٭C d dl mZ d dl mZ d dl mZ d dl mZ d dl mZ d dl mZ ddgZ ed Z ed
Z G d dee Z
G d d Z d
S ) )Any)cast)Dict)Generic)TypeVar)UnionStashStashKeyTDc e Zd ZdZdZdS )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.
N)__name__
__module__ __qualname____doc__ __slots__r _/builddir/build/BUILD/cloudlinux-venv-1.0.10/venv/lib/python3.11/site-packages/_pytest/stash.pyr
r
s IIIr c e Zd ZdZdZddZdee deddfdZdee defd Z dee d
e
de ee
f fd Z dee d
edefd Z
dee ddfd
Zdee defdZdefdZdS )r a/ ``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]
_storagereturnNc i | _ d S )Nr selfs r __init__zStash.__init__D s
57
r keyvaluec || j |< dS )zSet a value for key.Nr )r r r s r __setitem__zStash.__setitem__G s "
cr c B t t | j | S )zZGet the value for key.
Raises ``KeyError`` if the key wasn't set before.
)r r r r r s r __getitem__zStash.__getitem__K s
At}S)***r defaultc 8 | | S # t $ r |cY S w xY w)zNGet the value for key, or return default if the key wasn't set
before.KeyErrorr r r% s r getz Stash.getR s5 9 NNN s
c B | | S # t $ r
|| |< |cY S w xY w)zmReturn the value of key if already set, otherwise set the value
of key to default and return default.r' r) s r
setdefaultzStash.setdefaultZ s> 9 DINNN s
c | j |= dS )z]Delete the value for key.
Raises ``KeyError`` if the key wasn't set before.
Nr r# s r __delitem__zStash.__delitem__c s
M# r c || j v S )zReturn whether key was set.r r# s r __contains__zStash.__contains__j s dm##r c * t | j S )z)Return how many items exist in the stash.)lenr r s r __len__z
Stash.__len__n s 4=!!!r )r N)r r r r r r r
r r! r$ r r r* r, r. boolr0 intr3 r r r r r sV $ $L I8 8 8 8#x{ #1 # # # # #+x{ +q + + + +x{ Q 5A; hqk A ! x{ t $ $ $ $ $ $" " " " " " "r N) typingr r r r r r __all__r r r
r r r r r8 s J
GCLL GCLL wqz U" U" U" U" U" U" U" U" U" U"r