B Wcf@sddlZddlZddlmZddlmZddlmZddlmZddlm Z ddlm Z ddlm Z dd lm Z dd lm Z dd lmZdd lmZdd lmZddlmZddlmZddlmZddlmZddlmZddlZddlmZddlmZddlmZddlmZddlmZddlm Z ddlm!Z!ddl"m#Z#ddl"m$Z$ddl%m&Z&ddl%m'Z'ddl%m(Z(ddl)m*Z*dd l+m,Z,dd!l+m-Z-dd"l.m/Z/dd#l0m1Z1erdd$l2m3Z3dd%lm4Z4d&Z5eej6j7Z8e9e e9d'd(d)Z:eedd*d+d,Z;ed-eeeeed.d/d0ZZ?Gd5d-d-e?d6Z@d-eee9efeeAfd7d8d9ZBGd:d;d;e@ZCdd?ZDGd@dAdAeCZEGdBdCdCeEZFGdDdEdEe@ZGdS)FN) signature)Path)Any)Callable)cast)Iterable)Iterator)List)MutableMapping)Optional)overload)Set)Tuple)Type) TYPE_CHECKING)TypeVar)Union) getfslineno) ExceptionInfo) TerminalRepr)cached_property) LEGACY_PATH)Config)ConftestImportFailure)#FSCOLLECTOR_GETHOOKPROXY_ISINITPATH)NODE_CTOR_FSPATH_ARG)Mark) MarkDecorator) NodeKeywords)fail) absolutepath) commonpath)Stash) PytestWarning)Session)_TracebackStyle/)nodeidreturnccsd}|d}|dkrd}dVx>|t||}|dkr:P|dkrP|d|V|tt}q"Wx<|d|}|dkrxP|dkr|d|V|td}qbW|r|VdS)aReturn the parent node IDs of a given node ID, inclusive. For the node ID "testing/code/test_excinfo.py::TestFormattedExcinfo::test_repr_source" the result would be "" "testing" "testing/code" "testing/code/test_excinfo.py" "testing/code/test_excinfo.py::TestFormattedExcinfo" "testing/code/test_excinfo.py::TestFormattedExcinfo::test_repr_source" Note that / components are only considered until the first ::. rz::N)findSEPlen)r'posZ first_colonsZatr/,lib/python3.7/site-packages/_pytest/nodes.pyiterparentnodeids3s*  r1)pathfspathr(cCs&t||kr"td|d|ddS)NzPath(z) != z8 if both path and fspath are given they need to be equal)r ValueError)r2r3r/r/r0 _check_path`s r5Node) node_typer2r3r(cCsV|dk r tjtj|jddd|dk r>|dk r:t|||S|dk sJtt|SdS)N)Znode_type_name) stacklevel)warningswarnrformat__name__r5AssertionErrorr)r7r2r3r/r/r0 _imply_pathhs  r? _NodeType)Zboundcs$eZdZddZfddZZS)NodeMetacOs*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)r< __module__r=r)selfkkwmsgr/r/r0__call__szNodeMeta.__call__c sytj||Stk rztt|dfdd|D}ddlm}t ||dt |dtj||SXdS)N__init__cs i|]\}}|jkr||qSr/)Z parameters).0rGv)sigr/r0 sz$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.) superrJ TypeErrorrgetattritemsZ warning_typesrQr:r;set)rFrGrHZknown_kwrQ) __class__)rNr0_creates zNodeMeta._create)r=rE __qualname__rJrX __classcell__r/r/)rWr0rAs rAc @seZdZUdZeed<dZd@edee deeee eedddd Z e dd d d Z ed dZedddZeddddZeedddZedddZddddZddddZeddddZdAeeefedd d!d"ZdBeeeed#d$d%Z dCeeee!defd#d&d'Z"e#eeed#d(d)Z$e#eeed*d+d)Z$dDeeeeed*d,d)Z$e%edd-d.Z&eedd/d0Z'e(ge)fdd1d2d3Z*e+e,ee,d4d5d6Z-e.e/dd7d8d9Z0dEe.e/d:e1d;dd?Z3dS)Gr6zBase class for Collector and Item, the components of the test collection tree. Collector subclasses have children; Items are leaf nodes. r3)rCparentconfigsessionr2_nodeid_store__dict__NzOptional[Node]zOptional[Session])rCr[r\r]r3r2r'r(cCs||_||_|r||_n|s$td|j|_|r8||_n|sDtd|j|_|dkrh|dkrht|dd}tt|||d|_t ||_ g|_ t |_ |dk rd|kst||_n"|jstd|jjd|j|_t|_|j|_dS)Nz!config or parent must be providedz"session or parent must be providedr2)r3z::()z!nodeid or parent must be providedz::)rCr[r\rSr]rTr?typer2rkeywords own_markersrVextra_keyword_matchesr>r^r'r"Zstashr_)rFrCr[r\r]r3r2r'r/r/r0rKs4    z Node.__init__)r[cKs4d|krtdd|kr 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[)rSrX)clsr[rHr/r/r0 from_parents zNode.from_parentcCs|j|jS)z6fspath-sensitive hook proxy used to call pytest hooks.)r] gethookproxyr2)rFr/r/r0ihooksz Node.ihook)r(cCsd|jjt|ddS)Nz<{} {}>rC)r<rWr=rT)rFr/r/r0__repr__ sz Node.__repr__)warningr(cCsNt|tstd|t|\}}|dk s0ttj|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. zr: warn_explicitstr)rFrjr2rmr/r/r0r;s   z Node.warncCs|jS)z;A ::-separated string denoting its collection tree address.)r^)rFr/r/r0r'7sz Node.nodeidcCs t|jS)N)hashr^)rFr/r/r0__hash__<sz Node.__hash__cCsdS)Nr/)rFr/r/r0setup?sz Node.setupcCsdS)Nr/)rFr/r/r0teardownBsz Node.teardowncCs2g}|}x|dk r$|||j}q W||S)zReturn list of all parent collectors up to self, starting from the root of collection tree. :returns: The nodes. N)appendr[reverse)rFchainitemr/r/r0 listchainEs   zNode.listchainT)markerrwr(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.markr}rnrrrrTr4rbrCrcrwmarkinsert)rFr|rwr}Zmarker_r/r/r0 add_markerSs     zNode.add_marker)rCr(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)rPNr/)rLxr/r/r0 qsz$Node.iter_markers..)rC)iter_markers_with_node)rFrCr/r/r0 iter_markerskszNode.iter_markersccsLxFt|D]6}x0|jD]&}|dks6t|dd|kr||fVqWqWdS)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. NrC)reversedr{rcrT)rFrCnoder~r/r/r0rss zNode.iter_markers_with_nodecCsdS)Nr/)rFrCr/r/r0get_closest_markerszNode.get_closest_marker)rCdefaultr(cCsdS)Nr/)rFrCrr/r/r0rscCst|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. )rC)nextr)rFrCrr/r/r0rs cCs(t}x|D]}||jqW|S)z;Return a set of all extra keywords in self and any parents.)rVr{updaterd)rFZextra_keywordsrzr/r/r0listextrakeywordsszNode.listextrakeywordscCsdd|DS)NcSsg|] }|jqSr/)rC)rLrr/r/r0 sz"Node.listnames..)r{)rFr/r/r0 listnamesszNode.listnames)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)rFrr/r/r0rszNode.addfinalizer)rer(cCs8|}x|rt||s|j}qW|dks4t||s4t|S)zGet the next 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)rnr[r>)rFreZcurrentr/r/r0 getparents  zNode.getparent)excinfor(cCsdS)Nr/)rFrr/r/r0_prunetracebackszNode._prunetracebackzOptional[_TracebackStyle])rstyler(cCs>ddlm}t|jtr&t|jj}t|jtj r@|jj s@d}t|j|rV|j S|j ddrjd}n>tj|jdg}||t|jdkr||_|dkrd}|dkr|j d dd krd }nd}|j d dd krd}nd }ytt|j jjk}Wntk rd }YnX|jd ||j dd|d|dS)Nr)FixtureLookupErrorvalue fulltraceFZlongr)autotbstyleshortverboserPT showlocals)ZfuncargsabspathrrZtbfiltertruncate_locals)Z_pytest.fixturesrrnrrrZ from_exc_inforr ExceptionrDZ formatreprr\ getoption_pytest_codeZ Traceback tracebackrr-rosgetcwdZinvocation_paramsdirOSErrorZgetrepr)rFrrrtbrrr/r/r0_repr_failure_pysD       zNode._repr_failure_pycCs |||S)zReturn a representation of a collection or test failure. .. seealso:: :ref:`non-python tests` :param excinfo: Exception information for the failure. )r)rFrrr/r/r0 repr_failures zNode.repr_failure)NNNNNN)T)N)N)N)N)N)4r=rErY__doc__r__annotations__ __slots__rrr rrrK classmethodrfpropertyrhriror;r'intrtrurvr r{rrboolrrrrrrr rr rrrobjectrrr@rr BaseExceptionrrrrr/r/r/r0r6sR   4 '       6 ) metaclass)rr(cCsLt|dd}|dk r |ddSt|dd}|dk rrrrr?rarCr2rr4rrreplacersepr,r]r\ZrootpathrrRrK) rFr3rr2rCr[r\r]r'r)rWr/r0rKBsF        zFSCollector.__init__)r3r2c stjf|||d|S)zThe public constructor.)r[r3r2)rRrf)rer[r3r2rH)rWr/r0rfxs zFSCollector.from_parentzos.PathLike[str])r3cCstjtdd|j|S)Nr)r9)r:r;rr]rg)rFr3r/r/r0rgszFSCollector.gethookproxy)r2r(cCstjtdd|j|S)Nr)r9)r:r;rr] isinitpath)rFr2r/r/r0rszFSCollector.isinitpath)NNNNNNNN)r=rErYr rrrr6rrrrKrrfrgrrrZr/r/)rWr0rAs:,$rc@seZdZdZdS)FilezOBase class for collecting tests from a file. :ref:`non-python tests`. N)r=rErYrr/r/r/r0rsrcseZdZdZdZdeeedeeddfdd Zdddd Z ddd d Z eeedd d dZ e e defeeefdddZee eeeefdddZZS)rzvA basic test invocation item. Note that for a single function there might be multiple test invocation items. Nr$)r\r]r'r(c s6tj||f|||d|g|_g|_|dS)N)r\r]r')rRrK_report_sectionsZuser_properties-_check_item_and_collector_diamond_inheritance)rFrCr[r\r]r'rH)rWr/r0rKs z Item.__init__)r(cCs`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|jVqdS)N) issubclassrr=)rLbaser/r/r0rszEItem._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/) rarTsetattrjoin __bases__r:r;r=r#)rFreZ attr_nameZproblemsr/r/r0rs  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 subclassN)r)rFr/r/r0runtestsz Item.runtest)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)rrw)rFrrrr/r/r0add_report_sectionszItem.add_report_sectionzos.PathLike[str]cCs |jddfS)aHGet location information for this item for test reports. Returns a tuple with three elements: - The path of the test (default ``self.path``) - The line number of the test (default ``None``) - A name of the test to be shown (default ``""``) .. seealso:: :ref:`non-python tests` Nr*)r2)rFr/r/r0 reportinfos zItem.reportinfocCsL|}tt|d}|j|}t|dtks:t||d|dfS)NrrrP) rr rr3r]Z_node_location_to_relpathrarrr>)rFrr2Z relfspathr/r/r0rs  z Item.location)NNNN)r=rErYrZnextitemr rrrrKrrrrrrrrrrZr/r/)rWr0rs $ r)Hrr:inspectrZpathlibrtypingrrrrrr r r r r rrrrrZ _pytest._coderrZ_pytest._code.coderrZ_pytest.compatrrZ_pytest.configrrZ_pytest.deprecatedrrZ_pytest.mark.structuresrrrZ_pytest.outcomesrZ_pytest.pathlibr r!Z _pytest.stashr"Z_pytest.warning_typesr#Z _pytest.mainr$r%r,__file__r[rrrr1r5r?r@rarAr6rrprrrrrr/r/r/r0st                                     -  _$+L