a *jJ@s*ddlmZddlZddlmZddlmZddlmZddlZddlm Z ddlm Z ddlm Z dd lm Z dd lm Z ddlZdd lmZdd lmZd ZGdddZeZe GdddZdddddZGdddeZGdddZGdddZGdddejZGdd d ejZ dS)!) annotationsN)Callable)Mapping)Sequence)Any)cast)final)Literal)NoReturn) UsageError)check_ispytestZ file_or_dirc@seZdZddddZdS)NotSetstrreturncCsdS)Nzselfrr?E:\soccer\ml_env\Lib\site-packages\_pytest/config/argparsing.py__repr__szNotSet.__repr__N)__name__ __module__ __qualname__rrrrrr sr c@seZdZUdZdZded<d2dddddd d d d Zd d dddZd3dddddddZddd dddZ d4dddddd Z d!d"d#d$Z d5dddd%d&d'd(Z d6ddddd)d*Z d7ddd+dd,d-Zdefddd.dd d/d0d1ZdS)8ParserzParser 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. N str | NoneprogF _ispytestz!Callable[[Argument], None] | NoneboolNone)usage processoptrrcCs@t|td|dd|_g|_||_||_i|_g|_i|_dS)NzCustom optionsTparserr) r OptionGroup _anonymous_groups _processopt_usage_inidict _ininames extra_info)rr r!rrrr__init__)szParser.__init__Argument)optionrcCs|jr|jr||dSN)r'dest)rr.rrr processoption9szParser.processoptionrr$)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``. Tr"r)r&r3r$ enumerateinsert)rr3r4r5groupigrprrrgetgroup>s    zParser.getgrouproptsattrsrcOs|jj|i|dS)aRegister a command line option. :param opts: Option names, can be short or long options. :param attrs: Same attributes as the argparse library's :meth:`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)rr>r?rrrr@XszParser.addoptionz Sequence[str | os.PathLike[str]]argparse.Namespace | Noneargparse.Namespaceargs namespacercCs>ddlm}||_||jdd|D}|jj||dS)Nr)try_argcompletecSsg|]}t|qSrosfspath.0xrrr qz Parser.parse..rE)_pytest._argcompleterF _getparser optparser parse_args)rrDrErFstrargsrrrparsehs    z Parser.parseMyOptionParserrc Csddlm}t||j|jd}g|j|j}|D]L}|jr2|jpF|j }| |}|jD]$}| }| } |j |i| qXq2|j tdd} || _|S)Nr)filescompleter)r*)nargs)rPrWrVr+rr&r%optionsr4r3add_argument_groupnamesr? add_argument FILE_OR_DIRZ completer) rrWrRgroupsr9descZarggroupr.naZfile_or_dir_argrrrrQts    zParser._getparser list[str])rDr.rErcCsB|j||d}|jD]\}}t|||qtttt|tS)NrO) rU__dict__itemssetattrrlistrgetattrr^)rrDr.rEZ parsedoptionr3valuerrrparse_setoptionszParser.parse_setoptioncCs|j||ddS)zbParse the known arguments at this point. :returns: An argparse namespace object. rOr)parse_known_and_unknown_args)rrDrErrrparse_known_argss zParser.parse_known_argsz$tuple[argparse.Namespace, list[str]]cCs$|}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|qSrrGrJrrrrMrNz7Parser.parse_known_and_unknown_args..rO)rQrl)rrDrErRrTrrrrks z#Parser.parse_known_and_unknown_argsYLiteral['string', 'paths', 'pathlist', 'args', 'linelist', 'bool', 'int', 'float'] | None)r3helptypedefaultrcCs<|dvs J|turt|}|||f|j|<|j|dS)a Register 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 * ``int``: an integer * ``float``: a floating-point number .. versionadded:: 8.4 The ``float`` and ``int`` types. For ``paths`` and ``pathlist`` types, they are considered relative to the ini-file. In case the execution is happening without an ini-file defined, they will be considered relative to the current working directory (for example with ``--override-ini``). .. versionadded:: 7.0 The ``paths`` variable type. .. versionadded:: 8.1 Use the current working directory to resolve ``paths`` and ``pathlist`` in the absence of an ini-file. 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) `. ) NstringpathspathlistrDlinelistrintfloatN)NOT_SETget_ini_default_for_typer)r*append)rr3rnrorprrraddinis / z Parser.addini)NN)r2N)N)N)N)N)rrr__doc__r__annotations__r,r1r<r@rUrQrjrlrkrwrzrrrrrs.   rrmr)rorcCsD|dur dS|dvrgS|dkr$dS|dkr0dS|dkrrcCs|D]}t|dkr(td|d|qt|dkrl|ddkrL|ddks^td|d||j|q|ddd kr|ddkstd |d ||j|qd S) zhDirectly from optparse. Might not be necessary as this is passed to argparse later on. rzinvalid option string z&: must be at least two characters longrrr6zinvalid short option string z/: must be of the form -x, (x any non-dash char)--zinvalid long option string z*: must start with --, followed by non-dashN)lenr}rryr)rr>optrrrrGs&     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: roztype: rpz default: z Argument({}), ) rreprrr0hasattrrorpformatjoin)rrDrrrrds  zArgument.__repr__N) rrrr{r,r\r?rrrrrrr-s  r-c@sfeZdZdZdddddddd d d d Zdd d dddZdd d dddZdddd dddZdS)r$z,A group of options shown in its own section.r2NFrrz Parser | Nonerr)r3r4r#rrcCs$t|||_||_g|_||_dSr/)r r3r4rZr#)rr3r4r#rrrrr,us zOptionGroup.__init__rr=cOsNt|dd|jD}|r.td|dt|i|}|j|dddS)aJAdd 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 :meth:`add_argument() ` function accepts. css |]}|D] }|VqqdSr/)r\)rKrr3rrr sz(OptionGroup.addoption..z option names z already addedF shortupperN)set intersectionrZ ValueErrorr-_addoption_instance)rr>r?conflictr.rrrr@szOptionGroup.addoptioncOs t|i|}|j|dddS)NTr)r-r)rr>r?r.rrr _addoptionszOptionGroup._addoptionr-)r.rrcCsR|s0|jD]$}|ddkr |dr tdq |jrB|j||j|dS)Nrrr6zlowercase shortoptions reserved)rislowerrr#r1rZry)rr.rrrrrrs   zOptionGroup._addoption_instance)r2N)F)rrrr{r,r@rrrrrrr$rsr$csNeZdZddddddfdd Zd d d d d ZdddddddZZS)rVNrzdict[str, Any] | Nonerr)r#r+rrcs2||_tj||jdtddd|r(|ni|_dS)NF@)rr add_helpZformatter_classZ allow_abbrevZfromfile_prefix_chars)_parsersuperr,r(DropShorterLongHelpFormatterr+)rr#r+r __class__rrr,s zMyOptionParser.__init__rr )messagercCsD|jd|}t|jdr0|d|jjd}t||dS)z1Transform argparse error message into UsageError.z : error: _config_source_hintz ()N)rrrrr format_usage)rrr~rrrerrors zMyOptionParser.errorzSequence[str] | NonerArBrCc Cs|||\}}|r|D]d}|r|ddkrdd|g}t|jD]\}}|d|d|qL|d|qt|t  ||S)z(Allow splitting of positional arguments.rrzunrecognized arguments: {} z r ) rlrrsortedr+reryrrhr^extend) rrDrEparsedZ unrecognizedarglineskvrrrrSszMyOptionParser.parse_args)NN)NN)rrrr,rrS __classcell__rrrrrVs rVcsFeZdZdZddddfdd Zddd fd d Zd d ZZS)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. rr)rDkwargsrcs,d|vrtj|d<tj|i|dS)Nwidth)_pytest_ioZget_terminal_widthrr,)rrDrrrrr,sz%DropShorterLongHelpFormatter.__init__zargparse.Actionr)actionrc snt|}|r |ddkr |St|dd}|r4|S|d}t|dkrtt|ddksjt|ddkrt||_|Sg}i}|D]v}t|dks|ddkrq|dstd |d ||dd}|dd } | |vst|| t|kr||| <q|D]\}t|dks|ddkr&| ||dd| |dd kr| |dd dqd |} | |_| S) Nrr_formatted_action_invocationrrr6rrz&long optional argument without "--": []r2=) r_format_action_invocationrhrrr startswithr}rryrr) rrZorgstrresrZZ return_listZ short_longr.ZxxoptionZ shortenedZformatted_action_invocationrrrrsB   ,       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)rtextrrrlinerrr _split_lines s  z)DropShorterLongHelpFormatter._split_lines)rrrr{r,rrrrrrrrs&r)! __future__rargparsecollections.abcrrrrHtypingrrrr r Z _pytest._iorZ_pytest.config.exceptionsr Z_pytest.deprecatedr r^r rwrrx Exceptionr}r-r$ArgumentParserrV HelpFormatterrrrrrs2           O]52