Server : Apache/2.4.52 (Ubuntu) System : Linux webserver 6.8.0-49-generic #49~22.04.1-Ubuntu SMP PREEMPT_DYNAMIC Wed Nov 6 17:42:15 UTC 2 x86_64 User : www-data ( 33) PHP Version : 8.1.2-1ubuntu2.21 Disable Function : NONE Directory : /lib/python3/dist-packages/click/__pycache__/ |
o
�+cadJ � @ s� d Z ddlZddlmZ ddlmZ ddlmZ ddlm Z ddlm
Z
dd lm Z dd
lm Z ej
rOddlZdd lmZ dd lmZ dd
lmZ ddlmZ e�d�Ze� Zdej e dej e dej ej ej e ej ej!e df ej"e f fdd�Z#de dej e e f fdd�Z$de dej!d de fdd�Z%d e dej"e fd d �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�dddtjt f�fdd� � |rh� |�}|du r%q|dkr1|�� ��� n5|dkrQ� �fdd �t|�D �}�durI|�� |�t|�� n|d
k rf�dur]td ��t |��|�d� |s �dur�t��|�< 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`.
N�cz te.Deque[V]r c s2 z� d u r
| � � W S | �� W S ty Y d S w �N)�popleft�pop�
IndexError)r )�spos� �./usr/lib/python3/dist-packages/click/parser.py�_fetchB s
�z _unpack_args.<locals>._fetchr c s g | ]}� ���qS r r )�.0�_)r r r r �
<listcomp>T s 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_args1 s6
� r+ �optc C sT | d d� }|� � rd| fS | dd� |kr"| d d� | dd � fS || dd � fS )Nr � � )�isalnum)r, �firstr r r � split_optm s r1 �ctxr c C s4 |d u s |j d u r | S t| �\}} |� |� | �� �S r )�token_normalize_funcr1 )r, r2 �prefixr r r �
normalize_optv s r5 �stringc C sb ddl }|j | dd�}d|_d|_g }z
|D ]}|�|� qW |S ty0 |�|j� Y |S w )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 @ sx e Zd Z ddddeje deje deje ded ejej f d
d �Z e
d e fd
d��Z deddd dfdd�Z
dS )r Nr �obj�
CoreOption�opts�dest�actionr) �constc
C s� g | _ g | _t� | _|D ]9}t|�\}} |s td|� d���| j�|d � t|�dkr9t| �dkr9| j �|� q | j�|� | j�|� q |d u rLd}|| _ || _
|| _ || _ || _
d S )Nz$Invalid start character for option (�)r r �store)� _short_opts�
_long_opts�set�prefixesr1 r; �addr% r rC rD r) rE r@ )
�selfr@ 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_valuerN �state� ParsingStatec C s� | j dkr ||j| j< nM| j dkr| j|j| j< n@| j dkr*|j�| jg ��|� n/| j dkr<|j�| jg ��| j� n | j dkrP|j�| jd�d |j| j< n td| j � d ���|j�| j � d S )
NrG � store_constr � append_const�countr r zunknown action '�')
rD rB rC rE �
setdefaultr �getr; �orderr@ )rM rN rR 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 @ s\ e Zd Zddddeje defdd�Zdejeje ej eje f d d
d d fd
d�Z
d S )r
r r@ � CoreArgumentrC r) c C s || _ || _|| _d S r )rC r) r@ �rM r@ rC r) r r r rO � s
zArgument.__init__rN rR rS r Nc C s� | j dkr.|d us J �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>� s � z#Argument.process.<locals>.<genexpr>r z'Argument {name!r} takes {nargs} values.��namer) ���r ) r) �sumr% r r �formatrC r@ �envvarrB rZ r )rM rN rR �holesr 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 Zdeje ddfdd�ZdS )rS �rargsr Nc C s i | _ g | _|| _g | _d S r )rB �largsrs rZ )rM rs r r r rO � s
zParsingState.__init__)r] r^ r_ r �Listra rO r r r r rS � s rS c @ s^ e Zd ZdZd+dejd ddfdd�Z d,d d
d eje d eje d
eje de dejej
ddfdd�Z d-d dd eje de ddfdd�Z dej
e dejejeej
f ej
e ej
d f fdd�Zdeddfdd�Zdeddfd d �Zd ed eje deddfd d!�Zd"ededdfd#d$�Zd%ed&ededej
fd'd(�Zd"ededdfd)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.
Nr2 r r c C sJ || _ d| _d| _|d ur|j| _|j| _i | _i | _ddh| _g | _d S )NTF�-�--)r2 �allow_interspersed_args�ignore_unknown_options�
_short_opt� _long_opt�
_opt_prefixes�_args)rM r2 r r r rO s
zOptionParser.__init__r r@ rA rB rC rD r) rE c sd � fdd�|D �}t ||||||d�}� j�|j� |jD ]}|� j|< q |jD ]}|� j|< q(dS )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 r2 )r r, rP r r r 4 s z+OptionParser.add_option.<locals>.<listcomp>)rD r) rE N)r r} �updaterK rH r{ rI r| ) rM r@ rB rC rD r) rE �optionr, r rP r �
add_option# s
�zOptionParser.add_optionrf 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_argumentr �
CoreParameterc C sX t |�}z | �|� | �|� W n ty# | jdu s | jjs!� Y nw |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) rS �_process_args_for_options�_process_args_for_argsr r2 �resilient_parsingrB rt rZ )rM r rR r r r �
parse_argsF s
��zOptionParser.parse_argsrR 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 Z s z7OptionParser._process_args_for_args.<locals>.<listcomp>)r+ rt rs r~ � enumerater[ )rM rR �pargsr �idx�argr r r r� X s �
z#OptionParser._process_args_for_argsc C s� |j r?|j �d�}t|�}|dkrd S |d d� | jv r'|dkr'| �||� n| jr1|j�|� n |j �d|� d S |j sd S d S )Nr rx r ) rs r r% r} �
_process_optsry rt r �insert)rM rR r� �arglenr r r r� c s �z&OptionParser._process_args_for_optionsr, �explicit_valuec C s� || j vrddlm} ||| j �}t||| jd��| j | }|jr4|d ur,|j�d|� | �|||�}n|d urCt |t
d�j |d���d }|� ||� d S )Nr )�get_close_matches)�
possibilitiesr2 z&Option {name!r} does not take a value.)rk )
r| �difflibr� r r2 rQ rs r� �_get_value_from_stater r rn r[ )rM r, r� rR r� r� r� rN r r r �_match_long_opt� s
�z OptionParser._match_long_optr� c C s� d}d}|d }g }|dd � D ]R}t |� |� �| j�}| j�|�} |d7 }| s8| jr1|�|� qt|| jd��| jrV|t|�k rN|j �
d||d � � d}| � || |�}
nd }
| � |
|� |rb nq| jrw|ry|j
�|� d�|�� �� d S d S d S )NFr r )r2 Tr- )r5 r2 r{ rY rz r r rQ r% rs r� r� r[ rt �join) rM r� rR �stop�ir4 �unknown_options�chr, r� rN r r r �_match_short_opt� s4
�
�z OptionParser._match_short_opt� option_namer� c C s� |j }t|j�|k r |jjrt}|S t|tdd|�j||d���|dkrM|jd }|jjrEt|t �rE|d d� | j
v rEt|�dkrEt}|S |j� d�}|S t |jd |� �}|jd |�= |S )Nz%Option {name!r} requires an argument.z+Option {name!r} requires {nargs} arguments.rj r r )
r) r% rs r@ �_flag_needs_valuer r rn �
isinstancera r} r r# )rM r� r� rR r) rN � next_rargr r r r� � s< ����
�� �� z"OptionParser._get_value_from_statec C s� d }d|v r|� dd�\}}n|}t|| j�}z
| �|||� W d S tyG |d d� | jvr:| �||� Y d S | js>� |j� |� Y d S w )N�=r r. )
�splitr5 r2 r� r r} r� rz rt r )rM r� rR r� �long_opt�
norm_long_optr r r r� � s �zOptionParser._process_optsr r\ rq )r] r^ r_ �__doc__r r rO r` ra rb rc r� r� ru �Tuple�Dictr� rS r� r� r� r� r r� r� r r r r rv � st
������
�
�����
�
�&
� $���
� (���
�&rv ))r� �typingr � collectionsr r r r �
exceptionsr r r r �
TYPE_CHECKING�typing_extensions�te�corer
rf r r rA r
r� �TypeVarr �objectr� r` ra rb r� rr r ru r+ r1 r5 r? rS rv r r r r �<module> s>
��0
� < "6