U
e5dw @ s0 d Z dZdddddddd d
d d d
dddddgZddlZddlZddlZddl Z
ddl m Z m
Z
dZdZdZdZdZdZd ZG d d d eZd d ZG d!d deZG d"d deZG d#d d eZG d$d deZG d%d
d
eZ d&d' Z G d(d de Z G d)d de Z G d*d d eZ!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@e&Z,G dAd deZ-G dBd d eZ.G dCdD dDeZ/G dEdF dFe/Z0G dGdH dHe0Z1G dId dee/Z2dS )Ja
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)gettextngettextz ==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_argsargnamevalue r* /usr/lib64/python3.8/argparse.py__repr__t s
z_AttributeHolder.__repr__c C s t | j S N)sorted__dict__itemsr% r* r* r+ r" s z _AttributeHolder._get_kwargsc C s g S r- r* r1 r* r* r+ r s z_AttributeHolder._get_argsN)r
__module__ __qualname____doc__r, r" r r* r* r* r+ r k s r c C s6 | d kr g S t | tkr$| d d S dd l}|| S )Nr )r listcopy)r0 r6 r* r* r+ _copy_items s r7 c @ s e Zd ZdZd;ddZdd Zd d
ZG d d d eZd
d Z dd Z
dd Z dd Z d s z6HelpFormatter._Section.format_help.. z%*s%s:
) rX rW rT _join_partsr0 rV rY r rD )r% r$ Z item_helpZcurrent_indentrY r* r* r+ format_help s
z"HelpFormatter._Section.format_help)N)r r2 r3 rQ ra r* r* r* r+ rG s
rG c C s | j j||f d S r- )rI r0 r )r% r[ r\ r* r* r+ _add_item s zHelpFormatter._add_itemc C s0 | | | | j|}| |jg || _d S r- )rT rG rI rb ra )r% rY Zsectionr* r* r+
start_section s zHelpFormatter.start_sectionc C s | j j| _ | d S r- )rI rX rV r1 r* r* r+ end_section s
zHelpFormatter.end_sectionc C s$ |t k r |d k r | | j|g d S r- )r rb _format_text)r% textr* r* r+ add_text s zHelpFormatter.add_textc C s& |t k r"||||f}| | j| d S r- )r rb
_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* lenrZ sr* r* r+ r]
s z.HelpFormatter.add_argument..)
helpr _format_action_invocation_iter_indented_subactionsr rA rD rF rb _format_action)r% actionZget_invocationZ invocations subactionZinvocation_lengthZ
action_lengthr* r* r+ add_argument s
zHelpFormatter.add_argumentc C s |D ]}| | qd S r- )rx )r% rj rv r* r* r+
add_arguments s zHelpFormatter.add_argumentsc C s. | j }|r*| jd|}|dd }|S )N
r_ )rH ra rN substrip)r% rr r* r* r+ ra s
zHelpFormatter.format_helpc C s d dd |D S )Nr^ c S s g | ]}|r|t k r|qS r* )r )rZ partr* r* r+ r] ! s z-HelpFormatter._join_parts..)r$ )r% Z part_stringsr* r* r+ r` 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: rO z%(prog)s c S s g | ] }|r|qS r* r* rp r* r* r+ r] A 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 )NrS r r )ro r r$ )partsindentrl lineslineZline_lenr}
text_widthr* r+ get_linesU s"
z.HelpFormatter._format_usage..get_linesg ?rS r_ z%s%s
)N)_dictr> option_stringsr _format_actions_usager$ rC rD ro rJ findallrU extend)r% ri rj rk rl rO optionals positionalsrv formatZ action_usageZ part_regexpZ opt_usageZ pos_usageZ opt_partsZ pos_partsr r r r r* r r+ rh % 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 (()rS |%s%s %s[%s]T)reverser c S s g | ]}|d k r|qS r- r* )rZ itemr* r* r+ r] s z7HelpFormatter._format_actions_usage..z[\[(]z[\])]z(%s) z\1 (%s)z%s *%sr^ z \(([^|]*)\))setindex_group_actions
ValueErrorro addrequiredrange enumeraterr r r getpopr #_get_default_metavar_for_positional _format_argsnargs!_get_default_metavar_for_optionalr. r$ rJ r{ r| )r% rj rk
group_actionsZinsertsgroupstartendrv ir defaultr}
option_string args_stringrf 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 rz )r r> rA rC rD
_fill_text)r% rf r r r* r* r+ re 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 ) Nr8 r r^ z%*s%s
z %*s%-*s r rS r_ )r@ rF rB rA rC rD rs rr ro _expand_help _split_linesr endswithrt ru r` )
r% rv Z
help_positionZ
help_widthZ action_widthZ
action_headertupZ indent_firstr Z help_textZ
help_linesr rw r* r* r+ ru s8
z HelpFormatter._format_actionc C s |j s&| |}| ||d\}|S g }|jdkrB||j n4| |}| ||}|j D ]}|d||f q^d|S d S )NrS r r r ) r r _metavar_formatterr r r r r r$ )r% rv r metavarr r r r* r* r+ rs " s
z'HelpFormatter._format_action_invocationc sP |j d k r|j n.|jd k r s z4HelpFormatter._metavar_formatter..z{%s},c s t tr S f| S d S r- )
isinstancetuple)Z
tuple_sizeresultr* r+ r C s
z0HelpFormatter._metavar_formatter..format)r choicesr$ )r% rv default_metavarZ choice_strsr r* r r+ r : 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% rv r Z get_metavarr Zformatsr* r* r+ r J 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 )rZ cr* r* r+ r] k s z.HelpFormatter._expand_help..)
r varsr> r5 r hasattrr r r$ _get_help_string)r% rv Zparamsr( Z choices_strr* r* r+ r b s zHelpFormatter._expand_helpc c s@ z
|j }W n tk
r Y n X | | E d H | d S r- )_get_subactionsAttributeErrorrT rV )r% rv Zget_subactionsr* r* r+ rt o s
z'HelpFormatter._iter_indented_subactionsc C s& | j d| }dd l}|||S )Nr r )rM r{ r| textwrapZwrap)r% rf rP r r* r* r+ r y s zHelpFormatter._split_linesc C s, | j d| }dd l}|j||||dS )Nr r )Zinitial_indentZsubsequent_indent)rM r{ r| r Zfill)r% rf rP r r r* r* r+ r s zHelpFormatter._fill_textc C s |j S r- )rr r% rv 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)r8 r9 N)N) r r2 r3 r4 rQ rT rV objectrG rb rc rd rg rm rx ry ra r` rh r re ru rs r r r rt 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 )Nr^ c 3 s | ]} | V qd S r- r* )rZ r r r* r+ s z9RawDescriptionHelpFormatter._fill_text..T)keepends)r$
splitlines)r% rf rP r r* r r+ r s z&RawDescriptionHelpFormatter._fill_textN)r r2 r3 r4 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% rf rP r* r* r+ r s z!RawTextHelpFormatter._split_linesN)r r2 r3 r4 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))rr r r r
r r r )r% rv rr Zdefaulting_nargsr* r* r+ r s
z.ArgumentDefaultsHelpFormatter._get_help_stringN)r r2 r3 r4 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* r1 r+ r" ? s zAction._get_kwargsc C s t tdd S )Nz.__call__() not defined)NotImplementedErrorr r% parser namespacevaluesr r* r* r+ __call__M s zAction.__call__)NNNNNFNN)N)r r2 r3 r4 rQ 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 rQ r __class__r* r+ rQ S s
z_StoreAction.__init__c C s t || j| d S r- )setattrr r r* r* r+ r p s z_StoreAction.__call__)NNNNNFNN)Nr r2 r3 rQ r
__classcell__r* r* r r+ r Q 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 rr )r r rQ r% r r r r r rr r r r* r+ rQ v 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 t s r c s e Zd Zd fdd Z ZS )_StoreTrueActionFNc s t t| j||d|||d d S )NTr r r r r rr )r r rQ r% r r r r rr r r* r+ rQ s
z_StoreTrueAction.__init__)FFNr r2 r3 rQ 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 rQ r r r* r+ rQ 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 rQ r r r* r+ rQ s
z_AppendAction.__init__c C s2 t || jd }t|}|| t|| j| d S r- )r r r7 r r r% r r r r r0 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 rr r )r r rQ r r r* r+ rQ s
z_AppendConstAction.__init__c C s4 t || jd }t|}|| j t|| j| d S r- )r r r7 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 rr )r r rQ r r r* r+ rQ s
z_CountAction.__init__c C s0 t || jd }|d krd}t|| j|d d S Nr rS )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 rr )r r rQ )r% r r r rr r r* r+ rQ s
z_HelpAction.__init__c C s | | d S r- )
print_helpexitr r* r* r+ r s z_HelpAction.__call__)Nr r2 r3 r rQ 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 rQ version)r% r r r r rr r r* r+ rQ s
z_VersionAction.__init__c C sD | j }|d kr|j }| }|| || tj | d S r- )r _get_formatterrg _print_messagera _sysstdoutr )r% r r r r r rW r* r* r+ r ( 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 rr r )r$ r r
_ChoicesPseudoActionrQ )r% r( aliasesrr r r Zsupr r* r+ rQ 6 s
z/_SubParsersAction._ChoicesPseudoAction.__init__r r* r* r r+ r 4 s r FNc s< || _ || _i | _g | _tt| j||t| j|||d d S )N)r r r r r rr r ) _prog_prefix
_parser_class_name_parser_map_choices_actionsr r
rQ r )r% r rO parser_classr r rr r r r* r+ rQ > s
z_SubParsersAction.__init__c K s | dd kr d| j|f |d< |dd}d|krX|d}| |||}| j| | jf |}|| j|< |D ]}|| j|< qr|S )NrO r r r* rr )r r
r r r r r r )r% r( kwargsr rr Z
choice_actionr aliasr* r* r+
add_parserU s
z _SubParsersAction.add_parserc C s | j S r- )r r1 r* r* r+ r l 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 rS r ) parser_namer z5unknown parser %(parser_name)r (choices: %(choices)s))r r r r KeyErrorr$ r r parse_known_argsr r0
setdefault_UNRECOGNIZED_ARGS_ATTRr r ) r% r r r r r r& r\ msgZ subnamespacekeyr) r* r* r+ r o s$
z_SubParsersAction.__call__)N) r r2 r3 r r r rQ r r r r r* r* r r+ r
2 s r
c @ s e Zd ZdddZdS )
_ExtendActionNc C s2 t || jd }t|}|| t|| j| d S r- )r r r7 r r r r* r* r+ r s
z_ExtendAction.__call__)N)r r2 r3 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+ rQ 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! )rZ r' r* r* r+ r] s z%FileType.__repr__..c S s$ g | ] \}}|d k rd||f qS )Nr r* )rZ kwr' r* r* r+ r] s r )r r r r! r$ r r )r% r\ r Zargs_strr* r* r+ r, s zFileType.__repr__)r r NN)r r2 r3 r4 rQ r r, 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 r( r* r* r+ rQ 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- )r/ )r% r r* r* r+ __contains__ s zNamespace.__contains__N)r r2 r3 r4 rQ r1 r2 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 )Nrv ZstoreZ store_const
store_trueZ store_falser Z append_constr rr r parsersr z^-\d+$|^-\d*\.\d+$) r r3 rQ 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 _defaultsrJ rK _negative_number_matcher _has_negative_number_optionals)r% r6 r8 r7 r9 r r* r+ rQ s4 z_ActionsContainer.__init__c C s | j |i }|||< d S r- )r: r )r%
registry_namer) r registryr* r* r+ r; s z_ActionsContainer.registerNc C s | j | ||S r- )r: r )r% rD r) r r* r* r+
_registry_get s z _ActionsContainer._registry_getc K s2 | j | | jD ]}|j|kr||j |_qd S r- )rA updater= r r )r% r rv r* r* r+ set_defaults& s
z _ActionsContainer.set_defaultsc C s8 | j D ]"}|j|kr|jd k r|j S q| j|d S r- )r= r r rA r )r% r rv 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, ...)
rS 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)r8 ro r _get_positional_kwargs_get_optional_kwargsrA r7 _pop_action_classcallablerF r r r r r r _add_action)r% r\ r charsr Z action_classrv type_funcr* r* r+ rx 9 s:
z _ActionsContainer.add_argumentc O s t | f||}| j| |S r- )_ArgumentGroupr? r )r% r\ r r r* r* r+ add_argument_groupl s z$_ActionsContainer.add_argument_groupc K s t | f|}| j| |S r- )_MutuallyExclusiveGroupr@ r )r% r r r* r* r+ add_mutually_exclusive_groupq 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> rB matchrC )r% rv r r* r* r+ rO v 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)titler6 r9 )r )r? r[ r r rS r6 r9 r r@ rU r r= r rO )r% rW Ztitle_group_mapr r Z group_maprv 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+ rK 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 )optionr8 zNinvalid option string %(option)r: must start with a character %(prefix_chars)rrS r z%dest= is required for options like %rr& r r^ ) r8 r r r ro r lstripreplacer ) r% r\ r r Zlong_option_stringsr r r Zdest_option_stringr* r* r+ rL s2
z&_ActionsContainer._get_optional_kwargsc C s | d|}| d||S )Nrv )r rF )r% r r rv r* r* r+ rM 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)r9 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% rv Zconfl_optionalsr Zconfl_optionalr9 r* r* r+ rV 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* )rZ r rv r* r* r+ r] s z<_ActionsContainer._handle_conflict_error..)r ro r$ r )r% rv 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 rY r> r rW rZ )r% rv rb r r* r* r+ _handle_conflict_resolve s
z*_ActionsContainer._handle_conflict_resolve)N)N)r r2 r3 rQ r; rF rH rI rx rS rU rO rZ r] rK rL rM r< rV rc rd r r* r* r r+ r3 s$ 5
3($
r3 c s6 e Zd Zd fdd Z fddZ fddZ ZS ) rR Nc s |j }|d|j |d|j |d|j tt| j}|f d|i| || _g | _|j | _ |j
| _
|j | _ |j | _ |j
| _
|j| _d S )Nr9 r8 r7 r6 )r r9 r8 r7 r rR rQ r[ r r: r= r> rA rC r@ )r% rW r[ r6 r rG Z
super_initr r* r+ rQ s z_ArgumentGroup.__init__c s t t| |}| j| |S r- )r rR rO r r r r r* r+ rO 5 s z_ArgumentGroup._add_actionc s t t| | | j| d S r- )r rR rZ r rY r r r* r+ rZ : s z _ArgumentGroup._remove_action)NNr r2 r3 rQ rO rZ r r* r* r r+ rR s rR c s. e Zd Zd fdd Zdd Zdd Z ZS ) rT Fc s t t| | || _|| _d S r- )r rT rQ r
_container)r% rW r r r* r+ rQ A s z _MutuallyExclusiveGroup.__init__c C s2 |j rtd}t|| j|}| j| |S )Nz-mutually exclusive arguments must be optional)r r r rf rO r r )r% rv r r* r* r+ rO F s z#_MutuallyExclusiveGroup._add_actionc C s | j | | j| d S r- )rf rZ r rY r r* r* r+ rZ N s z&_MutuallyExclusiveGroup._remove_action)Fre r* r* r r+ rT ? s rT 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)r6 r8 r7 r9 r zpositional argumentszoptional argumentsc S s | S r- r* )r, r* r* r+ identity s z)ArgumentParser.__init__..identityr r& hr8 rr z show this help message and exit)rv r rr )r r rQ _ospathbasenamer argvrO ri epilogformatter_classfromfile_prefix_charsadd_help allow_abbrevrS r _positionals
_optionals _subparsersr; rx r r] rA r rG )r% rO ri r6 rm parentsrn r8 ro r7 r9 rp rq Z superinitZ add_grouprg Zdefault_prefixrX defaultsr r* r+ rQ f sJ
zArgumentParser.__init__c s" ddddddg} fdd|D S ) NrO ri r6 rn r9 rp c s g | ]}|t |fqS r* r r r1 r* r+ r] s z.ArgumentParser._get_kwargs..r* r r* r1 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[ r6 Z subcommandsrO r^ r5 r )rt r) r r r r rS rr r r _get_positional_actionsr@ rm ri ra r| rM rO ) r% r r[ r6 rW r rk Z
parsers_classrv r* r* r+ add_subparsers s$
z ArgumentParser.add_subparsersc C s$ |j r| j| n | j| |S r- )r rs rO rr r r* r* r+ rO s zArgumentParser._add_actionc C s dd | j D S )Nc S s g | ]}|j r|qS r* r rZ rv r* r* r+ r] s z8ArgumentParser._get_optional_actions..r= r1 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* ry rz r* r* r+ r] s z:ArgumentParser._get_positional_actions..r{ r1 r* r* r+ rw s z&ArgumentParser._get_positional_actionsc C s4 | ||\}}|r0td}| |d| |S Nzunrecognized arguments: %sr )r r r) r$ r% r\ r rl 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 rR )r rl r5 r
r= r r r r r rA _parse_known_argsr r r delattrr exc_infor) r )r% r\ r rv 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 )NrS --r& AOr^ 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 )rv Zargument_stringsr Zargument_valuesZconflict_actionr Z action_name)action_conflictsr seen_actionsseen_non_default_actionsr% r* r+ take_action@ 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 )NrS r r z ignored explicit argument %r)_match_argumentr r8 r> r r rU ) start_index option_tuplerv r explicit_argZmatch_argumentZ
action_tuples arg_countrP charZnew_explicit_argZ
optionals_mapr stopr\ r Zselected_patterns)r& arg_strings_patternextrasoption_string_indicesr% r r* r+ consume_optionalU sN
z:ArgumentParser._parse_known_args..consume_optionalc sn j }| d }||}t|D ]*\}} | | | }| |7 } || q&t|d d d < | S r- )_match_arguments_partialzipro )r Z
match_partialZselected_patternZ
arg_countsrv 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* )rZ r )r r* r+ r] s z4ArgumentParser._parse_known_args..z(the following arguments are required: %sr c S s g | ]}|j tk rt|qS r* )rr r r rz r* r* r+ r] s
z#one of the arguments %s is requiredr )N) ro _read_args_from_filesr@ r r r r iterr _parse_optionalr$ r rw rA r@ 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_actionsrv 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 )
ro 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 argumentsrS ) _get_nargs_patternrJ rX r r
r r r r r ro r )r% rv r
nargs_patternrX Z nargs_errorsr r* r* r+ r $ 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 r^ c s g | ]} |qS r* )r rz r1 r* r+ r] @ s z;ArgumentParser._match_arguments_partial..c S s g | ] }t |qS r* rn )rZ r, r* r* r+ r] D s )r ro r$ rJ rX r rk )r% rj r r r Z
actions_slicer rX r* r1 r+ r : 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 rS =r c S s g | ]\}}}|qS r* r* )rZ rv r r r* r* r+ r] i s z2ArgumentParser._parse_optional..)r_ Zmatchesz4ambiguous option: %(option)s could match %(matches)sr ) r8 r> ro split_get_option_tuplesr$ r r) rB rX rC )
r% r rv r r Z
option_tuplesZoptionsr\ r r r* r* r+ r J 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 rS r r8 z unexpected option string: %s)r8 rq r r>
startswithr r) r )
r% r r rP Z
option_prefixr rv 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 r^ r& )
r r
r r r r r r$ r ra )r% rv 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 rz r* r* r+ r] 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 )rZ r rv r r* r+ r] s
z;parse_intermixed_args: positional in mutuallyExclusiveGroup )warnzDo not expect %s in %sF)rw r r r@ ri Z
save_nargsZ save_defaultr format_usager r r r r warningsr r r| Z
save_requiredr ) r% r\ r aZ
save_usagerv 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 rS c s g | ]} |qS r* r rZ vrv r% r* r+ r] Z s z.ArgumentParser._get_values..c s g | ]} |qS r* r r r r* r+ r] ^ s r c s g | ]} |qS r* r r r r* r+ r] g s )r r r rY r r
r r r r r r _check_valuer ro r )r% rv r& r) r r r* r r+ r 6 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 rJ r rS )r r) z!invalid %(type)s value: %(value)r)
rF r rN r r r r r! r r r r r )r% rv r rQ r r r( r\ r* r* r+ r n s
zArgumentParser._get_valuec C sF |j d k rB||j krB|dtt|j d}td}t||| d S )Nr )r) r z3invalid choice: %(value)r (choose from %(choices)s))r r$ mapr! r r )r% rv r) r\ r r* r* r+ r s zArgumentParser._check_valuec C s$ | }|| j| j| j | S r- )r rm ri r= r@ ra )r% rW r* r* r+ r s
zArgumentParser.format_usagec C st | }|| j| j| j || j | jD ]0}||j ||j |
|j | q.|| j
| S r- )r rm ri r= r@ rg r6 r? rc r[ ry r rd rm ra )r% rW Z action_groupr* r* r+ ra s
zArgumentParser.format_helpc C s | j | jdS )Nr~ )rn rO r1 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 ra 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.
)rO r r8 z %(prog)s: error: %(message)s
N)r r r rO r r )r% r r\ r* r* r+ r) s zArgumentParser.error)NN)NN)NN)NN)N)N)N)r N)#r r2 r3 r4 r rQ r" rx rO r| rw r r r r r r r r r r r r r r r r ra r r r r r r) r r* r* r r+ r S sV @
# w:-1
M8
)3r4 __version____all__osri rerJ Zshutilr; sysr r r r r r
r r r r r r r r7 r r r r r r Exceptionr r r r r r r r r r r r r
r r r
r3 rR rT r r* r* r* r+ s = z
[#&] 7 :"