| Current File : //usr/lib/python3/dist-packages/zope/interface/common/__pycache__/mapping.cpython-312.pyc |
�
�� eE � �F � d Z ddlmZ ddlmZ G d� de� Z G d� dej e� Z G d� d e� Z G d
� d ej e� Z
G d � d
ee
� Z G d� de
� Z G d� de� Z
G d� de � Z G d� de� Z G d� dej eee
e � Zy)ah
Mapping Interfaces.
Importing this module does *not* mark any standard classes as
implementing any of these interfaces.
While this module is not deprecated, new code should generally use
:mod:`zope.interface.common.collections`, specifically
:class:`~zope.interface.common.collections.IMapping` and
:class:`~zope.interface.common.collections.IMutableMapping`. This
module is occasionally useful for its extremely fine grained breakdown
of interfaces.
The standard library :class:`dict` and :class:`collections.UserDict`
implement ``IMutableMapping``, but *do not* implement any of the
interfaces in this module.
� )� Interface)� collectionsc � � e Zd ZdZd� Zy)� IItemMappingz%Simplest readable mapping object
c � � y)z`Get a value for a key
A `KeyError` is raised if there is no value for the key.
N� ��keys �?/usr/lib/python3/dist-packages/zope/interface/common/mapping.py� __getitem__zIItemMapping.__getitem__& � � � N)�__name__�
__module__� __qualname__�__doc__r r r r r r " s � �� r r c � � e Zd ZdZdd�Zd� Zy)� IReadMappingz^
Basic mapping interface.
.. versionchanged:: 5.0.0
Extend ``IContainer``
Nc � � y)zaGet a value for a key
The default is returned if there is no value for the key.
Nr �r
�defaults r �getzIReadMapping.get5 r
r c � � y)z$Tell if a key exists in the mapping.Nr r s r � __contains__zIReadMapping.__contains__; r
r �N)r r r r r r r r r r r - s � �� � 3r r c � � e Zd ZdZd� Zd� Zy)�
IWriteMappingz!Mapping methods for changing datac � � y)z.Delete a value from the mapping using the key.Nr r s r � __delitem__zIWriteMapping.__delitem__C r
r c � � y)z Set a new item in the mapping.Nr )r
�values r � __setitem__zIWriteMapping.__setitem__F r
r N)r r r r r r" r r r r r @ s � �+�=�-r r c �( � e Zd ZdZd� Zd� Zd� Zd� Zy)�IEnumerableMappingzp
Mapping objects whose items can be enumerated.
.. versionchanged:: 5.0.0
Extend ``ISized``
c � � y)z/Return the keys of the mapping object.
Nr r r r �keyszIEnumerableMapping.keysR r
r c � � y)z?Return an iterator for the keys of the mapping object.
Nr r r r �__iter__zIEnumerableMapping.__iter__V r
r c � � y)z1Return the values of the mapping object.
Nr r r r �valueszIEnumerableMapping.valuesZ r
r c � � y)z0Return the items of the mapping object.
Nr r r r �itemszIEnumerableMapping.items^ r
r N)r r r r r& r( r* r, r r r r$ r$ J s � �� � � � r r$ c � � e Zd ZdZy)�IMappingz Simple mapping interface N�r r r r r r r r. r. b s � �$r r. c � � e Zd ZdZy)�IIterableMappingzLA mapping that has distinct methods for iterating
without copying.
Nr/ r r r r1 r1 e s � �r r1 c � � e Zd ZdZd� Zy)�IClonableMappingzSSomething that can produce a copy of itself.
This is available in `dict`.
c � � y)zreturn copy of dictNr r r r �copyzIClonableMapping.copyr r
r N)r r r r r5 r r r r3 r3 l s � ��
r r3 c � � e Zd ZdZy)�IExtendedReadMappingz�
Something with a particular method equivalent to ``__contains__``.
On Python 2, `dict` provided the ``has_key`` method, but it was removed
in Python 3.
Nr/ r r r r7 r7 u s � �r r7 c �2 � e Zd ZdZd� Zd� Zdd�Zdd�Zd� Zy) �IExtendedWriteMappingzHAdditional mutation methods.
These are all provided by `dict`.
c � � y)zdelete all itemsNr r r r �clearzIExtendedWriteMapping.clear� r
r c � � y)z0 Update D from E: for k in E.keys(): D[k] = E[k]Nr )�ds r �updatez IExtendedWriteMapping.update� r
r Nc � � y)z@D.setdefault(k[,d]) -> D.get(k,d), also set D[k]=d if k not in DNr r s r �
setdefaultz IExtendedWriteMapping.setdefault� r
r c � � y)a
pop(k[,default]) -> value
Remove specified key and return the corresponding value.
If key is not found, *default* is returned if given, otherwise
`KeyError` is raised. Note that *default* must not be passed by
name.
Nr )�kr s r �popzIExtendedWriteMapping.pop� r
r c � � y)zeremove and return some (key, value) pair as a
2-tuple; but raise KeyError if mapping is emptyNr r r r �popitemz IExtendedWriteMapping.popitem� r
r r ) r r r r r; r> r@ rC rE r r r r9 r9 ~ s! � ��
�;�K� �;r r9 c � � e Zd ZdZy)� IFullMappinga$
Full mapping interface.
Most uses of this interface should instead use
:class:`~zope.interface.commons.collections.IMutableMapping` (one of the
bases of this interface). The required methods are the same.
.. versionchanged:: 5.0.0
Extend ``IMutableMapping``
Nr/ r r r rG rG � s � � r rG N)r �zope.interfacer �zope.interface.commonr r �
IContainerr r �ISizedr$ r. r1 r3 r7 r9 �IMutableMappingrG r r r �<module>rM s� �� �" %� -� �9� �3�;�)�)�<� 3�&-�I� -� ��+�+�\� �0%�}� 0� %��)� � �y� ��+� � ;�M� ;�< ��#�#� � 3�5E�x� r