ง วtบfOใ ๓f—dZddlmZddlmZGd„deฆซZGd„dejeฆซZGd„d eฆซZGd „d ej eฆซZ Gd „d ee ฆซZ Gd„de ฆซZ Gd„deฆซZ Gd„de ฆซZGd„deฆซZGd„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๓—eZdZdZd„ZdS)ฺ IItemMappingz%Simplest readable mapping object c๓—dS)z`Get a value for a key A `KeyError` is raised if there is no value for the key. Nฉฉฺkeys ๚\/var/www/surfInsights/venv3-11/lib/python3.11/site-packages/zope/interface/common/mapping.pyฺ __getitem__zIItemMapping.__getitem__'๓€€€๓N)ฺ__name__ฺ __module__ฺ __qualname__ฺ__doc__r rrr rr#s-€€€€€๐๐๐ ๐ ๐ ๐ ๐ rrc๓ —eZdZdZdd„Zd„ZdS)ฺ IReadMappingz^ Basic mapping interface. .. versionchanged:: 5.0.0 Extend ``IContainer`` Nc๓—dS)zaGet a value for a key The default is returned if there is no value for the key. Nrฉr ฺdefaults r ฺgetzIReadMapping.get6r rc๓—dS)z$Tell if a key exists in the mapping.Nrr s r ฺ __contains__zIReadMapping.__contains__<r rฉN)rrrrrrrrr rr.sA€€€€€๐๐๐ ๐ ๐ ๐ ๐ 3๐3๐3๐3๐3rrc๓—eZdZdZd„Zd„ZdS)ฺ IWriteMappingz!Mapping methods for changing datac๓—dS)z.Delete a value from the mapping using the key.Nrr s r ฺ __delitem__zIWriteMapping.__delitem__Dr rc๓—dS)zSet a new item in the mapping.Nr)r ฺvalues r ฺ __setitem__zIWriteMapping.__setitem__Gr rN)rrrrrr"rrr rrAs8€€€€€ุ+ะ+๐=๐=๐=๐-๐-๐-๐-๐-rrc๓*—eZdZdZd„Zd„Zd„Zd„ZdS)ฺIEnumerableMappingzp Mapping objects whose items can be enumerated. .. versionchanged:: 5.0.0 Extend ``ISized`` c๓—dS)z/Return the keys of the mapping object. Nrrrr ฺkeyszIEnumerableMapping.keysSr rc๓—dS)z?Return an iterator for the keys of the mapping object. Nrrrr ฺ__iter__zIEnumerableMapping.__iter__Wr rc๓—dS)z1Return the values of the mapping object. Nrrrr ฺvalueszIEnumerableMapping.values[r rc๓—dS)z0Return the items of the mapping object. Nrrrr ฺitemszIEnumerableMapping.items_r rN)rrrrr&r(r*r,rrr r$r$KsZ€€€€€๐๐๐ ๐ ๐ ๐ ๐ ๐ ๐ ๐ ๐ ๐ ๐ ๐ ๐ ๐ rr$c๓—eZdZdZdS)ฺIMappingz Simple mapping interface Nฉrrrrrrr r.r.ds€€€€€ุ$ะ$ะ$ะ$rr.c๓—eZdZdZdS)ฺIIterableMappingzLA mapping that has distinct methods for iterating without copying. Nr/rrr r1r1hs€€€€€๐๐๐๐rr1c๓—eZdZdZd„ZdS)ฺIClonableMappingzSSomething that can produce a copy of itself. This is available in `dict`. c๓—dS)zreturn copy of dictNrrrr ฺcopyzIClonableMapping.copyur rN)rrrrr5rrr r3r3os-€€€€€๐๐๐ ๐๐๐๐rr3c๓—eZdZdZdS)ฺ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/rrr r7r7ys€€€€€๐๐๐๐rr7c๓4—eZdZdZd„Zd„Zdd„Zdd„Zd„ZdS) ฺIExtendedWriteMappingzHAdditional mutation methods. These are all provided by `dict`. c๓—dS)zdelete all itemsNrrrr ฺclearzIExtendedWriteMapping.clearˆr rc๓—dS)z0 Update D from E: for k in E.keys(): D[k] = E[k]Nr)ฺds r ฺupdatezIExtendedWriteMapping.update‹r rNc๓—dS)z@D.setdefault(k[,d]) -> D.get(k,d), also set D[k]=d if k not in DNrrs r ฺ setdefaultz IExtendedWriteMapping.setdefaultŽr rc๓—dS)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)ฺkrs r ฺpopzIExtendedWriteMapping.pop‘r rc๓—dS)zeremove and return some (key, value) pair as a 2-tuple; but raise KeyError if mapping is emptyNrrrr ฺpopitemzIExtendedWriteMapping.popitemœr rr) rrrrr;r>r@rCrErrr r9r9‚sw€€€€€๐๐๐ ๐๐๐;๐;๐;๐K๐K๐K๐K๐  ๐  ๐  ๐  ๐;๐;๐;๐;๐;rr9c๓—eZdZdZdS)ฺ 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/rrr rGrGกs€€€€€๐ ๐ ๐ ๐ rrGN)rฺzope.interfacerฺzope.interface.commonrrฺ IContainerrrฺISizedr$r.r1r3r7r9ฺIMutableMappingrGrrr ๚rMs๐๐๐๐"%ะ$ะ$ะ$ะ$ะ$ุ-ะ-ะ-ะ-ะ-ะ-๐ ๐ ๐ ๐ ๐ 9๑ ๔ ๐ ๐3๐3๐3๐3๐3;ิ)จ<๑3๔3๐3๐&-๐-๐-๐-๐-I๑-๔-๐-๐ ๐ ๐ ๐ ๐ ˜ิ+จ\๑ ๔ ๐ ๐2%๐%๐%๐%๐%ˆ}ะ0๑%๔%๐%๐๐๐๐๐ะ)๑๔๐๐๐๐๐๐y๑๔๐๐๐๐๐๐ะ+๑๔๐๐;๐;๐;๐;๐;˜M๑;๔;๐;๐>๐๐๐๐ุิุุุุ ๑ ๔๐๐๐r