Message408573
The ability to add docstrings for individual attributes, by using a dictionary for __slots__ was added in Issue36326. This is a fantastic feature, and deserves better documentation. It appears to currently only be documented in the "What's New" entry for Python 3.8: https://docs.python.org/3/whatsnew/3.8.html#inspect.
Moreover, the data model documentation currently states the following regarding using a mapping to specify __slots__:
"""
Any non-string iterable may be assigned to __slots__. Mappings may also be used; however, in the future, special meaning may be assigned to the values corresponding to each key.
"""
This is arguably now incorrect. A special meaning has been assigned to the values corresponding to each key: the values can be used for per-attribute docstrings. |
|
Date |
User |
Action |
Args |
2021-12-14 22:25:11 | AlexWaygood | set | recipients:
+ AlexWaygood, rhettinger, docs@python |
2021-12-14 22:25:11 | AlexWaygood | set | messageid: <1639520711.47.0.591169978723.issue46076@roundup.psfhosted.org> |
2021-12-14 22:25:11 | AlexWaygood | link | issue46076 messages |
2021-12-14 22:25:11 | AlexWaygood | create | |
|