Ë
    =Gìjé8  ã                   óì   — d Z ddlZddlZddlmZ  eh d£«      Z G d„ dej                  «      Z G d„ dej                  «      Z	 G d	„ d
ej                  «      Z
 G d„ dej                  «      Zd„ Zd„ Zy)a  This module provides argparse integration with absl.flags.

``argparse_flags.ArgumentParser`` is a drop-in replacement for
:class:`argparse.ArgumentParser`. It takes care of collecting and defining absl
flags in :mod:`argparse`.

Here is a simple example::

    # Assume the following absl.flags is defined in another module:
    #
    #     from absl import flags
    #     flags.DEFINE_string('echo', None, 'The echo message.')
    #
    parser = argparse_flags.ArgumentParser(
        description='A demo of absl.flags and argparse integration.')
    parser.add_argument('--header', help='Header message to print.')

    # The parser will also accept the absl flag `--echo`.
    # The `header` value is available as `args.header` just like a regular
    # argparse flag. The absl flag `--echo` continues to be available via
    # `absl.flags.FLAGS` if you want to access it.
    args = parser.parse_args()

    # Example usages:
    # ./program --echo='A message.' --header='A header'
    # ./program --header 'A header' --echo 'A message.'


Here is another example demonstrates subparsers::

    parser = argparse_flags.ArgumentParser(description='A subcommands demo.')
    parser.add_argument('--header', help='The header message to print.')

    subparsers = parser.add_subparsers(help='The command to execute.')

    roll_dice_parser = subparsers.add_parser(
        'roll_dice', help='Roll a dice.',
        # By default, absl flags can also be specified after the sub-command.
        # To only allow them before sub-command, pass
        # `inherited_absl_flags=None`.
        inherited_absl_flags=None)
    roll_dice_parser.add_argument('--num_faces', type=int, default=6)
    roll_dice_parser.set_defaults(command=roll_dice)

    shuffle_parser = subparsers.add_parser('shuffle', help='Shuffle inputs.')
    shuffle_parser.add_argument(
        'inputs', metavar='I', nargs='+', help='Inputs to shuffle.')
    shuffle_parser.set_defaults(command=shuffle)

    args = parser.parse_args(argv[1:])
    args.command(args)

    # Example usages:
    # ./program --echo='A message.' roll_dice --num_faces=6
    # ./program shuffle --echo='A message.' 1 2 3 4


There are several differences between :mod:`absl.flags` and
:mod:`~absl.flags.argparse_flags`:

1. Flags defined with absl.flags are parsed differently when using the
   argparse parser. Notably:

   1) absl.flags allows both single-dash and double-dash for any flag, and
      doesn't distinguish them; argparse_flags only allows double-dash for
      flag's regular name, and single-dash for flag's ``short_name``.
   2) Boolean flags in absl.flags can be specified with ``--bool``,
      ``--nobool``, as well as ``--bool=true/false`` (though not recommended);
      in argparse_flags, it only allows ``--bool``, ``--nobool``.

2. Help related flag differences:

   1) absl.flags does not define help flags, absl.app does that; argparse_flags
      defines help flags unless passed with ``add_help=False``.
   2) absl.app supports ``--helpxml``; argparse_flags does not.
   3) argparse_flags supports ``-h``; absl.app does not.
é    N)Úflags>   ÚhelpÚhelpxmlÚundefokÚflagfileÚhelpfullÚ	helpshortÚonly_check_flagsc                   ó:   ‡ — e Zd ZdZˆ fd„Zdˆ fd„	Zd„ Zd„ Zˆ xZS )ÚArgumentParserz:Custom ArgumentParser class to support special absl flags.c                 ó2  •— |j                  dd«      }|dk7  rt        d|› d�«      ‚|j                  dt        j                  «      | _        t        ‰| �  di |¤Ž | j                  rX| j                  ddt        j                  t        j                  ¬«       | j                  d	t        t        j                  d
¬«       | j
                  �L| j                  dt        j                  t        j                  ¬«       | j                  | j
                  «       yy)a¯  Initializes ArgumentParser.

    Args:
      **kwargs: same as argparse.ArgumentParser, except:
          1. It also accepts `inherited_absl_flags`: the absl flags to inherit.
             The default is the global absl.flags.FLAGS instance. Pass None to
             ignore absl flags.
          2. The `prefix_chars` argument must be the default value '-'.

    Raises:
      ValueError: Raised when prefix_chars is not '-'.
    Úprefix_charsÚ-zPargparse_flags.ArgumentParser only supports "-" as the prefix character, found "Ú"Úinherited_absl_flagsz--helpshortr   )ÚactionÚdefaultr   z
--helpfullzshow full help message and exitNz	--undefok)r   r   © )ÚgetÚ
ValueErrorÚpopr   ÚFLAGSÚ_inherited_absl_flagsÚsuperÚ__init__Úadd_helpÚadd_argumentÚargparseÚSUPPRESSÚ_HelpFullActionÚ_define_absl_flags)ÚselfÚkwargsr   Ú	__class__s      €ú]C:\Users\Stabi\Downloads\virtual-tryon(1)\venv\Lib\site-packages\absl/flags/argparse_flags.pyr   zArgumentParser.__init__q   s  ø€ ð —:‘:˜n¨cÓ2€LØ�sÒÜðØ+˜n¨Að/óð ð "(§¡Ð,BÄEÇKÁKÓ!P€DÔô 
�GÑÑ�vÒà‡}‚}ð ×Ñà
ØÜ×#Ñ#Ü× Ñ ð ô ð ×ÑØ
Ü Ü×#Ñ#Ø0ð	 ô ð ×!Ñ!Ð-Ø
×ÑØ
œx×0Ñ0´x×7HÑ7Hð ô ð ×Ñ˜d×8Ñ8Õ9ð	 .ó    c                 ó>  •— |€t         j                  dd  }| j                  �| j                  j                  |d¬«      }t	        «       }t        |d|«      }t        ‰| �  ||«      \  }}||ur||_        | j                  �]t        |d«      rt        |j                  |«      }|`| j                  j                  «        	 | j                  j                  «        ||fS ||fS # t        j                  $ r'}| j                  t!        |«      «       Y d }~||fS d }~ww xY w)Né   T)Ú	force_gnur   )ÚsysÚargvr   Úread_flags_from_filesÚobjectÚgetattrr   Úparse_known_argsr   ÚhasattrÚ_strip_undefok_argsÚmark_as_parsedÚvalidate_all_flagsr   ÚIllegalFlagValueErrorÚerrorÚstr)r"   ÚargsÚ	namespaceÚundefok_missingr   Úer$   s         €r%   r/   zArgumentParser.parse_known_args¢   s(  ø€ Ø€|Ü�X‰X�a�bˆ\€dØ×!Ñ!Ð-ð ×'Ñ'×=Ñ=Ø
˜$ð >ó €dô “h€OÜ�i ¨OÓ<€Gä‘gÑ.¨t°YÓ?�O€Iˆtð
 �oÑ%Ø!€iÔà×!Ñ!Ð-ô 
�˜IÔ	&Ü" 9×#4Ñ#4°dÓ;ˆð ÐØ
× Ñ ×/Ñ/Ô1ðØ×"Ñ"×5Ñ5Ô7ð �dˆ?Ðˆ9�dˆ?Ðøô ×(Ñ(ò Ø�
‰
”3�q“6×Ðà�dˆ?Ðûðús   Ã C" Ã"DÃ5DÄDc                 óÐ   — t        |j                  t        j                  d   «      «      }|D ]6  }|t        v rŒ||   }||j
                  k(  sŒ!||v}| j                  ||«       Œ8 y)zDefines flags from absl_flags.r   N)ÚsetÚget_key_flags_for_moduler*   r+   Ú_BUILT_IN_FLAGSÚnameÚ_define_absl_flag)r"   Ú
absl_flagsÚ	key_flagsr?   Úflag_instanceÚsuppresss         r%   r!   z!ArgumentParser._define_absl_flagsË   sj   € ä�J×7Ñ7¼¿¹À¹ÓDÓE€IÛˆØ	”Ñ	 àØ  Ñ&€mð 
�×#Ñ#Ó	#ð !¨	Ð1ˆØ×Ñ˜}¨hÕ7ñ r&   c                 óÒ  — |j                   }|j                  }d|z   g}|r|j                  dd|z   «       |rt        j                  }n|j
                  j                  dd«      }|j                  rF|j                  d|z   «        | j                  |t        ||j                   j                  «       |dœŽ y | j                  |t        ||j                   j                  «       |dœŽ y)	z&Defines a flag from the flag_instance.ú--r   r   Ú%z%%z--no)r   r   ÚmetavarrC   N)r?   Ú
short_nameÚinsertr   r   r   ÚreplaceÚbooleanÚappendr   Ú_BooleanFlagActionÚupperÚ_FlagAction)r"   rC   rD   Ú	flag_namerI   Úargument_namesÚhelptexts          r%   r@   z ArgumentParser._define_absl_flagÛ   sß   € à×"Ñ"€IØ×)Ñ)€JØ˜YÑ&Ð'€NÙØ×Ñ˜A˜s ZÑ/Ô0ÙÜ×"Ñ"�hð ×#Ñ#×+Ñ+¨C°Ó6€hØ×Òà×Ñ˜F YÑ.Ô/Ø€d×ÑØÜ#ØØ×$Ñ$×*Ñ*Ó,Ø%ôð €d×ÑØÜØØ×$Ñ$×*Ñ*Ó,Ø%ôr&   )NN)	Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   r/   r!   r@   Ú__classcell__©r$   s   @r%   r   r   n   s   ø„ ÙBô/:õb'òR8ö r&   r   c                   óB   ‡ — e Zd ZdZej
                  fˆ fd„	Zdd„Zˆ xZS )rP   z*Action class for Abseil non-boolean flags.c                 óX   •— ~|| _         t        ‰| �	  |t        j                  ||¬«       y)a˜  Initializes _FlagAction.

    Args:
      option_strings: See argparse.Action.
      dest: Ignored. The flag is always defined with dest=argparse.SUPPRESS.
      help: See argparse.Action.
      metavar: See argparse.Action.
      flag_instance: absl.flags.Flag, the absl flag instance.
      default: Ignored. The flag always uses dest=argparse.SUPPRESS so it
        doesn't affect the parsing result.
    )Úoption_stringsÚdestr   rH   N)Ú_flag_instancer   r   r   r   )r"   r\   r]   r   rH   rC   r   r$   s          €r%   r   z_FlagAction.__init__þ   s4   ø€ ð( 	Ø'€DÔÜ	�GÑØ%Ü×ÑØØð	 õ r&   c                 ó\   — | j                   j                  |«       d| j                   _        y)úCSee https://docs.python.org/3/library/argparse.html#action-classes.FN)r^   ÚparseÚusing_default_value)r"   Úparserr8   ÚvaluesÚoption_strings        r%   Ú__call__z_FlagAction.__call__  s$   € à×Ñ×Ñ˜fÔ%Ø.3€D×ÑÕ+r&   ©N©	rT   rU   rV   rW   r   r   r   rf   rX   rY   s   @r%   rP   rP   û   s   ø„ Ù2ð ×Ñõ÷:4r&   rP   c                   óB   ‡ — e Zd ZdZej
                  fˆ fd„	Zdd„Zˆ xZS )rN   z&Action class for Abseil boolean flags.c                 ó   •— ~~|| _         | j                   j                  g}| j                   j                  r%|j                  | j                   j                  «       t	        |«      | _        t        ‰| �  |t        j                  d||¬«       y)aŸ  Initializes _BooleanFlagAction.

    Args:
      option_strings: See argparse.Action.
      dest: Ignored. The flag is always defined with dest=argparse.SUPPRESS.
      help: See argparse.Action.
      metavar: See argparse.Action.
      flag_instance: absl.flags.Flag, the absl flag instance.
      default: Ignored. The flag always uses dest=argparse.SUPPRESS so it
        doesn't affect the parsing result.
    r   )r\   r]   Únargsr   rH   N)
r^   r?   rI   rM   Ú	frozensetÚ_flag_namesr   r   r   r   )	r"   r\   r]   r   rH   rC   r   Ú
flag_namesr$   s	           €r%   r   z_BooleanFlagAction.__init__$  sƒ   ø€ ð( 	ˆgØ'€DÔØ×%Ñ%×*Ñ*Ð+€JØ×Ñ×%Ò%Ø×Ñ˜×+Ñ+×6Ñ6Ô7Ü  Ó,€DÔÜ	�GÑØ%Ü×ÑØØØð õ r&   c                 ó‚  — t        |t        «      r|rt        d«      ‚|j                  d«      r|dd }n|dd }|| j                  v r| j
                  j                  d«       nK|j                  d«      r|dd | j                  vrt        d|z   «      ‚| j
                  j                  d	«       d
| j
                  _        y)r`   zvalues must be an empty list.rF   é   Nr(   ÚtrueÚnozinvalid option_string: ÚfalseF)Ú
isinstanceÚlistr   Ú
startswithrm   r^   ra   rb   )r"   rc   r8   rd   re   Úoptions         r%   rf   z_BooleanFlagAction.__call__F  s¶   € ä�fœdÔ#¡vÜÐ6Ó7Ð7Ø×Ñ Ô%Ø˜Q˜RÐ �fà˜Q˜RÐ €fØ�×!Ñ!Ñ!Ø
×Ñ×Ñ Õ'à×Ñ˜tÔ$¨¨q¨r¨
¸$×:JÑ:JÑ(JÜÐ2°]ÑBÓCÐCØ
×Ñ×Ñ Ô(Ø.3€D×ÑÕ+r&   rg   rh   rY   s   @r%   rN   rN   !  s   ø„ Ù.ð ×Ñõ ÷D4r&   rN   c                   ó*   ‡ — e Zd ZdZˆ fd„Zdd„Zˆ xZS )r    z!Action class for --helpfull flag.c                 ój   •— ~~t         ‰| �  |t        j                  t        j                  d|¬«       y)zÝInitializes _HelpFullAction.

    Args:
      option_strings: See argparse.Action.
      dest: Ignored. The flag is always defined with dest=argparse.SUPPRESS.
      default: Ignored.
      help: See argparse.Action.
    r   )r\   r]   r   rk   r   N)r   r   r   r   )r"   r\   r]   r   r   r$   s        €r%   r   z_HelpFullAction.__init__Z  s7   ø€ ð 	ˆgÜ	�GÑØ%Ü×ÑÜ×!Ñ!ØØð õ r&   c                 ó  — |j                  «        |j                  }|�^t        |j                  «       «      }t        j
                  d   }||v r|j                  |«       t        |j                  |dd¬«      «       |j                  «        y)r`   Nr   Ú T)ÚprefixÚinclude_special_flags)
Ú
print_helpr   ÚsortedÚflags_by_module_dictr*   r+   ÚremoveÚprintÚ_get_help_for_modulesÚexit)r"   rc   r8   rd   re   rA   ÚmodulesÚmain_modules           r%   rf   z_HelpFullAction.__call__l  s‚   € ð ×ÑÔà×-Ñ-€JØÐÜ�z×6Ñ6Ó8Ó9€gÜ—H‘H˜Q‘K€kØ	˜Ñ	à�‰�{Ô#ÜØ
×
*Ñ
*Ø˜b¸ð +ó ôð
 ‡K�K…Mr&   rg   )rT   rU   rV   rW   r   rf   rX   rY   s   @r%   r    r    W  s   ø„ Ù)ô÷$r&   r    c                 óä   — | r^| j                  d«      D �ch c]  }|j                  «       ’Œ }}||D �ch c]  }d|z   ’Œ	 c}z  }|D �cg c]  }t        ||«      rŒ|‘Œ }}|S c c}w c c}w c c}w )z=Returns a new list of args after removing flags in --undefok.Ú,rr   )ÚsplitÚstripÚ_is_undefok)r   r7   r?   Úundefok_namesÚargs        r%   r1   r1   ƒ  su   € áØ.5¯m©m¸CÔ.@ÓAÑ.@ d�T—Z‘Z•\Ð.@€MÐAØ©mÓ<©m d�d˜T“k¨mÑ<Ñ<€MáÓG™4�C¤{°3¸Õ'FŠC˜4€DÐGØ	€+ùò	 BùÚ<ùâGs   –A#´A(Á	A-ÁA-c                 ó¢   — | j                  d«      sy| j                  d«      r| dd }n| dd }d|v r|j                  dd«      \  }}n|}||v ryy)	zGReturns whether we can ignore arg based on a set of undefok flag names.r   FrF   rp   Nr(   Ú=T)rv   r‰   )r�   rŒ   Úarg_without_dashr?   Ú_s        r%   r‹   r‹   �  sg   € à	�‰˜Ô	ØØ‡^�^�DÔØ˜1˜2�wÑà˜1˜2�wÐØÐÑØ×$Ñ$ S¨!Ó,�G€D‰!à€DØ	ˆ]ÑØØ	r&   )rW   r   r*   Úabslr   rl   r>   r   ÚActionrP   rN   r    r1   r‹   r   r&   r%   Ú<module>r”      sz   ðñLó\ Û 
å ñ ò ó €ôJ�X×,Ñ,ô JôZ#4�(—/‘/ô #4ôL34˜Ÿ™ô 34ôl)�h—o‘oô )òXór&   