(phO FSrSSKJr SSKJr "SS\5r"SS\R \5r"SS \5r"S S \R\5r "S S \\ 5r "SS\ 5r "SS\5r "SS\ 5r"SS\5r"SS\R \\\ \ 5rg)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\rSrSrSrSrSrg) IItemMapping#z%Simplest readable mapping object cg)zPGet a value for a key A `KeyError` is raised if there is no value for the key. Nkeys P/var/www/html/venv/lib/python3.13/site-packages/zope/interface/common/mapping.py __getitem__IItemMapping.__getitem__'r N)__name__ __module__ __qualname____firstlineno____doc__r __static_attributes__r rr rr#s  rrc(\rSrSrSrSSjrSrSrg) IReadMapping.zN Basic mapping interface. .. versionchanged:: 5.0.0 Extend ``IContainer`` Ncg)zQGet a value for a key The default is returned if there is no value for the key. Nr r defaults r getIReadMapping.get6rrcg)z$Tell if a key exists in the mapping.Nr r s r __contains__IReadMapping.__contains__<rrr N)rrrrrrr rr rr rr.s 3rrc$\rSrSrSrSrSrSrg) IWriteMappingAz!Mapping methods for changing datacg)z.Delete a value from the mapping using the key.Nr r s r __delitem__IWriteMapping.__delitem__Drrcg)zSet a new item in the mapping.Nr )r values r __setitem__IWriteMapping.__setitem__Grrr N)rrrrrr'r+rr rr r$r$As+=-rr$c0\rSrSrSrSrSrSrSrSr g) IEnumerableMappingKz` Mapping objects whose items can be enumerated. .. versionchanged:: 5.0.0 Extend ``ISized`` cg)z/Return the keys of the mapping object. Nr r rr keysIEnumerableMapping.keysSrrcg)z?Return an iterator for the keys of the mapping object. Nr r rr __iter__IEnumerableMapping.__iter__Wrrcg)z1Return the values of the mapping object. Nr r rr valuesIEnumerableMapping.values[rrcg)z0Return the items of the mapping object. Nr r rr itemsIEnumerableMapping.items_rrr N) rrrrrr1r4r7r:rr rr r.r.Ks    rr.c\rSrSrSrSrg)IMappingdzSimple mapping interface r Nrrrrrrr rr r=r=ds$rr=c\rSrSrSrSrg)IIterableMappinghzDA mapping that has distinct methods for iterating without copying. r Nr?r rr rArAhsrrAc\rSrSrSrSrSrg)IClonableMappingozKSomething that can produce a copy of itself. This is available in `dict`. cg)zreturn copy of dictNr r rr copyIClonableMapping.copyurrr N)rrrrrrGrr rr rDrDos  rrDc\rSrSrSrSrg)IExtendedReadMappingyz Something with a particular method equivalent to ``__contains__``. On Python 2, `dict` provided the ``has_key`` method, but it was removed in Python 3. r Nr?r rr rJrJysrrJc>\rSrSrSrSrSrS SjrS SjrSr S r g) IExtendedWriteMappingz@Additional mutation methods. These are all provided by `dict`. cg)zdelete all itemsNr r rr clearIExtendedWriteMapping.clearrrcg)z/Update D from E: for k in E.keys(): D[k] = E[k]Nr )ds r updateIExtendedWriteMapping.updaterrNcg)z@D.setdefault(k[,d]) -> D.get(k,d), also set D[k]=d if k not in DNr rs r setdefault IExtendedWriteMapping.setdefaultrrcg)z 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 )krs r popIExtendedWriteMapping.poprrcg)z]remove and return some (key, value) pair as a 2-tuple; but raise KeyError if mapping is emptyNr r rr popitemIExtendedWriteMapping.popitemrrr r") rrrrrrPrTrWr[r^rr rr rMrMs! ;K  ;rrMc\rSrSrSrSrg) 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`` r Nr?r rr raras rraN)rzope.interfacerzope.interface.commonrr IContainerrr$ISizedr.r=rArDrJrMIMutableMappingrar rr rhs"%- 9 3;))<3&-I- ++\ 2%}0%)y+;M;> r