Server : Apache/2.4.52 (Ubuntu) System : Linux webserver 6.8.0-49-generic #49~22.04.1-Ubuntu SMP PREEMPT_DYNAMIC Wed Nov 6 17:42:15 UTC 2 x86_64 User : www-data ( 33) PHP Version : 8.1.2-1ubuntu2.21 Disable Function : NONE Directory : /lib/python3/dist-packages/zope/interface/common/__pycache__/ |
o
$
x`R � @ s� d Z ddlmZ ddlmZ ddlmZ G dd� de�ZG dd� dej e�Z
G d d
� d
e�Z G d d � d ej e
�Z
G d
d� de e
�ZG dd� de
�ZG dd� de�ZG dd� de�ZG dd� de �ZG dd� dejeeee�ZdS )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)�PYTHON2)� collectionsc @ � e Zd ZdZdd� ZdS )� IItemMappingz%Simplest readable mapping object
c C � dS )z`Get a value for a key
A `KeyError` is raised if there is no value for the key.
N� ��keyr r �?/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 c @ s" e Zd ZdZddd�Zdd� ZdS )� IReadMappingz^
Basic mapping interface.
.. versionchanged:: 5.0.0
Extend ``IContainer``
Nc C r )zaGet a value for a key
The default is returned if there is no value for the key.
Nr �r
�defaultr r r �get6 r
zIReadMapping.getc C r )z$Tell if a key exists in the mapping.Nr r r r r � __contains__< r
zIReadMapping.__contains__�N)r r r r r r r r r r r . s
r c @ s e Zd ZdZdd� Zdd� ZdS )�
IWriteMappingz!Mapping methods for changing datac C r )z.Delete a value from the mapping using the key.Nr r r r r � __delitem__D r
zIWriteMapping.__delitem__c C r )z Set a new item in the mapping.Nr )r
�valuer r r � __setitem__G r
zIWriteMapping.__setitem__N)r r r r r r r r r r r A s r c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
S ) �IEnumerableMappingzp
Mapping objects whose items can be enumerated.
.. versionchanged:: 5.0.0
Extend ``ISized``
c C r )z/Return the keys of the mapping object.
Nr r r r r �keysS r
zIEnumerableMapping.keysc C r )z?Return an iterator for the keys of the mapping object.
Nr r r r r �__iter__W r
zIEnumerableMapping.__iter__c C r )z1Return the values of the mapping object.
Nr r r r r �values[ r
zIEnumerableMapping.valuesc C r )z0Return the items of the mapping object.
Nr r r r r �items_ r
zIEnumerableMapping.itemsN)r r r r r r r r r r r r r K s r c @ � e Zd ZdZdS )�IMappingz Simple mapping interface N�r r r r r r r r r" c s r" c @ s0 e Zd ZdZerdd� Zdd� Zdd� ZdS dS ) �IIterableMappingz�A mapping that has distinct methods for iterating
without copying.
On Python 2, a `dict` has these methods, but on Python 3
the methods defined in `IEnumerableMapping` already iterate
without copying.
c C r )z-iterate over keys; equivalent to ``__iter__``Nr r r r r �iterkeysp r
zIIterableMapping.iterkeysc C r )ziterate over valuesNr r r r r �
itervaluess r
zIIterableMapping.itervaluesc C r )ziterate over itemsNr r r r r � iteritemsv r
zIIterableMapping.iteritemsN)r r r r �PY2r% r& r' r r r r r$ f s �r$ c @ r )�IClonableMappingzSSomething that can produce a copy of itself.
This is available in `dict`.
c C r )zreturn copy of dictNr r r r r �copy r
zIClonableMapping.copyN)r r r r r* r r r r r) y s r) c @ s e Zd ZdZerdd� ZdS dS )�IExtendedReadMappingz�
Something with a particular method equivalent to ``__contains__``.
On Python 2, `dict` provides this method, but it was removed
in Python 3.
c C r )zCTell if a key exists in the mapping; equivalent to ``__contains__``Nr r r r r �has_key� r
z IExtendedReadMapping.has_keyN)r r r r r( r, r r r r r+ � s
�r+ c @ s< e Zd ZdZdd� Zdd� Zd
dd�Zd
d d
�Zd d � ZdS )�IExtendedWriteMappingzHAdditional mutation methods.
These are all provided by `dict`.
c C r )zdelete all itemsNr r r r r �clear� r
zIExtendedWriteMapping.clearc C r )z0 Update D from E: for k in E.keys(): D[k] = E[k]Nr )�dr r r �update� r
z IExtendedWriteMapping.updateNc C r )z@D.setdefault(k[,d]) -> D.get(k,d), also set D[k]=d if k not in DNr r r r r �
setdefault� r
z IExtendedWriteMapping.setdefaultc C r )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 r r r �pop� r
zIExtendedWriteMapping.popc C r )zeremove and return some (key, value) pair as a
2-tuple; but raise KeyError if mapping is emptyNr r r r r �popitem� r
z IExtendedWriteMapping.popitemr ) r r r r r. r0 r1 r3 r4 r r r r r- � s
r- c @ r! )� 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 r r5 � s r5 N)r �zope.interfacer �zope.interface._compatr r( �zope.interface.commonr r �
IContainerr r �ISizedr r" r$ r) r+ r- �IMutableMappingr5 r r r r �<module> s"
�