?g SSKJr SSKJr SSKJr SSKJr SSKJr SS/r\"S5r\"S 5r "S S\\5r "S S5r g ) ) annotations)Any)cast)Generic)TypeVarStashStashKeyTDc\rSrSrSrSrSrg)r z``StashKey`` is an object used as a key to a :class:`Stash`. A ``StashKey`` is associated with the type ``T`` of the value of the key. A ``StashKey`` is unique and cannot conflict with another key. .. versionadded:: 7.0 N)__name__ __module__ __qualname____firstlineno____doc__ __slots____static_attributes__r//usr/lib/python3/dist-packages/_pytest/stash.pyr r sIrcl\rSrSrSrSrS SjrSSjrSSjrSSjr SSjr SS jr SS jr SS jr Srg )ra``Stash`` is a type-safe heterogeneous mutable mapping that allows keys and value types to be defined separately from where it (the ``Stash``) is created. Usually you will be given an object which has a ``Stash``, for example :class:`~pytest.Config` or a :class:`~_pytest.nodes.Node`: .. code-block:: python stash: Stash = some_object.stash If a module or plugin wants to store data in this ``Stash``, it creates :class:`StashKey`\s for its keys (at the module level): .. code-block:: python # At the top-level of the module some_str_key = StashKey[str]() some_bool_key = StashKey[bool]() To store information: .. code-block:: python # Value type must match the key. stash[some_str_key] = "value" stash[some_bool_key] = True To retrieve the information: .. code-block:: python # The static type of some_str is str. some_str = stash[some_str_key] # The static type of some_bool is bool. some_bool = stash[some_bool_key] .. versionadded:: 7.0 _storagec0Ulg)Nrselfs r__init__Stash.__init__Hs 57 rc X RU'g)zSet a value for key.Nr)rkeyvalues r __setitem__Stash.__setitem__Ks" crc<[[URU5$)zJGet the value for key. Raises ``KeyError`` if the key wasn't set before. )rr rrr"s r __getitem__Stash.__getitem__Os At}}S)**rc0X$![a Us$f=f)zFGet the value for key, or return default if the key wasn't set before.KeyErrorrr"defaults rget Stash.getVs# 9  N s  c8X$![a X U'Us$f=f)zeReturn the value of key if already set, otherwise set the value of key to default and return default.r+r-s r setdefaultStash.setdefault^s* 9  IN s cURU g)zMDelete the value for key. Raises ``KeyError`` if the key wasn't set before. Nrr's r __delitem__Stash.__delitem__gs MM# rcXR;$)zReturn whether key was set.rr's r __contains__Stash.__contains__nsmm##rc,[UR5$)z)Return how many items exist in the stash.)lenrrs r__len__ Stash.__len__rs4==!!rN)returnNone)r" StashKey[T]r#r r>r?)r"r@r>r )r"r@r.r r>zT | D)r"r@r.r r>r )r"r@r>r?)r"r@r>bool)r>int)rrrrrrrr$r(r/r2r5r8r<rrrrrrs7&PI8#+$"rN) __future__rtypingrrrr__all__r r r rrrrrFsP" J  CL CL wqz W"W"r