o hJ@s$ddlmZddlZddlmZddlmZddlmZddlZddlm Z ddlm Z ddlm Z dd lm Z dd lm Z ddlZdd lmZdd lmZd ZGdddZeZe GdddZd"ddZGdddeZGdddZGdddZGdddejZGd d!d!ejZ dS)#) annotationsN)Callable)Mapping)Sequence)Any)cast)final)Literal)NoReturn) UsageError)check_ispytest file_or_dirc@seZdZdddZdS)NotSetreturnstrcCsdS)NzselfrrZ/var/www/html/openai_agents/venv/lib/python3.10/site-packages/_pytest/config/argparsing.py__repr__szNotSet.__repr__Nrr)__name__ __module__ __qualname__rrrrrrsrc@seZdZUdZdZded<  d9ddd:ddZd;ddZ ddd Z d?d@d&d'Z dAd)d*Z d?dBd,d-Z d?d@d.d/Z d?dCd1d2ZdefdDd7d8ZdS)EParserzParser 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 _ispytestusage processopt!Callable[[Argument], None] | NonerboolrNonecCs@t|td|dd|_g|_||_||_i|_g|_i|_dS)NzCustom optionsTparserr) r OptionGroup _anonymous_groups _processopt_usage_inidict _ininames extra_info)rrr rrrr__init__)s zParser.__init__optionArgumentcCs"|jr |jr||dSdSdSN)r)dest)rr/rrr processoption9s zParser.processoptionnamer descriptionafterr&cCsj|jD] }|j|kr|Sqt|||dd}d}t|jD] \}}|j|kr)nq|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(r5r& enumerateinsert)rr5r6r7groupigrprrrgetgroup>s   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)rr?r@rrrrAXszParser.addoptionargs Sequence[str | os.PathLike[str]] namespaceargparse.Namespace | Noneargparse.NamespacecCs>ddlm}||_||jdd|D}|jj||dS)Nr)try_argcompletecSg|]}t|qSrosfspath.0xrrr qz Parser.parse..rD)_pytest._argcompleterG _getparser optparser parse_args)rrBrDrGstrargsrrrparsehs   z Parser.parseMyOptionParserc Csddlm}t||j|jd}g|j|j}|D]&}|jr?|jp#|j }| |}|jD]}| }| } |j |i| q,q|j tdd} || _|S)Nr)filescompleter)r*)nargs)rRrYrXr-rr(r'optionsr6r5add_argument_groupnamesr@ add_argument FILE_OR_DIR completer) rrYrTgroupsr;descarggroupr/nafile_or_dir_argrrrrSts    zParser._getparser list[str]cCsB|j||d}|jD] \}}t|||q tttt|tS)NrQ) rW__dict__itemssetattrrlistrgetattrr`)rrBr/rD parsedoptionr5valuerrrparse_setoptionszParser.parse_setoptioncCs|j||ddS)zbParse the known arguments at this point. :returns: An argparse namespace object. rQr)parse_known_and_unknown_args)rrBrDrrrparse_known_argss zParser.parse_known_args$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. cSrHrrIrLrrrrOrPz7Parser.parse_known_and_unknown_args..rQ)rSrr)rrBrDrTrVrrrrqs z#Parser.parse_known_and_unknown_argshelptypeYLiteral['string', 'paths', 'pathlist', 'args', 'linelist', 'bool', 'int', 'float'] | NonedefaultcCs<|dvsJ|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) `. ) NstringpathspathlistrBlinelistr"intfloatN)NOT_SETget_ini_default_for_typer+r,append)rr5rtrurwrrraddinis / z Parser.addiniNN)rrr r!rr"rr#)r/r0rr#r4N)r5rr6rr7rrr&r?rr@rrr#r1)rBrCrDrErrF)rrX)rBrCr/rFrDrErrh)rBrCrDrErrs) r5rrtrrurvrwrrr#)rrr__doc__r__annotations__r.r3r>rArWrSrprrrqr~rrrrrrs0        rrurvrrcCs@|durdS|dvr gS|dkrdS|dkrdS|dkrd SdS) zp Used by addini to get the default value for a given ini-option type, when default is not supplied. Nr4)ryrzrBr{r"Fr|rr}gr)rurrrrs 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||_dSr1)rr option_id)rrr/rrrr. szArgumentError.__init__cCs |jr d|jd|jS|jS)Nzoption : )rrrrrr__str__szArgumentError.__str__N)rrr/rrr#r)rrrrr.rrrrrrs rc@sBeZdZdZddd Zdd d ZdddZdddZdddZdS)r0zClass 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 r^rr@rrr#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.rurwr2rN-_r8z???zneed a long or short option) _attrs _short_opts _long_optsruKeyErrorrw_set_opt_stringsgetr2replace IndexErrorr)rr^r@r2errrr.s4       zArgument.__init__rhcCs |j|jSr1)rrrrrrr^9s zArgument.namesMapping[str, Any]c CsJd}||j|D]}z t|||j|<Wq ty!Yq w|jS)Nzdefault dest help)splitrr2rmrAttributeError)rr@attrrrrr@<s  zArgument.attrsr? Sequence[str]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 longrrr8zinvalid 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)lenrrrr)rr?optrrrrGs(     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: ruztype: rwz default: z Argument({}), ) rreprrr2hasattrrurwformatjoin)rrBrrrrds  zArgument.__repr__N)r^rr@rrr#)rrh)rr)r?rrr#r) rrrrr.r^r@rrrrrrr0s    r0c@sFeZdZdZ  ddddddZdddZdddZd d!ddZdS)"r&z,A group of options shown in its own section.r4NFrr5rr6r% Parser | Nonerr"rr#cCs$t|||_||_g|_||_dSr1)r r5r6r\r%)rr5r6r%rrrrr.us  zOptionGroup.__init__r?r@rcOsNt|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]}|VqqdSr1)r^)rMrr5rrr s  z(OptionGroup.addoption..z option names z already addedF shortupperN)set intersectionr\ ValueErrorr0_addoption_instance)rr?r@conflictr/rrrrAszOptionGroup.addoptioncOs t|i|}|j|dddS)NTr)r0r)rr?r@r/rrr _addoptionszOptionGroup._addoptionr/r0rcCsR|s|jD]}|ddkr|drtdq|jr!|j||j|dS)Nrrr8zlowercase shortoptions reserved)rislowerrr%r3r\r)rr/rrrrrrs  zOptionGroup._addoption_instancer) r5rr6rr%rrr"rr#r)F)r/r0rr"rr#)rrrrr.rArrrrrrr&rs  r&cs>eZdZ  ddfd d ZdddZ  ddddZZS)rXNr%rr-dict[str, Any] | Nonerrrr#cs8||_tj||jdtddd|r||_dSi|_dS)NF@)rradd_helpformatter_class allow_abbrevfromfile_prefix_chars)_parsersuperr.r*DropShorterLongHelpFormatterr-)rr%r-r __class__rrr.s zMyOptionParser.__init__messagerr cCs@|jd|}t|jdr|d|jjd}t||)z1Transform argparse error message into UsageError.z : error: _config_source_hintz ())rrrrr format_usage)rrrrrrerrors zMyOptionParser.errorrBSequence[str] | NonerDrErFc Cs|||\}}|rG|D]2}|r>|ddkr>dd|g}t|jD]\}}|d|d|q&|d|q t|t  ||S)z(Allow splitting of positional arguments.rrzunrecognized arguments: {} z r ) rrrrsortedr-rjrrrmr`extend) rrBrDparsed unrecognizedarglineskvrrrrUszMyOptionParser.parse_argsr)r%rr-rrrrr#)rrrr )rBrrDrErrF)rrrr.rrU __classcell__rrrrrXs  rXcs8eZdZdZdfdd 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. rBrkwargsrr#cs,d|vr tj|d<tj|i|dS)Nwidth)_pytest_ioget_terminal_widthrr.)rrBrrrrr.sz%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) Nrr_formatted_action_invocationrrr8rrz&long optional argument without "--": []r4=) r_format_action_invocationrmrrr startswithrrrrr) 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 splitlinesrwrapstrip)rtextrrrlinerrr _split_lines s  z)DropShorterLongHelpFormatter._split_lines)rBrrrrr#)rrrr)rrrrr.rrrrrrrrs &r)rurvrr)! __future__rargparsecollections.abcrrrrJtypingrrrr r _pytest._ior_pytest.config.exceptionsr _pytest.deprecatedr r`rr~rr Exceptionrr0r&ArgumentParserrX HelpFormatterrrrrrs4            O]52