python (3.12.0)
ˑe d Z dZg dZddlZddlZddlZddl Z ddl
m
Z m Z dZ
dZdZd Zd
Zd Zd Z G d
de Zd Z G d de Z G d de Z G d de Z G d de Z G d de Zd Z G d d e Z G d d e Z G d d e Z e Z! G d! d"e Z" G d# d$e Z# G d% d&e Z$ G d' d(e$ Z% G d) d*e$ Z& G d+ d,e Z' G d- d.e Z( G d/ d0e Z) G d1 d2e Z* G d3 d4e Z+ G d5 d6e Z, G d7 d8e' Z- G d9 d:e Z. G d; d<e Z/ G d= d>e Z0 G d? d@e0 Z1 G dA dBe1 Z2 G dC dDee0 Z3y)Ea
Command-line parsing library
This module is an optparse-inspired command-line parsing library that:
- handles both optional and positional arguments
- produces highly informative usage messages
- supports parsers that dispatch to sub-parsers
The following is a simple usage example that sums integers from the
command-line and writes the result to a file::
parser = argparse.ArgumentParser(
description='sum the integers at the command line')
parser.add_argument(
'integers', metavar='int', nargs='+', type=int,
help='an integer to be summed')
parser.add_argument(
'--log', default=sys.stdout, type=argparse.FileType('w'),
help='the file where the sum should be written')
args = parser.parse_args()
args.log.write('%s' % sum(args.integers))
args.log.close()
The module contains the following public classes:
- ArgumentParser -- The main entry point for command-line parsing. As the
example above shows, the add_argument() method is used to populate
the parser with actions for optional and positional arguments. Then
the parse_args() method is invoked to convert the args at the
command-line into an object with attributes.
- ArgumentError -- The exception raised by ArgumentParser objects when
there are errors with the parser's actions. Errors raised while
parsing the command-line are caught by ArgumentParser and emitted
as command-line messages.
- FileType -- A factory for defining types of files to be created. As the
example above shows, instances of FileType are typically passed as
the type= argument of add_argument() calls.
- Action -- The base class for parser actions. Typically actions are
selected by passing strings like 'store_true' or 'append_const' to
the action= argument of add_argument(). However, for greater
customization of ArgumentParser actions, subclasses of Action may
be defined and passed as the action= argument.
- HelpFormatter, RawDescriptionHelpFormatter, RawTextHelpFormatter,
ArgumentDefaultsHelpFormatter -- Formatter classes which
may be passed as the formatter_class= argument to the
ArgumentParser constructor. HelpFormatter is the default,
RawDescriptionHelpFormatter and RawTextHelpFormatter tell the parser
not to change the formatting for help text, and
ArgumentDefaultsHelpFormatter adds information about argument defaults
to the help.
All other classes in this module are considered implementation details.
(Also note that HelpFormatter and RawDescriptionHelpFormatter are only
considered public as object names -- the API of the formatter objects is
still considered an implementation detail.)
z1.1)ArgumentParser
ArgumentErrorArgumentTypeErrorBooleanOptionalActionFileType
HelpFormatter ArgumentDefaultsHelpFormatterRawDescriptionHelpFormatterRawTextHelpFormatterMetavarTypeHelpFormatter NamespaceAction ONE_OR_MOREOPTIONALPARSER REMAINDERSUPPRESS ZERO_OR_MORE N)gettextngettextz ==SUPPRESS==?*+zA......_unrecognized_argsc " e Zd ZdZd Zd Zd Zy)_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 t | j }g }i }| j D ] }|j t | | j D ]1 \ }}|j
r|j |d| -|||< 3 |r |j dt | z |ddj | dS )N=z**%s(, ))type__name__ _get_argsappendrepr _get_kwargs isidentifierjoin)self type_name arg_strings star_argsargnamevalues </BuggyBox/python/3.12.0/bootstrap/lib/python3.12/argparse.py__repr__z_AttributeHolder.__repr__v s J'' >># *C tCy ) * ++- (KD% """dE#:;"' $ (
vY 7 8$dii &<== c H t | j j S N)list__dict__itemsr+ s r2 r( z _AttributeHolder._get_kwargs s DMM'')**r4 c g S r6 r: s r2 r% z_AttributeHolder._get_args s r4 N)r$
__module__ __qualname____doc__r3 r( r% r< r4 r2 r r m s
> +r4 r c ` | g S t | t u r| d d S dd l}|j | S Nr )r# r7 copy)r9 rB s r2 _copy_itemsrC s5 } E{dQx 99U r4 c e Zd ZdZ d dZd Zd Z G d de Zd Z d Z
d
Z d Z d d Z
d
Zd Zd Zd Zd Zd Zd Zd Zd Zd Zd Zd Zd Zd Zd Z d Z d Z d Z y)!r zFormatter for generating usage messages and argument help strings.
Only the name of this class is considered a public API. All the methods
provided by the class are considered an implementation detail.
Nc |#dd l }|j j }|dz }|| _ || _ t |t
|dz
|dz | _ || _ d| _ d| _
d| _ | j | d | _
| j | _ t j dt j" | _ t j d | _ y )Nr z\s+z\n\n\n+)shutilget_terminal_sizecolumns_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+ progindent_incrementmax_help_positionwidthrH s r2 __init__zHelpFormatter.__init__ s = ,,.66E QJE
!1 "%&7&)%"*6F6J&K#M "# !]]4 6 $ 2 2 #&;;vsyy#A #&;;z#: r4 c l | xj | j z
c_ | xj dz
c_ y N rQ rL rR r: s r2 _indentzHelpFormatter._indent s' 6 66 q r4 c | xj | j z c_ | j dk\ sJ d | xj dz c_ y )Nr zIndent decreased below 0.rc rd r: s r2 _dedentzHelpFormatter._dedent s> 6 66 ##q(E*EE q r4 c e Zd ZddZd Zy)HelpFormatter._SectionNc < || _ || _ || _ g | _ y r6 ) formatterparentheadingr9 )r+ rk rl rm s r2 r` z HelpFormatter._Section.__init__ s &DN DK"DLDJr4 c | j | j j | j j } || j D cg c]
\ }} || c}} }| j | j j |sy| j t ur5| j )| j j }d|d| j fz }nd} |d||dg S c c}}w )N z%*s%s:
) rl rk re _join_partsr9 rg rm r rQ )r+ r* funcargs item_helpcurrent_indentrm s r2 format_helpz"HelpFormatter._Section.format_help s {{&&&(>>--D DJJ GjdDdDk GHI{{&&&( ||8+ 0H!% !?!?$DLL'II w 489 9! Hs C#
r6 )r$ r= r> r` rv r< r4 r2 rT ri s :r4 rT c R | j j j ||f y r6 )rV r9 r& )r+ rr rs s r2 _add_itemzHelpFormatter._add_item s ##**D$<8r4 c | j | j | | j | }| j |j g || _ y r6 )re rT rV rx rv )r+ rm sections r2
start_sectionzHelpFormatter.start_section s? --d&;&;WE w**B/ ' r4 c Z | j j | _ | j y r6 )rV rl rg r: s r2 end_sectionzHelpFormatter.end_section s $ 5 5 < < r4 c V |t ur!| | j | j |g y y y r6 )r rx _format_text)r+ texts r2 add_textzHelpFormatter.add_text s- x D$4 NN4,,tf 5 %5 r4 c Z |t ur#||||f}| j | j | y y r6 )r rx
_format_usage)r+ usageactionsgroupsprefixrs s r2 add_usagezHelpFormatter.add_usage s1 '661D NN4--t 4 !r4 c n |j t ur| j } || g}| j | D ] }|j || t t
t | }|| j z }t | j | | _ | j | j |g y y r6 ) helpr _format_action_invocation_iter_indented_subactionsr& rN maplenrQ rS rx _format_action)r+ actionget_invocation invocations subactioninvocation_length
action_lengths r2 add_argumentzHelpFormatter.add_argument s ;;h & " ; ;N)&12K ! ; ;F C
> "">)#<=
> !$C[$9 : -0D0D DM&)$*A*A*7'9D #
NN4.. 9 'r4 c 4 |D ] }| j | y r6 )r )r+ r r s r2
add_argumentszHelpFormatter.add_arguments s &F f % &r4 c | j j }|r0| j j d| }|j d dz }|S )N
rp )rU rv r[ substrip)r+ r s r2 rv zHelpFormatter.format_help sI !!--/ ++//=D::d#d*D r4 c ^ dj |D cg c] }|r
|t ur| c} S c c}w )Nro )r* r )r+ part_stringsparts r2 rq zHelpFormatter._join_parts$ s8 ww$0: D$8 : ; ; :s *c | t d }||t | j z }nB| |sdt | j z }n#| dt | j z }g }g }|D ]1 }|j r|j | !|j | 3 | j
} | ||z | }
dj
||
fD cg c] } | s| c} }| j | j z
t | t | z kD r]d} | || }
| || }t j | |
}t j | | }dj
| |
k( sJ dj
| |k( sJ d fd }t | t | z dz k r[dt | t | z dz z }|r' ||g|z || }|j ||| nw|r ||g|z || }nf|g}nbdt | z }||z } ||| }t | dkD r2g }|j ||| |j ||| |g|z }d j
| }||d
S c c} w ) Nzusage: r\ z%(prog)s z%\(.*?\)+(?=\s|$)|\[.*?\]+(?=\s|$)|\S+c g }g }t | }|t | dz
}n|dz
}| D ]d }|dz t | z kD r,|r*|j |dj | z g }|dz
}|j | |t | dz z
}f |r#|j |dj | z | |d |d |d< |S )Nrc r r )r r& r* ) partsindentr linesline
indent_lengthline_lenr
text_widths r2 get_linesz.HelpFormatter._format_usage.<locals>.get_linesY s E D$'KM )#&v;?#01#4 % 2#a<#d)3j@T !LL#((4.)@ A#%D'4q'8H D) CIM1
2 Vchhtn%<= )#(8MN#;a Lr4 g ?rc rp r r6 )
_dictrK option_stringsr& _format_actions_usager* rP rQ r rW findallextend)r+ r r r r r\ optionals positionalsr format action_usages part_regexp opt_usage pos_usage opt_parts pos_partsr r r r r s @r2 r zHelpFormatter._format_usage) s >y\F Ddjj 11E ]7 4::!66E ] $** 55D I K!
/(( $$V, &&v.
/ //F!)k"96BLHH$ )= CAa CDE t';';;J6{SZ'*4
#9f 5 "; 7 KK Y ? KK Y ? xx *i77xx *i77!, v;T*dZ.?? CK#d)$;a$? @F )4&9*<ff M Yy&%AB" )4&9*<ff M!% !3v; .F % 1E %eV 4E5zA~ " Yy&%AB Yy&%AB !FUNE %( $U++G Ds
I5I5c t }i }|D ]1 }|j st d| |j |j d }t |j }||z }||| |j k( sjd} |j D ]+ }
|j |
|
j t u s'| dz
} - || z
} |j s/||v r||xx dz
cc< nd||< ||v r||xx dz
cc< n9d||< n3| dkD r.||v r||xx dz
cc< nd||< ||v r||xx d z
cc< nd ||< t |dz | D ] } d
|| < 4 g }
t | D ]U \ } }
|
j t u rd|
j d |j | d
k( r|j | P|j | dz d
k( sh|j | dz }|
j sN| j |
}| j! |
| }|
|v r|d dk( r
|d dk( r|dd }|
j | |
j d }|
j" dk( r|
j% }n*| j' |
}| j! |
| }|d |}|
j s |
|vrd
|z }|
j | X t) |d D ] } || g|
| |
d j+ |
D cg c] }|| c} }d}d}t- j. d|z d| }t- j. d|z d| }t- j. |d|d| }|j1 }|S # t $ r Y Jw xY wc c}w )Nz empty group r rc z [[]z (r r" |r [%s]T)reversez[\[(]z[\])]z(%s) z\1 (%s)z *ro )set_group_actions
ValueErrorindexr addr r requiredrange enumerater& getpopr #_get_default_metavar_for_positional _format_argsnargs format_usage!_get_default_metavar_for_optionalsortedr* rW r r )r+ r r
group_actionsinsertsgroupstartgroup_action_countendsuppressed_actions_countr exposed_actions_countir defaultr
option_string args_stringitemr opencloses r2 r z#HelpFormatter._format_actions_usage s
( )E'' <w!788$
)
e&:&:1&=> &))=)=%>" 005%)=)==/0,"'"6"6 :%))&1!;;(2 4 9 4:
-?AY,Y) >> G+ #ENd 2N-0GEN '> #CLC /L+.GCL.2 G+ #ENd 2N-0GEN '> #CLC /L+.GCL "519c 2 )%(
)O( )V "7+ - #IAv {{h& T";;q>S(KKN [[Q'3.KKA& ** BB6J((9 ]*Aw#~$r(c/ #Abz T" !' 5 5a 8
<<1$!..0D
# D DV LG"&"3"3FG"DK&3[AD 6 +F!D=D T"[- #` . &A!!* E!AJ & xx%D$43CDE wwx$t4wwx%'5wwD%0#t<zz| K
t Es M
M M
MMc d|v r|t | j z }t | j | j z
d }d| j z }| j ||| dz S )Nz%(prog)r r r )r rK rN rP rQ
_fill_text)r+ r r r s r2 r zHelpFormatter._format_text s` $DJJ//Dt';';;R@
t+++tZ86AAr4 c ` t | j dz | j }t | j |z
d }|| j
z
dz
}| j
| }|j s| j
d|f}d|z }n<t | |k r| j
d||f}d|z }d}n| j
d|f}d|z }|}|g}|j r{|j j ra| j | } | rp| j | | }
|j dd|
d fz |
dd D ] } |j d|d| fz n"|j d s|j d | j | D ]" } |j | j | $ | j! | S ) NrF r ro z%*s%s
z %*s%-*s r rc rp )rM rS rO rN rP rQ r r r r _expand_help _split_linesr& endswithr r rq )
r+ r
help_position
help_width action_width
action_headertup indent_firstr help_text
help_linesr r s
r2 r z HelpFormatter._format_action s D 3 3a 7 3 35
}4b9
$t';';;a? 66v>
{{&&M9C %OM
<
/&&L-GC '# -M L &&M9C %OM(L ;;6;;,,. ))&1I ! . .y* E
Y,JqM)J JK &qrN HDLLmR-F!FGH ''- LL 77? 9I LL,,Y7 8 9 &&r4 c |j s-| j | } | j || d \ }|S g }|j dk( r |j |j nJ| j | }| j
|| }|j D ] }|j |d| dj | S )Nrc r r r! ) r r _metavar_formatterr r r r r& r* )r+ r r metavarr r r s r2 r z'HelpFormatter._format_action_invocation2 s $$>>vFG?t..vw?BHGN E ||q V 2 23
@@H " / / @ %+%:%: IMLLM;!GHI 99U# #r4 c |j
|j nE|j 7|j D cg c]
}t | }}ddj | z n|fd}|S c c}w )Nz{%s},c 4 t t rS f| z S r6 )
isinstancetuple)
tuple_sizeresults r2 r z0HelpFormatter._metavar_formatter.<locals>.formatS s &%(
zJ..r4 )r choicesstrr* )r+ r default_metavarchoice choice_strsr r s @r2 r z HelpFormatter._metavar_formatterJ se >> %^^F
^^
'5;^^D63v;DKDchh{ 33F$F /
Es A'c | j || }|j
d |d z }|S |j t k( r
d |d z }|S |j t k( r$ |d }t | dk( rd|z }|S d|z }|S |j t
k( r
d |d z }|S |j t k( rd}|S |j t k( r
d |d z }|S |j t k( rd
}|S t |j D cg c] }d }}d j | ||j z }|S c c}w # t $ r
t d d w xY w)
Nz%src r rF z
[%s [%s ...]]z[%s ...]z %s [%s ...]r z%s ...ro zinvalid nargs valuer )
r r r r r r r r r r TypeErrorr r* )r+ r r get_metavarr r r formatss r2 r zHelpFormatter._format_argsZ s --foF << KN*F.
- \\X
%k!n,F*
) \\\
)!!nG7|q (72"
$g-
\\[
("[^3F
\\Y
&F
\\V
# A.F
\\X
%F
B).v||)<=A4== XXg&V\\)BBF
>
B !67TA
Bs 2D? D:D? :D? ?Ec t t | | j }t | D ] }|| t u s||= t | D ]$ }t || d s|| j ||< & |j d 0dj |d D cg c]
}t | c} }||d< | j | |z S c c}w )Nr r$ r r! ) r varsrK r7 r hasattrr$ r r* r _get_help_string)r+ r paramsr0 c choices_strs r2 r zHelpFormatter._expand_helpv s d6l4L !Dd|x'4L ! L 5Dvd|Z0 %d| 4 4t 5 ::i , ))VI5F$GSV$GHK +F9 $$V,v55 %Hs Cc # K |j }| j | E d { | j y 7 # t $ r Y y w xY wwr6 )_get_subactionsre rg AttributeError)r+ r get_subactionss r2 r z'HelpFormatter._iter_indented_subactions sN # 3 3N
LLN%' ' ' LLN
( s1 A A AA A A A
AAc | j j d| j }dd l}|j || S )Nr r )rZ r r textwrapwrap)r+ r r_ r s r2 r zHelpFormatter._split_lines s9 ''++C6<<> }}T5))r4 c | j j d| j }dd l}|j |||| S )Nr r )initial_indentsubsequent_indent)rZ r r r fill)r+ r r_ r r s r2 r zHelpFormatter._fill_text sF ''++C6<<>}}T5,2/5 7 7r4 c |j S r6 )r r+ r s r2 r z HelpFormatter._get_help_string {{r4 c 6 |j j S r6 )destupperr s r2 r z/HelpFormatter._get_default_metavar_for_optional s {{ ""r4 c |j S r6 )r r s r2 r z1HelpFormatter._get_default_metavar_for_positional r r4 )rF Nr6 ) r$ r= r> r? r` re rg objectrT rx r{ r} r r r r rv rq r r r r r r r r r r r r r r r< r4 r2 r r s #$#% ;>
:6 :>9 ( 65
:$&;
_,BobB.'`$0 8 6*7#r4 r c e Zd ZdZd Zy)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 X dj fd|j d D S )Nro c 3 ( K | ] }|z y wr6 r< ).0r r s r2 <genexpr>z9RawDescriptionHelpFormatter._fill_text.<locals>.<genexpr> s Pv}Ps T)keepends)r*
splitlines)r+ r r_ r s `r2 r z&RawDescriptionHelpFormatter._fill_text s# wwP $ 1OPPPr4 N)r$ r= r> r? r r< r4 r2 r r s
Qr4 r c e Zd ZdZd Zy)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 " |j S r6 )r& )r+ r r_ s r2 r z!RawTextHelpFormatter._split_lines s r4 N)r$ r= r> r? r r< r4 r2 r
r
s !r4 r
c e Zd ZdZd Zy)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 |j }|d}d|vr=|j t ur+t t g}|j
s|j |v r|dz
}|S )a6
Add the default value to the option help message.
ArgumentDefaultsHelpFormatter and BooleanOptionalAction when it isn't
already present. This code will do that, detecting cornercases to
prevent duplicates or cases where it wouldn't make sense to the end
user.
ro z
%(default)z (default: %(default)s))r r r r r r r )r+ r r defaulting_nargss r2 r z.ArgumentDefaultsHelpFormatter._get_help_string s[ {{ <D t #~~X-$,l#; ((FLL<L,L 55D r4 N)r$ r= r> r? r r< r4 r2 r r s r4 r c e Zd ZdZd Zd Zy)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 . |j j S r6 r# r$ r s r2 r z:MetavarTypeHelpFormatter._get_default_metavar_for_optional {{###r4 c . |j j S r6 r. r s r2 r z<MetavarTypeHelpFormatter._get_default_metavar_for_positional r/ r4 N)r$ r= r> r? r r r< r4 r2 r r s $$r4 r c 2 | y | j rdj | j S | j d t fvr | j S | j d t fvr | j S | j
r!ddj | j
z dz S y )N/{r })r r* r r r r )arguments r2 _get_action_namer6 s xx//00 $!1 1 tX . .}} SXXh . .//#55r4 c e Zd ZdZd Zd Zy)r zAn error from creating or using an argument (optional or positional).
The string value of this exception is the message, augmented with
information about the argument that caused it.
c 2 t | | _ || _ y r6 )r6
argument_namemessage)r+ r5 r: s r2 r` zArgumentError.__init__ s -h 7 r4 c ~ | j d}n t d }|t | j | j z S )Nz %(message)sz'argument %(argument_name)s: %(message)s)r: r9 )r9 r r r: )r+ r s r2 __str__zArgumentError.__str__ sA %"F@AFT\\+/+=+=? ? ?r4 N)r$ r= r> r? r` r< r< r4 r2 r r s ?r4 r c e Zd ZdZy)r z@An error from trying to convert a command line string to a type.N)r$ r= r> r? r< r4 r2 r r s Jr4 r c < e Zd ZdZ ddZd Zd ZddZy) r
a\ Information about how to convert command line strings to Python objects.
Action objects are used by an ArgumentParser to represent the information
needed to parse a single argument from one or more strings from the
command line. The keyword arguments to the Action constructor are also
all attributes of Action instances.
Keyword Arguments:
- option_strings -- A list of command-line option strings which
should be associated with this action.
- dest -- The name of the attribute to hold the created object(s)
- nargs -- The number of command-line arguments that should be
consumed. By default, one argument will be consumed and a single
value will be produced. Other values include:
- N (an integer) consumes N arguments (and produces a list)
- '?' consumes zero or one arguments
- '*' consumes zero or more arguments (and produces a list)
- '+' consumes one or more arguments (and produces a list)
Note that the difference between the default and nargs=1 is that
with the default, a single value will be produced, while with
nargs=1, a list containing a single value will be produced.
- const -- The value to be produced if the option is specified and the
option uses an action that takes no values.
- default -- The value to be produced if the option is not specified.
- type -- A callable that accepts a single string argument, and
returns the converted value. The standard Python types str, int,
float, and complex are useful examples of such callables. If None,
str is used.
- choices -- A container of values that should be allowed. If not None,
after a command-line argument has been converted to the appropriate
type, an exception will be raised if it is not a member of this
collection.
- required -- True if the action must always be specified at the
command line. This is only meaningful for optional command-line
arguments.
- help -- The help string describing the argument.
- metavar -- The name to be used for the option's argument with the
help string. If None, the 'dest' value will be used as the name.
Nc || _ || _ || _ || _ || _ || _ || _ || _ | | _ |
| _ y r6
r r r constr r# r r r r ) r+ r r r rA r r# r r r r s r2 r` zAction.__init__J sK -
r4 c L g d}|D cg c] }|t | | f c}S c c}w )Nr@ getattrr+ namesr0 s r2 r( zAction._get_kwargs` s+
9>>wtT*+>>> !c | j d S rA )r r: s r2 r zAction.format_usageo s ""1%%r4 c * t t d )Nz.__call__() not defined)NotImplementedErrorr r+ parser namespacevaluesr s r2 __call__zAction.__call__r s !!$=">??r4 NNNNNFNNr6 )r$ r= r> r? r` r( r rO r< r4 r2 r
r
s7 0j ,
? &@r4 r
c : e Zd Zdeeddef fd ZddZd Z xZS )r NFc b g } |D ]> }
| j |
|
j d s&d|
dd z }
| j |
@ dD ]. } t | t ust j
| dd 0 |t u rd }|t u rd }|t u rd }t | | |d|||||| y )
N----no-rF )r# r r zP{name!r} is deprecated as of Python 3.12 and will be removed in Python {remove}.) )remover ) r r r r r# r r r r )r&
startswithlocals_deprecated_defaultwarnings _deprecatedsuperr` )
r+ r r r r# r r r r _option_stringsr
field_name __class__s
r2 r` z BooleanOptionalAction.__init__z s + 6M " "= 1 ''- '-*; ;
&&}5 6 9 $Jx
#+>>$$ 2" $ $ & &D ) )G ) )G
* r4 c p || j v r(t || j |j d y y )NrT )r setattrr rX rK s r2 rO z BooleanOptionalAction.__call__ s3 D / / / Ityym.F.Fw.O*O P 0r4 c 8 dj | j S )Nz | )r* r r: s r2 r z"BooleanOptionalAction.format_usage s zz$--..r4 r6 )r$ r= r> rZ r` rO r
__classcell__r` s @r2 r r y s( ), ,- `Q/r4 r c 8 e Zd Z d fd ZddZ xZS ) _StoreActionc |dk( r t d ||t k7 rt dt z t t | ||||||||| |
y )Nr znargs for store actions must be != 0; if you have nothing to store, actions such as store true or store const may be more appropriate nargs must be %r to supply constr@ )r r r] rg r` r+ r r r rA r r# r r r r r` s r2 r` z_StoreAction.__init__ ss A: K L
L (!2 ?( JK K
lD*) +
r4 c 2 t || j | y r6 )rb r rK s r2 rO z_StoreAction.__call__ s 499f-r4 rP r6 r$ r= r> r` rO rd re s @r2 rg rg s'
:.r4 rg c 2 e Zd Z d fd ZddZ xZS )_StoreConstActionc : t t | ||d|||| y )Nr )r r r rA r r r )r] rn r` r+ r r rA r r r r r` s r2 r` z_StoreConstAction.__init__ s/ /) 0 r4 c F t || j | j y r6 )rb r rA rK s r2 rO z_StoreConstAction.__call__ s 499djj1r4 NNFNNr6 rl re s @r2 rn rn s
"2r4 rn c & e Zd Z d fd Z xZS )_StoreTrueActionc 8 t t | ||d||| y )NTr r rA r r r )r] rt r` r+ r r r r r r` s r2 r` z_StoreTrueAction.__init__ s, .)
/ r4 )FFNr$ r= r> r` rd re s @r2 rt rt s
r4 rt c & e Zd Z d fd Z xZS )_StoreFalseActionc 8 t t | ||d||| y )NFrv )r] rz r` rw s r2 r` z_StoreFalseAction.__init__ s, /)
0 r4 )TFNrx re s @r2 rz rz s
r4 rz c 8 e Zd Z d fd ZddZ xZS )
_AppendActionc |dk( r t d ||t k7 rt dt z t t | ||||||||| |
y )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 appropriateri r@ )r r r] r} r` rj s r2 r` z_AppendAction.__init__ ss A: O P
P (!2 ?( JK K
mT+) ,
r4 c t || j d }t | }|j | t || j | y r6 )rD r rC r& rb r+ rL rM rN r r9 s r2 rO z_AppendAction.__call__- : 499d3E"
V 499e,r4 rP r6 rl re s @r2 r} r} s'
:-r4 r} c 2 e Zd Z d fd ZddZ xZS )_AppendConstActionc
< t t | ||d||||| y )Nr )r r r rA r r r r )r] r r` rp s r2 r` z_AppendConstAction.__init__6 s2 $0) 1 r4 c t || j d }t | }|j | j t || j | y r6 )rD r rC r& rA rb r s r2 rO z_AppendConstAction.__call__H s> 499d3E"
TZZ 499e,r4 rr r6 rl re s @r2 r r 4 s
$-r4 r c . e Zd Z d fd ZddZ xZS ) _CountActionc 8 t t | ||d||| y )Nr )r r r r r r )r] r r` rw s r2 r` z_CountAction.__init__Q s+ lD*)
+ r4 c n t || j d }|d}t || j |dz y )Nr rc )rD r rb )r+ rL rM rN r counts r2 rO z_CountAction.__call___ s2 499d3 =E 499eai0r4 )NFNr6 rl re s @r2 r r O s
1r4 r c . e Zd Zeedf fd ZddZ xZS ) _HelpActionNc 6 t t | |||d| y Nr )r r r r r )r] r r` )r+ r r r r r` s r2 r` z_HelpAction.__init__h s(
k4)) * r4 c D |j |j y r6 )
print_helpexitrK s r2 rO z_HelpAction.__call__t s
r4 r6 r$ r= r> r r` rO rd re s @r2 r r f s !
r4 r c 0 e Zd Zdeedf fd ZddZ xZS )_VersionActionNz&show program's version number and exitc D t t | |||d| || _ y r )r] r r` version)r+ r r r r r r` s r2 r` z_VersionAction.__init__{ s1 nd,) - r4 c | j }| |j }|j }|j | |j |j t
j |j y r6 )r _get_formatterr _print_messagerv _sysstdoutr )r+ rL rM rN r r rk s r2 rO z_VersionAction.__call__ s[ ,, ? nnG))+ 7# i 3 3 5t{{C
r4 r6 r re s @r2 r r y s !> r4 r c R e Zd Z G d de Zedddf fd Zd Zd Zd dZ xZ
S )
_SubParsersActionc e Zd Z fdZ xZS )&_SubParsersAction._ChoicesPseudoActionc |x}}|r|ddj | z z
}t t j | }|j g ||| y )Nr r! )r r r r )r* r] r _ChoicesPseudoActionr` )r+ r0 aliasesr r r supr` s r2 r` z/_SubParsersAction._ChoicesPseudoAction.__init__ sU ! !Gd7TYYw%777)>>EC LLD!(
*r4 rx re s @r2 r r s
* *r4 r FNc || _ || _ i | _ g | _ t t
| ||t | j ||| y )N)r r r r r r r ) _prog_prefix
_parser_class_name_parser_map_choices_actionsr] r r` r ) r+ r r\ parser_classr r r r r` s r2 r` z_SubParsersAction.__init__ sU ! ) " "
/))) 0 r4 c |j d | j d||d< |j dd }|| j v rt | t d |z |D ]( }|| j v st | t d |z d|v r?|j d }| j
||| }| j j | | j di |}|| j |< |D ] }|| j |< |S )Nr\ r r r< zconflicting subparser: %sz conflicting subparser alias: %sr )
r r r r r r r r r& r )r+ r0 kwargsr aliasr
choice_actionrL s r2
add_parserz _SubParsersAction.add_parser s( ::f %(,(9(94 @F6N**Y+ 4(( ( a(C&Dt&KL L HE---#! =>FH H H V ::f%D 5 5dGT JM ! ! ( ( 7 $##-f-&, d# 2E+1D ! !% ( 2
r4 c | j S r6 )r r: s r2 r
z!_SubParsersAction._get_subactions s $$$r4 c |d }|dd }| j t urt || j | | j | }|j |d \ } }t | j D ] \ }
} t ||
| |r?t | j t g t |t j | y y # t $ r9 |dj | j d}t
d |z }t | | w xY w)Nr rc r! ) parser_namer z5unknown parser %(parser_name)r (choices: %(choices)s))r r rb r KeyErrorr* r r parse_known_argsr r9
setdefault_UNRECOGNIZED_ARGS_ATTRrD r ) r+ rL rM rN r r r- rs msg subnamespacekeyr1 s r2 rO z_SubParsersAction.__call__ s Qi QRj 99H $ Ityy+ 6 +**;7F %+$;$;K$N! k |,224 +JC IsE * + O & &'> C I 6 7 > >{ K # +#. #yy)>)> ?ADKLtSC c* * +s C AD r6 ) r$ r= r> r
r r r` r r
rO rd re s @r2 r r s2 *v * . <% Lr4 r c e Zd ZddZy)
_ExtendActionNc t || j d }t | }|j | t || j | y r6 )rD r rC r rb r s r2 rO z_ExtendAction.__call__ r r4 r6 )r$ r= r> rO r< r4 r2 r r s -r4 r c $ e Zd ZdZddZd Zd Zy)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.
Nc < || _ || _ || _ || _ y r6 )_mode_bufsize _encoding_errors)r+ modebufsizeencodingerrorss r2 r` zFileType.__init__ s
! r4 c F |dk( rd j v r8d j v rt j j S t j S t fddD r8d j v rt j
j S t j
S t
d j z }t | t | j j j j S # t $ r#}||d}t
d }t ||z d }~ww xY w) N-rbc 3 : K | ] }|j v y wr6 )r )r# r
r+ s r2 r$ z$FileType.__call__.<locals>.<genexpr> s 4Q$**_4s waxzargument "-" with mode %r)filenameerrorz$can't open '%(filename)s': %(error)s)r r stdinbufferanyr r r r r r r OSErrorr )r+ stringr ers r: s ` r2 rO zFileType.__call__ s S=djj ,/4::,=tzz((M4::M4e44-0DJJ->t{{))ODKKO34tzzA o% 4
DMM4>> &
& 4 &3D>?G#GdN3 3 4s =6C4 4 D = DD c
L | j | j f}d| j fd| j fg}dj |D cg c] }|dk7 s t | c}|D cg c] \ }}||d| c}}z }t
| j d|dS c c}w c c}}w )Nr r r! r r r r" )r r r r r* r' r# r$ )r+ rs r r/ kwargs_strs r2 r3 zFileType.__repr__- s zz4==( t~~.4<<0HI994 EC3"9d3i EAG 2gb#!$ *,S 1 2 2 3 :..99 F 2s
B
B#B )r r NN)r$ r= r> r? r` rO r3 r< r4 r2 r r s 4(:r4 r c " e Zd ZdZd Zd Zd Zy)r zSimple object for storing attributes.
Implements equality by attribute names and values, and provides a simple
string representation.
c 2 |D ] }t | ||| y r6 )rb )r+ r r0 s r2 r` zNamespace.__init__@ s! .D D$t - .r4 c \ t |t st S t | t | k( S r6 )r r NotImplementedr )r+ others r2 __eq__zNamespace.__eq__D s% %+! !DzT%[((r4 c || j v S r6 )r8 )r+ r s r2 __contains__zNamespace.__contains__I s dmm##r4 N)r$ r= r> r? r` r r r< r4 r2 r r 9 s .)
$r4 r c e Zd Z fdZd ZddZd Zd Zd Zd Z d Z
d Z d
Z d Z
d Zd
ZddZd Zd Zd Zd Z xZS )_ActionsContainerc @ t t | || _ || _ || _ || _ i | _ | j dd t | j ddt | j ddt | j ddt | j ddt | j ddt | j ddt | j ddt | j dd t | j dd
t" | j dd t$ | j dd t& | j) g | _ i | _ g | _ g | _ i | _ t5 j6 d
| _ g | _ y )Nr store store_const
store_true store_falser& append_constr r r parsersr z^-\d+$|^-\d*\.\d+$) r] r r` descriptionargument_default prefix_charsconflict_handler _registriesregisterrg rn rt rz r} r r r r r r _get_handler_actions_option_string_actions_action_groups_mutually_exclusive_groups _defaultsrW rX _negative_number_matcher _has_negative_number_optionals)r+ r r r r r` s r2 r` z_ActionsContainer.__init__O s\
/1& 0 ( 0
hl3
h 6
h
/@A
h .>?
h
/@A
h-8
h0BC
h 6
h 4
h >:
h +<=
h-8
&(# !*,' ), 4I(J% /1+r4 c F | j j |i }|||< y r6 )r r )r+
registry_namer1 r registrys r2 r z_ActionsContainer.register s# ##..}bA r4 c @ | j | j || S r6 )r r )r+ r r1 r s r2
_registry_getz _ActionsContainer._registry_get s
.225'BBr4 c | j j | | j D ]% }|j |v s||j |_ ' y r6 )r updater r r )r+ r r s r2 set_defaultsz _ActionsContainer.set_defaults sE f% mm 5F{{f$!' !4 5r4 c | j D ], }|j |k( s|j |j c S | j j |d S r6 )r r r r r )r+ r r s r2 get_defaultz _ActionsContainer.get_default sM mm &F{{d"v~~'A ~~% & ~~!!$--r4 c | j }|rt | dk( r.|d d |vr$|rd|v r t d | j |i |}n | j |i |}d|vrA|d }|| j
v r| j
| |d< n| j | j |d< | j | }t | st d|d |di |}| j d |j |j }t | st |d
|t u rt |d t | d r! | j j |d | j! | S # t $ r t d
w xY w)z
add_argument(dest, ..., name=value, ...)
add_argument(option_string, option_string, ..., name=value, ...)
rc r r z+dest supplied twice for positional argumentr Nzunknown action ""r# z is not callablez: is a FileType class object, instance of it must be passedr z,length of metavar tuple does not match nargsr< )r r r _get_positional_kwargs_get_optional_kwargsr r _pop_action_classcallabler r# r r r r r _add_action)r+ rs r charsr action_classr type_funcs r2 r z _ActionsContainer.add_argument s !!s4yA~$q'!*E*A&( !NOO0T00$A&AF /T..??F F "&>Dt~~%$(NN4$8y!&&2$($9$9y! --f5 % l DE E '' &&vv{{FKKH " Y @A A 2; > ?
? 4) *
Q##%2264@ ''
Q !OPP
Qs 8 E) )E>c Z t | g|i |}| j j | |S r6 )_ArgumentGroupr r& )r+ rs r r s r2 add_argument_groupz$_ActionsContainer.add_argument_group s/ t5d5f5 ""5) r4 c T t | fi |}| j j | |S r6 )_MutuallyExclusiveGroupr r& )r+ r r s r2 add_mutually_exclusive_groupz._ActionsContainer.add_mutually_exclusive_group s* '77 ''..u5 r4 c V | j | | j j | | |_ |j D ] }|| j
|< |j D ]F }| j j | s | j r,| j j d H |S )NT) _check_conflictr r& containerr r r matchr )r+ r r s r2 r z _ActionsContainer._add_action s V$
V$ $ 2 2 @M9?D ' '
6 @ $ 2 2 EM,,22=A::77>>tD E
r4 c : | j j | y r6 )r rW r s r2 _remove_actionz _ActionsContainer._remove_action s
V$r4 c i }| j D ]B }|j |v r#t d }t ||j z |||j < D i }|j D ]r }|j |vr?| j |j |j
|j ||j < |j D ] }||j ||< t |j D ]4 }| j |j }|j D ] }|||< 6 |j D ]# }|j || j | % y )Nz.cannot merge actions - two groups are named %r)titler r )r )r r r r r r r r r r r r r r )r+ r title_group_mapr r group_mapr mutex_groups r2 _add_container_actionsz(_ActionsContainer._add_container_actions si (( 1E{{o-HI !455+0OEKK ( 1 -- AE {{/1/3/F/F ++ % 1 1%*%;%; 0G 0= , ..
A$3EKK$@ &!
A A" 99 0E ;; < )K ..
0$/ &!
0 0 (( <F MM&$ ' 3 3F ; <r4 c d|v rt d }t | |j d t t fvrd|d< |j d t k( r d|vrd|d< t ||g S )Nr z1'required' is an invalid argument for positionalsr Tr r r )r r r r r r )r+ r r r s r2 r z(_ActionsContainer._get_positional_kwargs st GHCC. ::g x &> >!%F: ::g , .9F3J!%F: Fb99r4 c g }g }|D ]~ }|d | j vr(|| j d}t d }t ||z |j | t | dkD s\|d | j v sn|j | |j dd }|U|r|d }n|d }|j
| j }|st d }t |z |j dd }t ||| S )
Nr )optionr zNinvalid option string %(option)r: must start with a character %(prefix_chars)rrc r z%dest= is required for options like %rr r r ) r r r r& r r lstripreplacer ) r+ rs r r long_option_stringsr r r dest_option_strings r2 r z&_ActionsContainer._get_optional_kwargs. s$ ! :M #t'8'88"/(,(9(9; G H t,,
! !- 0=!A%-*:d>O>O*O#**=9 : zz&$' <"%8%;"%3A%6"%,,T->->?D?@ }!455<<S)D FnEEr4 c L |j d| }| j d|| S )Nr )r r )r+ r r r s r2 r z#_ActionsContainer._pop_action_classP s' Hg.!!(FF;;r4 c d| j z } t | | S # t $ r$ t d }t || j z w xY w)Nz_handle_conflict_%sz%invalid conflict_resolution value: %r)r rD r r r )r+ handler_func_namer s r2 r z _ActionsContainer._get_handlerT sV 1D4I4I I :4!23 3 :;<C S4#8#8 89 9 :s -A
c g }|j D ]3 }|| j v s| j | }|j ||f 5 |r| j } ||| y y r6 )r r r& r )r+ r confl_optionalsr confl_optionalr s r2 r z!_ActionsContainer._check_conflict] st # 2 2 HM ; ;;!%!<!<]!K &&
~'FG H # 0 0 2 V_ 5 r4 c t ddt | }dj |D cg c] \ }}| c}} }t ||z c c}}w )Nz conflicting option string: %sz conflicting option strings: %sr! )r r r* r )r+ r conflicting_actionsr: r conflict_strings r2 _handle_conflict_errorz(_ActionsContainer._handle_conflict_errork s^ :; 235 ))(;%=)> &3 %= > FGo$=>>%=s A
c |D ]d \ }}|j j | | j j |d |j rJ|j j | f y r6 )r rW r r r r )r+ r r+ r s r2 _handle_conflict_resolvez*_ActionsContainer._handle_conflict_resolvet sc &9 8 !M6
! ! ( ( 7 ' ' + +M4 @ (( //7 8r4 r6 )r$ r= r> r` r r r r r r r r r r r r r r r r- r/ rd re s @r2 r r M sc 01j!C 5.1(f
*%&<P: FD<: 6 ? 8r4 r c > e Zd Zd fd Z fdZ fdZ fdZ xZS )r c |j } |d|j |d|j |d|j t t
| } |dd|i| || _ g | _ |j | _ |j | _
|j | _ |j | _ |j | _
|j | _ y )Nr r r r r< )r r r r r] r r` r r r r r r r r )r+ r r r r r
super_initr` s r2 r` z_ArgumentGroup.__init__ s ""!9#=#=>~y 5 56!9#=#=>>49
5{5f5
%00!**
&/&F&F#",, 4 4
+*3*N*N'r4 c d t t | | }| j j | |S r6 )r] r r r r& r+ r r` s r2 r z_ArgumentGroup._add_action s- ~t8@ ""6*
r4 c b t t | | | j j | y r6 )r] r r r rW r4 s r2 r z _ArgumentGroup._remove_action s&
nd26: ""6*r4 c Z t j dt d t | |i |S )Nz&Nesting argument groups is deprecated.rF category
stacklevel)r[ warnDeprecationWarningr] r r+ rs r r` s r2 r z!_ArgumentGroup.add_argument_group s/
4'
w)4:6::r4 NN)r$ r= r> r` r r r rd re s @r2 r r s O,
+; ;r4 r c 6 e Zd Zd fd Zd Zd Z fdZ xZS )r c H t t | | || _ || _ y r6 )r] r r` r
_container)r+ r r r` s r2 r` z _MutuallyExclusiveGroup.__init__ s!
%t5i@
#r4 c |j rt d }t | | j j | }| j
j
| |S )Nz-mutually exclusive arguments must be optional)r r r r@ r r r& )r+ r r s r2 r z#_MutuallyExclusiveGroup._add_action sK ??CDC S/ ! ,,V4 ""6*
r4 c p | j j | | j j | y r6 )r@ r r rW r s r2 r z&_MutuallyExclusiveGroup._remove_action s( &&v. ""6*r4 c Z t j dt d t | |i |S )Nz0Nesting mutually exclusive groups is deprecated.rF r7 )r[ r: r; r] r r< s r2 r z4_MutuallyExclusiveGroup.add_mutually_exclusive_group s/
>'
w3TDVDDr4 )F)r$ r= r> r` r r r rd re s @r2 r r s $
+E Er4 r c
e Zd ZdZddddg edddddddf
fd Zd Zd Zd Zd
Z d Z
d#d Z d#d
Z d Z
d Zd Zd Zd Zd Zd Zd Zd#dZd#dZd Zd Zd Zd Zd Zd Z d$d Z d$d Z d$d Z d%d!Z d" Z! xZ"S )&r aK Object for parsing command line strings into Python objects.
Keyword Arguments:
- prog -- The name of the program (default:
``os.path.basename(sys.argv[0])``)
- usage -- A usage message (default: auto-generated from arguments)
- description -- A description of what the program does
- epilog -- Text following the argument descriptions
- parents -- Parsers whose arguments should be copied into this one
- formatter_class -- HelpFormatter class for printing help messages
- prefix_chars -- Characters that prefix optional arguments
- fromfile_prefix_chars -- Characters that prefix files containing
additional arguments
- argument_default -- The default value for all arguments
- conflict_handler -- String indicating how to handle conflicts
- add_help -- Add a -h/-help option
- allow_abbrev -- Allow long options to be abbreviated unambiguously
- exit_on_error -- Determines whether or not ArgumentParser exits with
error info when an error occurs
Nr r Tc t t |
} |||| |
|0t j j t j d }|| _ || _ || _
|| _ || _ | | _
| | _ |
| _ | j } |t# d | _ |t# d | _ d | _ d }| j+ dd | d|v rdn|d }| j r,| j- |dz |d z d
z d
t. t# d |D ]; }| j1 | |j2 }| j2 j5 | = y # t6 $ r Y Jw xY w)
N)r r r r r zpositional argumentsoptionsc | S r6 r< )r s r2 identityz)ArgumentParser.__init__.<locals>.identity s Mr4 r# r hrF r z show this help message and exit)r r r ) r] r r` _ospathbasenamer argvr\ r epilogformatter_classfromfile_prefix_charsadd_help allow_abbrev
exit_on_errorr r _positionals
_optionals _subparsersr r r r r r r )r+ r\ r r rN parentsrO r rP r r rQ rR rS superinit add_grouprH default_prefixrl defaultsr` s r2 r` zArgumentParser.__init__ su .$8 k +#3#3 5 <88$$TYYq\2D
. %:"
( *++ %a(>&? @#AiL1
fdH- !$| 3 a == s"N1$4V$; x89
; 0F ' ' /
0!++ %%h/ 0 "
s 5 E E+*E+c L g d}|D cg c] }|t | | f c}S c c}w )N)r\ r r rO r rQ rC rE s r2 r( zArgumentParser._get_kwargs! s+
9>>wtT*+>>>rG c | j | j t d |j dt | d|v sd|v rNt |j dd }t |j dd }| j
|| | _ n| j | _ |j d k| j }| j }| j }|j | j ||d |j j |d< | j! |d } |d
d g i|}| j j# | |S ) Nz(cannot have multiple subparser argumentsr r r subcommandsr\ ro r r r< )rV r r r r# r r rT r r _get_positional_actionsr r r rv r r r ) r+ r r r rk r r
parsers_classr s r2 add_subparsersz ArgumentParser.add_subparsers/ s> ' JJqCD E .$t*5 f
7fjj-89EFJJ}d ;<K # 6 6uk JD # 0 0D ::f % ++-I 668K44F
K D & 2 2 4 : : <F6N ..vyA
;b;F; $$V,
r4 c |j r | j j | |S | j j | |S r6 )r rU r rT r s r2 r zArgumentParser._add_actionN s? OO ' ' /
) )& 1
r4 c X | j D cg c] }|j r| c}S c c}w r6 r r r s r2 _get_optional_actionsz$ArgumentParser._get_optional_actionsU s/ "mm*(( * * * 'c X | j D cg c] }|j s| c}S c c}w r6 rd r s r2 r_ z&ArgumentParser._get_positional_actionsZ s/ "mm. ,, . . .rf c | j || \ }}|r.t d }| j |dj | z |S Nzunrecognized arguments: %sr )r r r r* r+ rs rM rM r s r2
parse_argszArgumentParser.parse_argsb sD **4;
d 01C JJsSXXd^+ , r4 c |t j dd }n t | }|
t }| j D ]` }|j
t ust ||j
r-|j t us@t ||j
|j b | j D ]) }t || rt ||| j | + | j r | j || \ }}n| j || \ }}t |t r/|j# t% |t t' |t ||fS # t $ r$}| j t | Y d }~kd }~ww xY wrb )r rM r7 r r r r r r rb r rS _parse_known_argsr r r r r rD delattr)r+ rs rM r r errs r2 r z ArgumentParser.parse_known_argsi sL <99QR=D :D ! I mm HF{{(* y&++6 ~~X5 6;;G H NN ?D9d+ 4 )=> ?
%"&"8"8y"I 4 # 4 4T9 EOIt 9 5 6 KK +BC D I 6 7$ !
%
3s8$$
%s "E E=E88E=c X !" j j i j D ]h }|j }t |j D ]B \ }}j |g }|j
|d | |j
||dz d D j i g }t } t | D ]b \ }}
|
dk( r*|j d | D ] }
|j d 5 j |
} | d} n| |< d} |j | d dj | t t !d ! fd " "fd}
j "fd }g d
} r t }nd }||k r_t D cg c] }||k\ r| c} }||k7 r || }||kD r|}8|}| vr|| } j
| |} |
| }||k r_ || } j
|d g } j D ] }| vs|j r|j t# | /|j$ <t' |j$ t( sWt+ |j, sn|j$ t/ |j, u st1 |j, j3 ||j$ |r, j5 t7 d d
j | z j D ] }|j s|j D ] }|!v s & |j D cg c] }|j8 t: ur t# | ! }}t7 d } j5 |dj | z fS c c}w c c}w )Nrc rS r AOro c 2 j | j | | }|| j urQ
j | j | g D ]+ }|
v st d }t | }t
| ||z |t ur | || y y )Nz not allowed with argument %s)r _get_valuesr r r r6 r r ) r argument_stringsr argument_valuesconflict_actionr action_nameaction_conflictsrM seen_actionsseen_non_default_actionsr+ s r2 take_actionz5ArgumentParser._parse_known_args.<locals>.take_action s V $ " . .v7G HO
fnn4(,,V4'7';';FB'G GO&*BB > ?&6&G +FC+4E FF G h.tY G /r4 c | }|\ }}}j }g } |j | | dz S | ||d }j }|dk( rh|d |vra|dk7 r\|j |g |f |d } | |d z }|dd xs d }
j } || v r| | }|
}nt d } t || |z |dk( r | dz }
|g}|j |||f nNt d } t || |z | dz }|d } ||| }||z }
||
}|j |||f n|sJ |D ] \ }}} ||| |
S )Nrc rq r ro z ignored explicit argument %r)_match_argumentr& r r r r ) start_index option_tupler r explicit_argmatch_argument
action_tuples arg_countr charnew_explicit_arg
optionals_mapr stoprs r selected_patternsr- arg_strings_patternextrasoption_string_indicesr+ r| s r2 consume_optionalz:ArgumentParser._parse_known_args.<locals>.consume_optional s 1=L2> /FM< " 1 1N M >MM+k":;&?* + .vs ;I
! - -E!Q )! ,E 9 (B .%,,fb--HI ,Q /(,|A(>
+7+;+Ct((,(C(C
(M9%2=%AF+;L"#$B"CC"/l8J"K K #a *Q ,~%,,fdM-JK
> ? +FC,4F GG (!OE(;EF(C% .v7H II 9,D&uT2D!((&$
)FGs z ! /<
9+mFD-8
9Kr4 c
j }| d } | | }t | D ] \ }}| | |z }| |z
} || t | d d d | S r6 )_match_arguments_partialzipr ) r
match_partialselected_pattern
arg_countsr r rs r- r r r+ r| s r2 consume_positionalsz=ArgumentParser._parse_known_args.<locals>.consume_positionals$ s 9 9M 2;< @ &{4DEJ &)j%A
*! "; i0GHy( FD)
* )Z )9 :KN r4 r r z(the following arguments are required: %sr! z#one of the arguments %s is requiredr r6 ) rP _read_args_from_filesr r r r r iterr& _parse_optionalr* r r_ rN rM r r r6 r r r r r rD rb
_get_valuer r r r )#r+ r- rM r r r mutex_action conflictsarg_string_pattern_partsarg_strings_iter
arg_stringr patternr r r max_option_string_indexr next_option_string_indexpositionals_end_indexstrings
stop_indexrequired_actionsr r rF r ry r r r r rz r{ r| s# ``` @@@@@@@@r2 rm z ArgumentParser._parse_known_args s % % 1 44[AK :: 8K ' 6 6M#,[-G-G#H
8< , 7 7 b I r!23 q1uv!67
8 8 !# #% , &'7 8 9MAz T!(//4"2 9J,33C89 $ 3 3J ? ' !G/;)!, !G(//8# 9( !gg&> ? u #&5 H H*J J \ 224 ( &)*?&@ #&( # 44 (+ 2,)K' ,) (* $ 66(;K(H% );6"7K "7K "77%k2JK
g& 6 +;7K5 44: )5
k*+./ mm IF\)??$++,<V,DE 2"6>>37 6;;7 ')V[[*II 6;; $ GI I JJqCDyy!123
4 44 6E~~ # 2 2
6F !99
6 ,1+?+? =!' & 8 ; .f 5 =E = ABCJJsSXXe_ 45 6 & M,)~ =s N"$N'c 6 g }|D ] }|r|d | j vr|j | ( t |dd t j t j
5 }g }|j
j D ]) }| j | D ] }|j | + | j | }|j | d d d |S # 1 sw Y
xY w# t $ r%}| j t | Y d }~d }~ww xY w)Nr rc )r r )rP r& r r getfilesystemencodinggetfilesystemencodeerrorsreadr& convert_arg_line_to_argsr r r r r )r+ r- new_arg_stringsr args_filearg_liner/ ro s r2 r z$ArgumentParser._read_args_from_files s % )J A d6P6P!P &&z2 ) jn'+'A'A'C%)%C%C%EG <JS&( (1(8(C(C(E 8H'+'D'DX'N 8 + 2 23 7 88 '+&@&@&M '..{;< ), < < )JJs3x(()s0 5C*#A/C C* C' #C** D3DDc |gS r6 r< )r+ r s r2 r z'ArgumentParser.convert_arg_line_to_args s
zr4 c x | j | }t j || }|xd t d t t d t
t d i}|j
|j }|$t dd|j |j z }t || t |j d S )Nzexpected one argumentz expected at most one argumentz expected at least one argumentzexpected %s argumentzexpected %s argumentsrc ) _get_nargs_patternrW r r r r r r r r r r )r+ r r
nargs_patternr nargs_errorsr s r2 r~ z ArgumentParser._match_argument s //7
-)<= =a/0! ;<Q ? @ L
""6<<0C{ 5 6 %||-/5||< , , 5;;q>""r4 c \ g }t t | dd D ] }|d | }dj |D cg c] }| j | c} }t j
|| }|O|j
|j D cg c]
} t | c} |S |S c c}w c c} w )Nr r ro )r r r* r rW r r r )
r+ r r r r
actions_slicer r r r s
r2 r z'ArgumentParser._match_arguments_partial s s7|Q+ A #BQKMgg-: <#) $ 6 6v > < =GIIg':;E
Hvs6{ HI
< Is B$
B)
c
t |sy |d | j vry || j v r| j | }||d fS t | dk( ry d|v r7|j dd \ }}|| j v r| j | }|||fS | j | }t | dkD rLdj |D cg c] \ }}}|
c}}} }||d}t
d }| j ||z nt | dk( r|\ } | S | j j | r
| j sy d|v ry d |d fS c c}}}w )Nr rc r r! )r matchesz4ambiguous option: %(option)s could match %(matches)sr ) r r r split_get_option_tuplesr* r r r r r )
r+ r r r r
option_tuplesrF rs r r s
r2 r z ArgumentParser._parse_optional s !} 1 11 44 400<F:t+ + z?a * *4*:*:3*B 'M< ; ;; 44]C }l:: //
;
} !ii;H!J !J7FM< "/ !J KG (W=DJKC JJsTz "
1
$ )ML
( ( . .z :66 * Z%%3!Js 2
D3 c g }| j }|d |v r{|d |v rt| j rfd|v r|j dd \ }}n|}d }| j D ]9 }|j | s| j | }|||f}|j | ; |S |d |v r|d |vr|}d }|d d }|dd } | j D ]d }||k( r&| j | }||| f}|j | .|j | s@| j | }|||f}|j | f |S | j
t d |z |S )Nr rc r rF z unexpected option string: %s)r rR r r rX r& r r )
r+ r r r
option_prefixr r r short_option_prefixshort_explicit_args
r2 r z!ArgumentParser._get_option_tuples s !! u $ q)9U)B -'2?2E2Ec12M/M<$1M#'L%)%@%@ +M$//
>!%!<!<]!K $m\ A
c* +<
+ 1
&=+;5+H )M L"/"3 !.qr!2 !%!<!<
'
$77 ! 8 8 GF -1CCCMM#&"--m< ! 8 8 GF - =CMM#&
'
JJq78=H I
r4 c F |j }|d}n_|t k( rd}nS|t k( rd}nG|t k( rd}n;|t k( rd}n/|t
k( rd}n#|t k( rd}ndd j d
|z z }|j r$|j d d }|j d d }|S )
Nz(-*A-*)z(-*A?-*)z (-*[A-]*)z
(-*A[A-]*)z([-AO]*)z (-*A[-AO]*)z(-*-*)z(-*%s-*)z-*rq ro r )
r r r r r r r r* r r! )r+ r r r s r2 r z!ArgumentParser._get_nargs_pattern4 s = %M h
&M l
" 'M k
! (M i
&M f_ )M h
$M '3;)? ?M ) 1 1$ ;M ) 1 1#r :M r4 c | j || \ }}|r.t d }| j |dj | z |S ri )parse_known_intermixed_argsr r r* rj s r2 parse_intermixed_argsz$ArgumentParser.parse_intermixed_argse sD 55dIF
d 01C JJsSXXd^+ , r4 c | j }|D cg c] }|j t t fv r| }}|rt d|d j z | j
D cg c]# }|j D ] }||v r |j % c}}r t d | j } | j | j dd | _ |D ]: }|j |_
t |_ |j |_
t |_ < | j || \ }}|D ]g }t ||j st! ||j g k( s4ddlm} | d|j d| t' ||j i |D ]$ }|j |_ |j |_ & | j) }
|
D ] }|j* |_ d|_ | j
D ] }|j* |_ d|_ | j || \ }} |
D ] }|j, |_ | j
D ] }|j, |_ || _ || fS c c}w c c}}w # |D ]$ }|j |_ |j |_ & w xY w# |
D ] }|j, |_ | j
D ] }|j, |_ w xY w# | _ w xY w) Nz3parse_intermixed_args: positional arg with nargs=%sr z;parse_intermixed_args: positional in mutuallyExclusiveGroup )r: zDo not expect z in F)r_ r r r r r r r r r
save_nargsr r save_defaultr r rD r[ r: rn re r
save_required) r+ rs rM r r ar
save_usageremaining_argsr: r r s r2 r z*ArgumentParser.parse_known_intermixed_argsl s 224 "-
5 33
5
5 --.qTZZ 8 9
9 &*%D%D IE .. I&K2G
KK IK I 6 7
7. $ J
9::%!%!2!2!4QR!8DJ ) .F(. F%#+FL*0..F'%-FN
. -1,A,A$BK-M) > ) 8F 6;;7 ' 6;; ? C1 i PQ 6;;7
8 * 9F#)#4#4FL%+%8%8FN9 224I
9 ( ,F+1??F(&+FO, " < < +E*/..E'%*EN+ %)$9$9.:C%E! 6 ( ;F&,&:&:FO; ! < < 9E%*%8%8EN9 $DJ& u
5 I: * 9F#)#4#4FL%+%8%8FN9" ( ;F&,&:&:FO; ! < < 9E%*%8%8EN9 $DJsU !I,$(I1 K$ )BI7 =I7 6I7 :K$ A J% &:K$ 7+J""K$ %<K!!K$ $ K-c R |j t t fvr |j d |sn|j t
k( r[|j r
|j }n |j }t |t r$| j || }| j || |S |sO|j t k( r<|j s0|j |j }| j || |S |}|S t | dk( r>|j d t
fv r*|\ }| j || }| j || |S |j t k( r!|D cg c] }| j || }}|S |j t k( r6|D cg c] }| j || }}| j ||d |S |j t k( rt }|S |D cg c] }| j || }}|D ] }| j || |S # t $ r Y w xY wc c}w c c}w c c}w )NrS rc r )r r r rW r r r rA r r r r _check_valuer r r )r+ r r- r1 r vs r2 rt zArgumentParser._get_values s% << 2 2
""4(
v||x 7$$ %% 6!!&%0P I &,,,">''~~) !!&%0@ 9 $8 3
"v||h7G'G%KJOOFJ7E fe ,, ' \\Y
&9DEAT__VQ/EEE$ \\V
#9DEAT__VQ/EEE feAh / \\X
% E :EEAT__VQ/EEE
-!!&!,
- g
B F F Fs# H
HH H$
HHc | j d|j |j }t | st d }t |||z || }|S # t
$ r }t
| }t || d }~wt t f$ rJ t |j dt |j }||d}t d }t |||z w xY w)Nr# z%r is not callabler$ )r# r1 z!invalid %(type)s value: %(value)r) r r# r r r r r r r rD r' ) r+ r r r r r ro r0 rs s r2 r zArgumentParser._get_value s &&vv{{FKKH "()C i8 8
4 z*F
! -c(C , , :& 46;;
D4EFD :6D78C d
3 3 4s A C!A88A Cc |j U||j vrF|dj t t |j d}t d }t |||z y y )Nr! )r1 r z3invalid choice: %(value)r (choose from %(choices)s))r r* r r' r r )r+ r r1 rs r s r2 r zArgumentParser._check_value
s^ >> %%v~~*E " #yyT6>>)B CEDIJC d
3 3 +F %r4 c | j }|j | j | j | j |j S r6 )r r r r r rv )r+ rk s r2 r zArgumentParser.format_usage
sB '') DJJ
; ; =$$&&r4 c | j }|j | j | j | j |j | j | j D ]c }|j |j |j |j |j |j |j e |j | j |j S r6 )r r r r r r r r r{ r r r r} rN rv )r+ rk action_groups r2 rv zArgumentParser.format_help
s '') DJJ
; ; = 4++, ! / / $L # #L$6$6 7 | 7 7 8 # #L$?$? @ ! ! # $ 4;;' $$&&r4 c : | j | j S )Nr )rO r\ r: s r2 r z ArgumentParser._get_formatter4
s ###33r4 c h |t j }| j | j | y r6 )r r r r r+ files r2 print_usagezArgumentParser.print_usage:
s) <;;D D - - /6r4 c h |t j }| j | j | y r6 )r r r rv r s r2 r zArgumentParser.print_help?
s) <;;D D , , .5r4 c |r'|xs t j } |j | y y # t t f$ r Y y w xY wr6 )r stderrwriter r )r+ r: r s r2 r z ArgumentParser._print_messageD
sB &4;;D
7# #G,
s + ==c r |r | j |t j t j | y r6 )r r r r )r+ statusr: s r2 r zArgumentParser.exitO
s% 5 &r4 c | j t j | j |d}| j dt d |z y)zerror(message: string)
Prints a usage message incorporating the message to stderr and
exits.
If you override this in a subclass, it should not return -- it
should either exit or raise an exception.
)r\ r: rF z %(prog)s: error: %(message)s
N)r r r r\ r r )r+ r: rs s r2 r zArgumentParser.errorT
s=
% g6 !Q784?@r4 r= r6 )r N)#r$ r= r> r? r r` r( ra r re r_ rk r rm r r r~ r r r r r r rt r r r rv r r r r r r rd re s @r2 r r s , ! !. !'+"&") " #=0D ? >*
.$ Lx!t 6#, 8&t+Z+ bH!Z8t24' '.4 7
6
Ar4 r )4r? __version____all__osrJ rerW sysr r[ r r r r r r r r r r r r rC r r r
r r r6 Exceptionr r r
rZ r rg rn rt rz r} r r r r r r r r r r r r r< r4 r2 <module>r s ;z , * . v > "EF EPQ- Q!6 !M : $} $& ?I ?( \@
\@@ h 6/F 6/r .6 .F2 2.( ") "#-F #-L- -616 1.& &V 4bL bLH-M -1:v 1:n$ $(s8 s8l ';& ';TEn E8VA%'8 VAr4 
Browse
Usage
Versions