22 Dec
2020
22 Dec
'20
9:47 p.m.
On Tue, Dec 22, 2020 at 08:07:25PM +0300, Alexey Volobuev wrote:
Hi!
Sometimes you have to put docstrings in stub files e.g. when using code generation. In that case, stubs are the only place you can locate "objects" to add docstrings to.
Thus it is frustrating to find that docstring-related software generally tends to ignore the presence of docstrings in stubs or to work incorrectly with those.
It is not clear to me whether you are talking about dynamic tools that operate on the objects themselves, like `help()` and `inspect.getdoc()`, or static analysis tools that are expecting to work with source code. Can you elaborate on the nature of the problem and your recommended solution? -- Steve