B `@sdZdZddlmZddlmZddlmZGdddej Z Gdd d ej e Z Gd d d ej e ZGd d d eZGdddeZGdddeZGdddeeZdS)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. Zrestructuredtext) Interface) collections)PYTHON2c@seZdZdZddZdS)IMinimalSequenceaMost 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). cCsdS)z``x.__getitem__(index) <==> x[index]`` Declaring this interface does not specify whether `__getitem__` supports slice objects.N)indexrrf/home/kop/projects/devel/pgwui/test_venv/lib/python3.7/site-packages/zope/interface/common/sequence.py __getitem__4szIMinimalSequence.__getitem__N)__name__ __module__ __qualname____doc__r rrrrr%s rc@seZdZdZdS)IFiniteSequencez[ A sequence of bound size. .. versionchanged:: 5.0.0 Extend ``ISized`` N)r r r r rrrrr:src@sleZdZdZddZddZddZdd Zd d Zd d Z ddZ ddZ ddZ ddZ erhddZdS) 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`` cCsdS)z'``x.__contains__(item) <==> item in x``Nr)itemrrr __contains__OszIReadSequence.__contains__cCsdS)z"``x.__lt__(other) <==> x < other``Nr)otherrrr__lt__SszIReadSequence.__lt__cCsdS)z#``x.__le__(other) <==> x <= other``Nr)rrrr__le__VszIReadSequence.__le__cCsdS)z#``x.__eq__(other) <==> x == other``Nr)rrrr__eq__YszIReadSequence.__eq__cCsdS)z#``x.__ne__(other) <==> x != other``Nr)rrrr__ne__\szIReadSequence.__ne__cCsdS)z"``x.__gt__(other) <==> x > other``Nr)rrrr__gt___szIReadSequence.__gt__cCsdS)z#``x.__ge__(other) <==> x >= other``Nr)rrrr__ge__bszIReadSequence.__ge__cCsdS)z#``x.__add__(other) <==> x + other``Nr)rrrr__add__eszIReadSequence.__add__cCsdS)z``x.__mul__(n) <==> x * n``Nr)nrrr__mul__hszIReadSequence.__mul__cCsdS)z``x.__rmul__(n) <==> n * x``Nr)rrrr__rmul__kszIReadSequence.__rmul__cCsdS)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)ijrrr __getslice__oszIReadSequence.__getslice__N)r r r r rrrrrrrrrrPY2rrrrrrBs rc@s eZdZdZddZddZdS)IExtendedReadSequencezFull read interface for listscCsdS)z%Return number of occurrences of valueNr)rrrrcountzszIExtendedReadSequence.countcGsdS)zTindex(value, [start, [stop]]) -> int Return first index of *value* Nr)rargsrrrr}szIExtendedReadSequence.indexN)r r r r r"rrrrrr!wsr!c@sxeZdZdZddZddZer0ddZdd Zd d Z d d Z ddZ dddZ ddZ ddZdddZddZdS)IUniqueMemberWriteSequencezAThe write contract for a sequence that may enforce unique memberscCsdS)z``x.__setitem__(index, item) <==> x[index] = item`` Declaring this interface does not specify whether `__setitem__` supports slice objects. Nr)rrrrr __setitem__sz&IUniqueMemberWriteSequence.__setitem__cCsdS)z``x.__delitem__(index) <==> del x[index]`` Declaring this interface does not specify whether `__delitem__` supports slice objects. Nr)rrrr __delitem__sz&IUniqueMemberWriteSequence.__delitem__cCsdS)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)rrrrrr __setslice__sz'IUniqueMemberWriteSequence.__setslice__cCsdS)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)rrrrr __delslice__sz'IUniqueMemberWriteSequence.__delslice__cCsdS)z``x.__iadd__(y) <==> x += y``Nr)yrrr__iadd__sz#IUniqueMemberWriteSequence.__iadd__cCsdS)zAppend item to endNr)rrrrappendsz!IUniqueMemberWriteSequence.appendcCsdS)zInsert item before indexNr)rrrrrinsertsz!IUniqueMemberWriteSequence.insertcCsdS)z.Remove and return item at index (default last)Nr)rrrrpopszIUniqueMemberWriteSequence.popcCsdS)z Remove first occurrence of valueNr)rrrrremovesz!IUniqueMemberWriteSequence.removecCsdS)zReverse *IN PLACE*Nrrrrrreversesz"IUniqueMemberWriteSequence.reverseNcCsdS)z3Stable sort *IN PLACE*; `cmpfunc(x, y)` -> -1, 0, 1Nr)ZcmpfuncrrrsortszIUniqueMemberWriteSequence.sortcCsdS)z3Extend list by appending elements from the iterableNr)iterablerrrextendsz!IUniqueMemberWriteSequence.extend)r-)N)r r r r r%r&r r'r(r*r+r,r.r/r0r1r3rrrrr$s  r$c@seZdZdZddZdS)IWriteSequencez!Full write contract for sequencescCsdS)z``x.__imul__(n) <==> x *= n``Nr)rrrr__imul__szIWriteSequence.__imul__N)r r r r r5rrrrr4sr4c@seZdZdZdS) 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 N)r r r r rrrrr6sr6N)r Z __docformat__Zzope.interfacerZzope.interface.commonrZzope.interface._compatrr Z IIterablerZISizedrZ IContainerrr!r$r4r6rrrrs   5 :