o ZhQ@sxddlZddlmZddlZddlZddlmZddlmZddlmZddlmZddlm Z ddlm Z dd lm Z dd lm Z dd lm Z dd lmZdd lmZddlmZddlmZddlZddlmZddlmZdZGdddZeZe GdddZdee ddefddZGdddeZGdddZGd d!d!Z Gd"d#d#ej!Z"Gd$d%d%ej#Z$dS)&N)gettext)Any)Callable)cast)Dict)final)List)Literal)Mapping)NoReturn)Optional)Sequence)Tuple)Union) UsageError)check_ispytestZ file_or_dirc@seZdZdefddZdS)NotSetreturncCsdS)NzselfrrP/var/www/html/lang_env/lib/python3.10/site-packages/_pytest/config/argparsing.py__repr__szNotSet.__repr__N)__name__ __module__ __qualname__strrrrrrrsrc @seZdZUdZdZeeed<  d/dddeedeedgdfd e d dfd d Z d0ddZ d1dededeed dfddZ dede d dfddZ d2deeedfdeejd ejfddZd3d!d"Z d2deeedfd ejdeejd eefd#d$Z d2deeedfdeejd ejfd%d&Z d2deeedfdeejd eejeeffd'd(Zdefded)ed*eed+d,e d df d-d.ZdS)4ParserzParser 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 _ispytestusage processoptArgumentr rcCs@t|td|dd|_g|_||_||_i|_g|_i|_dS)NzCustom optionsTparserr ) r OptionGroup _anonymous_groups _processopt_usage_inidict _ininames extra_info)rr!r"r rrr__init__.s zParser.__init__optioncCs"|jr |jr||dSdSdSN)r)dest)rr/rrr processoption>s zParser.processoptionname 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(r4r& enumerateinsert)rr4r5r6groupigrprrrgetgroupCs   zParser.getgroupoptsattrscOs|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@]szParser.addoptionargszos.PathLike[str] namespacecCs>ddlm}||_||jdd|D}|jj||dS)Nr)try_argcompletecSg|]}t|qSrosfspath.0xrrr vz Parser.parse..rB)_pytest._argcompleterC _getparser optparser parse_args)rrArBrCstrargsrrrparsems   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)rNrUrTr-rr(r'optionsr5r4add_argument_groupnamesr? add_argument FILE_OR_DIRZ completer) rrUrPgroupsr:ZdescZarggroupr/naZfile_or_dir_argrrrrOys    zParser._getparsercCsB|j||d}|jD] \}}t|||q tttt|tS)NrM) rS__dict__itemssetattrrrrgetattrr\)rrAr/rBZ parsedoptionr4valuerrrparse_setoptionszParser.parse_setoptioncCs|j||ddS)zbParse the known arguments at this point. :returns: An argparse namespace object. rMr)parse_known_and_unknown_args)rrArBrrrparse_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. cSrDrrErHrrrrKrLz7Parser.parse_known_and_unknown_args..rM)rOrg)rrArBrPrRrrrrfs z#Parser.parse_known_and_unknown_argshelptypestringpathspathlistrAlinelistbooldefaultcCs<|dvsJ|turt|}|||f|j|<|j|dS)aRRegister 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 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) `. )NrkrlrmrArnroN)NOT_SETget_ini_default_for_typer+r,append)rr4rhrirprrraddinis (z Parser.addiniNN)r/r#rNr3Nr0)rrT)rrr__doc__rr r__annotations__rror.r2r=rr@r rargparse NamespacerSrOrrergrrfrqr rtrrrrr$s       rrirjrcCs(|durdS|dvr gS|dkrdSdS)zp Used by addini to get the default value for a given ini-option type, when default is not supplied. Nr3)rlrmrArnroFr)rirrrrrsrrc@s<eZdZdZdededefddfddZdefd d ZdS) ArgumentErrorzURaised if an Argument instance is created with invalid or inconsistent arguments.msgr/r#rNcCs||_t||_dSr0)r|r option_id)rr|r/rrrr.szArgumentError.__init__cCs |jr d|jd|jS|jS)Nzoption : )r}r|rrrr__str__szArgumentError.__str__)rrrrwrrr.rrrrrr{sr{c@sreZdZdZdededdfddZdeefdd Zde eeffd d Z d e eddfd dZ defddZ dS)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 rZr?rNc 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.rirpr1rN-_r7z???zneed a long or short option) _attrs _short_opts _long_optsriKeyErrorrp_set_opt_stringsgetr1replace IndexErrorr{)rrZr?r1errrr. s4       zArgument.__init__cCs |j|jSr0)rrrrrrrZ&s zArgument.namesc CsJd}||j|D]}z t|||j|<Wq ty!Yq w|jS)Nzdefault dest help)splitrsr1rcrAttributeError)rr?attrrrrr?)s  zArgument.attrsr>cCs|D]J}t|dkrtd||t|dkr1|ddkr#|ddks*td|||j|q|dddkr?|ddksFtd|||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 longrrr7zMinvalid 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)lenr{rrsr)rr>optrrrr4s4  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: riztype: rpz default: z Argument({}), ) rreprrr1hasattrrirpformatjoin)rrArrrrQs  zArgument.__repr__)rrrrwrrr.rrZr r?r rrrrrrr#s r#c @seZdZdZ  ddddededeed ed df d d Zd ede d dfddZ d ede d dfddZ dddded dfddZ dS)r&z,A group of options shown in its own section.r3NFrr4r5r%r rcCs$t|||_||_g|_||_dSr0)rr4r5rXr%)rr4r5r%r rrrr.bs  zOptionGroup.__init__r>r?cOsJt|dd|jD}|rtd|t|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]}|VqqdSr0)rZ)rIrr4rrr ~s  z(OptionGroup.addoption..zoption names %s already addedF shortupperN)set intersectionrX ValueErrorr#_addoption_instance)rr>r?conflictr/rrrr@ps zOptionGroup.addoptioncOs t|i|}|j|dddS)NTr)r#r)rr>r?r/rrr _addoptionszOptionGroup._addoptionr/r#rcCsR|s|jD]}|ddkr|drtdq|jr!|j||j|dS)Nrrr7zlowercase shortoptions reserved)rislowerrr%r2rXrs)rr/rrrrrrs  zOptionGroup._addoption_instancerv)F) rrrrwrr rror.rr@rrrrrrr&_s( r&c seZdZ  ddedeeeefdeeddffdd Zdede fd d Z  dd ee ed ee j de j fd dZejdddkr_dedeeee jeeeffddZZSZS)rTNr%r-rrcs6||_tj||jdtdd|r||_dSi|_dS)NF)rr!add_helpformatter_class allow_abbrev)_parsersuperr.r*DropShorterLongHelpFormatterr-)rr%r-r __class__rrr.s zMyOptionParser.__init__messagecCs@|jd|}t|jdr|d|jjd}t||)z1Transform argparse error message into UsageError.z : error: _config_source_hintz ())rrrrr format_usage)rrr|rrrerrors zMyOptionParser.errorrArBc Cs|||\}}|rF|D]1}|r=|ddkr=dd|g}t|jD]\}}|d|d|q%|d|q t|t ||S)z(Allow splitting of positional arguments.rrzunrecognized arguments: %s z r~ ) rgrsortedr-rarsrrcr\extend) rrArBparsedZ unrecognizedarglineskvrrrrQszMyOptionParser.parse_argsr) arg_stringc Cs|sdS|d|jvr dS||jvr|j|}||dfSt|dkr$dSd|vr?|dd\}}||jvr?|j|}|||fS|jsG|dsv||}t|dkrktd}ddd|D}| |||d n t|dkrv|\}|S|j |r|j sdSd |vrdSd|dfS) Nrr7=rz4ambiguous option: %(option)s could match %(matches)srcss|]\}}}|VqdSr0r)rIrr/rrrrsz1MyOptionParser._parse_optional..)r/matchesr) prefix_chars_option_string_actionsrrr startswith_get_option_tuplesrrr_negative_number_matchermatch_has_negative_number_optionals) rraction option_string explicit_arg option_tuplesr|rX option_tuplerrr_parse_optionals>            zMyOptionParser._parse_optionalru)rrrrr rrrr.r rr ryrzrQsys version_inforActionr __classcell__rrrrrTs:   rTcsNeZdZdZdededdffdd Zdejdeffd d 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. rAkwargsrNcs,d|vr tj|d<tj|i|dS)Nwidth)_pytest_ioZget_terminal_widthrr.)rrArrrrr.sz%DropShorterLongHelpFormatter.__init__rc sft|}|r|ddkr|St|dd}|r|S|d}t|dkr:t|ddks5t|ddkr:||_|Sg}i}|D]9}t|dksN|ddkrOq@|ds[td |||dd}|dd } | |vsut|| t|kry||| <q@|D],}t|dks|ddkr| ||dd| |dd kr| |dd dq|d |} | |_| S) Nrr_formatted_action_invocationrrr7rrz)long optional argument without "--": [%s]r3r) r_format_action_invocationrcrrrrr{rrsrr) rrZorgstrresrXZ return_listZ short_longr/ZxxoptionZ shortenedZformatted_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_liness  z)DropShorterLongHelpFormatter._split_lines) rrrrwrr.ryrrrrrrrrrrs &r)%ryrrFrtypingrrrrrrr r r r r rrZ _pytest._iorZ_pytest.config.exceptionsrZ_pytest.deprecatedrr\rrqrrr Exceptionr{r#r&ArgumentParserrT HelpFormatterrrrrrsH                >  ]5V