+ -iO HRt^RIHt^RIHt!RR]4t!RR]P ]4t!RR]4t!R R ]P]4t !R R ]] 4t !R R] 4t !RR]4t !RR] 4t!RR]4t!RR]P ]]] ] 4tR#)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*a]tRt^#toRtRtRtVtR#) IItemMappingz%Simplest readable mapping object c R#)zPGet a value for a key A `KeyError` is raised if there is no value for the key. Nkeys&?/usr/lib/python3/dist-packages/zope/interface/common/mapping.py __getitem__IItemMapping.__getitem__'rN)__name__ __module__ __qualname____firstlineno____doc__r __static_attributes____classdictcell__ __classdict__s@r rr#s  rrc4a]tRt^.toRtRRltRtRtVtR#) IReadMappingzN Basic mapping interface. .. versionchanged:: 5.0.0 Extend ``IContainer`` Nc R#)zQGet a value for a key The default is returned if there is no value for the key. Nrr defaults&&r getIReadMapping.get6r rc R#)z$Tell if a key exists in the mapping.Nrrs&r __contains__IReadMapping.__contains__<r rrN) rrrrrrr rrrs@r rr.s 33rrc0a]tRt^AtoRtRtRtRtVtR#) IWriteMappingz!Mapping methods for changing datac R#)z.Delete a value from the mapping using the key.Nrrs&r __delitem__IWriteMapping.__delitem__Dr rc R#)zSet a new item in the mapping.Nr)r values&&r __setitem__IWriteMapping.__setitem__Gr rrN) rrrrrr&r*rrrs@r r$r$As+=--rr$c<a]tRt^KtoRtRtRtRtRtRt Vt R#)IEnumerableMappingz` Mapping objects whose items can be enumerated. .. versionchanged:: 5.0.0 Extend ``ISized`` c R#)z/Return the keys of the mapping object. Nrrrr keysIEnumerableMapping.keysSr rc R#)z?Return an iterator for the keys of the mapping object. Nrrrr __iter__IEnumerableMapping.__iter__Wr rc R#)z1Return the values of the mapping object. Nrrrr valuesIEnumerableMapping.values[r rc R#)z0Return the items of the mapping object. Nrrrr itemsIEnumerableMapping.items_r rrN) rrrrrr/r2r5r8rrrs@r r-r-Ks#     rr-c]tRt^dtRtRtR#)IMappingzSimple mapping interface rNrrrrrrrrr r;r;ds$rr;c]tRt^htRtRtR#)IIterableMappingzDA mapping that has distinct methods for iterating without copying. rNr<rrr r>r>hsrr>c*a]tRt^otoRtRtRtVtR#)IClonableMappingzKSomething that can produce a copy of itself. This is available in `dict`. c R#)zreturn copy of dictNrrrr copyIClonableMapping.copyur rrN)rrrrrrBrrrs@r r@r@os rr@c]tRt^ytRtRtR#)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. rNr<rrr rErEysrrEcJa]tRt^toRtRtRtR RltR RltRt Rt Vt R#) IExtendedWriteMappingz@Additional mutation methods. These are all provided by `dict`. c R#)zdelete all itemsNrrrr clearIExtendedWriteMapping.clearr rc R#)z/Update D from E: for k in E.keys(): D[k] = E[k]Nr)ds&r updateIExtendedWriteMapping.updater rNc R#)z@D.setdefault(k[,d]) -> D.get(k,d), also set D[k]=d if k not in DNrrs&&r setdefault IExtendedWriteMapping.setdefaultr rc R#)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.popr rc R#)z]remove and return some (key, value) pair as a 2-tuple; but raise KeyError if mapping is emptyNrrrr popitemIExtendedWriteMapping.popitemr rrr") rrrrrrIrMrPrTrWrrrs@r rGrGs) ;K  ;;rrGc]tRt^tRtRtR#) 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`` rNr<rrr rZrZs rrZN)rzope.interfacerzope.interface.commonrr IContainerrr$ISizedr-r;r>r@rErGIMutableMappingrZrrr r`s"%- 9 3;))<3&-I- ++\ 2%}0%)y+;M;> r