jjfddlmZddlZddlmZddlmZddlmZddlmZddlm 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"Z5d:d#Z6e ejnjpZ9ed$Z:ed%d&'Z;Gd(d)ejxZ=Gd*d&ej|e=+Z?d;d,Z@Gd-d.e?ej|ZAe d/0 dr?sigvknown_kwrE __class__s r,_createzNodeMeta._createcs 47#Q-"- - 4GC45C)+KAqCNN7J1KKHK ? MM(eRSVW_S`Rab(( 7#Q3(3 3 4s"1B+A A A B+*B+)returnr )r=ztype[_T]rTr/)r<r; __qualname____doc__rArS __classcell__rRs@r,r4r4Ks !44r.r4cjeZdZUdZded<dZ d ddZed dZe d!dZ d"d Z d#d Z e d"d Z d$d Zd%d Zd%dZd&dZd'dZd(d)dZd*d+dZ d* d,dZed-dZed.dZd*d/dZd0dZd1dZd2dZd3dZd4dZ d* d5dZ d* d6dZy)7r1zBase 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_storeconfigr8parentr+sessionNc"||_||_|r||_n|s td|j|_|r||_n|s td|j|_||J|j }||_t ||_g|_t|_ |d|vsJ||_ nB|js td|jjdz|jz|_ t|_|j|_y)Nz!config or parent must be providedz"session or parent must be providedz::()z!nodeid or parent must be providedz::)r8r^r]rGr_r+rkeywords own_markersrNextra_keyword_matchesr[nodeidrstashr\)selfr8r^r]r_r'r+rds r,rCz Node.__init__s  "(DK CDD --DK $+DL DEE!>>DL <% %%;;D"& 3?t2D (*03u"  ' ''!DL;; CDD;;--4tyy@DL"G jj r.c fd|vr tdd|vr td|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. r]z.config is not a valid argument for from_parentr_z/session is not a valid argument for from_parentr^)rGrS)r=r^r?s r, from_parentzNode.from_parentsC r>LM M ?MN Ns{{/&/B//r.cL|jj|jS)z4Path-sensitive hook proxy used to call pytest hooks.)r_ gethookproxyr+rfs r,ihookz Node.ihooks||((33r.cddj|jjt|ddS)Nz<{} {}>r8)r:rRr<rHrls r,__repr__z Node.__repr__s( 7 7vt9TUUr.ct|tstd|t|\}}|Jt j |dt ||dzy)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 NrD)categoryfilenamelineno) isinstanceWarning ValueErrorget_fslocation_from_itemrL warn_explicitstr)rfwarningr+rss r,rMz Node.warnsc,'7+J7+V 05 f!!! YA:  r.c|jS)z;A ::-separated string denoting its collection tree address.)r[rls r,rdz Node.nodeids||r.c,t|jSN)hashr[rls r,__hash__z Node.__hash__sDLL!!r.cyr}rhrls r,setupz Node.setup r.cyr}rhrls r,teardownz Node.teardownrr.c#<K|}|||j}|yyw)zIterate over all parent collectors starting from and including self up to the root of the collection tree. .. versionadded:: 8.1 N)r^)rfr^s r, iter_parentszNode.iter_parentss) # L]]F scrg}|}| |j||j}| |j|S)zxReturn a list of all parent collectors starting from the root of the collection tree down to and including self.)appendr^reverse)rfchainitems r, listchainzNode.listchain)sA  LL ;;D   r.cTddlm}t|tr|}n(t|tr t ||}n t d||j|j<|r&|jj|jy|jjd|jy)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.markrrtrryrHrvrar8rbrmarkinsert)rfmarkerrrmarker_s r, add_markerzNode.add_marker4s * fm ,G  $h/GFG G&- gll#     # #GLL 1    # #Aw|| 4r.c4d|j|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|] }|d yw)rDNrh).0xs r, z$Node.iter_markers..PsE!Esr7)iter_markers_with_noderfr8s r, iter_markerszNode.iter_markersJs Fd99t9DEEr.c#K|jD],}|jD]}|t|dd|k(s||f.yw)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. Nr8)rrbrH)rfr8noders r,rzNode.iter_markers_with_nodeRsT%%' %D(( %<74#>$#F*$ % %s 5A Acyr}rhrs r,get_closest_markerzNode.get_closest_marker_sD  ! !$"<"< = >r.c\|jDcgc]}|jc}Scc}wr})rr8)rfrs r, listnameszNode.listnamesus! $ 011111s)cP|jjj||y)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_ _setupstate addfinalizer)rffins r,rzNode.addfinalizerxs   --c48r.cN|jD]}t||s|cSy)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)rrt)rfr=rs r, getparentzNode.getparents0%%' D$$  r.c|jSr}) traceback)rfexcinfos r,_traceback_filterzNode._traceback_filters   r.c ddlm}t|jtr)t j |jj}t|jtjr|jjsd}t|j|r|jjS|jjddrd}d}n|j}|dk(rd}|$|jjddd k(rd }nd}|jjd kDrd}nd }|jjd kDrdnd } t!t#j$|jj&j(k7}|j-d ||jjd d||||S#t*$rd }Y?wxYw)Nr)FixtureLookupErrorvalue fulltraceFlongautotbstyleshortrDT showlocals)funcargsabspathrstyletbfiltertruncate_locals truncate_args)_pytest.fixturesrrtrrrfrom_exceptioncauser Exceptionr9 formatreprr] getoptionr get_verbosityr r&getcwdinvocation_paramsdirOSErrorgetrepr)rfrrrrrrrs r,_repr_failure_pyzNode._repr_failure_pys 8 gmm%: ;#227==3F3FGG gmmT^^ 4==(( gmm%7 8==++- - ;; e 4EH--H ={{$$Y77B ;; $ $ & *#O"O!%!:!:!G GGc&|j||S)zReturn a representation of a collection or test failure. .. seealso:: :ref:`non-python tests` :param excinfo: Exception information for the failure. )r)rfrrs r, repr_failurezNode.repr_failures$$We44r.)NNNNNN)r8ryr^ Node | Noner] Config | Noner_Session | Noner'Noner+ Path | Nonerd str | NonerTr)r^r1rTr!)rTzpluggy.HookRelay)rTry)rzrurTr)rTintrTr)rTzIterator[Node])rTz list[Node])T)rzstr | MarkDecoratorrboolrTrr})r8rrTzIterator[Mark])r8rrTzIterator[tuple[Node, Mark]])r8ryrT Mark | None)r8ryrrrTr)r8ryrrrTr)rTzset[str])rTz list[str])rzCallable[[], object]rTr)r=ztype[_NodeType]rTz_NodeType | NonerExceptionInfo[BaseException]rTr)rrrTracebackStyle | NonerTr)rrrrrTstr | TerminalRepr)r<r;rUrV__annotations__ __slots__rC classmethodripropertyrmrorMrdrrrrrrrrrrrrrrrrrrhr.r,r1r1ws  I# $"& !<!<!<! <!  <!  <!<!<! <!|00"44V! J"   # 5,F"& % % $ %?? GG;29 ! (,8 -8 %8   8 z(, 5- 5% 5  5r.) metaclassc|t|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)rHr)rrrs r,rwrwsW4;4T3RH| $t $C 3 4!3 4b 88r.cdeZdZdZGddeZejddZ d dZ d dZ y) CollectorzBase class of all collectors. Collector create children through `collect()` and thus iteratively build the collection tree. ceZdZdZy)Collector.CollectErrorz6An error during collection, contains a custom message.Nr<r;rUrVrhr.r, CollectErrorrsDr.rctd)z;Collect children (items and collectors) for this collector.abstractNotImplementedErrorrls r,collectzCollector.collects"*--r.c.t|j|jr@|jj dds$|j}t |j dS|jj dd}|dk(rd}|j||S)zyReturn a representation of a collection failure. :param excinfo: Exception information for the failure. rFrrrr)r)rtrrr]rryargsr)rfrexcrs r,rzCollector.repr_failures gmmT%6%6 7 @U@U A --Csxx{# #++'' 6: f G$$WG$<:ND1|#|% <99D!fkkT&9$**6;;7Cs8D~ ?% %%nnG > VTYY227>>3J3JKL!&)   )" V89N9NPTU Vs$#D 08D DDD<;D<)r'r+c *t|d|||d|S)zThe public constructor.)r^r'r+rh)rFri)r=r^r'r+r?rRs r,rizFSCollector.from_parentas!w"Q&dQbQQr.)NNNNNNNN)r'rrzPath | Node | Noner+rr8rr^rr]rr_rrdrrTr)r'rr+rrTr!)r<r;rUrVrCrrirWrXs@r,r r (s/-1 " $"&!4 4 +4  4  4  4 4  4 4  4 l  R R  R  R Rr.r ceZdZdZy)FilezOBase class for collecting tests from a file. :ref:`non-python tests`. Nrrhr.r,rrnsr.rceZdZdZy) 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`. Nrrhr.r,rrusr.rceZdZdZdZ d d fd Zd dZejd dZ d dZ d dZ e ddZ xZS)ItemzBase class of all test invocation items. Note that for a single function there might be multiple test invocation items. Nc lt|||f|||d|g|_g|_|j y)N)r]r_rd)rFrC_report_sectionsuser_properties-_check_item_and_collector_diamond_inheritance)rfr8r^r]r_rdr?rRs r,rCz Item.__init__sR        =?:< ::.s" "z$ 7RDMM s))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/) typerHsetattrjoin __bases__rLrMr<r )rfr= attr_nameproblemss r,rz2Item._check_item_and_collector_diamond_inheritances 4j @ 3 5 ) Y%99 &)mm    MM<<.!%%-J/gg    r.ctd)zRun the test case for this item. Must be implemented by subclasses. .. seealso:: :ref:`non-python tests` z,runtest must be implemented by Item subclassrrls r,runtestz Item.runtests""PQQr.cF|r|jj|||fyy)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)rfwhenkeycontents r,add_report_sectionzItem.add_report_sections'   ! ! ( ($W)= > r.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*rls r, reportinfozItem.reportinfosyy$""r.c|j}t|d}|jj|}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. rrrD)r/rr__node_location_to_relpathr!ry)rfrr+ relfspaths r,rz Item.locations^??$HQK(LL::4@ HQK C'''8A; 44r.)NNNN)r]rr_rrdrrTrr)r*ryr+ryr,ryrTr)rTz.tuple[os.PathLike[str] | str, int | None, str])rTztuple[str, int | None, str])r<r;rUrVnextitemrCrrrr(r-r/rrrWrXs@r,rrs H  $"&! = =  =  = =:: RR?" # 5 5r.r)r+zstr | os.PathLike[str]rTry)rr1rTztuple[str | Path, int | None])rzfrozenset[Path]r+r rTr)G __future__rrcollections.abcrrrr functoolsrr r&pathlibr typingr r r rrrrLpluggy _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)r-__file__r^rr/r0ABCMetar4ABCr1rwrr r rrrrhr.r,rIsy" $$$*%   %,+(-&$!0(10!(/&%  .w''(// T] Kv . )4s{{)4X^5377h^5B 9&,!cgg,!^ 4 " *.   CR)SWWCRL; SWW$u54u5r.