/usr/lib/python3.10/__pycache__
Edit: /usr/lib/python3.10/__pycache__/argparse.cpython-310.pyc (63539B)
o
9j @ sB d Z dZg dZddlZddlZddlZz
ddl m Z
m Z W n e y/ dd Z
dd Z Y nw d
Z
d Zd Zd
ZdZdZdZG dd deZdd ZG dd deZG dd deZG dd deZG dd d eZG d d d eZd d Z G d!d" d"e Z G d#d$ d$e Z G d%d& d&eZ G d'd( d(e Z!G d)d* d*e Z"G d+d, d,e Z#G d-d. d.e#Z$G d/d0 d0e#Z%G d1d2 d2e Z&G d3d4 d4e Z'G d5d6 d6e Z(G d7d8 d8e Z)G d9d: d:e Z*G d;d< d
d>e&Z,G d?d@ d@eZ-G dAdB dBeZ.G dCdD dDeZ/G dEdF dFe/Z0G dGdH dHe0Z1G dIdJ dJee/Z2dS )Ka
Command-line parsing library
This module is an optparse-inspired command-line parsing library that:
- handles both optional and positional arguments
- produces highly informative usage messages
- supports parsers that dispatch to sub-parsers
The following is a simple usage example that sums integers from the
command-line and writes the result to a file::
parser = argparse.ArgumentParser(
description='sum the integers at the command line')
parser.add_argument(
'integers', metavar='int', nargs='+', type=int,
help='an integer to be summed')
parser.add_argument(
'--log', default=sys.stdout, type=argparse.FileType('w'),
help='the file where the sum should be written')
args = parser.parse_args()
args.log.write('%s' % sum(args.integers))
args.log.close()
The module contains the following public classes:
- ArgumentParser -- The main entry point for command-line parsing. As the
example above shows, the add_argument() method is used to populate
the parser with actions for optional and positional arguments. Then
the parse_args() method is invoked to convert the args at the
command-line into an object with attributes.
- ArgumentError -- The exception raised by ArgumentParser objects when
there are errors with the parser's actions. Errors raised while
parsing the command-line are caught by ArgumentParser and emitted
as command-line messages.
- FileType -- A factory for defining types of files to be created. As the
example above shows, instances of FileType are typically passed as
the type= argument of add_argument() calls.
- Action -- The base class for parser actions. Typically actions are
selected by passing strings like 'store_true' or 'append_const' to
the action= argument of add_argument(). However, for greater
customization of ArgumentParser actions, subclasses of Action may
be defined and passed as the action= argument.
- HelpFormatter, RawDescriptionHelpFormatter, RawTextHelpFormatter,
ArgumentDefaultsHelpFormatter -- Formatter classes which
may be passed as the formatter_class= argument to the
ArgumentParser constructor. HelpFormatter is the default,
RawDescriptionHelpFormatter and RawTextHelpFormatter tell the parser
not to change the formatting for help text, and
ArgumentDefaultsHelpFormatter adds information about argument defaults
to the help.
All other classes in this module are considered implementation details.
(Also note that HelpFormatter and RawDescriptionHelpFormatter are only
considered public as object names -- the API of the formatter objects is
still considered an implementation detail.)
z1.1)ArgumentParser
ArgumentErrorArgumentTypeErrorBooleanOptionalActionFileType
HelpFormatter ArgumentDefaultsHelpFormatterRawDescriptionHelpFormatterRawTextHelpFormatterMetavarTypeHelpFormatter NamespaceAction ONE_OR_MOREOPTIONALPARSER REMAINDERSUPPRESS ZERO_OR_MORE N)gettextngettextc C | S N )messager r /usr/lib/python3.10/argparse.py__ r c C s |dkr| S |S N r )singularpluralnr r r r a s r z ==SUPPRESS==?*+zA......_unrecognized_argsc @ ( e Zd ZdZdd Zdd Zdd ZdS ) _AttributeHoldera Abstract base class that provides __repr__.
The __repr__ method returns a string in the format::
ClassName(attr=name, attr=name, ...)
The attributes are determined either by a class-level attribute,
'_kwarg_names', or by inspecting the instance __dict__.
c C s t | j}g }i }| D ] }|t| q
| D ]\}}| r-|d||f q|||< q|r=|dt| d|d|f S )N%s=%rz**%s%s(%s), )type__name__ _get_argsappendrepr _get_kwargs isidentifierjoin)self type_name arg_strings star_argsargnamevaluer r r __repr__} s
z_AttributeHolder.__repr__c C s t | j S r )list__dict__itemsr4 r r r r1 z _AttributeHolder._get_kwargsc C s g S r r r? r r r r. r z_AttributeHolder._get_argsN)r-
__module__ __qualname____doc__r; r1 r. r r r r r( t s
r( c C s6 | d u rg S t | tu r| d d S dd l}|| S Nr )r, r< copy)r> rE r r r _copy_items s
rF c @ s e Zd ZdZ d;ddZdd Zd d
ZG d d d eZd
d Z dd Z
dd Z dd Z d )r4 ri rj rk r r r re
z HelpFormatter._Section.__init__c C s | j d ur
| j | jj}|dd | jD }| j d ur"| j |s&dS | jtur=| jd ur=| jj}d|d| jf }nd}|d||dgS )Nc S s g | ]\}}|| qS r r ).0funcargsr r r
z6HelpFormatter._Section.format_help.. z%*s%s:
) rj ri rg _join_partsr> rh rk r rU )r4 r3 item_helpcurrent_indentrk r r r format_help s
z"HelpFormatter._Section.format_helpr )r- rA rB re rw r r r r rX s
rX c C s | j j||f d S r )rZ r> r/ )r4 rn ro r r r _add_item s zHelpFormatter._add_itemc C s0 | | | | j|}| |jg || _d S r )rg rX rZ rx rw )r4 rk sectionr r r
start_section s
zHelpFormatter.start_sectionc C s | j j| _ | d S r )rZ rj rh r? r r r end_section s
zHelpFormatter.end_sectionc C s, |t ur|d ur| | j|g d S d S d S r )r rx _format_text)r4 textr r r add_text s zHelpFormatter.add_textc C s* |t ur||||f}| | j| d S d S r )r rx
_format_usage)r4 usageactionsgroupsprefixro r r r add_usage s zHelpFormatter.add_usagec C sv |j tur9| j}||g}| |D ] }||| qttt|}|| j }t| j || _ |
| j |g d S d S r ) helpr _format_action_invocation_iter_indented_subactionsr/ rR maplenrU rW rx _format_action)r4 actionget_invocation invocations subactioninvocation_length
action_lengthr r r add_argument
s
zHelpFormatter.add_argumentc C s |D ]}| | qd S r )r )r4 r r r r r
add_arguments s zHelpFormatter.add_argumentsc C s. | j }|r| jd|}|dd }|S )N
rs )rY rw r_ substrip)r4 r r r r rw & s
zHelpFormatter.format_helpc C s d dd |D S )Nrr c S s g | ]
}|r |t ur|qS r )r )rm partr r r rp . s z-HelpFormatter._join_parts..)r3 )r4 part_stringsr r r rt - s
zHelpFormatter._join_partsc s( |d u rt d}|d ur|t| jd }n|d u r$|s$dt| jd }n|d u rdt| jd }g }g }|D ]}|jrB|| q7|| q7| j} | || |}
ddd ||
fD }| j| j t |t | krd} | ||} | ||}
t
| | }t
| |
}d|| ksJ d||
ksJ d fdd }t |t | d
krdt |t | d }|r||g| ||}| ||| n=|r||g| ||}n1|g}n-dt | }|| }|||}t |d krg }| ||| | ||| |g| }d |}d
||f S )Nzusage: r` z%(prog)s c S s g | ]}|r|qS r r )rm sr r r rp N z/HelpFormatter._format_usage..z%\(.*?\)+(?=\s|$)|\[.*?\]+(?=\s|$)|\S+c s g }g }|d urt |d }nt |d }| D ]-}|d t | kr7|r7||d| g }t |d }|| |t |d 7 }q|rQ||d| |d ura|d t |d |d< |S )Nr r r )r r/ r3 )partsindentr lineslineline_lenr
text_widthr r get_linesb s"
z.HelpFormatter._format_usage..get_linesg ?r rs z%s%s
r )
r dictrO option_stringsr/ _format_actions_usager3 rT rU r r[ findallextend)r4 r r r r r` optionals positionalsr format action_usage part_regexp opt_usage pos_usage opt_parts pos_partsr r r r r r r r 2 s\
zHelpFormatter._format_usagec C s t }i }|D ]}|jstd| z
||jd }W n ty& Y qw t|j}|| }||| |jkrd} |jD ]}
||
|
jtu rN| d7 } q>|| } |jsy||v rc|| d7 < nd||< ||v rt|| d7 < n+d||< n&| dkr||v r|| d7 < nd||< ||v r|| d 7 < nd ||< t |d |D ]} d
|| < qqg }
t
|D ]\} }
|
jtu r|
d | | d
kr|
| q| | d d
kr|
| d q|
js| |
}| |
|}|
|v r|d dkr|d dkr|dd }|
| q|
jd }|
jdkr |
}n| |
}| |
|}d ||f }|
js<|
|vr.z[\[(]z[\])]z(%s) z\1 (%s)z%s *%srr )set_group_actions
ValueErrorindexr addr r requiredrange enumerater/ getpopr #_get_default_metavar_for_positional _format_argsnargs format_usage!_get_default_metavar_for_optionalsortedr3 r[ r r )r4 r r
group_actionsinsertsgroupstartgroup_action_countendsuppressed_actions_countr exposed_actions_countir defaultr
option_string args_stringr} opencloser r r r s
z#HelpFormatter._format_actions_usagec C sF d|v r |t | jd }t| j| j d}d| j }| |||d S )Nz%(prog)r r r )r rO rR rT rU
_fill_text)r4 r} r r r r r r| s
zHelpFormatter._format_textc
C sD t | jd | j}t| j| d}|| j d }| |}|js+| jd|f}d| }n t||kr?| jd||f}d| }d}n | jd|f}d| }|}|g}|jr|j r|
|} | r| | |}
| d|d|
d f |
dd D ] } | d|d| f qun
|
ds| d | |D ]
} | | | q| |S ) NrG r rr z%*s%s
z %*s%-*s r r rs )rQ rW rS rR rT rU r r r r _expand_help _split_linesr/ endswithr r rt )
r4 r
help_position
help_width action_width
action_headertup indent_firstr help_text
help_linesr r r r r r
s<
z HelpFormatter._format_actionc C s |j s| |}| ||d\}|S g }|jdkr!||j n| |}| ||}|j D ] }|d||f q/d|S )Nr r r r+ ) r r _metavar_formatterr r r r r/ r3 )r4 r r metavarr r r r r r r : s
z'HelpFormatter._format_action_invocationc sP |j d ur |j n|jd ur dd |jD }dd| n| fdd}|S )Nc S g | ]}t |qS r str)rm choicer r r rp V r z4HelpFormatter._metavar_formatter..z{%s},c s t tr S f| S r )
isinstancetuple)
tuple_sizeresultr r r [ s
z0HelpFormatter._metavar_formatter..format)r choicesr3 )r4 r default_metavar choice_strsr r r r r R s
z HelpFormatter._metavar_formatterc C s | ||}|jd u rd|d }|S |jtkr d|d }|S |jtkr;|d}t|dkr5d| }|S d| }|S |jtkrHd|d }|S |jtkrQd}|S |jtkr^d |d }|S |jtkrgd
}|S z d d t |jD }W n t
y t d
d w d |||j }|S )N%sr r rG z
[%s [%s ...]]z[%s ...]z %s [%s ...]r% z%s ...rr c S s g | ]}d qS )r r )rm r r r r rp x s z.HelpFormatter._format_args..zinvalid nargs valuer )
r r r r r r
r r r r TypeErrorr r3 )r4 r r get_metavarr r formatsr r r r b sB
zHelpFormatter._format_argsc C s t t|| jd}t|D ] }|| tu r||= q
t|D ]}t|| dr-|| j||< q |dd urEddd |d D }||d< | || S )Nr r- r r+ c S r r r rm cr r r rp r z.HelpFormatter._expand_help..)
r varsrO r< r hasattrr- r r3 _get_help_string)r4 r paramsr9 choices_strr r r r ~ s zHelpFormatter._expand_helpc c sB z|j }W n
ty Y d S w | | E d H | d S r )_get_subactionsAttributeErrorrg rh )r4 r get_subactionsr r r r s
z'HelpFormatter._iter_indented_subactionsc C s& | j d| }dd l}|||S )Nr r )r^ r r textwrapwrap)r4 r} rc r r r r r s zHelpFormatter._split_linesc C s, | j d| }dd l}|j||||dS )Nr r )initial_indentsubsequent_indent)r^ r r r fill)r4 r} rc r r r r r r s zHelpFormatter._fill_textc C |j S r )r r4 r r r r r z HelpFormatter._get_help_stringc C s
|j S r )destupperr r r r r
z/HelpFormatter._get_default_metavar_for_optionalc C r
r )r
r r r r r r z1HelpFormatter._get_default_metavar_for_positional)rG rH Nr ) r- rA rB rC re rg rh objectrX rx rz r{ r~ r r r rw rt r r r| r r r r r r r r r r r r r r r r s@
"
`q0
r c @ e Zd ZdZdd ZdS )r zHelp message formatter which retains any formatting in descriptions.
Only the name of this class is considered a public API. All the methods
provided by the class are considered an implementation detail.
c s d fdd|jddD S )Nrr c 3 s | ]} | V qd S r r )rm r r r r s z9RawDescriptionHelpFormatter._fill_text..T)keepends)r3
splitlines)r4 r} rc r r r r r s z&RawDescriptionHelpFormatter._fill_textN)r- rA rB rC r r r r r r r c @ r )r zHelp message formatter which retains formatting of all help text.
Only the name of this class is considered a public API. All the methods
provided by the class are considered an implementation detail.
c C s | S r )r )r4 r} rc r r r r z!RawTextHelpFormatter._split_linesN)r- rA rB rC r r r r r r r r c @ r )r zHelp message formatter which adds default values to argument help.
Only the name of this class is considered a public API. All the methods
provided by the class are considered an implementation detail.
c C s> |j }d|j vr |jtur ttg}|js|j|v r |d7 }|S )Nz
%(default) (default: %(default)s))r r r r r r r )r4 r r defaulting_nargsr r r r s
z.ArgumentDefaultsHelpFormatter._get_help_stringN)r- rA rB rC r r r r r r r r c @ e Zd ZdZdd Zdd ZdS )r
a Help message formatter which uses the argument 'type' as the default
metavar value (instead of the argument 'dest')
Only the name of this class is considered a public API. All the methods
provided by the class are considered an implementation detail.
c C |j jS r r, r- r r r r r r z:MetavarTypeHelpFormatter._get_default_metavar_for_optionalc C r r r r r r r r r z.r r4 namesr r? r r1 ] s zAction._get_kwargsc C s
| j d S rD r r? r r r r l r zAction.format_usagec C s t td)Nz.__call__() not defined)NotImplementedErrorr r4 parser namespacevaluesr r r r __call__o zAction.__call__NNNNNFNNr )r- rA rB rC re r1 r r5 r r r r r s 5
r c s< e Zd Z d fdd Zd
ddZdd Z ZS ) r NFc s~ g } |D ]}
| |
|
dr d|
dd }
| |
q|d ur.|d ur.|tur.|d7 }t j| |d||||||d d S )N----no-rG r r ) r r
r r r, r r r r )r/
startswithr superre ) r4 r r
r r, r r r r _option_stringsr __class__r r re s s(
z BooleanOptionalAction.__init__c C s( || j v rt|| j|d d S d S )Nr9 )r setattrr
r: r1 r r r r5 s
z BooleanOptionalAction.__call__c C s d | jS )Nz | )r3 r r? r r r r r6 z"BooleanOptionalAction.format_usage)NNNFNNr )r- rA rB re r5 r
__classcell__r r r= r r r s
r c 8 e Zd Z d fdd ZdddZ ZS ) _StoreActionNFc T |dkrt d|d ur|tkrt dt tt| j||||||||| |
d
d S )Nr znargs for store actions must be != 0; if you have nothing to store, actions such as store true or store const may be more appropriate nargs must be %r to supply constr$ )r r r; rB re r& r= r r re
z_StoreAction.__init__c C s t || j| d S r )r? r
r1 r r r r5 z_StoreAction.__call__r7 r r- rA rB re r5 r@ r r r= r rB rB c 0 e Zd Z d fdd ZdddZ ZS ) _StoreConstActionNFc s" t t| j||d||||d d S )Nr )r r
r r% r r r )r; rJ re r4 r r
r% r r r r r= r r re s
z_StoreConstAction.__init__c C s t || j| j d S r )r? r
r% r1 r r r r5 s z_StoreConstAction.__call__NFNNr rG r r r= r rJ s rJ c s$ e Zd Z d fdd Z ZS )_StoreTrueActionFNc t t| j||d|||d d S )NTr r
r% r r r )r; rM re r4 r r
r r r r= r r re
z_StoreTrueAction.__init__)FFNr- rA rB re r@ r r r= r rM
rM c s$ e Zd Z d fdd Z ZS )_StoreFalseActionTFNc rN )NFrO )r; rT re rP r= r r re rQ z_StoreFalseAction.__init__)TFNrR r r r= r rT rS rT c rA )
_AppendActionNFc rC )Nr znargs for append actions must be != 0; if arg strings are not supplying the value to append, the append const action may be more appropriaterD r$ )r r r; rU re r& r= r r re rE z_AppendAction.__init__c C 2 t || jd }t|}|| t|| j| d S r )r* r
rF r/ r? r4 r2 r3 r4 r r> r r r r5
z_AppendAction.__call__r7 r rG r r r= r rU rH rU c rI ) _AppendConstActionNFc
s$ t t| j||d|||||d d S )Nr )r r
r r% r r r r )r; rY re rK r= r r re s
z_AppendConstAction.__init__c C s4 t || jd }t|}|| j t|| j| d S r )r* r
rF r/ r% r? rW r r r r5 1 s z_AppendConstAction.__call__rL r rG r r r= r rY s rY c s. e Zd Z d fdd ZdddZ ZS ) _CountActionNFc rN )Nr )r r
r r r r )r; rZ re rP r= r r re : rQ z_CountAction.__init__c C s0 t || jd }|d u r
d}t|| j|d d S Nr r )r* r
r? )r4 r2 r3 r4 r countr r r r5 H s z_CountAction.__call__)NFNr rG r r r= r rZ 8 s rZ c s. e Zd Zeedf fdd ZdddZ ZS ) _HelpActionNc s t t| j|||d|d d S Nr )r r
r r r )r; r] re )r4 r r
r r r= r r re Q s
z_HelpAction.__init__c C s | | d S r )
print_helpexitr1 r r r r5 ] s z_HelpAction.__call__r r- rA rB r re r5 r@ r r r= r r] O s r] c s0 e Zd Zdeedf fdd ZdddZ ZS )_VersionActionNz&show program's version number and exitc s$ t t| j|||d|d || _d S r^ )r; rb re version)r4 r rc r
r r r= r r re d s
z_VersionAction.__init__c C sD | j }|d u r
|j }| }|| || tj | d S r )rc _get_formatterr~ _print_messagerw _sysstdoutr` )r4 r2 r3 r4 r rc ri r r r r5 r s
z_VersionAction.__call__r ra r r r= r rb b s rb c sP e Zd ZG dd deZedddf fdd Zdd Zd d
Zd
d d Z Z
S )_SubParsersActionc s e Zd Z fddZ ZS )z&_SubParsersAction._ChoicesPseudoActionc s@ | }}|r|dd | 7 }ttj| }|jg |||d d S )Nr r+ )r r
r r )r3 r; rh _ChoicesPseudoActionre )r4 r9 aliasesr r r
supr= r r re s
z/_SubParsersAction._ChoicesPseudoAction.__init__rR r r r= r ri ~ s ri FNc s< || _ || _i | _g | _tt| j||t| j|||d d S )N)r r
r r r r r ) _prog_prefix
_parser_class_name_parser_map_choices_actionsr; rh re r )r4 r r` parser_classr
r r r r= r r re s
z_SubParsersAction.__init__c K s | dd u rd| j|f |d< |dd}d|v r,|d}| |||}| j| | jdi |}|| j|< |D ]}|| j|< q;|S )Nr` r rj r r )r rl r ri ro r/ rm rn )r4 r9 kwargsrj r
choice_actionr2 aliasr r r
add_parser s
z _SubParsersAction.add_parserc C s | j S r )ro r? r r r r r z!_SubParsersAction._get_subactionsc C s |d }|dd }| j turt|| j | z| j| }W n ty8 |d| jd}td| }t| |w ||d \} }t |
D ]
\}
} t||
| qG|rft | t g t
|t | d S d S )Nr r r+ ) parser_namer z5unknown parser %(parser_name)r (choices: %(choices)s))r
r r? rn KeyErrorr3 r r parse_known_argsr r>
setdefault_UNRECOGNIZED_ARGS_ATTRr* r ) r4 r2 r3 r4 r ru r6 ro msg subnamespacekeyr: r r r r5 s(
z_SubParsersAction.__call__r ) r- rA rB r ri r re rt r r5 r@ r r r= r rh | s rh c @ s e Zd ZdddZdS )
_ExtendActionNc C rV r )r* r
rF r r? rW r r r r5 rX z_ExtendAction.__call__r )r- rA rB r5 r r r r r} s r} c @ s* e Zd ZdZd ddZdd Zd d
ZdS ) r a Factory for creating file object types
Instances of FileType are typically passed as type= arguments to the
ArgumentParser add_argument() method.
Keyword Arguments:
- mode -- A string indicating how the file is to be opened. Accepts the
same values as the builtin open() function.
- bufsize -- The file's desired buffer size. Accepts the same values as
the builtin open() function.
- encoding -- The file's encoding. Accepts the same values as the
builtin open() function.
- errors -- A string indicating how encoding and decoding errors are to
be handled. Accepts the same value as the builtin open() function.
rr Nc C s || _ || _|| _|| _d S r )_mode_bufsize _encoding_errors)r4 modebufsizeencodingerrorsr r r re rl zFileType.__init__c
s |dkr7d j v rd j v rtjjS tjS t fdddD r,d j v r)tjjS tjS td j }t|z
t| j j j
j W S t y_ } z||d}td }t
|| d }~ww )
N-r~ bc 3 s | ]}| j v V qd S r )r r r? r r r s z$FileType.__call__..waxzargument "-" with mode %r)filenameerrorz$can't open '%(filename)s': %(error)s)r rf stdinbufferanyrg r r r r r r OSErrorr )r4 stringrz ero r r r? r r5 s"
zFileType.__call__c C sT | j | jf}d| jfd| jfg}ddd |D dd |D }dt| j|f S )Nr r r+ c S s g | ]
}|d krt |qS )r )r0 )rm r8 r r r rp s z%FileType.__repr__..c S s$ g | ]\}}|d urd||f qS )Nr) r )rm kwr8 r r r rp s
r* )r r r r r3 r, r- )r4 ro rq args_strr r r r; s zFileType.__repr__)r~ r NN)r- rA rB rC re r5 r; r r r r r s
r c @ r' ) r zSimple object for storing attributes.
Implements equality by attribute names and values, and provides a simple
string representation.
c K s |D ]
}t | ||| qd S r )r? )r4 rq r9 r r r re " s zNamespace.__init__c C s t |tstS t| t|kS r )r r NotImplementedr )r4 otherr r r __eq__& s
zNamespace.__eq__c C s
|| j v S r )r= )r4 r| r r r __contains__+ r zNamespace.__contains__N)r- rA rB rC re r r r r r r r s
r c s e Zd Z fddZdd Zd&ddZdd Zd
d Zd d
Zdd Z dd Z
dd Z dd Z dd Z
dd Zdd Zd&d d Zd d Zd d! Zd"d# Zd$d% Z ZS )'_ActionsContainerc s t t| || _|| _|| _|| _i | _| dd t | ddt | ddt
| ddt | ddt | ddt
| ddt | ddt | dd t | dd
t | dd t | dd t | g | _i | _g | _g | _i | _td
| _ g | _ d S )Nr store store_const
store_true store_falser/ append_constr\ r rc parsersr z^-\d+$|^-\d*\.\d+$) r; r re descriptionargument_default prefix_charsconflict_handler _registriesregisterrB rJ rM rT rU rY rZ r] rb rh r} _get_handler_actions_option_string_actions_action_groups_mutually_exclusive_groups _defaultsr[ r\ _negative_number_matcher _has_negative_number_optionals)r4 r r r r r= r r re 1 s4
z_ActionsContainer.__init__c C s | j |i }|||< d S r )r rx )r4
registry_namer: r registryr r r r f s z_ActionsContainer.registerNc C s | j | ||S r )r r )r4 r r: r r r r
_registry_getj rF z _ActionsContainer._registry_getc K s2 | j | | jD ]
}|j|v r||j |_q d S r )r updater r
r )r4 rq r r r r set_defaultsp s
z _ActionsContainer.set_defaultsc C s8 | j D ]}|j|kr|jd ur|j S q| j|d S r )r r
r r r )r4 r
r r r r get_defaulty s
z _ActionsContainer.get_defaultc O sF | j }|rt|dkr&|d d |vr&|r d|v r td| j|i |}n| j|i |}d|vrM|d }|| jv rC| j| |d< n
| jdurM| j|d< | |}t|s]td|f |d
i |}| d|j
|j
}t|sxtd |f |t u rtd
|f t | d rz
|
|d W n ty td w | |S )z
add_argument(dest, ..., name=value, ...)
add_argument(option_string, option_string, ..., name=value, ...)
r r r
z+dest supplied twice for positional argumentr Nzunknown action "%s"r, %r is not callablez<%r is a FileType class object, instance of it must be passedrd z,length of metavar tuple does not match nargsr )r r r _get_positional_kwargs_get_optional_kwargsr r _pop_action_classcallabler r, r r rd r r _add_action)r4 ro rq charsr
action_classr type_funcr r r r s<
z _ActionsContainer.add_argumentc O s& t | g|R i |}| j| |S r )_ArgumentGroupr r/ )r4 ro rq r r r r add_argument_group s z$_ActionsContainer.add_argument_groupc K s t | fi |}| j| |S r )_MutuallyExclusiveGroupr r/ )r4 rq r r r r add_mutually_exclusive_group z._ActionsContainer.add_mutually_exclusive_groupc C s` | | | j| | |_|jD ]}|| j|< q|jD ]}| j|r-| js-| jd q |S )NT) _check_conflictr r/ containerr r r matchr )r4 r r r r r r s
z _ActionsContainer._add_actionc C s | j | d S r )r remover r r r _remove_action s z _ActionsContainer._remove_actionc C s i }| j D ]}|j|v rtd}t||j |||j< qi }|j D ]"}|j|vr7| j|j|j|jd||j< |jD ] }||j ||< q:q"|jD ]}| j |j
d}|jD ]}|||< qTqH|j D ] }| ||
| q_d S )Nz.cannot merge actions - two groups are named %r)titler r )r )r r r r r r r r r r r r r r )r4 r title_group_mapr rz group_mapr mutex_groupr r r _add_container_actions s6
z(_ActionsContainer._add_container_actionsc K s^ d|v r t d}t||dttfvrd|d< |dtkr(d|vr(d|d< t||g dS )Nr z1'required' is an invalid argument for positionalsr Tr r
r )r r r r r r )r4 r
rq rz r r r r s z(_ActionsContainer._get_positional_kwargsc O s g }g }|D ]0}|d | j vr || j d}td}t|| || t|dkr6|d | j v r6|| q|dd }|d u rd|rH|d }n|d }|| j }|s^td}t|| |dd}t|||d S )
Nr )optionr zNinvalid option string %(option)r: must start with a character %(prefix_chars)rr r
z%dest= is required for options like %rr r r ) r r r r/ r r lstripreplacer ) r4 ro rq r long_option_stringsr rz r
dest_option_stringr r r r s0
z&_ActionsContainer._get_optional_kwargsc C s | d|}| d||S )Nr )r r )r4 rq r r r r r r 2 s z#_ActionsContainer._pop_action_classc C s< d| j }zt| |W S ty td}t|| j w )Nz_handle_conflict_%sz%invalid conflict_resolution value: %r)r r* r r r )r4 handler_func_namerz r r r r 6 s
z _ActionsContainer._get_handlerc C sP g }|j D ]}|| jv r| j| }|||f q|r&| }||| d S d S r )r r r/ r )r4 r confl_optionalsr confl_optionalr r r r r ? s
z!_ActionsContainer._check_conflictc C s2 t ddt|}ddd |D }t||| )Nz conflicting option string: %sz conflicting option strings: %sr+ c S s g | ]\}}|qS r r )rm r r r r r rp Q s z<_ActionsContainer._handle_conflict_error..)r r r3 r )r4 r conflicting_actionsr conflict_stringr r r _handle_conflict_errorM s
z(_ActionsContainer._handle_conflict_errorc C s> |D ]\}}|j | | j|d |j s |j| qd S r )r r r r r r )r4 r r r r r r _handle_conflict_resolveV s z*_ActionsContainer._handle_conflict_resolver )r- rA rB re r r r r r r r r r r r r r r r r r r@ r r r= r r / s& 5
3(
" r c s6 e Zd Zd fdd Z fddZ fddZ ZS ) r Nc s |j }|d|j |d|j |d|j tt| j}|dd|i| || _g | _|j | _ |j
| _
|j | _ |j | _ |j
| _
|j| _d S )Nr r r r r )rx r r r r; r re r r r r r r r r )r4 r r r rq r
super_initr= r r re g s z_ArgumentGroup.__init__c s t t| |}| j| |S r )r; r r r r/ r r= r r r } r z_ArgumentGroup._add_actionc s t t| | | j| d S r )r; r r r r r r= r r r s z _ArgumentGroup._remove_actionNNr- rA rB re r r r@ r r r= r r e s r c s. e Zd Zd fdd Zdd Zdd Z ZS ) r Fc s t t| | || _|| _d S r )r; r re r
_container)r4 r r r= r r re s
z _MutuallyExclusiveGroup.__init__c C s2 |j r td}t|| j|}| j| |S )Nz-mutually exclusive arguments must be optional)r r r r r r r/ )r4 r rz r r r r s z#_MutuallyExclusiveGroup._add_actionc C s | j | | j| d S r )r r r r r r r r r s z&_MutuallyExclusiveGroup._remove_action)Fr r r r= r r s r c
s, e Zd ZdZddddg edddddddf
fdd Zdd Zd
d Zd d
Zdd Z dd Z
dAddZ dAddZ dd Z
dd Zdd Zd d Zd d Zd d! Zd"d# Zd$d% ZdAd&d'ZdAd(d)Zd*d+ Zd,d- Zd.d/ Zd0d1 Zd2d3 Zd4d5 Z dBd6d7Z dBd8d9Z dBd:d;Z dCd=d>Z d?d@ Z! Z"S )Dr aK Object for parsing command line strings into Python objects.
Keyword Arguments:
- prog -- The name of the program (default:
``os.path.basename(sys.argv[0])``)
- usage -- A usage message (default: auto-generated from arguments)
- description -- A description of what the program does
- epilog -- Text following the argument descriptions
- parents -- Parsers whose arguments should be copied into this one
- formatter_class -- HelpFormatter class for printing help messages
- prefix_chars -- Characters that prefix optional arguments
- fromfile_prefix_chars -- Characters that prefix files containing
additional arguments
- argument_default -- The default value for all arguments
- conflict_handler -- String indicating how to handle conflicts
- add_help -- Add a -h/-help option
- allow_abbrev -- Allow long options to be abbreviated unambiguously
- exit_on_error -- Determines whether or not ArgumentParser exits with
error info when an error occurs
Nr r Tc s$ t t| j}|||| |
d |d u rtjtjd }|| _|| _ || _
|| _ || _ | | _
| | _|
| _| j}|td| _|td| _d | _dd }| dd | d|v rXdn|d }| j
rq| j|d |d
d d ttd d
|D ] }| | z|j}W n ty Y qsw | j| qsd S )N)r r r r r zpositional argumentsoptionsc S r r r )r r r r identity r z)ArgumentParser.__init__..identityr, r hrG r z show this help message and exit)r r r ) r; r re _ospathbasenamerf argvr` r epilogformatter_classfromfile_prefix_charsadd_help allow_abbrev
exit_on_errorr r _positionals
_optionals _subparsersr r r r r r r )r4 r` r r r parentsr r r r r r r r superinit add_groupr default_prefixrj defaultsr= r r re sL
zArgumentParser.__init__c r' )N)r` r r r r r c r( r r) r+ r? r r rp r, z.ArgumentParser._get_kwargs..r r- r r? r r1 s zArgumentParser._get_kwargsc K s | j d ur | td |dt| d|v s d|v r4t|dd}t|dd }| ||| _ n| j| _ |dd u r[| }|
}| j }| | j
||d | |d< | |d}|d
d g i|}| j | |S ) Nz(cannot have multiple subparser argumentsrp r r subcommandsr` rr r r r )r r r rx r, r r r r rd _get_positional_actionsr r r rw r r r ) r4 rq r r ri r r
parsers_classr r r r add_subparsers s$
z ArgumentParser.add_subparsersc C s& |j r | j| |S | j| |S r )r r r r r r r r r s
zArgumentParser._add_actionc C dd | j D S )Nc S s g | ]}|j r|qS r r/ rm r r r r rp (
z8ArgumentParser._get_optional_actions..r r? r r r _get_optional_actions' z$ArgumentParser._get_optional_actionsc C r )Nc S s g | ]}|j s|qS r r/ r r r r rp - r z:ArgumentParser._get_positional_actions..r r? r r r r , r z&ArgumentParser._get_positional_actionsc C 4 | ||\}}|rtd}| |d| |S Nzunrecognized arguments: %sr )rw r r r3 r4 ro r3 r rz r r r
parse_args4
zArgumentParser.parse_argsc C s |d u r t jdd }nt|}|d u rt }| jD ]}|jtur4t||js4|jtur4t ||j|j q| j
D ]}t||sHt ||| j
| q8| j rmz
| ||\}}W n t
yl t d }| t| Y n w | ||\}}t|tr|t|t t|t ||fS r )rf r r< r r r
r r r r? r r _parse_known_argsr exc_infor r ry r r* delattr)r4 ro r3 r r
errr r r rw ; s6
z ArgumentParser.parse_known_argsc s j d ur
i jD ])}|j}t|jD ] \}} |g }||d | |||d d qqi g }t} t| D ]/\}}
|
dkr]|d | D ]}
|d qTqE |
} | d u rid} n| |< d} || qEd
|t t d fdd fd d
}
fd d }g d
rt
}nd}
|krt
fddD }
|kr|
}|
kr|
q|
vr
| }| |
|
|ks|
}|d g } jD ]=}|vr9|jr|t| q|jd ur9t|jtr9t|jr9|jt|ju r9t|j ||j q|rI tdd
| jD ]+}|jrv|jD ]
}|v r^ nqUdd |jD }td} |d
| qLfS )Nr r8 r AOrr c s | | |}|| jur1 | | g D ]}|v r0td}t|}t| || q|tur>| || d S d S )Nz not allowed with argument %s)r _get_valuesr r r r! r r )r argument_stringsr argument_valuesconflict_actionrz action_name)action_conflictsr3 seen_actionsseen_non_default_actionsr4 r r take_action s
z5ArgumentParser._parse_known_args..take_actionc s | }|\}}}j }g } |d u r | | d S |d ur||d}j}|dkrk|d |vrk|dkrk||g |f |d } | |d }|dd pQd }
j} || v r`| | }|
}nLtd} t|| | |dkr| d }
|g}||||f n.td} t|| | | d }|d }|||}|| }
||
}||||f nq|sJ |D ] \}}}||| q|
S )NTr r r rr z ignored explicit argument %r)_match_argumentr/ r r r r ) start_index option_tupler r explicit_argmatch_argument
action_tuples arg_countr charnew_explicit_arg
optionals_maprz stopro r selected_patterns)r6 arg_strings_patternextrasoption_string_indicesr4 r r r consume_optional sV
=z:ArgumentParser._parse_known_args..consume_optionalc sn j }| d }||}t|D ]\}} | | | }| |7 } || qt|d d d < | S r )_match_arguments_partialzipr )r
match_partialselected_pattern
arg_countsr r ro )r6 r r r4 r r r consume_positionals s
z=ArgumentParser._parse_known_args..consume_positionalsr r c s g | ]}| kr|qS r r )rm r )r r r rp s
z4ArgumentParser._parse_known_args..z(the following arguments are required: %sr+ c S s g | ] }|j turt|qS r )r r r! r r r r rp S s
z#one of the arguments %s is requiredr r ) r _read_args_from_filesr r r rx r iterr/ _parse_optionalr3 r r rR rQ r r r! r r r r r
r* r?
_get_valuer r )r4 r6 r3 r r r mutex_action conflictsarg_string_pattern_partsarg_strings_iter
arg_stringr patternr r$ max_option_string_indexnext_option_string_indexpositionals_end_indexstrings
stop_indexrequired_actionsr r r. rz r ) r r6 r r r3 r r r r
r4 r r r r b s
N
z ArgumentParser._parse_known_argsc C s g }|D ]c}|r|d | j vr|| qz.c S r r )r )rm r r r r rp r )r r r3 r[ r r r )r4 r r r r
actions_slicer. r r r? r r s z'ArgumentParser._match_arguments_partialc
C s |sd S |d | j vr
d S || jv r | j| }||d fS t|dkr$d S d|v r?|dd\}}|| jv r?| j| }|||fS | |}t|dkreddd |D }||d}td}| || n t|dkrp|\} | S | j |r{| j
s{d S d |v rd S d |d fS )
Nr r =r+ c S s g | ]\}}}|qS r r )rm r r r r r r rp s z2ArgumentParser._parse_optional..)r matchesz4ambiguous option: %(option)s could match %(matches)sr ) r r r split_get_option_tuplesr3 r r r r r )
r4 r- r r r
option_tuplesr ro rz r r r r r' s>
z ArgumentParser._parse_optionalc
C s0 g }| j }|d |v rA|d |v rA| jr?d|v r!|dd\}}n|}d }| jD ]}||r>| j| }|||f}|| q(|S |d |v r|d |vr|}d }|d d }|dd } | jD ]*}||krv| j| }||| f}|| q`||r| j| }|||f}|| q`|S | td| |S )Nr r r> rG z unexpected option string: %s)r r r@ r r: r/ r r )
r4 r r r
option_prefixr r r short_option_prefixshort_explicit_argr r r rA sB
z!ArgumentParser._get_option_tuplesc C s |j }|d u r
d}n3|tkrd}n,|tkrd}n%|tkr d}n |tkr&d}n|tkr-d}n|tkr4d}n dd d
| }|jrL| d d }| d d }|S )
Nz(-*A-*)z(-*A?-*)z (-*[A-]*)z
(-*A[A-]*)z([-AO]*)z (-*A[-AO]*)z(-*-*)z(-*%s-*)z-*r rr r )
r r r r
r r r r3 r r )r4 r r r; r r r r: s( z!ArgumentParser._get_nargs_patternc C r r )parse_known_intermixed_argsr r r3 r r r r parse_intermixed_args7 r z$ArgumentParser.parse_intermixed_argsc s | dd D }|rtd|d j fdd| jD r$tdz| j}z`| jd u r7| dd | _ D ]}|j|_t|_|j|_ t|_q9|
||\}} D ]%}t ||j ryt
||j g kryddlm} |d |j |f t||j qTW D ]
}|j|_|j |_q}n D ]
}|j|_|j |_qw | }z6|D ] }|j|_d
|_q| jD ] } | j| _d
| _q|
||\}}
W |D ]}|j|_q| jD ]} | j| _qn|D ]}|j|_q| jD ]} | j| _qw W || _||
fS || _w ) Nc S s g | ] }|j ttfv r|qS r )r r r r r r r rp L s z>ArgumentParser.parse_known_intermixed_args..z3parse_intermixed_args: positional arg with nargs=%sr c s& g | ]}|j D ] }| v r|jqqS r )r r
)rm r r r r r rp R s
z;parse_intermixed_args: positional in mutuallyExclusiveGroup )warnzDo not expect %s in %sF)r r r r r r
save_nargsr r save_defaultrw r r
r* warningsrJ r r r
save_required) r4 ro r3 a
save_usager remaining_argsrJ r r r r rH r rF > sx
z*ArgumentParser.parse_known_intermixed_argsc s j ttfvrz|d W n ty Y nw |s< j tkr< jr& j}n j}t |t
r: |} | |S |sY j t
krY jsY jd urO j}n|} | |S t|dkrw j d tfv rw|\} |} | |S j tkr fdd|D }|S j tkr fdd|D } |d |S j tkrt}|S fdd|D }|D ]} | q|S )Nr8 r c g | ]} |qS r r( rm vr r4 r r rp rq z.ArgumentParser._get_values..c rR r rS rT rV r r rp rq r c rR r rS rT rV r r rp rq )r r r r r r r r% r r r r( _check_valuer r r )r4 r r6 r: r- rU r rV r r sR
&
zArgumentParser._get_valuesc C s | d|j|j}t|std}t||| z||}W |S ty= t|jdt|j}tt
d }t|| t t fy_ t|jdt|j}||d}td}t||| w )Nr, r r- r )r, r: z!invalid %(type)s value: %(value)r)
r r, r r r r r* r0 r rf r r r )r4 r r- r rz r r9 ro r r r r( s"
zArgumentParser._get_valuec C sJ |j d ur!||j vr#|dtt|j d}td}t||| d S d S )Nr+ )r: r z3invalid choice: %(value)r (choose from %(choices)s))r r3 r r0 r r )r4 r r: ro rz r r r rW s zArgumentParser._check_valuec C s$ | }|| j| j| j | S r )rd r r r r rw )r4 ri r r r r s
zArgumentParser.format_usagec C st | }|| j| j| j || j | jD ]}||j ||j |
|j | q|| j
| S r )rd r r r r r~ r r rz r r r r{ r rw )r4 ri action_groupr r r rw s
zArgumentParser.format_helpc C s | j | jdS )Nr )r r` r? r r r rd
r@ z ArgumentParser._get_formatterc C " |d u rt j}| | | d S r )rf rg re r r4 filer r r print_usage
zArgumentParser.print_usagec C rY r )rf rg re rw rZ r r r r_
r] zArgumentParser.print_helpc C s$ |r|d u r t j}|| d S d S r )rf stderrwrite)r4 r r[ r r r re
s
z ArgumentParser._print_messager c C s |r | |tj t| d S r )re rf r^ r` )r4 statusr r r r r`
s zArgumentParser.exitc C s0 | tj | j|d}| dtd| dS )zerror(message: string)
Prints a usage message incorporating the message to stderr and
exits.
If you override this in a subclass, it should not return -- it
should either exit or raise an exception.
)r` r rG z %(prog)s: error: %(message)s
N)r\ rf r^ r` r` r )r4 r ro r r r r #
s zArgumentParser.errorr r )r N)#r- rA rB rC r re r1 r r r r r rw r r% r6 r r r' rA r: rG rF r r( rW r rw rd r\ r_ re r` r r@ r r r= r r sZ B
' {:-
1
M8
r )3rC __version____all__osr rer[ sysrf r r r rN r r r r
r r ry r r( rF r r r r r
r! Exceptionr r r r rB rJ rM rT rU rY rZ r] rb rh r} r r r r r r r r r r sl = ^)#&] 7 8"