[issue9842] Document ... used in recursive repr of containers
New submission from Éric Araujo <merwok@netwok.org>: Built-in containers like dict use an ellipsis to represent a recursive item. In the symbols index, “...” only links to the secondary prompt; I think it should also link to a paragraph explaining the display of recursive containers. ---------- assignee: docs@python components: Documentation keywords: easy messages: 116256 nosy: docs@python, eric.araujo priority: normal severity: normal stage: needs patch status: open title: Document ... used in recursive repr of containers versions: Python 2.7, Python 3.1, Python 3.2 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue9842> _______________________________________
R. David Murray <rdmurray@bitdance.com> added the comment: ... is also the Ellipsis object, and it is probably even more important that the index cross reference that usage :) ---------- nosy: +r.david.murray _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue9842> _______________________________________
Changes by Terry J. Reedy <tjreedy@udel.edu>: ---------- nosy: +terry.reedy _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue9842> _______________________________________
Changes by Terry J. Reedy <tjreedy@udel.edu>: ---------- versions: +Python 3.3, Python 3.4 -Python 3.1 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue9842> _______________________________________
Changes by Éric Araujo <merwok@netwok.org>: ---------- versions: +Python 3.6, Python 3.7 -Python 3.2, Python 3.3, Python 3.4 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue9842> _______________________________________
Changes by Mike Hoy <veozev@gmail.com>: ---------- nosy: +vexoxev _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue9842> _______________________________________
Change by Pablo Galindo Salgado <pablogsal@gmail.com>: ---------- keywords: +patch pull_requests: +4033 stage: needs patch -> patch review _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue9842> _______________________________________
Raymond Hettinger <raymond.hettinger@gmail.com> added the comment: Since the appearance of reprs is not guaranteed. I don't think this should be documented (because doing so makes it a guaranteed behavior). In fact, the appearance has changed over time from ... to [...] in and may change at some point to <...> so that it can't be confused with an actual Ellipsis object. At best this should be a FAQ entry or we can defer to behaviors that are documented and guaranteed (such as reprlib.recursive_repr() and its default fillvalue). I concur with David Murray that the Ellipsis object should be indexed and cross-referenced. ---------- nosy: +rhettinger _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue9842> _______________________________________
miss-islington <mariatta.wijaya+miss-islington@gmail.com> added the comment: New changeset b4db249c9544fc4425c32feb86d610f3224ca3d8 by Miss Islington (bot) (Pablo Galindo) in branch 'master': bpo-9842: Add cross-reference to the ellipsis object (GH-4063) https://github.com/python/cpython/commit/b4db249c9544fc4425c32feb86d610f3224... ---------- nosy: +miss-islington _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue9842> _______________________________________
Change by Serhiy Storchaka <storchaka+cpython@gmail.com>: ---------- pull_requests: +9634 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue9842> _______________________________________
Serhiy Storchaka <storchaka+cpython@gmail.com> added the comment: PR 10330 adds few references for using an ellipsis as a placeholder. ---------- nosy: +serhiy.storchaka _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue9842> _______________________________________
Serhiy Storchaka <storchaka+cpython@gmail.com> added the comment: Could anybody please look at PR 10330? ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue9842> _______________________________________
Serhiy Storchaka <storchaka+cpython@gmail.com> added the comment: New changeset 6c48bf2d9e1e18dfbfa35f7582ddd32f11f75129 by Serhiy Storchaka in branch 'master': bpo-9842: Add references for using "..." as a placeholder to the index. (GH-10330) https://github.com/python/cpython/commit/6c48bf2d9e1e18dfbfa35f7582ddd32f11f... ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue9842> _______________________________________
Change by miss-islington <mariatta.wijaya+miss-islington@gmail.com>: ---------- pull_requests: +9855 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue9842> _______________________________________
Change by miss-islington <mariatta.wijaya+miss-islington@gmail.com>: ---------- pull_requests: +9856 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue9842> _______________________________________
miss-islington <mariatta.wijaya+miss-islington@gmail.com> added the comment: New changeset f8f9915f9585a5d4f4a4457ef43ac66607c5f380 by Miss Islington (bot) in branch '3.7': bpo-9842: Add references for using "..." as a placeholder to the index. (GH-10330) https://github.com/python/cpython/commit/f8f9915f9585a5d4f4a4457ef43ac66607c... ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue9842> _______________________________________
miss-islington <mariatta.wijaya+miss-islington@gmail.com> added the comment: New changeset dac5124ba498b51a2c46e2bda751150ae244ed47 by Miss Islington (bot) in branch '3.6': bpo-9842: Add references for using "..." as a placeholder to the index. (GH-10330) https://github.com/python/cpython/commit/dac5124ba498b51a2c46e2bda751150ae24... ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue9842> _______________________________________
Change by Serhiy Storchaka <storchaka+cpython@gmail.com>: ---------- resolution: -> fixed stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue9842> _______________________________________
participants (8)
-
Mike Hoy -
miss-islington
-
Pablo Galindo Salgado
-
R. David Murray
-
Raymond Hettinger
-
Serhiy Storchaka
-
Terry J. Reedy
-
Éric Araujo