补上缺的文件再跑一遍
把 requirements.txt 补进仓库,再跑一次,输出补之前和补之后各是第几步失败(0 表示全跑通)。
⚠️ 前几步跑通了
输出两样:一共几步 / 成功跑过了几步(卡住的那一步不算跑过)。
什么样的注释是废话
下面这种注释最没有价值:【0】。
docstring 和普通注释差在哪
docstring 和 # 注释的区别是【0】。
⚠️ 一个函数的说明该写什么
除了"这个函数做什么",docstring 还必须写清【0】。
几个函数没写说明
模块里有五个函数,其中两个写了 docstring。运行下面这段程序: def no_doc(funcs): return [n for n, d in funcs if not d] funcs = [('add'
哪几个没写
把没写说明的函数名列出来。运行下面这段程序: def no_doc(funcs): return [n for n, d in funcs if not d] funcs = [('add', '把两个数加
找出没写说明的函数
补全 no_doc(funcs):funcs 里每项是 (函数名, 说明),说明为 None 表示没写。输出没写的个数。
算出说明覆盖率
输出两样:写了说明的函数数 / 覆盖率百分比(取整,带 %)。
⚠️ 两项检查一起报
把 README 小节和函数说明两项一起查,输出三样:缺的小节数 / 没说明的函数数 / 两项合计。