课程大纲 第 211 课,共 250 课 · 项目:构建真东西
项目:构建真东西

自己来设计:一份每日报告

到目前为止的每一课都交给你一个脚手架:一个写了一半的函数,每一步一条注释,等着填的空白。真实的工作很少以这种方式到来。有人交给你一句话:"你能给我一份这些事件的每日摘要吗?",然后那个空文件就归你了。这一课有意制造了那一刻。起始代码几乎是空白的:一个签名和一段文档字符串,别的什么都没有。被评分的技能不是一段新的语法,而是把一个模糊的要求变成一个能工作的程序。

约定

写 daily_report(events)。输入 events 是一个字典列表,每个字典的形状像 {"day": str, "type": str, "amount": number}。返回一个字典,把每一天映射到那一天的一个小摘要:

  • 输入中出现的每一天都是结果里的一个键,恰好一次。
  • 每一天映射到 {"count": int, "total": number},其中 count 是那一天有多少个事件,total 是它们的 amount 值之和。
  • 空的输入列表返回一个空字典 {}。
  • 如果任何事件缺少必需的键之一(day、type 或 amount),就抛出 ValueError。

返回的字典里键的顺序无关紧要。重要的是计数和总和要对,并且每个输入的日子都出现一次。

三个示例

daily_report([
    {"day": "Mon", "type": "coffee", "amount": 3},
    {"day": "Mon", "type": "lunch",  "amount": 12},
    {"day": "Tue", "type": "coffee", "amount": 4},
])
# -> {"Mon": {"count": 2, "total": 15},
#     "Tue": {"count": 1, "total": 4}}

daily_report([{"day": "Sat", "type": "movie", "amount": 20}])
# -> {"Sat": {"count": 1, "total": 20}}

daily_report([])
# -> {}

怎样对付一张白纸

没有脚手架时,在动手打字之前,先在脑子里给自己搭一个。一个可靠的顺序:

  • 说出输出的形状。这里它是一个以日子为键的字典,每个值是一个有两个字段的字典。想象一条完成的条目:"Mon": {"count": 2, "total": 15}。这一个例子就告诉了你每一行代码都在朝什么努力。
  • 选出构建它的结构。你是在按一个键给行分组,并为每组累加两个数。一个在遍历列表时不断更新的字典是自然的选择:第一次见到某一天时,把它从 {"count": 0, "total": 0} 开始;之后每次都往上加。
  • 庆祝之前先处理好边界。如果你从一个空字典开始、并且从不对它做特殊处理,空列表的情况自然就解决了。格式错误的事件是你必须主动选择去处理的那个:检查各个键都存在,不存在就抛出 ValueError,而不是让一个 KeyError 漏出去。

注意这里没有逐行的注释告诉你什么时候开始一天、怎样往上加。那个决定正是这个练习本身。构建满足约定的最小的东西,然后在运行之前,对照上面三个例子把它读一遍。

轮到你了

根据约定写 daily_report(events),没有脚手架可以依靠。events 是一个字典列表,每个字典的形状为 {"day": str, "type": str, "amount": number}。返回一个字典,把每一天映射到 {"count": int, "total": number}:count 是落在那一天的事件数,total 是它们金额之和,并且每个输入的日子都恰好出现一次。空列表返回 {}。如果任何事件缺少 day、type 或 amount,就抛出 ValueError。自己设计数据的形状和循环。

发现这节课有问题?报告它 · 就这节课提问

这个练习即将开放

完成它前面的那一课,这一课就会解锁。整门课程免费,无需账号,而且你现在就可以阅读这节课。