iOddlmZddlZddlmZddlmZddlmZddlZddlZddl m Z ddl m Z ddl m Z dd l m Z d d lmZddlZdd lmZd ZGddZeZe GddZd#dZGddeZGddZGddZGddejZGdd ejZ Gd!d"ej!Z"dS)$) annotationsN)Callable)Mapping)Sequence)Any)final)Literal)NoReturn) UsageError)check_ispytest file_or_dirceZdZddZdS)NotSetreturnstrcdS)Nzselfs V/root/projects/qq-shell/venv/lib/python3.11/site-packages/_pytest/config/argparsing.py__repr__zNotSet.__repr__szNrr)__name__ __module__ __qualname__rrrrrrs(rrceZdZdZ d1ddd2d Zed3dZejd4dZd5dZ d6d7dZ d8dZ d9d:d$Z d9d:d%Z d9d;d'Z defd(d)d value to display in case there's an error processing the command line arguments. NF _ispytestusage str | None processopt!Callable[[Argument], None] | Noner!boolrNoneclt|ddlm}||_i|_t |||j|_|jd}t|d|d|_ |j g|_ |j td}||_ 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)rr"r$r!r)anonymous_arggroupfile_or_dir_args r__init__zParser.__init__'s y!!!777777%*,-dE4?KK!^>>?OPP%  dd   ( .55k5MM$2!9; ,.rrc|jjSNr1progrs rr@z Parser.progAs ~""rvaluec||j_dSr>r?)rrAs rr@z Parser.progEs#roptionArgumentcT|jr|jr||dSdSdSr>)r.dest)rrCs r processoptionzParser.processoptionIsE   ){ )  ((((( ) ) ) )rname descriptionafterr3c|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``. Tr rr ) r4rIr1r2r3 enumerateinsert_action_groupspop)rrIrJrKgrouparggroupigrps rgetgroupzParser.getgroupNs\  EzT!! ">44[5HDIIHdDDAAA  --  FAsx5  ! AE5))) %,,QUDN4Q4U4U4W4WXXX roptsattrsrc*|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)rrVrWs rrYzParser.addoptionms$ "!41511111rargs 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|Srosfspath.0xs r z Parser.parse.. ...A29Q<<...rNTr\)r-r`r1argparse Namespace_raise_print_helpparse_intermixed_args)rrZr\r`strargss rparsez Parser.parse}s 988888'''.....   *,,I ,*.I '>7797UU++ + + + + +s "AA"c<|||dS)zbParse the known arguments at this point. :returns: An argparse namespace object. rjr)parse_known_and_unknown_args)rrZr\s rparse_known_argszParser.parse_known_argss"000KKANNr$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|Srrbres rrhz7Parser.parse_known_and_unknown_args..rir) )rw )rwrzr N-) sys version_infor1rsgetattrr6 startswithappendparse_known_intermixed_args)rrZr\rounknownr unknown_flagsargs rrrz#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 Qrr)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) `. ) NstringpathspathlistrZlinelistr&intfloatNrzalias z- conflicts with existing configuration optionz is already an alias of )NOT_SETget_ini_default_for_typer8 ValueErrorr9get)rrIrrrraliasalreadys raddiniz Parser.addinisn       <D g  .t44G#T73 d , ,E %% SUSSS ,00777D E!P!PW!P!PQQQ'+D e $ $ , ,r)NN)r"r#r$r%r!r&rr'r)rArrr')rCrDrr')rHN)rIrrJrrKr#rr3rVrrWrrr'r>)rZr[r\r]rr^)rZr[r\r]rrt) rIrrrrrrrrrrr')rrr__doc__r<propertyr@setterrGrUrYrprsrrrrrrrrrsv!8</  //////4###X# [$$$[$)))) EI>2222&04,,,,,604 O O O O O04RRRRR@P,"$P,P,P,P,P,P,P,P,rrrRLiteral['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. )rrrZrr&FrrrgrHr)rs rrr sD 888 u q srrc"eZdZdZd dZd d Zd S) ArgumentErrorzURaised if an Argument instance is created with invalid or inconsistent arguments.msgrrCArgument | strrr'c<||_t||_dSr>)rr option_id)rrrCs rr<zArgumentError.__init__%sVrcB|jrd|jd|jS|jS)Nzoption : )rrrs r__str__zArgumentError.__str__)s- > 9T^99tx99 98OrN)rrrCrrr'r)rrrrr<rrrrrr!sF%%%%rrc:eZdZdZddZdd Zdd ZddZddZdS)rDzClass 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 namesrrWrrr'c||_g|_g|_ |d|_n#t$rYnwxYw |d|_n#t$rYnwxYw|||d}|r ||_dS|jr0|jddd dd|_dS |jdd d|_dS#t$r}d |_td ||d}~wwxYw) z5Store params in private vars for use in add_argument.rrrFrNr{_r z???zneed a long or short option) _attrs _short_opts _long_optsrKeyErrorr_set_opt_stringsrrFreplace IndexErrorr)rrrWrFes rr<zArgument.__init__9sK &(%' f DII    D   +DLL    D  e$$$ 99V,,  PDIII _ P*122.66sC@@DIII P ,Q/3  P P P! #$A4HHaO Ps5 % 22 A AAC D'C??D list[str]c |j|jzSr>)rrrs rrzArgument.namesTs$/11rMapping[str, Any]c~ddd|jfD]+} t|||j|<#t$rY(wxYw|jS)NrrFr)rFr~rAttributeError)rattrs rrWzArgument.attrsWsb :  D $+D$$7$7 D!!!    {s ( 55rVrc|D]}t|dkrtd|d|t|dkrG|ddkr |ddkstd|d||j||ddd kr |ddkstd |d ||j|d 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 longrr{r 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)lenrrrr)rrVopts rrzArgument._set_opt_strings`s5  , ,C3xx!||#;S;;; SQA# #a&C--'HsHHH  '',,,,AaCD((SVs]]'CcCCC &&s++++- , ,rcg}|jr|dt|jzgz }|jr|dt|jzgz }|dt|jzgz }t |dr|dt|jzgz }t |dr|dt|jzgz }dd |S) Nz _short_opts: z _long_opts: zdest: rztype: rz default: z Argument({}), ) rreprrrFhasattrrrformatjoin)rrZs rrzArgument.__repr__}s   ? _tD,<'='==> >D ? = ^d4?&;&;;< )r _arggrouprIoptionsr)rrRrIrr!s rr<zOptionGroup.__init__s2 y!!!! ')  rrVrWrct|d|jD}|rtd|dt |i|}||ddS)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. c3HK|]}|D]}|VdSr>)r)rfrrIs r z(OptionGroup.addoption..sO* * SYY[[* * -1D* * * * * * * rz option names z already addedF shortupperN)set intersectionrrrD_addoption_instance)rrVrWconflictrCs rrYzOptionGroup.addoptionst99))* *  L* * *     GEXEEEFF F4)5))   E :::::rcLt|i|}||ddS)NTr)rDr)rrVrWrCs r _addoptionzOptionGroup._addoptions34)5))   D 99999rrCrDrcj|s?|jD]7}|ddkr)|drtd8|jr|j||jj|i||j |dS)Nrr{r zlowercase shortoptions reserved) rislowerrrrGrr5rrWrr)rrCrrs rrzOptionGroup._addoption_instances H) H Hq6S==SV^^%5%5=$%FGGG ; . K % %f - - -##V\\^^Fv||~~FFF F#####rN)F) rRrrIrrrr!r&rr'r)rCrDrr&rr')rrrrr<rYrrrrrr3r3sy66     ;;;;,:::: $ $ $ $ $ $ $rr3c(eZdZdfd Zdd ZxZS)r0rrr"r#r/dict[str, str]rr'cz||_t|dtdd||_dS)NF@)r"add_helpformatter_class allow_abbrevfromfile_prefix_chars)_parsersuperr<DropShorterLongHelpFormatterr/)rrr"r/ __class__s rr<zPytestArgumentParser.__init__sI   8"%    %rmessagerr c |jd|}|jrI|dddt|jDzz }t ||z)z1Transform argparse error message into UsageError.z : error:  c3,K|]\}}d|d|VdS)z rNr)rfkvs rrz-PytestArgumentParser.error..sC$$"&!Q Q ! $$$$$$r)r@r/rsorteditemsr format_usage)rrrs rerrorzPytestArgumentParser.errors..W.. ?  4$))$$*01F1F1H1H*I*I$$$ C**,,s2333r)rrr"r#r/rrr')rrrr )rrrr<r __classcell__rs@rr0r0sQ%%%%%%$44444444rr0c6eZdZdZd fd Zdfd Zd ZxZS)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. rZrkwargsrr'cd|vr!tj|d<tj|i|dS)Nwidth)_pytest_ioget_terminal_widthrr<)rrZrrs rr<z%DropShorterLongHelpFormatter.__init__sG & %k<<>>F7O$)&)))))ractionargparse.Actionrct|}|r|ddkr|St|dd}|r|S|d}t |dkr;t |ddkst |ddkr ||_|Sg}i}|D]}t |dks |ddkr"|dstd |d ||dd}|dd } | |vs&t || t |kr||| <|D]}t |dks |ddkr| ||dd| |dd kr*| |dd dd |} | |_| S) Nrr{_formatted_action_invocationrrr  rz&long optional argument without "--": []rH=) r_format_action_invocationr~splitrrrrrrrr) rrorgstrresr return_list short_longrCxxoption shortenedformatted_action_invocationrs rrz6DropShorterLongHelpFormatter._format_action_invocations<226::  fQi3&&M!&*H$OO  J,,t$$ w<<1  #gaj//Q"6"6#gaj//Q:N:N28F /M %'  1 1F6{{a6!9#3#3$$T** #FVFFFabbzH ((b11I **c*Y2G.H.H3LL//)1 9% @ @F6{{a6!9#3#3""6***abbzZ^^FNN3,C,CDDDD""6>>#sA#>#>???&*ii &<&<#.I+**rcddl}g}|D]=}||||>|S)z}Wrap lines after splitting on original newlines. This allows to have explicit line breaks in the help text. rN)textwrap splitlinesextendwrapstrip)rtextrr lineslines r _split_linesz)DropShorterLongHelpFormatter._split_liness[ OO%% = =D LLtzz||U;; < < < < r)rZrrrrr')rrrr)rrrrr<rrrrs@rrrsu****** $+$+$+$+$+$+L       rrc0eZdZdZ 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. Noption_stringsrrFrr,int | str | None ini_option ini_valuerr'cbtj||dg|Ri|||_||_dS)Nr)rr<rr) rrrFr,rrrZrrs rr<zOverrideIniAction.__init__(sB qB4BBB6BBB$"rrargparse.ArgumentParserr\r^ct||jdt|dd}|g}||jd|jt|d|dS)NT override_inir)setattrrFr~rrr)rrr\rZrcurrent_overridess r__call__zOverrideIniAction.__call__6su  49d+++#I~tDD  $ "   DO!F!Fdn!F!FGGG >+<=====rr>) rrrFrr,rrrrrrr')rrr\r^rr')rrrrr<rrrs@rrr se#' # # # # # # # > > > > > > > >rr)rrrr)# __future__rrkcollections.abcrrrrcr|typingrrr r exceptionsr _pytest._ior_pytest.deprecatedr r6rrrr ExceptionrrDr3ArgumentParserr0 HelpFormatterrActionrrrrr)s""""""$$$$$$######$$$$$$ """"""------  &((i,i,i,i,i,i,i,i,X*     I   X6X6X6X6X6X6X6X6v4$4$4$4$4$4$4$4$n4444482444:>>>>>8#9>>>B">">">">">">">">">">r