[Python-Dev] Best way to specify docstrings for member objects (original) (raw)

Ethan Furman ethan at stoneleaf.us
Wed Mar 20 18:59:44 EDT 2019

On 03/20/2019 03:24 PM, Ethan Furman wrote:

On 03/19/2019 11:55 AM, Raymond Hettinger wrote:

There's another way I would like to propose. The slots definition already works with any iterable including a dictionary (the dict values are ignored), so we could use the values for the docstrings.

[...] What do you all think about the proposal? This proposal only works with objects defining slots, and only the objects in slots? Does it help Enum, dataclasses, or other enhanced classes/objects?

Hmm. Said somewhat less snarkily, is there a more general solution to the problem of absent docstrings or do we have to attack this problem piece-by-piece?

-- Ethan

More information about the Python-Dev mailing list