[issue24879] Pydoc to list data descriptors in _fields order if it exists

Changes by Raymond Hettinger : -- resolution: -> fixed stage: patch review -> resolved status: open -> closed ___ Python tracker ___

[issue24879] Pydoc to list data descriptors in _fields order if it exists

Roundup Robot added the comment: New changeset f5c40ab9e233 by Raymond Hettinger in branch 'default': Issue #24879: Teach pydoc to display named tuple fields in the order they were defined. https://hg.python.org/cpython/rev/f5c40ab9e233 -- nosy: +python-dev ___

[issue24879] Pydoc to list data descriptors in _fields order if it exists

Changes by Raymond Hettinger : Added file: http://bugs.python.org/file40203/pydoc2.diff ___ Python tracker ___ ___ Python-bugs-list mailing li

[issue24879] Pydoc to list data descriptors in _fields order if it exists

R. David Murray added the comment: No, protocols and duck typing do not always use dunder names. In fact checking for dunder names explicitly is probably the less common of the two cases. (We are talking about "protocol" here in a generic sense, not the restricted set of those that include d

[issue24879] Pydoc to list data descriptors in _fields order if it exists

Yury Selivanov added the comment: > Named tuples are not a type, they are a protocol. Guido has agreed that > checking for _fields is an acceptable and preferred way of finding out > whether something is a namedtuple. They are, but for protocols we usually use dunder names. "_fields" is a co

[issue24879] Pydoc to list data descriptors in _fields order if it exists

Raymond Hettinger added the comment: Named tuples are not a type, they are a protocol. Guido has agreed that checking for _fields is an acceptable and preferred way of finding out whether something is a namedtuple.I can add a check to at least check the value of _fields is an iterable of

[issue24879] Pydoc to list data descriptors in _fields order if it exists

Yury Selivanov added the comment: Can this be enabled only for namedtuples? Otherwise this might be a backwards incompatible change, for example: class Foo: '''spam''' _fields = None -- nosy: +yselivanov ___ Python tracker

[issue24879] Pydoc to list data descriptors in _fields order if it exists

Raymond Hettinger added the comment: With the attached patch, the new output is: | -- | Data descriptors defined here: | | nickname | Alias for field number 0 | | firstname | Alias for field number 1

[issue24879] Pydoc to list data descriptors in _fields order if it exists

Changes by Raymond Hettinger : -- keywords: +patch Added file: http://bugs.python.org/file40194/pydoc.diff ___ Python tracker ___ ___

[issue24879] Pydoc to list data descriptors in _fields order if it exists

Changes by Raymond Hettinger : -- assignee: -> rhettinger stage: -> patch review ___ Python tracker ___ ___ Python-bugs-list mailing

[issue24879] Pydoc to list data descriptors in _fields order if it exists

New submission from Raymond Hettinger: Currently, help() lists out data descriptors in alphabetical order. This is fine in the general case, however if the fields are parts of a named tuple, it is more sensible to list them in the order found in the tuple. The presence of a named tuple can be