§
    JDvcR  ã            	       ór  — d Z ddlmZ ddlmZ ddlmZ  G d„ de¦  «        Z G d„ dej	        e¦  «        Z
 G d	„ d
e¦  «        Z G d„ dej        e
¦  «        Z G d„ dee¦  «        Z G d„ de¦  «        Z G d„ de¦  «        Z G d„ de¦  «        Z G d„ de¦  «        Z G d„ dej        eeee¦  «        ZdS )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)ÚPYTHON2)Úcollectionsc                   ó   — e Zd ZdZd„ ZdS )ÚIItemMappingz%Simplest readable mapping object
    c                 ó   — dS )z`Get a value for a key

        A `KeyError` is raised if there is no value for the key.
        N© ©Úkeys    ú?/usr/lib/python3/dist-packages/zope/interface/common/mapping.pyÚ__getitem__zIItemMapping.__getitem__'   ó   € € € ó    N)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   r	   r   r   r   r   #   s-   € € € € € ðð ðð ð ð ð r   r   c                   ó    — e Zd ZdZdd„Zd„ ZdS )ÚIReadMappingz^
    Basic mapping interface.

    .. versionchanged:: 5.0.0
       Extend ``IContainer``
    Nc                 ó   — dS )zaGet a value for a key

        The default is returned if there is no value for the key.
        Nr	   ©r   Údefaults     r   ÚgetzIReadMapping.get6   r   r   c                 ó   — dS )z$Tell if a key exists in the mapping.Nr	   r
   s    r   Ú__contains__zIReadMapping.__contains__<   r   r   ©N)r   r   r   r   r   r   r	   r   r   r   r   .   sA   € € € € € ðð ðð ð ð ð3ð 3ð 3ð 3ð 3r   r   c                   ó   — e Zd ZdZd„ Zd„ ZdS )ÚIWriteMappingz!Mapping methods for changing datac                 ó   — dS )z.Delete a value from the mapping using the key.Nr	   r
   s    r   Ú__delitem__zIWriteMapping.__delitem__D   r   r   c                 ó   — dS )zSet a new item in the mapping.Nr	   )r   Úvalues     r   Ú__setitem__zIWriteMapping.__setitem__G   r   r   N)r   r   r   r   r    r#   r	   r   r   r   r   A   s8   € € € € € Ø+Ð+ð=ð =ð =ð-ð -ð -ð -ð -r   r   c                   ó*   — e Zd ZdZd„ Zd„ Zd„ Zd„ ZdS )ÚIEnumerableMappingzp
    Mapping objects whose items can be enumerated.

    .. versionchanged:: 5.0.0
       Extend ``ISized``
    c                  ó   — dS )z/Return the keys of the mapping object.
        Nr	   r	   r   r   ÚkeyszIEnumerableMapping.keysS   r   r   c                  ó   — dS )z?Return an iterator for the keys of the mapping object.
        Nr	   r	   r   r   Ú__iter__zIEnumerableMapping.__iter__W   r   r   c                  ó   — dS )z1Return the values of the mapping object.
        Nr	   r	   r   r   ÚvalueszIEnumerableMapping.values[   r   r   c                  ó   — dS )z0Return the items of the mapping object.
        Nr	   r	   r   r   ÚitemszIEnumerableMapping.items_   r   r   N)r   r   r   r   r'   r)   r+   r-   r	   r   r   r%   r%   K   sZ   € € € € € ðð ðð ð ðð ð ðð ð ðð ð ð ð r   r%   c                   ó   — e Zd ZdZdS )ÚIMappingz Simple mapping interface N©r   r   r   r   r	   r   r   r/   r/   c   s   € € € € € Ø$Ð$Ð$Ð$r   r/   c                   ó,   — e Zd ZdZerd„ Zd„ Zd„ ZdS dS )ÚIIterableMappingzÞA 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                  ó   — dS )z-iterate over keys; equivalent to ``__iter__``Nr	   r	   r   r   ÚiterkeyszIIterableMapping.iterkeysp   r   r   c                  ó   — dS )ziterate over valuesNr	   r	   r   r   Ú
itervalueszIIterableMapping.itervaluess   r   r   c                  ó   — dS )ziterate over itemsNr	   r	   r   r   Ú	iteritemszIIterableMapping.iteritemsv   r   r   N)r   r   r   r   ÚPY2r4   r6   r8   r	   r   r   r2   r2   f   s_   € € € € € ðð ð ð !ð	<ð 	<ð 	<ð	"ð 	"ð 	"ð	!ð 	!ð 	!ð 	!ð 	!ð!ð !r   r2   c                   ó   — e Zd ZdZd„ ZdS )ÚIClonableMappingzSSomething that can produce a copy of itself.

    This is available in `dict`.
    c                  ó   — dS )zreturn copy of dictNr	   r	   r   r   ÚcopyzIClonableMapping.copy   r   r   N)r   r   r   r   r=   r	   r   r   r;   r;   y   s-   € € € € € ðð ð
ð ð ð ð r   r;   c                   ó    — e Zd ZdZerd„ ZdS dS )ÚIExtendedReadMappingzŸ
    Something with a particular method equivalent to ``__contains__``.

    On Python 2, `dict` provides this method, but it was removed
    in Python 3.
    c                 ó   — dS )zCTell if a key exists in the mapping; equivalent to ``__contains__``Nr	   r
   s    r   Úhas_keyzIExtendedReadMapping.has_key‹   r   r   N)r   r   r   r   r9   rA   r	   r   r   r?   r?   ‚   sI   € € € € € ðð ð ð Vð	Vð 	Vð 	Vð 	Vð 	VðVð Vr   r?   c                   ó4   — e Zd ZdZd„ Zd„ Zdd„Zdd„Zd„ ZdS )	ÚIExtendedWriteMappingzHAdditional mutation methods.

    These are all provided by `dict`.
    c                  ó   — dS )zdelete all itemsNr	   r	   r   r   ÚclearzIExtendedWriteMapping.clear”   r   r   c                 ó   — dS )z0 Update D from E: for k in E.keys(): D[k] = E[k]Nr	   )Úds    r   ÚupdatezIExtendedWriteMapping.update—   r   r   Nc                 ó   — dS )z@D.setdefault(k[,d]) -> D.get(k,d), also set D[k]=d if k not in DNr	   r   s     r   Ú
setdefaultz IExtendedWriteMapping.setdefaultš   r   r   c                 ó   — dS )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	   )Úkr   s     r   ÚpopzIExtendedWriteMapping.pop�   r   r   c                  ó   — dS )zeremove and return some (key, value) pair as a
        2-tuple; but raise KeyError if mapping is emptyNr	   r	   r   r   ÚpopitemzIExtendedWriteMapping.popitem¨   r   r   r   )	r   r   r   r   rE   rH   rJ   rM   rO   r	   r   r   rC   rC   Ž   sw   € € € € € ðð ð
ð ð ð;ð ;ð ;ðKð Kð Kð Kð	ð 	ð 	ð 	ð;ð ;ð ;ð ;ð ;r   rC   c                   ó   — e Zd ZdZdS )Ú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``
    Nr0   r	   r   r   rQ   rQ   ¬   s   € € € € € ð	ð 	ð 	ð 	r   rQ   N)r   Úzope.interfacer   Úzope.interface._compatr   r9   Úzope.interface.commonr   r   Ú
IContainerr   r   ÚISizedr%   r/   r2   r;   r?   rC   ÚIMutableMappingrQ   r	   r   r   ú<module>rX      s  ððð ð" %Ð $Ð $Ð $Ð $Ð $Ø 1Ð 1Ð 1Ð 1Ð 1Ð 1Ø -Ð -Ð -Ð -Ð -Ð -ðð ð ð ð �9ñ ô ð ð3ð 3ð 3ð 3ð 3�;Ô)¨<ñ 3ô 3ð 3ð&-ð -ð -ð -ð -�Iñ -ô -ð -ðð ð ð ð ˜Ô+¨\ñ ô ð ð0%ð %ð %ð %ð %ˆ}Ð0ñ %ô %ð %ð!ð !ð !ð !ð !Ð)ñ !ô !ð !ð&ð ð ð ð �yñ ô ð ð
Vð 
Vð 
Vð 
Vð 
VÐ+ñ 
Vô 
Vð 
Vð;ð ;ð ;ð ;ð ;˜Mñ ;ô ;ð ;ð<ð ð ð ð ØÔ#ØÐ3Ð5EÀxñô ð ð ð r   