�
JDvc� � � � d Z dZddlmZ ddlmZ ddlmZ G d� dej � � Z
G d� d ej e
� � Z G d
� d ej
e � � Z G d � d
e� � Z G d� de� � Z G d� de� � Z G d� 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 � � e Zd ZdZd� 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 � � dS )z�``x.__getitem__(index) <==> x[index]``
Declaring this interface does not specify whether `__getitem__`
supports slice objects.N� ��indexs �@/usr/lib/python3/dist-packages/zope/interface/common/sequence.py� __getitem__z IMinimalSequence.__getitem__4 � � � � � N)�__name__�
__module__� __qualname__�__doc__r r
r r
r r % s- � � � � � � � � #� #� #� #� #r r c � � e Zd ZdZdS )�IFiniteSequencez[
A sequence of bound size.
.. versionchanged:: 5.0.0
Extend ``ISized``
N�r r r r r
r r
r r : s � � � � � �� � � r r c �\ � e Zd ZdZd� Zd� Zd� Zd� Zd� Zd� Z d� Z
d � Z d
� Z d � Z
erd � Zd
S d
S )�
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 � � dS )z'``x.__contains__(item) <==> item in x``Nr
��items r
� __contains__zIReadSequence.__contains__O r r c � � dS )z"``x.__lt__(other) <==> x < other``Nr
��others r
�__lt__zIReadSequence.__lt__S r r c � � dS )z#``x.__le__(other) <==> x <= other``Nr
r s r
�__le__zIReadSequence.__le__V r r c � � dS )z#``x.__eq__(other) <==> x == other``Nr
r s r
�__eq__zIReadSequence.__eq__Y r r c � � dS )z#``x.__ne__(other) <==> x != other``Nr
r s r
�__ne__zIReadSequence.__ne__\ r r c � � dS )z"``x.__gt__(other) <==> x > other``Nr
r s r
�__gt__zIReadSequence.__gt___ r r c � � dS )z#``x.__ge__(other) <==> x >= other``Nr
r s r
�__ge__zIReadSequence.__ge__b r r c � � dS )z#``x.__add__(other) <==> x + other``Nr
r s r
�__add__zIReadSequence.__add__e r r c � � dS )z``x.__mul__(n) <==> x * n``Nr
��ns r
�__mul__zIReadSequence.__mul__h r r c � � dS )z ``x.__rmul__(n) <==> n * x``Nr
r/ s r
�__rmul__zIReadSequence.__rmul__k r r c � � dS )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�js r
� __getslice__zIReadSequence.__getslice__o r r N)r r r r r r! r# r% r' r) r+ r- r1 r3 �PY2r8 r
r r
r r B s� � � � � � �
�
�6� 6� 6�1� 1� 1�2� 2� 2�2� 2� 2�2� 2� 2�1� 1� 1�2� 2� 2�2� 2� 2�*� *� *�+� +� +� � � � � � � �� r r c � � e Zd ZdZd� Zd� ZdS )�IExtendedReadSequencez Full read interface for listsc � � dS )z%Return number of occurrences of valueNr
r s r
�countzIExtendedReadSequence.countz r r c � � dS )zTindex(value, [start, [stop]]) -> int
Return first index of *value*
Nr
)r �argss r
r zIExtendedReadSequence.index} r r N)r r r r r= r r
r r
r; r; w s8 � � � � � �'�'�4� 4� 4� � � � � r r; c �b � e Zd ZdZd� Zd� Zerd� Zd� Zd� Z d� Z
d� Z dd
�Z d � Z
d � Zdd�Zd� Zd
S )�IUniqueMemberWriteSequencezAThe write contract for a sequence that may enforce unique membersc � � dS )z�``x.__setitem__(index, item) <==> x[index] = item``
Declaring this interface does not specify whether `__setitem__`
supports slice objects.
Nr
�r r s r
� __setitem__z&IUniqueMemberWriteSequence.__setitem__� r r c � � dS )z�``x.__delitem__(index) <==> del x[index]``
Declaring this interface does not specify whether `__delitem__`
supports slice objects.
Nr
r s r
� __delitem__z&IUniqueMemberWriteSequence.__delitem__� r r c � � dS )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
)r6 r7 r s r
� __setslice__z'IUniqueMemberWriteSequence.__setslice__� r r c � � dS )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
r5 s r
� __delslice__z'IUniqueMemberWriteSequence.__delslice__� r r c � � dS )z ``x.__iadd__(y) <==> x += y``Nr
)�ys r
�__iadd__z#IUniqueMemberWriteSequence.__iadd__� r r c � � dS )zAppend item to endNr
r s r
�appendz!IUniqueMemberWriteSequence.append� r r c � � dS )zInsert item before indexNr
rC s r
�insertz!IUniqueMemberWriteSequence.insert� r r ���c � � dS )z.Remove and return item at index (default last)Nr
r s r
�popz IUniqueMemberWriteSequence.pop� r r c � � dS )z Remove first occurrence of valueNr
r s r
�removez!IUniqueMemberWriteSequence.remove� r r c � � dS )zReverse *IN PLACE*Nr
r
r r
�reversez"IUniqueMemberWriteSequence.reverse� r r Nc � � dS )z3Stable sort *IN PLACE*; `cmpfunc(x, y)` -> -1, 0, 1Nr
)�cmpfuncs r
�sortz IUniqueMemberWriteSequence.sort� r r c � � dS )z3Extend list by appending elements from the iterableNr
)�iterables r
�extendz!IUniqueMemberWriteSequence.extend� r r )rR )N)r r r r rD rF r9 rH rJ rM rO rQ rT rV rX r[ r^ r
r r
rA rA � s� � � � � � �K�K� � � � � � � � � � � � � � �,� ,� ,�!� !� !�'� '� '�=� =� =� =�/� /� /�!� !� !�B� B� B� B�B� B� B� B� Br rA c � � e Zd ZdZd� ZdS )�IWriteSequencez!Full write contract for sequencesc � � dS )z ``x.__imul__(n) <==> x *= n``Nr
r/ s r
�__imul__zIWriteSequence.__imul__� r r N)r r r r rb r
r r
r` r` � s) � � � � � �+�+�,� ,� ,� ,� ,r r` c � � e Zd ZdZdS )� 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
Nr r
r r
rd rd � s � � � � � �� � � r rd N)r �
__docformat__�zope.interfacer �zope.interface.commonr �zope.interface._compatr r9 � IIterabler �ISizedr �
IContainerr r; rA r` rd r
r r
�<module>rl s� �� � �$ #�
� $� $� $� $� $� $� -� -� -� -� -� -� 1� 1� 1� 1� 1� 1�#� #� #� #� #�{�,� #� #� #�*� � � � �k�(�*:� � � �3� 3� 3� 3� 3�K�*�O� 3� 3� 3�j
�
�
�
�
�M�
�
�
�8B� 8B� 8B� 8B� 8B�� 8B� 8B� 8B�t,� ,� ,� ,� ,�/� ,� ,� ,� � � � � �
�~� � � � � r |