/snap/core20/2866/usr/lib/python3.8/__pycache__
Edit: /snap/core20/2866/usr/lib/python3.8/__pycache__/argparse.cpython-38.pyc (62591B)
U
ʦi7x @ sR d Z dZdddddddd d
d d d
dddddgZddlZddlZddlZzddl m Z
m Z W n$ e k
r~ dd Z
dd Z Y nX dZ
dZd Zd Zd Zd Zd ZG d!d" d"eZd#d$ ZG d%d deZG d&d deZG d'd d eZG d(d deZG d)d
d
eZd*d+ Z G d,d de Z G d-d de Z G d.d d eZ 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@e Z)G dAdB dBe Z*G dCdD dDe%Z+G dEd deZ,G dFd d eZ-G dGdH dHeZ.G dIdJ dJe.Z/G dKdL dLe/Z0G dMd dee.Z1dS )Na
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.1ArgumentParser
ArgumentErrorArgumentTypeErrorFileType
HelpFormatter ArgumentDefaultsHelpFormatterRawDescriptionHelpFormatterRawTextHelpFormatterMetavarTypeHelpFormatter NamespaceAction ONE_OR_MOREOPTIONALPARSER REMAINDERSUPPRESS ZERO_OR_MORE N)gettextngettextc C s | S N )messager r /usr/lib/python3.8/argparse.py_^ s r c C s |dkr | S |S d S N r )ZsingularZpluralnr r r r ` s r z ==SUPPRESS==?*+zA......Z_unrecognized_argsc @ s( 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 ],\}}| rZ|d||f q6|||< q6|rz|dt| d|d|f S )N%s=%rz**%s%s(%s), )type__name__ _get_argsappendrepr _get_kwargs isidentifierjoin)selfZ type_name arg_stringsZ star_argsargnamevaluer r r __repr__| s
z_AttributeHolder.__repr__c C s t | j S r )sorted__dict__itemsr- r r r r* s z _AttributeHolder._get_kwargsc C s g S r r r6 r r r r' s z_AttributeHolder._get_argsN)r&
__module__ __qualname____doc__r2 r* r' r r r r r! s s r! c C s6 | d kr g S t | tkr$| d d S dd l}|| S )Nr )r% listcopy)r5 r; r r r _copy_items s r< c @ s e Zd ZdZd;ddZdd Zd d
ZG d d d eZd
d Z dd Z
dd Z dd Z d d}Y nX || _|| _t|t|d |d | _|| _ d| _
d| _ d| _ |
| d | _| j| _tdtj| _td| _d S )Nr r= F z\s+z\n\n\n+)Zshutilget_terminal_sizecolumns ImportError_prog_indent_incrementminmax_max_help_position_width_current_indent_level_action_max_length_Section
_root_section_current_section_recompileASCII_whitespace_matcher_long_break_matcher)r- progZindent_incrementZmax_help_positionwidthZ_shutilr r r __init__ s(
zHelpFormatter.__init__c C s" | j | j7 _ | jd7 _d S r )rJ rE rK r6 r r r _indent s zHelpFormatter._indentc C s4 | j | j8 _ | j dks"td| jd8 _d S )Nr zIndent decreased below 0.r )rJ rE AssertionErrorrK r6 r r r _dedent s zHelpFormatter._dedentc @ s e Zd ZdddZdd ZdS )zHelpFormatter._SectionNc C s || _ || _|| _g | _d S r ) formatterparentheadingr5 )r- r[ r\ r] r r r rW s z HelpFormatter._Section.__init__c C s | j d k r| j | jj}|dd | jD }| j d k rD| j |sLdS | jtk rz| jd k rz| jj}d|d| jf }nd}|d||dgS )Nc S s g | ]\}}|| qS r r ).0funcargsr r r
s z6HelpFormatter._Section.format_help.. z%*s%s:
) r\ r[ rX _join_partsr5 rZ r] r rJ )r- r, Z item_helpZcurrent_indentr] r r r format_help s
z"HelpFormatter._Section.format_help)N)r& r7 r8 rW re r r r r rM s
rM c C s | j j||f d S r )rO r5 r( )r- r_ r` r r r _add_item s zHelpFormatter._add_itemc C s0 | | | | j|}| |jg || _d S r )rX rM rO rf re )r- r] Zsectionr r r
start_section s zHelpFormatter.start_sectionc C s | j j| _ | d S r )rO r\ rZ r6 r r r end_section s
zHelpFormatter.end_sectionc C s$ |t k r |d k r | | j|g d S r )r rf _format_text)r- textr r r add_text s zHelpFormatter.add_textc C s& |t k r"||||f}| | j| d S r )r rf
_format_usage)r- usageactionsgroupsprefixr` r r r add_usage s zHelpFormatter.add_usagec C sv |j tk rr| j}||g}| |D ]}||| q$tdd |D }|| j }t| j|| _| | j |g d S )Nc S s g | ] }t |qS r lenr^ sr r r ra s z.HelpFormatter.add_argument..)
helpr _format_action_invocation_iter_indented_subactionsr( rG rJ rL rf _format_action)r- actionZget_invocationZ invocations subactionZinvocation_lengthZ
action_lengthr r r add_argument s
zHelpFormatter.add_argumentc C s |D ]}| | qd S r )r| )r- rn rz r r r
add_arguments s zHelpFormatter.add_argumentsc C s. | j }|r*| jd|}|dd }|S )N
rc )rN re rT substrip)r- rv r r r re % s
zHelpFormatter.format_helpc C s d dd |D S )Nrb c S s g | ]}|r|t k r|qS r )r )r^ partr r r ra - s z-HelpFormatter._join_parts..)r, )r- Z part_stringsr r r rd , s
zHelpFormatter._join_partsc s6 |d krt d}|d k r,|t| jd }n|d krL|sLdt| jd }n|d kr*dt| jd }g }g }|D ] }|jr|| qr|| qr| j} | || |}
ddd ||
fD }| j| j t |t | kr*d} | ||} | ||}
t
| | }t
| |
}d|| ks&t d||
ks:t d fdd }t |t | d
krdt |t | d }|r||g| ||}|
||| n |r||g| ||}n|g}nZdt | }|| }|||}t |d krg }|
||| |
||| |g| }d |}d
||f S )Nzusage: rU z%(prog)s c S s g | ] }|r|qS r r rt r r r ra M s z/HelpFormatter._format_usage..z%\(.*?\)+(?=\s|$)|\[.*?\]+(?=\s|$)|\S+c s g }g }|d k r t |d }n t |d }| D ]Z}|d t | krn|rn||d| g }t |d }|| |t |d 7 }q.|r||d| |d k r|d t |d |d< |S )Nr r r )rs r( r, )partsindentrp lineslineZline_lenr
text_widthr r get_linesa s"
z.HelpFormatter._format_usage..get_linesg ?r rc z%s%s
)N)r dictrD option_stringsr( _format_actions_usager, rI rJ rs rP findallrY extend)r- rm rn ro rp rU optionals positionalsrz formatZ action_usageZ part_regexpZ opt_usageZ pos_usageZ opt_partsZ pos_partsr r r r r r r rl 1 s\
zHelpFormatter._format_usagec C s t }i }|D ]}z||jd }W n tk
r@ Y qY qX |t|j }||| |jkr|jD ]}|| qh|js||kr|| d7 < nd||< ||kr|| d7 < nd||< nF||kr|| d7 < nd||< ||kr|| d7 < nd||< t|d |D ]} d || < qqg }
t|D ]"\} }|j t
kr|
d | | d krr|
| n"| | d d krX|
| d n|js| |} | || } ||kr| d dkr| d
dkr| dd
} |
| nf|jd }
|jdkrd |
} n"| |} | || }d |
|f } |jsN||krNd
| } |
| q6t|ddD ]} || g|
| | < qhddd |
D }d}d}td| d|}td| d|}td||f d|}tdd|}| }|S )Nr z [[]z (()r |%s%s %s[%s]T)reverser c S s g | ]}|d k r|qS r r )r^ itemr r r ra s z7HelpFormatter._format_actions_usage..z[\[(]z[\])]z(%s) z\1 (%s)z%s *%srb z \(([^|]*)\))setindex_group_actions
ValueErrorrs addrequiredrange enumeraterv r r( getpopr #_get_default_metavar_for_positional _format_argsnargs!_get_default_metavar_for_optionalr3 r, rP r r )r- rn ro
group_actionsZinsertsgroupstartendrz ir defaultr
option_string args_stringrj opencloser r r r sz
z#HelpFormatter._format_actions_usagec C sF d|kr|t | jd }t| j| j d}d| j }| |||d S )Nz%(prog)r r r~ )r rD rG rI rJ
_fill_text)r- rj r r r r r ri s
zHelpFormatter._format_textc
C s: t | jd | j}t| j| d}|| j d }| |}|jsV| jd|f}d| }n@t||kr~| jd||f}d| }d}n| jd|f}d| }|}|g}|jr| |} |
| |}
| d|d|
d f |
dd D ]} | d|d| f qn| ds| d |
|D ]} | | | q| |S ) Nr= r rb z%*s%s
z %*s%-*s r r rc )rF rL rH rG rI rJ rw rv rs _expand_help _split_linesr( endswithrx ry rd )
r- rz Z
help_positionZ
help_widthZ action_widthZ
action_headertupZ indent_firstr Z help_textZ
help_linesr r{ r r r ry s8
z HelpFormatter._format_actionc C s |j s&| |}| ||d\}|S g }|jdkrB||j n4| |}| ||}|j D ]}|d||f q^d|S d S )Nr r r r$ ) r r _metavar_formatterr r r r r( r, )r- rz r metavarr r r r r r rw . s
z'HelpFormatter._format_action_invocationc sP |j d k r|j n.|jd k r.z{%s},c s t tr S f| S d S r )
isinstancetuple)Z
tuple_sizeresultr r r O s
z0HelpFormatter._metavar_formatter..format)r choicesr, )r- rz default_metavarZ choice_strsr r r r r F s
z HelpFormatter._metavar_formatterc C s | ||}|jd kr$d|d }n|jtkr.zinvalid nargs valuer ) r r r
r r r r r r TypeErrorr r, )r- rz r Z get_metavarr Zformatsr r r r V s*
zHelpFormatter._format_argsc C s t t|| jd}t|D ]}|| tkr||= qt|D ] }t|| dr:|| j||< q:|dd k rddd |d D }||d< | || S )Nr r& r r$ c S s g | ] }t |qS r r )r^ cr r r ra w s z.HelpFormatter._expand_help..)
r varsrD r: r hasattrr& r r, _get_help_string)r- rz Zparamsr0 Z choices_strr r r r n s zHelpFormatter._expand_helpc c s@ z
|j }W n tk
r Y n X | | E d H | d S r )_get_subactionsAttributeErrorrX rZ )r- rz Zget_subactionsr r r rx { s
z'HelpFormatter._iter_indented_subactionsc C s& | j d| }dd l}|||S )Nr r )rS r r textwrapZwrap)r- rj rV r r r r r s zHelpFormatter._split_linesc C s, | j d| }dd l}|j||||dS )Nr r )Zinitial_indentZsubsequent_indent)rS r r r Zfill)r- rj rV r r r r r r s zHelpFormatter._fill_textc C s |j S r )rv r- rz r r r r s z HelpFormatter._get_help_stringc C s
|j S r )destupperr r r r r s z/HelpFormatter._get_default_metavar_for_optionalc C s |j S r )r r r r r r s z1HelpFormatter._get_default_metavar_for_positional)r= r> N)N) r& r7 r8 r9 rW rX rZ objectrM rf rg rh rk rq r| r} re rd rl r ri ry rw r r r rx r r r r r r r r r r s>
"
`g/
c @ s 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 )Nrb c 3 s | ]} | V qd S r r )r^ r r r r s z9RawDescriptionHelpFormatter._fill_text..T)keepends)r,
splitlines)r- rj rV r r r r r s z&RawDescriptionHelpFormatter._fill_textN)r& r7 r8 r9 r r r r r r s c @ s e Zd ZdZdd ZdS )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 )r- rj rV r r r r s z!RawTextHelpFormatter._split_linesN)r& r7 r8 r9 r r r r r r s c @ s e Zd ZdZdd ZdS )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 kr:|jtk r:ttg}|js2|j|kr:|d7 }|S )Nz
%(default)z (default: %(default)s))rv r r r
r r r )r- rz rv Zdefaulting_nargsr r r r s
z.ArgumentDefaultsHelpFormatter._get_help_stringN)r& r7 r8 r9 r r r r r r s c @ s 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 s |j jS r r% r& r r r r r s z:MetavarTypeHelpFormatter._get_default_metavar_for_optionalc C s |j jS r r r r r r r s z.r r- namesr r6 r r* K s zAction._get_kwargsc C s t tdd S )Nz.__call__() not defined)NotImplementedErrorr r- parser namespacevaluesr r r r __call__Y s zAction.__call__)NNNNNFNN)N)r& r7 r8 r9 rW r* r r r r r r s 5
c s( e Zd Zd fdd ZdddZ ZS ) _StoreActionNFc sT |dkrt d|d k r,|tkr,t 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
superr rW r __class__r r rW _ s
z_StoreAction.__init__c C s t || j| d S r )setattrr r r r r r | s z_StoreAction.__call__)NNNNNFNN)Nr& r7 r8 rW r
__classcell__r r r r r ] s r c s( e Zd Zd fdd ZdddZ ZS ) _StoreConstActionNFc s" t t| j||d||||d d S )Nr )r r r r r r rv )r r rW r- r r r r r rv r r r r rW s
z_StoreConstAction.__init__c C s t || j| j d S r )r r r r r r r r s z_StoreConstAction.__call__)NFNN)Nr r r r r r s r c s e Zd Zd fdd Z ZS )_StoreTrueActionFNc s t t| j||d|||d d S )NTr r r r r rv )r r rW r- r r r r rv r r r rW s
z_StoreTrueAction.__init__)FFNr& r7 r8 rW r r r r r r s r c s e Zd Zd fdd Z ZS )_StoreFalseActionTFNc s t t| j||d|||d d S )NFr )r r rW r r r r rW s
z_StoreFalseAction.__init__)TFNr r r r r r s r c s( e Zd Zd fdd ZdddZ ZS )
_AppendActionNFc sT |dkrt d|d k r,|tkr,t dt tt| j||||||||| |
d
d S )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 appropriater r )r r
r r rW r r r r rW s
z_AppendAction.__init__c C s2 t || jd }t|}|| t|| j| d S r )r r r< r( r r- r r r r r5 r r r r s
z_AppendAction.__call__)NNNNNFNN)Nr r r r r r s r c s( e Zd Zd fdd ZdddZ ZS ) _AppendConstActionNFc
s$ t t| j||d|||||d d S )Nr )r r r r r r rv r )r r rW r r r r rW s
z_AppendConstAction.__init__c C s4 t || jd }t|}|| j t|| j| d S r )r r r< r( r r r r r r r s z_AppendConstAction.__call__)NFNN)Nr r r r r r s r c s( e Zd Zd fdd ZdddZ ZS ) _CountActionNFc s t t| j||d|||d d S )Nr )r r r r r rv )r r rW r r r r rW s
z_CountAction.__init__c C s0 t || jd }|d krd}t|| j|d d S Nr r )r r r )r- r r r r countr r r r
s z_CountAction.__call__)NFN)Nr r r r r r s
r c s. e Zd Zeedf fdd ZdddZ ZS ) _HelpActionNc s t t| j|||d|d d S Nr )r r r r rv )r r rW )r- r r r rv r r r rW s
z_HelpAction.__init__c C s | | d S r )
print_helpexitr r r r r s z_HelpAction.__call__)Nr& r7 r8 r rW r r r r r r r 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 r rW version)r- r r r r rv r r r rW & s
z_VersionAction.__init__c C sD | j }|d kr|j }| }|| || tj | d S r )r _get_formatterrk _print_messagere _sysstdoutr )r- r r r r r r[ r r r r 4 s
z_VersionAction.__call__)Nr r r r r r $ s r 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 rv r )r, r r _ChoicesPseudoActionrW )r- r0 aliasesrv r r Zsupr r r rW B s
z/_SubParsersAction._ChoicesPseudoAction.__init__r r r r r r
@ s r
FNc s< || _ || _i | _g | _tt| j||t| j|||d d S )N)r r r r r rv r ) _prog_prefix
_parser_class_name_parser_map_choices_actionsr r rW r )r- r rU parser_classr r rv r r r r rW J s
z_SubParsersAction.__init__c K s | dd kr d| j|f |d< |dd}d|krX|d}| |||}| j| | jf |}|| j|< |D ]}|| j|< qr|S )NrU r r r rv )r r r r
r r( r r )r- r0 kwargsr rv Z
choice_actionr aliasr r r
add_parsera s
z _SubParsersAction.add_parserc C s | j S r )r r6 r r r r x s z!_SubParsersAction._get_subactionsc C s |d }|dd }| j tk r,t|| j | z| j| }W n< tk
rv |d| jd}td| }t| |Y nX ||d \} }t |
D ]\}
} t||
| q|rt | t g t
|t | d S )Nr r r$ ) parser_namer z5unknown parser %(parser_name)r (choices: %(choices)s))r r r r KeyErrorr, r r parse_known_argsr r5
setdefault_UNRECOGNIZED_ARGS_ATTRr r ) r- r r r r r r. r` msgZ subnamespacekeyr1 r r r r { s$
z_SubParsersAction.__call__)N) r& r7 r8 r r
r rW r r r r r r r r r > s r c @ s e Zd ZdddZdS )
_ExtendActionNc C s2 t || jd }t|}|| t|| j| d S r )r r r< r r r r r r r s
z_ExtendAction.__call__)N)r& r7 r8 r 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)r- modebufsizeencodingerrorsr r r rW s zFileType.__init__c
C s |dkr>d| j krtjS d| j kr(tjS td| j }t|zt|| j | j| j| j W S t
k
r } z"||d}td}t || W 5 d }~X Y nX d S )N-r wzargument "-" with mode %r)filenameerrorz$can't open '%(filename)s': %(error)s) r r
stdinr r r r r! r" r# OSErrorr )r- stringr er` r r r r r 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 )r) )r^ r/ r r r ra s z%FileType.__repr__..c S s$ g | ] \}}|d k rd||f qS )Nr" r )r^ kwr/ r r r ra s r# )r r! r" r# r, r% r& )r- r` r Zargs_strr r r r2 s zFileType.__repr__)r r NN)r& r7 r8 r9 rW r r2 r r r r r s
c @ s( e Zd ZdZdd Zdd Zdd ZdS ) 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 )r- r r0 r r r rW s zNamespace.__init__c C s t |tstS t| t|kS r )r r
NotImplementedr )r- otherr r r __eq__ s
zNamespace.__eq__c C s
|| j kS r )r4 )r- r r r r __contains__ s zNamespace.__contains__N)r& r7 r8 r9 rW r3 r4 r r r r r
s 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 )Nrz ZstoreZ store_const
store_trueZ store_falser( Z append_constr rv r parsersr z^-\d+$|^-\d*\.\d+$) r r5 rW descriptionargument_default prefix_charsconflict_handler _registriesregisterr r r r r r r r r r r _get_handler_actions_option_string_actions_action_groups_mutually_exclusive_groups _defaultsrP rQ _negative_number_matcher _has_negative_number_optionals)r- r8 r: r9 r; r r r rW s4 z_ActionsContainer.__init__c C s | j |i }|||< d S r )r< r )r-
registry_namer1 r registryr r r r= ( s z_ActionsContainer.registerNc C s | j | ||S r )r< r )r- rF r1 r r r r
_registry_get, s z _ActionsContainer._registry_getc K s2 | j | | jD ]}|j|kr||j |_qd S r )rC updater? r r )r- r rz r r r set_defaults2 s
z _ActionsContainer.set_defaultsc C s8 | j D ]"}|j|kr|jd k r|j S q| j|d S r )r? r r rC r )r- r rz r r r get_default; s
z _ActionsContainer.get_defaultc O sD | j }|r&t|dkrH|d d |krH|r:d|kr:td| j||}n | j||}d|kr|d }|| jkr~| j| |d< n| jdk r| j|d< | |}t|std|f |f |}| d|j
|j
}t|std |f |t krtd
|f t | d r:z|
|d W n tk
r8 td Y nX | |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 passedr z,length of metavar tuple does not match nargs)r: rs r _get_positional_kwargs_get_optional_kwargsrC r9 _pop_action_classcallablerH r% r r r r r _add_action)r- r` r charsr Z action_classrz type_funcr r r r| E s:
z _ActionsContainer.add_argumentc O s t | f||}| j| |S r )_ArgumentGrouprA r( )r- r` r r r r r add_argument_groupx s z$_ActionsContainer.add_argument_groupc K s t | f|}| j| |S r )_MutuallyExclusiveGrouprB r( )r- r r r r r add_mutually_exclusive_group} s z._ActionsContainer.add_mutually_exclusive_groupc C s` | | | j| | |_|jD ]}|| j|< q"|jD ]"}| j|r8| js8| jd q8|S )NT) _check_conflictr? r( containerr r@ rD matchrE )r- rz r r r r rQ 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|kr.td}t||j |||j< q
i }|j D ]D}|j|krn| j|j|j|jd||j< |jD ]}||j ||< qtqD|jD ]&}| j |j
d}|jD ] }|||< qq|j D ]}| ||
| qd S )Nz.cannot merge actions - two groups are named %r)titler8 r; )r )rA r] r r rU r8 r; r rB rW r r? r rQ )r- rY Ztitle_group_mapr r Z group_maprz mutex_groupr r r _add_container_actions s0
z(_ActionsContainer._add_container_actionsc K s^ d|krt d}t||dttfkr2d|d< |dtkrPd|krPd|d< t||g dS )Nr z1'required' is an invalid argument for positionalsr Tr r r )r r r r
r r )r- r r r r r r rM s z(_ActionsContainer._get_positional_kwargsc O s g }g }|D ]n}|d | j kr>|| j d}td}t|| || |d | j kr t|dkr |d | j kr || q |dd }|d kr|r|d }n|d }|| j }|std}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( rs r lstripreplacer ) r- r` r r Zlong_option_stringsr r r Zdest_option_stringr r r rN s2
z&_ActionsContainer._get_optional_kwargsc C s | d|}| d||S )Nrz )r rH )r- r r rz r r r rO s z#_ActionsContainer._pop_action_classc C sF d| j }z t| |W S tk
r@ td}t|| j Y nX d S )Nz_handle_conflict_%sz%invalid conflict_resolution value: %r)r; r r r r )r- Zhandler_func_namer r r r r> s
z _ActionsContainer._get_handlerc C sL g }|j D ]&}|| jkr
| j| }|||f q
|rH| }||| d S r )r r@ r( r> )r- rz Zconfl_optionalsr Zconfl_optionalr; r r r rX s
z!_ActionsContainer._check_conflictc C s6 t ddt|}ddd |D }t||| d S )Nz conflicting option string: %sz conflicting option strings: %sr$ c S s g | ] \}}|qS r r )r^ r rz r r r ra s z<_ActionsContainer._handle_conflict_error..)r rs r, r )r- rz conflicting_actionsr Zconflict_stringr r r _handle_conflict_error s
z(_ActionsContainer._handle_conflict_errorc C s> |D ]4\}}|j | | j|d |j s|j| qd S r )r r[ r@ r rY r\ )r- rz rd r r r r _handle_conflict_resolve s
z*_ActionsContainer._handle_conflict_resolve)N)N)r& r7 r8 rW r= rH rJ rK r| rU rW rQ r\ r_ rM rN rO r> rX re rf r r r r r r5 s$ 5
3($
r5 c s6 e Zd Zd fdd Z fddZ fddZ ZS ) rT Nc s |j }|d|j |d|j |d|j tt| j}|f d|i| || _g | _|j | _ |j
| _
|j | _ |j | _ |j
| _
|j| _d S )Nr; r: r9 r8 )r r; r: r9 r rT rW r] r r< r? r@ rC rE rB )r- rY r] r8 r rI Z
super_initr r r rW + s z_ArgumentGroup.__init__c s t t| |}| j| |S r )r rT rQ r r( r r r r rQ A s z_ArgumentGroup._add_actionc s t t| | | j| d S r )r rT r\ r r[ r r r r r\ F s z _ArgumentGroup._remove_action)NNr& r7 r8 rW rQ r\ r r r r r rT ) s rT c s. e Zd Zd fdd Zdd Zdd Z ZS ) rV Fc s t t| | || _|| _d S r )r rV rW r
_container)r- rY r r r r rW M s z _MutuallyExclusiveGroup.__init__c C s2 |j rtd}t|| j|}| j| |S )Nz-mutually exclusive arguments must be optional)r r r rh rQ r r( )r- rz r r r r rQ R s z#_MutuallyExclusiveGroup._add_actionc C s | j | | j| d S r )rh r\ r r[ r r r r r\ Z s z&_MutuallyExclusiveGroup._remove_action)Frg r r r r rV K s rV c s* e Zd ZdZddddg eddddddf fdd Zdd Zd
d Zd d
Zdd Z dd Z
dAddZ dBddZ dd Z
dd Zdd Zd d Zd d Zd d! Zd"d# Zd$d% ZdCd&d'ZdDd(d)Zd*d+ Zd,d- Zd.d/ Zd0d1 Zd2d3 Zd4d5 Z dEd6d7Z dFd8d9Z dGd:d;Z dHd=d>Z d?d@ Z! Z"S )Ir a Object for parsing command line strings into Python objects.
Keyword Arguments:
- prog -- The name of the program (default: 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
Nr( r+ Tc
s" t t| j}
|
||| |
d |d kr6tjtjd }|| _|| _ || _
|| _ || _ | | _
| | _| j}|td| _|td| _d | _dd }| dd | d|krdn|d }| j
r| j|d |d
d d ttd d
|D ]<}| | z
|j}W n tk
r Y qX | j| qd S )N)r8 r: r9 r; r zpositional argumentszoptional argumentsc S s | S r r )r. r r r identity s z)ArgumentParser.__init__..identityr% r( hr= rv z show this help message and exit)rz r rv )r r rW _ospathbasenamer
argvrU rm epilogformatter_classfromfile_prefix_charsadd_help allow_abbrevrU r _positionals
_optionals _subparsersr= r| r r_ rC r rI )r- rU rm r8 ro parentsrp r: rq r9 r; rr rs Z superinitZ add_groupri Zdefault_prefixr\ defaultsr r r rW r sJ
zArgumentParser.__init__c s" ddddddg} fdd|D S ) NrU rm r8 rp r; rr c s g | ]}|t |fqS r r r r6 r r ra s z.ArgumentParser._get_kwargs..r r r r6 r r* s zArgumentParser._get_kwargsc K s | j d k r| td |dt| d|ks8d|krht|dd}t|dd }| ||| _ n| j| _ |dd kr| }|
}| j }| | j
||d | |d< | |d}|f d g i|}| j | |S )
Nz(cannot have multiple subparser argumentsr r] r8 Z subcommandsrU rb r7 r )rv r+ r r r% r rU rt r r _get_positional_actionsrB rq rm re r rO rQ ) r- r r] r8 r[ r ro Z
parsers_classrz r r r add_subparsers s$
z ArgumentParser.add_subparsersc C s$ |j r| j| n | j| |S r )r ru rQ rt r r r r rQ s zArgumentParser._add_actionc C s dd | j D S )Nc S s g | ]}|j r|qS r r r^ rz r r r ra s z8ArgumentParser._get_optional_actions..r? r6 r r r _get_optional_actions s z$ArgumentParser._get_optional_actionsc C s dd | j D S )Nc S s g | ]}|j s|qS r r{ r| r r r ra s z:ArgumentParser._get_positional_actions..r} r6 r r r ry s z&ArgumentParser._get_positional_actionsc C s4 | ||\}}|r0td}| |d| |S Nzunrecognized arguments: %sr )r r r+ r, r- r` r rn r r r r
parse_args s
zArgumentParser.parse_argsc C s |d krt jdd }nt|}|d kr.t }| jD ]4}|jtk r4t||js4|jtk r4t ||j|j q4| j
D ] }t||spt ||| j
| qpz>| ||\}}t|t r|
t|t t|t ||fW S tk
r t d }| t| Y nX d S r )r
rn r: r
r? r r r r r rC _parse_known_argsr r r delattrr exc_infor+ r )r- r` r rz r errr r r r s,
z ArgumentParser.parse_known_argsc s j d k r i jD ]R}|j}t|jD ]<\}} |g }||d | |||d d q2q i g }t} t| D ]^\}}
|
dkr|d | D ]}
|d qq |
} | d krd} n | |< d} || qd
|t t d fdd fd d
}
fd d }g d
r`t
}nd}
|krt
fddD }
|kr|
}|
kr|
qdn|
kr҈
| }| |
|
qd|
}|d g } jD ]|}|kr|jr(|t| nT|jd k rt|jtrt|jr|jt|jkrt|j ||j q|r tdd
| jD ]X}|jr|jD ]}|kr qqdd |jD }td} |d
| qfS )Nr --r( AOrb c s| | | |}|| jk rb | | g D ]*}|kr6td}t|}t| || q6|tk rx| || d S )Nz not allowed with argument %s)r _get_valuesr r r r r r )rz Zargument_stringsr Zargument_valuesZconflict_actionr Z action_name)action_conflictsr seen_actionsseen_non_default_actionsr- r r take_actionL s
z5ArgumentParser._parse_known_args..take_actionc s | }|\}}}j }g }|d kr: | | d S |d k r||d}j}|dkr|d |kr||g |f |d } | |d }|dd pd }
j} || kr| | }|
}ntd} t|| | nB|dkr| d }
|g}||||f q\ntd} t|| | q | d }|d }|||}|| }
||
}||||f q\q |sft|D ]\}}}||| qj|
S )Nr r r z ignored explicit argument %r)_match_argumentr( r: r@ r r rY ) start_index option_tuplerz r explicit_argZmatch_argumentZ
action_tuples arg_countrR charZnew_explicit_argZ
optionals_mapr stopr` r Zselected_patterns)r. arg_strings_patternextrasoption_string_indicesr- r r r consume_optionala sN
z:ArgumentParser._parse_known_args..consume_optionalc sn j }| d }||}t|D ]*\}} | | | }| |7 } || q&t|d d d < | S r )_match_arguments_partialziprs )r Z
match_partialZselected_patternZ
arg_countsrz r r` )r. r r r- r r r consume_positionals s
z=ArgumentParser._parse_known_args..consume_positionalsr r c s g | ]}| kr|qS r r )r^ r )r r r ra s z4ArgumentParser._parse_known_args..z(the following arguments are required: %sr$ c S s g | ]}|j tk rt|qS r )rv r r r| r r r ra
s
z#one of the arguments %s is requiredr )N) rq _read_args_from_filesrB r r r r iterr( _parse_optionalr, r ry rG rF r? r r r r r r r r r
_get_valuer+ r )r- r. r r^ r r Z mutex_actionZ conflictsZarg_string_pattern_partsZarg_strings_iter
arg_stringr patternr r Zmax_option_string_indexZnext_option_string_indexZpositionals_end_indexZstringsZ
stop_indexZrequired_actionsrz r r r r ) r r. r r r r r r r r- r r r r s
J
z ArgumentParser._parse_known_argsc
C s g }|D ]}|r |d | j kr*|| qzdt|dd J}g }| D ] }| |D ]}|| q\qN| |}|| W 5 Q R X W q tk
r t
d }| t | Y qX q|S r )
rq r( r readr convert_arg_line_to_argsr r r- r
r r+ r )r- r. Znew_arg_stringsr Z args_filearg_liner/ r r r r r s
z$ArgumentParser._read_args_from_filesc C s |gS r r )r- r r r r r - s z'ArgumentParser.convert_arg_line_to_argsc C sz | |}t||}|d krld tdttdttdi}||j}|d krbtdd|j|j }t ||t
| dS )Nzexpected one argumentz expected at most one argumentz expected at least one argumentzexpected %s argumentzexpected %s argumentsr ) _get_nargs_patternrP rZ r r
r r r r r rs r )r- rz r
nargs_patternrZ Z nargs_errorsr r r r r 0 s(
z ArgumentParser._match_argumentc sr g }t t|ddD ]X}|d | }d fdd|D }t||}|d k r|dd | D qnq|S )Nr r rb c s g | ]} |qS r )r r| r6 r r ra L s z;ArgumentParser._match_arguments_partial..c S s g | ] }t |qS r rr )r^ r. r r r ra P s )r rs r, rP rZ r ro )r- rn r r r Z
actions_slicer rZ r r6 r r F s z'ArgumentParser._match_arguments_partialc
C s |sd S |d | j krd S || jkr8| j| }||d fS t|dkrHd S d|kr~|dd\}}|| jkr~| j| }|||fS | |}t|dkrddd |D }||d}td}| || nt|dkr|\} | S | j |r| j
sd S d |krd S d |d fS )
Nr r =r$ c S s g | ]\}}}|qS r r )r^ rz r r r r r ra u s z2ArgumentParser._parse_optional..)ra Zmatchesz4ambiguous option: %(option)s could match %(matches)sr ) r: r@ rs split_get_option_tuplesr, r r+ rD rZ rE )
r- r rz r r Z
option_tuplesZoptionsr` r r r r r r V s>
z ArgumentParser._parse_optionalc
C s0 g }| j }|d |kr|d |kr| jr~d|krB|dd\}}n|}d }| jD ],}||rP| j| }|||f}|| qPn|d |kr|d |kr|}d }|d d }|dd } | jD ]T}||kr| j| }||| f}|| q||r| j| }|||f}|| qn| td| |S )Nr r r r= z unexpected option string: %s)r: rs r r@
startswithr( r+ r )
r- r r rR Z
option_prefixr rz r Zshort_option_prefixZshort_explicit_argr r r r s:
z!ArgumentParser._get_option_tuplesc C s |j }|d krd}nf|tkr"d}nX|tkr0d}nJ|tkr>d}n<|tkrLd}n.|tkrZd}n |tkrhd}ndd d
| }|jr| d d }| d d }|S )
Nz(-*A-*)z(-*A?-*)z (-*[A-]*)z
(-*A[A-]*)z([-AO]*)z (-*A[-AO]*)z(-*-*)z(-*%s-*)z-*r rb r( )
r r
r r r r r r, r rc )r- rz r r r r r r s( z!ArgumentParser._get_nargs_patternc C s4 | ||\}}|r0td}| |d| |S r )parse_known_intermixed_argsr r+ r, r r r r parse_intermixed_args s
z$ArgumentParser.parse_intermixed_argsc s | dd D }|r,td|d j fdd| jD rHtdzN| j}z| jd krp| dd | _ D ] }|j|_t |_|j|_t |_qt|
||\}} D ]J}t ||j rt
||j g krddlm} |d |j |f t||j qW 5 D ]}|j|_|j|_qX | }zJ|D ]}|j|_d
|_q$| jD ]} | j| _d
| _q@|
||\}}
W 5 |D ]}|j|_qn| jD ]} | j| _qX W 5 || _X ||
fS ) Nc S s g | ]}|j ttfkr|qS r )r r r r| r r r ra s z>ArgumentParser.parse_known_intermixed_args..z3parse_intermixed_args: positional arg with nargs=%sr c s& g | ] }|j D ]}| kr|jqqS r )r r )r^ r rz r r r ra s
z;parse_intermixed_args: positional in mutuallyExclusiveGroup )warnzDo not expect %s in %sF)ry r r rB rm Z
save_nargsZ save_defaultr format_usager r r r r warningsr r r~ Z
save_requiredr ) r- r` r aZ
save_usagerz Zremaining_argsr r r r r r r r s`
z*ArgumentParser.parse_known_intermixed_argsc s j ttfkr2z|d W n tk
r0 Y nX |sz j tkrz jrN j}n j}t |t
rv |} | n|s j t
kr js jd k r j}n|} | nt|dkr j d tfkr|\} |} | n j tkr fdd|D }np j tkr@ fdd|D } |d n> j tkrRt}n, fdd|D }|D ]} | qj|S )Nr r c s g | ]} |qS r r r^ vrz r- r r ra f s z.ArgumentParser._get_values..c s g | ]} |qS r r r r r r ra j s r c s g | ]} |qS r r r r r r ra s s )r r r r[ r r
r r r r r r _check_valuer rs r )r- rz r. r1 r r r r r r B sD
zArgumentParser._get_valuesc C s | d|j|j}t|s0td}t||| z ||}W n tk
r~ t|jdt|j}tt
d }t||Y nL t t fk
r t|jdt|j}||d}td}t||| Y nX |S )Nr% rL r& r )r% r1 z!invalid %(type)s value: %(value)r)
rH r% rP r r r r r) r r
r r r )r- rz r rS r r r0 r` r r r r z s
zArgumentParser._get_valuec C sF |j d k rB||j krB|dtt|j d}td}t||| d S )Nr$ )r1 r z3invalid choice: %(value)r (choose from %(choices)s))r r, mapr) r r )r- rz r1 r` r r r r r s zArgumentParser._check_valuec C s$ | }|| j| j| j | S r )r rq rm r? rB re )r- r[ r r r r s
zArgumentParser.format_usagec C st | }|| j| j| j || j | jD ]0}||j ||j |
|j | q.|| j
| S r )r rq rm r? rB rk r8 rA rg r] r} r rh ro re )r- r[ Z action_groupr r r re s
zArgumentParser.format_helpc C s | j | jdS )Nr )rp rU r6 r r r r s z ArgumentParser._get_formatterc C s" |d krt j}| | | d S r )r
r r r r- filer r r print_usage s zArgumentParser.print_usagec C s" |d krt j}| | | d S r )r
r r re r r r r r s zArgumentParser.print_helpc C s |r |d krt j}|| d S r )r
stderrwrite)r- r r r r r r s z ArgumentParser._print_messager c C s |r| |tj t| d S r )r r
r r )r- Zstatusr 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.
)rU r r= z %(prog)s: error: %(message)s
N)r r
r rU r r )r- r r` r r r r+ s zArgumentParser.error)NN)NN)NN)NN)N)N)N)r N)#r& r7 r8 r9 r rW r* rz rQ r~ ry r r r r r r r r r r r r r r r r re r r r r r r+ r r r r r r _ sV @
# w:-1
M8
)2r9 __version____all__osrk rerP sysr
r r r rC r r
r r r r r r r! r< r r r r r r Exceptionr r r r r r r r r r r r r r r r
r5 rT rV r r r r r s = ~
[#&] 7 :"