Edit File: docopt.cpython-37.pyc
B �ўS�M � @ sv d Z ddlZddlZdgZdZG dd� de�ZG dd� de�ZG d d � d e �Z G d d � d e �Z G d d� de �Z G dd� de �Z G dd� de �ZG dd� de �ZG dd� de �ZG dd� de �ZG dd� de�ZG dd � d e �ZG d d � d e �ZG d d � d e�Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zd)d*� Zd+d,� Z d<d.d/�Z d0d1� Z d2d3� Z d4d5� Z d6d7� Z!G d8d9� d9e"�Z#d=d;d�Z$dS )>a Pythonic command-line interface parser that will make you smile. * http://docopt.org * Repository and issue-tracker: https://github.com/docopt/docopt * Licensed under terms of MIT license (see LICENSE-MIT) * Copyright (c) 2013 Vladimir Keleshev, vladimir@keleshev.com � N�docoptz0.6.2c @ s e Zd ZdZdS )�DocoptLanguageErrorz4Error in construction of usage-message by developer.N)�__name__� __module__� __qualname__�__doc__� r r �7/opt/alt/python37/lib/python3.7/site-packages/docopt.pyr s r c @ s e Zd ZdZdZddd�ZdS )� DocoptExitz;Exit in case user invoked program with incorrect arguments.� c C s t �| |d | j �� � d S )N� )� SystemExit�__init__�usage�strip)�self�messager r r r s zDocoptExit.__init__N)r )r r r r r r r r r r r s r c @ sB e Zd Zdd� Zdd� Zdd� Zddd �Zd d � Zed d � �Z dS )�Patternc C s t | �t |�kS )N)�repr)r �otherr r r �__eq__" s zPattern.__eq__c C s t t| ��S )N)�hashr )r r r r �__hash__% s zPattern.__hash__c C s | � � | �� | S )N)�fix_identities�fix_repeating_arguments)r r r r �fix( s z Pattern.fixNc C s| t | d�s| S |dkr&tt| �� ��n|}xLt| j�D ]>\}}t |d�sj||ksTt�||�|� | j|< q6|�|� q6W dS )z>Make pattern-tree tips point to same object if they are equal.�childrenN) �hasattr�list�set�flat� enumerater �AssertionError�indexr )r Zuniq�i�cr r r r - s zPattern.fix_identitiesc s� dd� | j jD �}x�|D ]�� x�� fdd�� D �D ]v}t|�tksRt|�tkr~|jr~|jdkrdg |_nt|j�tk r~|j�� |_t|�t ks�t|�tkr0|jdkr0d|_q0W qW | S )z5Fix elements that should accumulate/increment values.c S s g | ]}t |j��qS r )r r )�.0r% r r r � <listcomp>; s z3Pattern.fix_repeating_arguments.<locals>.<listcomp>c s g | ]}� � |�d kr|�qS )� )�count)r& r% )�caser r r' = s Nr ) �eitherr �type�Argument�Option�argcount�valuer �split�Command)r r+ �er )r* r r 9 s "z Pattern.fix_repeating_argumentsc C s� g }| gg}�x�|�r�|� d�}dd� |D �}t|krzdd� |D �d }|� |�|�� x |jD ]}|�|g| � q`W qt|kr�dd� |D �d }|� |�|�� |�t|j�| � qt|kr�dd� |D �d }|� |�|�� |�t|j�| � qt|k�r<dd� |D �d }|� |�|�� |�t|j�| � qt |k�r�dd� |D �d } |� |�| �� |�t| j�d | � q|�|� qW td d� |D �� S ) zATransform pattern into an equivalent, with only top-level Either.r c S s g | ] }t |��qS r )r, )r& r% r r r r' P s z"Pattern.either.<locals>.<listcomp>c S s g | ]}t |�tkr|�qS r )r, �Either)r& r% r r r r' R s c S s g | ]}t |�tkr|�qS r )r, �Required)r& r% r r r r' W s c S s g | ]}t |�tkr|�qS r )r, �Optional)r& r% r r r r' [ s c S s g | ]}t |�tkr|�qS r )r, � AnyOptions)r& r% r r r r' _ s c S s g | ]}t |�tkr|�qS r )r, � OneOrMore)r& r% r r r r' c s � c S s g | ] }t |� �qS r )r5 )r& r3 r r r r' h s ) �popr4 r# r �appendr5 r r6 r7 r8 ) r �ret�groupsr �typesr+ r% �required�optionalZ oneormorer r r r+ G s8 zPattern.either)N) r r r r r r r r �propertyr+ r r r r r s r c @ s0 e Zd Zd dd�Zdd� Zdd� Zd dd �ZdS ) � ChildPatternNc C s || _ || _d S )N)�namer0 )r rC r0 r r r r m s zChildPattern.__init__c C s d| j j| j| jf S )Nz %s(%r, %r))� __class__r rC r0 )r r r r �__repr__q s zChildPattern.__repr__c G s |rt | �|kr| gS g S )N)r, )r r> r r r r t s zChildPattern.flatc s� |d kr g n|}� � |�\}}|d kr0d||fS |d |� ||d d � }� fdd�|D �}t� j�ttfkr�t� j�tkr�d}n t|j�tkr�|jgn|j}|s�||_d|||g fS |d j|7 _d||fS d|||g fS )NFr( c s g | ]}|j � j kr|�qS r )rC )r& �a)r r r r' } s z&ChildPattern.match.<locals>.<listcomp>Tr )� single_matchr, r0 �intr �str)r �left� collected�pos�matchZleft_Z same_name� incrementr )r r rM w s" zChildPattern.match)N)N)r r r r rE r rM r r r r rB k s rB c @ s$ e Zd Zdd� Zdd� Zdd� ZdS )� ParentPatternc G s t |�| _d S )N)r r )r r r r r r � s zParentPattern.__init__c C s" d| j jd�dd� | jD ��f S )Nz%s(%s)z, c s s | ]}t |�V qd S )N)r )r& rF r r r � <genexpr>� s z)ParentPattern.__repr__.<locals>.<genexpr>)rD r �joinr )r r r r rE � s zParentPattern.__repr__c s, t | �� kr| gS t� fdd�| jD �g �S )Nc s g | ]}|j � � �qS r )r )r& r% )r> r r r' � s z&ParentPattern.flat.<locals>.<listcomp>)r, �sumr )r r> r )r> r r � s zParentPattern.flatN)r r r r rE r r r r r rO � s rO c @ s e Zd Zdd� Zedd� �ZdS )r- c C s8 x2t |�D ]&\}}t|�tkr |t| j|j�fS q W dS )N)NN)r! r, r- rC r0 )r rJ �n�pr r r rG � s zArgument.single_matchc C s8 t �d|�d }t jd|t jd�}| ||r2|d nd �S )Nz(<\S*?>)r z\[default: (.*)\])�flags)�re�findall�I)�class_�sourcerC r0 r r r �parse� s zArgument.parseN)r r r rG � classmethodr[ r r r r r- � s r- c @ s e Zd Zddd�Zdd� ZdS )r2 Fc C s || _ || _d S )N)rC r0 )r rC r0 r r r r � s zCommand.__init__c C sD x>t |�D ]2\}}t|�tkr |j| jkr:|t| jd�fS P q W dS )NT)NN)r! r, r- r0 rC r2 )r rJ rS rT r r r rG � s zCommand.single_matchN)F)r r r r rG r r r r r2 � s r2 c @ s> e Zd Zddd�Zedd� �Zdd � Zed d � �Zd d � Z dS )r. Nr Fc C sB |dks t �|| | _| _|| | _| _|dkr8|r8d n|| _d S )N)r r( F)r" �short�longr/ r0 )r r] r^ r/ r0 r r r r � s zOption.__init__c C s� d\}}}}|� � �d�\}}}|�dd��dd�}x4|�� D ](} | �d�rR| }q>| �d�rb| }q>d}q>W |r�tjd |tjd �} | r�| d nd }| ||||�S ) N)NNr Fz �,� �=z--�-r( z\[default: (.*)\])rU r )r � partition�replacer1 � startswithrV rW rX ) rY Zoption_descriptionr] r^ r/ r0 �options�_� description�s�matchedr r r r[ � s z Option.parsec C s. x(t |�D ] \}}| j|jkr ||fS q W dS )N)NN)r! rC )r rJ rS rT r r r rG � s zOption.single_matchc C s | j p | jS )N)r^ r] )r r r r rC � s z Option.namec C s d| j | j| j| jf S )NzOption(%r, %r, %r, %r))r] r^ r/ r0 )r r r r rE � s zOption.__repr__)NNr F) r r r r r\ r[ rG rA rC rE r r r r r. � s r. c @ s e Zd Zddd�ZdS )r5 Nc C sR |d kr g n|}|}|}x.| j D ]$}|�||�\}}}|s d||fS q W d||fS )NFT)r rM )r rJ rK �lr% rT rj r r r rM � s zRequired.match)N)r r r rM r r r r r5 � s r5 c @ s e Zd Zddd�ZdS )r6 Nc C s< |d kr g n|}x | j D ]}|�||�\}}}qW d||fS )NT)r rM )r rJ rK rT �mr r r rM � s zOptional.match)N)r r r rM r r r r r6 � s r6 c @ s e Zd ZdZdS )r7 z*Marker/placeholder for [options] shortcut.N)r r r r r r r r r7 � s r7 c @ s e Zd Zddd�ZdS )r8 Nc C s� t | j�dkst�|d kr g n|}|}|}d }d}d}x>|rt| jd �||�\}}}||r^dnd7 }||krnP |}q8W |dkr�d||fS d||fS )Nr( Tr F)�lenr r" rM )r rJ rK rk r% Zl_rj �timesr r r rM � s zOneOrMore.match)N)r r r rM r r r r r8 � s r8 c @ s e Zd Zddd�ZdS )r4 Nc C sf |d kr g n|}g }x2| j D ](}|�||� \}}}}|r |�|� q W |r\t|dd� d�S d||fS )Nc S s t | d �S )Nr( )rm )�outcomer r r �<lambda> � z Either.match.<locals>.<lambda>)�keyF)r rM r; �min)r rJ rK ZoutcomesrT rj rg ro r r r rM s z Either.match)N)r r r rM r r r r r4 s r4 c @ s$ e Zd Zdd� Zdd� Zdd� ZdS )� TokenStreamc C s$ | t |d�r|�� n|7 } || _d S )Nr1 )r r1 �error)r rZ ru r r r r # s zTokenStream.__init__c C s t | �r| �d�S d S )Nr )rm r: )r r r r �move' s zTokenStream.movec C s t | �r| d S d S )Nr )rm )r r r r �current* s zTokenStream.currentN)r r r r rv rw r r r r rt ! s rt c s� | � � �d�\� }}� �d�s"t�|| kr6dkr>n ndn|}� fdd�|D �}| jtkrx|g krx� fdd�|D �}t|�dkr�| �d � d �d d � |D ��f ��n�t|�dk r�|dkr�dnd }td� |�}|� |� | jtkr�td� ||r�|nd�}n�t|d j |d j |d j |d j �}|j d k�rJ|dk �rz| �d|j ��n0|dk�rz| �� dk�rr| �d|j ��| � � }| jtk�r�|dk �r�|nd|_ |gS )z-long ::= '--' chars [ ( ' ' | '=' ) chars ] ;ra z--r Nc s g | ]}|j � kr|�qS r )r^ )r& �o)r^ r r r' 3 s z parse_long.<locals>.<listcomp>c s" g | ]}|j r|j �� �r|�qS r )r^ re )r& rx )r^ r r r' 5 s r( z %s is not a unique prefix: %s?z, c s s | ] }|j V qd S )N)r^ )r& rx r r r rP 8 s z parse_long.<locals>.<genexpr>r Tz %s must not have an argumentz%s requires argument)rv rc re r" ru r rm rQ r. r; r] r^ r/ r0 rw )�tokensrf �eqr0 �similarr/ rx r )r^ r � parse_long. s6 r| c sb | � � }|�d�r |�d�r t�|�d�}g }�x,|dk�r\d|d |dd� � }� fdd�|D �}t|�dkr�| �d � t|�f ��n�t|�dk r�t� dd�}|�|� | jtkr�t� ddd �}n�t� |d j |d j |d j �}d}|j dk�r0|dk�r(| � � dk�r | �d � ��| � � }n|}d}| jtk�rP|dk �rJ|nd |_ |�|� q2W |S ) z-shorts ::= '-' ( chars )* [ [ ' ' ] chars ] ;rb z--r r r( Nc s g | ]}|j � kr|�qS r )r] )r& rx )r] r r r' W s z parse_shorts.<locals>.<listcomp>z$%s is specified ambiguously %d timesTz%s requires argument) rv re r" �lstriprm ru r. r; r r^ r/ r0 rw )ry rf �tokenrJ �parsedr{ rx r0 r )r] r � parse_shortsO s: r� c C sF t t�dd| �t�}t||�}|�� d k r>|�dd�|� ��t|� S )Nz([\[\]\(\)\|]|\.\.\.)z \1 zunexpected ending: %rr` ) rt rV �subr � parse_exprrw ru rQ r5 )rZ rf ry �resultr r r � parse_patternr s r� c C s� t | |�}| �� dkr|S t|�dkr0t|� gn|}x@| �� dkrt| �� t | |�}|t|�dkrlt|� gn|7 }q6W t|�dkr�t|� gS |S )zexpr ::= seq ( '|' seq )* ;�|r( )� parse_seqrw rm r5 rv r4 )ry rf �seqr� r r r r� { s "r� c C sJ g }x@| � � dkrDt| |�}| � � dkr:t|� g}| �� ||7 }qW |S )z seq ::= ( atom [ '...' ] )* ;)N�]�)r� z...)rw � parse_atomr8 rv )ry rf r� Zatomr r r r� � s r� c C s� | � � }g }|dkrd| �� dtgdtgd�| \}}|t| |�� }| �� |kr^| �d| ��|gS |dkr|| �� t� gS |�d�r�|dkr�t| |�S |�d�r�|d kr�t | |�S |�d �r�|� d �s�|� � r�t | �� �gS t | �� �gS d S ) ziatom ::= '(' expr ')' | '[' expr ']' | 'options' | long | shorts | argument | command ; z([r� r� )�(�[zunmatched '%s'rf z--rb )rb z--�<�>N)rw rv r5 r6 r� ru r7 re r| r� �endswith�isupperr- r2 )ry rf r~ r� Zmatching�patternr r r r� � s& r� Fc C s� g }x�| � � dk r�| � � dkr0|dd� | D � S | � � �d�rN|t| |�7 }q| � � �d�rx| � � dkrx|t| |�7 }q|r�|dd� | D � S |�td| �� �� qW |S )z�Parse command-line argument vector. If options_first: argv ::= [ long | shorts ]* [ argument ]* [ '--' [ argument ]* ] ; else: argv ::= [ long | shorts | argument ]* [ '--' [ argument ]* ] ; Nz--c S s g | ]}t d |��qS )N)r- )r& �vr r r r' � s z parse_argv.<locals>.<listcomp>rb c S s g | ]}t d |��qS )N)r- )r& r� r r r r' � s )rw re r| r� r; r- rv )ry rf � options_firstr r r r � parse_argv� s r� c C sN t �d| �dd � }dd� t|d d d� |dd d� �D �}dd� |D �}|S )Nz *(<\S+?>|-\S+?)r( c S s g | ]\}}|| �qS r r )r& �s1�s2r r r r' � s z"parse_defaults.<locals>.<listcomp>r9 c S s g | ]}|� d �rt�|��qS )rb )re r. r[ )r& ri r r r r' � s )rV r1 �zip)�docr1 rf r r r �parse_defaults� s (r� c C sV t �d| �}t|�dk r td��t|�dkr4td��t �dd�|dd � ��d �� S ) Nz([Uu][Ss][Aa][Gg][Ee]:)� z&"usage:" (case-insensitive) not found.z*More than one "usage:" (case-insensitive).z\n\s*\nr r( r )rV r1 rm r rQ r )r� Z usage_splitr r r �printable_usage� s r� c s8 | � � dd � � dd�� fdd�� dd � D �� d S )Nr( z( r` c 3 s" | ]}|� d krdn|V qdS )r z) | (Nr )r& ri )�pur r rP � s z formal_usage.<locals>.<genexpr>z ))r1 rQ )r� r )r� r � formal_usage� s r� c C sV | r,t dd� |D ��r,t|�d�� t�� |rRt dd� |D ��rRt|� t�� d S )Nc s s | ]}|j d ko|jV qdS ))z-hz--helpN)rC r0 )r& rx r r r rP � s zextras.<locals>.<genexpr>r c s s | ]}|j d ko|jV qdS )z --versionN)rC r0 )r& rx r r r rP � s )�any�printr �sys�exit)�help�versionrf r� r r r �extras� s r� c @ s e Zd Zdd� ZdS )�Dictc C s dd� dd� t| �� �D �� S )Nz{%s}z, c s s | ]}d | V qdS )z%r: %rNr )r& r$ r r r rP � s z Dict.__repr__.<locals>.<genexpr>)rQ �sorted�items)r r r r rE � s z Dict.__repr__N)r r r rE r r r r r� � s r� Tc C s� |dkrt jdd� }t| �t_t| �}tttj�|�}tt |t�t |�|�}t |� t ��}x,|� t�D ] }t| �} t t | �| �|_qhW t|||| � |�� �|�\} } } | r�| g kr�tdd� |� � | D ��S t� �dS )a� Parse `argv` based on command-line interface described in `doc`. `docopt` creates your command-line interface based on its description that you pass as `doc`. Such description can contain --options, <positional-argument>, commands, which could be [optional], (required), (mutually | exclusive) or repeated... Parameters ---------- doc : str Description of your command-line interface. argv : list of str, optional Argument vector to be parsed. sys.argv[1:] is used if not provided. help : bool (default: True) Set to False to disable automatic help on -h or --help options. version : any object If passed, the object will be printed if --version is in `argv`. options_first : bool (default: False) Set to True to require options preceed positional arguments, i.e. to forbid options and positional arguments intermix. Returns ------- args : dict A dictionary, where keys are names of command-line elements such as e.g. "--verbose" and "<path>", and values are the parsed values of those elements. Example ------- >>> from docopt import docopt >>> doc = ''' Usage: my_program tcp <host> <port> [--timeout=<seconds>] my_program serial <port> [--baud=<n>] [--timeout=<seconds>] my_program (-h | --help | --version) Options: -h, --help Show this screen and exit. --baud=<n> Baudrate [default: 9600] ''' >>> argv = ['tcp', '127.0.0.1', '80', '--timeout', '30'] >>> docopt(doc, argv) {'--baud': '9600', '--help': False, '--timeout': '30', '--version': False, '<host>': '127.0.0.1', '<port>': '80', 'serial': False, 'tcp': True} See also -------- * For video introduction see http://docopt.org * Full documentation is available in README.rst as well as online at https://github.com/docopt/docopt#readme Nr( c s s | ]}|j |jfV qd S )N)rC r0 )r& rF r r r rP B s zdocopt.<locals>.<genexpr>)r� �argvr� r r r� r� r� r� rt r r r r. r7 r r� r rM r� ) r� r� r� r� r� rf r� Zpattern_optionsZaoZ doc_optionsrj rJ rK r r r r � s ? )F)NTNF)%r r� rV �__all__� __version__� Exceptionr r r �objectr rB rO r- r2 r. r5 r6 r7 r8 r4 r rt r| r� r� r� r� r� r� r� r� r� r� �dictr� r r r r r �<module> s> K!( !#