U
|
ß=®d{J ã @ s~ d Z ddlZddlmZ ddlmZ ddlmZ ddlm Z ddlm
|
Z
|
dd lm Z dd
|
lm Z ej rddlZdd lmZ dd lmZ dd lmZ ddlmZ e d¡Ze Zej e ej e ej ej ej e ej ej!e df ej"e f dddZ#e ej e e f dddZ$e ej!d e dddZ%e ej"e ddd 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 }ddtjt dfdd |rÌ |}|dkrHq2|dkr`| ¡ q2|dkr fddt|D }dk r| ¡ | t|¡ q2|d k r2dk r¸td
|
t || d¡ q2dk 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 kr| ¡ W S | ¡ W S W n tk
|
r6 Y d S X d S ©N)ÚpopleftÚpopÚ
|
IndexError)r )Úspos© úCd:\z\workplace\vscode\pyvenv\venv\Lib\site-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 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_optm s r1 r )r, Úctxr c C s4 |d ks|j d kr| S t| \}} | | | ¡ S r )Ztoken_normalize_funcr1 )r, r2 Úprefixr r r Ú normalize_optv s r4 )Ústringr c C sd ddl }|j | dd}d|_d|_g }z|D ]}| |¡ q,W n tk
|
r^ | |j¡ Y nX |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)r5 r7 ÚlexÚoutr; r r r Úsplit_arg_string} s r> c @ sf e Zd Zddeje eje eje eejej dddZ e
|
e ddd 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 krd}|| _ || _
|
|| _ || _ || _ d S )Nz$Invalid start character for option (ú)r r Ústore)Ú _short_optsÚ
|
_long_optsÚsetÚprefixesr1 r: Úaddr% r rB rC r) rD r@ )
|
Úselfr@ rA rB rC r) rD r, r3 Úvaluer r r Ú__init__ s& zOption.__init__)r c C s
|
| j dkS )N)rF r )rC ©rL r r r Ú takes_valueÁ s zOption.takes_valueÚ ParsingState©rM Ú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 )
|
NrF Ú store_constr Ú append_constÚcountr r zunknown action 'ú')
|
rC rA rB rD Ú
|
setdefaultr Úgetr: Úorderr@ )rL rM rS r r r ÚprocessÅ s
|
|
|
|
|
zOption.process)Nr N)Ú__name__Ú
|
__module__Ú __qualname__r ÚSequenceÚstrr ÚintÚAnyrN ÚpropertyÚboolrP r[ r r r r r s ù
|
ù !r c @ sT e Zd Zd deje edddZejeje ej eje f dddd d
|
Z
|
dS ) r
|
r Ú CoreArgument)r@ rB r) c C s || _ || _|| _d S r )rB r) r@ ©rL r@ rB r) r r r rN Ö s zArgument.__init__rQ NrR c C s | j dkr\|d k sttdd |D }|t|kr:d }n"|dkr\ttdj| j| j d| j dkr~| jj d k r~|dkr~d }||j
|
| j< |j | j¡ d S ) Nr c s s | ]}|d krdV 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) ÚAssertionErrorÚsumr% r r ÚformatrB r@ ZenvvarrA rZ r )rL rM rS Zholesr r r r[ Û s
|
ÿÿ zArgument.process)r ) r\ r] r^ r r r` ra rN ÚUnionr_ r[ r r r r r
|
Õ s
|
ür
|
c @ s" e Zd Zeje ddddZdS )rQ N)Úrargsr c C s i | _ g | _|| _g | _d S r )rA Úlargsrp rZ )rL rp r r r rN ö s zParsingState.__init__)r\ r] r^ r ÚListr` rN r r r r rQ õ s rQ c @ s( e Zd ZdZd$ejd ddddZd%deje eje eje e ejej
|
dd d
|
d Z d&d eje e dd ddZ ej e ejejeej
|
f ej e ej d f dddZeddddZeddddZeeje eddddZeedd 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 )r2 r c C sJ || _ d| _d| _|d k r*|j| _|j| _i | _i | _ddh| _g | _d S )NTFú-ú--)r2 Úallow_interspersed_argsÚignore_unknown_optionsÚ
|
_short_optÚ _long_optÚ _opt_prefixesÚ_args)rL r2 r r r rN s
|
zOptionParser.__init__r r? )r@ rA rB rC r) rD 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 | jqS r )r4 r2 )r r, rO r r r 4 s z+OptionParser.add_option.<locals>.<listcomp>)rC r) rD N)r rz ÚupdaterJ rG rx rH ry ) rL r@ rA rB rC r) rD Úoptionr, r rO r Ú
|
add_option# s
|
|
zOptionParser.add_optionre )r@ rB 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.
|
)rB r) N)r{ r r
|
rf r r r Ú add_argument< s zOptionParser.add_argumentÚ CoreParameter)r r c C sZ t |}z| |¡ | |¡ W n( tk
|
rH | jdksB| jjsD Y nX |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) rQ Ú_process_args_for_optionsÚ_process_args_for_argsr r2 Zresilient_parsingrA rq rZ )rL r rS r r r Ú
|
parse_argsF s
|
zOptionParser.parse_args)rS r c C sV t |j|j dd | jD \}}t| jD ]\}}| || |¡ q,||_g |_d S )Nc S s g | ]
|
}|j qS r )r) rg r r r r Z s z7OptionParser._process_args_for_args.<locals>.<listcomp>)r+ rq rp r{ Ú enumerater[ )rL rS Zpargsr ÚidxÚargr r r r X s
|
ÿz#OptionParser._process_args_for_argsc C sz |j rv|j d¡}t|}|dkr&d S |d d
| jkrN|dkrN| ||¡ q | jrb|j |¡ q |j d|¡ d S q d S )Nr ru r ) rp r r% rz Ú _process_optsrv rq r Úinsert)rL rS r Zarglenr r r r c s z&OptionParser._process_args_for_options)r, Úexplicit_valuerS r c C s || j kr2ddlm} ||| j }t||| jd| j | }|jrh|d k rX|j d|¡ | |||¡}n$|d k rt |t
|
dj |dnd }| ||¡ d S )Nr )Úget_close_matches)Ú possibilitiesr2 z&Option {name!r} does not take a value.)rj ) ry Údifflibr r r2 rP rp r Ú_get_value_from_stater r rn r[ )rL r, r rS r r r} rM r r r Ú_match_long_opt s
|
|
ÿz OptionParser._match_long_opt)r rS 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 )r2 Tr- )r4 r2 rx rY rw r r rP r% rp r r r[ rq Újoin) rL r rS ÚstopÚir3 Zunknown_optionsÚchr, r} rM r r r Ú_match_short_opt¥ s0
|
|
z OptionParser._match_short_opt)Ú option_namer} rS r c C s¸ |j }t|j|k r@|jjr"t}q´t|tdd|j||dnt|dkr|jd }|jjrt|t r|d d
| j
|
krt|dkrt}q´|j d¡}n t |jd |
}|jd |
= |S )Nz%Option {name!r} requires an argument.z+Option {name!r} requires {nargs} arguments.ri r r ) r) r% rp r@ Ú_flag_needs_valuer r rn Ú
|
isinstancer` rz r r# )rL r r} rS r) rM Z next_rargr r r r Í s< ý üþ
|
ÿþý
|
ü z"OptionParser._get_value_from_statec C s d }d|kr | dd¡\}}n|}t|| j}z| |||¡ W nL tk
|
r |d d
| jkrt| ||¡ Y d S | js| |j |¡ Y nX d S )Nú=r r. )
|
Úsplitr4 r2 r r rz r rw rq r )rL r rS r Zlong_optZ norm_long_optr r r r ó s zOptionParser._process_opts)N)Nr N)r )r\ r] r^ Ú__doc__r r rN r_ r` ra rb r~ r rr ÚTupleÚDictr rQ r r r r r r r r r r r rs ý sL ù
|
ø ÿ þ &þ % þ ) þ &rs ))r Útypingr Ú collectionsr r r r Ú
|
exceptionsr r r r Ú TYPE_CHECKINGZtyping_extensionsÚteÚcorer
|
re r r r? r r ÚTypeVarr Úobjectr r_ r` ra r ro r rr r+ r1 r4 r> rQ rs r r r r Ú<module> s6
|
0þ < "6
|
