(phSrSrSSKJr SSKJr "SS\R 5r"SS\R\5r "S S \R\ 5r "S S \ 5r "S S\5r "SS\ 5r"SS\ \5rg)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) collectionsc\rSrSrSrSrSrg)IMinimalSequence%aMost 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). cg)z``x.__getitem__(index) <==> x[index]`` Declaring this interface does not specify whether `__getitem__` supports slice objects.Nindexs Q/var/www/html/venv/lib/python3.13/site-packages/zope/interface/common/sequence.py __getitem__IMinimalSequence.__getitem__4r N)__name__ __module__ __qualname____firstlineno____doc__r__static_attributes__r rr rr%s  #rrc\rSrSrSrSrg)IFiniteSequence;zK A sequence of bound size. .. versionchanged:: 5.0.0 Extend ``ISized`` r Nrrrrrrr rr rr;srrcT\rSrSrSrSrSrSrSrSr Sr S r S r S r S rS rg) IReadSequenceDa 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`` cg)z'``x.__contains__(item) <==> item in x``Nr items r __contains__IReadSequence.__contains__Qrrcg)z"``x.__lt__(other) <==> x < other``Nr others r __lt__IReadSequence.__lt__Urrcg)z#``x.__le__(other) <==> x <= other``Nr r%s r __le__IReadSequence.__le__Xrrcg)z#``x.__eq__(other) <==> x == other``Nr r%s r __eq__IReadSequence.__eq__[rrcg)z#``x.__ne__(other) <==> x != other``Nr r%s r __ne__IReadSequence.__ne__^rrcg)z"``x.__gt__(other) <==> x > other``Nr r%s r __gt__IReadSequence.__gt__arrcg)z#``x.__ge__(other) <==> x >= other``Nr r%s r __ge__IReadSequence.__ge__drrcg)z#``x.__add__(other) <==> x + other``Nr r%s r __add__IReadSequence.__add__grrcg)z``x.__mul__(n) <==> x * n``Nr ns r __mul__IReadSequence.__mul__jrrcg)z``x.__rmul__(n) <==> n * x``Nr r<s r __rmul__IReadSequence.__rmul__mrrr N)rrrrrr"r'r*r-r0r3r6r9r>rArr rr rrDs9 61222122*+rrc$\rSrSrSrSrSrSrg)IExtendedReadSequenceqzFull read interface for listscg)z%Return number of occurrences of valueNr r s r countIExtendedReadSequence.counttrrcg)zDindex(value, [start, [stop]]) -> int Return first index of *value* Nr )r!argss r r IExtendedReadSequence.indexwrrr N)rrrrrrGr rr rr rDrDqs'4 rrDc\\rSrSrSrSrSrSrSrSr SSjr S r S r SS jr S rSrg )IUniqueMemberWriteSequence~zAThe write contract for a sequence that may enforce unique memberscg)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__&IUniqueMemberWriteSequence.__setitem__rrcg)z``x.__delitem__(index) <==> del x[index]`` Declaring this interface does not specify whether `__delitem__` supports slice objects. Nr r s r __delitem__&IUniqueMemberWriteSequence.__delitem__rrcg)z``x.__iadd__(y) <==> x += y``Nr )ys r __iadd__#IUniqueMemberWriteSequence.__iadd__rrcg)zAppend item to endNr r s r append!IUniqueMemberWriteSequence.appendrrcg)zInsert item before indexNr rPs r insert!IUniqueMemberWriteSequence.insertrrcg)z.Remove and return item at index (default last)Nr r s r popIUniqueMemberWriteSequence.poprrcg)z Remove first occurrence of valueNr r s r remove!IUniqueMemberWriteSequence.removerrcg)zReverse *IN PLACE*Nr r rr reverse"IUniqueMemberWriteSequence.reverserrNcg)z3Stable sort *IN PLACE*; `cmpfunc(x, y)` -> -1, 0, 1Nr )cmpfuncs r sortIUniqueMemberWriteSequence.sortrrcg)z3Extend list by appending elements from the iterableNr )iterables r extend!IUniqueMemberWriteSequence.extendrrr ))N)rrrrrrQrTrXr[r^rardrgrkrorr rr rMrM~s9K  ,!'=/!BBrrMc\rSrSrSrSrSrg)IWriteSequencez!Full write contract for sequencescg)z``x.__imul__(n) <==> x *= n``Nr r<s r __imul__IWriteSequence.__imul__rrr N)rrrrrrvrr rr rsrss +,rrsc\rSrSrSrSrg) 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 r Nrr rr ryrysrryN)r __docformat__zope.interfacerzope.interface.commonr IIterablerISizedr IContainerrrDrMrsryr rr rs$# $-#{,,#,k((*:*+K**O*+Z  M  'B'BT,/, ~r