消息 [79495]
I disagree. Purpose of __doc__ is to explain functionality all at once.
This command idiom is useful:
$ python -c 'from a_module import thing; help(thing)'
The doctest module is a lightweight nicety that helps verify that which
is suitable. The sufficiently simple algorithms of my code have doc
strings that are the complete test and explanation. For others I
provide both docstring and unit tests. But with many I explain the
arguments and output, possibly the algorithm in a doc string. Tests and
use case examples reside in the module's unit test.
I'm among the "Choose correct tool for the job. python comes with full
tool bag." group. |
|
| 日期 |
用户 |
动作 |
参数 |
| 2009-01-09 19:52:59 | LambertDW | 修改 | recipients:
+ LambertDW, dalloliogm |
| 2009-01-09 19:52:59 | LambertDW | 修改 | messageid: <1231530779.73.0.818206141585.issue4899@psf.upfronthosting.co.za> |
| 2009-01-09 19:52:59 | LambertDW | 链接 | issue4899 messages |
| 2009-01-09 19:52:58 | LambertDW | 创建 | |
|