Day 12: 测试与可重复的程序

参考实现（两个文件放在同一目录；已用 Python 3.13 和 3.14 验证）：
# file: counter.py
def count_non_empty(lines):
"""Return how many items contain non-whitespace text.

Raise TypeError if an item is not a str.
"""
count = 0
for line in lines:
if not isinstance(line, str):
raise TypeError(f"expected str, got {type(line).__name__}")
if line.strip():
count += 1
return count
# end file
# file: test_counter.py
import unittest

from counter import count_non_empty

class CounterTests(unittest.TestCase):
def test_empty_list_returns_zero(self):
self.assertEqual(count_non_empty([]), 0)

def test_whitespace_only_line_is_ignored(self):
self.assertEqual(count_non_empty([" \t\n"]), 0)

def test_mixed_lines_count_only_non_empty(self):
self.assertEqual(count_non_empty(["alpha\n", " \n", "", "beta"]), 2)

def test_non_string_item_raises_type_error(self):
with self.assertRaises(TypeError):
count_non_empty(["alpha", None])

if __name__ == "__main__":
unittest.main()
# end file
在该目录用发现方式运行：
$ python -m unittest -v
test_empty_list_returns_zero (test_counter.CounterTests.test_empty_list_returns_zero) ... ok
test_mixed_lines_count_only_non_empty (test_counter.CounterTests.test_mixed_lines_count_only_non_empty) ... ok
test_non_string_item_raises_type_error (test_counter.CounterTests.test_non_string_item_raises_type_error) ... ok
test_whitespace_only_line_is_ignored (test_counter.CounterTests.test_whitespace_only_line_is_ignored) ... ok

----------------------------------------------------------------------
Ran 4 tests in 0.001s

OK
直接运行文件时，只会通过 unittest.main() 执行这个文件里的测试，模块显示为 __main__：
$ python test_counter.py -v
test_empty_list_returns_zero (__main__.CounterTests.test_empty_list_returns_zero) ... ok
test_mixed_lines_count_only_non_empty (__main__.CounterTests.test_mixed_lines_count_only_non_empty) ... ok
test_non_string_item_raises_type_error (__main__.CounterTests.test_non_string_item_raises_type_error) ... ok
test_whitespace_only_line_is_ignored (__main__.CounterTests.test_whitespace_only_line_is_ignored) ... ok

----------------------------------------------------------------------
Ran 4 tests in 0.001s

OK
OK 证明了什么：在这个解释器上，这四个输入的每条断言都成立，包括 None 抛出了 TypeError。没证明什么：count_non_empty 对没人测过的输入（例如其他非 str 类型或少见的空白字符）也正确。

参考实现：
# file: scores.py
def summarize_scores(path):
"""Return {name: highest score} for rows like "ana,7".

Strict contract: a missing file raises FileNotFoundError and a
malformed score raises ValueError; blank lines are ignored.
"""
best = {}
with open(path, encoding="utf-8") as f:
for lineno, line in enumerate(f, 1):
line = line.strip()
if not line:
continue
name, _, raw = line.rpartition(",")
try:
score = int(raw)
except ValueError:
raise ValueError(f"line {lineno}: invalid score {raw!r}") from None
if name not in best or score > best[name]:
best[name] = score
return best
# end file
把上面的 test_scores.py 放在同一目录：
$ python -m unittest -v
test_invalid_score (test_scores.SummarizeTests.test_invalid_score) ... ok
test_missing_file (test_scores.SummarizeTests.test_missing_file) ... ok
test_valid_file (test_scores.SummarizeTests.test_valid_file) ... ok

----------------------------------------------------------------------
Ran 3 tests in 0.002s

OK
在同一目录做诱饵检查（bash）：
$ echo "ana,1" > does-not-exist.txt
$ python -m unittest -v
test_invalid_score (test_scores.SummarizeTests.test_invalid_score) ... ok
test_missing_file (test_scores.SummarizeTests.test_missing_file) ... ok
test_valid_file (test_scores.SummarizeTests.test_valid_file) ... ok

----------------------------------------------------------------------
Ran 3 tests in 0.002s

OK
同样三个测试通过：工作目录里的文件既不能满足也不能破坏 test_missing_file。每个预期值都在断言中可见：{"ana": 8, "bo": 9}（ana 的 8 胜过 7）、FileNotFoundError，以及 bo,x9 这一行对应的 ValueError。

修复前的观察（节选；traceback 的行因环境而异）：
$ python -m unittest -v
test_three_rows (test_total.TotalTests.test_three_rows) ... FAIL

======================================================================
FAIL: test_three_rows (test_total.TotalTests.test_three_rows)
----------------------------------------------------------------------
Traceback (most recent call last):
...
AssertionError: 20 != 30

----------------------------------------------------------------------
Ran 1 test in 0.001s

FAILED (failures=1)
诊断。症状：总分是 20 而不是 30——恰好少了一行 10 分。证据：fixture 在测试内写入，因此不涉及外部文件、工作目录或已安装的包，而且你运行的每个解释器下失败都相同。假设：readlines()[1:] 把第 1 行当作表头丢弃，但 fixture 的第一行是 a,10。分类：代码缺陷；文档规定的格式没有表头行，所以测试的 30 是对的。最小修复——只改 total.py 的一行，test_total.py 不变：
# file: total.py
def total_score(path):
"""Return the sum of the scores in rows like "a,10" (no header row)."""
total = 0
with open(path, encoding="utf-8") as f:
lines = f.readlines()
for line in lines:
name, _, raw = line.strip().rpartition(",")
total += int(raw)
return total
# end file
重跑：
$ python -m unittest -v
test_three_rows (test_total.TotalTests.test_three_rows) ... ok

----------------------------------------------------------------------
Ran 1 test in 0.001s

OK

参考答案——先记录你独立完成的尝试，再来对照。
# file: scores.py
import sys

def summarize_scores(path):
"""Return {name: highest score} for rows like "ana,7".

Strict contract: a missing file raises FileNotFoundError and a
malformed score raises ValueError; blank lines are ignored.
"""
best = {}
with open(path, encoding="utf-8") as f:
for lineno, line in enumerate(f, 1):
line = line.strip()
if not line:
continue
name, _, raw = line.rpartition(",")
try:
score = int(raw)
except ValueError:
raise ValueError(f"line {lineno}: invalid score {raw!r}") from None
if name not in best or score > best[name]:
best[name] = score
return best

def main(argv=None):
args = sys.argv[1:] if argv is None else argv
if len(args) != 1:
print("usage: python scores.py SCORES_FILE", file=sys.stderr)
return 2
try:
result = summarize_scores(args[0])
except FileNotFoundError as e:
print(f"error: file not found: {e.filename}", file=sys.stderr)
return 1
except ValueError as e:
print(f"error: {e}", file=sys.stderr)
return 1
print(result)
return 0

if __name__ == "__main__":
sys.exit(main())
# end file
# file: test_scores.py
import tempfile
import unittest
from pathlib import Path

from scores import summarize_scores

class SummarizeTests(unittest.TestCase):
def test_valid_file(self):
with tempfile.TemporaryDirectory() as d:
p = Path(d) / "scores.txt"
p.write_text("ana,7\nbo,9\nana,8\n", encoding="utf-8")
self.assertEqual(summarize_scores(str(p)), {"ana": 8, "bo": 9})

def test_missing_file(self):
with tempfile.TemporaryDirectory() as d:
missing = Path(d) / "does-not-exist.txt"
with self.assertRaises(FileNotFoundError):
summarize_scores(str(missing))

def test_invalid_score(self):
with tempfile.TemporaryDirectory() as d:
p = Path(d) / "scores.txt"
p.write_text("ana,7\nbo,x9\n", encoding="utf-8")
with self.assertRaises(ValueError):
summarize_scores(str(p))
# end file
# file: requirements.txt
# stdlib only, no third-party dependencies
# end file
在只含这三个文件的目录中运行：
$ python -m unittest -v
test_invalid_score (test_scores.SummarizeTests.test_invalid_score) ... ok
test_missing_file (test_scores.SummarizeTests.test_missing_file) ... ok
test_valid_file (test_scores.SummarizeTests.test_valid_file) ... ok

----------------------------------------------------------------------
Ran 3 tests in 0.002s

OK
然后是命令行（bash；额外的 fixture 文件在测试运行之后才创建）：
$ printf 'ana,7\nbo,9\nana,8\n' > s1.txt
$ python scores.py s1.txt; echo "exit $?"
{'ana': 8, 'bo': 9}
exit 0
$ python scores.py nope.txt; echo "exit $?"
error: file not found: nope.txt
exit 1
$ printf 'ana,7\nbo,x9\n' > s2.txt
$ python scores.py s2.txt; echo "exit $?"
error: line 2: invalid score 'x9'
exit 1
用 python -c "import sys; print(sys.executable, sys.version)" 记录解释器。恢复计划：Ran 0 tests → 检查 test_*.py 命名和发现目录（day-12-act-01）；ModuleNotFoundError → 检查解释器和工作目录（day-11）；FileNotFoundError → 检查路径（day-10）；断言失败 → 先诊断再改（day-12-act-03）。