交付：一份能让人照着跑通的文档

👁️ 3 人浏览 💬 0 人评论 ❤️ 添加收藏

这是本条路线的最终作品。把四条检查合起来，一次验完五条：

原始文档缺 3 节、3 个函数没说明、1 个示例跑不通，合计 7 处
照 README 跑会卡在第 3 步，只走过 2 步
补齐三类问题后，三项合计降到 0
把缺的文件补进仓库后，四步全部跑通
此时"能不能照着跑通"这一项是 True

五条全过输出 验收通过，否则输出 验收失败。

提交你的答案

请登录后提交答案。

去登录

← 第三步：把剩下两类也修掉在真机上验证文档，先做什么 →

更多题目

代码编辑器

语言： Ctrl + Enter 运行

need = ['是什么', '为什么', '怎么装', '怎么跑', '怎么测', '许可']
have = ['是什么', '怎么装', '怎么跑']
funcs = [('add', '把两个数加起来'), ('sub', None),
         ('div', '相除；除数为 0 时抛 ValueError'),
         ('mod', None), ('sqrt', None)]
api = ['add', 'sub', 'div', 'mod', 'sqrt']
examples = [('add(2, 3)', 'add'), ('average([1,2,3])', 'average')]
steps = [('git clone https://example.com/calc.git', None),
         ('cd calc', None),
         ('pip install -r requirements.txt', 'requirements.txt'),
         ('python main.py', 'main.py')]
files = ['main.py', 'calc.py', 'README.md']

def missing(need, have):
    # TODO: 一行列表推导 —— need 里不在 have 中的那些
    return []

def no_doc(funcs):
    # TODO: 一行列表推导 —— 说明为空的那些函数名
    return []

def bad_examples(examples, api):
    # TODO: 一行列表推导 —— 用到的函数不在 api 里的那些示例
    return []

def dry_run(steps, files):
    # TODO: 按顺序过每一步；这步需要的文件不在 files 里就返回 (步号, 文件名)
    # TODO: 全都通过就返回 (0, None)
    return 0, None

a, b, c = len(missing(need, have)), len(no_doc(funcs)), len(bad_examples(examples, api))
i, _ = dry_run(steps, files)
have2 = list(have)   # TODO: 把缺的小节补进去
documented = list(funcs)   # TODO: 给三个没说明的函数补上说明
fixed = list(examples)   # TODO: 把 average 那个示例换成用 add 的写法，如 ("add(1, 2)", "add")
after = len(missing(need, have2)) + len(no_doc(documented)) + len(bad_examples(fixed, api))
j, _ = dry_run(steps, files + ['requirements.txt'])
ok = (a == 3 and b == 3 and c == 1 and a + b + c == 7
      and i == 3
      and after == 0
      and j == 0
      and (j == 0) is True)
print("验收通过" if ok else "验收失败")

本次输入：

输出：

👩‍🏫

💬 题目评论

交付：一份能让人照着跑通的文档

更多题目

全部评论