a �DOgG�@sdZdZgd�ZddlZddlZddlZddl m Z m Z dZ dZ dZd Zd Zd Zd ZGd d�de�Zdd�ZGdd�de�ZGdd�de�ZGdd�de�ZGdd�de�ZGdd�de�Zdd�ZGdd�de�ZGdd �d e�ZGd!d"�d"e�ZGd#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-d.�d.e�Z%Gd/d0�d0e�Z&Gd1d2�d2e�Z'Gd3d4�d4e�Z(Gd5d6�d6e�Z)Gd7d8�d8e�Z*Gd9d:�d:e%�Z+Gd;d<�d�d>e�Z-Gd?d@�d@e�Z.GdAdB�dBe.�Z/GdCdD�dDe/�Z0GdEdF�dFee.�Z1dS)Ga� 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�BooleanOptionalAction�FileType� HelpFormatter�ArgumentDefaultsHelpFormatter�RawDescriptionHelpFormatter�RawTextHelpFormatter�MetavarTypeHelpFormatter� Namespace�Action� ONE_OR_MORE�OPTIONAL�PARSER� REMAINDER�SUPPRESS� ZERO_OR_MORE�N)�gettext�ngettextz ==SUPPRESS==�?�*�+zA...�...�_unrecognized_argsc@s(eZdZdZdd�Zdd�Zdd�ZdS) �_AttributeHolderaAbstract 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__. cCs�t|�j}g}i}|��D]}|�t|��q|��D],\}}|��rZ|�d||f�q6|||<q6|rz|�dt|��d|d�|�fS)N�%s=%rz**%s�%s(%s)�, )�type�__name__� _get_args�append�repr� _get_kwargs� isidentifier�join)�self� type_name� arg_strings� star_args�arg�name�value�r.� /usr/lib64/python3.9/argparse.py�__repr__ts   z_AttributeHolder.__repr__cCst|j���S�N)�list�__dict__�items�r'r.r.r/r$�sz_AttributeHolder._get_kwargscCsgSr1r.r5r.r.r/r!�sz_AttributeHolder._get_argsN)r � __module__� __qualname__�__doc__r0r$r!r.r.r.r/rksrcCs6|dur gSt|�tur$|dd�Sddl}|�|�S�Nr)rr2�copy)r4r:r.r.r/� _copy_items�s   r;c@s�eZdZdZd;dd�Zdd�Zd d �ZGd d �d e�Zd d�Z dd�Z dd�Z dd�Z d��z6HelpFormatter._Section.format_help..�z%*s%s: � ) r^r]r[� _join_partsr4r\r_rrH)r'r&� item_help�current_indentr_r.r.r/� format_help�s    z"HelpFormatter._Section.format_help)N)r r6r7rWrjr.r.r.r/rK�s rKcCs|jj�||f�dSr1)rMr4r")r'rarbr.r.r/� _add_item�szHelpFormatter._add_itemcCs0|��|�||j|�}|�|jg�||_dSr1)r[rKrMrkrj)r'r_�sectionr.r.r/� start_section�szHelpFormatter.start_sectioncCs|jj|_|��dSr1)rMr^r\r5r.r.r/� end_section�s zHelpFormatter.end_sectioncCs$|tur |dur |�|j|g�dSr1)rrk� _format_text)r'�textr.r.r/�add_text�szHelpFormatter.add_textcCs&|tur"||||f}|�|j|�dSr1)rrk� _format_usage)r'�usage�actions�groups�prefixrbr.r.r/� add_usage�s zHelpFormatter.add_usagecCsr|jturn|j}||�g}|�|�D]}|�||��q$ttt|��}||j}t|j |�|_ |� |j |g�dSr1) �helpr�_format_action_invocation�_iter_indented_subactionsr"rE�map�lenrHrJrk�_format_action)r'�action�get_invocation� invocations� subaction�invocation_length� action_lengthr.r.r/� add_arguments   �zHelpFormatter.add_argumentcCs|D]}|�|�qdSr1)r�)r'rtr~r.r.r/� add_argumentsszHelpFormatter.add_argumentscCs.|j��}|r*|j�d|�}|�d�d}|S)N� rf)rLrjrR�sub�strip)r'rxr.r.r/rjs  zHelpFormatter.format_helpcCsd�dd�|D��S)NrecSsg|]}|r|tur|�qSr.)r)r`�partr.r.r/rc"s �z-HelpFormatter._join_parts..)r&)r'� part_stringsr.r.r/rg!s �zHelpFormatter._join_partscs|durtd�}|dur,|t|jd�}�n�|durL|sLdt|jd�}�n�|du�rdt|jd�}g}g}|D] }|jr�|�|�qr|�|�qr|j} | |||�} d�dd�|| fD��}|j|j�t |�t |��k�rd} | ||�} | ||�} t � | | �}t � | | �}d�fdd � }t |�t |�d �k�r�dt |�t |�d }|�r|||g|||�}|� |||��n |�r�||g|||�}n|g}nZdt |�}||}|||�}t |�d k�r�g}|� |||��|� |||��|g|}d �|�}d ||fS)Nzusage: �rSz%(prog)s� cSsg|] }|r|�qSr.r.)r`�sr.r.r/rcBrdz/HelpFormatter._format_usage..z%\(.*?\)+(?=\s|$)|\[.*?\]+(?=\s|$)|\S+cs�g}g}|durt|�d}n t|�d}|D]Z}|dt|��krn|rn|�|d�|��g}t|�d}|�|�|t|�d7}q.|r�|�|d�|��|dur�|dt|�d�|d<|S)NrYr�r)r|r"r&)�parts�indentrv�lines�line�line_lenr��� text_widthr.r/� get_linesVs"   z.HelpFormatter._format_usage..get_linesg�?rYrfz%s%s )N) �_�dictrB�option_stringsr"�_format_actions_usager&rGrHr|rN�findall�extend)r'rsrtrurvrS� optionals� positionalsr~�format� action_usage� part_regexp� opt_usage� pos_usage� opt_parts� pos_partsr�r�r�r�r.r�r/rr&sX     �        zHelpFormatter._format_usagec Cst�}i}|D�]*}|js(td|����z|�|jd�}WntyRYqYq0|t|j�}|||�|jkr|jD]}|�|�qz|js�||vr�||d7<nd||<||vr�||d7<nd||<nF||vr�||d7<nd||<||v�r||d7<nd||<t|d |�D]} d || <�q*qg} t|�D�]"\} }|j t u�r�| � d�|� | �d k�r�|� | �n"|� | d �d k�rj|� | d �n�|j�s|�|�} |�|| �} ||v�r�| ddk�r�| d dk�r�| d d �} | � | �nf|jd} |jdk�r$|��} n"|�|�} |�|| �}d | |f} |j�s`||v�r`d | } | � | ��qHt|dd�D]} || g| | | �<�qzd�dd�| D��}d}d}t�d|d|�}t�d|d|�}t�d||fd|�}t�dd|�}|��}|S)Nz empty group rz [�[�]z (�(�)rY�|������%s %s�[%s]T)�reverser�cSsg|]}|dur|�qSr1r.)r`�itemr.r.r/rc�rdz7HelpFormatter._format_actions_usage..z[\[(]z[\])]z(%s) z\1� (%s)z%s *%srez \(([^|]*)\))�set�_group_actions� ValueError�indexr|�add�required�range� enumeraterxrr"�get�popr��#_get_default_metavar_for_positional� _format_args�nargs� format_usage�!_get_default_metavar_for_optional�sortedr&rNr�r�)r'rtru� group_actions�inserts�group�start�endr~�ir��defaultr�� option_string� args_stringrp�open�closer.r.r/r��s~                     z#HelpFormatter._format_actions_usagecCsFd|vr|t|jd�}t|j|jd�}d|j}|�|||�dS)Nz%(prog)r�� r�r�)r�rBrErGrH� _fill_text)r'rpr�r�r.r.r/ro�s  zHelpFormatter._format_textc CsNt|jd|j�}t|j|d�}||jd}|�|�}|jsV|jd|f}d|}n@t|�|kr~|jd||f}d|}d}n|jd|f}d|}|}|g}|j�r |j� ��r |� |�} | �r"|� | |�} |� d|d| df�| dd�D]} |� d|d| f�q�n|� d��s"|� d�|�|�D]} |� |�| ���q,|�|�S) Nr<r�rez%*s%s z %*s%-*s rrYrf)rDrJrFrErGrHryrxr|r�� _expand_help� _split_linesr"�endswithrzr}rg) r'r~� help_position� help_width� action_width� action_header�tup� indent_firstr�� help_text� help_linesr�r�r.r.r/r}�s: �         zHelpFormatter._format_actioncCs�|js&|�|�}|�||�d�\}|Sg}|jdkrB|�|j�n4|�|�}|�||�}|jD]}|�d||f�q^d�|�SdS)NrYrr�r) r�r��_metavar_formatterr�r�r�r�r"r&)r'r~r��metavarr�r�r�r.r.r/ry's     z'HelpFormatter._format_action_invocationcsP|jdur|j�n.|jdur.z{%s}�,cst�t�r�S�f|SdSr1)� isinstance�tuple)� tuple_size��resultr.r/r�Hs z0HelpFormatter._metavar_formatter..format)r��choicesr&)r'r~�default_metavar� choice_strsr�r.r�r/r�?s   z HelpFormatter._metavar_formattercCs |�||�}|jdur$d|d�}n�|jtkr.zinvalid nargs valuer�) r�r�rrr|r rrrr�� TypeErrorr�r&)r'r~r�� get_metavarr�r��formatsr.r.r/r�Os0            zHelpFormatter._format_argscCs�tt|�|jd�}t|�D]}||tur||=qt|�D] }t||d�r:||j||<q:|�d�dur�d�dd�|dD��}||d<|� |�|S)Nr�r r�rcSsg|] }t|��qSr.r��r`�cr.r.r/rctrdz.HelpFormatter._expand_help..) r��varsrBr2r�hasattrr r�r&�_get_help_string)r'r~�paramsr,� choices_strr.r.r/r�ks   zHelpFormatter._expand_helpccs>z |j}WntyYn0|��|�EdH|��dSr1)�_get_subactions�AttributeErrorr[r\)r'r~�get_subactionsr.r.r/rzxs   z'HelpFormatter._iter_indented_subactionscCs&|j�d|���}ddl}|�||�S)Nr�r)rQr�r��textwrap�wrap)r'rprVr�r.r.r/r��szHelpFormatter._split_linescCs,|j�d|���}ddl}|j||||d�S)Nr�r)�initial_indent�subsequent_indent)rQr�r�r��fill)r'rprVr�r�r.r.r/r��s �zHelpFormatter._fill_textcCs|jSr1)rx�r'r~r.r.r/r��szHelpFormatter._get_help_stringcCs |j��Sr1)�dest�upperr�r.r.r/r��sz/HelpFormatter._get_default_metavar_for_optionalcCs|jSr1)r�r�r.r.r/r��sz1HelpFormatter._get_default_metavar_for_positional)r<r=N)N) r r6r7r8rWr[r\�objectrKrkrmrnrqrwr�r�rjrgrrr�ror}ryr�r�r�rzr�r�r�r�r�r.r.r.r/r�s>�  `j0  rc@seZdZdZdd�ZdS)rz�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. cs d��fdd�|jdd�D��S)Nrec3s|]}�|VqdSr1r.)r`r��r�r.r/� �rdz9RawDescriptionHelpFormatter._fill_text..T)�keepends)r&� splitlines)r'rprVr�r.r�r/r��sz&RawDescriptionHelpFormatter._fill_textN)r r6r7r8r�r.r.r.r/r�src@seZdZdZdd�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. cCs|��Sr1)r)r'rprVr.r.r/r��sz!RawTextHelpFormatter._split_linesN)r r6r7r8r�r.r.r.r/r �sr c@seZdZdZdd�ZdS)rz�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. cCs>|j}d|jvr:|jtur:ttg}|js2|j|vr:|d7}|S)Nz %(default)� (default: %(default)s))rxr�rrrr�r�)r'r~rx�defaulting_nargsr.r.r/r��s  z.ArgumentDefaultsHelpFormatter._get_help_stringN)r r6r7r8r�r.r.r.r/r�src@s eZdZdZdd�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. cCs|jjSr1�rr r�r.r.r/r��sz:MetavarTypeHelpFormatter._get_default_metavar_for_optionalcCs|jjSr1rr�r.r.r/r��sz.r.�r'�namesr.r5r/r$Js zAction._get_kwargscCs |jdSr9�r�r5r.r.r/r�YszAction.format_usagecCsttd���dS)Nz.__call__() not defined)�NotImplementedErrorr��r'�parser� namespace�valuesr�r.r.r/�__call__\szAction.__call__)NNNNNFNN)N)r r6r7r8rWr$r�rr.r.r.r/r s5� r cs0eZdZd �fdd� Zd dd�Zdd�Z�ZS) rNFc s~g} |D]2} | �| �| �d�rd| dd�} | �| �q|dur\|dur\|tur\|d7}t�j| |d||||||d� dS)N�--�--no-r<rr) r�r�r�r�rr�r�rxr�)r"� startswithr�superrW) r'r�r�r�rr�r�rxr��_option_stringsr��� __class__r.r/rW`s&    �zBooleanOptionalAction.__init__cCs$||jvr t||j|�d� �dS)Nr)r��setattrr�rrr.r.r/r�s zBooleanOptionalAction.__call__cCs d�|j�S)Nz | )r&r�r5r.r.r/r��sz"BooleanOptionalAction.format_usage)NNNFNN)N)r r6r7rWrr�� __classcell__r.r.r r/r_s� rcs(eZdZd�fdd� Zddd�Z�ZS) � _StoreActionNFc sT|dkrtd��|dur,|tkr,tdt��tt|�j||||||||| | d� dS)Nrz�nargs 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�rrr$rWrr r.r/rW�s   �z_StoreAction.__init__cCst||j|�dSr1)r"r�rr.r.r/r�sz_StoreAction.__call__)NNNNNFNN)N�r r6r7rWrr#r.r.r r/r$�s�r$cs(eZdZd�fdd� Zddd�Z�ZS) �_StoreConstActionNFc s"tt|�j||d||||d�dS)Nr)r�r�r�r r�r�rx)rr'rW�r'r�r�r r�r�rxr�r r.r/rW�s �z_StoreConstAction.__init__cCst||j|j�dSr1)r"r�r rr.r.r/r�sz_StoreConstAction.__call__)NFNN)Nr&r.r.r r/r'�s �r'cseZdZd�fdd� Z�ZS)�_StoreTrueActionFNcs tt|�j||d|||d�dS)NT�r�r�r r�r�rx)rr)rW�r'r�r�r�r�rxr r.r/rW�s �z_StoreTrueAction.__init__)FFN�r r6r7rWr#r.r.r r/r)�s�r)cseZdZd�fdd� Z�ZS)�_StoreFalseActionTFNcs tt|�j||d|||d�dS)NFr*)rr-rWr+r r.r/rW�s �z_StoreFalseAction.__init__)TFNr,r.r.r r/r-�s�r-cs(eZdZd�fdd� Zddd�Z�ZS) � _AppendActionNFc sT|dkrtd��|dur,|tkr,tdt��tt|�j||||||||| | d� dS)Nrz�nargs for append actions must be != 0; if arg strings are not supplying the value to append, the append const action may be more appropriater%r )r�rrr.rWrr r.r/rW�s   �z_AppendAction.__init__cCs2t||jd�}t|�}|�|�t||j|�dSr1)rr�r;r"r"�r'rrrr�r4r.r.r/rs z_AppendAction.__call__)NNNNNFNN)Nr&r.r.r r/r.�s�r.cs(eZdZd�fdd� Zddd�Z�ZS) �_AppendConstActionNFc s$tt|�j||d|||||d�dS)Nr)r�r�r�r r�r�rxr�)rr0rWr(r r.r/rW s �z_AppendConstAction.__init__cCs4t||jd�}t|�}|�|j�t||j|�dSr1)rr�r;r"r r"r/r.r.r/rs z_AppendConstAction.__call__)NFNN)Nr&r.r.r r/r0 s �r0cs(eZdZd�fdd� Zddd�Z�ZS) � _CountActionNFcs tt|�j||d|||d�dS)Nr)r�r�r�r�r�rx)rr1rWr+r r.r/rW's �z_CountAction.__init__cCs0t||jd�}|durd}t||j|d�dS�NrrY)rr�r")r'rrrr��countr.r.r/r5sz_CountAction.__call__)NFN)Nr&r.r.r r/r1%s �r1cs.eZdZeedf�fdd� Zddd�Z�ZS)� _HelpActionNcstt|�j|||d|d�dS�Nr)r�r�r�r�rx)rr4rW)r'r�r�r�rxr r.r/rW>s �z_HelpAction.__init__cCs|��|��dSr1)� print_help�exitrr.r.r/rJsz_HelpAction.__call__)N�r r6r7rrWrr#r.r.r r/r4<s � r4cs0eZdZdeedf�fdd� Zddd�Z�ZS)�_VersionActionNz&show program's version number and exitcs$tt|�j|||d|d�||_dSr5)rr9rW�version)r'r�r:r�r�rxr r.r/rWQs �z_VersionAction.__init__cCsD|j}|dur|j}|��}|�|�|�|��tj�|��dSr1)r:�_get_formatterrq�_print_messagerj�_sys�stdoutr7)r'rrrr�r:r]r.r.r/r_s z_VersionAction.__call__)Nr8r.r.r r/r9Os �r9csPeZdZGdd�de�Zedddf�fdd� Zdd�Zd d �Zd d d �Z �Z S)�_SubParsersActioncseZdZ�fdd�Z�ZS)z&_SubParsersAction._ChoicesPseudoActioncs@|}}|r|dd�|�7}ttj|�}|jg|||d�dS)Nr�r)r�r�rxr�)r&rr?�_ChoicesPseudoActionrW)r'r,�aliasesrxr�r��supr r.r/rWms  �z/_SubParsersAction._ChoicesPseudoAction.__init__r,r.r.r r/r@ksr@FNc s<||_||_i|_g|_tt|�j||t|j|||d�dS)N)r�r�r�r�r�rxr�)� _prog_prefix� _parser_class�_name_parser_map�_choices_actionsrr?rWr)r'r�rS� parser_classr�r�rxr�r r.r/rWus  �z_SubParsersAction.__init__cKs�|�d�dur d|j|f|d<|�dd�}d|vrX|�d�}|�|||�}|j�|�|jfi|��}||j|<|D]}||j|<qv|S)NrSr�rAr.rx)r�rCr�r@rFr"rDrE)r'r,�kwargsrArx� choice_actionr�aliasr.r.r/� add_parser�s     z_SubParsersAction.add_parsercCs|jSr1)rFr5r.r.r/r��sz!_SubParsersAction._get_subactionsc Cs�|d}|dd�}|jtur,t||j|�z|j|}Wn:tyt|d�|j�d�}td�|}t||��Yn0|�|d�\} }t | �� �D]\} } t|| | �q�|r�t |�� t g�t |t ��|�dS)NrrYr)� parser_namer�z5unknown parser %(parser_name)r (choices: %(choices)s))r�rr"rE�KeyErrorr&r�r�parse_known_argsr�r4� setdefault�_UNRECOGNIZED_ARGS_ATTRrr�) r'rrrr�rLr)rb�msg� subnamespace�keyr-r.r.r/r�s$    �  z_SubParsersAction.__call__)N) r r6r7r r@rrWrKr�rr#r.r.r r/r?is�r?c@seZdZddd�ZdS)� _ExtendActionNcCs2t||jd�}t|�}|�|�t||j|�dSr1)rr�r;r�r"r/r.r.r/r�s z_ExtendAction.__call__)N)r r6r7rr.r.r.r/rT�srTc@s*eZdZdZd dd�Zdd�Zd d �ZdS) ra�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. �rr�NcCs||_||_||_||_dSr1)�_mode�_bufsize� _encoding�_errors)r'�mode�bufsize�encoding�errorsr.r.r/rW�szFileType.__init__c s�|dkrnd�jvr*d�jvr$tjjStjSt�fdd�dD��rXd�jvrRtjjStjStd��j}t|��zt|�j�j �j �j �WSt y�}z*||d�}td �}t ||��WYd}~n d}~00dS) N�-rU�bc3s|]}|�jvVqdSr1)rVr�r5r.r/r��rdz$FileType.__call__..�waxzargument "-" with mode %r)�filename�errorz$can't open '%(filename)s': %(error)s)rVr=�stdin�buffer�anyr>r�r�r�rWrXrY�OSErrorr)r'�stringrQ�erbr r.r5r/r�s � zFileType.__call__cCsT|j|jf}d|jfd|jfg}d�dd�|D�dd�|D��}dt|�j|fS)Nr\r]rcSsg|]}|dkrt|��qS)r�)r#)r`r+r.r.r/rc�rdz%FileType.__repr__..cSs$g|]\}}|durd||f�qS)Nrr.)r`�kwr+r.r.r/rcs �r)rVrWrXrYr&rr )r'rbrH�args_strr.r.r/r0�s   �zFileType.__repr__)rUr�NN)r r6r7r8rWrr0r.r.r.r/r�s rc@s(eZdZdZdd�Zdd�Zdd�ZdS) r z�Simple object for storing attributes. Implements equality by attribute names and values, and provides a simple string representation. cKs|D]}t||||�qdSr1)r")r'rHr,r.r.r/rWszNamespace.__init__cCst|t�stSt|�t|�kSr1)r�r �NotImplementedr�)r'�otherr.r.r/�__eq__s zNamespace.__eq__cCs ||jvSr1)r3)r'rSr.r.r/� __contains__szNamespace.__contains__N)r r6r7r8rWrmrnr.r.r.r/r sr cs�eZdZ�fdd�Zdd�Zd&dd�Zdd �Zd d �Zd d �Zdd�Z dd�Z dd�Z dd�Z dd�Z dd�Zdd�Zd'dd�Zdd�Zd d!�Zd"d#�Zd$d%�Z�ZS)(�_ActionsContainercstt|���||_||_||_||_i|_|�ddt �|�ddt �|�ddt �|�ddt �|�ddt �|�ddt �|�ddt�|�ddt�|�dd t�|�dd t�|�dd t�|�dd t�|��g|_i|_g|_g|_i|_t�d �|_g|_dS)Nr~�store� store_const� store_true� store_falser"� append_constr3rxr:�parsersr�z^-\d+$|^-\d*\.\d+$)rrorW� description�argument_default� prefix_chars�conflict_handler� _registries�registerr$r'r)r-r.r0r1r4r9r?rT� _get_handler�_actions�_option_string_actions�_action_groups�_mutually_exclusive_groups� _defaultsrNrO�_negative_number_matcher�_has_negative_number_optionals)r'rvrxrwryr r.r/rWs4 z_ActionsContainer.__init__cCs|j�|i�}|||<dSr1)rzrO)r'� registry_namer-r��registryr.r.r/r{Ssz_ActionsContainer.registerNcCs|j|�||�Sr1)rzr�)r'r�r-r�r.r.r/� _registry_getWsz_ActionsContainer._registry_getcKs2|j�|�|jD]}|j|vr||j|_qdSr1)r��updater}r�r�)r'rHr~r.r.r/� set_defaults]s   z_ActionsContainer.set_defaultscCs8|jD]"}|j|kr|jdur|jSq|j�|d�Sr1)r}r�r�r�r�)r'r�r~r.r.r/� get_defaultfs  z_ActionsContainer.get_defaultcOsP|j}|r&t|�dkrL|dd|vrL|r:d|vr:td��|j|i|��}n|j|i|��}d|vr�|d}||jvr�|j||d<n|jdur�|j|d<|�|�}t|�s�td|f��|fi|��}|� d|j |j �}t|�s�td |f��|t u�rtd |f��t |d ��rFz|� ��|d�Wnt�yDtd ��Yn0|�|�S) z� add_argument(dest, ..., name=value, ...) add_argument(option_string, option_string, ..., name=value, ...) rYrr�z+dest supplied twice for positional argumentr�Nzunknown action "%s"r�%r is not callablez<%r is a FileType class object, instance of it must be passedr;z,length of metavar tuple does not match nargs)rxr|r��_get_positional_kwargs�_get_optional_kwargsr�rw�_pop_action_class�callabler�rrr�r;r�r�� _add_action)r'rbrH�charsr�� action_classr~� type_funcr.r.r/r�ps:        � z_ActionsContainer.add_argumentcOs&t|g|�Ri|��}|j�|�|Sr1)�_ArgumentGrouprr")r'rbrHr�r.r.r/�add_argument_group�s z$_ActionsContainer.add_argument_groupcKs t|fi|��}|j�|�|Sr1)�_MutuallyExclusiveGroupr�r")r'rHr�r.r.r/�add_mutually_exclusive_group�s z._ActionsContainer.add_mutually_exclusive_groupcCs`|�|�|j�|�||_|jD]}||j|<q"|jD]"}|j�|�r8|js8|j�d�q8|S)NT) �_check_conflictr}r"� containerr�r~r��matchr�)r'r~r�r.r.r/r��s      z_ActionsContainer._add_actioncCs|j�|�dSr1)r}�remover�r.r.r/�_remove_action�sz _ActionsContainer._remove_actioncCs�i}|jD].}|j|vr.td�}t||j��|||j<q i}|jD]D}|j|vrn|j|j|j|jd�||j<|jD]}||j||<qtqD|jD]&}|j |j d�}|jD] }|||<q�q�|j D]}|� ||�� |�q�dS)Nz.cannot merge actions - two groups are named %r)�titlervry)r�)rr�r�r�r�rvryr�r�r�r�r}r�r�)r'r��title_group_mapr�rQ� group_mapr~� mutex_groupr.r.r/�_add_container_actions�s0     �   �   z(_ActionsContainer._add_container_actionscKs^d|vrtd�}t|��|�d�ttfvr2d|d<|�d�tkrPd|vrPd|d<t||gd�S)Nr�z1'required' is an invalid argument for positionalsr�Tr��r�r�)r�r�r�rrr�)r'r�rHrQr.r.r/r��sz(_ActionsContainer._get_positional_kwargsc Os�g}g}|D]`}|d|jvr>||jd�}td�}t||��|�|�t|�dkr |d|jvr |�|�q |�dd�}|dur�|r�|d}n|d}|�|j�}|s�td�}t||��|�dd�}t|||d �S) Nr)�optionrxzNinvalid option string %(option)r: must start with a character %(prefix_chars)rrYr�z%dest= is required for options like %rr^r�r�) rxr�r�r"r|r��lstrip�replacer�) r'rbrHr��long_option_stringsr�rQr��dest_option_stringr.r.r/r��s.�        z&_ActionsContainer._get_optional_kwargscCs|�d|�}|�d||�S)Nr~)r�r�)r'rHr�r~r.r.r/r�s z#_ActionsContainer._pop_action_classcCsDd|j}z t||�WSty>td�}t||j��Yn0dS)Nz_handle_conflict_%sz%invalid conflict_resolution value: %r)ryrr�r�r�)r'�handler_func_namerQr.r.r/r|#s    z_ActionsContainer._get_handlercCsLg}|jD]&}||jvr |j|}|�||f�q |rH|��}|||�dSr1)r�r~r"r|)r'r~�confl_optionalsr��confl_optionalryr.r.r/r�,s   z!_ActionsContainer._check_conflictcCs6tddt|��}d�dd�|D��}t|||��dS)Nzconflicting option string: %szconflicting option strings: %srcSsg|] \}}|�qSr.r.)r`r�r~r.r.r/rc>s�z<_ActionsContainer._handle_conflict_error..)rr|r&r)r'r~�conflicting_actionsr �conflict_stringr.r.r/�_handle_conflict_error:s� �z(_ActionsContainer._handle_conflict_errorcCs>|D]4\}}|j�|�|j�|d�|js|j�|�qdSr1)r�r�r~r�r�r�)r'r~r�r�r.r.r/�_handle_conflict_resolveCs   z*_ActionsContainer._handle_conflict_resolve)N)N)r r6r7rWr{r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r#r.r.r r/ros$ 5   3("   rocs6eZdZd�fdd� Z�fdd�Z�fdd�Z�ZS) r�Nc s�|j}|d|j�|d|j�|d|j�tt|�j}|fd|i|��||_g|_|j |_ |j |_ |j |_ |j |_ |j |_ |j|_dS)Nryrxrwrv)rOryrxrwrr�rWr�r�rzr}r~r�r�r�)r'r�r�rvrHr�� super_initr r.r/rWTs    �z_ArgumentGroup.__init__cs tt|��|�}|j�|�|Sr1)rr�r�r�r"r�r r.r/r�js z_ArgumentGroup._add_actioncs tt|��|�|j�|�dSr1)rr�r�r�r�r�r r.r/r�osz_ArgumentGroup._remove_action)NN�r r6r7rWr�r�r#r.r.r r/r�Rs r�cs.eZdZd�fdd� Zdd�Zdd�Z�ZS) r�Fcs tt|��|�||_||_dSr1)rr�rWr�� _container)r'r�r�r r.r/rWvsz _MutuallyExclusiveGroup.__init__cCs2|jrtd�}t|��|j�|�}|j�|�|S)Nz-mutually exclusive arguments must be optional)r�r�r�r�r�r�r")r'r~rQr.r.r/r�{s   z#_MutuallyExclusiveGroup._add_actioncCs|j�|�|j�|�dSr1)r�r�r�r�r�r.r.r/r��s z&_MutuallyExclusiveGroup._remove_action)Fr�r.r.r r/r�tsr�c s,eZdZdZddddgedddddddf �fdd� Zdd �Zd d �Zd d �Zdd�Z dd�Z dAdd�Z dBdd�Z dd�Z dd�Zdd�Zdd�Zdd�Zd d!�Zd"d#�Zd$d%�ZdCd&d'�ZdDd(d)�Zd*d+�Zd,d-�Zd.d/�Zd0d1�Zd2d3�Zd4d5�ZdEd6d7�ZdFd8d9�ZdGd:d;�ZdHd=d>�Z d?d@�Z!�Z"S)Ira)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 - exit_on_error -- Determines whether or not ArgumentParser exits with error info when an error occurs Nr^rbTc s&tt|�j}|||| | d�|dur6tj�tjd�}||_||_ ||_ ||_ ||_ | |_ | |_| |_|j}|td��|_|td��|_d|_dd�}|�dd|�d|vr�dn|d}|j r�|j|d |d d d ttd �d �|D]:}|�|�z |j}Wnt�yYq�0|j�|�q�dS)N)rvrxrwryrzpositional argumentszoptional argumentscSs|Sr1r.)rgr.r.r/�identity�sz)ArgumentParser.__init__..identityrr^�hr<rxzshow this help message and exit)r~r�rx)rrrW�_os�path�basenamer=�argvrSrs�epilog�formatter_class�fromfile_prefix_chars�add_help� allow_abbrev� exit_on_errorr�r�� _positionals� _optionals� _subparsersr{r�rr�r�r�r�)r'rSrsrvr��parentsr�rxr�rwryr�r�r�� superinit� add_groupr��default_prefixr^�defaultsr r.r/rW�sH ��  zArgumentParser.__init__csgd�}�fdd�|D�S)N)rSrsrvr�ryr�csg|]}|t�|�f�qSr.rrr5r.r/rc�rdz.ArgumentParser._get_kwargs..r.rr.r5r/r$�szArgumentParser._get_kwargsc Ks�|jdur|�td��|�dt|��d|vs8d|vrht|�dd��}t|�dd��}|�||�|_n|j|_|�d�dur�|� �}|� �}|j }|� |j ||d�|����|d<|�|d�}|fd gi|��}|j�|�|S) Nz(cannot have multiple subparser argumentsrGr�rv� subcommandsrSrerur�)r�rbr�rOrr�r�r�r�r;�_get_positional_actionsr�rwrsrjr�r�r�) r'rHr�rvr]r�ru� parsers_classr~r.r.r/�add_subparsers�s$   zArgumentParser.add_subparserscCs$|jr|j�|�n |j�|�|Sr1)r�r�r�r�r�r.r.r/r� s zArgumentParser._add_actioncCsdd�|jD�S)NcSsg|]}|jr|�qSr.r�r`r~r.r.r/rcs�z8ArgumentParser._get_optional_actions..�r}r5r.r.r/�_get_optional_actionss�z$ArgumentParser._get_optional_actionscCsdd�|jD�S)NcSsg|]}|js|�qSr.rr�r.r.r/rcs�z:ArgumentParser._get_positional_actions..r�r5r.r.r/r�s�z&ArgumentParser._get_positional_actionscCs4|�||�\}}|r0td�}|�|d�|��|S�Nzunrecognized arguments: %sr�)rNr�rbr&�r'rbrr�rQr.r.r/� parse_args s zArgumentParser.parse_argscCs|durtjdd�}nt|�}|dur.t�}|jD]4}|jtur4t||j�s4|jtur4t ||j|j�q4|j D] }t||�spt |||j |�qp|j r�z|� ||�\}}Wq�t y�t��d}|�t|��Yq�0n|� ||�\}}t|t��r|�t|t��t|t�||fSrX)r=r�r2r r}r�rr�r�r"r�r��_parse_known_argsr�exc_inforbr�rPr�r�delattr)r'rbrr~r��errr.r.r/rN's0          zArgumentParser.parse_known_argscs� jdur� ����i�� jD]R}|j}t|j�D]<\}}��|g�}|�|d|��|�||dd��q2qi�g}t��} t| �D]^\}} | dkr�|�d�| D]} |�d�q�q�� � | �} | dur�d} n | �|<d} |�| �q�d� |��t ��t ��d����� fdd� � ����� � fd d �} � � ������ � fd d �}g�d � ��r`t ��}nd}� |k�r�t� fdd��D��}� |k�r�|� �}|� k�r�|� �qdn|� � �v�r҈� |�}��|�|� | � �� �qd|� �}���|d��g}� jD]|}|�v�r|j�r(|�t|��nT|jdu�rt|jt��rt�|j��r|jt�|j�u�rt�|j� �||j���q|�r�� �td�d� |��� jD]X}|j�r�|jD]}|�v�r��q��q�dd�|jD�}td�}� �|d� |���q���fS)NrYrr^�A�Orecs|��|���||�}||jurb��|���|g�D]*}|�vr6td�}t|�}t|||��q6|turx|��||�dS)Nznot allowed with argument %s)r�� _get_valuesr�r�r�rrr)r~�argument_stringsr��argument_values�conflict_actionrQ� action_name)�action_conflictsr� seen_actions�seen_non_default_actionsr'r.r/� take_action}s    z5ArgumentParser._parse_known_args..take_actioncs~�|}|\}}}�j}g}|dur:���|�|dS|du�r||d�}�j}|dkr�|d|vr�|�|g|f�|d} | |d}|dd�p�d} �j} || vr�| |}| }ntd�} t|| |��nB|dkr�|d} |g}|�|||f��q\ntd�} t|| |��q|d}�|d�}|||�}||} �|| �}|�|||f��q\q|D]\}}}�|||��q`| S)NrYr�rzignored explicit argument %r)�_match_argumentr"rxr~r�r)� start_index� option_tupler~r�� explicit_arg�match_argument� action_tuples� arg_countr��char�new_explicit_arg� optionals_maprQ�stoprbr��selected_patterns)r)�arg_strings_pattern�extras�option_string_indicesr'r�r.r/�consume_optional�sL       z:ArgumentParser._parse_known_args..consume_optionalcsn�j}�|d�}|�|�}t�|�D]*\}}�|||�}||7}�||�q&�t|�d��dd�<|Sr1)�_match_arguments_partial�zipr|)r�� match_partial�selected_pattern� arg_countsr~r�rb)r)r�r�r'r�r.r/�consume_positionals�s   z=ArgumentParser._parse_known_args..consume_positionalsrr�csg|]}|�kr|�qSr.r.)r`r�)r�r.r/rc�s�z4ArgumentParser._parse_known_args..z(the following arguments are required: %srcSsg|]}|jturt|��qSr.)rxrrr�r.r.r/rc;s �z#one of the arguments %s is requiredr�)N)r��_read_args_from_filesr�r�r�rOr��iterr"�_parse_optionalr&r�r�rErDr}r�rr�r�r�r�r�rr"� _get_valuerbr�)r'r)rr�r�r�� mutex_action� conflicts�arg_string_pattern_parts�arg_strings_iter� arg_stringr��patternr�r��max_option_string_index�next_option_string_index�positionals_end_index�strings� stop_index�required_actionsr~r�rrQr.) r�r)r�r�rr�r�r�r�r'r�r�r/r�Ns�        J   �          � �� � �    �z ArgumentParser._parse_known_argsc Cs�g}|D]�}|r|d|jvr*|�|�qzxt|dd���T}g}|����D]}|�|�D]}|�|�q\qN|�|�}|�|�Wd�n1s�0YWqty�t � �d}|� t |��Yq0q|Sr2) r�r"r��readr�convert_arg_line_to_argsr�r�rfr=r�rbr�)r'r)�new_arg_stringsr�� args_file�arg_liner+r�r.r.r/r�Ds   ,  z$ArgumentParser._read_args_from_filescCs|gSr1r.)r'rr.r.r/r^sz'ArgumentParser.convert_arg_line_to_argscCsz|�|�}t�||�}|durldtd�ttd�ttd�i}|�|j�}|durbtdd|j�|j}t ||��t |� d��S)Nzexpected one argumentzexpected at most one argumentzexpected at least one argumentzexpected %s argumentzexpected %s argumentsrY) �_get_nargs_patternrNr�r�rr r�r�rrr|r�)r'r~r�� nargs_patternr�� nargs_errorsrQr.r.r/r�as"  � �� zArgumentParser._match_argumentcsrg}tt|�dd�D]X}|d|�}d��fdd�|D��}t�||�}|dur|�dd�|��D��qnq|S)Nrr�recsg|]}��|��qSr.)r r�r5r.r/rc}s�z;ArgumentParser._match_arguments_partial..cSsg|] }t|��qSr.)r|)r`rgr.r.r/rc�rd)r�r|r&rNr�r�ru)r'rtr�r�r�� actions_slicer�r�r.r5r/r�ws � z'ArgumentParser._match_arguments_partialc Cs|sdS|d|jvrdS||jvr8|j|}||dfSt|�dkrHdSd|vr~|�dd�\}}||jvr~|j|}|||fS|�|�}t|�dkr�d�dd�|D��}||d�}td�}|�||�nt|�dkr�|\} | S|j� |�r�|j s�dSd |v�rdSd|dfS) NrrY�=rcSsg|]\}}}|�qSr.r.)r`r~r�r�r.r.r/rc�s�z2ArgumentParser._parse_optional..)r��matchesz4ambiguous option: %(option)s could match %(matches)sr�) rxr~r|�split�_get_option_tuplesr&r�rbr�r�r�) r'r�r~r�r�� option_tuples�optionsrbrQr�r.r.r/r��s>          �    zArgumentParser._parse_optionalc Cs0g}|j}|d|vr�|d|vr�|jr~d|vrB|�dd�\}}n|}d}|jD],}|�|�rP|j|}|||f}|�|�qPn�|d|v�r|d|v�r|}d}|dd�}|dd�} |jD]T}||kr�|j|}||| f}|�|�q�|�|�r�|j|}|||f}|�|�q�n|�td�|�|S)NrrYr r<zunexpected option string: %s)rxr�rr~rr"rbr�) r'r�r�r�� option_prefixr�r~r��short_option_prefix�short_explicit_argr.r.r/r�s:             z!ArgumentParser._get_option_tuplescCs�|j}|durd}nf|tkr"d}nX|tkr0d}nJ|tkr>d}n<|tkrLd}n.|tkrZd}n |tkrhd}ndd �d |�}|jr�|� d d �}|� d d �}|S) Nz(-*A-*)z(-*A?-*)z (-*[A-]*)z (-*A[A-]*)z([-AO]*)z (-*A[-AO]*)z(-*-*)z(-*%s-*)z-*r�rer^) r�rrr rrrr&r�r�)r'r~r�r r.r.r/r �s(  z!ArgumentParser._get_nargs_patterncCs4|�||�\}}|r0td�}|�|d�|��|Sr�)�parse_known_intermixed_argsr�rbr&r�r.r.r/�parse_intermixed_args s z$ArgumentParser.parse_intermixed_argsc s�|���dd��D�}|r,td|dj���fdd�|jD�rHtd���z�|j}z�|jdurp|��dd�|_�D] }|j|_t|_|j|_ t|_qt|� ||�\}}�D]J}t ||j �r�t ||j �gkr�ddlm}|d |j |f�t||j �q�W�D]}|j|_|j |_q�n�D]}|j|_|j |_�q0|��}zt|D]}|j|_d |_�q@|jD]} | j| _d | _�q\|� ||�\}} W|D]}|j|_�q�|jD]} | j| _�q�n,|D]}|j|_�q�|jD]} | j| _�q�0W||_n||_0|| fS) NcSsg|]}|jttfvr|�qSr.)r�rrr�r.r.r/rc4 s�z>ArgumentParser.parse_known_intermixed_args..z3parse_intermixed_args: positional arg with nargs=%srcs&g|]}|jD]}|�vr|j�qqSr.)r�r�)r`r�r~�r�r.r/rc: s�z;parse_intermixed_args: positional in mutuallyExclusiveGroup�)�warnzDo not expect %s in %sF)r�r�r�r�rsr�� save_nargsrr�� save_defaultrNr�r�r�warningsrr�r�r�� save_required) r'rbr�a� save_usager~�remaining_argsrr�r�r�r.rr/r& sn � � �  �   �   �  z*ArgumentParser.parse_known_intermixed_argscs��jttfvr0z|�d�Wnty.Yn0|sx�jtkrx�jrL�j}n�j}t |t �rt�� �|�}�� �|��n|s��jt kr��js��jdur��j}n|}�� �|�n�t|�dkr�jdtfvr�|\}�� �|�}�� �|�n��jtk�r ��fdd�|D�}np�jtk�r>��fdd�|D�}�� �|d�n>�jtk�rPt}n,��fdd�|D�}|D]}�� �|��qh|S)NrrYcsg|]}���|��qSr.�r��r`�v�r~r'r.r/rc� rdz.ArgumentParser._get_values..csg|]}���|��qSr.r"r#r%r.r/rc� rdrcsg|]}���|��qSr.r"r#r%r.r/rc� rd)r�rrr�r�rr�r r�r�r�r�� _check_valuerr|r)r'r~r)r-r�r$r.r%r/r�s sD   �     zArgumentParser._get_valuesc Cs�|�d|j|j�}t|�s0td�}t|||��z ||�}Wn�ty|t|jdt|j��}tt � �d�}t||��YnJt t fy�t|jdt|j��}||d�}td�}t|||��Yn0|S)Nrr�r rY)rr-z!invalid %(type)s value: %(value)r) r�rr�r�rrrr#r�r=r�r�r�)r'r~r�r�rQr�r,rbr.r.r/r�� s    zArgumentParser._get_valuecCsF|jdurB||jvrB|d�tt|j��d�}td�}t|||��dS)Nr)r-r�z3invalid choice: %(value)r (choose from %(choices)s))r�r&r{r#r�r)r'r~r-rbrQr.r.r/r&� s �zArgumentParser._check_valuecCs$|��}|�|j|j|j�|��Sr1)r;rwrsr}r�rj)r'r]r.r.r/r�� s  �zArgumentParser.format_usagecCst|��}|�|j|j|j�|�|j�|jD]0}|�|j �|�|j�|� |j �|� �q.|�|j �|��Sr1)r;rwrsr}r�rqrvrrmr�r�r�rnr�rj)r'r]� action_groupr.r.r/rj� s �       zArgumentParser.format_helpcCs|j|jd�S)Nr�)r�rSr5r.r.r/r;� szArgumentParser._get_formattercCs"|durtj}|�|��|�dSr1)r=r>r<r��r'�filer.r.r/� print_usage� szArgumentParser.print_usagecCs"|durtj}|�|��|�dSr1)r=r>r<rjr(r.r.r/r6� szArgumentParser.print_helpcCs |r|durtj}|�|�dSr1)r=�stderr�write)r'r r)r.r.r/r<� szArgumentParser._print_messagercCs |r|�|tj�t�|�dSr1)r<r=r+r7)r'�statusr r.r.r/r7 szArgumentParser.exitcCs0|�tj�|j|d�}|�dtd�|�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. )rSr r<z%(prog)s: error: %(message)s N)r*r=r+rSr7r�)r'r rbr.r.r/rb s  zArgumentParser.error)NN)NN)NN)NN)N)N)N)rN)#r r6r7r8rrWr$r�r�r�r�r�rNr�r�rr�r�r�rr rrr�r�r&r�rjr;r*r6r<r7rbr#r.r.r r/r�sX�B  'w:-1  M8    r)2r8� __version__�__all__�osr��rerN�sysr=rr�rrrrr rrrPr�rr;rrr rr r� Exceptionrrr rr$r'r)r-r.r0r1r4r9r?rTrr ror�r�rr.r.r.r/�s`=   ^)#&] 78"