小编ddb*_*eck的帖子

我正在努力提高Python项目中测试的数量和质量.随着测试次数的增加,我遇到的困难之一是知道每个测试的作用以及它应该如何帮助发现问题.我知道跟踪测试的部分是更好的单元测试名称(已在别处解决),但我也有兴趣了解文档和单元测试如何结合在一起.

当这些测试将来失败时,如何记录单元测试以提高其效用？具体来说,是什么让一个好的单元测试docstring？

我很欣赏这些描述性答案以及具有出色文档的单元测试示例.虽然我只使用Python,但我对其他语言的实践持开放态度.

假设我有一个这样的项目符号列表:

* list item 1
* list item 2 (a parent)
** list item 3 (a child of list item 2)
** list item 4 (a child of list item 2 as well)
*** list item 5 (a child of list item 4 and a grand-child of list item 2)
* list item 6

我想将其解析为嵌套列表或其他一些数据结构,这使得元素之间的父子关系显式化(而不是依赖于它们的内容和相对位置).例如,这是一个元组列表,其中包含一个项目及其子项列表(等等):

编辑:希望是一个更正确的列表示例,其中列表中的每个元素都是一个元组,其中包含:子弹的文本以及子项列表(如果适用)(以相同的形式).

    [('list item 1',),
     ('list item 2', [('list item 3',), ('list item 4', [('list item 5',)])]
     ('list item 6',)]

[('list item 1',),
 ('list item …