U ƒç„gOã@sÔdZddlmZddlmZGdd„deƒZGdd„dejeƒZGdd „d eƒZGd d „d ej eƒZ Gd d „d ee ƒZ Gdd„de ƒZ Gdd„deƒZ Gdd„de ƒZGdd„deƒZGdd„dejeee e ƒ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)Ú collectionsc@seZdZdZdd„ZdS)Ú IItemMappingz%Simplest readable mapping object cCsdS)z`Get a value for a key A `KeyError` is raised if there is no value for the key. N©©ÚkeyrrúA/tmp/pip-unpacked-wheel-pt80dmt4/zope/interface/common/mapping.pyÚ __getitem__'szIItemMapping.__getitem__N)Ú__name__Ú __module__Ú __qualname__Ú__doc__r rrrrr#src@s"eZdZdZddd„Zdd„ZdS)Ú IReadMappingz^ Basic mapping interface. .. versionchanged:: 5.0.0 Extend ``IContainer`` NcCsdS)zaGet a value for a key The default is returned if there is no value for the key. Nr©rÚdefaultrrrÚget6szIReadMapping.getcCsdS)z$Tell if a key exists in the mapping.NrrrrrÚ __contains__<szIReadMapping.__contains__)N)r r r r rrrrrrr.s rc@s eZdZdZdd„Zdd„ZdS)Ú IWriteMappingz!Mapping methods for changing datacCsdS)z.Delete a value from the mapping using the key.NrrrrrÚ __delitem__DszIWriteMapping.__delitem__cCsdS)zSet a new item in the mapping.Nr)rÚvaluerrrÚ __setitem__GszIWriteMapping.__setitem__N)r r r r rrrrrrrAsrc@s0eZdZdZdd„Zdd„Zdd„Zdd „Zd S) ÚIEnumerableMappingzp Mapping objects whose items can be enumerated. .. versionchanged:: 5.0.0 Extend ``ISized`` cCsdS)z/Return the keys of the mapping object. NrrrrrÚkeysSszIEnumerableMapping.keyscCsdS)z?Return an iterator for the keys of the mapping object. NrrrrrÚ__iter__WszIEnumerableMapping.__iter__cCsdS)z1Return the values of the mapping object. NrrrrrÚvalues[szIEnumerableMapping.valuescCsdS)z0Return the items of the mapping object. NrrrrrÚitems_szIEnumerableMapping.itemsN)r r r r rrrrrrrrrKs rc@seZdZdZdS)ÚIMappingz Simple mapping interface N©r r r r rrrrrdsrc@seZdZdZdS)ÚIIterableMappingzLA mapping that has distinct methods for iterating without copying. Nrrrrrrhsrc@seZdZdZdd„ZdS)ÚIClonableMappingzSSomething that can produce a copy of itself. This is available in `dict`. cCsdS)zreturn copy of dictNrrrrrÚcopyuszIClonableMapping.copyN)r r r r r rrrrrosrc@seZdZdZdS)Ú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. Nrrrrrr!ysr!c@s<eZdZdZdd„Zdd„Zd dd„Zdd d „Zd d „ZdS)ÚIExtendedWriteMappingzHAdditional mutation methods. These are all provided by `dict`. cCsdS)zdelete all itemsNrrrrrÚclearˆszIExtendedWriteMapping.clearcCsdS)z0 Update D from E: for k in E.keys(): D[k] = E[k]Nr)ÚdrrrÚupdate‹szIExtendedWriteMapping.updateNcCsdS)z@D.setdefault(k[,d]) -> D.get(k,d), also set D[k]=d if k not in DNrrrrrÚ setdefaultŽsz IExtendedWriteMapping.setdefaultcCsdS)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)ÚkrrrrÚpop‘szIExtendedWriteMapping.popcCsdS)zeremove and return some (key, value) pair as a 2-tuple; but raise KeyError if mapping is emptyNrrrrrÚpopitemœszIExtendedWriteMapping.popitem)N)N) r r r r r#r%r&r(r)rrrrr"‚s   r"c@seZdZdZdS)Ú 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`` Nrrrrrr*¡sr*N)r Zzope.interfacerZzope.interface.commonrrZ IContainerrrZISizedrrrrr!r"ZIMutableMappingr*rrrrÚs$       û