o

$
x`��@s�dZd
Z
ddlmZ
ddlmZ
ddlmZ
Gdd�dej	�Z
Gdd	�d	eje
�ZGd
d�dej
e�ZGdd
�d
e�ZGdd�de�ZGdd�de�ZGdd�dee�ZdS)a�
Sequence 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.ISequence` and
:class:`~zope.interface.common.collections.IMutableSequence`. This
module is occasionally useful for its fine-grained breakdown of interfaces.

The standard library :class:`list`, :class:`tuple` and
:class:`collections.UserList`, among others, implement ``ISequence``
or ``IMutableSequence`` but *do not* implement any of the interfaces
in this module.
�restructuredtext�)
�	Interface)
�collections)
�PYTHON2c@�eZ
dZd
Zdd�ZdS)�IMinimalSequencea�
Most basic sequence interface.

    All sequences are iterable.  This requires at least one of the
    following:

    - a `__getitem__()` method that takes a single argument; integer
      values starting at 0 must be supported, and `IndexError` should
      be raised for the first index for which there is no value, or

    - an `__iter__()` method that returns an iterator as defined in
      the Python documentation (http://docs.python.org/lib/typeiter.html).

    c


C�d
S)z�``x.__getitem__(index) <==> x[index]``

        Declaring this interface does not specify whether `__getitem__`
        supports slice objects.N��
�indexr	r	�@/usr/lib/python3/dist-packages/zope/interface/common/sequence.py�__getitem__4�zIMinimalSequence.__getitem__N)�__name__�
__module__�__qualname__�__doc__r
r	r	r	rr%s
rc
@�eZ
dZd
ZdS)�IFiniteSequencez[
    A sequence of bound size.

    .. versionchanged:: 5.0.0
       Extend ``ISized``
    N�rrrrr	r	r	rr:�
rc@speZ
dZd
Zdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dd�Zdd�Zdd�Z
er6dd�ZdSdS)�
IReadSequencea.

    read interface shared by tuple and list

    This interface is similar to
    :class:`~zope.interface.common.collections.ISequence`, but
    requires that all instances be totally ordered. Most users
    should prefer ``ISequence``.

    .. versionchanged:: 5.0.0
       Extend ``IContainer``
    c


Cr)z'``x.__contains__(item) <==> item in x``Nr	�
�itemr	r	r�__contains__OrzIReadSequence.__contains__c


Cr)z"``x.__lt__(other) <==> x < other``Nr	�
�otherr	r	r�__lt__SrzIReadSequence.__lt__c


Cr)z#``x.__le__(other) <==> x <= other``Nr	rr	r	r�__le__VrzIReadSequence.__le__c


Cr)z#``x.__eq__(other) <==> x == other``Nr	rr	r	r�__eq__YrzIReadSequence.__eq__c


Cr)z#``x.__ne__(other) <==> x != other``Nr	rr	r	r�__ne__\rzIReadSequence.__ne__c


Cr)z"``x.__gt__(other) <==> x > other``Nr	rr	r	r�__gt___rzIReadSequence.__gt__c


Cr)z#``x.__ge__(other) <==> x >= other``Nr	rr	r	r�__ge__brzIReadSequence.__ge__c


Cr)z#``x.__add__(other) <==> x + other``Nr	rr	r	r�__add__erzIReadSequence.__add__c


Cr)z``x.__mul__(n) <==> x * n``Nr	�
�
nr	r	r�__mul__hrzIReadSequence.__mul__c


Cr)z``x.__rmul__(n) <==> n * x``Nr	r$r	r	r�__rmul__krzIReadSequence.__rmul__c
Cr)z�``x.__getslice__(i, j) <==> x[i:j]``

            Use of negative indices is not supported.

            Deprecated since Python 2.0 but still a part of `UserList`.
            Nr	��
i�
jr	r	r�__getslice__orzIReadSequence.__getslice__N)rrrrrrrrr r!r"r#r&r'�PY2r+r	r	r	rrBs

�rc@s eZ
dZd
Zdd�Zdd�ZdS)�IExtendedReadSequencezFull read interface for listsc


Cr)z%Return number of occurrences of valueNr	rr	r	r�countzrzIExtendedReadSequence.countc

Gr)zTindex(value, [start, [stop]]) -> int

        Return first index of *value*
        Nr	)r�argsr	r	rr}rzIExtendedReadSequence.indexN)rrrrr.rr	r	r	rr-ws
r-c@sxeZ
dZd
Zdd�Zdd�Zerdd�Zdd	�Zd
d�Z	dd
�Z
dd�Zddd�
Zdd�Z
dd�Zddd�
Zdd�ZdS)�IUniqueMemberWriteSequencezAThe write contract for a sequence that may enforce unique membersc
Cr)z�``x.__setitem__(index, item) <==> x[index] = item``

        Declaring this interface does not specify whether `__setitem__`
        supports slice objects.
        Nr	�rrr	r	r�__setitem__�rz&IUniqueMemberWriteSequence.__setitem__c


Cr)z�``x.__delitem__(index) <==> del x[index]``

        Declaring this interface does not specify whether `__delitem__`
        supports slice objects.
        Nr	r
r	r	r�__delitem__�rz&IUniqueMemberWriteSequence.__delitem__c
Cr)z�``x.__setslice__(i, j, other) <==> x[i:j] = other``

            Use of negative indices is not supported.

            Deprecated since Python 2.0 but still a part of `UserList`.
            Nr	)r)r*rr	r	r�__setslice__�rz'IUniqueMemberWriteSequence.__setslice__c
Cr)z�``x.__delslice__(i, j) <==> del x[i:j]``

            Use of negative indices is not supported.

            Deprecated since Python 2.0 but still a part of `UserList`.
            Nr	r(r	r	r�__delslice__�rz'IUniqueMemberWriteSequence.__delslice__c


Cr)z``x.__iadd__(y) <==> x += y``Nr	)
�
yr	r	r�__iadd__�rz#IUniqueMemberWriteSequence.__iadd__c


Cr)zAppend item to endNr	rr	r	r�append�rz!IUniqueMemberWriteSequence.appendc
Cr)zInsert item before indexNr	r1r	r	r�insert�rz!IUniqueMemberWriteSequence.insert���c


Cr)z.Remove and return item at index (default last)Nr	r
r	r	r�pop�rzIUniqueMemberWriteSequence.popc


Cr)z Remove first occurrence of valueNr	rr	r	r�remove�rz!IUniqueMemberWriteSequence.removec
Cr)zReverse *IN PLACE*Nr	r	r	r	r�reverse�rz"IUniqueMemberWriteSequence.reverseNc


Cr)z3Stable sort *IN PLACE*; `cmpfunc(x, y)` -> -1, 0, 1Nr	)
�cmpfuncr	r	r�sort�rzIUniqueMemberWriteSequence.sortc


Cr)z3Extend list by appending elements from the iterableNr	)
�iterabler	r	r�extend�rz!IUniqueMemberWriteSequence.extend)
r:)
N)rrrrr2r3r,r4r5r7r8r9r;r<r=r?rAr	r	r	rr0�s



r0c@r)�IWriteSequencez!Full write contract for sequencesc


Cr)z``x.__imul__(n) <==> x *= n``Nr	r$r	r	r�__imul__�rzIWriteSequence.__imul__N)rrrrrCr	r	r	rrB�s
rBc
@r)�	ISequencea�

    Full sequence contract.

    New code should prefer
    :class:`~zope.interface.common.collections.IMutableSequence`.

    Compared to that interface, which is implemented by :class:`list`
    (:class:`~zope.interface.common.builtins.IList`), among others,
    this interface is missing the following methods:

        - clear

        - count

        - index

    This interface adds the following methods:

        - sort
    Nrr	r	r	rrD�rrDN)r�
__docformat__�zope.interfacer�zope.interface.commonr�zope.interface._compatrr,�	IIterabler�ISizedr�
IContainerrr-r0rBrDr	r	r	r�<module>
s



5: