3
\a @ s0 d Z dZdddddddd d
d d d
dddddgZddlZddlZddlZddl Z
ddl Z ddl
ZddlmZmZ dZdZdZdZdZdZd ZG d d d eZd d ZG d!d deZ G d"d de Z G d#d d e Z G d$d de Z G d%d
d
e Z 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 deZ0G d@d d eZ1G dAdB dBeZ2G dCdD dDe2Z3G dEdF dFe3Z4G dGd dee2Z5dS )Ha
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...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 }x | j D ]}|jt| q W x8| j D ],\}}|j r`|jd||f q<|||< q s z6HelpFormatter._Section.format_help.. z%*s%s:
) rU rT rQ _join_partsr+ rS rV r rB )r! r Z item_helpZcurrent_indentrV r& r& r' format_help s
z"HelpFormatter._Section.format_help)N)r r, r- rO r^ r& r& r& r' rE s
rE c C s | j jj||f d S )N)rG r+ r )r! rX rY r& r& r' _add_item s zHelpFormatter._add_itemc C s0 | j | j| | j|}| j|jg || _d S )N)rQ rE rG r_ r^ )r! rV Zsectionr& r& r'
start_section s zHelpFormatter.start_sectionc C s | j j| _ | j d S )N)rG rU rS )r! r& r& r' end_section s
zHelpFormatter.end_sectionc C s$ |t k r |d k r | j| j|g d S )N)r r_ _format_text)r! textr& r& r' add_text s zHelpFormatter.add_textc C s& |t k r"||||f}| j| j| d S )N)r r_
_format_usage)r! usageactionsgroupsprefixrY r& r& r' add_usage s zHelpFormatter.add_usagec C sz |j tk rv| j}||g}x | j|D ]}|j|| q&W tdd |D }|| j }t| j|| _| j| j |g d S )Nc S s g | ] }t |qS r& )len)rW sr& r& r' rZ
s z.HelpFormatter.add_argument..)
helpr _format_action_invocation_iter_indented_subactionsr r@ rB rD r_ _format_action)r! actionZget_invocationZ invocations subactionZinvocation_lengthZ
action_lengthr& r& r' add_argument s
zHelpFormatter.add_argumentc C s x|D ]}| j | qW d S )N)rs )r! rg rq r& r& r'
add_arguments s
zHelpFormatter.add_argumentsc C s. | j j }|r*| jjd|}|jdd }|S )Nz
r\ )rF r^ rL substrip)r! rm r& r& r' r^ s
zHelpFormatter.format_helpc C s dj dd |D S )Nr[ c S s g | ]}|r|t k r|qS r& )r )rW partr& r& r' rZ ! s z-HelpFormatter._join_parts..)r )r! Z part_stringsr& r& r' r] s
zHelpFormatter._join_partsc s< |d krt d}|d k r,|t| jd }n|d krN| rNdt| jd }n|d kr0dt| jd }g }g }x(|D ] }|jr|j| qv|j| qvW | j} | || |}
djdd ||
gD }| j| j t |t | kr0d} | ||} | ||}
t
j | | }t
j | |
}dj|| ks,t dj||
ks@t d fdd }t |t | d
krdt |t | d }|r||g| ||}|j
||| n |r||g| ||}n|g}nZdt | }|| }|||}t |d kr g }|j
||| |j
||| |g| }d j|}d
||f S )Nzusage: )rM z%(prog)s c S s g | ] }|r|qS r& r& )rW rl r& r& r' rZ A s z/HelpFormatter._format_usage..z%\(.*?\)+(?=\s|$)|\[.*?\]+(?=\s|$)|\S+c s g }g }|d k r t |d }n t |d }xb| D ]Z}|d t | krp|rp|j|dj| g }t |d }|j| |t |d 7 }q0W |r|j|dj| |d k r|d t |d |d< |S )NrP rx r )rk r r )partsindentri lineslineZline_lenrw )
text_widthr& r' get_linesU s"
z.HelpFormatter._format_usage..get_linesg ?rP r\ z%s%s
)N)_dictr< option_stringsr _format_actions_usager rA rB rk rH findallrR extend)r! rf rg rh ri rM Z optionals positionalsrq formatZ action_usageZ part_regexpZ opt_usageZ pos_usageZ opt_partsZ pos_partsr~ rz r{ ry r& )r} r' re % sZ
zHelpFormatter._format_usagec
C s t }i }x|D ]}y|j|jd }W n tk
r> wY qX |t|j }||| |jkrx|jD ]}|j| qhW |js||kr|| d7 < nd||< d||< n*||kr|| d7 < nd||< d||< x t|d |D ] } d || < qW qW g }
x2t|D ]$\} }|j t
krj|
j d |j | d krF|j
| n"|j | d d kr.|j
| d n|js| j|} | j|| } ||kr| d dkr| d dkr| dd } |
j | nh|jd }
|jdkrd
|
} n"| j|} | j|| }d |
|f } |j r$||kr$d | } |
j | q
W x(t|d
dD ]} || g|
| | < qBW djdd |
D }d}d}tjd| d|}tjd| d|}tjd||f d|}tjdd|}|j }|S ) Nr z [[]z (()rP |z%sz%s %sz[%s]T)reverserx c S s g | ]}|d k r|qS )Nr& )rW itemr& r& r' rZ s z7HelpFormatter._format_actions_usage..z[\[(]z[\])]z(%s) z\1z (%s)z%s *%sr[ z \(([^|]*)\)r )setindex_group_actionsr; rk addrequiredrange enumeraterm r r getpopr #_get_default_metavar_for_positional _format_argsnargs!_get_default_metavar_for_optionalr) r rH ru rv )r! rg rh
group_actionsZinsertsgroupstartendrq iry defaultrw
option_string args_stringrc opencloser& r& r' r sr
z#HelpFormatter._format_actions_usagec C sF d|kr|t | jd }t| j| j d}d| j }| j|||d S )Nz%(prog))rM rx z
)r r< r@ rA rB
_fill_text)r! rc r} rz r& r& r' rb s
zHelpFormatter._format_textc
C sB t | jd | j}t| j| d}|| j d }| j|}|jsV| jd|f}d| }n@t||kr~| jd||f}d| }d}n| jd|f}d| }|}|g}|jr| j |} | j
| |}
|j d|d|
d f x@|
dd D ]} |j d|d| f qW n|j ds|j d x$| j
|D ]} |j | j| q W | j|S ) Nr3 r r[ z%*s%s
z %*s%-*s r rP r\ )r? rD r> r@ rA rB rn rm rk _expand_help _split_linesr endswithro rp r] )
r! rq Z
help_positionZ
help_widthZ action_widthZ
action_headertupZ indent_firstry Z help_textZ
help_linesr| rr r& r& r' rp s6
z HelpFormatter._format_actionc C s |j s&| j|}| j||d\}|S g }|jdkrB|j|j n8| j|}| j||}x |j D ]}|jd||f q`W dj|S d S )NrP r z%s %sz, ) r r _metavar_formatterr r r r r r )r! rq r metavarry r r r& r& r' rn 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 )N)
isinstancetuple)Z
tuple_size)resultr& r' r = s
z0HelpFormatter._metavar_formatter..format)r choicesr )r! rq default_metavarZ choice_strsr r& )r r' r 4 s
z HelpFormatter._metavar_formatterc C s | j ||}|jd kr$d|d }n|jtkr.rx ) r r r
r r r r r r )r! rq r Z get_metavarr Zformatsr& r& r' r D s
zHelpFormatter._format_argsc C s t t|| jd}x"t|D ]}|| tkr ||= q W x,t|D ] }t|| dr@|| j||< q@W |jdd k rdjdd |d D }||d< | j || S )N)rM r r z, c S s g | ] }t |qS r& )r )rW cr& r& r' rZ ` s z.HelpFormatter._expand_help..)
r varsr< listr hasattrr r r _get_help_string)r! rq Zparamsr$ Z choices_strr& r& r' r W s
zHelpFormatter._expand_helpc c s@ y
|j }W n tk
r Y n X | j | E d H | j d S )N)_get_subactionsAttributeErrorrQ rS )r! rq Zget_subactionsr& r& r' ro d s
z'HelpFormatter._iter_indented_subactionsc C s | j jd|j }tj||S )Nrx )rK ru rv _textwrapZwrap)r! rc rN r& r& r' r n s zHelpFormatter._split_linesc C s$ | j jd|j }tj||||dS )Nrx )Zinitial_indentZsubsequent_indent)rK ru rv r Zfill)r! rc rN rz r& r& r' r r s
zHelpFormatter._fill_textc C s |j S )N)rm )r! rq r& r& r' r w s z HelpFormatter._get_help_stringc C s
|j j S )N)destupper)r! rq r& r& r' r z s z/HelpFormatter._get_default_metavar_for_optionalc C s |j S )N)r )r! rq r& r& r' r } s z1HelpFormatter._get_default_metavar_for_positional)r3 r4 N)N) r r, r- r. rO rQ rS objectrE r_ r` ra rd rj rs rt r^ r] re r rb rp rn r r r ro r r r r r r& r& r& r' r s<
`a/
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 dj fdd|jddD S )Nr[ c 3 s | ]} | V qd S )Nr& )rW r| )rz r& r' s z9RawDescriptionHelpFormatter._fill_text..T)keepends)r
splitlines)r! rc rN rz r& )rz r' r s z&RawDescriptionHelpFormatter._fill_textN)r r, r- r. 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 |j S )N)r )r! rc rN r& r& r' r s z!RawTextHelpFormatter._split_linesN)r r, r- r. 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))rm r r r
r r r )r! rq rm Zdefaulting_nargsr& r& r' r s
z.ArgumentDefaultsHelpFormatter._get_help_stringN)r r, r- r. 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 )N)r r )r! rq r& r& r' r s z:MetavarTypeHelpFormatter._get_default_metavar_for_optionalc C s |j jS )N)r r )r! rq r& r& r' r s z.r& )r! namesr& )r! r' r / s zAction._get_kwargsc C s t tdd S )Nz.__call__() not defined)NotImplementedErrorr )r! parserr1 valuesr r& r& r' __call__= s zAction.__call__)NNNNNFNN)N)r r, r- r. rO r r r& r& r& r' r s 1
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 appropriatez nargs must be %r to supply const)
r r r r r r r r rm r )r; r
superr rO ) r! r r r r r r r r rm r ) __class__r& r' rO C s
z_StoreAction.__init__c C s t || j| d S )N)r0 r )r! r r1 r r r& r& r' r ` s z_StoreAction.__call__)NNNNNFNN)N)r r, r- rO r
__classcell__r& r& )r r' r A 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 rm )r r rO )r! r r r r r rm r )r r& r' rO f s
z_StoreConstAction.__init__c C s t || j| j d S )N)r0 r r )r! r r1 r r r& r& r' r w s z_StoreConstAction.__call__)NFNN)N)r r, r- rO r r r& r& )r r' r d s
r c s e Zd Zd fdd Z ZS )_StoreTrueActionFNc s t t| j||d|||d d S )NT)r r r r r rm )r r rO )r! r r r r rm )r r& r' rO } s
z_StoreTrueAction.__init__)FFN)r r, r- rO 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 )NF)r r r r r rm )r r rO )r! r r r r rm )r r& r' rO s
z_StoreFalseAction.__init__)TFN)r r, r- rO r 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 appropriatez nargs must be %r to supply const)
r r r r r r r r rm r )r; r
r r rO ) r! r r r r r r r r rm r )r r& r' rO s
z_AppendAction.__init__c C s0 t jt|| jg }|j| t|| j| d S )N)_copycopyr2 r r r0 )r! r r1 r r r+ r& r& r' r s
z_AppendAction.__call__)NNNNNFNN)N)r r, r- rO r r 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 rm r )r r rO )r! r r r r r rm r )r r& r' rO s
z_AppendConstAction.__init__c C s2 t jt|| jg }|j| j t|| j| d S )N)r r r2 r r r r0 )r! r r1 r r r+ r& r& r' r s z_AppendConstAction.__call__)NFNN)N)r r, r- rO r r 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 rm )r r rO )r! r r r r rm )r r& r' rO s
z_CountAction.__init__c C s$ t || jdd }t|| j| d S )Nr rP )r2 r r0 )r! r r1 r r Z new_countr& r& r' r s z_CountAction.__call__)NFN)N)r r, r- rO r r 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 rm )r r rO )r! r r r rm )r r& r' rO s
z_HelpAction.__init__c C s |j |j d S )N)
print_helpexit)r! r r1 r r r& r& r' r s z_HelpAction.__call__)N)r r, r- r rO 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 )Nr )r r r r rm )r r rO version)r! r r r r rm )r r& r' rO s
z_VersionAction.__init__c C sD | j }|d kr|j }|j }|j| |j|j tj |j d S )N)r _get_formatterrd _print_messager^ _sysstdoutr )r! r r1 r r r rT r& r& r' r s
z_VersionAction.__call__)N)r r, r- r rO r r r& r& )r r' r s
r c sN e Zd ZG dd deZeddf fdd Zdd Zdd Zd d
d Z Z
S )
_SubParsersActionc s e Zd Z fddZ ZS )z&_SubParsersAction._ChoicesPseudoActionc s@ | }}|r |ddj | 7 }ttj| }|jg |||d d S )Nz (%s)z, )r r rm r )r r r _ChoicesPseudoActionrO )r! r$ aliasesrm r r Zsup)r r& r' rO " s
z/_SubParsersAction._ChoicesPseudoAction.__init__)r r, r- rO r r& r& )r r' r s r Nc s> || _ || _tj | _g | _tt| j||t | j||d d S )N)r r r r rm r )
_prog_prefix
_parser_class _collections OrderedDict_name_parser_map_choices_actionsr r rO r )r! r rM parser_classr rm r )r r& r' rO * s
z_SubParsersAction.__init__c K s |j dd kr d| j|f |d< |jdf }d|krX|jd}| j|||}| jj| | jf |}|| j|< x|D ]}|| j|< qtW |S )NrM z%s %sr rm )r r r r r r r r )r! r$ kwargsr rm Z
choice_actionr aliasr& r& r'
add_parser? s
z _SubParsersAction.add_parserc C s | j S )N)r )r! r& r& r' r V s z!_SubParsersAction._get_subactionsc
C s |d }|dd }| j tk r,t|| j | y| j| }W n< tk
rv |dj| jd}td| }t| |Y nX |j|d \} }x$t | j
D ]\}
} t||
| qW |rt |j t g t
|t j| d S )Nr rP z, ) parser_namer z5unknown parser %(parser_name)r (choices: %(choices)s))r r r0 r r: r r r parse_known_argsr r+
setdefault_UNRECOGNIZED_ARGS_ATTRr/ r ) r! r r1 r r r r" rY msgZ subnamespacekeyr% r& r& r' r Y s"
z_SubParsersAction.__call__)N) r r, r- r r r rO r r r 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.
rrP Nc C s || _ || _|| _|| _d S )N)_mode_bufsize _encoding_errors)r! modebufsizeencodingerrorsr& r& r' rO s zFileType.__init__c C s |dkr>d| j krtjS d| j kr(tjS td| j }t|yt|| j | j| j| j S t
k
r } z td}t |||f W Y d d }~X nX d S )N-r wzargument "-" with mode %rzcan't open '%s': %s) r r stdinr r r; r r r r OSErrorr )r! stringr er r& r& r' r s
zFileType.__call__c C sT | j | jf}d| jfd| jfg}djdd |D dd |D }dt| j|f S )Nr r z, c S s g | ]}|dkrt |qS )rP r )r )rW r# r& r& r' rZ s z%FileType.__repr__..c S s$ g | ] \}}|d k rd||f qS )Nz%s=%rr& )rW kwr# r& r& r' rZ s z%s(%s))r r r r r r r )r! rY r Zargs_strr& r& r' r( s
zFileType.__repr__r )r r NN)r r, r- r. rO 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" x |D ]}t | ||| qW d S )N)r0 )r! r r$ r& r& r' rO s
zNamespace.__init__c C s t |tstS t| t|kS )N)r r
NotImplementedr )r! otherr& r& r' __eq__ s
zNamespace.__eq__c C s
|| j kS )N)r* )r! r r& r& r' __contains__ s zNamespace.__contains__N)r r, r- r. rO r r
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| j || _|| _|| _|| _i | _| jdd t | jddt | jddt
| jddt | jddt | jddt
| jddt | jddt | jdd t | jdd
t | jdd t | j g | _i | _g | _g | _i | _tjd | _g | _ d S )
Nrq ZstoreZ store_const
store_trueZ store_falser Z append_constcountrm r parsersz^-\d+$|^-\d*\.\d+$) r r rO descriptionargument_default prefix_charsconflict_handler _registriesregisterr r r r r r r r r r _get_handler_actions_option_string_actions_action_groups_mutually_exclusive_groups _defaultsrH rI _negative_number_matcher _has_negative_number_optionals)r! r r r r )r r& r' rO s2 z_ActionsContainer.__init__c C s | j j|i }|||< d S )N)r r )r!
registry_namer% r registryr& r& r' r s z_ActionsContainer.registerNc C s | j | j||S )N)r r )r! r r% r r& r& r'
_registry_get s z _ActionsContainer._registry_getc K s6 | j j| x$| jD ]}|j|kr||j |_qW d S )N)r updater r r )r! r rq r& r& r' set_defaults s
z _ActionsContainer.set_defaultsc C s8 x(| j D ] }|j|kr|jd k r|jS qW | jj|d S )N)r r r r r )r! r rq r& r& r' get_default s
z _ActionsContainer.get_defaultc O s0 | j }| s(t|dkrJ|d d |krJ|r| js>| jjd q>W |S )NT) _check_conflictr r containerr r r matchr )r! rq r r& r& r' r( T s
z _ActionsContainer._add_actionc C s | j j| d S )N)r remove)r! rq r& r& r' _remove_actioni s z _ActionsContainer._remove_actionc C s i }x8| j D ].}|j|kr0td}t||j |||j< q W i }xR|j D ]H}|j|krt| j|j|j|jd||j< x |jD ]}||j ||< q|W qJW x4|jD ]*}| j |j
d}x|jD ] }|||< qW qW x |j D ]}|j || j
| qW d S )Nz.cannot merge actions - two groups are named %r)titler r )r )r r4 r r; r, r r r r r. r r r r( )r! r0 Ztitle_group_mapr r Z group_maprq mutex_groupr& r& r' _add_container_actionsl s,
z(_ActionsContainer._add_container_actionsc K s^ d|krt d}t||jdttgkr2d|d< |jdtkrPd|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' r# s z(_ActionsContainer._get_positional_kwargsc O s g }g }xv|D ]n}|d | j kr@|| j d}td}t|| |j| |d | j krt|dkr|d | j kr|j| qW |jdd }|d kr|r|d }n|d }|j| j }|std}t|| |jdd}t|||d S )
Nr )optionr zNinvalid option string %(option)r: must start with a character %(prefix_chars)rrP r z%dest= is required for options like %rr r )r r ) r r r; r rk r lstripreplacer ) r! rY r r Zlong_option_stringsr r r Zdest_option_stringr& r& r' r$ s0
z&_ActionsContainer._get_optional_kwargsc C s |j d|}| jd||S )Nrq )r r )r! r r rq r& r& r' r% s z#_ActionsContainer._pop_action_classc C sD d| j }y
t| |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 sP g }x0|j D ]&}|| jkr | j| }|j||f q W |rL| j }||| d S )N)r r r r )r! rq Zconfl_optionalsr Zconfl_optionalr r& r& r' r/ s
z!_ActionsContainer._check_conflictc C s6 t ddt|}djdd |D }t||| d S )Nz conflicting option string: %sz conflicting option strings: %sz, c S s g | ] \}}|qS r& r& )rW r rq r& r& r' rZ s z<_ActionsContainer._handle_conflict_error..)r rk r r )r! rq conflicting_actionsr Zconflict_stringr& r& r' _handle_conflict_error s
z(_ActionsContainer._handle_conflict_errorc C sB x<|D ]4\}}|j j| | jj|d |j s|jj| qW d S )N)r r2 r r r0 r3 )r! rq r: r r& r& r' _handle_conflict_resolve s
z*_ActionsContainer._handle_conflict_resolve)N)N)r r, r- rO r r r! r" rs r, r. r( r3 r6 r# r$ r% r r/ r; r< r r& r& )r r' r s$ 4
/($
r c s6 e Zd Zd fdd Z fddZ fddZ ZS ) r+ 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 r r )r r r r r r+ rO r4 r r r r r r r )r! r0 r4 r r r Z
super_init)r r& r' rO s z_ArgumentGroup.__init__c s t t| j|}| jj| |S )N)r r+ r( r r )r! rq )r r& r' r( s z_ArgumentGroup._add_actionc s t t| j| | jj| d S )N)r r+ r3 r r2 )r! rq )r r& r' r3 s z _ArgumentGroup._remove_action)NN)r r, r- rO r( r3 r r& r& )r r' r+ s r+ c s. e Zd Zd fdd Zdd Zdd Z ZS ) r- Fc s t t| j| || _|| _d S )N)r r- rO r
_container)r! r0 r )r r& r' rO s z _MutuallyExclusiveGroup.__init__c C s2 |j rtd}t|| jj|}| jj| |S )Nz-mutually exclusive arguments must be optional)r r r; r= r( r r )r! rq r r& r& r' r( $ s z#_MutuallyExclusiveGroup._add_actionc C s | j j| | jj| d S )N)r= r3 r r2 )r! rq r& r& r' r3 , s z&_MutuallyExclusiveGroup._remove_action)F)r r, r- rO r( r3 r r& r& )r r' r- s r- c s e Zd ZdZddddg eddddddf fdd Zdd Zd
d Zd d
Zdd Z dd Z
d=ddZ d>ddZ dd Z
dd Zdd Zd d Zd d Zd d! Zd"d# Zd$d% Zd&d' Zd(d) Zd*d+ Zd,d- Zd.d/ Zd0d1 Zd?d2d3Zd@d4d5Z dAd6d7Z dBd9d:Z d;d< Z Z S )Cr 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 errorTc
s& t t| j}
|
||| |
d |d kr6tjjtjd }|| _|| _ || _
|| _ || _ | | _
| | _| j}|td| _|td| _d | _dd }| jdd | d|krdn|d }| j
r| j|d |d
d d ttd d
xD|D ]<}| j| y
|j}W n tk
r Y qX | jj| qW d S )N)r r r r r zpositional argumentszoptional argumentsc S s | S )Nr& )r r& r& r' identityj s z)ArgumentParser.__init__..identityr r hr3 rm z show this help message and exit)rq r rm )r r rO r8 pathbasenamer argvrM rf epilogformatter_classfromfile_prefix_charsadd_help allow_abbrevr, r _positionals
_optionals _subparsersr rs r r6 r r r )r! rM rf r rD parentsrE r rF r r rG rH Z superinitZ add_groupr? Zdefault_prefixrU Zdefaults)r r& r' rO D sB
zArgumentParser.__init__c s" ddddddg} fdd|D S ) NrM rf r rE r rG c s g | ]}|t |fqS r& )r/ )rW r$ )r! r& r' rZ s z.ArgumentParser._get_kwargs..r& )r! r r& )r! r' r s zArgumentParser._get_kwargsc K s | j d k r| jtd |jdt| d|ks8d|krht|jdd}t|jdd }| j||| _ n| j| _ |jdd kr| j }| j
}| j }|j | j
||d |j j |d< | j|d}|f d g i|}| j j| |S )
Nz(cannot have multiple subparser argumentsr r4 r Z subcommandsrM r[ r r )rK r> r r r r r, rI r r _get_positional_actionsr rj rf r^ rv r% r( ) r! r r4 r rT r rh Z
parsers_classrq r& r& r' add_subparsers s$
z ArgumentParser.add_subparsersc C s$ |j r| jj| n | jj| |S )N)r rJ r( rI )r! rq r& r& r' r( s zArgumentParser._add_actionc C s dd | j D S )Nc S s g | ]}|j r|qS r& )r )rW rq r& r& r' rZ s z8ArgumentParser._get_optional_actions..)r )r! 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 )rW rq r& r& r' rZ s z:ArgumentParser._get_positional_actions..)r )r! r& r& r' rM s z&ArgumentParser._get_positional_actionsc C s4 | j ||\}}|r0td}| j|dj| |S )Nzunrecognized arguments: %srx )r r r> r )r! rY r1 rC r r& r& r'
parse_args s
zArgumentParser.parse_argsc C s |d krt jdd }nt|}|d kr.t }x>| jD ]4}|jtk r6t||js6|jtk r6t ||j|j q6W x*| j
D ] }t||svt ||| j
| qvW y<| j ||\}}t|t r|j
t|t t|t ||fS tk
r t j d }| jt| Y nX d S )NrP )r rC r r
r r r r r r0 r _parse_known_argsr r r/ delattrr exc_infor> r )r! rY r1 rq r errr& r& r' r s,
z ArgumentParser.parse_known_argsc s" j d k r ji x` jD ]V}|j}xJt|jD ]<\}} j|g }|j|d | |j||d d q6W q W i g }t} xnt| D ]b\}}
|
dkr|jd xF| D ]}
|jd qW q j |
} | d krd} n | |< d} |j| qW dj
|t t d fdd fd d
}
j fd d }g d
rpt
}nd}x|
|krt
fddD }
|kr|
}|
kr|
qvn|
kr
| }j| |
|
qvW |
}j|d g }x jD ]|}|kr|jr>|jt| nT|jd k rt|jtrt|jr|jt|jkrt|j j||j qW |r jtddj
| xb jD ]X}|jrxH|jD ]}|krP qW dd |jD }td} j|dj
| qW fS )NrP z--r AOr[ c s j | j| |}|| jk rfj | x: j| g D ]*}|kr8td}t|}t| || q8W |tk r|| || d S )Nz not allowed with argument %s)r _get_valuesr r r r r r )rq Zargument_stringsr Zargument_valuesZconflict_actionr Z action_name)action_conflictsr1 seen_actionsseen_non_default_actionsr! r& r' take_action s
z5ArgumentParser._parse_known_args..take_actionc s | }|\}}}j }g }x>|d kr>j | | d S |d k r||d}j}|dkr|d |kr|j|g |f |d } | |d }|dd pd }
j} || kr| | }|
}ntd} t|| | n@|dkr| d }
|g}|j|||f P ntd} t|| | q | d }|d }|||}|| }
||
}|j|||f P q W |shtx |D ]\}}}||| qnW |
S )NrP rU r z ignored explicit argument %r)_match_argumentr r r r r rR ) start_index option_tuplerq r explicit_argZmatch_argumentZ
action_tuples arg_countr) charZnew_explicit_argZ
optionals_mapr stoprY r Zselected_patterns)r" arg_strings_patternextrasoption_string_indicesr! r[ r& r' consume_optional3 sP
z:ArgumentParser._parse_known_args..consume_optionalc sr j }| d }||}x8t|D ]*\}} | | | }| |7 } || q(W t|d d d < | S )N)_match_arguments_partialziprk )r] Z
match_partialZselected_patternZ
arg_countsrq r` rY )r" rc r r! r[ r& r' consume_positionals s
z=ArgumentParser._parse_known_args..consume_positionalsr c s g | ]}| kr|qS r& r& )rW r )r] r& r' rZ s z4ArgumentParser._parse_known_args..z(the following arguments are required: %sz, c S s g | ]}|j tk rt|qS r& )rm r r )rW rq r& r& r' rZ s z#one of the arguments %s is requiredrx )Nr ) rF _read_args_from_filesr r r r r iterr _parse_optionalr r rM r@ r? r r r r r r r r r/ r0
_get_valuer> r )r! r" r1 r5 r r Z mutex_actionZ conflictsZarg_string_pattern_partsZarg_strings_iter
arg_stringr^ patternrf ri Zmax_option_string_indexZnext_option_string_indexZpositionals_end_indexZstringsZ
stop_indexZrequired_actionsrq r r r r& ) rX r" rc rd r1 re r rY rZ r! r] r[ r' rQ s
J
z ArgumentParser._parse_known_argsc C s g }x|D ]}| s"|d | j kr.|j| q
ylt|dd R}g }x2|j j D ]"}x | j|D ]}|j| qdW qTW | j|}|j| W d Q R X W q
tk
r t j
d }| j t | Y q
X q
W |S )Nr rP )
rF r r readr convert_arg_line_to_argsrj r r r rS r> r )r! r" Znew_arg_stringsrn Z args_filearg_liner# rT r& r& r' rj s
z$ArgumentParser._read_args_from_filesc C s |gS )Nr& )r! rr r& r& r' rq s z'ArgumentParser.convert_arg_line_to_argsc C st | j |}tj||}|d krfd tdttdttdi}tdd|j|j }|j|j|}t ||t
|j dS )Nzexpected one argumentz expected at most one argumentz expected at least one argumentzexpected %s argumentzexpected %s argumentsrP ) _get_nargs_patternrH r1 r r
r r r r r rk r )r! rq rc
nargs_patternr1 Z nargs_errorsr r r& r& r' r\ s
z ArgumentParser._match_argumentc st g }xjt t|ddD ]V}|d | }dj fdd|D }tj||}|d k r|jdd |j D P qW |S )Nr rP r[ c s g | ]} j |qS r& )rs )rW rq )r! r& r' rZ s z;ArgumentParser._match_arguments_partial..c S s g | ] }t |qS r& )rk )rW r r& r& r' rZ ! s r )r rk r rH r1 r rh )r! rg rc r r Z
actions_slicero r1 r& )r! r' rg s
z'ArgumentParser._match_arguments_partialc
C s |sd S |d | j krd S || jkr8| j| }||d fS t|dkrHd S d|kr~|jdd\}}|| jkr~| j| }|||fS | jr| j|}t|dkrdjdd |D }||d}td}| j|| nt|dkr|\} | S | j j
|r | j s d S d |krd S d |d fS )
Nr rP =z, c S s g | ]\}}}|qS r& r& )rW rq r r_ r& r& r' rZ G s z2ArgumentParser._parse_optional..)r7 Zmatchesz4ambiguous option: %(option)s could match %(matches)srx ) r r rk splitrH _get_option_tuplesr r r> r r1 r )
r! rn rq r r_ Z
option_tuplesZoptionsrY r r^ r& r& r' rl ' s>
z ArgumentParser._parse_optionalc
C s0 g }| j }|d |kr~|d |kr~d|kr<|jdd\}}n|}d }x| jD ],}|j|rL| j| }|||f}|j| qLW n|d |ko|d |kr|}d }|d d }|dd } xr| jD ]T}||kr| j| }||| f}|j| q|j|r| j| }|||f}|j| qW n| jtd| |S )Nr rP ru r3 z unexpected option string: %s)r rv r
startswithr r> r )
r! r r r) Z
option_prefixr_ rq r Zshort_option_prefixZshort_explicit_argr& r& r' rw b s8
z!ArgumentParser._get_option_tuplesc C s |j }|d krd}nX|tkr"d}nJ|tkr0d}n<|tkr>d}n.|tkrLd}n |tkrZd}nddjd | }|jr|jdd
}|jd d
}|S ) Nz(-*A-*)z(-*A?-*)z (-*[A-]*)z
(-*A[A-]*)z([-AO]*)z (-*A[-AO]*)z(-*%s-*)z-*rU r[ r ) r r
r r r r r r r9 )r! rq r rt r& r& r' rs s$ z!ArgumentParser._get_nargs_patternc sx j ttgkr2y|jd W n tk
r0 Y nX | rz j tkrz jrP j}n j}t |t
rxj |}j | n| r j t
kr j r jd k r j}n|}j | nt|dkr j d tgkr|\}j |}j | n j tkr fdd|D }nb j tkrD fdd|D }j |d n0 fdd|D }x|D ]}j | q^W |S )Nz--rP c s g | ]}j |qS r& )rm )rW v)rq r! r& r' rZ s z.ArgumentParser._get_values..c s g | ]}j |qS r& )rm )rW ry )rq r! r& r' rZ s r c s g | ]}j |qS r& )rm )rW ry )rq r! r& r' rZ s )r r r r2 r; r
r r r r r rm _check_valuer rk )r! rq r" r% rn ry r& )rq r! r' rW s>
zArgumentParser._get_valuesc C s | j d|j|j}t|s0td}t||| y ||}W n tk
r~ t|jdt|j}tt j
d }t||Y nL t t fk
r t|jdt|j}||d}td}t||| Y nX |S )Nr z%r is not callabler rP )r r% z!invalid %(type)s value: %(value)r)
r r r& r r r r/ r r r rS r' r; )r! rq rn r* r r r$ rY r& r& r' rm s
zArgumentParser._get_valuec C sF |j d k rB||j krB|djtt|j d}td}t||| d S )Nz, )r% r z3invalid choice: %(value)r (choose from %(choices)s))r r mapr r r )r! rq r% rY r r& r& r' rz s
zArgumentParser._check_valuec C s$ | j }|j| j| j| j |j S )N)r rj rf r r r^ )r! rT r& r& r' format_usage s zArgumentParser.format_usagec C sx | j }|j| j| j| j |j| j x:| jD ]0}|j|j |j|j |j
|j |j q0W |j| j
|j S )N)r rj rf r r rd r r r` r4 rt r ra rD r^ )r! rT Z action_groupr& r& r' r^ s zArgumentParser.format_helpc C s | j | jdS )N)rM )rE rM )r! r& r& r' r 0 s z ArgumentParser._get_formatterc C s" |d krt j}| j| j | d S )N)r r r r| )r! filer& r& r' print_usage6 s zArgumentParser.print_usagec C s" |d krt j}| j| j | d S )N)r r r r^ )r! r} r& r& r' r ; s zArgumentParser.print_helpc C s |r |d krt j}|j| d S )N)r stderrwrite)r! r r} r& r& r' r @ s z ArgumentParser._print_messager c C s |r| j |tj tj| d S )N)r r r r )r! Zstatusr r& r& r' r I s zArgumentParser.exitc C s0 | j tj | j|d}| jdtd| 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.
)rM r r3 z %(prog)s: error: %(message)s
N)r~ r r rM r r )r! r rY r& r& r' r> N s zArgumentParser.error)NN)NN)N)N)N)r N)!r r, r- r. r rO r rN r( rO rM rP r rQ rj rq r\ rg rl rw rs rW rm rz r| r^ r r~ r r r r> r r& r& )r r' r 1 sP 4
# w;,,4
)6r. __version____all__ collectionsr r r osr8 rerH sysr textwrapr r r r r r
r r r r r r r r2 r r r r r r Exceptionr r r r r r r r r r r r r r r
r r+ r- r r& r& r& r' > s
n
[#%`6 5"