jjE|ddlmZddlZddlmZddlmZddlZddlZddlZddl m Z ddl m Z ddl m Z ddl m Z d d lmZddlZdd lmZdd lmZd Ze GddZ ddZGddZGddZGddej6ZGddej:ZGddej>Z y)) annotationsN)Callable)Sequence)Any)final)Literal)NoReturn) UsageError)NOTSET)check_ispytest file_or_dirceZdZdZ dddd ddZeddZejddZddZ d dd Z dd Z d dd Z d dd Z d dd Z defdd ddZy)ParserzParser for command line arguments and config-file values. :ivar extra_info: Dict of generic param -> value to display in case there's an error processing the command line arguments. NF)prog _ispytestcxt|ddlm}||_i|_t ||j||_|j jd}t|d|d|_ |jg|_ i|_ |j jtd }||_i|_i|_y) Nr)filescompleterrzCustom options _anonymousTr*)nargs)r _pytest._argcompleter _processopt extra_infoPytestArgumentParser optparseradd_argument_group OptionGroupr_groups _opt2dest add_argument FILE_OR_DIR completer_inidict _ini_aliases)selfusage processoptrrranonymous_arggroupfile_or_dir_args [/opt/eval-harness/bench_task/venv/lib/python3.12/site-packages/_pytest/config/argparsing.py__init__zParser.__init__ s y!7%*,-eT__4P!^^>>?OP%  dd ( )+..55k5M$2!9; ,.c.|jjSNrrr(s r-rz Parser.prog=s~~"""r/c&||j_yr1r2)r(values r-rz Parser.progAs#r/cZ|jr|jr|j|yyyr1)rdest)r(options r- processoptionzParser.processoptionEs*   {{  ( r/c|jD]}|j|k(s|cS|jj|xs|}t |||d}d}t |jD]\}}|j|k(sn|jj |dz||jjj |dz|jjj|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``. Trrr ) r!namerrr enumerateinsert_action_groupspop)r(r; descriptionaftergrouparggroupigrps r-getgroupzParser.getgroupJs\\ EzzT!  >>44[5HDIHdDDA  - FAsxx5   AE5) %%,,QUDNN4Q4Q4U4U4WX r/c<|jj|i|y)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 addoptionr(optsattrss r-rHzParser.addoptionis "!!4151r/cddlm}||j|Dcgc]}tj|}}|t j } d|_|jj|||`Scc}w#|`wxYw)zParse the arguments. Unlike ``parse_known_args`` and ``parse_known_and_unknown_args``, raises PrintHelp on `--help` and UsageError on unknown flags :meta private: r)try_argcompleteT namespace) rrMrosfspathargparse Namespace_raise_print_helpparse_intermixed_args)r(argsrOrMxstrargss r-parsez Parser.parseys{ 9')-.A299Q<..   **,I ,*.I '>>7797U+/+sA8#A==Bc.|j||dS)zbParse the known arguments at this point. :returns: An argparse namespace object. rNr)parse_known_and_unknown_args)r(rVrOs r-parse_known_argszParser.parse_known_argss000KANNr/c|Dcgc]}tj|}}tjdksdtjcxkrdkrgnnd|jj ||\}}|Jt |t}g}|D]&}|jdr|n|j|(||fS|jj||Scc}w)a Parse the known arguments at this point, and also return the remaining unknown flag arguments. :returns: A tuple containing an argparse namespace object for the known arguments, and a list of unknown flag arguments. ) )r^ )r^rar -) rPrQsys version_inforr\getattrr$ startswithappendparse_known_intermixed_args) r(rVrOrWrXunknownr unknown_flagsargs r-r[z#Parser.parse_known_and_unknown_argss*..A299Q<..   j (Gs7G7G,T*,T!%!@!@)!T Iw( ((!)[9K')M T"%.."5;NNsS Tm+ +>>==gyQ Q/sC)aliasesc"|dvsJ|d}|tur t|}|||f|j|<|D][}||jvrtd|d|jj |x}t|d|||j|<]y)aRegister a configuration file option. :param name: Name of the configuration. :param type: Type of the configuration. 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 config-file. In case the execution is happening without a config-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 a config-file. Defaults to ``string`` if ``None`` or not passed. :param default: Default value if no config-file option exists but is queried. :param aliases: Additional names by which this option can be referenced. Aliases resolve to the canonical name. .. versionadded:: 9.0 The ``aliases`` parameter. The value of configuration keys can be retrieved via a call to :py:func:`config.getini(name) `. ) NstringpathspathlistrVlinelistboolintfloatNrozalias z- conflicts with existing configuration optionz is already an alias of )r get_ini_default_for_typer& ValueErrorr'get)r(r;helptypedefaultrmaliasalreadys r-addiniz Parser.addinisn     <D f .t4G#T73 d ,E % UI%RS ,,0077D E9,DWK!PQQ'+D  e $ ,r/)NN) r) str | Noner*z!Callable[[Argument], None] | NonerrrrsreturnNonerstr)r5rrr)r8Argumentrr)N)r;rr@rrArrr rJrrKrrrr1)rV Sequence[str | os.PathLike[str]]rOargparse.Namespace | Nonerargparse.Namespace)rVrrOrrz$tuple[argparse.Namespace, list[str]]) r;rryrrzzYLiteral['string', 'paths', 'pathlist', 'args', 'linelist', 'bool', 'int', 'float'] | Noner{rrm Sequence[str]rr)__name__ __module__ __qualname____doc__r.propertyrsetterr9rFrHrYr\r[r r~rlr/r-rrs!8</   //6/  /  / /:## [[$$) EI&)7A >2&04,.,-,  ,604 O. O- O  O04R.R-R . R@P,"$P,P,P, P,P,P, P,r/rc4|dvrgS|dk(ry|dk(ry|dk(ryy) zs Used by addini to get the default value for a given config option type, when default is not supplied. )rprqrVrrrsFrtrrugrrl)rzs r-rvrvs3 88   r/cfeZdZdZd dZd dZd dZed dZeddZ eddZ d dZ y )rz$An option defined in an OptionGroup.c||_yr1)_action)r(actions r-r.zArgument.__init__ s  r/c.|jjSr1)r__dict__r3s r-rKzArgument.attrs#s||$$$r/c.|jjSr1)roption_stringsr3s r-nameszArgument.names&s||***r/c.|jjSr1)rr7r3s r-r7z Argument.dest)||   r/c.|jjSr1)rr{r3s r-r{zArgument.default-s||###r/c.|jjSr1)rrzr3s r-rzz Argument.type1rr/cft|dd}|yg}|dt|jzgz }|dt|jzgz }|jr|dt|jzgz }|dt|j zgz }dj dj|S) NrzArgument()zopts: zdest: ztype: z default: z Argument({}), )rereprrr7rzr{formatjoin)r(rrVs r-__repr__zArgument.__repr__5sy$/ >. D..// DO+,, ;; XTYY/0 0D tDLL1122$$TYYt_55r/N)rargparse.Actionrr)rdict[str, Any])rrr)rr)rz Any | None) rrrrr.rKrrr7r{rzrrlr/r-rrsU.%+!!$$!! 6r/rcVeZdZdZ d ddZd dZd dZ d dZy) r z,A group of options shown in its own section.cRt|||_||_g|_||_yr1)r _arggroupr;optionsparser)r(rCr;rrs r-r.zOptionGroup.__init__Es( y!! ')  r/ct|jd|jD}|rtd|d|j ||dy)aAdd 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. Note that lower-case short options (e.g. `-x`) are reserved. :param attrs: Same attributes as the argparse library's :meth:`add_argument() ` function accepts. c3JK|]}|jD]}|ywr1)r).0optr;s r- z(OptionGroup.addoption..as-* SYY[* -1D* * s!#z option names z already addedFallow_reservedN)set intersectionrrw_addoption_inner)r(rJrKconflicts r-rHzOptionGroup.addoptionRsWt9))*  LL*   }XJnEF F dE%@r/c,|j||dy)z}Like addoption(), but also allows registering short lower case options (e.g. -x), which are reserved for pytest core.TrN)rrIs r- _addoptionzOptionGroup._addoptionhs dE$?r/c|s=|D]8}t|dk\s|ddk(s|djs/td|jj|i|}t |}|j j||jrT|jD]%}|j|jj|<'|jj|yy)Nrrbr z$lowercase short options are reserved) lenislowerrwrr#rrrgrrr7r"r9)r(rJrKrrrr8r;s r-rzOptionGroup._addoption_innerms Ms8q=SVs]s1v~~7G$%KLL M-,,d.s%$"&!Q"QCr! $s)rrrsorteditemsr format_usage)r(messagemsgs r-errorzPytestArgumentParser.errorsu 9WI. ?? 4$))$*01F1F1H*I$ C**,s233r/)r)rrzdict[str, str]rrrr)rrrr )rrrr.r __classcell__rs@r-rr~s8  %%#%  %  %& 4r/rc8eZdZdZdfd Zdfd ZddZxZS)rzShorten 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. cnd|vr!tjj|d<t||i|y)Nwidth)_pytest_ioget_terminal_widthrr.)r(rVkwargsrs r-r.z%DropShorterLongHelpFormatter.__init__s3 & %kk<<>F7O $)&)r/ct ||}|r |ddk7r|S|jd}t|dk(r$t|ddk(st|ddk(r|Sg}i}|D]p}t|dk(s|ddk(r|j ds Jd|d |dd}|j dd }||vst||t|ksl|||<r|D]s}t|dk(s|ddk(r|j ||dd|j|j dd k(sR|j |j dd dudj|S) Nrrbrrr  z--z&long optional argument without "--": []r=) r_format_action_invocationsplitrrfreplacergrxr) r(rorgstrr return_list short_longr8xxoption shortenedrs r-rz6DropShorterLongHelpFormatter._format_action_invocations26: fQi3&M,,t$ w<1 #gaj/Q"6#gaj/Q:NM %'  1F6{a6!9#3$$T* 8B *abzH ((b1I *c*Y2G.H3L/)1 9% 1 @F6{a6!9#3""6*abzZ^^FNN3,CDD""6>>#sA#>?  @ yy%%r/cg}|jD]5}|jtj|j |7|S)z}Wrap lines after splitting on original newlines. This allows to have explicit line breaks in the help text. ) splitlinesextendtextwrapwrapstrip)r(textrlineslines r- _split_linesz)DropShorterLongHelpFormatter._split_linessA OO% =D LLtzz|U; < = r/)rVrrrrr)rrrr)rrrrtrz list[str])rrrrr.rrrrs@r-rrs * &>r/rcReZdZdZ d dfd Z ddZxZS)OverrideIniActionzCustom argparse action that makes a CLI flag equivalent to overriding an option, in addition to behaving like `store_true`. This can simplify things since code only needs to inspect the config option and not consider the CLI flag. cLt|||dg|i|||_||_y)Nr)rr. ini_option ini_value) r(rr7rrrrVrrs r-r.zOverrideIniAction.__init__s. qB4B6B$"r/ct||jdt|dd}|g}|j|jd|j t|d|y)NT override_inir)setattrr7rergrr)r(rrOrVrcurrent_overridess r-__call__zOverrideIniAction.__call__s_  499d+#I~tD  $ "   DOO#4Adnn5E!FG >+<=r/r1) rrr7rrzint | str | Nonerrrrrr)rzargparse.ArgumentParserrOrrr)rrrrr.rrrs@r-rrsm#' #% # # #  # #  # >' >& >  >r/r)rzzRLiteral['string', 'paths', 'pathlist', 'args', 'linelist', 'bool', 'int', 'float']rr)! __future__rrRcollections.abcrrrPrcrtypingrrrr exceptionsr _pytest._ior_pytest.compatr _pytest.deprecatedr r$rrvrr ArgumentParserr HelpFormatterrActionrrlr/r-rs"$$ "!- l,l,l,^  *"6"6J9.9.x48224@48#9#94n">">r/