U 42iRP@sJddlmZddlZddlmZddlZddlZddlmZddlmZddlm Z ddlm Z ddlm Z dd lm Z dd lm Z dd lmZdd lmZddlZdd lmZddlmZdZGdddZeZe GdddZdddddZGdddeZGdddZGdddZGdd d ejZ Gd!d"d"ej!Z"dS)#) annotationsN)gettext)Any)Callable)cast)final)List)Literal)Mapping)NoReturn)Sequence) UsageError)check_ispytestZ file_or_dirc@seZdZddddZdS)NotSetstrreturncCsdS)Nzselfrr=/tmp/pip-unpacked-wheel-7n2p7kht/_pytest/config/argparsing.py__repr__szNotSet.__repr__N)__name__ __module__ __qualname__rrrrrrsrc@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)rr0rrr processoption<szParser.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(r5r& enumerateinsert)rr5r6r7groupigrprrrgetgroupAs    zParser.getgrouproptsattrsrcOs|jj||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@rArrrrB[szParser.addoptionz Sequence[str | os.PathLike[str]]argparse.Namespace | Noneargparse.Namespaceargs namespacercCs>ddlm}||_||jdd|D}|jj||dS)Nr)try_argcompletecSsg|]}t|qSrosfspath.0xrrr tsz Parser.parse..rG)_pytest._argcompleterH _getparser optparser parse_args)rrFrGrHstrargsrrrparseks    z Parser.parseMyOptionParserrc Csddlm}t||j|jd}|j|jf}|D]H}|jr0|jpD|j }| |}|jD] }| }| } |j || qVq0|j tdd} || _|S)Nr)filescompleter)r*)nargs)rQrXrWr-rr(r'optionsr6r5add_argument_groupnamesrA add_argument FILE_OR_DIRZ completer) rrXrSgroupsr;descZarggroupr0naZfile_or_dir_argrrrrRws    zParser._getparser list[str])rFr0rGrcCsB|j||d}|jD]\}}t|||qtttt|tS)NrP) rV__dict__itemssetattrrrrgetattrr_)rrFr0rGZ parsedoptionr5valuerrrparse_setoptionszParser.parse_setoptioncCs|j||ddS)zbParse the known arguments at this point. :returns: An argparse namespace object. rPr)parse_known_and_unknown_args)rrFrGrrrparse_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|qSrrIrLrrrrOsz7Parser.parse_known_and_unknown_args..rP)rRrl)rrFrGrSrUrrrrks z#Parser.parse_known_and_unknown_argsKLiteral[('string', 'paths', 'pathlist', 'args', 'linelist', 'bool')] | None)r5helptypedefaultrcCs<|dks t|tkrt|}|||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) `. )NstringpathspathlistrFlinelistr N)AssertionErrorNOT_SETget_ini_default_for_typer+r,append)rr5rnrorprrraddinis ' z Parser.addini)NN)r4N)N)N)N)N)rrr__doc__r__annotations__r.r3r>rBrVrRrjrlrkrvryrrrrr"s0   rrmr)rorcCs,|dkr dS|dkrgS|dkr$dSdSdS)zp Used by addini to get the default value for a given ini-option type, when default is not supplied. Nr4)rrrsrFrtr Fr)rorrrrwsrwc@s0eZdZdZddddddZddd d Zd S) ArgumentErrorzURaised if an Argument instance is created with invalid or inconsistent arguments.rzArgument | strr!)msgr0rcCs||_t||_dSr1)r}r option_id)rr}r0rrrr.szArgumentError.__init__rcCs$|jrd|jd|jS|jSdS)Nzoption : )r~r}rrrr__str__szArgumentError.__str__N)rrrrzr.rrrrrr|sr|c@s\eZdZdZddddddZdd d d Zd d d dZdddddZdd ddZdS)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 rrr!)r]rArc Os||_g|_g|_z|d|_Wntk r4YnXz|d|_Wntk rXYnX|||d}|rz||_nr|jr|jddd dd|_nNz|jdd d|_Wn4t k r}zd |_t d ||W5d}~XYnXdS) z5Store params in private vars for use in add_argument.rorpr2rN-_r8z???zneed a long or short option) _attrs _short_opts _long_optsroKeyErrorrp_set_opt_stringsgetr2replace IndexErrorr|)rr]rAr2errrr.s,  zArgument.__init__rdrcCs |j|jSr1)rrrrrrr]#szArgument.nameszMapping[str, Any]c CsNd}||j|D].}zt|||j|<Wqtk rDYqXq|jS)Nzdefault dest help)splitrxr2rhrAttributeError)rrAattrrrrrA&s zArgument.attrsz Sequence[str])r@rcCs|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 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)lenr|rrxr)rr@optrrrr1s&     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({}), ) rreprrr2hasattrrorpformatjoin)rrFrrrrNs  zArgument.__repr__N) rrrrzr.r]rArrrrrrr/s  r/c@sfeZdZdZdddddddd d d d Zdd d dddZdd d dddZdddd dddZdS)r&z,A group of options shown in its own section.r4NFrrz Parser | Noner r!)r5r6r%rrcCs$t|||_||_g|_||_dSr1)rr5r6r[r%)rr5r6r%rrrrr._s zOptionGroup.__init__rr?cOsJt|dd|jD}|r.td|dt||}|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[ ValueErrorr/_addoption_instance)rr@rAconflictr0rrrrBms zOptionGroup.addoptioncOst||}|j|dddS)NTr)r/r)rr@rAr0rrr _addoptions zOptionGroup._addoptionr/)r0rrcCsR|s0|jD]$}|ddkr |dr tdq |jrB|j||j|dS)Nrrr8zlowercase shortoptions reserved)rislowerrr%r3r[rx)rr0rrrrrrs   zOptionGroup._addoption_instance)r4N)F)rrrrzr.rBrrrrrrr&\sr&csheZdZddddddfdd Zd d d d d ZdddddddZejdkr`d ddddZZ S)rWNrzdict[str, Any] | Nonerr!)r%r-rrcs2||_tj||jdtddd|r(|ni|_dS)NF@)rr"add_helpformatter_class allow_abbrevfromfile_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] | NonerCrDrEc 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-rfrxrrhr_extend) rrFrGparsedZ unrecognizedarglineskvrrrrTszMyOptionParser.parse_args) z5tuple[argparse.Action | None, str, str | None] | None) arg_stringrc Cs|sdS|d|jkrdS||jkr8|j|}||dfSt|dkrHdSd|kr~|dd\}}||jkr~|j|}|||fS|js|ds||}t|dkrtd}ddd|D}| |||d nt|dkr|\}|S|j |r|j sdSd |krdSd|dfS) Nrr8=rz4ambiguous option: %(option)s could match %(matches)srcss|]\}}}|VqdSr1r)rMrr0rrrrsz1MyOptionParser._parse_optional..)r0matchesr) prefix_chars_option_string_actionsrrr startswith_get_option_tuplesrrr_negative_number_matchermatch_has_negative_number_optionals) rraction option_string explicit_arg option_tuplesr}r[ option_tuplerrr_parse_optionals>           zMyOptionParser._parse_optional)NN)NN) rrrr.rrTsys version_infor __classcell__rrrrrWs  rWcsFeZdZdZddddfdd 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!)rFkwargsrcs(d|krtj|d<tj||dS)Nwidth)_pytest_ioZget_terminal_widthrr.)rrFrrrrr.sz%DropShorterLongHelpFormatter.__init__zargparse.Actionr)rrc snt|}|r |ddkr |St|dd}|r4|S|d}t|dkrtt|ddksjt|ddkrt||_|Sg}i}|D]v}t|dks|ddkrq|dstd |d ||dd}|dd } | |kst|| t|kr||| <q|D]\}t|dks|ddkr&| ||dd| |dd kr| |dd dqd |} | |_| S) Nrr_formatted_action_invocationrrr8rrz&long optional argument without "--": []r4r) r_format_action_invocationrhrrrrr|rrxrr) rrZorgstrresr[Z return_listZ short_longr0ZxxoptionZ shortenedZformatted_action_invocationrrrrsD   ,       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)rrrrzr.rrrrrrrrs&r)# __future__rargparserrJrtypingrrrrrr r r r Z _pytest._iorZ_pytest.config.exceptionsr Z_pytest.deprecatedrr_rrvrrw Exceptionr|r/r&ArgumentParserrW HelpFormatterrrrrrs8             =]5X