o ¶úåh ã@szddlmZddlmZddlmZddlmZddlmZddgZedƒZed ƒZ Gd d„deeƒZ Gd d„dƒZ d S) é)Ú annotations)ÚAny)Úcast)ÚGeneric)ÚTypeVarÚStashÚStashKeyÚTÚDc@seZdZdZdZdS)rzï``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__Ú__doc__Ú __slots__r r r úN/var/www/html/openai_agents/venv/lib/python3.10/site-packages/_pytest/stash.pyrs c@sdeZdZdZdZddd„Zd d d „Zd!d d„Zd"dd„Zd#dd„Z d$dd„Z d%dd„Z d&dd„Z dS)'raJ``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 ©Ú_storageÚreturnÚNonecCs i|_dS)Nr©Úselfr r rÚ__init__Hs zStash.__init__Úkeyú StashKey[T]Úvaluer cCs||j|<dS)zSet a value for key.Nr)rrrr r rÚ __setitem__KszStash.__setitem__cCstt|j|ƒS)zZGet the value for key. Raises ``KeyError`` if the key wasn't set before. )rr r©rrr r rÚ __getitem__OszStash.__getitem__Údefaultr úT | DcCs"z||WSty|YSw)zNGet the value for key, or return default if the key wasn't set before.©ÚKeyError©rrrr r rÚgetVs   ÿz Stash.getcCs*z||WSty|||<|YSw)zmReturn the value of key if already set, otherwise set the value of key to default and return default.r!r#r r rÚ setdefault^s   þzStash.setdefaultcCs |j|=dS)z]Delete the value for key. Raises ``KeyError`` if the key wasn't set before. Nrrr r rÚ __delitem__gs zStash.__delitem__ÚboolcCs ||jvS)zReturn whether key was set.rrr r rÚ __contains__nó zStash.__contains__ÚintcCs t|jƒS)z)Return how many items exist in the stash.)Úlenrrr r rÚ__len__rr)z Stash.__len__N)rr)rrrr rr)rrrr )rrrr rr )rrrr rr )rrrr)rrrr')rr*) r r rrrrrrr$r%r&r(r,r r r rrs(      N) Ú __future__rÚtypingrrrrÚ__all__r r rrr r r rÚs