File: //usr/local/lib/python3.9/site-packages/click/__pycache__/parser.cpython-39.pyc
a
X>h{J � @ s~ d Z ddlZddlmZ ddlmZ ddlmZ ddlm Z ddlm
Z
dd lm Z dd
lm Z ej
r�ddlZdd lmZ dd lmZ dd
lmZ ddlmZ e�d�Ze� Zej e ej e ej ej ej e ej ej!e df ej"e f d�dd�Z#e ej e e f d�dd�Z$e ej!d e d�dd�Z%e ej"e d�dd �Z&G d d � d �ZG d d � d �ZG d!d"� d"�Z'G d#d$� d$�Z(dS )%a;
This module started out as largely a copy paste from the stdlib's
optparse module with the features removed that we do not need from
optparse because we implement them in Click on a higher level (for
instance type handling, help formatting and a lot more).
The plan is to remove more and more from here over time.
The reason this is a different module and not optparse from the stdlib
is that there are differences in 2.x and 3.x about the error messages
generated and optparse in the stdlib uses gettext for no good reason
and might cause us issues.
Click uses parts of optparse written by Gregory P. Ward and maintained
by the Python Software Foundation. This is limited to code in parser.py.
Copyright 2001-2006 Gregory P. Ward. All rights reserved.
Copyright 2002-2006 Python Software Foundation. All rights reserved.
� N)�deque)�gettext)�ngettext� )�BadArgumentUsage)�BadOptionUsage)� NoSuchOption)�
UsageError)�Argument)�Context)�Option)� Parameter�V)�args�
nargs_spec�returnc s t ���t |�}g }d�dtjt d��fdd� � |r̈ |�}|du rHq2|dkr`|�� ��� q2|dkr�� �fdd�t|�D �}�dur�|�� |�t|�� q2|d k r2�dur�td
��t |��|�d� q2�du�rt��|�< g �t
|�d d� �|�d d�< t|�t ��fS ) a� Given an iterable of arguments and an iterable of nargs specifications,
it returns a tuple with all the unpacked arguments at the first index
and all remaining arguments as the second.
The nargs specification is the number of arguments that should be consumed
or `-1` to indicate that this position should eat up all the remainders.
Missing items are filled with `None`.
Nz te.Deque[V])�cr c s: z � d u r| � � W S | �� W S W n ty4 Y d S 0 d S �N)�popleft�pop�
IndexError)r )�spos� �6/usr/local/lib/python3.9/site-packages/click/parser.py�_fetchD s
z _unpack_args.<locals>._fetchr c s g | ] }� ���qS r r )�.0�_)r r r r �
<listcomp>V � z _unpack_args.<locals>.<listcomp>r zCannot have two nargs < 0) r �t�Optionalr �append�range�reverse�tuple� TypeError�len�reversed�list)r r �rv�nargs�xr )r r r r � _unpack_args3 s4
r, )�optr c C sT | d d� }|� � r d| fS | dd� |krD| d d� | dd � fS || dd � fS )Nr � � )�isalnum)r- �firstr r r � split_opto s r2 r )r- �ctxr c C s4 |d u s|j d u r| S t| �\}} |� |� | �� �S r )Ztoken_normalize_funcr2 )r- r3 �prefixr r r �
normalize_optx s r5 )�stringr c C sb ddl }|j | dd�}d|_d|_g }z|D ]}|�|� q,W n ty\ |�|j� Y n0 |S )a� Split an argument string as with :func:`shlex.split`, but don't
fail if the string is incomplete. Ignores a missing closing quote or
incomplete escape sequence and uses the partial token as-is.
.. code-block:: python
split_arg_string("example 'my file")
["example", "my file"]
split_arg_string("example my\")
["example", "my"]
:param string: String to split.
r NT)�posixr. )�shlex�whitespace_split�
commentersr! �
ValueError�token)r6 r8 �lex�outr< r r r �split_arg_string s r? c @ sf e Zd Zddeje eje eje eejej d�dd�Z e
e d�dd ��Z ejd
dd �d d
�Z
dS )r Nr �
CoreOption)�obj�opts�dest�actionr* �constc
C s� g | _ g | _t� | _|D ]r}t|�\}} |s<td|� d���| j�|d � t|�dkrrt| �dkrr| j �|� q| j�|� | j�|� q|d u r�d}|| _ || _
|| _ || _ || _
d S )Nz$Invalid start character for option (�)r r �store)� _short_opts�
_long_opts�set�prefixesr2 r; �addr& r! rC rD r* rE rA )
�selfrA rB rC rD r* rE r- r4 �valuer r r �__init__� s& zOption.__init__)r c C s
| j dv S )N)rG r! )rD �rM r r r � takes_value� s zOption.takes_value� ParsingState�rN �stater c C s� | j dkr||j| j< n�| j dkr2| j|j| j< n�| j dkrT|j�| jg ��|� n^| j dkrx|j�| jg ��| j� n:| j dkr�|j�| jd�d |j| j< ntd| j � d ���|j�| j � d S )
NrG � store_constr! � append_const�countr r zunknown action '�')
rD rB rC rE �
setdefaultr! �getr; �orderrA )rM rN rT r r r �process� s
zOption.process)Nr N)�__name__�
__module__� __qualname__r �Sequence�strr �int�AnyrO �property�boolrQ r\ r r r r r � s �
� !r c @ sT e Zd Zd deje ed�dd�Zejeje ej eje f ddd�d d
�Z
dS ) r
r � CoreArgument)rA rC r* c C s || _ || _|| _d S r )rC r* rA �rM rA rC r* r r r rO � s zArgument.__init__rR NrS c C s� | j dkr\|d usJ �tdd� |D ��}|t|�kr:d }n"|dkr\ttd�j| j| j d���| j dkr~| jjd ur~|dkr~d }||j | j< |j
� | j� d S ) Nr c s s | ]}|d u rdV qd S )Nr r �r r+ r r r � <genexpr>� r z#Argument.process.<locals>.<genexpr>r z'Argument {name!r} takes {nargs} values.��namer* ���r ) r* �sumr& r r �formatrC rA ZenvvarrB r[ r! )rM rN rT Zholesr r r r\ � s
�� zArgument.process)r ) r] r^ r_ r r ra rb rO �Unionr` r\ r r r r r
� s
�r
c @ s" e Zd Zeje dd�dd�ZdS )rR N)�rargsr c C s i | _ g | _|| _g | _d S r )rB �largsrp r[ )rM rp r r r rO � s zParsingState.__init__)r] r^ r_ r �Listra rO r r r r rR � s rR c @ s( e Zd ZdZd$ejd dd�dd�Zd%deje eje eje e ejej
dd �d
d �Z d&d eje e dd
�dd�Z ej
e ejejeej
f ej
e ej
d f d�dd�Zedd�dd�Zedd�dd�Zeeje edd�dd�Zeedd �d d �Zeeeej
d �d d!�Zeedd �d"d#�ZdS )'� OptionParsera+ The option parser is an internal class that is ultimately used to
parse options and arguments. It's modelled after optparse and brings
a similar but vastly simplified API. It should generally not be used
directly as the high level Click classes wrap it for you.
It's not nearly as extensible as optparse or argparse as it does not
implement features that are implemented on a higher level (such as
types or defaults).
:param ctx: optionally the :class:`~click.Context` where this parser
should go with.
Nr )r3 r c C sJ || _ d| _d| _|d ur*|j| _|j| _i | _i | _ddh| _g | _d S )NTF�-�--)r3 �allow_interspersed_args�ignore_unknown_options�
_short_opt� _long_opt�
_opt_prefixes�_args)rM r3 r r r rO
s
zOptionParser.__init__r r@ )rA rB rC rD r* rE r c sd � fdd�|D �}t ||||||d�}� j�|j� |jD ]}|� j|< q:|jD ]}|� j|< qPdS )az Adds a new option named `dest` to the parser. The destination
is not inferred (unlike with optparse) and needs to be explicitly
provided. Action can be any of ``store``, ``store_const``,
``append``, ``append_const`` or ``count``.
The `obj` can be used to identify the option in the order list
that is returned from the parser.
c s g | ]}t |� j��qS r )r5 r3 )r r- rP r r r 6 r z+OptionParser.add_option.<locals>.<listcomp>)rD r* rE N)r rz �updaterK rH rx rI ry ) rM rA rB rC rD r* rE �optionr- r rP r �
add_option% s
zOptionParser.add_optionrf )rA rC r* r c C s | j �t|||d�� dS )z�Adds a positional argument named `dest` to the parser.
The `obj` can be used to identify the option in the order list
that is returned from the parser.
)rC r* N)r{ r! r
rg r r r � add_argument> s zOptionParser.add_argument�
CoreParameter)r r c C sX t |�}z| �|� | �|� W n& tyF | jdu s@| jjsB� Y n0 |j|j|jfS )aZ Parses positional arguments and returns ``(values, args, order)``
for the parsed options and arguments as well as the leftover
arguments if there are any. The order is a list of objects as they
appear on the command line. If arguments appear multiple times they
will be memorized multiple times as well.
N) rR �_process_args_for_options�_process_args_for_argsr r3 Zresilient_parsingrB rq r[ )rM r rT r r r �
parse_argsH s
zOptionParser.parse_args)rT r c C sV t |j|j dd� | jD ��\}}t| j�D ]\}}|�|| |� q,||_g |_d S )Nc S s g | ]
}|j �qS r )r* rh r r r r \ r z7OptionParser._process_args_for_args.<locals>.<listcomp>)r, rq rp r{ � enumerater\ )rM rT Zpargsr �idx�argr r r r� Z s �z#OptionParser._process_args_for_argsc C sz |j rv|j �d�}t|�}|dkr&d S |d d� | jv rN|dkrN| �||� q | jrb|j�|� q |j �d|� d S q d S )Nr ru r ) rp r r& rz �
_process_optsrv rq r! �insert)rM rT r� Zarglenr r r r� e s z&OptionParser._process_args_for_options)r- �explicit_valuerT r c C s� || j vr2ddlm} ||| j �}t||| jd��| j | }|jrh|d urX|j�d|� | �|||�}n$|d ur�t |t
d�j |d���nd }|� ||� d S )Nr )�get_close_matches)�
possibilitiesr3 z&Option {name!r} does not take a value.)rk )
ry �difflibr� r r3 rQ rp r� �_get_value_from_stater r rn r\ )rM r- r� rT r� r� r} rN r r r �_match_long_opt� s
�z OptionParser._match_long_opt)r� rT r c C s� d}d}|d }g }|dd � D ]�}t |� |� �| j�}| j�|�} |d7 }| sp| jrb|�|� q t|| jd��| jr�|t|�k r�|j �
d||d � � d}| � || |�}
nd }
| � |
|� |r q�q | jr�|r�|j
�|� d�|�� �� d S )NFr r )r3 Tr. )r5 r3 rx rZ rw r! r rQ r& rp r� r� r\ rq �join) rM r� rT �stop�ir4 Zunknown_options�chr- r} rN r r r �_match_short_opt� s0
z OptionParser._match_short_opt)� option_namer} rT r c C s� |j }t|j�|k r@|jjr"t}q�t|tdd|�j||d���nt|dkr�|jd }|jjr�t|t �r�|d d� | j
v r�t|�dkr�t}q�|j� d�}n t |jd |� �}|jd |�= |S )Nz%Option {name!r} requires an argument.z+Option {name!r} requires {nargs} arguments.rj r r )
r* r& rp rA �_flag_needs_valuer r rn �
isinstancera rz r r$ )rM r� r} rT r* rN Z next_rargr r r r� � s: ���
���
� z"OptionParser._get_value_from_statec C s� d }d|v r |� dd�\}}n|}t|| j�}z| �|||� W nJ ty� |d d� | jvrr| �||� Y d S | jsz� |j� |� Y n0 d S )N�=r r/ )
�splitr5 r3 r� r rz r� rw rq r! )rM r� rT r� Zlong_optZ
norm_long_optr r r r� � s zOptionParser._process_opts)N)Nr N)r )r] r^ r_ �__doc__r r rO r` ra rb rc r~ r rr �Tuple�Dictr� rR r� r� r� r� r r� r� r r r r rs � s@
�
� � � &� % � )� &rs ))r� �typingr � collectionsr r r r �
exceptionsr r r r �
TYPE_CHECKINGZtyping_extensions�te�corer
rf r r r@ r
r� �TypeVarr �objectr� r` ra rb r� ro r rr r, r2 r5 r? rR rs r r r r �<module> s4
0� < "6