ó ÓËŜKc@sdZddlmZdefd„ƒYZdefd„ƒYZdefd„ƒYZd efd „ƒYZd eefd „ƒYZd efd„ƒYZdefd„ƒYZ defd„ƒYZ defd„ƒYZ de e e efd„ƒYZ dS(sJMapping Interfaces $Id: mapping.py 110536 2010-04-06 02:59:44Z tseaver $ i˙˙˙˙(t Interfacet IItemMappingcBseZdZd„ZRS(s%Simplest readable mapping object cCsdS(s^Get a value for a key A KeyError is raised if there is no value for the key. N((tkey((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pyt __getitem__s(t__name__t __module__t__doc__R(((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pyRst IReadMappingcBs#eZdZdd„Zd„ZRS(sBasic mapping interface cCsdS(saGet a value for a key The default is returned if there is no value for the key. N((Rtdefault((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pytget#scCsdS(s$Tell if a key exists in the mapping.N((R((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pyt __contains__)sN(RRRtNoneR R (((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pyRs t IWriteMappingcBs eZdZd„Zd„ZRS(s!Mapping methods for changing datacCsdS(s.Delete a value from the mapping using the key.N((R((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pyt __delitem__0scCsdS(sSet a new item in the mapping.N((Rtvalue((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pyt __setitem__3s(RRRR R(((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pyR -s tIEnumerableMappingcBs;eZdZd„Zd„Zd„Zd„Zd„ZRS(s3Mapping objects whose items can be enumerated. cCsdS(s/Return the keys of the mapping object. N((((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pytkeys;scCsdS(s?Return an iterator for the keys of the mapping object. N((((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pyt__iter__?scCsdS(s1Return the values of the mapping object. N((((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pytvaluesCscCsdS(s0Return the items of the mapping object. N((((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pytitemsGscCsdS(s$Return the number of items. N((((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pyt__len__Ks(RRRRRRRR(((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pyR7s     tIMappingcBseZdZRS(s Simple mapping interface (RRR(((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pyROstIIterableMappingcBs#eZd„Zd„Zd„ZRS(cCsdS(s)iterate over keys; equivalent to __iter__N((((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pytiterkeysTscCsdS(siterate over valuesN((((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pyt itervaluesWscCsdS(siterate over itemsN((((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pyt iteritemsZs(RRRRR(((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pyRRs  tIClonableMappingcBseZd„ZRS(cCsdS(sreturn copy of dictN((((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pytcopy_s(RRR(((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pyR]stIExtendedReadMappingcBseZd„ZRS(cCsdS(s?Tell if a key exists in the mapping; equivalent to __contains__N((R((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pythas_keyds(RRR(((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pyRbstIExtendedWriteMappingcBs8eZd„Zd„Zdd„Zd„Zd„ZRS(cCsdS(sdelete all itemsN((((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pytcleariscCsdS(s0 Update D from E: for k in E.keys(): D[k] = E[k]N((td((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pytupdatelscCsdS(s@D.setdefault(k[,d]) -> D.get(k,d), also set D[k]=d if k not in DN((RR((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pyt setdefaultoscGsdS(sâremove specified key and return the corresponding value *args may contain a single default value, or may not be supplied. If key is not found, default is returned if given, otherwise KeyError is raisedN((tktargs((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pytpoprscCsdS(seremove and return some (key, value) pair as a 2-tuple; but raise KeyError if mapping is emptyN((((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pytpopitemxsN(RRR R"R R#R&R'(((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pyRgs     t IFullMappingcBseZdZRS(s Full mapping interface (RRR(((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pyR(|sN( Rtzope.interfaceRRRR RRRRRRR((((sA/usr/lib/python2.7/dist-packages/zope/interface/common/mapping.pyts