课程大纲 第 145 课,共 148 课 · 十扇门和 Field Kit
十扇门和 Field Kit

第 2 扇门:一本能扛住它的用户的账本

为什么重要 真实的数据模型会以两种方式失败:下一个变更请求放不进去,或者一个调用者错误地使用了 API,而数据悄悄地坏掉了。这扇门同时检验这两者。

一家小公司想要一本内部账本:团队的账户、在它们之间转移的钱,以及来自外部的存款。你会拿到第一份规格、两个已经商定好的变更请求,以及测试团队将针对它运行的误用脚本。所有这些都在下面和练习里。

变更请求

  • CR1:财务部门需要任意一个账户在过去任意一个时间的余额。
  • CR2:团队会被改名。一个被改名的账户保留它的 ID、余额和历史;它的旧名字会被释放出来。

误用脚本

下面的每一种都必须抛出 ValueError 并且不改变任何东西:一个不是正整数分的金额(0、-5、2.5、2.0、True、"10");一个未知的账户;转给同一个账户;一次会让发送方低于 0 的转账;一个已经被用于不同细节的转账 ID;用一个已被使用的名字开户。调用者还会在超时时重试:带着同样细节的同一个转账 ID 再次到来时,必须安静地什么都不做。一次重试比第一次尝试来得更晚,所以它的时间可能不同:必须一致的细节是两个账户和金额。

轮到你了

在一本由你设计的账本上(普通数据或一个对象)编写六个函数:

  • new_ledger():一本空账本。
  • open_account(ledger, name):返回一个新的账户 ID(任何你喜欢的值)。新账户从 0 开始。
  • rename(ledger, account_id, new_name):CR2。
  • find(ledger, name):现在名叫 name 的账户的 ID,或者 ValueError。
  • transfer(ledger, transfer_id, from_id, to_id, cents, t):在时间 t 转移 cents;from_id 为 None 表示一笔来自外部的存款。时间永远不会减小。
  • balance(ledger, account_id, t=None):计入时间 <= t 的转账后的余额,如果 t 是 None,就计入全部(CR1)。
误用脚本中的每一种情况都会抛出 ValueError 并且不改变任何东西。一次重试(同样的转账 ID、同样的账户和金额、任意更晚的时间)什么都不做,也不抛出任何异常。

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

这个练习即将开放

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