python – 把docstrings放在特殊方法上?

前端之家收集整理的这篇文章主要介绍了python – 把docstrings放在特殊方法上?前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。
我正在尝试决定在类docstring中放入什么信息以及在__init__方法docstring中放入什么.到目前为止,我已经在类docstring中对类进行了概述以及如何使用它,而与初始化(参数详细信息等)直接相关的东西我放入了__init__ docstring.

今天我开始想知道这是否是正确的方法,所以我看了几个内置模块,我发现__init__方法几乎从来没有文档字符串.根据PEP8,“非公开方法不需要文档字符串”,但是不公开__init__?

同样,如果__getitem __,__ getattr__或__new__等其他特殊方法应该有文档字符串呢?或者我应该只提一下他们在类docstring中的后果?

解决方法

直接从 PEP 257

Public methods (including the __init__@H_502_13@ constructor) should also have docstrings.

[…]

The class constructor should be documented in the docstring for its __init__@H_502_13@ method.

猜你在找的Python相关文章