o (j6h#J@s"dZddlmZddlmZddlZddlm Z ddl m Z ddl m Z ddl mZdd l mZdd l mZdd l mZejrWdd lmZdd lmZddlmZddlmZedZeZd.ddZd/ddZ d0d d!Z!Gd"d#d#Z"Gd$d%d%Z#Gd&d'd'Z$Gd(d)d)Z%d1d,d-Z&dS)2a; 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. ) annotationsN)deque)gettext)ngettext)BadArgumentUsage)BadOptionUsage) NoSuchOption) UsageError)Argument)Context)Option) ParameterVargscabc.Sequence[str] nargs_speccabc.Sequence[int]returnGtuple[cabc.Sequence[str | cabc.Sequence[str | None] | None], list[str]]cs tt|}g}dd fdd |ra|}|durq|dkr*|n5|dkrJfd d t|D}durB||t|n|d kr_durVtd t||d|sdur}t|<gt|dd|dd<t|tfS)aGiven 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`. Ncdeque[V]rV | Nonecs2zdur |WS|WStyYdSwN)popleftpop IndexError)r)spos[/var/www/html/chefvision.cloud.itp360.com/venv/lib/python3.10/site-packages/click/parser.py_fetchEs   z_unpack_args.._fetchrcsg|]}qSrr).0_)r rrr Wsz _unpack_args..rzCannot have two nargs < 0)rrrr) rappendrangereversetuple TypeErrorlenreversedlist)rrrvnargsxr)r rrr _unpack_args4s6     r/optstrtuple[str, str]cCsT|dd}|rd|fS|dd|kr"|dd|ddfS||ddfS)Nr)isalnum)r0firstrrr _split_optps r7ctxContext | NonecCs4|dus |jdur |St|\}}|||Sr)token_normalize_funcr7)r0r8prefixrrr_normalize_optys r<c@s6eZdZ   ddddZedddZdddZdS)_OptionNrobj CoreOptionoptsrdest str | Noneactionr-intconst t.Any | Nonec Csg|_g|_t|_|D]9}t|\}} |std|d|j|dt|dkr9t| dkr9|j|q |j||j|q |durLd}||_ ||_ ||_ ||_ ||_ dS)Nz$Invalid start character for option ()rrstore) _short_opts _long_optssetprefixesr7 ValueErroraddr)r$rArCr-rEr>) selfr>r@rArCr-rEr0r;valuerrr__init__s&    z_Option.__init__rboolcCs |jdvS)N)rHr$)rCrOrrr takes_values z_Option.takes_valuerPt.Anystate _ParsingStateNonecCs|jdkr ||j|j<nM|jdkr|j|j|j<n@|jdkr*|j|jg|n/|jdkr<|j|jg|jn|jdkrP|j|jdd|j|j<n td|jd |j|j dS) NrH store_constr$ append_constcountrrzunknown action '') rCr@rArE setdefaultr$getrMorderr>)rOrPrVrrrprocesss     z_Option.processNrN) r>r?r@rrArBrCrBr-rDrErF)rrR)rPrUrVrWrrX)__name__ __module__ __qualname__rQpropertyrTr`rrrrr=s ! r=c@s"eZdZdddd ZdddZdS) _Argumentrr> CoreArgumentrArBr-rDcCs||_||_||_dSr)rAr-r>rOr>rAr-rrrrQs z_Argument.__init__rP&str | cabc.Sequence[str | None] | NonerVrWrrXcCs|jdkr.|dus Jtdd|D}|t|krd}n|dkr.ttdj|j|jd|jdkr?|jjdur?|dkr?d}||j |j<|j |jdS) Nrcss|] }|durdVqdS)Nrrr!r.rrr sz$_Argument.process..rz'Argument {name!r} takes {nargs} values.namer-r) r-sumr)rr"formatrAr>envvarr@r_r$)rOrPrVholesrrrr`s    z_Argument.processNr)r>rgrArBr-rD)rPrirVrWrrX)rbrcrdrQr`rrrrrfs rfc@seZdZdddZdS) rWrargs list[str]rrXcCsi|_g|_||_g|_dSr)r@largsrtr_)rOrtrrrrQs z_ParsingState.__init__N)rtrurrX)rbrcrdrQrrrrrWsrWc@seZdZdZd5d6ddZ  d7d8ddZd9d:ddZd;ddZdd+d,Z d?d1d2Z d>d3d4Z dS)@ _OptionParserajThe 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. .. deprecated:: 8.2 Will be removed in Click 9.0. Nr8r9rrXcCsJ||_d|_d|_|dur|j|_|j|_i|_i|_ddh|_g|_dS)NTF---)r8allow_interspersed_argsignore_unknown_options _short_opt _long_opt _opt_prefixes_args)rOr8rrrrQs  z_OptionParser.__init__rr>r?r@rrArBrCr-rDrErFc sdfdd|D}t||||||d}j|j|jD]}|j|<q|jD]}|j|<q(dS)azAdds 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. csg|]}t|jqSr)r<r8)r!r0rSrrr#sz,_OptionParser.add_option..)rCr-rEN)r=r~updaterLrIr|rJr}) rOr>r@rArCr-rEoptionr0rrSr add_options    z_OptionParser.add_optionrgcCs|jt|||ddS)zAdds 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. )rAr-N)rr$rfrhrrr add_argument sz_OptionParser.add_argumentrru7tuple[dict[str, t.Any], list[str], list[CoreParameter]]cCsXt|}z ||||Wnty#|jdus |jjs!Ynw|j|j|jfS)aZParses 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) rW_process_args_for_options_process_args_for_argsr r8resilient_parsingr@rvr_)rOrrVrrr parse_args(s   z_OptionParser.parse_argsrVrWcCsVt|j|jdd|jD\}}t|jD] \}}||||q||_g|_dS)NcSsg|]}|jqSr)r-rjrrrr#<sz8_OptionParser._process_args_for_args..)r/rvrtr enumerater`)rOrVpargsridxargrrrr:s z$_OptionParser._process_args_for_argscCs|jr?|jd}t|}|dkrdS|dd|jvr'|dkr'|||n|jr1|j|n |jd|dS|jsdSdS)Nrryr) rtrr)r~ _process_optsrzrvr$insert)rOrVrarglenrrrrEs z'_OptionParser._process_args_for_optionsr0r1explicit_valuecCs||jvrddlm}|||j}t|||jd|j|}|jr4|dur,|jd|||||}n|durCt |t dj |dd}| ||dS)Nr)get_close_matches) possibilitiesr8z&Option {name!r} does not take a value.)rm) r}difflibrr r8rTrtr_get_value_from_staterr"rpr`)rOr0rrVrrrrPrrr_match_long_optis    z_OptionParser._match_long_optrc Csd}d}|d}g}|ddD]R}t|||j}|j|} |d7}| s8|jr1||qt||jd| jrV|t|krN|j d||dd}| || |} nd} | | ||rbnq|jrw|ry|j |d|dSdSdS)NFrr)r8Tr3)r<r8r|r^r{r$r rTr)rtrrr`rvjoin) rOrrVstopir;unknown_optionschr0rrPrrr_match_short_opts4     z_OptionParser._match_short_opt option_namerr=rUcCs|j}t|j|kr |jjrt}|St|tdd|j||d|dkrM|jd}|jjrEt|t rE|dd|j vrEt|dkrEt}|S|j d}|St |jd|}|jd|=|S)Nz%Option {name!r} requires an argument.z+Option {name!r} requires {nargs} arguments.rlrr) r-r)rtr>_flag_needs_valuerrrp isinstancer1r~rr')rOrrrVr-rP next_rargrrrrs<    z#_OptionParser._get_value_from_statecCsd}d|vr|dd\}}n|}t||j}z ||||WdStyG|dd|jvr:|||YdS|js>|j |YdSw)N=rr4) splitr<r8rr r~rr{rvr$)rOrrVrlong_opt norm_long_optrrrrs   z_OptionParser._process_optsr)r8r9rrXra)r>r?r@rrArBrCrBr-rDrErFrrXrs)r>rgrArBr-rDrrX)rrurr)rVrWrrX)r0r1rrBrVrWrrX)rr1rVrWrrX)rr1rr=rVrWrrU)rbrcrd__doc__rQrrrrrrrrrrrrrrws     $  (&rwrmobjectcCshddl}|dvr|jd|dtddtd|S|dkr0d d lm}|jd tdd|St|) Nr>r r split_opt OptionParser ParsingState normalize_optz'parser.z\' is deprecated and will be removed in Click 9.0. The old parser is available in 'optparse'.r4) stacklevelr"split_arg_stringr)rzpImporting 'parser.split_arg_string' is deprecated, it will only be available in 'shell_completion' in Click 9.0.)warningswarnDeprecationWarningglobalsshell_completionrAttributeError)rmrrrrr __getattr__s"  r)rrrrrr)r0r1rr2)r0r1r8r9rr1)rmr1rr)'r __future__rcollections.abcabccabctypingt collectionsrrr"r exceptionsrrr r TYPE_CHECKINGcorer rgr r r?r CoreParameterTypeVarrrrr/r7r<r=rfrWrwrrrrrs8                < 6