[Python-Dev] Best way to specify docstrings for member objects

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