+
    Spjf                       ^ RI Ht ^ RIt^ RIHt ^ RIHt ^ RIHt ^ RIHt ^ RIH	t	 ^ RIH
t
 ^ RIt^ RIt^ R	IHt ^ R
IHt ^ RIHt ^ RIHt ^ RIHt ^ RIHt ^ RIHt ^ RIt^ RIt^ RIt^ RIHt ^ RIHt ^ RIHt ^ RIHt ^ RIHt ^ RIH t  ^ RIH!t! ^ RI"H#t# ^ RI"H$t$ ^ RI%H&t& ^ RI%H't' ^ RI%H(t( ^ RI)H*t* ^ RI+H,t, ^ RI-H.t. ^ RI/H0t0 ]'       d   ^ R I1H2t2 ^ R!I3H4t4 R"t5R# R$ lt6]! ]Pn                  4      Pp                  t9]! R%4      t:]! R&R'R(7      t; ! R) R*]Px                  4      t= ! R+ R']P|                  ]=R,7      t?R- R. lt@ ! R/ R0]?]P|                  4      tA]
! R1R27      R3 R4 l4       tB ! R5 R6]A]P|                  4      tC ! R7 R8]C]P|                  4      tD ! R9 R:]C]P|                  4      tE ! R; R<]?]P|                  4      tFR# )=    )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/c                    V ^8  d   QhRRRR/# )   pathzstr | os.PathLike[str]returnstr )formats   "4/tmp/pip-target-d46v3snk/lib/python/_pytest/nodes.py__annotate__r,   5   s     
. 
.) 
.c 
.    c                V    \         P                  ! V 4      P                  R\        4      # )am  Normalize 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.
\)osfspathreplaceSEPr&   s   &r+   norm_sepr5   5   s     99T?""4--r-   _T	_NodeTypeNode)boundc                  >   a  ] tR t^KtRtR R ltR V 3R lltRtV ;t# )NodeMetaa  Metaclass 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.
c                   V ^8  d   QhRR/# )r%   r'   r   r)   )r*   s   "r+   r,   NodeMeta.__annotate__Z   s     ! !8 !r-   c                	v    R P                  V P                   RV P                   2R7      p\        VRR7       R# )zDirect 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)pytraceN)r*   
__module____name__r   )clskkwmsgs   &*, r+   __call__NodeMeta.__call__Z   s:    ! &(#,,8&
9 	 	S% r-   c                    V ^8  d   QhRRRR/# )r%   rE   ztype[_T]r'   r6   r)   )r*   s   "r+   r,   r=   c   s     4 4X 4B 4r-   c           
     	l  <  \         SV `  ! V/ VB #   \         d    \        \	        T R 4      4      pTP                  4        UUu/ uF  w  rYP                  9   g   K  YbK  	  Mu uppi ppp^RIHp \        P                  ! T! T  R\        T4       R24      4       \         ST `  ! X/ TB u # i ; i)__init__)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.)superrI   	TypeErrorr   getattritems
parameterswarning_typesrN   warningswarnset)rE   rF   rG   sigvknown_kwrN   	__class__s   &*,    r+   _createNodeMeta._createc   s    	47#Q-"-- 	4GC45C)+KqNN7JKHK?MM(eRSVW_S`Ra b( ( 7#Q3(33	4s"    3B3A&A&%AB32B3r)   )	rD   rC   __qualname____firstlineno____doc__rI   r\   __static_attributes____classcell__r[   s   @r+   r;   r;   K   s    !4 4r-   r;   c                     ] tR t^wt$ RtR]R&   R6tR7R R llt]R R l4       t	]
R	 R
 l4       tR R ltR R lt]
R R l4       tR R ltR R ltR R ltR R ltR R ltR8R R lltR9R R lltR9R R  llt]R! R" l4       t]R# R$ l4       tR9R% R& lltR' R( ltR) R* ltR+ R, ltR- R. ltR/ R0 ltR9R1 R2 lltR9R3 R4 lltR5t R# ):r8   zBase 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.
r   r1   Nc               8    V ^8  d   QhRRRRRRRRR	R
RRRRRR
/# )r%   rA   r(   parentNode | NoneconfigConfig | NonesessionSession | Noner1   Noner&   Path | Nonenodeid
str | Noner'   r)   )r*   s   "r+   r,   Node.__annotate__   sZ     <! <!<! <! 	<!
  <! <! <! <! 
<!r-   c                	v   Wn         W n        V'       d   W0n        M$V'       g   \        R 4      hVP                  V n        V'       d   W@n        M$V'       g   \        R4      hVP                  V n        Vf   Vf   Q hVP
                  pW`n        \        V 4      V n        . V n        \        4       V n
        Ve   RV9  g   Q hWpn        MPV P                  '       g   \        R4      hV P                  P                  R,           V P                   ,           V n        \        4       V n        V P                  V n        R# )z!config or parent must be providedz"session or parent must be providedNz::()z!nodeid or parent must be providedz::)rA   rf   rh   rP   rj   r&   r   keywordsown_markersrW   extra_keyword_matches_nodeidrn   r   stash_store)selfrA   rf   rh   rj   r1   r&   rn   s   &&&&&&&&r+   rM   Node.__init__   s     	 "(K CDD --DK$+L DEE!>>DL<%%%;;D"&	 3?t2D (* 03u"'''!L;;; CDD;;--4tyy@DL "G
jjr-   c                    V ^8  d   QhRRRR/# )r%   rf   r8   r'   r!   r)   )r*   s   "r+   r,   rp      s     0 0 0 0r-   c                r    RV9   d   \        R4      hRV9   d   \        R4      hV P                  ! RRV/VB # )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.
rh   z.config is not a valid argument for from_parentrj   z/session is not a valid argument for from_parentrf   r)   )rP   r\   )rE   rf   rG   s   &&,r+   from_parentNode.from_parent   sA     r>LMM?MNN{{/&/B//r-   c                   V ^8  d   QhRR/# )r%   r'   zpluggy.HookRelayr)   )r*   s   "r+   r,   rp      s     4 4' 4r-   c                L    V P                   P                  V P                  4      # )z4Path-sensitive hook proxy used to call pytest hooks.)rj   gethookproxyr&   rx   s   &r+   ihook
Node.ihook   s     ||((33r-   c                   V ^8  d   QhRR/# r%   r'   r(   r)   )r*   s   "r+   r,   rp      s     V V# Vr-   c                	d    R P                  V P                  P                  \        V RR4      4      # )z<{} {}>rA   N)r*   r[   rD   rQ   r   s   &r+   __repr__Node.__repr__   s(     7 7vt9TUUr-   c                    V ^8  d   QhRRRR/# )r%   warningWarningr'   rl   r)   )r*   s   "r+   r,   rp      s     !
 !
G !
 !
r-   c                    \        V\        4      '       g   \        RV: 24      h\        V 4      w  r#Vf   Q h\        P
                  ! VR\        V4      V^,           R7       R# )a  Issue 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 <pytest.PytestWarning>` subclasses.
z8warning must be an instance of Warning or subclass, got N)categoryfilenamelineno)
isinstancer   
ValueErrorget_fslocation_from_itemrU   warn_explicitr(   )rx   r   r&   r   s   &&  r+   rV   	Node.warn   sd    , '7++J7+V  05!!!YA:		
r-   c                   V ^8  d   QhRR/# r   r)   )r*   s   "r+   r,   rp     s       r-   c                    V P                   # )z;A ::-separated string denoting its collection tree address.)ru   r   s   &r+   rn   Node.nodeid  s     ||r-   c                   V ^8  d   QhRR/# )r%   r'   intr)   )r*   s   "r+   r,   rp     s     " "# "r-   c                	,    \        V P                  4      # N)hashru   r   s   &r+   __hash__Node.__hash__  s    DLL!!r-   c                   V ^8  d   QhRR/# r%   r'   rl   r)   )r*   s   "r+   r,   rp     s      t r-   c                	    R # r   r)   r   s   &r+   setup
Node.setup      r-   c                   V ^8  d   QhRR/# r   r)   )r*   s   "r+   r,   rp     s      $ r-   c                	    R # r   r)   r   s   &r+   teardownNode.teardown  r   r-   c                   V ^8  d   QhRR/# )r%   r'   zIterator[Node]r)   )r*   s   "r+   r,   rp     s     	# 	#n 	#r-   c              #  >   "   T pVe   Vx  VP                   pK  R# 5i)zIterate over all parent collectors starting from and including self
up to the root of the collection tree.

.. versionadded:: 8.1
N)rf   )rx   rf   s   & r+   iter_parentsNode.iter_parents  s%      # L]]F !s   c                   V ^8  d   QhRR/# )r%   r'   z
list[Node]r)   )r*   s   "r+   r,   rp   )  s     	 	: 	r-   c                t    . pT pVe    VP                  V4       VP                  pK#  VP                  4        V# )zpReturn a list of all parent collectors starting from the root of the
collection tree down to and including self.)appendrf   reverse)rx   chainitems   &  r+   	listchainNode.listchain)  s7      LL;;Dr-   c               $    V ^8  d   QhRRRRRR/# )r%   markerzstr | MarkDecoratorr   boolr'   rl   r)   )r*   s   "r+   r,   rp   4  s"     5 5!4 5d 5d 5r-   c                x   ^ RI Hp \        V\        4      '       d   TpM-\        V\        4      '       d   \        W14      pM\        R4      hW@P                  VP                  &   V'       d(   V P                  P                  VP                  4       R# V P                  P                  ^ VP                  4       R# )zDynamically add a marker object to the node.

:param marker:
    The marker.
:param append:
    Whether to append the marker, or prepend it.
)MARK_GENz'is not a string or pytest.mark.* MarkerN)_pytest.markr   r   r   r(   rQ   r   rr   rA   rs   r   markinsert)rx   r   r   r   marker_s   &&&  r+   
add_markerNode.add_marker4  s     	*fm,,G$$h/GFGG&-gll###GLL1##Aw||4r-   c                    V ^8  d   QhRRRR/# )r%   rA   ro   r'   zIterator[Mark]r)   )r*   s   "r+   r,   rp   J  s     F F F~ Fr-   c                4    R V P                  VR7       4       # )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.
c              3  2   "   T F  q^,          x  K  	  R# 5i)   Nr)   ).0xs   & r+   	<genexpr>$Node.iter_markers.<locals>.<genexpr>P  s     ED!Ds   r@   )iter_markers_with_noderx   rA   s   &&r+   iter_markersNode.iter_markersJ  s     Fd99t9DEEr-   c                    V ^8  d   QhRRRR/# )r%   rA   ro   r'   zIterator[tuple[Node, Mark]]r)   )r*   s   "r+   r,   rp   R  s     % %%	$%r-   c              #     "   V P                  4        F3  pVP                   F   pVe   \        VRR4      V8X  g   K  W#3x  K"  	  K5  	  R# 5i)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.
NrA   )r   rs   rQ   )rx   rA   noder   s   &&  r+   r   Node.iter_markers_with_nodeR  sG      %%'D((<74#>$#F*$ ) (s
   6AAc                    V ^8  d   QhRRRR/# )r%   rA   r(   r'   Mark | Noner)   )r*   s   "r+   r,   rp   `  s    ??s?{?r-   c                	    R # r   r)   r   s   &&r+   get_closest_markerNode.get_closest_marker_  s    <?r-   c               $    V ^8  d   QhRRRRRR/# )r%   rA   r(   defaultr   r'   r)   )r*   s   "r+   r,   rp   c  s    GGsGTGdGr-   c                	    R # r   r)   rx   rA   r   s   &&&r+   r   r   b  s    DGr-   c               $    V ^8  d   QhRRRRRR/# )r%   rA   r(   r   r   r'   r)   )r*   s   "r+   r,   rp   e  s!     ; ;s ;[ ;K ;r-   c                :    \        V P                  VR7      V4      # )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@   )nextr   r   s   &&&r+   r   r   e  s     D%%4%0'::r-   c                   V ^8  d   QhRR/# )r%   r'   zset[str]r)   )r*   s   "r+   r,   rp   n  s      8 r-   c                ~    \        4       pV P                  4        F  pVP                  VP                  4       K   	  V# )z;Return a set of all extra keywords in self and any parents.)rW   r   updatert   )rx   extra_keywordsr   s   &  r+   listextrakeywordsNode.listextrakeywordsn  s4    #&5NN$D!!$"<"<= %r-   c                   V ^8  d   QhRR/# )r%   r'   z	list[str]r)   )r*   s   "r+   r,   rp   u  s     2 29 2r-   c                	^    V P                  4        Uu. uF  qP                  NK  	  up# u upi r   )r   rA   )rx   r   s   & r+   	listnamesNode.listnamesu  s%     $ 01 01 0111s   *c                    V ^8  d   QhRRRR/# )r%   finzCallable[[], object]r'   rl   r)   )r*   s   "r+   r,   rp   x  s     9 9 4 9 9r-   c                P    V P                   P                  P                  W4       R# )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)rj   _setupstateaddfinalizer)rx   r   s   &&r+   r   Node.addfinalizerx  s     	  --c8r-   c                    V ^8  d   QhRRRR/# )r%   rE   ztype[_NodeType]r'   z_NodeType | Noner)   )r*   s   "r+   r,   rp     s     
 
_ 
1A 
r-   c                ^    V P                  4        F  p\        W!4      '       g   K  Vu # 	  R# )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)r   r   )rx   rE   r   s   && r+   	getparentNode.getparent  s,     %%'D$$$ ( r-   c                    V ^8  d   QhRRRR/# r%   excinfoExceptionInfo[BaseException]r'   r   r)   )r*   s   "r+   r,   rp     s     ! !)E !) !r-   c                	    VP                   # r   )	traceback)rx   r   s   &&r+   _traceback_filterNode._traceback_filter  s       r-   c               $    V ^8  d   QhRRRRRR/# )r%   r   r   styleTracebackStyle | Noner'   r   r)   )r*   s   "r+   r,   rp     s(     8
 8
-8
 %8
 
	8
r-   c           
     	   ^ RI Hp \        VP                  \        4      '       d+   \
        P                  ! VP                  P                  4      p\        VP                  \        P                  4      '       d   VP                  P                  '       g   Rp\        VP                  V4      '       d   VP                  P                  4       # V P                  P                  RR4      '       d   RpRpMV P                  pVR8X  d   RpVf'   V P                  P                  RR4      R8X  d   RpMRpV P                  P                  4       ^8  d   RpMR	pV P                  P                  4       ^8  d   RMR	p \!        \"        P$                  ! 4       4      V P                  P&                  P(                  8g  pVP-                  R	VV P                  P                  R
R4      VVVVR7      #   \*         d    R	p LAi ; i)r   )FixtureLookupErrorvalue	fulltraceFlongautotbstyleshortT
showlocals)funcargsabspathr  r   tbfiltertruncate_localstruncate_args)_pytest.fixturesr   r   r   r   r   from_exceptioncauser   	ExceptionrB   
formatreprrh   	getoptionr   get_verbosityr
   r0   getcwdinvocation_paramsdirOSErrorgetrepr)rx   r   r   r   r  r  r  r  s   &&&     r+   _repr_failure_pyNode._repr_failure_py  s   
 	8gmm%:;;#227==3F3FGGgmmT^^44==(((gmm%788==++-- ;;  e44EH--H={{$$Y77B;;$$&*#O"O!%!:!:!<q!@d	299;'4;;+H+H+L+LLG {{,,\5A+'  
 	
  	G	s   =?G. .G>=G>c               $    V ^8  d   QhRRRRRR/# )r%   r   r   r   r   r'   str | TerminalReprr)   )r*   s   "r+   r,   rp     s(     5 5-5 %5 
	5r-   c                $    V P                  W4      # )zReturn a representation of a collection or test failure.

.. seealso:: :ref:`non-python tests`

:param excinfo: Exception information for the failure.
)r  )rx   r   r   s   &&&r+   repr_failureNode.repr_failure  s     $$W44r-   )ru   rw   rh   rt   rr   rA   rs   rf   r&   rj   rv   )__dict__ru   rw   rh   rA   rf   r&   rj   )NNNNNN)Tr   )!rD   rC   r^   r_   r`   __annotations__	__slots__rM   classmethodr|   propertyr   r   rV   rn   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r  r  ra   r)   r-   r+   r8   r8   w   s     	I<!| 0 0" 4 4V!
J  "	#	5,F% ? ?G G;29
!8
t5 5r-   )	metaclassc                    V ^8  d   QhRRRR/# )r%   r   r8   r'   ztuple[str | Path, int | None]r)   )r*   s   "r+   r,   r,     s     9 94 9,I 9r-   c                    \        V RR4      pVe
   VR,          # \        V RR4      pVe   \        V4      # \        V RR4      R3# )a  Try 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.
locationN:Nr%   Nobjr&   zunknown location)rQ   r   )r   r$  r%  s   &  r+   r   r     sU     4;4T3RH|
$t
$C
34!34b88r-   c                  r    ] tR tRtRt ! R R]4      t]P                  R R l4       t	R R lt
R	 R
 ltRtR# )	Collectori  z}Base class of all collectors.

Collector create children through `collect()` and thus iteratively build
the collection tree.
c                      ] tR tRtRtRtR# )Collector.CollectErrori  z6An error during collection, contains a custom message.r)   NrD   rC   r^   r_   r`   ra   r)   r-   r+   CollectErrorr*    s    Dr-   r,  c                   V ^8  d   QhRR/# )r%   r'   zIterable[Item | Collector]r)   )r*   s   "r+   r,   Collector.__annotate__  s     . .3 .r-   c                    \        R4      h)z;Collect children (items and collectors) for this collector.abstractNotImplementedErrorr   s   &r+   collectCollector.collect  s     "*--r-   c                    V ^8  d   QhRRRR/# )r%   r   r   r'   r  r)   )r*   s   "r+   r,   r.    s     = =3=	=r-   c                P   \        VP                  V P                  4      '       dK   V P                  P	                  RR4      '       g)   VP                  p\        VP                  ^ ,          4      # V P                  P	                  RR4      pVR8X  d   RpV P                  WR7      # )ziReturn a representation of a collection failure.

:param excinfo: Exception information for the failure.
r   Fr  r   r  )r   )r   r   r,  rh   r  r(   argsr  )rx   r   excr  s   &&  r+   r  Collector.repr_failure  s     gmmT%6%677@U@UA
 A
 --Csxx{## ++''	6:fG$$W$<<r-   c                    V ^8  d   QhRRRR/# r   r)   )r*   s   "r+   r,   r.    s     ! !)E !) !r-   c                	    \        V R 4      '       dV   VP                  pVP                  V P                  R7      pW28X  d   VP                  \        R7      pVP                  V4      # VP                  # )r&   r4   )excludepath)hasattrr   cutr&   tracebackcutdirfilter)rx   r   r   
ntracebacks   &&  r+   r   Collector._traceback_filter  sa    4  ))I"DII6J&'^^^H
$$W--   r-   r)   N)rD   rC   r^   r_   r`   r  r,  abcabstractmethodr3  r  r   ra   r)   r-   r+   r(  r(    s>    Ey E 	. .
=*! !r-   r(  i  )maxsizec               $    V ^8  d   QhRRRRRR/# )r%   initial_pathszfrozenset[Path]r&   r
   r'   ro   r)   )r*   s   "r+   r,   r,     s$     
 
"
*.

r-   c                    W9   d   R # VP                    F%  pW 9   g   K  \        VP                  V4      4      u # 	  R# ) N)parentsr(   relative_to)rG  r&   rf   s   && r+   _check_initialpaths_for_relpathrL    s<     ,,"t''/00  r-   c                  ^   a  ] tR tRtRtRR V 3R lllt]RRRR/R V 3R	 lll4       tR
tV ;t	# )FSCollectori(  z%Base class for filesystem collectors.Nc               <    V ^8  d   QhRRRRRRRRR	R
RRRRRRRR/	# )r%   r1   rl   path_or_parentzPath | Node | Noner&   rm   rA   ro   rf   rg   rh   ri   rj   rk   rn   r'   r)   )r*   s   "r+   r,   FSCollector.__annotate__+  sd     4
 4
4
 +4
 	4

 4
 4
 4
  4
 4
 
4
r-   c	           	     	  < V'       dL   \        V\        4      '       d   Ve   Q h\        \        V4      pM\        V\        4      '       d	   Ve   Q hTpVf   Q hVfT   VP
                  pVeD   VP                  V8w  d3    VP                  VP                  4      p	\        V	4      p\        V4      pW0n        Vf   Vf   Q hVP                  pVfM    \        V P                  P                  VP                  P                  4      4      pV'       d   \        V4      p\         S
V `E  VVVVVVR7       R #   \         d     Li ; i  \         d    \        TP                  T4      p L^i ; i)N)rA   rf   rh   rj   rn   r&   )r   r8   r   rN  r
   rA   r&   rK  r(   r   r5   rj   rh   rootpathrL  _initialpathsrO   rM   )rx   r1   rP  r&   rA   rf   rh   rj   rn   relr[   s   &&&&&&&&& r+   rM   FSCollector.__init__+  sX    .$//~%~k>:ND11|#|%<99D!fkkT&9$**6;;7C s8D~	?%%%nnG>VTYY227>>3J3JKL !&) 	 	
) "   V89N9NPTUVs$   D5 8E 5EE!E*)E*r1   r&   c               $    V ^8  d   QhRRRRRR/# )r%   r1   rl   r&   rm   r'   r!   r)   )r*   s   "r+   r,   rQ  b  s/     	R 	R 		R
 	R 
	Rr-   c          	     0   < \         SV `  ! RRVRVRV/VB # )zThe public constructor.rf   r1   r&   r)   )rO   r|   )rE   rf   r1   r&   rG   r[   s   &&$$,r+   r|   FSCollector.from_parenta  s'     w"Q&QQdQbQQr-   r4   )NNNNNNNN)
rD   rC   r^   r_   r`   rM   r  r|   ra   rb   rc   s   @r+   rN  rN  (  sC    /4
 4
l 	R 		R
 !	R 	R 	Rr-   rN  c                      ] tR tRtRtRtR# )Filein  zGBase class for collecting tests from a file.

:ref:`non-python tests`.
r)   Nr+  r)   r-   r+   r[  r[  n  s    r-   r[  c                      ] tR tRtRtRtR# )	Directoryiu  a  Base 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`.
r)   Nr+  r)   r-   r+   r]  r]  u  s    r-   r]  c                     a  ] tR tRtRtRtRR V 3R llltR R lt]P                  R R	 l4       t
R
 R ltR R lt]R R l4       tRtV ;t# )Itemi  zyBase class of all test invocation items.

Note that for a single function there might be multiple test invocation items.
Nc               (    V ^8  d   QhRRRRRRRR/# )	r%   rh   ri   rj   rk   rn   ro   r'   rl   r)   )r*   s   "r+   r,   Item.__annotate__  s4     = = 	=
  = = 
=r-   c           	     	t   < \         SV `  ! VV3R VRVRV/VB  . V n        . V n        V P	                  4        R# )rh   rj   rn   N)rO   rM   _report_sectionsuser_properties-_check_item_and_collector_diamond_inheritance)rx   rA   rf   rh   rj   rn   rG   r[   s   &&&&&&,r+   rM   Item.__init__  s`     		
 	
 		

 	
 	
 =? :<::<r-   c                   V ^8  d   QhRR/# r   r)   )r*   s   "r+   r,   ra    s      t r-   c                   \        V 4      pRp\        WR4      '       d   R# \        WR4       RP                  R VP                   4       4      pV'       d.   \
        P                  ! VP                   RV R2\        4       R# R# )	z{
Check if the current type inherits from both File and Collector
at the same time, emitting a warning accordingly (#8447).
)_pytest_diamond_inheritance_warning_shownFNTz, c              3  j   "   T F)  p\        V\        4      '       g   K  VP                  x  K+  	  R # 5ir   )
issubclassr(  rD   )r   bases   & r+   r   EItem._check_item_and_collector_diamond_inheritance.<locals>.<genexpr>  s"      
&3dz$	7RMDMMms   33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/)	typerQ   setattrjoin	__bases__rU   rV   rD   r    )rx   rE   	attr_nameproblemss   &   r+   re  2Item._check_item_and_collector_diamond_inheritance  s    
 4j @	35))%99 
&)mm
 
 MM<<. !%%-J /gg
  r-   c                   V ^8  d   QhRR/# r   r)   )r*   s   "r+   r,   ra    s     R R Rr-   c                    \        R4      h)zkRun the test case for this item.

Must be implemented by subclasses.

.. seealso:: :ref:`non-python tests`
z,runtest must be implemented by Item subclassr1  r   s   &r+   runtestItem.runtest  s     ""PQQr-   c               (    V ^8  d   QhRRRRRRRR/# )r%   whenr(   keycontentr'   rl   r)   )r*   s   "r+   r,   ra    s(     ? ?s ? ?s ?t ?r-   c                T    V'       d    V P                   P                  WV34       R# R# )a  Add 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)rc  r   )rx   rz  r{  r|  s   &&&&r+   add_report_sectionItem.add_report_section  s%     !!(($W)=> r-   c                   V ^8  d   QhRR/# )r%   r'   z.tuple[os.PathLike[str] | str, int | None, str]r)   )r*   s   "r+   r,   ra    s     # #J #r-   c                     V P                   RR3# )a   Get 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`
NrI  r4   r   s   &r+   
reportinfoItem.reportinfo  s     yy$""r-   c                   V ^8  d   QhRR/# )r%   r'   ztuple[str, int | None, str]r)   )r*   s   "r+   r,   ra    s     
5 
55 
5r-   c                    V P                  4       p\        V^ ,          4      pV P                  P                  V4      p\	        V^,          4      \
        J g   Q hW1^,          V^,          3# )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.
)r  r   rj   _node_location_to_relpathrn  r(   )rx   r$  r&   	relfspaths   &   r+   r$  Item.location  s\     ??$HQK(LL::4@	HQK C'''A;44r-   )rc  rd  )NNNN)rD   rC   r^   r_   r`   nextitemrM   re  rC  rD  rw  r~  r  r   r$  ra   rb   rc   s   @r+   r_  r_    sX    
 H= =:: 	R R?"# 
5 
5r-   r_  )G
__future__r   rC  collections.abcr   r   r   r   	functoolsr   r	   r0   pathlibr
   typingr   r   r   r   r   r   rU   pluggy_pytest._code_pytestr   _pytest._code.coder   r   r   r   _pytest.compatr   r   _pytest.configr   r   _pytest.mark.structuresr   r   r   _pytest.outcomesr   _pytest.pathlibr   _pytest.stashr   _pytest.warning_typesr    typing_extensionsr!   _pytest.mainr"   r3   r5   __file__rf   r?  r6   r7   ABCMetar;   ABCr8   r   r(  rL  rN  r[  r]  r_  r)   r-   r+   <module>r     sa   " 
 $ $ $ * %  	             % , + ( - & $ ! 0 ( 1 0 ! (  / & % 

. w''(// T] Kv.	)4s{{ )4X^5377h ^5B9&,!cgg ,!^ 4
 
CR)SWW CRL; SWW $u54 u5r-   