o v&iO@s2ddlmZddlZddlmZddlmZddlmZddlZddlZddl m Z ddl m Z ddl m Z dd l m Z d d lmZddlZdd lmZd ZGdddZeZe GdddZd$ddZGdddeZGdddZGdddZGdddejZGd d!d!ejZ Gd"d#d#ej!Z"dS)%) annotationsN)Callable)Mapping)Sequence)Any)final)Literal)NoReturn) UsageError)check_ispytest file_or_dirc@seZdZdddZdS)NotSetreturnstrcCsdS)Nzselfrr_/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/_pytest/config/argparsing.py__repr__szNotSet.__repr__Nrr)__name__ __module__ __qualname__rrrrrrsrc@seZdZdZ  d:ddd;d dZedddZ d?d@ddZ dAd"d#Z dBdCd)d*Z dBdCd+d,Z dBdDd.d/Z defd0d1dEd8d9ZdS)FParserzParser 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 _ispytestusage str | None processopt!Callable[[Argument], None] | NonerboolrNonecCs~t|ddlm}||_i|_t|||j|_|jd}t|d|dd|_ |j g|_ |jj t dd}||_ i|_i|_dS) Nr)filescompleterzCustom options _anonymousTr*)nargs)r _pytest._argcompleter# _processopt extra_infoPytestArgumentParser optparseradd_argument_group OptionGroupr$_groups add_argument FILE_OR_DIR completer_inidict _ini_aliases)rrrrr#anonymous_arggroupfile_or_dir_argrrr__init__'s    zParser.__init__rcCs|jjSNr+progrrrrr9Asz Parser.progvaluecCs ||j_dSr7r8)rr:rrrr9Es optionArgumentcCs"|jr |jr||dSdSdSr7)r(dest)rr;rrr processoptionIs zParser.processoptionname descriptionafterr-cCs|jD] }|j|kr|Sq|j|p|}t|||dd}d}t|jD] \}}|j|kr1nq&|j|d||jj|d|jj|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.r@r+r,r- enumerateinsert_action_groupspop)rr@rArBgrouparggroupigrprrrgetgroupNs   zParser.getgroupoptsattrsrcOs|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)rrLrMrrrrNmszParser.addoptionargs Sequence[str | os.PathLike[str]] namespaceargparse.Namespace | Noneargparse.NamespacecCsXddlm}||jdd|D}|durt}zd|_|jj||dW|`S|`w)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_argcompletecSg|]}t|qSrosfspath.0xrrr z Parser.parse..NTrQ)r'rTr+argparse Namespace_raise_print_helpparse_intermixed_args)rrOrQrTstrargsrrrparse}s  z Parser.parsecCs|j||ddS)zbParse the known arguments at this point. :returns: An argparse namespace object. r^r)parse_known_and_unknown_args)rrOrQrrrparse_known_argss zParser.parse_known_args$tuple[argparse.Namespace, list[str]]cCsdd|D}tjdksdtjkrdkrDnn+|j||\}}|dus(Jt|t}g}|D]}|dr:|n||q1||fS|j||S)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. cSrUrrVrYrrrr\r]z7Parser.parse_known_and_unknown_args..) )rh )rhrkr N-) sys version_infor+rfgetattrr0 startswithappendparse_known_intermixed_args)rrOrQrcunknownr unknown_flagsargrrrres $  z#Parser.parse_known_and_unknown_argsr)aliaseshelptypeYLiteral['string', 'paths', 'pathlist', 'args', 'linelist', 'bool', 'int', 'float'] | Nonedefaultrv Sequence[str]cCs|dvsJ|dur d}|turt|}|||f|j|<|D]'}||jvr-td|d|j|}dur@t|d|||j|<qdS)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) `. ) NstringpathspathlistrOlinelistr!intfloatNr|zalias z- conflicts with existing configuration optionz is already an alias of )NOT_SETget_ini_default_for_typer2 ValueErrorr3get)rr@rwrxrzrvaliasalreadyrrraddinis 7    z Parser.addini)NN)rrrr rr!rr"r)r:rrr")r;r<rr")r?N)r@rrArrBrrr-rLrrMrrr"r7)rOrPrQrRrrS)rOrPrQrRrrg) r@rrwrrxryrzrrvr{rr")rrr__doc__r6propertyr9setterr>rKrNrdrfrerrrrrrrs4         rrxRLiteral['string', 'paths', 'pathlist', 'args', 'linelist', 'bool', 'int', 'float']rrcCs4|dvrgS|dkr dS|dkrdS|dkrdSdS) zs Used by addini to get the default value for a given config option type, when default is not supplied. )r}r~rOrr!Frrrgr?r)rxrrrr s rc@s$eZdZdZd dd Zdd d Zd S) ArgumentErrorzURaised if an Argument instance is created with invalid or inconsistent arguments.msgrr;Argument | strrr"cCs||_t||_dSr7)rr option_id)rrr;rrrr6%szArgumentError.__init__cCs |jr d|jd|jS|jS)Nzoption : )rrrrrr__str__)szArgumentError.__str__N)rrr;rrr"r)rrrrr6rrrrrr!s rc@sBeZdZdZddd Zdd d ZdddZdddZdddZdS)r<zClass 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 namesrrMrrr"c Os||_g|_g|_z|d|_Wn tyYnwz|d|_Wn ty*Ynw|||d}|r<||_dS|jrO|jddd dd|_dSz |jdd d|_WdSt yq}z d |_t d ||d}~ww) z5Store params in private vars for use in add_argument.rxrzr=rNrl_r z???zneed a long or short option) _attrs _short_opts _long_optsrxKeyErrorrz_set_opt_stringsrr=replace IndexErrorr)rrrMr=errrr69s4       zArgument.__init__ list[str]cCs |j|jSr7)rrrrrrrTs zArgument.namesMapping[str, Any]c Cs@ddd|jfD]}z t|||j|<WqtyYqw|jS)Nrzr=rw)r=rorAttributeError)rattrrrrrMWs zArgument.attrsrLr{cCs|D]P}t|dkrtd|d|t|dkr5|ddkr%|ddks.td|d||j|q|ddd krC|ddksLtd |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 longrrlr zinvalid 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)lenrrrqr)rrLoptrrrr`s(     zArgument._set_opt_stringscCsg}|jr|dt|jg7}|jr|dt|jg7}|dt|jg7}t|dr5|dt|jg7}t|drD|dt|jg7}dd |S) Nz _short_opts: z _long_opts: zdest: rxztype: rzz default: z Argument({}), ) rreprrr=hasattrrxrzformatjoin)rrOrrrr}s  zArgument.__repr__N)rrrMrrr")rr)rr)rLr{rr"r) rrrrr6rrMrrrrrrr<0s    r<c@s>eZdZdZ ddd dZdddZdddZddddZdS) r-z,A group of options shown in its own section.FrHargparse._ArgumentGroupr@rparser Parser | Nonerr!rr"cCs$t|||_||_g|_||_dSr7)r _arggroupr@optionsr)rrHr@rrrrrr6s  zOptionGroup.__init__rLrMrcOsNt|dd|jD}|rtd|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]}|VqqdSr7)r)rZrr@rrr s  z(OptionGroup.addoption..z option names z already addedF shortupperN)set intersectionrrr<_addoption_instance)rrLrMconflictr;rrrrNszOptionGroup.addoptioncOs t|i|}|j|dddS)NTr)r<r)rrLrMr;rrr _addoptionszOptionGroup._addoptionr;r<rcCsl|s|jD]}|ddkr|drtdq|jr!|j||jj|i||j |dS)Nrrlr zlowercase shortoptions reserved) rislowerrrr>rr/rrMrrq)rr;rrrrrrs  zOptionGroup._addoption_instanceN)F) rHrr@rrrrr!rr"r)r;r<rr!rr")rrrrr6rNrrrrrrr-s r-cs(eZdZdfd d ZdddZZS)r*rrrrr)dict[str, str]rr"cs&||_tj|dtddd||_dS)NF@)radd_helpformatter_class allow_abbrevfromfile_prefix_chars)_parsersuperr6DropShorterLongHelpFormatterr))rrrr) __class__rrr6s zPytestArgumentParser.__init__messagerr cCsL|jd|}|jr|ddddt|jD7}t||)z1Transform argparse error message into UsageError.z : error:  css$|] \}}d|d|VqdS)z rNr)rZkvrrrrs z-PytestArgumentParser.error..)r9r)rsorteditemsr format_usage)rrrrrrerrors   zPytestArgumentParser.error)rrrrr)rrr")rrrr )rrrr6r __classcell__rrrrr*sr*cs8eZdZdZdfdd Zdfd d ZddZZS)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. rOrkwargsrr"cs,d|vr tj|d<tj|i|dS)Nwidth)_pytest_ioget_terminal_widthrr6)rrOrrrrr6sz%DropShorterLongHelpFormatter.__init__actionargparse.Actionrc sjt|}|r|ddkr|St|dd}|r|S|d}t|dkr:t|ddks5t|ddkr:||_|Sg}i}|D];}t|dksN|ddkrOq@|ds]td |d ||dd}|dd } | |vswt|| t|kr{||| <q@|D],}t|dks|ddkr| ||dd| |dd kr| |dd dq~d |} | |_| S) Nrrl_formatted_action_invocationrrr  rz&long optional argument without "--": []r?=) r_format_action_invocationrosplitrrrprrrqrr) rrorgstrresr return_list short_longr;xxoption shortenedformatted_action_invocationrrrrsF   ,      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 splitlinesextendwrapstrip)rtextrrlineslinerrr _split_liness  z)DropShorterLongHelpFormatter._split_lines)rOrrrrr")rrrr)rrrrr6rrrrrrrrs &rcs0eZdZdZ ddfd d ZdddZZS)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. Noption_stringsr{r=rr&int | str | None ini_option ini_valuerr"cs.tj||dg|Ri|||_||_dS)Nr)rr6rr)rrr=r&rrrOrrrrr6(s  zOverrideIniAction.__init__rargparse.ArgumentParserrQrScOsNt||jdt|dd}|durg}||jd|jt|d|dS)NT override_inir)setattrr=rorqrr)rrrQrOrcurrent_overridesrrr__call__6s  zOverrideIniAction.__call__r7) rr{r=rr&rrrrrrr")rrrQrSrr")rrrrr6rrrrrrr s  r)rxrrr)# __future__rr_collections.abcrrrrWrmtypingrrrr exceptionsr _pytest._ior_pytest.deprecatedr r0rrrr Exceptionrr<r-ArgumentParserr* HelpFormatterrActionrrrrrs6           m[7A