[issue31942] Document that support of start and stop parameters in the Sequence's index() is optional

New submission from Serhiy Storchaka <storchaka+cpython@gmail.com>: Parameters start and stop were added to the Sequence.index() mixin method in 3.5 (see issue23086). But not all concrete implementations of the Sequence ABC support them (for example range.index() doesn't, see issue28197). This should be explicitly documented (including the docstring of Sequence.index). ---------- assignee: docs@python components: Documentation keywords: easy messages: 305547 nosy: docs@python, rhettinger, serhiy.storchaka priority: normal severity: normal stage: needs patch status: open title: Document that support of start and stop parameters in the Sequence's index() is optional type: behavior versions: Python 3.6, Python 3.7 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue31942> _______________________________________

Change by Serhiy Storchaka <storchaka+cpython@gmail.com>: ---------- nosy: +Devin Jeanpierre _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue31942> _______________________________________

Change by Nitish <nitishchandrachinta@gmail.com>: ---------- keywords: +patch pull_requests: +4239 stage: needs patch -> patch review _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue31942> _______________________________________

Change by Nitish <nitishchandrachinta@gmail.com>: ---------- nosy: +nitishch _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue31942> _______________________________________

STINNER Victor <victor.stinner@gmail.com> added the comment: See also bpo-31956: "Add start and stop parameters to the array.index()". ---------- nosy: +haypo _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue31942> _______________________________________

Nitish <nitishchandrachinta@gmail.com> added the comment: Any comments on the PR? ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue31942> _______________________________________

STINNER Victor <victor.stinner@gmail.com> added the comment: New changeset 5ce0a2a100909104836f53a2c8823006ec46f8ad by Victor Stinner (Nitish Chandra) in branch 'master': bpo-31942: Document optional support of start and stop attributes in Sequence.index method (#4277) https://github.com/python/cpython/commit/5ce0a2a100909104836f53a2c8823006ec4... ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue31942> _______________________________________

Change by Roundup Robot <devnull@psf.upfronthosting.co.za>: ---------- pull_requests: +4706 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue31942> _______________________________________

STINNER Victor <victor.stinner@gmail.com> added the comment: New changeset 78cd00b799be36a35c9f5cc99ce3bcef31112a5f by Victor Stinner (Miss Islington (bot)) in branch '3.6': bpo-31942: Document optional support of start and stop attributes in Sequence.index method (GH-4277) (#4811) https://github.com/python/cpython/commit/78cd00b799be36a35c9f5cc99ce3bcef311... ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue31942> _______________________________________

STINNER Victor <victor.stinner@gmail.com> added the comment: Thanks Nitish Chandra for your doc enhancement! ---------- resolution: -> fixed stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue31942> _______________________________________
participants (4)
-
Nitish
-
Roundup Robot
-
Serhiy Storchaka
-
STINNER Victor