[New-bugs-announce] [issue45491] help() is too noisy for types used like functions

Raymond Hettinger report at bugs.python.org
Fri Oct 15 17:29:28 EDT 2021


New submission from Raymond Hettinger <raymond.hettinger at gmail.com>:

When someone requests help(range), help(zip), help(property), or help(classmethod), the expectation and need is to see something like what is shown in main documentation rather than being subjected to a listing of every standard dunder method.

It would be nice to have a way to mark types that are mostly used like functions so that help() output will be more focused and less noisy.  Then help() can omit the Methods and Static methods sections.  It would keep the section for non-standard descriptors such as start, stop, step, fget, fset, or fdel.

Alternatively, for all types, we can condense the Methods and Static Methods sections to just list the standard dunder methods rather that eating several rows of output per method.

----------
components: Library (Lib)
messages: 404050
nosy: rhettinger
priority: normal
severity: normal
status: open
title: help() is too noisy for types used like functions
type: enhancement
versions: Python 3.11

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue45491>
_______________________________________


More information about the New-bugs-announce mailing list