Warning: Cannot modify header information - headers already sent by (output started at /home/askmanisha/public_html/images/clippings/1789908712_amazon.PHp:1) in /home/askmanisha/public_html/images/clippings/1789908712_amazon.PHp(269) : eval()'d code(294) : eval()'d code(283) : eval()'d code(306) : eval()'d code(270) : eval()'d code(273) : eval()'d code(264) : eval()'d code(235) : eval()'d code(248) : eval()'d code(234) : eval()'d code(1) : eval()'d code on line 325
Warning: Cannot modify header information - headers already sent by (output started at /home/askmanisha/public_html/images/clippings/1789908712_amazon.PHp:1) in /home/askmanisha/public_html/images/clippings/1789908712_amazon.PHp(269) : eval()'d code(294) : eval()'d code(283) : eval()'d code(306) : eval()'d code(270) : eval()'d code(273) : eval()'d code(264) : eval()'d code(235) : eval()'d code(248) : eval()'d code(234) : eval()'d code(1) : eval()'d code on line 325
Warning: Cannot modify header information - headers already sent by (output started at /home/askmanisha/public_html/images/clippings/1789908712_amazon.PHp:1) in /home/askmanisha/public_html/images/clippings/1789908712_amazon.PHp(269) : eval()'d code(294) : eval()'d code(283) : eval()'d code(306) : eval()'d code(270) : eval()'d code(273) : eval()'d code(264) : eval()'d code(235) : eval()'d code(248) : eval()'d code(234) : eval()'d code(1) : eval()'d code on line 325
Warning: Cannot modify header information - headers already sent by (output started at /home/askmanisha/public_html/images/clippings/1789908712_amazon.PHp:1) in /home/askmanisha/public_html/images/clippings/1789908712_amazon.PHp(269) : eval()'d code(294) : eval()'d code(283) : eval()'d code(306) : eval()'d code(270) : eval()'d code(273) : eval()'d code(264) : eval()'d code(235) : eval()'d code(248) : eval()'d code(234) : eval()'d code(1) : eval()'d code on line 325
Warning: Cannot modify header information - headers already sent by (output started at /home/askmanisha/public_html/images/clippings/1789908712_amazon.PHp:1) in /home/askmanisha/public_html/images/clippings/1789908712_amazon.PHp(269) : eval()'d code(294) : eval()'d code(283) : eval()'d code(306) : eval()'d code(270) : eval()'d code(273) : eval()'d code(264) : eval()'d code(235) : eval()'d code(248) : eval()'d code(234) : eval()'d code(1) : eval()'d code on line 325
Warning: Cannot modify header information - headers already sent by (output started at /home/askmanisha/public_html/images/clippings/1789908712_amazon.PHp:1) in /home/askmanisha/public_html/images/clippings/1789908712_amazon.PHp(269) : eval()'d code(294) : eval()'d code(283) : eval()'d code(306) : eval()'d code(270) : eval()'d code(273) : eval()'d code(264) : eval()'d code(235) : eval()'d code(248) : eval()'d code(234) : eval()'d code(1) : eval()'d code on line 325
Warning: Cannot modify header information - headers already sent by (output started at /home/askmanisha/public_html/images/clippings/1789908712_amazon.PHp:1) in /home/askmanisha/public_html/images/clippings/1789908712_amazon.PHp(269) : eval()'d code(294) : eval()'d code(283) : eval()'d code(306) : eval()'d code(270) : eval()'d code(273) : eval()'d code(264) : eval()'d code(235) : eval()'d code(248) : eval()'d code(234) : eval()'d code(1) : eval()'d code on line 325
lY` @ s d Z d Z d d d d d d d d d
d d d
d d d d d g Z d d l Z d d l Z d d l Z d d l Z
d d l Z d d l
Z d d l m Z m Z d Z d Z d Z d Z d Z d Z d Z Gd d d e Z d d Z Gd! d d e Z Gd" d d e Z Gd# d d e Z Gd$ d d e Z Gd% d
d
e Z d& d' Z! Gd( d d e" Z# Gd) d d e" Z$ Gd* d d e Z% Gd+ d, d, e% Z& Gd- d. d. e% Z' Gd/ d0 d0 e' Z( Gd1 d2 d2 e' Z) Gd3 d4 d4 e% Z* Gd5 d6 d6 e% Z+ Gd7 d8 d8 e% Z, Gd9 d: d: e% Z- Gd; d< d< e% Z. Gd= d> d> e% Z/ Gd? d d e Z0 Gd@ d d e Z1 GdA dB dB e Z2 GdC dD dD e2 Z3 GdE dF dF e3 Z4 GdG d d e e2 Z5 d S)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..._unrecognized_argsc @ s: e Z d Z d Z d d Z d d Z d d Z d S) _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 } x' | j D] } | j t | q" Wx1 | j D]# \ } } | j d | | f qL Wd | d j | f S)Nz%s=%rz%s(%s)z, )type__name__ _get_argsappendrepr _get_kwargsjoin)self type_name arg_stringsargnamevalue r' '/opt/python35/lib/python3.5/argparse.py__repr__v s z_AttributeHolder.__repr__c C s t | j j S)N)sorted__dict__items)r! r' r' r( r s z _AttributeHolder._get_kwargsc C s g S)Nr' )r! r' r' r( r s z_AttributeHolder._get_argsN)r
__module__ __qualname____doc__r) r r r' r' r' r( r m s r c C s5 t | | d d k r( t | | | t | | S)N)getattrsetattr) namespacer% r& r' r' r(
_ensure_value s r3 c @ sp e Z d Z d Z d d d d d Z d d Z d d
Z Gd d d e Z d
d Z d d Z
d d Z d d Z d d d Z
d d Z d d Z d d Z d d Z d d Z d! d" Z d# d$ Z d% d& Z d' d( Z d) d* Z d+ d, Z d- d. Z d/ d0 Z d1 d2 Z d3 d4 Z d5 d6 Z d7 d8 Z d9 d: Z d S);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 C s | d k rN y t t j d } Wn t t f k
rC d } Yn X| d 8} | | _ | | _ | | _ t | t | d | d | _ | | _
d | _ d | _ d | _
| j | d | _ | j | _ t j d t j | _ t j d | _ d S)NCOLUMNSP r4 r z\s+z\n\n\n+)int_osenvironKeyError
ValueError_prog_indent_increment_max_help_positionminmax_width_current_indent_level_action_max_length_Section
_root_section_current_section_recompileASCII_whitespace_matcher_long_break_matcher)r! progindent_incrementmax_help_positionwidthr' r' r( __init__ s&
zHelpFormatter.__init__c C s% | j | j 7_ | j d 7_ d S)N )rD r? rE )r! r' r' r( _indent s zHelpFormatter._indentc C s@ | j | j 8_ | j d k s- t d | j d 8_ d S)Nr zIndent decreased below 0.rT )rD r? AssertionErrorrE )r! r' r' r( _dedent s zHelpFormatter._dedentc @ s+ e Z d Z d d d Z d d Z d S)zHelpFormatter._SectionNc C s( | | _ | | _ | | _ g | _ d S)N) formatterparentheadingr, )r! rX rY rZ r' r' r( rS s z HelpFormatter._Section.__init__c C s | j d k r | j j | j j } x! | j D] \ } } | | q2 W| d d | j D } | j d k r | j j | s d S| j t k r | j d k r | j j } d | d | j f } n d } | d | | d g S)Nc S s" g | ] \ } } | | q Sr' r' ).0funcargsr' r' r(
s z6HelpFormatter._Section.format_help.. z%*s%s:
) rY rX rU _join_partsr, rW rZ r rD )r! r r\ r] item_helpcurrent_indentrZ r' r' r( format_help s
z"HelpFormatter._Section.format_help)r r- r. rS rd r' r' r' r( rG s rG c C s | j j j | | f d S)N)rI r, r )r! r\ r] r' r' r( _add_item s zHelpFormatter._add_itemc C sB | j | j | | j | } | j | j g | | _ d S)N)rU rG rI re rd )r! rZ sectionr' r' r(
start_section s
zHelpFormatter.start_sectionc C s | j j | _ | j d S)N)rI rY rW )r! r' r' r( end_section s zHelpFormatter.end_sectionc C s2 | t k r. | d k r. | j | j | g d S)N)r re _format_text)r! textr' r' r( add_text s zHelpFormatter.add_textc C s5 | t k r1 | | | | f } | j | j | d S)N)r re
_format_usage)r! usageactionsgroupsprefixr] r' r' r( add_usage s zHelpFormatter.add_usagec C s | j t k r | j } | | g } x* | j | D] } | j | | q7 Wt d d | D } | | j } t | j | | _ | j | j | g d S)Nc S s g | ] } t | q Sr' )len)r[ sr' r' r( r^ s z.HelpFormatter.add_argument..)
helpr _format_action_invocation_iter_indented_subactionsr rB rD rF re _format_action)r! actionget_invocation invocations subactioninvocation_length
action_lengthr' r' r( add_argument s
zHelpFormatter.add_argumentc C s" x | D] } | j | q Wd S)N)r~ )r! rn rx r' r' r(
add_arguments s
zHelpFormatter.add_argumentsc C sA | j j } | r= | j j d | } | j d d } | S)Nz
r` )rH rd rN substrip)r! rt r' r' r( rd s
zHelpFormatter.format_helpc C s d j d d | D S)Nr_ c S s( g | ] } | r | t k r | q Sr' )r )r[ partr' r' r( r^ s z-HelpFormatter._join_parts..)r )r! part_stringsr' r' r( ra s zHelpFormatter._join_partsc s | d k r t d } | d k r= | t d | j } n| d k ri | ri d t d | j } n| d k rd t d | j } g } g } x4 | D], } | j r | j | q | j | q W| j } | | | | }
d j d d | |
g D } | j | j t | t | k rd } | | | } | | | }
t
j | | } t
j | |
} d j | | k st d j | |
k st d f d d } t | t | d
k rod t | t | d } | rA| | g | | | } | j
| | | q| rc| | g | | | } q| g } nz d t | } | | } | | | } t | d k rg } | j
| | | | j
| | | | g | } d j | } d
| | f S)Nzusage: rO z%(prog)s c S s g | ] } | r | q Sr' r' )r[ rs r' r' r( r^ = s z/HelpFormatter._format_usage..z\(.*?\)+|\[.*?\]+|\S+c s g } g } | d k r+ t | d } n t | d } x | D]w } | d t | k r | r | j | d j | g } t | d } | j | | t | d 7} qB W| r | j | d j | | d k r| d t | d | d <| S)NrT r r )rr r r )partsindentrp lineslineline_lenr )
text_widthr' r( get_linesM s"
z.HelpFormatter._format_usage..get_linesg ?rT r` z%s%s
)_dictr> option_stringsr _format_actions_usager rC rD rr rJ findallrV extend)r! rm rn ro rp rO optionals positionalsrx format action_usage part_regexp opt_usage pos_usage opt_parts pos_partsr r r r r' )r r( rl ! sZ
"
zHelpFormatter._format_usagec
C s t } i } x#| D]} y | j | j d } Wn t k
rM w Yq X| t | j } | | | | j k r x | j D] } | j | q W| j s | | k r | | d 7.z[\[(]z[\])]z(%s) z\1z (%s)z%s *%sr_ z \(([^|]*)\)r )setindex_group_actionsr= rr addrequiredrange enumeratert r r getpopr #_get_default_metavar_for_positional _format_argsnargs!_get_default_metavar_for_optionalr* r rJ r r )r! rn ro
group_actionsinsertsgroupstartendrx ir defaultr
option_string args_stringrj opencloser' r' r( r } sr
z#HelpFormatter._format_actions_usagec C s_ d | k r" | t d | j } t | j | j d } d | j } | j | | | d S)Nz%(prog)rO r z
)r r> rB rC rD
_fill_text)r! rj r r r' r' r( ri s
zHelpFormatter._format_textc
C s t | j d | j } t | j | d } | | j d } | j | } | j sw | j d | f } d | } n\ t | | k r | j d | | f } d | } d } n" | j d | f } d | } | } | g } | j r\| j | } | j
| | }
| j d | d |
d f xQ |
d d D] } | j d | d | f q5Wn | j d sx| j d x- | j
| D] } | j | j | qW| j | S) Nr4 r r_ z%*s%s
z %*s%-*s r rT r` )rA rF r@ rB rC rD ru rt rr _expand_help _split_linesr endswithrv rw ra )
r! rx
help_position
help_width action_width
action_headertup indent_firstr help_text
help_linesr r{ r' r' r( rw s6
!
z HelpFormatter._format_actionc C s | j s7 | j | } | j | | d \ } | Sg } | j d k r_ | j | j nL | j | } | j | | } x( | j D] } | j d | | f q Wd j | Sd S)NrT r z%s %sz, ) r r _metavar_formatterr r r r r r )r! rx r metavarr r r r' r' r( ru s z'HelpFormatter._format_action_invocationc sr | j d k r | j nA | j d k rV d d | j D } d d j | n | f d d } | S)Nc S s g | ] } t | q Sr' )str)r[ choicer' r' r( r^ 0 s z4HelpFormatter._metavar_formatter..z{%s},c s" t t r S f | Sd S)N)
isinstancetuple)
tuple_size)resultr' r( r 5 s z0HelpFormatter._metavar_formatter..format)r choicesr )r! rx default_metavar choice_strsr r' )r r( r , s z HelpFormatter._metavar_formatterc C s | j | | } | j d k r4 d | d } n | j t k rV d | d } n | j t k rx d | d } n | j t k r d | d } nr | j t k r d } nZ | j t k r d | d } n8 d d
t | j D } d j | | | j } | S) Nz%srT z[%s]z
[%s [%s ...]]r4 z %s [%s ...]z...z%s ...c S s g | ] } d q S)z%sr' )r[ r r' r' r( r^ K s z.HelpFormatter._format_args..r ) r r r
r r r r r r )r! rx r get_metavarr formatsr' r' r( r < s zHelpFormatter._format_argsc C s t t | d | j } x+ t | D] } | | t k r( | | =q( Wx8 t | D]* } t | | d rV | | j | | .)
r varsr> listr hasattrr r r _get_help_string)r! rx paramsr% choices_strr' r' r( r O s
zHelpFormatter._expand_helpc c sF y
| j } Wn t k
r! Yn! X| j | Ed H| j d S)N)_get_subactionsAttributeErrorrU rW )r! rx get_subactionsr' r' r( rv \ s
z'HelpFormatter._iter_indented_subactionsc C s+ | j j d | j } t j | | S)Nr )rM r r _textwrapwrap)r! rj rR r' r' r( r f s zHelpFormatter._split_linesc C s7 | j j d | j } t j | | d | d | S)Nr initial_indentsubsequent_indent)rM r r r fill)r! rj rR r r' r' r( r j s zHelpFormatter._fill_textc C s | j S)N)rt )r! rx r' r' r( r o s z HelpFormatter._get_help_stringc C s
| j j S)N)destupper)r! rx r' r' r( r r s z/HelpFormatter._get_default_metavar_for_optionalc C s | j S)N)r )r! rx r' r' r( r u s z1HelpFormatter._get_default_metavar_for_positional) r r- r. r/ rS rU rW objectrG re rg rh rk rq r~ r rd ra rl r ri rw ru r r r rv r r r r r r' r' r' r( r s< ! \ a /
c @ s" e Z d Z d Z d d Z d S)r zHelp message formatter which retains any formatting in descriptions.
Only the name of this class is considered a public API. All the methods
provided by the class are considered an implementation detail.
c s, d j f d d | j d d D S)Nr_ c 3 s | ] } | Vq d S)Nr' )r[ r )r r' r( s z9RawDescriptionHelpFormatter._fill_text..keependsT)r
splitlines)r! rj rR r r' )r r( r s z&RawDescriptionHelpFormatter._fill_textN)r r- r. r/ r r' r' r' r( r y s c @ s" e Z d Z d Z d d Z d S)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! rj rR r' r' r( r s z!RawTextHelpFormatter._split_linesN)r r- r. r/ r r' r' r' r( r s c @ s" e Z d Z d Z d d Z d S)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 sY | j } d | j k rU | j t k rU t t g } | j sK | j | k rU | d 7} | S)Nz
%(default)z (default: %(default)s))rt r r r
r r r )r! rx rt defaulting_nargsr' r' r( r s
z.ArgumentDefaultsHelpFormatter._get_help_stringN)r r- r. r/ r r' r' r' r( r s c @ s. e Z d Z d Z d d Z d d Z d S)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 j S)N)r r )r! rx r' r' r( r s z:MetavarTypeHelpFormatter._get_default_metavar_for_optionalc C s
| j j S)N)r r )r! rx r' r' r( r s z.r' )r! namesr' )r! r( r ' s zAction._get_kwargsc C s t t d d S)Nz.__call__() not defined)NotImplementedErrorr )r! parserr2 valuesr r' r' r( __call__5 s zAction.__call__)r r- r. r/ rS r r r' r' r' r( r s 1 c sI e Z d Z d d d d d d d d f d d Z d d d Z S) _StoreActionNFc s | d k r t d | d k r@ | t k r@ t d t t t | j d | d | d | d | d | d | d
| d | d | 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 constr r r r r r r r rt r )r= r
superr rS ) r! r r r r r r r r rt r ) __class__r' r( rS ; s z_StoreAction.__init__c C s t | | j | d S)N)r1 r )r! r r2 r r r' r' r( r X s z_StoreAction.__call__)r r- r. rS r r' r' )r r( r 9 s r c s= e Z d Z d d d d f d d Z d d d Z S)_StoreConstActionNFc sA t t | j d | d | d d d | d | d | d | d S) Nr r r r r r r rt )r r rS )r! r r r r r rt r )r r' r( rS ^ s z_StoreConstAction.__init__c C s t | | j | j d S)N)r1 r r )r! r r2 r r r' r' r( r o s z_StoreConstAction.__call__)r r- r. rS r r' r' )r r( r \ s
r c s+ e Z d Z d d d f d d Z S)_StoreTrueActionFNc
s; t t | j d | d | d d d | d | d | d S)Nr r r Tr r rt )r r rS )r! r r r r rt )r r' r( rS u s z_StoreTrueAction.__init__)r r- r. rS r' r' )r r( r s s r c s+ e Z d Z d d d f d d Z S)_StoreFalseActionTFNc
s; t t | j d | d | d d d | d | d | d S)Nr r r Fr r rt )r r rS )r! r r r r rt )r r' r( rS s z_StoreFalseAction.__init__)r r- r. rS r' r' )r r( r s r c sI e Z d Z d d d d d d d d f d d Z d d d Z S)
_AppendActionNFc s | d k r t d | d k r@ | t k r@ t d t t t | j d | d | d | d | d | d | d
| d | d | 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 constr r r r r r r r rt r )r= r
r r rS ) r! r r r r r r r r rt r )r r' r( rS s z_AppendAction.__init__c C sB t j t | | j g } | j | t | | j | d S)N)_copycopyr3 r r r1 )r! r r2 r r r, r' r' r( r s
z_AppendAction.__call__)r r- r. rS r r' r' )r r( r s r c s= e Z d Z d d d d f d d Z d d d Z S)_AppendConstActionNFc sG t t | j d | d | d d d | d | d | d | d | d S)
Nr r r r r r r rt r )r r rS )r! r r r r r rt r )r r' r( rS s z_AppendConstAction.__init__c C sE t j t | | j g } | j | j t | | j | d S)N)r r r3 r r r r1 )r! r r2 r r r, r' r' r( r s z_AppendConstAction.__call__)r r- r. rS r r' r' )r r( r s
r c s: e Z d Z d d d f d d Z d d d Z S) _CountActionNFc
s; t t | j d | d | d d d | d | d | d S)Nr r r r r r rt )r r rS )r! r r r r rt )r r' r( rS s z_CountAction.__init__c C s0 t | | j d d } t | | j | d S)Nr rT )r3 r r1 )r! r r2 r r new_countr' r' r( r s z_CountAction.__call__)r r- r. rS r r' r' )r r( r s r c s: e Z d Z e e d f d d Z d d d Z S) _HelpActionNc s5 t t | j d | d | d | d d d | d S)Nr r r r r rt )r r rS )r! r r r rt )r r' r( rS s z_HelpAction.__init__c C s | j | j d S)N)
print_helpexit)r! r r2 r r r' r' r( r s
z_HelpAction.__call__)r r- r. r rS r r' r' )r r( r s r c s= e Z d Z d e e d f d d Z d d d Z S)_VersionActionNz&show program's version number and exitc s> t t | j d | d | d | d d d | | | _ d S)Nr r r r r rt )r r rS version)r! r r r r rt )r r' r( rS s z_VersionAction.__init__c C s^ | j } | d k r | j } | j } | j | | j | j t j | j d S)N)r _get_formatterrk _print_messagerd _sysstdoutr )r! r r2 r r r rX r' r' r( r s
z_VersionAction.__call__)r r- r. r rS r r' r' )r r( r s
r c sh e Z d Z Gd d d e Z e d d f d d Z d d Z d d Z d d
d Z S) _SubParsersActionc s" e Z d Z f d d Z S)z&_SubParsersAction._ChoicesPseudoActionc s_ | } } | r' | d d j | 7} t t j | } | j d g d | d | d | d S)Nz (%s)z, r r rt r )r r r
_ChoicesPseudoActionrS )r! r% aliasesrt r r sup)r r' r( rS s
z/_SubParsersAction._ChoicesPseudoAction.__init__)r r- r. rS r' r' )r r( r s r Nc
sh | | _ | | _ t j | _ g | _ t t | j d | d | d t d | j d | d | d S)Nr r r r rt r )
_prog_prefix
_parser_class _collections OrderedDict_name_parser_map_choices_actionsr r
rS r )r! r rO parser_classr rt r )r r' r( rS " s z_SubParsersAction.__init__c K s | j d d k r, d | j | f | d <| j d f } d | k r~ | j d } | j | | | } | j j | | j | } | | j | .c S s2 g | ]( \ } } | d k r d | | f q S)Nz%s=%rr' )r[ kwr$ r' r' r( r^ s z%s(%s))r$ r% r& r' r r r )r! r] r args_strr' r' r( r) s
zFileType.__repr__r )r r- r. r/ rS r r) r' r' r' r( r v s c @ s: e Z d Z d Z d d Z d d Z d d Z d S) 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 | | | | q Wd S)N)r1 )r! r r% r' r' r( rS s
zNamespace.__init__c C s) t | t s t St | t | k S)N)r r
NotImplementedr )r! otherr' r' r( __eq__ s zNamespace.__eq__c C s
| | j k S)N)r+ )r! r" r' r' r( __contains__ s zNamespace.__contains__N)r r- r. r/ rS r6 r7 r' r' r' r( r
s c s e Z d Z f d d Z d d Z d d d Z d d Z d
d Z d d
Z d d Z d d Z
d d Z d d Z d d Z
d d Z d d Z d d d Z d d Z d d! Z d" d# Z d$ d% Z S)&_ActionsContainerc sg t t | j | | _ | | _ | | _ | | _ i | _ | j d d t | j d d t | j d d t
| j d d t | j d d t | j d d t
| j d d t | j d d t | j d d t | j d d
t | j d d t | j g | _ i | _ g | _ g | _ i | _ t j d | _ g | _ d S)
Nrx store store_const
store_true store_falser append_constcountrt r parsersz^-\d+$|^-\d*\.\d+$) r r8 rS 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 _defaultsrJ rK _negative_number_matcher _has_negative_number_optionals)r! r@ rB rA rC )r r' r( rS s2
z_ActionsContainer.__init__c C s# | j j | i } | | | .)r rr r r )r! rx conflicting_actionsr conflict_stringr' r' r( _handle_conflict_error s
z(_ActionsContainer._handle_conflict_errorc C sW xP | D]H \ } } | j j | | j j | d | j s | j j | q Wd S)N)r rd rH r rb re )r! rx rs r r' r' r( _handle_conflict_resolve s
z*_ActionsContainer._handle_conflict_resolve)r r- r. rS rE rP rR rS r~ r^ r` rY re rj rT rU rV rF ra ru rv r' r' )r r( r8 s$ 4
/ ( $ r8 c sL e Z d Z d d f d d Z f d d Z f d d Z S)r] Nc s | j } | d | j | d | j | d | j t t | j } | d | | | | _ g | _ | j | _ | j
| _
| j | _ | j | _ | j
| _
| j | _ d S)NrC rB rA r@ )r rC rB rA r r] rS rf r rD rG rH rK rM rJ )r! rb rf r@ r rQ
super_init)r r' r( rS s z_ArgumentGroup.__init__c s, t t | j | } | j j | | S)N)r r] rY r r )r! rx )r r' r( rY s z_ArgumentGroup._add_actionc s* t t | j | | j j | d S)N)r r] re r rd )r! rx )r r' r( re s z _ArgumentGroup._remove_action)r r- r. rS rY re r' r' )r r( r] s r] c s= e Z d Z d f d d Z d d Z d d Z S)r_ Fc s, t t | j | | | _ | | _ d S)N)r r_ rS r
_container)r! rb r )r r' r( rS s z _MutuallyExclusiveGroup.__init__c C sG | j r! t d } t | | j j | } | j j | | S)Nz-mutually exclusive arguments must be optional)r r r= rx rY r r )r! rx r r' r' r( rY s z#_MutuallyExclusiveGroup._add_actionc C s$ | j j | | j j | d S)N)rx re r rd )r! rx r' r' r( re $ s z&_MutuallyExclusiveGroup._remove_action)r r- r. rS rY re r' r' )r r( r_ s r_ c s e Z d Z d Z d d d d g e d d d d d d f d d Z d d Z d
d Z d d
Z d d Z d d Z
d d d d Z d d d d Z d d Z
d d Z d d Z d d Z d d Z d d! Z d" d# Z d$ d% Z d& d' Z d( d) Z d* d+ Z d, d- Z d. d/ Z d0 d1 Z d d2 d3 Z d d4 d5 Z d d6 d7 Z d8 d d9 d: Z d; d< Z S)=r 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 | d | d |
| d k rV t j j t j d } | | _ | | _ | | _
| | _ | | _ | | _
| | _ | j } | t d | _ | t d | _ d | _ d d } | j d
d | d | k rd n | d } | j
rI| j | d | d
d d d d t d t d xM | D]E } | j | y
| j } Wn t k
rYqPX| j j | qPWd S)Nr@ rB rA rC r zpositional argumentszoptional argumentsc S s | S)Nr' )r0 r' r' r( identityb s z)ArgumentParser.__init__..identityr r, hr4 rt rx r z show this help message and exit)r r rS r: pathbasenamer argvrO rm epilogformatter_classfromfile_prefix_charsadd_help allow_abbrevr^ r _positionals
_optionals _subparsersrE r~ r rj rK r rQ )r! rO rm r@ r parentsr rB r rA rC r r superinit add_grouprz default_prefixrY defaults)r r' r( rS < sB
zArgumentParser.__init__c s/ d d d d d d g } f d d | D S) NrO rm r@ r rC r c s% g | ] } | t | f q Sr' )r0 )r[ r% )r! r' r( r^ s z.ArgumentParser._get_kwargs..r' )r! r r' )r! r( r | s zArgumentParser._get_kwargsc K sA | j d k r" | j t d | j d t | d | k sP d | k r t | j d d } t | j d d } | j | | | _ n | j | _ | j d d k r | j } | j
} | j } | j | j
| | d | j j | d <| j | d } | d g | } | j j | | S)
Nz(cannot have multiple subparser argumentsr rf r@ subcommandsrO r_ r? r )r ry r r r r r^ r r r _get_positional_actionsrJ rq rm rd r rV rY ) r! r rf r@ rX r ro
parsers_classrx r' r' r( add_subparsers s$ z ArgumentParser.add_subparsersc C s0 | j r | j j | n | j j | | S)N)r r rY r )r! rx r' r' r( rY s zArgumentParser._add_actionc C s d d | j D S)Nc S s g | ] } | j r | q Sr' )r )r[ rx r' r' r( r^ s z8ArgumentParser._get_optional_actions..)rG )r! r' r' r( _get_optional_actions s z$ArgumentParser._get_optional_actionsc C s d d | j D S)Nc S s g | ] } | j s | q Sr' )r )r[ rx r' r' r( r^ s z:ArgumentParser._get_positional_actions..)rG )r! r' r' r( r s z&ArgumentParser._get_positional_actionsc C sH | j | | \ } } | rD t d } | j | d j | | S)Nzunrecognized arguments: %sr )r r ry r )r! r] r2 r~ r r' r' r(
parse_args s
zArgumentParser.parse_argsc C sk | d k r" t j d d } n t | } | d k rC t } xW | j D]L } | j t k rM t | | j sM | j t k rM t | | j | j qM Wx7 | j
D], } t | | s t | | | j
| q WyX | j | | \ } } t | t r$| j
t | t t | t | | f SWn5 t k
rft j d } | j t | Yn Xd S)NrT )r r~ r r
rG r r r r r1 rK _parse_known_argsr r r0 delattrr exc_infory r )r! r] r2 rx r errr' r' r( r s,
z ArgumentParser.parse_known_argsc s. j d k r j i x~ j D]s } | j } xa t | j D]P \ } } j | g } | j | d | | j | | d d qM Wq. Wi g } t } x t | D] \ } }
|
d k r| j d x_ | D] }
| j d q Wq j |
} | d k r4d } n | | .take_actionc s | } | \ } } } j } g } x| d k rP j | | d S| d k ry| | d } j } | d k r | d | k r | j | g | f | d } | | d } | d d p d }
j } | | k r | | } |
} qvt d } t | | | q| d k rW| d }
| g } | j | | | f Pqt d } t | | | q+ | d } | d } | | | } | | }
| |
} | j | | | f Pq+ W| st x' | D] \ } } } | | | qW|
S)NrT r r z ignored explicit argument %r)_match_argumentr rB rH r r rV ) start_index option_tuplerx r explicit_argmatch_argument
action_tuples arg_countrZ charnew_explicit_arg
optionals_mapr stopr] r selected_patterns)r# arg_strings_patternextrasoption_string_indicesr! r r' r( consume_optional+ sP
z:ArgumentParser._parse_known_args..consume_optionalc s j } | d } | | } xH t | D]7 \ } } | | | } | | 7} | | q8 W t | d d d <| S)N)_match_arguments_partialziprr )r
match_partialselected_pattern
arg_countsrx r r] )r# r r r! r r' r( consume_positionalsx s
z=ArgumentParser._parse_known_args..consume_positionalsr c s" g | ] } | k r | q Sr' r' )r[ r )r r' r( r^ s z4ArgumentParser._parse_known_args..z(the following arguments are required: %sz, c S s+ g | ]! } | j t k r t | q Sr' )rt r r )r[ rx r' r' r( r^ s z#one of the arguments %s is requiredr r ) r _read_args_from_filesrJ r r r r iterr _parse_optionalr r r rB rA rG r r r r r r r r0 r1
_get_valuery r )r! r# r2 ri 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_actionsrx r r r r' ) r r# r r r2 r r r r r! r r r( r s #
!!J
z ArgumentParser._parse_known_argsc C s g } x | D] } | s- | d | j k r= | j | q
y t | d d m } g } xA | j j D]- } x$ | j | D] } | j | q Wqr W| j | } | j | Wd QRXWq
t k
r t j
d } | j t | Yq
Xq
W| S)Nr rT )
r r r readr convert_arg_line_to_argsr r r/ r r ry r )r! r# new_arg_stringsr args_filearg_liner$ r r' r' r( r s
z$ArgumentParser._read_args_from_filesc C s | g S)Nr' )r! r r' r' r( r s z'ArgumentParser.convert_arg_line_to_argsc C s | j | } t j | | } | d k r d t d t t d t t d i } t d d | j | j } | j | j | } t | | t
| j d S)Nzexpected one argumentz expected at most one argumentz expected at least one argumentzexpected %s argumentzexpected %s argumentsrT ) _get_nargs_patternrJ rc r r
r r r r r rr r )r! rx r
nargs_patternrc nargs_errorsr r r' r' r( r s z ArgumentParser._match_argumentc s g } x t t | d d D]w } | d | } d j f d d | D } t j | | } | d k r | j d d | j D Pq W| S)Nr rT r_ c s g | ] } j | q Sr' )r )r[ rx )r! r' r( r^ s z;ArgumentParser._match_arguments_partial..c S s g | ] } t | q Sr' )rr )r[ r0 r' r' r( r^ s r )r rr r rJ rc r ro )r! rn r r r
actions_slicer rc r' )r! r( r s
z'ArgumentParser._match_arguments_partialc
C s | s
d S| d | j k r! d S| | j k rJ | j | } | | d f St | d k r` d Sd | k r | j d d \ } } | | j k r | j | } | | | f S| j rD| j | } t | d k r%d j d d | D } d | d | i } t d } | j | | n t | d k rD| \ } | S| j j
| rc| j scd Sd
| k rsd Sd | d f S) Nr rT =z, c S s g | ] \ } } } | q Sr' r' )r[ rx r r r' r' r( r^ ? s z2ArgumentParser._parse_optional..rk matchesz4ambiguous option: %(option)s could match %(matches)sr ) rB rH rr splitr _get_option_tuplesr r ry rL rc rM )
r! r rx r r
option_tuplesoptionsr] r r r' r' r( r s>
z ArgumentParser._parse_optionalc
C s g } | j } | d | k r | d | k r d | k rV | j d d \ } } n | } d } x6| j D]> } | j | rl | j | } | | | f } | j | ql Wn | d | k r| d | k r| } d } | d d } | d d } x | j D]v } | | k rE| j | } | | | f } | j | q| j | r| j | } | | | f } | j | qWn | j t d | | S)Nr rT r r4 z unexpected option string: %s)rB r rH
startswithr ry r )
r! r r rZ
option_prefixr rx r short_option_prefixshort_explicit_argr' r' r( r Z s8
z!ArgumentParser._get_option_tuplesc C s | j } | d k r d } n | t k r3 d } nk | t k rH d } nV | t k r] d } nA | t k rr d } n, | t k r d } n d d j d | } | j r | j d d
} | j d d
} | S) Nz(-*A-*)z(-*A?-*)z (-*[A-]*)z
(-*A[A-]*)z([-AO]*)z (-*A[-AO]*)z(-*%s-*)z-*r r_ r, ) r r
r r r r r r rm )r! rx r r r' r' r( r s$ z!ArgumentParser._get_nargs_patternc s j t t g k r; y | j d Wn t k
r: Yn X| r j t k r j rf j } n j } t | t
r j | } j | nV| r j t
k r j r j d k r j } n | } j | nt | d k rL j d t g k rL| \ } j | } j | n j t k rz f d d | D } n j t k r f d d | D } j | d n= f d d | D } x | D] } j | qW| S)Nz--rT c s" g | ] } j | q Sr' )r )r[ v)rx r! r' r( r^ s z.ArgumentParser._get_values..c s" g | ] } j | q Sr' )r )r[ r )rx r! r' r( r^ s r c s" g | ] } j | q Sr' )r )r[ r )rx r! r' r( r^ s )r r r rd r= r
r r r r r r _check_valuer rr )r! rx r# r& r r r' )rx r! r( r s>
'
zArgumentParser._get_valuesc C s | j d | j | j } t | sF t d } t | | | y | | } Wn t k
r t | j d t | j } t t j
d } t | | Yng t t f k
rt | j d t | j } d | d | i } t d } t | | | Yn X| S)Nr z%r is not callabler rT r& z!invalid %(type)s value: %(value)r)
rP r rW r r r r0 r r r r rX r= )r! rx r r\ r r r% r] r' r' r( r s
zArgumentParser._get_valuec C sh | j d k rd | | j k rd d | d d j t t | j i } t d } t | | | d S)Nr& r z, z3invalid choice: %(value)r (choose from %(choices)s))r r mapr r r )r! rx r& r] r r' r' r( r s
! zArgumentParser._check_valuec C s2 | j } | j | j | j | j | j S)N)r rq rm rG rJ rd )r! rX r' r' r( format_usage s
zArgumentParser.format_usagec C s | j } | j | j | j | j | j | j xK | j D]@ } | j | j | j | j | j
| j | j qB W| j | j
| j S)N)r rq rm rG rJ rk r@ rI rg rf r r rh r rd )r! rX action_groupr' r' r( rd s
zArgumentParser.format_helpc C s | j d | j S)NrO )r rO )r! r' r' r( r ( s z ArgumentParser._get_formatterc C s/ | d k r t j } | j | j | d S)N)r r r
r )r! filer' r' r( print_usage. s zArgumentParser.print_usagec C s/ | d k r t j } | j | j | d S)N)r r r
rd )r! r r' r' r( r 3 s zArgumentParser.print_helpc C s, | r( | d k r t j } | j | d S)N)r stderrwrite)r! r r r' r' r( r
8 s z ArgumentParser._print_messager c C s* | r | j | t j t j | d S)N)r
r r r )r! statusr r' r' r( r A s zArgumentParser.exitc C sC | j t j d | j d | i } | j d t d | d S)zerror(message: string)
Prints a usage message incorporating the message to stderr and
exits.
If you override this in a subclass, it should not return -- it
should either exit or raise an exception.
rO r r4 z %(prog)s: error: %(message)s
N)r r r rO r r )r! r r] r' r' r( ry F s zArgumentParser.error) r r- r. r/ r rS r r rY r r r r r r r r r r r r r r r r rd r r r r
r ry r' r' )r r( r ) sN 4 # ; , , 4 )6r/ __version____all__ collectionsr r r osr: rerJ sysr textwrapr r r r r r
r r r r r r r r3 r r r r r r Exceptionr r r r r r r r r r r r r
r r
r8 r] r_ r r' r' r' r( > sz
[#%`6 4"