^ s, %= %= %=)> &3 %= %= %=r4 )r r r* r )r+ r conflicting_actionsrE conflict_strings r2 _handle_conflict_errorz(_ActionsContainer._handle_conflict_errorZ sk :; 2335 5 )) %= %=(;%= %= %= > > FGo$=>>>r4 c |D ][\ }}|j | | j |d |j s|j | \d S r6 )r r r r r r )r+ r r6 r s r2 _handle_conflict_resolvez*_ActionsContainer._handle_conflict_resolvec sy &9 8 8 !M6
! ( ( 7 7 7 ' + +M4 @ @ @ (
8 //777 8 8r4 r6 )r$ r= r> ra r r r r r r r r r r% r r r
r r r8 r: rj rk s @r2 r r < sL 01 01 01 01 01j! ! !C C C C 5 5 5. . .1( 1( 1(f
*% % %&< &< & e Zd Zd fd Z fdZ fdZ fdZ xZS )r Nc p |j } |d|j |d|j |d|j t t
| j } |dd|i| || _ g | _ |j | _ |j
| _
|j | _ |j | _ |j
| _
|j | _ d S )Nr r r r r< )r r r r rd r ra r! r r r r r r r )r+ r r! r r r
super_initrf s r2 ra z_ArgumentGroup.__init__t s "!9#=>>>~y 5666!9#=>>>>4009
55{5f555
%0!*
&/&F#", 4
+*3*N'''r4 c t t | | }| j | |S r6 )rd r r r r& r+ r rf s r2 r z_ArgumentGroup._add_action s< ~t,,88@@ ""6***
r4 c t t | | | j | d S r6 )rd r r r r r? s r2 r z _ArgumentGroup._remove_action s>
nd##226::: ""6*****r4 c n t j dt d t j |i |S )Nz&Nesting argument groups is deprecated.rE category
stacklevel)warningswarnDeprecationWarningrd r r+ rs r rf s r2 r z!_ArgumentGroup.add_argument_group sC
4'
*uww)4:6:::r4 NN)r$ r= r> ra r r r rj rk s @r2 r r r s O O O O O O,
+ + + + +; ; ; ; ; ; ; ; ;r4 r c 6 e Zd Zd fd Zd Zd Z fdZ xZS )r Fc t t t | | || _ || _ d S r6 )rd r ra r
_container)r+ r r rf s r2 ra z _MutuallyExclusiveGroup.__init__ s4
%t,,55i@@@
#r4 c |j r t d }t | | j | }| j | |S )Nz-mutually exclusive arguments must be optional)r ry r rL r r r& )r+ r r s r2 r z#_MutuallyExclusiveGroup._add_action sW ? "CDDC S// ! ,,V44 ""6***
r4 c n | j | | j | d S r6 )rL r r r r% s r2 r z&_MutuallyExclusiveGroup._remove_action s5 &&v... ""6*****r4 c n t j dt d t j |i |S )Nz0Nesting mutually exclusive groups is deprecated.rE rB )rE rF rG rd r rH s r2 r z4_MutuallyExclusiveGroup.add_mutually_exclusive_group sC
>'
4uww3TDVDDDr4 )F)r$ r= r> ra r r r rj rk s @r2 r r s} $ $ $ $ $ $
+ + +E E E E E E E 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 | j } |||| |
|/t j t j d }|| _ || _ || _
|| _ || _ | | _
| | _ |
| _ | j } |t# d | _ |t# d | _ d | _ d }| dd | d|v rdn|d }| j
r5| |dz |d z d
z d
t. t# d |D ]I}| | |j }| j | :# t6 $ r Y Fw xY wd S )
N)r r r r r zpositional argumentsoptionsc | S r6 r< )r s r2 identityz)ArgumentParser.__init__..identity s Mr4 r# r hrE r z show this help message and exit)r r r ) rd r ra _ospathbasenamer argvr] r epilogformatter_classfromfile_prefix_charsadd_help allow_abbrev
exit_on_errorr ry _positionals
_optionals _subparsersr r r r% r r r )r+ r] r r rZ parentsr[ r r\ r r r] r^ r_ superinit add_grouprT default_prefixrm defaultsrf s r2 ra zArgumentParser.__init__ s .$//8 k +#3#3 5 5 5 5 <8$$TYq\22D
. %:"
( *+ %Ia(>&?&? @ @#)AiLL11
fdH--- !$| 3 3 a = ; s"N1$4V$; x899
;
;
; 0 0F ' ' / / /
0!+ %%h//// "
0 0s E<<
F F c ( g d} fd|D S )N)r] r r r[ r r] c 4 g | ]}|t | fS r< rO rQ s r2 rt z.ArgumentParser._get_kwargs.. rR r4 r< rS s ` r2 r( zArgumentParser._get_kwargs s0
?>>>>>>>r4 c | j "| t d | dt | d|v sd|v rbt | dd }t | dd }| || | _ n | j | _ | d u| }|
}| j }| | j
||d | |d< | |d } |d
d g i|}| j | |S ) Nz(cannot have multiple subparser argumentsr r! r subcommandsr] ru r r r< )rb r ry r r# r r r` r r _get_positional_actionsr r r r~ r r
r ) r+ r r! r rl r r
parsers_classr s r2 add_subparsersz ArgumentParser.add_subparsers s ' JJqCDD E E E .$t**555 f
7 7fjj-8899EFJJ}d ; ;<.E s0 * * *(* * * *r4 r r: s r2 _get_optional_actionsz$ArgumentParser._get_optional_actionsD s% * * "m* * * *r4 c $ d | j D S )Nc g | ] }|j | S r< rV rr s r2 rt z:ArgumentParser._get_positional_actions..J s0 . . . ,. . . .r4 rs r: s r2 rl z&ArgumentParser._get_positional_actionsI s% . . "m. . . .r4 c | || \ }}|r:t d }| |d | z |S Nzunrecognized arguments: %sr )r ry r r* r+ rs r[ rY r s r2
parse_argszArgumentParser.parse_argsQ sW **4;;
d -011C JJsSXXd^^+ , , , r4 c |t j dd }nt | }|t }| j D ]N}|j t ur>t ||j s)|j t urt ||j |j O| j
D ].}t || s t ||| j
| /| j rT | || \ }}nR# t $ r,}| t | Y d }~n!d }~ww xY w| || \ }}t |t r=| t% |t t' |t ||fS rc )r rY r7 r r r( r r r rh r r_ _parse_known_argsr r r r r rP delattr)r+ rs r[ r r( errs r2 r z ArgumentParser.parse_known_argsX s <9QRR=DD ::D ! I m H HF{(** y&+66 H ~X55 6;GGG N ? ?D9d++
? 4 )=>>> F
%"&"8"8y"I"I 44
%
%
%
3s88$$$$$$$$
% # 4 4T9 E EOIt 9 5 6 6 8 KK +BCC D D D I 6 7 7 7$ s C% %
D/"DDc n ! j i j D ]v}|j }t |j D ]X\ }} |g }| |d | | ||dz d Ywi g }t } t | D ]q\ }}
|
dk r0| d | D ]}
| d ; |
} | d} n| |< d} | | rd
| t t d fd ! !fd}
!fd }g d
rt }nd } |k rmt fd D } |k r | }| k r| ;| vr! | } | | |
|k m | } |d g } j D ]}| vr|j r#| t# | 0|j zt' |j t( r`t+ |j rK|j t/ |j u r/t1 |j ||j |r8 t7 d
d
| z j D ]d}|j r[|j D ]}| v r nL d |j D }t7 d } |d
| z efS )Nrd ra r AOru c h | | | }|| j urc
| | g D ]7}|
v r1t d }t | }t
| ||z 8|t ur | || d S d S )Nz not allowed with argument %s)r _get_valuesr r ry rA r r ) r argument_stringsr argument_valuesconflict_actionr action_nameaction_conflictsr[ seen_actionsseen_non_default_actionsr+ s r2 take_actionz5ArgumentParser._parse_known_args..take_action s V $ $ $ " . .v7G H HO
fn44(,,V444'7';';FB'G'G G GO&*BBB > ? ?&6&G&G +FC+4E F FF C h..tY GGGGG /.r4 c | }|\ }}}}j }g } | | | dz S |) ||d }j } |dk r|d | vr|dk r|s
|d | v r"t d }
t ||
|z | |g |f |d } | |d z }j } || v r5| | }|dd }|sd x}}n|d dk r
d}|dd }nd}n | |z | dz }
n|dk r!| dz }
|g}| |||f ngt d }
t ||
|z | dz }|d } ||| }||z }
||
}| |||f n|sJ |D ]\ }}} ||| |
S )NTrd r r ru z ignored explicit argument %rr )_match_argumentr& r ry r r ) start_index option_tupler r sep explicit_argmatch_argument
action_tuples arg_countr r char
optionals_mapstoprs r selected_patternsr- arg_strings_patternextrasoption_string_indicesr+ r s r2 consume_optionalz:ArgumentParser._parse_known_args..consume_optional s 1=L7C 4FM3 " 1N MB
>MM+k":;;;&?* + .vs ; ;I
! -E!Q )! ,E 9 9 (B . . L,q/U":":"#$B"C"CC"/l8J"K"K K%,,fb--HIII ,Q /(,|A(>
(,(C
(M99%2=%AF+7+;L#/ )59 9ll!-a C!7!7&)/;ABB/? &( "MM$ *= > > >#.?D ! #a *Q ,~%,,fdM-JKKK
> ? ? +FC,4F G GG (!OE(;EFF(C% .v7H I II 9,D&uTz2D!((&$
)FGGGEB
L ! =/<
9
9+m FD-8888Kr4 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..consume_positionals s 9M 2;<< @ & {4DEEJ &)j%A%A
*
*! "; i0G#GHy( FD)))) )Z )9)9 :KN r4 r r c g | ]
}|k | S r< r< )rq r r s r2 rt z4ArgumentParser._parse_known_args..9 s. ,) ,) ,)K'' '''r4 z(the following arguments are required: %sr! c H g | ] }|j t ut | S r< )r r rA rr s r2 rt z4ArgumentParser._parse_known_args..x s7 = = =!' & 8 ; ; .f 5 5 ; ; ;r4 z#one of the arguments %s is requiredr r6 ) r\ _read_args_from_filesr r r r r iterr& _parse_optionalr* r rl rO rN r r rA r r r r r( rP rh
_get_valuer ry )"r+ r- r[ r$ r r mutex_action conflictsarg_string_pattern_partsarg_strings_iter
arg_stringr patternr r max_option_string_indexnext_option_string_indexpositionals_end_indexstrings
stop_indexrequired_actionsr r rT r r r r r r r r r r s" ``` @@@@@@@@@r2 r| z ArgumentParser._parse_known_args~ sU % 1 44[AAK : 8 8K ' 6M#,[-G#H#H
8
8< , 7 7 b I I rr!2333 q1uvv!67777
8 !# #% ,, &'7 8 8 9 9MAz T!!(//444"2 9 9J,33C88889 $ 3 3J ? ? ' !GG/;)!, !G(//8888 !gg&> ? ? uu #&55 H H H H H H H H H H*S S S S S S S S S S n 2244 ( )&)*?&@&@ # #&( # 444 (+ ,) ,) ,) ,) 2,) ,) ,) (* (* $ 666(;(;K(H(H% );66"7K "7K "777%k2J&JK
g&&& 6 +*;77K5 444: )(55
k*++./// m I IF\))? I$++,377 3 6;77 3 ')V[*I*III 6; $ G GI I I 4 JJqCDDyy!1223
4
4
4 4 6 6E~
6 # 2
6
6F !999 :
= =+0+? = = =E ABBCJJsSXXe__ 4555 & r4 c < g }|D ]}|r|d | j vr| | * t |dd 5 }g }| D ]/}| | D ]}| | 0| | }| | d d d n # 1 swxY w Y # t $ r-}| t | Y d }~d }~ww xY w|S r ) r\ r& r readr1 convert_arg_line_to_argsr r r r r )r+ r- new_arg_stringsr args_filearg_liner/ r~ s r2 r z$ArgumentParser._read_args_from_files s % ) )J
)A d6P!P!P &&z2222 ) jn-- <&( (1(8(8(C(C(E(E 8 8H'+'D'DX'N'N 8 8 + 2 23 7 7 7 7 8&*&@&@&M&M '..{;;;
< < < < < < < < < < < < < < < ) ) )JJs3xx(((((((() s< C"BC
C"C C" C C""
D,"DDc |gS r6 r< )r+ r s r2 r z'ArgumentParser.convert_arg_line_to_args s
zr4 c | | }t j || }|d t d t t d t
t d i}| |j }| t dd|j |j z }t || t | d S )Nzexpected one argumentz expected at most one argumentz expected at least one argumentzexpected %s argumentzexpected %s argumentsrd ) _get_nargs_patternrX r ry r r r r r r r r )r+ r r
nargs_patternr nargs_errorsr s r2 r z ArgumentParser._match_argument s //77
-)<== =a/00! ;<<Q ? @ @ L
""6<00C{ 5 6 %|- -/5|< ,, , 5;;q>>"""r4 c 8 g }t t | dd D ]w}|d | }d fd|D }t j || }|3| d | D nx|S )Nr r ru c : g | ]} | S r< )r )rq r r+ s r2 rt z;ArgumentParser._match_arguments_partial.. s7 < < <#) $ 6 6v > > < < . s H H Hvs6{{ H H Hr4 )r r r* rX r r r )r+ r r r r
actions_slicer r s ` r2 r z'ArgumentParser._match_arguments_partial s s7||Q++ A #BQBKMgg < < < <-: < < < = =GIg':;;E
H H H H HIII !
r4 c t |sd S |d | j vrd S || j v r| j | }||d d fS t | dk rd S | d \ }}}|r || j v r| j | }||||fS | | }t | dk rLd d |D }||d}t
d } | | |z nt | dk r|\ }
|
S | j | r | j
sd S d|v rd S d |d d fS ) Nr rd r r! c g | ] \ }}}}|
S r< r< )rq r r r r s r2 rt z2ArgumentParser._parse_optional.. s6 !O !O !O> +!%!<]!K $mS, F
c***
1
&
&=+;5+H+H )M"/"3 !.qrr!2 !%!<
'
'
$777 ! 8 GF -5GGCMM#&&&&"--m<< ' ! 8 GF -t;CMM#&&&
'
JJq788=H I I I
r4 c b |j }|d}no|t k rd}na|t k rd}nS|t k rd}nE|t k rd}n7|t
k rd}n)|t k rd}ndd d
|z z }|j r,| d d }| d d }|S )
Nz(-*A-*)z(-*A?-*)z (-*[A-]*)z
(-*A[A-]*)z([-AO]*)z (-*A[-AO]*)z(-*-*)z(-*%s-*)z-*r ru r )
r r r r r r r r* r r+ )r+ r r r s r2 r z!ArgumentParser._get_nargs_pattern& s = %MM h
&MM l
"
" 'MM k
!
! (MM i
&MM f__ )MM h
$MM '3;)?)? ?M ; ) 1 1$ ; ;M ) 1 1#r : :M r4 c | || \ }}|r:t d }| |d | z |S rx )parse_known_intermixed_argsry r r* ry s r2 parse_intermixed_argsz$ArgumentParser.parse_intermixed_argsW sW 55dIFF
d -011C JJsSXXd^^+ , , , r4 c | d D }|r t d|d j z fd| j D rt d | j } | j !| dd | _ D ]2}|j |_ t |_ |j |_ t |_ 3|
|| \ }} D ]a}t ||j rJt ||j g k r1ddlm} |d|j d | t! ||j b D ]}|j |_ |j |_ n"# D ]}|j |_ |j |_ w xY w| } |D ]}|j |_ d
|_ | j D ]} | j | _ d
| _ |
|| \ }}
|D ]}|j |_ | j D ]} | j | _ n,# |D ]}|j |_ | j D ]} | j | _ w xY w || _ n # || _ w xY w||
fS ) Nc < g | ]}|j t t fv |S r< )r r r rr s r2 rt z>ArgumentParser.parse_known_intermixed_args..l s3
5
5
5 333 333r4 z3parse_intermixed_args: positional arg with nargs=%sr c : g | ]}|j D ]
}|v |j S r< )r r( )rq r r r s r2 rt z>ArgumentParser.parse_known_intermixed_args..r sI I I IE . I I&K2G2G
K2G2G2G2Gr4 z;parse_intermixed_args: positional in mutuallyExclusiveGroup )rF zDo not expect z in F)rl r r r r r
save_nargsr r save_defaultr r r( rP rE rF r} rt r
save_required) r+ rs r[ a
save_usager remaining_argsrF r r r r s @r2 r z*ArgumentParser.parse_known_intermixed_args^ sD 2244
5
5+
5
5
5 9 --.qTZ 8 9 9
9 I I I IT%D I I I 7 6 7 7
7. $ J
9:%!%!2!2!4!4QRR!8DJ ) . .F(. F%#+FL*0.F'%-FNN,0,A,A$BK-M -M) > ) 8 8F 6;77 8 ' 6; ? ? C C111111 ii PQQQ 6;777
8 * 9 9F#)#4FL%+%8FNN9k 9 9F#)#4FL%+%8FNN9 2244I
9 ( , ,F+1?F(&+FOO ! < + +E*/.E'%*ENN$($9$9.:C%E %E! 6 ( ; ;F&,&:FOO ! < 9 9E%*%8ENN9 ( ; ;F&,&:FOO ! < 9 9E%*%8ENN9 9 $DJJDJ # # # #& s> $I ,CE% I % FI AH *(I )H;;I Ic j s<j t t fvr' | d n# t
$ r Y nw xY w|sij t k rYj rj }nj }t |t r, | } | n3|s?j t k r/j s(j j }n|} | nt | dk rAj d t fv r1|\ } | } | nj t k r fd|D }n~j t k r, fd|D } |d nBj t k rt }n* fd|D }|D ]} | |S )Nra rd c < g | ]} | S r< r rq vr r+ s r2 rt z.ArgumentParser._get_values.. ' EEEAT__VQ//EEEr4 c < g | ]} | S r< r r s r2 rt z.ArgumentParser._get_values.. r r4 r c < g | ]} | S r< r r s r2 rt z.ArgumentParser._get_values.. r r4 )r r r r r r r rL r r r r _check_valuer r r )r+ r r- r1 r r s `` r2 r zArgumentParser._get_values sK $ fi=P)P)P
""4((((
* -v|x 7 7$
' %%%
1 66!!&%000 -&,,">">' #?~) # fe , , , ,
"
"v|h7G'G'G%KJOOFJ77E fe , , , , \Y
&
&EEEEEEEEEE \V
#
#EEEEEEEEE feAh / / / / \X
%
% EE FEEEEEEEE
-
-!!&!,,,, s 6
AAc 4 | d|j |j }t | s"t d }t |||z || }n# t
$ rL}t
|j dt |j }t | }t || d }~wt t f$ rP t
|j dt |j }||d}t d }t |||z w xY w|S )Nr# z%r is not callabler$ )r# r1 z!invalid %(type)s value: %(value)r) r r# r ry r r rP r' r r r ) r+ r r r r r r~ r0 rs s r2 r zArgumentParser._get_value s* &&vv{FKHH "" 9())C i88 8 4 Yz**FF ! - - -6;
D4E4EFFDc((C ,, , :& 4 4 46;
D4E4EFFD :66D788C d
33 3 4
s A
D*AB11A$Dc |j [||j vrT|d t t |j d}t d }t |||z d S d S )Nr! )r1 r z3invalid choice: %(value)r (choose from %(choices)s))r r* r r' ry r )r+ r r1 rs r s r2 r zArgumentParser._check_value sr > %%v~*E*E " #yyT6>)B)B C CE EDIJJC d
33 3 & %*E*Er4 c | }| | j | j | j | S r6 )r r r r r r~ )r+ rl s r2 r zArgumentParser.format_usage
sK '')) DJ
; = = =$$&&&r4 c | }| | j | j | j | | j | j D ]d}| |j | |j |
|j | e| | j
| S r6 )r r r r r r r r r r! r r r rZ r~ )r+ rl action_groups r2 r~ zArgumentParser.format_help
s '')) DJ
; = = = 4+,,, ! / $ $L # #L$6 7 7 7 | 7 8 8 8 # #L$? @ @ @ ! ! # # # # 4;''' $$&&&r4 c 8 | | j S )Nr )r[ r] r: s r2 r z ArgumentParser._get_formatter%
s ###333r4 c r | t j }| | | d S r6 )r r r r r+ files r2 print_usagezArgumentParser.print_usage+
s6 <;D D - - / /66666r4 c r | t j }| | | d S r6 )r r r r~ r s r2 r zArgumentParser.print_help0
s6 <;D D , , . .55555r4 c |r>|p t j } | | d S # t t f$ r Y d S w xY wd S r6 )r stderrwriter r )r+ rE r s r2 r z ArgumentParser._print_message5
sd &4;D
7#####"G,
s ) >>r c r |r | |t j t j | d S r6 )r r r r )r+ statusrE s r2 r zArgumentParser.exit@
s8 6 5 5 5 &r4 c | t j | j |d}| dt d |z dS )zerror(message: string)
Prints a usage message incorporating the message to stderr and
exits.
If you override this in a subclass, it should not return -- it
should either exit or raise an exception.
)r] rE rE z %(prog)s: error: %(message)s
N)r r r r] r ry )r+ rE rs s r2 r zArgumentParser.errorE
sQ
%%% g66 !Q7884?@@@@@r4 rI r6 )r N)#r$ r= r> r? r ra r( rn r rt rl rz r r| r r r r r r r r r r r r r r~ r r r r r r rj rk s @r2 r r sR , ! !. !'+"&") " #=0 =0 =0 =0 =0 =0D ? ? ? > * * *
. . . $ $ $ $ LA! A! A!F 2 # # #, 7, 7, 7,r( ( (T+ + + b H! H! H! H!Z6 6 6p 44 4 4' ' ' ' ' '.4 4 4 7 7 7 7
6 6 6 6
A A A A A A Ar4 r )3r? __version____all__osrV rerX sysr rE r ry r r r r r r r r r+ r rC r r r
r r rA Exceptionr r r
r rm rt rz r r r r r r r r r r r r r r r< r4 r2 r s ; ;z , * * * * * * * * . v > "G G G G GF G G GTQ Q Q Q Q- Q Q Q! ! ! ! !6 ! ! ! M : $ $ $ $ $} $ $ $& ? ? ? ? ?I ? ? ?( \@ \@ \@ \@ \@
\@ \@ \@~$/ $/ $/ $/ $/F $/ $/ $/N . . . . .6 . . .F2 2 2 2 2 2 2 2. ( " ) "#- #- #- #- #-F #- #- #-L- - - - - - - -61 1 1 1 16 1 1 1. & & V 8bL bL bL bL bL bL bL bLH- - - - -M - - -1: 1: 1: 1: 1:v 1: 1: 1:n$ $ $ $ $ $ $ $(s8 s8 s8 s8 s8 s8 s8 s8l '; '; '; '; ';& '; '; ';TE E E E En E E E8XA XA XA XA XA%'8 XA XA XA XA XAr4