o gHdE@sdZddlmZddlmZGdddeZGdddejeZGdd d eZGd d d ej eZ Gd d d ee Z Gddde Z GdddeZ Gddde ZGdddeZGdddejeee 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@eZdZdZddZdS) IItemMappingz%Simplest readable mapping object cCdS)z`Get a value for a key A `KeyError` is raised if there is no value for the key. Nkeyrrd/var/www/html/facialservice/flask-venv/lib/python3.10/site-packages/zope/interface/common/mapping.py __getitem__&zIItemMapping.__getitem__N)__name__ __module__ __qualname____doc__r rrrr r"s rc@s"eZdZdZdddZddZdS) IReadMappingz^ Basic mapping interface. .. versionchanged:: 5.0.0 Extend ``IContainer`` NcCr)zaGet a value for a key The default is returned if there is no value for the key. Nrr defaultrrr get5r zIReadMapping.getcCr)z$Tell if a key exists in the mapping.Nrrrrr __contains__;r zIReadMapping.__contains__N)r rrrrrrrrr r-s  rc@s eZdZdZddZddZdS) IWriteMappingz!Mapping methods for changing datacCr)z.Delete a value from the mapping using the key.Nrrrrr __delitem__Cr zIWriteMapping.__delitem__cCr)zSet a new item in the mapping.Nr)r valuerrr __setitem__Fr zIWriteMapping.__setitem__N)r rrrrrrrrr r@s rc@s0eZdZdZddZddZddZdd Zd S) IEnumerableMappingzp Mapping objects whose items can be enumerated. .. versionchanged:: 5.0.0 Extend ``ISized`` cCr)z/Return the keys of the mapping object. Nrrrrr keysRr zIEnumerableMapping.keyscCr)z?Return an iterator for the keys of the mapping object. Nrrrrr __iter__Vr zIEnumerableMapping.__iter__cCr)z1Return the values of the mapping object. Nrrrrr valuesZr zIEnumerableMapping.valuescCr)z0Return the items of the mapping object. Nrrrrr items^r zIEnumerableMapping.itemsN)r rrrrrrrrrrr rJs  rc@eZdZdZdS)IMappingz Simple mapping interface Nr rrrrrrr r!br!c@r )IIterableMappingzLA mapping that has distinct methods for iterating without copying. Nr"rrrr r$er#r$c@r)IClonableMappingzSSomething that can produce a copy of itself. This is available in `dict`. cCr)zreturn copy of dictNrrrrr copyrr zIClonableMapping.copyN)r rrrr&rrrr r%ls r%c@r )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"rrrr r'ur#r'c@s<eZdZdZddZddZd ddZd d d Zd d ZdS)IExtendedWriteMappingzHAdditional mutation methods. These are all provided by `dict`. cCr)zdelete all itemsNrrrrr clearr zIExtendedWriteMapping.clearcCr)z0 Update D from E: for k in E.keys(): D[k] = E[k]Nr)drrr updater zIExtendedWriteMapping.updateNcCr)z@D.setdefault(k[,d]) -> D.get(k,d), also set D[k]=d if k not in DNrrrrr setdefaultr z IExtendedWriteMapping.setdefaultcCr)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 popr zIExtendedWriteMapping.popcCr)zeremove and return some (key, value) pair as a 2-tuple; but raise KeyError if mapping is emptyNrrrrr popitemr zIExtendedWriteMapping.popitemr) r rrrr)r+r,r.r/rrrr 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"rrrr r0sr0N)rzope.interfacerzope.interface.commonrr IContainerrrISizedrr!r$r%r'r(IMutableMappingr0rrrr s