׎jilddlmZddlZddlmZddlmZddlmZddlmZddlm Z ddlm Z ddl Z ddl Z dd l m Z dd lmZdd lmZdd lmZdd lmZddlmZddlmZddlZddlZddlZddlmZddlmZddlmZddlmZddlmZddlm Z ddlm!Z!ddl"m#Z#ddl"m$Z$ddl%m&Z&ddl%m'Z'ddl%m(Z(ddl)m*Z*ddl+m,Z,ddl-m.Z.ddl/m0Z0er dd l1m2Z2dd!l3m4Z4d"Z5dDd'Z6e ej7j8Z9ed(Z:ed)d*+Z;Gd,d-ej<Z=Gd.d*ej>e=/Z?dEd2Z@Gd3d4e?ej>ZAe d56dFd;ZBGd<d=eAej>ZCGd>d?eCej>ZDGd@dAeCej>ZEGdBdCe?ej>ZFdS)G) annotationsN)Callable)Iterable)Iterator)MutableMapping)cached_property) lru_cache)Path)Any)cast)NoReturn)overload) TYPE_CHECKING)TypeVar) getfslineno) ExceptionInfo) TerminalRepr) Traceback)TracebackStyle) LEGACY_PATH) signature)Config)ConftestImportFailure)Mark) MarkDecorator) NodeKeywords)fail) absolutepath)Stash) PytestWarning)Self)Session/pathstr | os.PathLike[str]returnstrc\tj|dtS)aNormalize path separators to forward slashes for nodeid compatibility. Replaces backslashes with forward slashes. This handles both Windows native paths and cross-platform data (e.g., Windows paths in serialized test reports when running on Linux). :param path: A path string or PathLike object. :returns: String with all backslashes replaced by forward slashes. \)osfspathreplaceSEPr$s ;C:\Projects\DSCons\.venv\Lib\site-packages\_pytest\nodes.pynorm_sepr05s" 9T?? " "4 - --_T _NodeTypeNode)boundc,eZdZdZd dZd fd ZxZS) NodeMetaaMetaclass used by :class:`Node` to enforce that direct construction raises :class:`Failed`. This behaviour supports the indirection introduced with :meth:`Node.from_parent`, the named constructor to be used instead of direct construction. The design decision to enforce indirection with :class:`NodeMeta` was made as a temporary aid for refactoring the collection tree, which was diagnosed to have :class:`Node` objects whose creational patterns were overly entangled. Once the refactoring is complete, this metaclass can be removed. See https://github.com/pytest-dev/pytest/projects/3 for an overview of the progress on detangling the :class:`Node` classes. r&r crd|jd|j}t|ddS)NzDirect construction of {name} has been deprecated, please use {name}.from_parent. See https://docs.pytest.org/en/stable/deprecations.html#node-construction-changed-to-node-from-parent for more details..nameF)pytrace)format __module____name__r)clskkwmsgs r/__call__zNodeMeta.__call__ZsJ ! &88#,88& 9 9 S%      r1r@type[_T]r2c r tj|i|S#t$rtt |dfd|D}ddlm}tj ||dt|dtj|i|cYSwxYw)N__init__c.i|]\}}|jv||S) parameters).0rAvsigs r/ z$NodeMeta._create..hs+KKKAqCN7J7J17J7J7Jr1)PytestDeprecationWarningz7 is not using a cooperative constructor and only takes z. See https://docs.pytest.org/en/stable/deprecations.html#constructors-of-custom-pytest-node-subclasses-should-take-kwargs for more details.) superrD TypeErrorrgetattritems warning_typesrPwarningswarnset)r@rArBknown_kwrPrM __class__s @r/_createzNodeMeta._createcs 4#577#Q-"-- - 4 4 4GC4455CKKKKKKKH ? ? ? ? ? ? M((((SVW_S`S`(((   $577#Q3(33 3 3 3 4sBB65B6)r&r )r@rEr&r2)r?r> __qualname____doc__rDr[ __classcell__rZs@r/r7r7Ks[  !!!!4444444444r1r7cReZdZUdZded<dZ dKdLdZedMdZe dNdZ dOdZ dPdZ e dOdZ dQdZdRd ZdRd!ZdSd#ZdTd%ZdUdVd+ZdWdXd-Z dWdYd/ZedZd1Zed[d4ZdWd\d5Zd]d7Zd^d9Zd_d<Zd`d@ZdadDZ dWdbdHZ dWdcdJZdS)dr4zBase class of :class:`Collector` and :class:`Item`, the components of the test collection tree. ``Collector``\'s are the internal nodes of the tree, and ``Item``\'s are the leaf nodes. rr+)__dict___nodeid_storeconfigr;parentr$sessionNr;r're Node | Nonerd Config | NonerfSession | NoneNoner$ Path | Nonenodeid str | Noner&c||_||_|r||_n|std|j|_|r||_n|std|j|_| |J|j}||_t ||_g|_t|_ |d|vsJ||_ n2|jstd|jj dz|jz|_ t|_|j|_dS)Nz!config or parent must be providedz"session or parent must be providedz::()z!nodeid or parent must be providedz::)r;rerdrRrfr$rkeywords own_markersrXextra_keyword_matchesrbrlrstashrc)selfr;rerdrfr+r$rls r/rGz Node.__init__s,   ("(DKK E CDDD -DK  *$+DLL F DEEE!>DL <%%%;D"& 3?t2D2D (*03uu"  ''''!DLL; E CDDD;-4ty@DL"GG j r1r!c ld|vrtdd|vrtd|jdd|i|S)a:Public constructor for Nodes. This indirection got introduced in order to enable removing the fragile logic from the node constructors. Subclasses can use ``super().from_parent(...)`` when overriding the construction. :param parent: The parent node of this Node. rdz.config is not a valid argument for from_parentrfz/session is not a valid argument for from_parentrerI)rRr[)r@rerBs r/ from_parentzNode.from_parentsQ r>>LMM M ??MNN Ns{//&/B///r1pluggy.HookRelayc@|j|jS)z4Path-sensitive hook proxy used to call pytest hooks.)rf gethookproxyr$rss r/ihookz Node.ihooks|((333r1c`d|jjt|ddS)Nz<{} {}>r;)r=rZr?rSrys r/__repr__z Node.__repr__s) 7vt9T9TUUUr1warningWarningct|tstd|t|\}}|Jt j|dt ||dzdS)awIssue a warning for this Node. Warnings will be displayed after the test session, unless explicitly suppressed. :param Warning warning: The warning instance to issue. :raises ValueError: If ``warning`` instance is not a subclass of Warning. Example usage: .. code-block:: python node.warn(PytestWarning("some message")) node.warn(UserWarning("some message")) .. versionchanged:: 6.2 Any subclass of :class:`Warning` is now accepted, rather than only :class:`PytestWarning ` subclasses. z8warning must be an instance of Warning or subclass, got NrO)categoryfilenamelineno) isinstancer~ ValueErrorget_fslocation_from_itemrV warn_explicitr')rsr}r$rs r/rWz Node.warns,'7++ V7VV 055 f!!! YYA:       r1c|jS)z;A ::-separated string denoting its collection tree address.)rbrys r/rlz Node.nodeids |r1intc*t|jSN)hashrbrys r/__hash__z Node.__hash__sDL!!!r1cdSrrIrys r/setupz Node.setup r1cdSrrIrys r/teardownz Node.teardownrr1Iterator[Node]c#0K|}||V|j}| dSdS)zIterate over all parent collectors starting from and including self up to the root of the collection tree. .. versionadded:: 8.1 N)re)rsres r/ iter_parentszNode.iter_parentss7 # LLL]F     r1 list[Node]cvg}|}||||j}|||S)zxReturn a list of all parent collectors starting from the root of the collection tree down to and including self.)appendrereverse)rschainitems r/ listchainzNode.listchain)sI  LL   ;D   r1Tmarkerstr | MarkDecoratorrboolcPddlm}t|tr|}n5t|trt ||}nt d||j|j<|r!|j |j dS|j d|j dS)zDynamically add a marker object to the node. :param marker: The marker. :param append: Whether to append the marker, or prepend it. r)MARK_GENz'is not a string or pytest.mark.* MarkerN) _pytest.markrrrr'rSrror;rprmarkinsert)rsrrrmarker_s r/ add_markerzNode.add_marker4s *))))) fm , , HGG  $ $ Hh//GGFGG G&- gl#  5   # #GL 1 1 1 1 1   # #Aw| 4 4 4 4 4r1Iterator[Mark]cBd||DS)zIterate over all markers of the node. :param name: If given, filter the results by the name attribute. :returns: An iterator of the markers of the node. c3&K|] }|dV dS)rONrIrKxs r/ z$Node.iter_markers..Ps&EE!EEEEEEr1r:)iter_markers_with_nodersr;s r/ iter_markerszNode.iter_markersJs* FEd99t9DDEEEEr1Iterator[tuple[Node, Mark]]c#K|D])}|jD]}|t|dd|kr||fV *dS)zIterate over all markers of the node. :param name: If given, filter the results by the name attribute. :returns: An iterator of (node, mark) tuples. Nr;)rrprS)rsr;noders r/rzNode.iter_markers_with_nodeRsp%%'' % %D( % %<74#>#>$#F#F*$$$ % % %r1 Mark | NonecdSrrIrs r/get_closest_markerzNode.get_closest_marker_s >D  ! !$"< = = = =r1 list[str]c>d|DS)Ncg|] }|j SrIr:rs r/ z"Node.listnames..vs1111111r1)rrys r/ listnameszNode.listnamesus 11 0 01111r1finCallable[[], object]cF|jj||dS)zRegister a function to be called without arguments when this node is finalized. This method can only be called when this node is active in a setup chain, for example during self.setup(). N)rf _setupstate addfinalizer)rsrs r/rzNode.addfinalizerxs%  --c488888r1r@type[_NodeType]_NodeType | Nonec\|D]}t||r|cSdS)zGet the closest parent node (including self) which is an instance of the given class. :param cls: The node class to search for. :returns: The node, if found. N)rr)rsr@rs r/ getparentzNode.getparentsD%%''  D$$$   tr1excinfoExceptionInfo[BaseException]rc|jSr) traceback)rsrs r/_traceback_filterzNode._traceback_filters   r1styleTracebackStyle | Nonerc \ddlm}t|jtrt j|jj}t|jtj r|jj sd}t|j|r|j S|j ddrd}d}n|j}|dkrd}|$|j ddd krd }nd}|j d krd}nd }|j d krdnd } t!t#j|j jjk}n#t*$rd }YnwxYw|d ||j d d||||S)Nr)FixtureLookupErrorvalue fulltraceFlongautotbstyleshortrOT showlocals)funcargsabspathrrtbfiltertruncate_locals truncate_args)_pytest.fixturesrrrrrfrom_exceptioncauser Exceptionr< formatreprrd getoptionr get_verbosityr r*getcwdinvocation_paramsdirOSErrorgetrepr)rsrrrrrrrs r/_repr_failure_pyzNode._repr_failure_pys 877777 gm%: ; ; H#27=3FGGG gmT^ 4 4 =(  gm%7 8 8 .=++-- - ; e 4 4 EHH-H ={$$Y777BB ; $ $ & & * *#OO"O!%!:!:!r\r]__annotations__ __slots__rG classmethodrupropertyrzr|rWrlrrrrrrrrrrrrrrrrrrIr1r/r4r4ws I# $"& !<!<!<!<!<!|000[0"444X4VVVV! ! ! ! JX""""         # # # #    55555,FFFFF"& % % % % %???X? GGGXG;;;;;22229999    !!!! (,8 8 8 8 8 z(, 5 5 5 5 5 5 5r1) metaclassrtuple[str | Path, int | None]ct|dd}| |ddSt|dd}|t|St|dddfS)aTry to extract the actual location from a node, depending on available attributes: * "location": a pair (path, lineno) * "obj": a Python object that the node wraps. * "path": just a path :rtype: A tuple of (str|Path, int) with filename and 0-based line number. locationNrobjr$zunknown location)rSr)rrrs r/rrse4;4T3R3RH| $t $ $C 3 4!3 4 4b 88r1c`eZdZdZGddeZejddZdd Z dd Z d S) CollectorzBase class of all collectors. Collector create children through `collect()` and thus iteratively build the collection tree. ceZdZdZdS)Collector.CollectErrorz6An error during collection, contains a custom message.Nr?r>r\r]rIr1r/ CollectErrorrsDDDDr1rr&Iterable[Item | Collector]c td)z;Collect children (items and collectors) for this collector.abstractNotImplementedErrorrys r/collectzCollector.collects"*---r1rrrc"t|j|jr<|jdds!|j}t |jdS|jdd}|dkrd}|||S)zyReturn a representation of a collection failure. :param excinfo: Exception information for the failure. rFrrrr)r)rrrrdrr'argsr)rsrexcrs r/rzCollector.repr_failures gmT%6 7 7 $ @U@U A A  $-Csx{## #+'' 6:: f  G$$WG$<<r\r]rrabcabstractmethodr rrrIr1r/rrs EEEEEyEEE .... ====*!!!!!!r1ri)maxsize initial_pathsfrozenset[Path]r rmcv||vrdS|jD]*}||vr$t||cS+dS)N)parentsr' relative_to)rr$res r/_check_initialpaths_for_relpathrs^ }r,11 ] " "t''//00 0 0 0 # 4r1cZeZdZdZ ddfd ZeddddfdZxZS) FSCollectorz%Base class for filesystem collectors.Nr+rjpath_or_parentPath | Node | Noner$rkr;rmrergrdrhrfrirlr&c |rJt|tr|Jtt|}nt|tr|J|}|J|^|j}|U|j|krJ ||j} t| }n#t$rYnwxYwt|}||_| |J|j }|i t|j|j j }n%#t$rt|j|}YnwxYw|rt|}t!||||||dS)N)r;rerdrfrlr$)rr4r r r r;r$rr'rr0rfrdrootpathr _initialpathsrQrG) rsr+r!r$r;rerdrfrlrelrZs r/rGzFSCollector.__init__+s  &.$// &~~~k>::ND11 &|||% <9D!fkT&9&9$**6;77Cs88DD"D ~~ ?%%%nG > VTY227>3JKKLL V V V89NPTUU V *!&))       s$)B B B  1C;;DD)r+r$r!c >tjd|||d|S)zThe public constructor.)rer+r$rI)rQru)r@rer+r$rBrZs r/ruzFSCollector.from_parentas+#uww"Q&dQQbQQQr1)NNNNNNNN)r+rjr!r"r$rkr;rmrergrdrhrfrirlrmr&rj)r+rjr$rkr&r!)r?r>r\r]rGrrur^r_s@r/r r (s//-1 " $"&!4 4 4 4 4 4 4 l  R R R R R R R[ R R R R Rr1r ceZdZdZdS)FilezOBase class for collecting tests from a file. :ref:`non-python tests`. NrrIr1r/r)r)nsr1r)ceZdZdZdS) DirectoryaBase class for collecting files from a directory. A basic directory collector does the following: goes over the files and sub-directories in the directory and creates collectors for them by calling the hooks :hook:`pytest_collect_directory` and :hook:`pytest_collect_file`, after checking that they are not ignored using :hook:`pytest_ignore_collect`. The default directory collectors are :class:`~pytest.Dir` and :class:`~pytest.Package`. .. versionadded:: 8.0 :ref:`custom directory collectors`. NrrIr1r/r+r+usr1r+ceZdZdZdZ ddfd Zdd Zejdd Z ddZ ddZ e ddZ xZS)ItemzBase class of all test invocation items. Note that for a single function there might be multiple test invocation items. Nrdrhrfrirlrmr&rjc tj||f|||d|g|_g|_|dS)N)rdrfrl)rQrG_report_sectionsuser_properties-_check_item_and_collector_diamond_inheritance)rsr;rerdrfrlrBrZs r/rGz Item.__init__sq           =?:< ::<<<<.sG  "z$ 7R7R M      r1zF is an Item subclass and should not be a collector, however its bases z are collectors. Please split the Collectors and the Item into separate node types. Pytest Doc example: https://docs.pytest.org/en/latest/example/nonpython.html example pull request on a plugin: https://github.com/asmeurer/pytest-flakes/pull/40/) typerSsetattrjoin __bases__rVrWr?r )rsr@ attr_nameproblemss r/r1z2Item._check_item_and_collector_diamond_inheritances 4jj @ 3 5 ) )  FY%%%99  &)m        M<gg%-ggg         r1c td)zRun the test case for this item. Must be implemented by subclasses. .. seealso:: :ref:`non-python tests` z,runtest must be implemented by Item subclassrrys r/runtestz Item.runtests""PQQQr1whenr'keycontentcH|r|j|||fdSdS)aAdd a new report section, similar to what's done internally to add stdout and stderr captured output:: item.add_report_section("call", "stdout", "report section contents") :param str when: One of the possible capture states, ``"setup"``, ``"call"``, ``"teardown"``. :param str key: Name of the section, can be customized at will. Pytest uses ``"stdout"`` and ``"stderr"`` internally. :param str content: The full contents as a string. N)r/r)rsr?r@rAs r/add_report_sectionzItem.add_report_sections:  ?  ! ( ($W)= > > > > > ? ?r1.tuple[os.PathLike[str] | str, int | None, str]c|jddfS)aPGet location information for this item for test reports. Returns a tuple with three elements: - The path of the test (default ``self.path``) - The 0-based line number of the test (default ``None``) - A name of the test to be shown (default ``""``) .. seealso:: :ref:`non-python tests` Nrr.rys r/ reportinfozItem.reportinfosy$""r1tuple[str, int | None, str]c|}t|d}|j|}t |dt usJ||d|dfS)z Returns a tuple of ``(relfspath, lineno, testname)`` for this item where ``relfspath`` is file path relative to ``config.rootpath`` and lineno is a 0-based line number. rrrO)rFrrf_node_location_to_relpathr7r')rsrr$ relfspaths r/rz Item.locationsk??$$HQK((L::4@@ HQK  C''''8A; 44r1)NNNN)rdrhrfrirlrmr&rjr)r?r'r@r'rAr'r&rj)r&rD)r&rG)r?r>r\r]nextitemrGr1rrr>rCrFrrr^r_s@r/r-r-s H  $"&! =======:: RRRR????" # # # # 5 5 5_ 5 5 5 5 5r1r-)r$r%r&r')rr4r&r)rrr$r r&rm)G __future__rrcollections.abcrrrr functoolsrr r*pathlibr typingr r r rrrrVpluggy _pytest._code_pytestr_pytest._code.coderrrr_pytest.compatrr_pytest.configrr_pytest.mark.structuresrrr_pytest.outcomesr_pytest.pathlibr _pytest.stashr_pytest.warning_typesr typing_extensionsr! _pytest.mainr"r-r0__file__rerr2r3ABCMetar7ABCr4rrrr r)r+r-rIr1r/ras"""""" $$$$$$$$$$$$$$$$$$******%%%%%%   %%%%%%,,,,,,++++++((((((------&&&&&&$$$$$$!!!!!!000000((((((111111000000!!!!!!((((((//////%&&&&&&%$$$$$  . . . .$w'((/ WT]] GKv . . . )4)4)4)4)4s{)4)4)4X^5^5^5^5^537h^5^5^5^5B 9999&,!,!,!,!,!cg,!,!,!^ 4    CRCRCRCRCR)SWCRCRCRL; SW$u5u5u5u5u54u5u5u5u5u5r1