a *jg@sddlmZddlZddlmZddlmZddlmZddlmZddlm 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/m0Z0dd l1m2Z2dd!l3m4Z4erdd"l5m6Z6dd#l7m8Z8d$Z9e ej:j;Zed-d.d/Z?Gd0d1d1ej@ZAGd2d.d.ejBeAd3ZCd.d4d5d6d7ZDGd8d9d9eCejBZEe d:d;dd?d@ZFGdAdBdBeEejBZGGdCdDdDeGejBZHGdEdFdFeGejBZIGdGdHdHeCejBZJdS)I) 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) _check_path)NODE_CTOR_FSPATH_ARG)Mark) MarkDecorator) NodeKeywords)fail) absolutepath)Stash) PytestWarning)Self)Session/_Tz type[Node] Path | NoneLEGACY_PATH | Noner ) node_typepathfspathreturncCsV|dur tjtj|jddd|dur>|dur:t|||S|dusJJt|SdS)N)Znode_type_name) stacklevel)warningswarnrformat__name__rr )r(r)r*r23E:\soccer\ml_env\Lib\site-packages\_pytest/nodes.py _imply_path<s  r4 _NodeTypeNode)boundcs6eZdZdZddddZdddfd d ZZS) 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+cOs*dj|jd|jd}t|dddS)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)r0 __module__r1r)clskkwmsgr2r2r3__call__cs zNodeMeta.__call__ztype[_T]r%r?r+c sztj|i|WStytt|dfdd|D}ddlm}t ||dt |dtj|i|YS0dS)N__init__cs i|]\}}|jvr||qSr2) parameters).0r@vsigr2r3 qz$NodeMeta._create..)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.) superrC TypeErrorrgetattritemsZ warning_typesrNr.r/set)r?r@rAZknown_kwrN __class__rIr3_createls   zNodeMeta._create)r1r> __qualname____doc__rCrV __classcell__r2r2rTr3r8Ts r8c @seZdZUdZded<dZd^dddd d d d d dddZedddddZe ddddZ ddddZ dd dddZ e dddd Z d!dd"d#Zd dd$d%Zd dd&d'Zd(dd)d*Zd+dd,d-Zd_d/d0d d1d2d3Zd`d d4d5d6d7Zdad d8d5d9d:Zedd;d5dd>d?d@d=Zdbdd;d;d?dAd=ZdBddCdDZdEddFdGZdHd dIdJdKZdLdMdNdOdPZdQdRdSdTdUZdcdQdVdWdXdYdZZdddQdVd[dXd\d]ZdS)er6zBase 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)sessionNstr Node | None Config | NoneSession | Noner'r& str | NoneNone)r<r^r]r_r*r)nodeidr+cCs||_||_|r||_n|s$td|j|_|r8||_n|sDtd|j|_|durh|durht|dd}tt|||d|_t ||_ g|_ t |_ |durd|vsJ||_n"|jstd|jjd|j|_t|_|j|_dS)Nz!config or parent must be providedz"session or parent must be providedr)r*z::()z!nodeid or parent must be providedz::)r<r^r]rPr_rQr4typer)rkeywords own_markersrSextra_keyword_matchesr[rfr stashr\)selfr<r^r]r_r*r)rfr2r2r3rEs4    z Node.__init__r")r^r+cKs4d|vrtdd|vr td|jfd|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. r]z.config is not a valid argument for from_parentr_z/session is not a valid argument for from_parentr^)rPrV)r?r^rAr2r2r3 from_parents zNode.from_parentzpluggy.HookRelayr9cCs|j|jS)z6fspath-sensitive hook proxy used to call pytest hooks.)r_Z gethookproxyr)rmr2r2r3ihooksz Node.ihookcCsd|jjt|ddS)Nz<{} {}>r<)r0rUr1rQror2r2r3__repr__sz Node.__repr__Warning)warningr+cCsNt|tstd|t|\}}|dus0Jtj|dt||dddS)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 NrM)categoryfilenamelineno) isinstancerr ValueErrorget_fslocation_from_itemr. warn_explicitr`)rmrsr)rvr2r2r3r/s   z Node.warncCs|jS)z;A ::-separated string denoting its collection tree address.)r[ror2r2r3rfsz Node.nodeidintcCs t|jSN)hashr[ror2r2r3__hash__sz Node.__hash__cCsdSr|r2ror2r2r3setup sz Node.setupcCsdSr|r2ror2r2r3teardown#sz Node.teardownzIterator[Node]ccs|}|dur|V|j}qdS)zIterate over all parent collectors starting from and including self up to the root of the collection tree. .. versionadded:: 8.1 N)r^)rmr^r2r2r3 iter_parents&szNode.iter_parentsz list[Node]cCs.g}|}|dur"|||j}q||S)zxReturn a list of all parent collectors starting from the root of the collection tree down to and including self.N)appendr^reverse)rmchainitemr2r2r3 listchain1s zNode.listchainTzstr | MarkDecoratorbool)markerrr+cCsnddlm}t|tr|}nt|tr2t||}ntd||j|j<|rZ|j |j n|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) Z _pytest.markrrwrr`rQrxrir<rjrmarkinsert)rmrrrZmarker_r2r2r3 add_marker<s     zNode.add_markerzIterator[Mark])r<r+cCsdd|j|dDS)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. css|]}|dVqdS)rMNr2rGxr2r2r3 XrLz$Node.iter_markers..r;)iter_markers_with_nodermr<r2r2r3 iter_markersRszNode.iter_markerszIterator[tuple[Node, Mark]]ccs@|D]2}|jD]&}|dus.t|dd|kr||fVqqdS)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<)rrjrQ)rmr<noderr2r2r3rZs  zNode.iter_markers_with_nodez Mark | NonecCsdSr|r2rr2r2r3get_closest_markergszNode.get_closest_markerr)r<defaultr+cCsdSr|r2rmr<rr2r2r3rjscCst|j|d|S)zReturn the first marker matching the name, from closest (for example function) to farther level (for example module level). :param default: Fallback return value if no marker was found. :param name: Name to filter by. r;)nextrrr2r2r3rmszset[str]cCs$t}|D]}||jq|S)z;Return a set of all extra keywords in self and any parents.)rSrupdaterk)rmZextra_keywordsrr2r2r3listextrakeywordsvs zNode.listextrakeywordsz list[str]cCsdd|DS)NcSsg|] }|jqSr2r;rr2r2r3 ~rLz"Node.listnames..)rror2r2r3 listnames}szNode.listnameszCallable[[], object])finr+cCs|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)r_Z _setupstate addfinalizer)rmrr2r2r3rszNode.addfinalizerztype[_NodeType]z_NodeType | NonerDcCs$|D]}t||r|SqdS)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)rrw)rmr?rr2r2r3 getparents   zNode.getparentExceptionInfo[BaseException]rexcinfor+cCs|jSr|) traceback)rmrr2r2r3_traceback_filterszNode._traceback_filterzTracebackStyle | Noner)rstyler+c Cs(ddlm}t|jtr&t|jj}t|jtj r@|jj s@d}t|j|rV|j S|j ddrnd}d}n|j}|dkrd}|dur|j ddd krd }nd}|j d krd}nd }|j d krdnd }ztt|j jjk}Wntyd }Yn0|jd ||j d d||||dS)Nr)FixtureLookupErrorvalue fulltraceFlongautotbstyleshortrMT showlocals)Zfuncargsabspathrrtbfiltertruncate_locals truncate_args)Z_pytest.fixturesrrwrrrfrom_exceptioncauser Exceptionr=Z formatreprr] getoptionrZ get_verbosityr osgetcwdZinvocation_paramsdirOSErrorZgetrepr)rmrrrrrrrr2r2r3_repr_failure_pysF      zNode._repr_failure_pystr | TerminalReprcCs |||S)zReturn a representation of a collection or test failure. .. seealso:: :ref:`non-python tests` :param excinfo: Exception information for the failure. )r)rmrrr2r2r3 repr_failures zNode.repr_failure)NNNNNN)T)N)N)N)N)N)r1r>rWrX__annotations__ __slots__rE classmethodrnpropertyrprqr/rfr~rrrrrrrr rrrrrrrrr2r2r2r3r6sR  =%       =) metaclassztuple[str | Path, int | None])rr+cCsLt|dd}|dur |ddSt|dd}|durrWrXr2r2r2r3 CollectErrorsrzIterable[Item | Collector]r9cCs tddS)z;Collect children (items and collectors) for this collector.abstractNNotImplementedErrorror2r2r3collectszCollector.collectrrrcCsXt|j|jr0|jdds0|j}t|jdS|jdd}|dkrJd}|j||dS)zyReturn a representation of a collection failure. :param excinfo: Exception information for the failure. rFrrrr)r)rwrrr]rr`argsr)rmrexcrr2r2r3rszCollector.repr_failurercCsBt|dr<|j}|j|jd}||kr2|jtd}||S|jS)Nr)r))Z excludepath)hasattrrcutr)tracebackcutdirfilter)rmrrZ ntracebackr2r2r3rs   zCollector._traceback_filterN) r1r>rWrXrrabcabstractmethodrrrr2r2r2r3rs ri)maxsizezfrozenset[Path]rd) initial_pathsr)r+cCs6||vr dS|jD]}||vrt||SqdS)N)parentsr` relative_to)rr)r^r2r2r3_check_initialpaths_for_relpath"s  rc sZeZdZdZdddddddd dd d fd d ZedddddddfddZZS) FSCollectorz%Base class for filesystem collectors.Nr'zPath | Node | Noner&rdrarbrcre) r*path_or_parentr)r<r^r]r_rfr+c sL|r@t|tr&|dusJtt|}nt|tr@|dusrWrXrErrnrYr2r2rTr3r0s$6rc@seZdZdZdS)FilezOBase class for collecting tests from a file. :ref:`non-python tests`. Nrr2r2r2r3rvsrc@seZdZdZdS) 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`. Nrr2r2r2r3r}srcseZdZdZdZddddddfdd Zdd d d Zejdd d dZ dddddddZ dd ddZ e dd ddZ ZS)ItemzBase class of all test invocation items. Note that for a single function there might be multiple test invocation items. Nrbrcrdre)r]r_rfr+c s6tj||f|||d|g|_g|_|dS)N)r]r_rf)rOrE_report_sectionsZuser_properties-_check_item_and_collector_diamond_inheritance)rmr<r^r]r_rfrArTr2r3rEs z Item.__init__r9cCs`t|}d}t||drdSt||dddd|jD}|r\t|jd|d tdS) z Check if the current type inherits from both File and Collector at the same time, emitting a warning accordingly (#8447). Z)_pytest_diamond_inheritance_warning_shownFNTz, css|]}t|tr|jVqdSr|) issubclassrr1)rGbaser2r2r3rszEItem._check_item_and_collector_diamond_inheritance..zF 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/) rhrQsetattrjoin __bases__r.r/r1r!)rmr? attr_nameproblemsr2r2r3rs   z2Item._check_item_and_collector_diamond_inheritancecCs tddS)zRun the test case for this item. Must be implemented by subclasses. .. seealso:: :ref:`non-python tests` z,runtest must be implemented by Item subclassNrror2r2r3runtestsz Item.runtestr`)whenkeycontentr+cCs|r|j|||fdS)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)rr)rmrrrr2r2r3add_report_sectionszItem.add_report_sectionz.tuple[os.PathLike[str] | str, int | None, str]cCs |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` Nrrror2r2r3 reportinfos zItem.reportinfoztuple[str, int | None, str]cCsF|}t|d}|j|}t|dtus4J||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. rrrM)rrr_Z_node_location_to_relpathrhr`)rmrr)Z relfspathr2r2r3rs   z Item.location)NNNN)r1r>rWrXZnextitemrErrrrrrrrrYr2r2rTr3rs  r)K __future__rrcollections.abcrrrr functoolsrrrpathlibr typingr r r r rrr.ZpluggyZ _pytest._codeZ_pytestrZ_pytest._code.coderrrrZ_pytest.compatrrZ_pytest.configrrZ_pytest.config.compatrZ_pytest.deprecatedrZ_pytest.mark.structuresrrrZ_pytest.outcomesrZ_pytest.pathlibrZ _pytest.stashr Z_pytest.warning_typesr!Ztyping_extensionsr"Z _pytest.mainr#r__file__r^rr%r4r5ABCMetar8ABCr6ryrrrrrrr2r2r2r3sr                                    ,b/ F