课程大纲 第 99 课,共 148 课 · 评判输出
评判输出

没人要求的修改

为什么重要 你要的是一个一行的修复。这个差异还改变了总额的取整方式。评审者会读他们问到的那部分;其余的部分就这样发布了。

这一课中的助手输出是为这门课编写的,形状和真实助手的输出完全一样。它不是任何特定模型的记录。

一个统一差异(git diff 打印出来的东西)每个文件有一个头部,然后是若干个块。每个块以类似 @@ -40,7 +40,7 @@ def apply_discount(order, code): 的一行开始;第二个 @@ 后面的文本,是这处修改所在的函数或类。在一个块内部,各行以一个空格(未改变)、-(删除)或 +(新增)开头。

第二个 @@ 后面的文本只是 git 的提示:块上方最近的一行看起来像函数或类开头的行。对于在 .gitattributes 中没有 *.py diff=python 的 Python 文件,一处方法的修改常常显示的是它的 class 行,而一个从新的 def 上方开始的块,会给出它前面那个函数的名字。这个工具相信这个提示,这已经足以让评审者去看一看;当你需要精确的结果时,就设置这个属性(或者解析文件)。

算好的例子

你要求修复 apply_discount。助手的差异是:

diff --git a/app/orders.py b/app/orders.py
index 3f2a1c0..9b7e4d2 100644
--- a/app/orders.py
+++ b/app/orders.py
@@ -40,7 +40,7 @@ def apply_discount(order, code):
-    if code.percent > 100:
+    if code.percent >= 100:
@@ -88,6 +88,6 @@ def total(order):
-    return round(sum(l.price for l in order.lines), 2)
+    return sum(l.price for l in order.lines)
@@ -120,4 +120,4 @@ class Order:
-    status = "new"
+    status = "open"
diff --git a/db/reports.sql b/db/reports.sql
index 77ab12c..e09f3d1 100644
--- a/db/reports.sql
+++ b/db/reports.sql
@@ -1,3 +1,3 @@
 SELECT id, total
--- totals are rounded in total()
+-- totals are no longer rounded
 FROM orders
diff --git a/app/flags.py b/app/flags.py
new file mode 100644
index 0000000..1c2d3e4
--- /dev/null
+++ b/app/flags.py
@@ -0,0 +1,2 @@
+FAST_CHECKOUT = True
+

除了你要求的,它还修改了 total(取整没了)、类 Order 中的一个默认值、一个 SQL 文件里的一条注释(那里没有函数,所以是 <module>),还新增了一整个文件。注意 --- totals are rounded in total() 这一行:它是一条被删除的 SQL 注释(- 加上 -- totals...),而不是一个文件头。

轮到你了

编写 unrequested(diff, asked)。asked 是这个请求所涉及的函数或类名的集合。返回一个排好序的 (path, name) 对列表,每一对只出现一次。文件:一个文件从 diff --git 开始;在它的第一个块之前,--- a/PATH 和 +++ b/PATH 给出它的路径(去掉 a/ 或 b/)。如果 --- 那一侧是 /dev/null,就报告 (path, "<new file>");如果 +++ 那一侧是 /dev/null,就报告 (path, "<deleted>")(路径取自 --- 那一侧);对这些文件不再报告别的东西。块:对于其他每一个文件,每个块都属于第二个 @@ 后面的那个名字:def NAME(、async def NAME( 或 class NAME 中的名字,如果没有这样的文本,就是 "<module>"。当名字不在 asked 中时,报告 (path, name)。在一个块内部,以 --- 或 +++ 开头的行是内容,而不是头部。

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

这个练习即将开放

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