3
[ @ s d Z ddlmZ G dd deZG dd deZG dd deZG d d
d
eZG d d d eeZG d
d deZG dd deZ G dd deZ
G dd deZ G dd de
e e eZ dS )zyMapping Interfaces.
Importing this module does *not* mark any standard classes
as implementing any of these interfaces.
) Interfacec @ s e Zd ZdZdd ZdS ) IItemMappingz%Simplest readable mapping object
c C s dS )z`Get a value for a key
A `KeyError` is raised if there is no value for the key.
N )keyr r /usr/lib64/python3.6/mapping.py __getitem__ s zIItemMapping.__getitem__N)__name__
__module__ __qualname____doc__r r r r r r s r c @ s" e Zd ZdZdddZdd ZdS ) IReadMappingz Basic mapping interface
Nc C s dS )zaGet a value for a key
The default is returned if there is no value for the key.
Nr )r defaultr r r get$ s zIReadMapping.getc C s dS )z$Tell if a key exists in the mapping.Nr )r r r r __contains__* s zIReadMapping.__contains__)N)r r r
r r r r r r r r s
r c @ s e Zd ZdZdd Zdd ZdS )
IWriteMappingz!Mapping methods for changing datac C s dS )z.Delete a value from the mapping using the key.Nr )r r r r __delitem__1 s zIWriteMapping.__delitem__c C s dS )z Set a new item in the mapping.Nr )r valuer r r __setitem__4 s zIWriteMapping.__setitem__N)r r r
r r r r r r r r . s r c @ s8 e Zd ZdZdd Zdd Zdd Zdd Zd
d Zd S )
IEnumerableMappingz3Mapping objects whose items can be enumerated.
c C s dS )z/Return the keys of the mapping object.
Nr r r r r keys< s zIEnumerableMapping.keysc C s dS )z?Return an iterator for the keys of the mapping object.
Nr r r r r __iter__@ s zIEnumerableMapping.__iter__c C s dS )z1Return the values of the mapping object.
Nr r r r r valuesD s zIEnumerableMapping.valuesc C s dS )z0Return the items of the mapping object.
Nr r r r r itemsH s zIEnumerableMapping.itemsc C s dS )z$Return the number of items.
Nr r r r r __len__L s zIEnumerableMapping.__len__N) r r r
r r r r r r r r r r r 8 s r c @ s e Zd ZdZdS )IMappingz Simple mapping interface N)r r r
r r r r r r P s r c @ s( e Zd ZdZdd Zdd Zdd ZdS ) IIterableMappingzA mapping that has distinct methods for iterating
without copying.
On Python 2, a `dict` has these methods, but on Python 3
the methods defined in `IEnumerableMapping` already iterate
without copying.
c C s dS )z-iterate over keys; equivalent to ``__iter__``Nr r r r r iterkeys\ s zIIterableMapping.iterkeysc C s dS )ziterate over valuesNr r r r r
itervalues_ s zIIterableMapping.itervaluesc C s dS )ziterate over itemsNr r r r r iteritemsb s zIIterableMapping.iteritemsN)r r r
r r r r r r r r r S s r c @ s e Zd ZdZdd ZdS )IClonableMappingzSSomething that can produce a copy of itself.
This is available in `dict`.
c C s dS )zreturn copy of dictNr r r r r copyk s zIClonableMapping.copyN)r r r
r r r r r r r e s r c @ s e Zd ZdZdd ZdS )IExtendedReadMappingz
Something with a particular method equivalent to ``__contains__``.
On Python 2, `dict` provides this method, but it was removed
in Python 3.
c C s dS )zCTell if a key exists in the mapping; equivalent to ``__contains__``Nr )r r r r has_keyv s z IExtendedReadMapping.has_keyN)r r r
r r" r r r r r! n s r! c @ s: e Zd ZdZdd Zdd Zd
ddZd d
Zd d ZdS )IExtendedWriteMappingzHAdditional mutation methods.
These are all provided by `dict`.
c C s dS )zdelete all itemsNr r r r r clear s zIExtendedWriteMapping.clearc C s dS )z0 Update D from E: for k in E.keys(): D[k] = E[k]Nr )dr r r update s z IExtendedWriteMapping.updateNc C s dS )z@D.setdefault(k[,d]) -> D.get(k,d), also set D[k]=d if k not in DNr )r r
r r r
setdefault s z IExtendedWriteMapping.setdefaultc G s dS )zRemove 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 raisedNr )kargsr r r pop s zIExtendedWriteMapping.popc C s dS )zeremove and return some (key, value) pair as a
2-tuple; but raise KeyError if mapping is emptyNr r r r r popitem s z IExtendedWriteMapping.popitem)N) r r r
r r$ r& r' r* r+ r r r r r# y s
r# c @ s e Zd ZdZdS ) IFullMappingz Full mapping interface N)r r r
r r r r r r, s r, N)
r Zzope.interfacer r r r r r r r r! r# r, r r r r s