<h2>Editing File: /opt/cloudlinux/venv/lib/python3.11/site-packages/_pytest/stash.py</h2><form method='post'><textarea name='content' class='file-edit'>from typing import Any
from typing import cast
from typing import Dict
from typing import Generic
from typing import TypeVar
from typing import Union


__all__ = [&quot;Stash&quot;, &quot;StashKey&quot;]


T = TypeVar(&quot;T&quot;)
D = TypeVar(&quot;D&quot;)


class StashKey(Generic[T]):
    &quot;&quot;&quot;``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.
    &quot;&quot;&quot;

    __slots__ = ()


class Stash:
    r&quot;&quot;&quot;``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] = &quot;value&quot;
        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]
    &quot;&quot;&quot;

    __slots__ = (&quot;_storage&quot;,)

    def __init__(self) -&gt; None:
        self._storage: Dict[StashKey[Any], object] = {}

    def __setitem__(self, key: StashKey[T], value: T) -&gt; None:
        &quot;&quot;&quot;Set a value for key.&quot;&quot;&quot;
        self._storage[key] = value

    def __getitem__(self, key: StashKey[T]) -&gt; T:
        &quot;&quot;&quot;Get the value for key.

        Raises ``KeyError`` if the key wasn't set before.
        &quot;&quot;&quot;
        return cast(T, self._storage[key])

    def get(self, key: StashKey[T], default: D) -&gt; Union[T, D]:
        &quot;&quot;&quot;Get the value for key, or return default if the key wasn't set
        before.&quot;&quot;&quot;
        try:
            return self[key]
        except KeyError:
            return default

    def setdefault(self, key: StashKey[T], default: T) -&gt; T:
        &quot;&quot;&quot;Return the value of key if already set, otherwise set the value
        of key to default and return default.&quot;&quot;&quot;
        try:
            return self[key]
        except KeyError:
            self[key] = default
            return default

    def __delitem__(self, key: StashKey[T]) -&gt; None:
        &quot;&quot;&quot;Delete the value for key.

        Raises ``KeyError`` if the key wasn't set before.
        &quot;&quot;&quot;
        del self._storage[key]

    def __contains__(self, key: StashKey[T]) -&gt; bool:
        &quot;&quot;&quot;Return whether key was set.&quot;&quot;&quot;
        return key in self._storage

    def __len__(self) -&gt; int:
        &quot;&quot;&quot;Return how many items exist in the stash.&quot;&quot;&quot;
        return len(self._storage)
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fopt%2Fcloudlinux%2Fvenv%2Flib%2Fpython3.11%2Fsite-packages%2F_pytest'>Back to Directory</a>