֎jzGddlmZddlZddlmZddlmZddlZddlZddlZddl m Z ddl m Z ddl m Z ddl m Z d d lmZddlZdd lmZdd lmZd Ze GddZddZGddZGddZGddejZGddejZGddejZ dS) ) annotationsN)Callable)Sequence)Any)final)Literal)NoReturn) UsageError)NOTSET)check_ispytest file_or_dirceZdZdZ d2dddd3dZed4dZejd5dZd6dZ d7d8dZ d9dZ d:d;d%Z d:d;d&Z d:dParserzParser 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 _ispytestusage str | None processopt!Callable[[Argument], None] | NonerrboolreturnNonec|t|ddlm}||_i|_t ||j||_|jd}t|d|d|_ |j g|_ i|_ |j td }||_i|_i|_dS) 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)selfrrrrranonymous_arggroupfile_or_dir_args GC:\Projects\DSCons\.venv\Lib\site-packages\_pytest\config\argparsing.py__init__zParser.__init__ s y!!!777777%*,-eT_4PPP!^>>?OPP%  dd   ( )+.55k5MM$2!9; ,.strc|jjSNr%rr/s r2rz Parser.prog=s ~""r4valuec||j_dSr7r8)r/r:s r2rz Parser.progAs#r4optionArgumentcT|jr|jr||dSdSdSr7)r"dest)r/r<s r2 processoptionzParser.processoptionEsE   ){ )  ((((( ) ) ) )r4name descriptionafterr'c|jD]}|j|kr|cS|j|p|}t |||d}d}t |jD]\}}|j|krn|j|dz||jj|dz|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(rBr%r&r' enumerateinsert_action_groupspop)r/rBrCrDgrouparggroupigrps r2getgroupzParser.getgroupJs\  EzT!! ">44[5HDIIHdDDAAA  --  FAsx5  ! AE5))) %,,QUDN4Q4U4U4W4WXXX r4optsattrsrc*|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 addoptionr/rOrPs r2rRzParser.addoptionis$ "!41511111r4args Sequence[str | os.PathLike[str]] namespaceargparse.Namespace | Noneargparse.Namespacecddlm}||jd|D}|tj} d|_|j|||`S#|`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_argcompletec6g|]}tj|Sosfspath.0xs r2 z Parser.parse.. ...A29Q<<...r4NTrV)r!rZr%argparse Namespace_raise_print_helpparse_intermixed_args)r/rTrVrZstrargss r2parsez Parser.parseys 988888'''.....   *,,I ,*.I '>7797UU++ + + + + +s "AA"c<|||dS)zbParse the known arguments at this point. :returns: An argparse namespace object. rer)parse_known_and_unknown_args)r/rTrVs r2parse_known_argszParser.parse_known_argss"000KKANNr4$tuple[argparse.Namespace, list[str]]cd|D}tjdksdtjcxkrdkrqnnn|j||\}}|Jt |t }g}|D].}|dr|n||/||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. c6g|]}tj|Sr\r]r`s r2rcz7Parser.parse_known_and_unknown_args..rdr4) )rr )rrrur N-) sys version_infor%rngetattrr+ startswithappendparse_known_intermixed_args)r/rTrVrjunknownr unknown_flagsargs r2rmz#Parser.parse_known_and_unknown_argss/....  j ( (Gs7G,T,T,T,T*,T,T,T,T,T!%!@!@)!T!T Iw(((!)[99K')M T T"%.."5"5F;NNsSSSSm+ +>==gyQQ Qr4r\)aliaseshelptypeYLiteral['string', 'paths', 'pathlist', 'args', 'linelist', 'bool', 'int', 'float'] | Nonedefaultr Sequence[str]c|dvsJ|d}|turt|}|||f|j|<|D]X}||jvrtd|d|j|x}t|d|||j|<YdS)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) `. ) NstringpathspathlistrTlinelistrintfloatNrzalias z- conflicts with existing configuration optionz is already an alias of )r get_ini_default_for_typer- ValueErrorr.get)r/rBrrrraliasalreadys r2addiniz Parser.addinisn       <D f  .t44G#T73 d , ,E %% SUSSS ,00777D E!P!PW!P!PQQQ'+D e $ $ , ,r4)NN) rrrrrrrrrrrr5)r:r5rr)r<r=rr)rAN)rBr5rCr5rDrrr'rOr5rPrrrr7)rTrUrVrWrrX)rTrUrVrWrro) rBr5rr5rrrrrrrr)__name__ __module__ __qualname____doc__r3propertyrsetterr@rNrRrkrnrmr rr\r4r2rrsy!8</   //////:###X# [$$$[$)))) EI>2222&04,,,,,604 O O O O O04RRRRR@P,"$P,P,P,P,P,P,P,P,r4rrRLiteral['string', 'paths', 'pathlist', 'args', 'linelist', 'bool', 'int', 'float']rrcB|dvrgS|dkrdS|dkrdS|dkrdSdS) zs Used by addini to get the default value for a given config option type, when default is not supplied. )rrrTrrFrrrgrAr\)rs r2rrsD 888 u q srr4czeZdZdZddZddZdd Zedd ZeddZ eddZ ddZ dS)r=z$An option defined in an OptionGroup.actionargparse.Actionrrc||_dSr7)_action)r/rs r2r3zArgument.__init__ s  r4dict[str, Any]c|jjSr7)r__dict__r9s r2rPzArgument.attrs#s |$$r4rc|jjSr7)roption_stringsr9s r2nameszArgument.names&s |**r4r5c|jjSr7)rr?r9s r2r?z Argument.dest) |  r4rc|jjSr7)rrr9s r2rzArgument.default-s |##r4 Any | Nonec|jjSr7)rrr9s r2rz Argument.type1rr4ct|dd}|dSg}|dt|zgz }|dt|jzgz }|jr|dt|jzgz }|dt|jzgz }dd|S) NrzArgument()zopts: zdest: ztype: z default: z Argument({}), )ryreprrr?rrformatjoin)r/rrTs r2__repr__zArgument.__repr__5sy$// >.. D...// DOO+,, ; 1 XTY/0 0D tDL11122$$TYYt__555r4N)rrrr)rr)rrr)rr)rr) rrrrr3rPrrr?rrrr\r4r2r=r=s..%%%%++++!!!X!$$$X$!!!X! 6 6 6 6 6 6r4r=c6eZdZdZ ddd ZddZddZddZdS)r'z,A group of options shown in its own section.FrKargparse._ArgumentGrouprBr5parser Parser | Nonerrrrc\t|||_||_g|_||_dSr7)r _arggrouprBoptionsr)r/rKrBrrs r2r3zOptionGroup.__init__Es2 y!!!! ')  r4rOrPrct|d|jD}|rtd|d|||ddS)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. c3HK|]}|D]}|VdSr7)r)raoptrBs r2 z(OptionGroup.addoption..asO* * SYY[[* * -1D* * * * * * * r4z option names z already addedFallow_reservedN)set intersectionrr_addoption_inner)r/rOrPconflicts r2rRzOptionGroup.addoptionRst99))* *  L* * *     GEXEEEFF F dE%@@@@@r4c6|||ddS)z}Like addoption(), but also allows registering short lower case options (e.g. -x), which are reserved for pytest core.TrN)rrSs r2 _addoptionzOptionGroup._addoptionhs% dE$?????r4tuple[str, ...]rrc|sM|D]J}t|dkr5|ddkr)|drtdK|jj|i|}t |}|j||jrG| D]}|j |jj |<|j |dSdS)Nrrvr z$lowercase short options are reserved) lenislowerrrr*r=rr{rrr?r)r@)r/rOrPrrrr<rBs r2rzOptionGroup._addoption_innerms M M Ms88q==SVs]]s1v~~7G7G]$%KLLL,,d.sC$$"&!Q Q ! $$$$$$r4)rr#rsorteditemsr format_usage)r/rmsgs r2errorzPytestArgumentParser.errors..W.. ?  4$))$$*01F1F1H1H*I*I$$$ C**,,s2333r4)rrr#rrrrr)rr5rr )rrrr3r __classcell__rs@r2r$r$~s`  %%%%%%%%& 4 4 4 4 4 4 4 4r4r$c8eZdZdZdfd 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. rTrkwargsrrcd|vr!tj|d<tj|i|dS)Nwidth)_pytest_ioget_terminal_widthrr3)r/rTrrs r2r3z%DropShorterLongHelpFormatter.__init__sG & %k<<>>F7O$)&)))))r4rrr5ct|}|r|ddkr|S|d}t|dkr4t|ddkst|ddkr|Sg}i}|D]}t|dks |ddkr"|dsJd|d |dd}|dd }||vs&t||t|kr|||<|D]}t|dks |ddkr|||dd||dd kr*||dd dd|S) Nrrvrrr  z--z&long optional argument without "--": []rA=) r_format_action_invocationsplitrrzreplacer{rr) r/rorgstrr return_list short_longr<xxoption shortenedrs r2rz6DropShorterLongHelpFormatter._format_action_invocations226::  fQi3&&M,,t$$ w<<1  #gaj//Q"6"6#gaj//Q:N:NM %'  1 1F6{{a6!9#3#3$$T**  BBBB  *abbzH ((b11I **c*Y2G.H.H3LL//)1 9% @ @F6{{a6!9#3#3""6***abbzZ^^FNN3,C,CDDDD""6>>#sA#>#>???yy%%%r4textrr list[str]cg}|D]<}|tj||=|S)z}Wrap lines after splitting on original newlines. This allows to have explicit line breaks in the help text. ) splitlinesextendtextwrapwrapstrip)r/rrlineslines r2 _split_linesz)DropShorterLongHelpFormatter._split_linessP OO%% = =D LLtzz||U;; < < < < r4)rTrrrrr)rrrr5)rr5rrrr)rrrrr3rrrrs@r2rrsy ****** &&&&&&>r4rc0eZdZdZ ddfd ZddZxZS)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. Nrrr?r5r int | str | None ini_option ini_valuerrcbtj||dg|Ri|||_||_dS)Nr)rr3rr) r/rr?r rrrTrrs r2r3zOverrideIniAction.__init__sB qB4BBB6BBB$"r4rargparse.ArgumentParserrVrXct||jdt|dd}|g}||jd|jt|d|dS)NT override_inir)setattrr?ryr{rr)r/rrVrTrcurrent_overridess r2__call__zOverrideIniAction.__call__su  49d+++#I~tDD  $ "   DO!F!Fdn!F!FGGG >+<=====r4r7) rrr?r5r rrr5rr5rr)rrrVrXrr)rrrrr3r rrs@r2rrse#' # # # # # # # > > > > > > > >r4r)rrrr)! __future__rrfcollections.abcrrr^rwrtypingrrrr exceptionsr _pytest._ior_pytest.compatr _pytest.deprecatedr r+rrr=r'ArgumentParserr$ HelpFormatterrActionrr\r4r2rs%""""""$$$$$$$$$$$$ """"""!!!!!!------ l,l,l,l,l,l,l,l,^*"6"6"6"6"6"6"6"6J9.9.9.9.9.9.9.9.x4444482444@444448#9444n">">">">">">">">">">r4