3
\a � @ s0 d Z dZdddddddd d
d d d
dddddgZddlZddlZddlZddl Z
ddl Z ddl
ZddlmZmZ dZdZdZdZdZdZd ZG d d � d e�Zd d � ZG d!d� de�Z G d"d� de �Z G d#d � d e �Z G d$d� de �Z G d%d
� d
e �Z d&d'� Z!G d(d� de"�Z#G d)d� de"�Z$G d*d � d e�Z%G d+d,� d,e%�Z&G d-d.� d.e%�Z'G d/d0� d0e'�Z(G d1d2� d2e'�Z)G d3d4� d4e%�Z*G d5d6� d6e%�Z+G d7d8� d8e%�Z,G d9d:� d:e%�Z-G d;d<� d� d>e%�Z/G d?d� de�Z0G d@d � d e�Z1G dAdB� dBe�Z2G dCdD� dDe2�Z3G dEdF� dFe3�Z4G dGd� dee2�Z5dS )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.1�ArgumentParser�
ArgumentError�ArgumentTypeError�FileType�
HelpFormatter� ArgumentDefaultsHelpFormatter�RawDescriptionHelpFormatter�RawTextHelpFormatter�MetavarTypeHelpFormatter� Namespace�Action� ONE_OR_MORE�OPTIONAL�PARSER� REMAINDER�SUPPRESS� ZERO_OR_MORE� N)�gettext�ngettextz ==SUPPRESS==�?�*�+zA...z...Z_unrecognized_argsc @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) �_AttributeHoldera Abstract base class that provides __repr__.
The __repr__ method returns a string in the format::
ClassName(attr=name, attr=name, ...)
The attributes are determined either by a class-level attribute,
'_kwarg_names', or by inspecting the instance __dict__.
c C s� t | �j}g }i }x | j� D ]}|jt|�� q W x8| j� D ],\}}|j� r`|jd||f � q<|||< q� s z6HelpFormatter._Section.format_help..� z%*s%s:
�
) rU rT rQ � _join_partsr+ rS rV r rB )r! r Z item_helpZcurrent_indentrV r& r& r' � format_help� s
z"HelpFormatter._Section.format_help)N)r r, r- rO r^ r& r& r& r' rE � s
rE c C s | j jj||f� d S )N)rG r+ r )r! rX rY r& r& r' � _add_item� s zHelpFormatter._add_itemc C s0 | j � | j| | j|�}| j|jg � || _d S )N)rQ rE rG r_ r^ )r! rV Zsectionr& r& r' �
start_section� s zHelpFormatter.start_sectionc C s | j j| _ | j� d S )N)rG rU rS )r! r& r& r' � end_section� s
zHelpFormatter.end_sectionc C s$ |t k r |d k r | j| j|g� d S )N)r r_ � _format_text)r! �textr& r& r' �add_text� s zHelpFormatter.add_textc C s& |t k r"||||f}| j| j|� d S )N)r r_ �
_format_usage)r! �usage�actions�groups�prefixrY r& r& r' � add_usage� s zHelpFormatter.add_usagec C sz |j tk rv| j}||�g}x | j|�D ]}|j||�� q&W tdd� |D ��}|| j }t| j|�| _| j| j |g� d S )Nc S s g | ] }t |��qS r& )�len)rW �sr& r& r' rZ
s z.HelpFormatter.add_argument..)
�helpr �_format_action_invocation�_iter_indented_subactionsr r@ rB rD r_ �_format_action)r! �actionZget_invocationZ invocations� subactionZinvocation_lengthZ
action_lengthr& r& r' � add_argument s
zHelpFormatter.add_argumentc C s x|D ]}| j |� qW d S )N)rs )r! rg rq r& r& r' �
add_arguments s
zHelpFormatter.add_argumentsc C s. | j j� }|r*| jjd|�}|jd�d }|S )Nz
r\ )rF r^ rL �sub�strip)r! rm r& r& r' r^ s
zHelpFormatter.format_helpc C s dj dd� |D ��S )Nr[ c S s g | ]}|r|t k r|�qS r& )r )rW �partr& r& r' rZ ! s z-HelpFormatter._join_parts..)r )r! Z part_stringsr& r& r' r] s
zHelpFormatter._join_partsc s< |d krt d�}|d k r,|t| jd� }�n|d krN| rNdt| jd� }�n�|d k�r0dt| jd� }g }g }x(|D ] }|jr�|j|� qv|j|� qvW | j} | || |�}
djdd� ||
gD ��}| j| j � t |�t |� � k�r0d} | ||�} | ||�}
t
j | | �}t
j | |
�}dj|�| k�s,t �dj|�|
k�s@t �d� fdd � }t |�t |� d
� k�r�dt |�t |� d }|�r�||g| ||�}|j
|||�� n |�r�||g| ||�}n|g}nZdt |� }|| }|||�}t |�d k�r g }|j
|||�� |j
|||�� |g| }d j|�}d
||f S )Nzusage: )rM z%(prog)s� c S s g | ] }|r|�qS r& r& )rW rl r& r& r' rZ A s z/HelpFormatter._format_usage..z%\(.*?\)+(?=\s|$)|\[.*?\]+(?=\s|$)|\S+c s� g }g }|d k r t |�d }n t |�d }xb| D ]Z}|d t |� � krp|rp|j|dj|� � g }t |�d }|j|� |t |�d 7 }q0W |r�|j|dj|� � |d k r�|d t |�d � |d< |S )NrP rx r )rk r r )�parts�indentri �lines�lineZline_lenrw )�
text_widthr& r' � get_linesU s"
z.HelpFormatter._format_usage..get_linesg �?rP r\ z%s%s
)N)�_�dictr< �option_stringsr �_format_actions_usager rA rB rk rH �findallrR �extend)r! rf rg rh ri rM Z optionals� positionalsrq �formatZ action_usageZ part_regexpZ opt_usageZ pos_usageZ opt_partsZ pos_partsr~ rz r{ ry r& )r} r' re % sZ
zHelpFormatter._format_usagec
C s� t � }i }x�|D ]�}y|j|jd �}W n tk
r> wY qX |t|j� }|||� |jkrx|jD ]}|j|� qhW |js�||kr�|| d7 < nd||< d||< n*||kr�|| d7 < nd||< d||< x t|d |�D ] } d || < q�W qW g }
�x2t|�D �]$\} }|j t
k�rj|
j d � |j | �d k�rF|j
| � n"|j | d �d k�r.|j
| d � n�|j�s�| j|�} | j|| �} ||k�r�| d dk�r�| d dk�r�| dd� } |
j | � nh|jd }
|jdk�r�d
|
} n"| j|�} | j|| �}d |
|f } |j �r$||k�r$d | } |
j | � �q
W x(t|d
d�D ]} || g|
| | �< �qBW djdd� |
D ��}d}d}tjd| d|�}tjd| d|�}tjd||f d|�}tjdd|�}|j� }|S ) Nr z [�[�]z (�(�)rP �|z%sz%s %sz[%s]T)�reverserx c S s g | ]}|d k r|�qS )Nr& )rW �itemr& r& r' rZ � s z7HelpFormatter._format_actions_usage..z[\[(]z[\])]z(%s) z\1z (%s)z%s *%sr[ z \(([^|]*)\)�����r� )�set�index�_group_actionsr; rk �add�required�range� enumeraterm r r �get�popr� �#_get_default_metavar_for_positional� _format_args�nargs�!_get_default_metavar_for_optionalr) r rH ru rv )r! rg rh �
group_actionsZinserts�group�start�endrq �iry �defaultrw �
option_string� args_stringrc �open�closer& r& r' r� � sr
z#HelpFormatter._format_actions_usagec C sF d|kr|t | jd� }t| j| j d�}d| j }| j|||�d S )Nz%(prog))rM � rx z
)r� r< r@ rA rB �
_fill_text)r! rc r} rz r& r& r' rb � s
zHelpFormatter._format_textc
C sB t | jd | j�}t| j| d�}|| j d }| j|�}|jsV| jd|f}d| }n@t|�|kr~| jd||f}d| }d}n| jd|f}d| }|}|g}|jr�| j |�} | j
| |�}
|j d|d|
d f � x@|
dd � D ]} |j d|d| f � q�W n|j d��s|j d� x$| j
|�D ]} |j | j| �� �q W | j|�S ) Nr3 r� r[ z%*s%s
z %*s%-*s r rP r\ )r? rD r> r@ rA rB rn rm rk � _expand_help� _split_linesr �endswithro rp r] )
r! rq Z
help_positionZ
help_widthZ action_widthZ
action_header�tupZ indent_firstry Z help_textZ
help_linesr| rr r& r& r' rp � s6
z HelpFormatter._format_actionc C s� |j s&| j|�}| j||�d�\}|S g }|jdkrB|j|j � n8| j|�}| j||�}x |j D ]}|jd||f � q`W dj|�S d S )NrP r z%s %sz, ) r� r� �_metavar_formatterr� r� r� r� r r )r! rq r� �metavarry r� r� r& r& r' rn s
z'HelpFormatter._format_action_invocationc sP |j d k r|j � n.|jd k r.z{%s}�,c s t � t�r� S � f| S d S )N)�
isinstance�tuple)Z
tuple_size)�resultr& r' r� = s
z0HelpFormatter._metavar_formatter..format)r� �choicesr )r! rq �default_metavarZ choice_strsr� r& )r� r' r� 4 s
z HelpFormatter._metavar_formatterc C s� | j ||�}|jd kr$d|d� }n�|jtkr.rx ) r� r� r
r r r r r� r )r! rq r� Z get_metavarr� Zformatsr& r& r' r� D s
zHelpFormatter._format_argsc C s� t t|�| jd�}x"t|�D ]}|| tkr ||= q W x,t|�D ] }t|| d�r@|| j||< q@W |jd�d k r�djdd� |d D ��}||d< | j |�| S )N)rM r r� z, c S s g | ] }t |��qS r& )r� )rW �cr& r& r' rZ ` s z.HelpFormatter._expand_help..)
r� �varsr< �listr �hasattrr r� r �_get_help_string)r! rq Zparamsr$ Z choices_strr& r& r' r� W s
zHelpFormatter._expand_helpc c s@ y
|j }W n tk
r Y n X | j� |� E d H | j� d S )N)�_get_subactions�AttributeErrorrQ rS )r! rq Zget_subactionsr& r& r' ro d s
z'HelpFormatter._iter_indented_subactionsc C s | j jd|�j� }tj||�S )Nrx )rK ru rv � _textwrapZwrap)r! rc rN r& r& r' r� n s zHelpFormatter._split_linesc C s$ | j jd|�j� }tj||||d�S )Nrx )Zinitial_indentZsubsequent_indent)rK ru rv r� Zfill)r! rc rN rz r& r& r' r� r s
zHelpFormatter._fill_textc C s |j S )N)rm )r! rq r& r& r' r� w s z HelpFormatter._get_help_stringc C s
|j j� S )N)�dest�upper)r! rq r& r& r' r� z s z/HelpFormatter._get_default_metavar_for_optionalc C s |j S )N)r� )r! rq r& r& r' r� } s z1HelpFormatter._get_default_metavar_for_positional)r3 r4 N)N) r r, r- r. rO rQ rS �objectrE r_ r` ra rd rj rs rt r^ r] re r� rb rp rn r� r� r� ro r� r� r� r� r� r& r& r& r' r � s<
`a/
c @ s e Zd ZdZdd� ZdS )r z�Help message formatter which retains any formatting in descriptions.
Only the name of this class is considered a public API. All the methods
provided by the class are considered an implementation detail.
c s dj � fdd�|jdd�D ��S )Nr[ c 3 s | ]}� | V qd S )Nr& )rW r| )rz r& r' � � s z9RawDescriptionHelpFormatter._fill_text..T)�keepends)r �
splitlines)r! rc rN rz r& )rz r' r� � s z&RawDescriptionHelpFormatter._fill_textN)r r, r- r. r� r& r& r& r' r � s c @ s e Zd ZdZdd� ZdS )r z�Help message formatter which retains formatting of all help text.
Only the name of this class is considered a public API. All the methods
provided by the class are considered an implementation detail.
c C s |j � S )N)r� )r! rc rN r& r& r' r� � s z!RawTextHelpFormatter._split_linesN)r r, r- r. r� r& r& r& r' r � s c @ s e Zd ZdZdd� ZdS )r z�Help message formatter which adds default values to argument help.
Only the name of this class is considered a public API. All the methods
provided by the class are considered an implementation detail.
c C s> |j }d|j kr:|jtk r:ttg}|js2|j|kr:|d7 }|S )Nz
%(default)z (default: %(default)s))rm r� r r
r r� r� )r! rq rm Zdefaulting_nargsr& r& r' r� � s
z.ArgumentDefaultsHelpFormatter._get_help_stringN)r r, r- r. r� r& r& r& r' r � s c @ s e Zd ZdZdd� Zdd� ZdS )r a Help message formatter which uses the argument 'type' as the default
metavar value (instead of the argument 'dest')
Only the name of this class is considered a public API. All the methods
provided by the class are considered an implementation detail.
c C s |j jS )N)r r )r! rq r& r& r' r� � s z:MetavarTypeHelpFormatter._get_default_metavar_for_optionalc C s |j jS )N)r r )r! rq r& r& r' r� � s z.r& )r! �namesr& )r! r' r / s zAction._get_kwargsc C s t td���d S )Nz.__call__() not defined)�NotImplementedErrorr )r! �parserr1 �valuesr� r& r& r' �__call__= s zAction.__call__)NNNNNFNN)N)r r, r- r. rO r r� r& r& r& r' r � s 1
c s( e Zd Zd� fdd� Zddd�Z� ZS ) � _StoreActionNFc sT |dkrt d��|d k r,|tkr,t dt ��tt| �j||||||||| |
d�
d S )Nr z�nargs for store actions must be > 0; if you have nothing to store, actions such as store true or store const may be more appropriatez nargs must be %r to supply const)
r� r� r� r� r� r r� r� rm r� )r; r
�superr� rO ) r! r� r� r� r� r� r r� r� rm r� )� __class__r& r' rO C s
z_StoreAction.__init__c C s t || j|� d S )N)r0 r� )r! r� r1 r� r� r& r& r' r� ` s z_StoreAction.__call__)NNNNNFNN)N)r r, r- rO r� �
__classcell__r& r& )r� r' r� A s r� c s( e Zd Zd� fdd� Zddd�Z� ZS ) �_StoreConstActionNFc s" t t| �j||d||||d� d S )Nr )r� r� r� r� r� r� rm )r� r� rO )r! r� r� r� r� r� rm r� )r� r& r' rO f s
z_StoreConstAction.__init__c C s t || j| j� d S )N)r0 r� r� )r! r� r1 r� r� r& r& r' r� w s z_StoreConstAction.__call__)NFNN)N)r r, r- rO r� r� r& r& )r� r' r� d s
r� c s e Zd Zd� fdd� Z� ZS )�_StoreTrueActionFNc s t t| �j||d|||d� d S )NT)r� r� r� r� r� rm )r� r� rO )r! r� r� r� r� rm )r� r& r' rO } s
z_StoreTrueAction.__init__)FFN)r r, r- rO r� r& r& )r� r' r� { s r� c s e Zd Zd� fdd� Z� ZS )�_StoreFalseActionTFNc s t t| �j||d|||d� d S )NF)r� r� r� r� r� rm )r� r� rO )r! r� r� r� r� rm )r� r& r' rO � s
z_StoreFalseAction.__init__)TFN)r r, r- rO r� r& r& )r� r' r� � s r� c s( e Zd Zd� fdd� Zddd�Z� ZS ) �
_AppendActionNFc sT |dkrt d��|d k r,|tkr,t dt ��tt| �j||||||||| |
d�
d S )Nr z�nargs for append actions must be > 0; if arg strings are not supplying the value to append, the append const action may be more appropriatez nargs must be %r to supply const)
r� r� r� r� r� r r� r� rm r� )r; r
r� r� rO ) r! r� r� r� r� r� r r� r� rm r� )r� r& r' rO � s
z_AppendAction.__init__c C s0 t jt|| jg ��}|j|� t|| j|� d S )N)�_copy�copyr2 r� r r0 )r! r� r1 r� r� r+ r& r& r' r� � s
z_AppendAction.__call__)NNNNNFNN)N)r r, r- rO r� r� r& r& )r� r' r� � s r� c s( e Zd Zd� fdd� Zddd�Z� ZS ) �_AppendConstActionNFc
s$ t t| �j||d|||||d� d S )Nr )r� r� r� r� r� r� rm r� )r� r� rO )r! r� r� r� r� r� rm r� )r� r& r' rO � s
z_AppendConstAction.__init__c C s2 t jt|| jg ��}|j| j� t|| j|� d S )N)r� r� r2 r� r r� r0 )r! r� r1 r� r� r+ r& r& r' r� � s z_AppendConstAction.__call__)NFNN)N)r r, r- rO r� r� r& r& )r� r' r� � s
r� c s( e Zd Zd� fdd� Zddd�Z� ZS ) � _CountActionNFc s t t| �j||d|||d� d S )Nr )r� r� r� r� r� rm )r� r� rO )r! r� r� r� r� rm )r� r& r' rO � s
z_CountAction.__init__c C s$ t || jd�d }t|| j|� d S )Nr rP )r2 r� r0 )r! r� r1 r� r� Z new_countr& r& r' r� � s z_CountAction.__call__)NFN)N)r r, r- rO r� r� r& r& )r� r' r� � s r� c s. e Zd Zeedf� fdd� Zddd�Z� ZS )� _HelpActionNc s t t| �j|||d|d� d S )Nr )r� r� r� r� rm )r� r� rO )r! r� r� r� rm )r� r& r' rO � s
z_HelpAction.__init__c C s |j � |j� d S )N)�
print_help�exit)r! r� r1 r� r� r& r& r' r� � s z_HelpAction.__call__)N)r r, r- r rO r� r� r& r& )r� r' r� � s r� c s0 e Zd Zdeedf� fdd� Zddd�Z� ZS )�_VersionActionNz&show program's version number and exitc s$ t t| �j|||d|d� || _d S )Nr )r� r� r� r� rm )r� r� rO �version)r! r� r� r� r� rm )r� r& r' rO s
z_VersionAction.__init__c C sD | j }|d kr|j }|j� }|j|� |j|j� tj� |j� d S )N)r� �_get_formatterrd �_print_messager^ �_sys�stdoutr� )r! r� r1 r� r� r� rT r& r& r' r� s
z_VersionAction.__call__)N)r r, r- r rO r� r� r& r& )r� r' r� s
r� c sN e Zd ZG dd� de�Zeddf� fdd� Zdd� Zdd � Zd d
d �Z � Z
S )
�_SubParsersActionc s e Zd Z� fdd�Z� ZS )z&_SubParsersAction._ChoicesPseudoActionc s@ | }}|r |ddj |� 7 }ttj| �}|jg |||d� d S )Nz (%s)z, )r� r� rm r� )r r� r� �_ChoicesPseudoActionrO )r! r$ �aliasesrm r� r� Zsup)r� r& r' rO " s
z/_SubParsersAction._ChoicesPseudoAction.__init__)r r, r- rO r� r& r& )r� r' r� s r� Nc s> || _ || _tj� | _g | _tt| �j||t | j||d� d S )N)r� r� r� r� rm r� )
� _prog_prefix�
_parser_class� _collections� OrderedDict�_name_parser_map�_choices_actionsr� r� rO r )r! r� rM � parser_classr� rm r� )r� r& r' rO * s
z_SubParsersAction.__init__c K s� |j d�d kr d| j|f |d< |jdf �}d|krX|jd�}| j|||�}| jj|� | jf |�}|| j|< x|D ]}|| j|< qtW |S )NrM z%s %sr� rm )r� r� r� r� r� r r� r� )r! r$ �kwargsr� rm Z
choice_actionr� �aliasr& r& r' �
add_parser? s
z _SubParsersAction.add_parserc C s | j S )N)r� )r! r& r& r' r� V s z!_SubParsersAction._get_subactionsc
C s� |d }|dd � }| j tk r,t|| j |� y| j| }W n< tk
rv |dj| j�d�}td�| }t| |��Y nX |j|d �\} }x$t | �j
� D ]\}
} t||
| � q�W |r�t |�j t g � t
|t �j|� d S )Nr rP z, )� parser_namer� z5unknown parser %(parser_name)r (choices: %(choices)s))r� r r0 r� r: r r r �parse_known_argsr� r+ �
setdefault�_UNRECOGNIZED_ARGS_ATTRr/ r� ) r! r� r1 r� r� r� r" rY �msgZ subnamespace�keyr% r& r& r' r� Y s"
z_SubParsersAction.__call__)N) r r, r- r r� r rO r� r� r� r� r& r& )r� r' r� s r� c @ s* e Zd ZdZd dd�Zdd� Zd d
� ZdS )
r a� Factory for creating file object types
Instances of FileType are typically passed as type= arguments to the
ArgumentParser add_argument() method.
Keyword Arguments:
- mode -- A string indicating how the file is to be opened. Accepts the
same values as the builtin open() function.
- bufsize -- The file's desired buffer size. Accepts the same values as
the builtin open() function.
- encoding -- The file's encoding. Accepts the same values as the
builtin open() function.
- errors -- A string indicating how encoding and decoding errors are to
be handled. Accepts the same value as the builtin open() function.
�rrP Nc C s || _ || _|| _|| _d S )N)�_mode�_bufsize� _encoding�_errors)r! �mode�bufsize�encoding�errorsr& r& r' rO � s zFileType.__init__c C s� |dkr>d| j krtjS d| j kr(tjS td�| j }t|��yt|| j | j| j| j �S t
k
r� } z td�}t |||f ��W Y d d }~X nX d S )N�-r� �wzargument "-" with mode %rzcan't open '%s': %s) r� r� �stdinr� r r; r� r� r� r� �OSErrorr )r! �stringr� �er� r& r& r' r� � s
zFileType.__call__c C sT | j | jf}d| jfd| jfg}djdd� |D �dd� |D � �}dt| �j|f S )Nr� r� z, c S s g | ]}|dkrt |��qS )rP r� )r )rW r# r& r& r' rZ � s z%FileType.__repr__..c S s$ g | ] \}}|d k rd||f �qS )Nz%s=%rr& )rW �kwr# r& r& r' rZ � s z%s(%s))r� r� r� r� r r r )r! rY r� Zargs_strr& r& r' r( � s
zFileType.__repr__r� )r� r� NN)r r, r- r. rO r� r( r& r& r& r' r ~ s
c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) r
z�Simple object for storing attributes.
Implements equality by attribute names and values, and provides a simple
string representation.
c K s" x |D ]}t | ||| � qW d S )N)r0 )r! r� r$ r& r& r' rO � s
zNamespace.__init__c C s t |t�stS t| �t|�kS )N)r� r
�NotImplementedr� )r! �otherr& r& r' �__eq__� s
zNamespace.__eq__c C s
|| j kS )N)r* )r! r� r& r& r' � __contains__� s zNamespace.__contains__N)r r, r- r. rO r r
r& r& r& r' r
� s c s� e Zd Z� fdd�Zdd� Zd&dd�Zdd � Zd
d � Zd d
� Zdd� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zd'd d �Zd d � Zd d!� Zd"d#� Zd$d%� Z� ZS )(�_ActionsContainerc s t t| �j� || _|| _|| _|| _i | _| jdd t � | jddt � | jddt
� | jddt � | jddt � | jddt
� | jddt� | jddt� | jdd t� | jdd
t� | jdd t� | j� g | _i | _g | _g | _i | _tjd �| _g | _ d S )
Nrq ZstoreZ store_const�
store_trueZ store_falser Z append_const�countrm r� �parsersz^-\d+$|^-\d*\.\d+$) r� r rO � description�argument_default� prefix_chars�conflict_handler� _registries�registerr� r� r� r� r� r� r� r� r� r� � _get_handler�_actions�_option_string_actions�_action_groups�_mutually_exclusive_groups� _defaultsrH rI �_negative_number_matcher� _has_negative_number_optionals)r! r r r r )r� r& r' rO � s2 z_ActionsContainer.__init__c C s | j j|i �}|||< d S )N)r r� )r! �
registry_namer% r� �registryr& r& r' r � s z_ActionsContainer.registerNc C s | j | j||�S )N)r r� )r! r r% r� r& r& r' �
_registry_get s z _ActionsContainer._registry_getc K s6 | j j|� x$| jD ]}|j|kr||j |_qW d S )N)r �updater r� r� )r! r� rq r& r& r' � set_defaults s
z _ActionsContainer.set_defaultsc C s8 x(| j D ] }|j|kr|jd k r|jS qW | jj|d �S )N)r r� r� r r� )r! r� rq r& r& r' � get_default s
z _ActionsContainer.get_defaultc O s0 | j }| s(t|�dkrJ|d d |krJ|r| js>| jjd� q>W |S )NT) �_check_conflictr r � containerr� r r �matchr )r! rq r� r& r& r' r( T s
z _ActionsContainer._add_actionc C s | j j|� d S )N)r �remove)r! rq r& r& r' �_remove_actioni s z _ActionsContainer._remove_actionc C s� i }x8| j D ].}|j|kr0td�}t||j ��|||j< q W i }xR|j D ]H}|j|krt| j|j|j|jd�||j< x |jD ]}||j ||< q|W qJW x4|jD ]*}| j |j
d�}x|jD ] }|||< q�W q�W x |j D ]}|j || �j
|� q�W d S )Nz.cannot merge actions - two groups are named %r)�titler r )r� )r r4 r r; r, r r r� r r. r� r r� r( )r! r0 Ztitle_group_mapr� r� Z group_maprq � mutex_groupr& r& r' �_add_container_actionsl s,
z(_ActionsContainer._add_container_actionsc K s^ d|krt d�}t|��|jd�ttgkr2d|d< |jd�tkrPd|krPd|d< t||g d�S )Nr� z1'required' is an invalid argument for positionalsr� Tr� )r� r� )r r' r� r
r r� )r! r� r� r� r& r& r' r# � s z(_ActionsContainer._get_positional_kwargsc O s� g }g }xv|D ]n}|d | j kr@|| j d�}td�}t|| ��|j|� |d | j krt|�dkr|d | j kr|j|� qW |jdd �}|d kr�|r�|d }n|d }|j| j �}|s�td�}t|| ��|jdd�}t|||d �S )
Nr )�optionr zNinvalid option string %(option)r: must start with a character %(prefix_chars)rrP r� z%dest= is required for options like %rr r )r� r� ) r r r; r rk r� �lstrip�replacer� ) r! rY r� r� Zlong_option_stringsr� r� r� Zdest_option_stringr& r& r' r$ � s0
z&_ActionsContainer._get_optional_kwargsc C s |j d|�}| jd||�S )Nrq )r� r )r! r� r� rq r& r& r' r% � s z#_ActionsContainer._pop_action_classc C sD d| j }y
t| |�S tk
r> td�}t|| j ��Y nX d S )Nz_handle_conflict_%sz%invalid conflict_resolution value: %r)r r/ r� r r; )r! Zhandler_func_namer� r& r& r' r � s
z _ActionsContainer._get_handlerc C sP g }x0|j D ]&}|| jkr | j| }|j||f� q W |rL| j� }|||� d S )N)r� r r r )r! rq Zconfl_optionalsr� Zconfl_optionalr r& r& r' r/ � s
z!_ActionsContainer._check_conflictc C s6 t ddt|��}djdd� |D ��}t||| ��d S )Nz conflicting option string: %sz conflicting option strings: %sz, c S s g | ] \}}|�qS r& r& )rW r� rq r& r& r' rZ � s z<_ActionsContainer._handle_conflict_error..)r rk r r )r! rq �conflicting_actionsr� Zconflict_stringr& r& r' �_handle_conflict_error� s
z(_ActionsContainer._handle_conflict_errorc C sB x<|D ]4\}}|j j|� | jj|d � |j s|jj|� qW d S )N)r� r2 r r� r0 r3 )r! rq r: r� r& r& r' �_handle_conflict_resolve� s
z*_ActionsContainer._handle_conflict_resolve)N)N)r r, r- rO r r r! r" rs r, r. r( r3 r6 r# r$ r% r r/ r; r< r� r& r& )r� r' r � s$ 4
/($
r c s6 e Zd Zd� fdd� Z� fdd�Z� fdd�Z� ZS ) r+ Nc s� |j }|d|j� |d|j� |d|j� tt| �j}|f d|i|�� || _g | _|j | _ |j
| _
|j | _ |j | _ |j
| _
|j| _d S )Nr r r r )r� r r r r� r+ rO r4 r� r r r r r r )r! r0 r4 r r� r Z
super_init)r� r& r' rO � s z_ArgumentGroup.__init__c s t t| �j|�}| jj|� |S )N)r� r+ r( r� r )r! rq )r� r& r' r( s z_ArgumentGroup._add_actionc s t t| �j|� | jj|� d S )N)r� r+ r3 r� r2 )r! rq )r� r& r' r3 s z _ArgumentGroup._remove_action)NN)r r, r- rO r( r3 r� r& r& )r� r' r+ � s r+ c s. e Zd Zd� fdd� Zdd� Zdd� Z� ZS ) r- Fc s t t| �j|� || _|| _d S )N)r� r- rO r� �
_container)r! r0 r� )r� r& r' rO s z _MutuallyExclusiveGroup.__init__c C s2 |j rtd�}t|��| jj|�}| jj|� |S )Nz-mutually exclusive arguments must be optional)r� r r; r= r( r� r )r! rq r� r& r& r' r( $ s z#_MutuallyExclusiveGroup._add_actionc C s | j j|� | jj|� d S )N)r= r3 r� r2 )r! rq r& r& r' r3 , s z&_MutuallyExclusiveGroup._remove_action)F)r r, r- rO r( r3 r� r& r& )r� r' r- s r- c s e Zd ZdZddddg eddddddf � fdd� Zdd � Zd
d � Zd d
� Zdd� Z dd� Z
d=dd�Z d>dd�Z dd� Z
dd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Zd,d-� Zd.d/� Zd0d1� Zd?d2d3�Zd@d4d5�Z dAd6d7�Z dBd9d:�Z d;d<� Z � Z S )Cr a� Object for parsing command line strings into Python objects.
Keyword Arguments:
- prog -- The name of the program (default: sys.argv[0])
- usage -- A usage message (default: auto-generated from arguments)
- description -- A description of what the program does
- epilog -- Text following the argument descriptions
- parents -- Parsers whose arguments should be copied into this one
- formatter_class -- HelpFormatter class for printing help messages
- prefix_chars -- Characters that prefix optional arguments
- fromfile_prefix_chars -- Characters that prefix files containing
additional arguments
- argument_default -- The default value for all arguments
- conflict_handler -- String indicating how to handle conflicts
- add_help -- Add a -h/-help option
- allow_abbrev -- Allow long options to be abbreviated unambiguously
Nr �errorTc
s& t t| �j}
|
||| |
d� |d kr6tjjtjd �}|| _|| _ || _
|| _ || _ | | _
| | _| j}|td��| _|td��| _d | _dd� }| jdd |� d|kr�dn|d }| j
r�| j|d |d
d d ttd �d
� xD|D ]<}| j|� y
|j}W n tk
�r Y q�X | jj|� q�W d S )N)r r r r r zpositional argumentszoptional argumentsc S s | S )Nr& )r r& r& r' �identityj s z)ArgumentParser.__init__..identityr r �hr3 rm z show this help message and exit)rq r� rm )r� r rO r8 �path�basenamer� �argvrM rf �epilog�formatter_class�fromfile_prefix_chars�add_help� allow_abbrevr, r � _positionals�
_optionals� _subparsersr rs r r6 r r� r )r! rM rf r rD �parentsrE r rF r r rG rH Z superinitZ add_groupr? Zdefault_prefixrU Zdefaults)r� r& r' rO D sB
zArgumentParser.__init__c s" ddddddg}� fdd�|D �S ) NrM rf r rE r rG c s g | ]}|t � |�f�qS r& )r/ )rW r$ )r! r& r' rZ � s z.ArgumentParser._get_kwargs..r& )r! r� r& )r! r' r � s zArgumentParser._get_kwargsc K s� | j d k r| jtd�� |jdt| �� d|ks8d|krht|jdd��}t|jdd ��}| j||�| _ n| j| _ |jd�d kr�| j � }| j
� }| j }|j | j
||d� |j� j� |d< | j|d�}|f d g i|��}| j j|� |S )
Nz(cannot have multiple subparser argumentsr� r4 r Z subcommandsrM r[ r r� )rK r> r r� r r� r, rI r� r� �_get_positional_actionsr rj rf r^ rv r% r( ) r! r� r4 r rT r� rh Z
parsers_classrq r& r& r' �add_subparsers� s$
z ArgumentParser.add_subparsersc C s$ |j r| jj|� n | jj|� |S )N)r� rJ r( rI )r! rq r& r& r' r( � s zArgumentParser._add_actionc C s dd� | j D �S )Nc S s g | ]}|j r|�qS r& )r� )rW rq r& r& r' rZ � s z8ArgumentParser._get_optional_actions..)r )r! r& r& r' �_get_optional_actions� s z$ArgumentParser._get_optional_actionsc C s dd� | j D �S )Nc S s g | ]}|j s|�qS r& )r� )rW rq r& r& r' rZ � s z:ArgumentParser._get_positional_actions..)r )r! r& r& r' rM � s z&ArgumentParser._get_positional_actionsc C s4 | j ||�\}}|r0td�}| j|dj|� � |S )Nzunrecognized arguments: %srx )r� r r> r )r! rY r1 rC r� r& r& r' �
parse_args� s
zArgumentParser.parse_argsc C s |d krt jdd � }nt|�}|d kr.t� }x>| jD ]4}|jtk r6t||j�s6|jtk r6t ||j|j� q6W x*| j
D ] }t||�svt ||| j
| � qvW y<| j ||�\}}t|t �r�|j
t|t �� t|t � ||fS tk
�r t j� d }| jt|�� Y nX d S )NrP )r� rC r� r
r r� r r� r� r0 r �_parse_known_argsr� r� r/ �delattrr �exc_infor> r� )r! rY r1 rq r� �errr& r& r' r� � s,
z ArgumentParser.parse_known_argsc s" � j d k r� j���i � x`� jD ]V}|j}xJt|j�D ]<\}}� j|g �}|j|d |� � |j||d d � � q6W q W i �g }t��} xnt| �D ]b\}}
|
dkr�|jd� xF| D ]}
|jd� q�W q�� j |
�} | d kr�d} n | �|< d} |j| � q�W dj
|��t � �t � �d� ���� fdd� � ����� � fd d
�}
� j � ����� � fd d �}g �d
�
��rpt
��}nd}x|�
|k�r�t�
fdd��D ��}�
|k�r�|�
�}|�
k�r�|�
�qvn|�
�
�k�r��
|� }�j|� |�
|
�
��
�qvW |�
�}�j�|d � � g }x�� jD ]|}|�k�r|j�r>|jt|�� nT|jd k �rt|jt��rt�|j��r|jt�|j�k�rt�|j� j||j�� �qW |�r�� jtd�dj
|� � xb� jD ]X}|j�r�xH|jD ]}|�k�r�P �q�W dd� |jD �}td�}� j|dj
|� � �q�W ��fS )NrP z--r �A�Or[ c s� �j | � �j| |�}|| jk rf�j | � x:� j| g �D ]*}|�kr8td�}t|�}t| || ��q8W |tk r|| ��||� d S )Nz not allowed with argument %s)r� � _get_valuesr� r� r r� r r )rq Zargument_stringsr� Zargument_valuesZconflict_actionr� Z action_name)�action_conflictsr1 � seen_actions�seen_non_default_actionsr! r& r' � take_action s
z5ArgumentParser._parse_known_args..take_actionc s� �| }|\}}}�j }g }�x>|d kr>�j� | � | d S |d k �r||d�}�j}|dkr�|d |kr�|j|g |f� |d } | |d }|dd � p�d }
�j} || kr�| | }|
}ntd�} t|| | ��n@|dkr�| d }
|g}|j|||f� P ntd�} t|| | ��q | d }�|d � }|||�}|| }
� ||
� }|j|||f� P q W |�sht�x |D ]\}}}�|||� �qnW |
S )NrP rU r z ignored explicit argument %r)�_match_argumentr r r r r rR )� start_index� option_tuplerq r� � explicit_argZmatch_argumentZ
action_tuples� arg_countr) �charZnew_explicit_argZ
optionals_mapr� �stoprY r� Zselected_patterns)r" �arg_strings_pattern�extras�option_string_indicesr! r[ r& r' �consume_optional3 sP
z:ArgumentParser._parse_known_args..consume_optionalc sr �j }�| d � }|�|�}x8t�|�D ]*\}}� | | | � }| |7 } �||� q(W �t|�d � �d d �< | S )N)�_match_arguments_partial�ziprk )r] Z
match_partialZselected_patternZ
arg_countsrq r` rY )r" rc r� r! r[ r& r' �consume_positionals� s
z=ArgumentParser._parse_known_args..consume_positionalsr c s g | ]}|� kr|�qS r& r& )rW r� )r] r& r' rZ � s z4ArgumentParser._parse_known_args..z(the following arguments are required: %sz, c S s g | ]}|j tk rt|��qS r& )rm r r� )rW rq r& r& r' rZ � s z#one of the arguments %s is requiredrx )Nr� ) rF �_read_args_from_filesr r� r� r� r� �iterr �_parse_optionalr r� rM r@ r? r r� r� r� r� r� r� r� r/ r0 �
_get_valuer> r )r! r" r1 r5 r� r� Z mutex_actionZ conflictsZarg_string_pattern_partsZarg_strings_iter�
arg_stringr^ �patternrf ri Zmax_option_string_indexZnext_option_string_indexZpositionals_end_indexZstringsZ
stop_indexZrequired_actionsrq r� r� r� r& ) rX r" rc rd r1 re r� rY rZ r! r] r[ r' rQ � s�
J
z ArgumentParser._parse_known_argsc C s� g }x�|D ]�}| s"|d | j kr.|j|� q
ylt|dd � ��R}g }x2|j� j� D ]"}x | j|�D ]}|j|� qdW qTW | j|�}|j|� W d Q R X W q
tk
r� t j
� d }| j t |�� Y q
X q
W |S )Nr rP )
rF r r� �readr� �convert_arg_line_to_argsrj r� r r� rS r> r� )r! r" Znew_arg_stringsrn Z args_file�arg_liner# rT r& r& r' rj � s
z$ArgumentParser._read_args_from_filesc C s |gS )Nr& )r! rr r& r& r' rq � s z'ArgumentParser.convert_arg_line_to_argsc C st | j |�}tj||�}|d krfd td�ttd�ttd�i}tdd|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 argumentsrP ) �_get_nargs_patternrH r1 r r
r r r� r� r rk r� )r! rq rc �
nargs_patternr1 Z nargs_errorsr� r� r& r& r' r\ s
z ArgumentParser._match_argumentc st g }xjt t|�dd�D ]V}|d |� }dj� fdd�|D ��}tj||�}|d k r|jdd� |j� D �� P qW |S )Nr rP r[ c s g | ]}� j |��qS r& )rs )rW rq )r! r& r' rZ s z;ArgumentParser._match_arguments_partial..c S s g | ] }t |��qS r& )rk )rW r r& r& r' rZ ! s r� )r� rk r rH r1 r� rh )r! rg rc r� r� Z
actions_slicero r1 r& )r! r' rg s
z'ArgumentParser._match_arguments_partialc
C s |sd S |d | j krd S || jkr8| j| }||d fS t|�dkrHd S d|kr~|jdd�\}}|| jkr~| j| }|||fS | jr�| j|�}t|�dkr�djdd� |D ��}||d�}td�}| j|| � nt|�dkr�|\} | S | j j
|��r | j �s d S d |k�rd S d |d fS )
Nr rP �=z, c S s g | ]\}}}|�qS r& r& )rW rq r� r_ r& r& r' rZ G s z2ArgumentParser._parse_optional..)r7 Zmatchesz4ambiguous option: %(option)s could match %(matches)srx ) r r rk �splitrH �_get_option_tuplesr r r> r r1 r )
r! rn rq r� r_ Z
option_tuplesZoptionsrY r� r^ r& r& r' rl ' s>
z ArgumentParser._parse_optionalc
C s0 g }| j }|d |kr~|d |kr~d|kr<|jdd�\}}n|}d }x�| jD ],}|j|�rL| j| }|||f}|j|� qLW n�|d |ko�|d |k�r|}d }|d d� }|dd � } xr| jD ]T}||kr�| j| }||| f}|j|� q�|j|�r�| j| }|||f}|j|� q�W n| jtd�| � |S )Nr rP ru r3 z unexpected option string: %s)r rv r �
startswithr r> r )
r! r� r� r) Z
option_prefixr_ rq r� Zshort_option_prefixZshort_explicit_argr& r& r' rw b s8
z!ArgumentParser._get_option_tuplesc C s� |j }|d krd}nX|tkr"d}nJ|tkr0d}n<|tkr>d}n.|tkrLd}n |tkrZd}nddjd | � }|jr�|jdd
�}|jd d
�}|S ) Nz(-*A-*)z(-*A?-*)z (-*[A-]*)z
(-*A[A-]*)z([-AO]*)z (-*A[-AO]*)z(-*%s-*)z-*rU r[ r ) r� r
r r r r r r� r9 )r! rq r� rt r& r& r' rs � s$ z!ArgumentParser._get_nargs_patternc sx � j ttgkr2y|jd� W n tk
r0 Y nX | rz� j tkrz� jrP� j}n� j}t |t
�rx�j � |�}�j � |� n�| r�� j t
kr�� j r�� jd k r�� j}n|}�j � |� n�t|�dkr�� j d tgkr�|\}�j � |�}�j � |� n�� j tk�r� �fdd�|D �}nb� j tk�rD� �fdd�|D �}�j � |d � n0� �fdd�|D �}x|D ]}�j � |� �q^W |S )Nz--rP c s g | ]}�j � |��qS r& )rm )rW �v)rq r! r& r' rZ � s z.ArgumentParser._get_values..c s g | ]}�j � |��qS r& )rm )rW ry )rq r! r& r' rZ � s r c s g | ]}�j � |��qS r& )rm )rW ry )rq r! r& r' rZ � s )r� r r r2 r; r
r� r� r� r� r� rm � _check_valuer rk )r! rq r" r% rn ry r& )rq r! r' rW � s>
zArgumentParser._get_valuesc C s� | j d|j|j�}t|�s0td�}t||| ��y ||�}W n� tk
r~ t|jdt|j��}tt j
� d �}t||��Y nL t t fk
r� t|jdt|j��}||d�}td�}t||| ��Y nX |S )Nr z%r is not callabler rP )r r% z!invalid %(type)s value: %(value)r)
r r r& r r r r/ r r� r� rS r' r; )r! rq rn r* r� r� r$ rY r& r& r' rm � s
zArgumentParser._get_valuec C sF |j d k rB||j krB|djtt|j ��d�}td�}t||| ��d S )Nz, )r% r� z3invalid choice: %(value)r (choose from %(choices)s))r� r �mapr r r )r! rq r% rY r� r& r& r' rz s
zArgumentParser._check_valuec C s$ | j � }|j| j| j| j� |j� S )N)r� rj rf r r r^ )r! rT r& r& r' � format_usage s zArgumentParser.format_usagec C sx | j � }|j| j| j| j� |j| j� x:| jD ]0}|j|j � |j|j� |j
|j � |j � q0W |j| j
� |j� S )N)r� rj rf r r rd r r r` r4 rt r� ra rD r^ )r! rT Z action_groupr& r& r' r^ s zArgumentParser.format_helpc C s | j | jd�S )N)rM )rE rM )r! r& r& r' r� 0 s z ArgumentParser._get_formatterc C s" |d krt j}| j| j� |� d S )N)r� r� r� r| )r! �filer& r& r' � print_usage6 s zArgumentParser.print_usagec C s" |d krt j}| j| j� |� d S )N)r� r� r� r^ )r! r} r& r& r' r� ; s zArgumentParser.print_helpc C s |r |d krt j}|j|� d S )N)r� �stderr�write)r! r� r} r& r& r' r� @ s z ArgumentParser._print_messager c C s |r| j |tj� tj|� d S )N)r� r� r r� )r! Zstatusr� r& r& r' r� I s zArgumentParser.exitc C s0 | j tj� | j|d�}| jdtd�| � dS )z�error(message: string)
Prints a usage message incorporating the message to stderr and
exits.
If you override this in a subclass, it should not return -- it
should either exit or raise an exception.
)rM r� r3 z %(prog)s: error: %(message)s
N)r~ r� r rM r� r )r! r� rY r& r& r' r> N s zArgumentParser.error)NN)NN)N)N)N)r N)!r r, r- r. r rO r rN r( rO rM rP r� rQ rj rq r\ rg rl rw rs rW rm rz r| r^ r� r~ r� r� r� r> r� r& r& )r� r' r 1 sP 4
# w;,,4
)6r. � __version__�__all__� collectionsr� r� r� �osr8 �rerH �sysr� �textwrapr� r r r r r
r r r r r� r� r r2 r r r r r r� � Exceptionr r r r� r� r� r� r� r� r� r� r� r� r r
r r+ r- r r& r& r& r' �> s�
n
[#%`6 5"