o ¼>hOã@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@óeZdZdZdd„ZdS)Ú IItemMappingz%Simplest readable mapping object cCódS)z`Get a value for a key A `KeyError` is raised if there is no value for the key. N©©Úkeyrrú}/var/www/vedio/testing/chatpythonscript.ninositsolution.com/env/lib/python3.10/site-packages/zope/interface/common/mapping.pyÚ __getitem__'ózIItemMapping.__getitem__N)Ú__name__Ú __module__Ú __qualname__Ú__doc__r rrrr r#s rc@s"eZdZdZddd„Zdd„ZdS)Ú 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. Nr©r Údefaultrrr Úget6r zIReadMapping.getcCr)z$Tell if a key exists in the mapping.Nrrrrr Ú __contains__<r zIReadMapping.__contains__©N)r rrrrrrrrr r.s  rc@s eZdZdZdd„Zdd„ZdS)Ú IWriteMappingz!Mapping methods for changing datacCr)z.Delete a value from the mapping using the key.Nrrrrr Ú __delitem__Dr zIWriteMapping.__delitem__cCr)zSet a new item in the mapping.Nr)r Úvaluerrr Ú __setitem__Gr zIWriteMapping.__setitem__N)r rrrrrrrrr rAs rc@s0eZdZdZdd„Zdd„Zdd„Zdd „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 ÚkeysSr zIEnumerableMapping.keyscCr)z?Return an iterator for the keys of the mapping object. Nrrrrr Ú__iter__Wr zIEnumerableMapping.__iter__cCr)z1Return the values of the mapping object. Nrrrrr Úvalues[r zIEnumerableMapping.valuescCr)z0Return the items of the mapping object. Nrrrrr Úitems_r zIEnumerableMapping.itemsN)r rrrrrrrrrrr rKs  rc@óeZdZdZdS)ÚIMappingz Simple mapping interface N©r rrrrrrr r!dór!c@r )ÚIIterableMappingzLA mapping that has distinct methods for iterating without copying. Nr"rrrr r$hr#r$c@r)ÚIClonableMappingzSSomething that can produce a copy of itself. This is available in `dict`. cCr)zreturn copy of dictNrrrrr Úcopyur zIClonableMapping.copyN)r rrrr&rrrr r%os 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'yr#r'c@s<eZdZdZdd„Zdd„Zd dd„Zd d d „Zd d „ZdS)ÚIExtendedWriteMappingzHAdditional mutation methods. These are all provided by `dict`. cCr)zdelete all itemsNrrrrr Úclearˆr zIExtendedWriteMapping.clearcCr)z0 Update D from E: for k in E.keys(): D[k] = E[k]Nr)Údrrr Úupdate‹r zIExtendedWriteMapping.updateNcCr)z@D.setdefault(k[,d]) -> D.get(k,d), also set D[k]=d if k not in DNrrrrr Ú setdefaultŽr 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 Úpop‘r zIExtendedWriteMapping.popcCr)zeremove and return some (key, value) pair as a 2-tuple; but raise KeyError if mapping is emptyNrrrrr Úpopitemœr 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 r0¡sr0N)rÚzope.interfacerÚzope.interface.commonrrÚ IContainerrrÚISizedrr!r$r%r'r(ÚIMutableMappingr0rrrr Ús&      û