a !fR@sddlZddlZddlZddlZddlmZddlmZddlmZddlmZddlm Z ddlm Z ddlm Z dd lm Z dd lm Z dd lmZdd lmZdd lmZddlmZddlZddlmZddlmZddlmZddlmZddlmZddlmZerddlmZdZeGdddZ Gddde!Z"GdddZ#GdddZ$Gdd d ej%Z&Gd!d"d"ej'Z(dS)#N)gettext)Any)Callable)cast)Dict)List)Mapping)NoReturn)Optional)Sequence)Tuple) TYPE_CHECKING)Union)final) UsageError)ARGUMENT_PERCENT_DEFAULT)ARGUMENT_TYPE_STR)ARGUMENT_TYPE_STR_CHOICE)check_ispytest)LiteralZ file_or_dirc@sheZdZUdZdZeeed<d(ddeeeedgdfe dddd Z ddd d d Z d)eeeeddddZ ee ddddZd*eeedfeejejdddZddddZd+eeedfejeejeedddZd,eeedfeejejdd d!Zd-eeedfeejeejeefdd"d#Zd.eeed$e dd%d&d'ZdS)/ParserzParser for command line arguments and ini-file values. :ivar extra_info: Dict of generic param -> value to display in case there's an error processing the command line arguments. NprogF _ispytestArgument)usage processoptrreturncCs@t|td|dd|_g|_||_||_i|_g|_i|_dS)NzCustom optionsTparserr) r OptionGroup _anonymous_groups _processopt_usage_inidict _ininames extra_info)selfrrrr)Z/var/www/html/python-backend/venv/lib/python3.9/site-packages/_pytest/config/argparsing.py__init__+szParser.__init__)optionrcCs|jr|jr||dSN)r#dest)r(r,r)r)r* processoption;szParser.processoptionr )name descriptionafterrcCsj|jD]}|j|kr|Sqt|||dd}d}t|jD]\}}|j|kr<qTq<|j|d||S)aGet (or create) a named option Group. :param name: Name of the option group. :param description: Long description for --help output. :param after: Name of another group, used for ordering --help output. :returns: The option group. The returned group object has an ``addoption`` method with the same signature as :func:`parser.addoption ` but will be shown in the respective group in the output of ``pytest --help``. Trr)r"r1r enumerateinsert)r(r1r2r3groupigrpr)r)r*getgroup@s    zParser.getgroupoptsattrsrcOs|jj|i|dS)a!Register a command line option. :param opts: Option names, can be short or long options. :param attrs: Same attributes as the argparse library's :py:func:`add_argument() ` function accepts. After command line parsing, options are available on the pytest config object via ``config.option.NAME`` where ``NAME`` is usually set by passing a ``dest`` attribute, for example ``addoption("--long", dest="NAME", ...)``. N)r! addoption)r(r<r=r)r)r*r>ZszParser.addoptionzos.PathLike[str]args namespacercCs>ddlm}||_||jdd|D}|jj||dS)Nr)try_argcompletecSsg|]}t|qSr)osfspath.0xr)r)r* sz Parser.parse..rA)_pytest._argcompleterB _getparser optparser parse_args)r(r@rArBstrargsr)r)r*parsejs    z Parser.parseMyOptionParserrc Csddlm}t||j|jd}|j|jg}|D]L}|jr0|jpD|j }| |}|jD]$}| }| } |j |i| qVq0|j tdd} || _|S)Nr)filescompleter)r*)nargs)rLrTrRr'rr"r!optionsr2r1add_argument_groupnamesr= add_argument FILE_OR_DIRZ completer) r(rTrNgroupsr7descZarggroupr,naZfile_or_dir_argr)r)r*rMvs    zParser._getparser)r@r,rArcCsB|j||d}|jD]\}}t|||qtttt|tS)NrK) rQ__dict__itemssetattrrrstrgetattrr[)r(r@r,rAZ parsedoptionr1valuer)r)r*parse_setoptionszParser.parse_setoptioncCs|j||ddS)zbParse the known arguments at this point. :returns: An argparse namespace object. rKr)parse_known_and_unknown_args)r(r@rAr)r)r*parse_known_argss zParser.parse_known_argscCs$|}dd|D}|j||dS)aParse the known arguments at this point, and also return the remaining unknown arguments. :returns: A tuple containing an argparse namespace object for the known arguments, and a list of the unknown arguments. cSsg|]}t|qSr)rCrFr)r)r*rIrJz7Parser.parse_known_and_unknown_args..rK)rMrh)r(r@rArNrPr)r)r*rgs z#Parser.parse_known_and_unknown_argszBLiteral['string', 'paths', 'pathlist', 'args', 'linelist', 'bool'])r1helptypedefaultrcCs,|dvs J|||f|j|<|j|dS)aRegister an ini-file option. :param name: Name of the ini-variable. :param type: Type of the variable. Can be: * ``string``: a string * ``bool``: a boolean * ``args``: a list of strings, separated as in a shell * ``linelist``: a list of strings, separated by line breaks * ``paths``: a list of :class:`pathlib.Path`, separated as in a shell * ``pathlist``: a list of ``py.path``, separated as in a shell .. versionadded:: 7.0 The ``paths`` variable type. Defaults to ``string`` if ``None`` or not passed. :param default: Default value if no ini-file option exists but is queried. The value of ini-variables can be retrieved via a call to :py:func:`config.getini(name) `. )NstringpathsZpathlistr@ZlinelistboolN)r%r&append)r(r1rirjrkr)r)r*addinis! z Parser.addini)NN)r0N)N)N)N)N)NN)__name__ __module__ __qualname____doc__rr rc__annotations__rrnr+r/r:rr>r rargparse NamespacerQrMrrfrhr rgrpr)r)r)r*r!sp        rc@s8eZdZdZeedefddddZeddd ZdS) ArgumentErrorzURaised if an Argument instance is created with invalid or inconsistent arguments.rN)msgr,rcCs||_t||_dSr-)ryrc option_id)r(ryr,r)r)r*r+szArgumentError.__init__rScCs$|jrd|jd|jS|jSdS)Nzoption : )rzryr(r)r)r*__str__szArgumentError.__str__)rqrrrsrtrcrr+r}r)r)r)r*rxsrxc@szeZdZdZeeeedZee ddddZ e eddd Z e ee fdd d Zeedd d dZedddZdS)rzClass that mimics the necessary behaviour of optparse.Option. It's currently a least effort implementation and ignoring choices and integer prefixes. https://docs.python.org/3/library/optparse.html#optparse-standard-option-types )intrlfloatcomplexN)rYr=rc Os||_g|_g|_d|dp dvr2tjtddz |d}WntyPYnz0t|t r|dkrtjt j ||dd dt |d d |d<n&tjt j ||dd dtj||d<|d|_ n||_ z|d |_WntyYn0|||d }|r||_nx|jr4|jd dddd|_nRz|jd dd|_Wn8ty}zd|_td||WYd}~n d}~00dS)z5Store params in private vars for use in add_argument.%defaultrir0) stacklevelrjchoice)typrYchoicesrrkr.N-_r4z???zneed a long or short option)_attrs _short_opts _long_optsgetwarningswarnrKeyError isinstancercrformatrjrr_typ_maprk_set_opt_stringsr.replace IndexErrorrx)r(rYr=rr.er)r)r*r+sJ        zArgument.__init__rScCs |j|jSr-)rrr|r)r)r*rY szArgument.namesc Csxd}||j|D],}zt|||j|<WqtyBYq0q|jdrr|jd}|dd}||jd<|jS)Nzdefault dest helprirz %(default)s)splitror.rdrAttributeErrorrr)r(r=attrr_r)r)r*r=#s      zArgument.attrs)r<rcCs|D]}t|dkr$td||qt|dkrd|ddkrH|ddksVtd|||j|q|dddkr|ddkstd|||j|qd S) zhDirectly from optparse. Might not be necessary as this is passed to argparse later on. rz>invalid option string %r: must be at least two characters longrrr4zMinvalid short option string %r: must be of the form -x, (x any non-dash char)--zGinvalid long option string %r: must start with --, followed by non-dashN)lenrxrror)r(r<optr)r)r*r3s2  zArgument._set_opt_stringscCsg}|jr|dt|jg7}|jr8|dt|jg7}|dt|jg7}t|drj|dt|jg7}t|dr|dt|jg7}dd |S) Nz _short_opts: z _long_opts: zdest: rjztype: rkz default: z Argument({}), ) rreprrr.hasattrrjrkrjoin)r(r@r)r)r*__repr__Ps  zArgument.__repr__)rqrrrsrtr~rcrrrrr+rrYrr=r rrr)r)r)r*rs1rc@sjeZdZdZdddeeeeeddddZee dd d d Z ee dd d d Z ddeddddZ dS)r z,A group of options shown in its own section.r0NFr)r1r2rrrcCs$t|||_||_g|_||_dSr-)rr1r2rWr)r(r1r2rrr)r)r*r+as zOptionGroup.__init__r;cOsJt|dd|jD}|r*td|t|i|}|j|dddS)aMAdd an option to this group. If a shortened version of a long option is specified, it will be suppressed in the help. ``addoption('--twowords', '--two-words')`` results in help showing ``--two-words`` only, but ``--twowords`` gets accepted **and** the automatic destination is in ``args.twowords``. :param opts: Option names, can be short or long options. :param attrs: Same attributes as the argparse library's :py:func:`add_argument() ` function accepts. css |]}|D] }|VqqdSr-)rY)rGrr1r)r)r* }sz(OptionGroup.addoption..zoption names %s already addedF shortupperN)set intersectionrW ValueErrorr_addoption_instance)r(r<r=conflictr,r)r)r*r>os zOptionGroup.addoptioncOs t|i|}|j|dddS)NTr)rr)r(r<r=r,r)r)r* _addoptionszOptionGroup._addoptionr)r,rrcCsR|s0|jD]$}|ddkr |dr tdq |jrB|j||j|dS)Nrrr4zlowercase shortoptions reserved)rislowerrrr/rWro)r(r,rrr)r)r*rs   zOptionGroup._addoption_instance)r0N)F) rqrrrsrtrcr rrnr+rr>rrr)r)r)r*r ^s r cseZdZdeeeeefeeddfdd Zee dddZ dee eee j e j dd d Zejdd d kreeeee jeeefd ddZZS)rRN)rr'rrcs0||_tj||jdtdd|r&|ni|_dS)NF)rradd_helpformatter_class allow_abbrev)_parsersuperr+r$DropShorterLongHelpFormatterr')r(rr'r __class__r)r*r+s zMyOptionParser.__init__)messagercCsD|jd|}t|jdr0|d|jjd}t||dS)z1Transform argparse error message into UsageError.z : error: _config_source_hintz ()N)rrrrr format_usage)r(rryr)r)r*errors zMyOptionParser.errorr?c Cs|||\}}|r|D]b}|r|ddkrdd|g}t|jD]\}}|d|d|qJ|d|qt|t ||S)z(Allow splitting of positional arguments.rrzunrecognized arguments: %s z r{ ) rhrsortedr'rarorrdr[extend) r(r@rAparsedZ unrecognizedarglineskvr)r)r*rOszMyOptionParser.parse_argsr)r ) arg_stringrc Cs|sdS|d|jvrdS||jvr8|j|}||dfSt|dkrHdSd|vr~|dd\}}||jvr~|j|}|||fS|js|ds||}t|dkrtd}ddd|D}| |||d nt|dkr|\}|S|j |r|j sdSd |vrdSd|dfS) Nrr4=rz4ambiguous option: %(option)s could match %(matches)srcss|]\}}}|VqdSr-r))rGrr,r)r)r*rrJz1MyOptionParser._parse_optional..)r,matchesr) prefix_chars_option_string_actionsrrr startswith_get_option_tuplesrrr_negative_number_matchermatch_has_negative_number_optionals) r(raction option_string explicit_arg option_tuplesryrW option_tupler)r)r*_parse_optionals>           zMyOptionParser._parse_optional)NN)NN)rqrrrsrr rrcrr+r rr rvrwrOsys version_infor Actionr __classcell__r)r)rr*rRs(   rRcsHeZdZdZeeddfdd Zejedfdd Z d d Z Z S) ra+Shorten help for long options that differ only in extra hyphens. - Collapse **long** options that are the same except for extra hyphens. - Shortcut if there are only two options and one of them is a short one. - Cache result on the action object as this is called at least 2 times. N)r@kwargsrcs,d|vrtj|d<tj|i|dS)Nwidth)_pytest_ioZget_terminal_widthrr+)r(r@rrr)r*r+sz%DropShorterLongHelpFormatter.__init__)rrc sjt|}|r |ddkr |St|dd}|r4|S|d}t|dkrtt|ddksjt|ddkrt||_|Sg}i}|D]r}t|dks|ddkrq|dstd |||dd}|dd } | |vst|| t|kr||| <q|D]\}t|dks|ddkr"| ||dd| |dd kr| |dd dqd |} | |_| S) Nrr_formatted_action_invocationrrr4rrz)long optional argument without "--": [%s]r0r) r_format_action_invocationrdrrrrrxrrorr) r(rZorgstrresrWZ return_listZ short_longr,ZxxoptionZ shortenedZformatted_action_invocationrr)r*rsB   ,      z6DropShorterLongHelpFormatter._format_action_invocationcCs4ddl}g}|D]}||||q|S)z}Wrap lines after splitting on original newlines. This allows to have explicit line breaks in the help text. rN)textwrap splitlinesrwrapstrip)r(textrrrliner)r)r* _split_liness  z)DropShorterLongHelpFormatter._split_lines) rqrrrsrtrr+rvrrcrrrr)r)rr*rs&r))rvrDrrrtypingrrrrrrr r r r r rZ _pytest._iorZ_pytest.compatrZ_pytest.config.exceptionsrZ_pytest.deprecatedrrrrZtyping_extensionsrr[r Exceptionrxrr ArgumentParserrR HelpFormatterrr)r)r)r*sD                    4z5V