Week 16 教材 - 0611 移除過多提示(提示詞自己打)

weeks/week-16/in_class/0611-sort-lab.md

@@ -37,10 +37,7 @@
   - `f.records` — 歷次耗時的 list(累積)
 - 裝飾器內**不准 `print`**——輸出格式化是 benchmark 的事,計時器保持安靜才能被重複利用
 
-> 設計提示:`last_elapsed` 和 `records` 掛在 wrapper 函式物件上。
-> 想想看:為什麼掛在 wrapper 上而不是用全域變數?(這題會出現在課末檢測)
-
-**必備 test case(≥3)**:回傳值不變、`__name__` 保留、呼叫後 `last_elapsed > 0` 且 `records` 長度遞增。
+**必備 test case(≥3)**:規格的每一條都要有測試覆蓋。AI 給的測試齊不齊,自己驗收。
 
 ## Stage 2｜三種排序 + 量測(課堂 0:25–1:10)
 
@@ -55,8 +52,8 @@ def merge_sort(data: list) -> list: ...
 - 一律**回傳新的 list,不可修改傳入的 list**(測試會驗)
 - **禁用** `sorted()` / `list.sort()`——那是 Stage 3 的對照組
 
-**必備 test case(每個函式都要過)**:空 list、單元素、含重複值、反向排序、隨機資料與 `sorted()` 結果比對、原 list 未被修改。
-三個函式共用同一組測試——用迴圈 + `subTest`,不要複製貼上三份。
+**必備 test case(每個函式都要過)**:一般案例之外,edge case 自己想(空的?重複?已排好?),
+「不可修改傳入 list」也要有測試。三個函式共用同一組測試——用迴圈 + `subTest`,不要複製貼上三份。
 
 接著寫 `benchmark.py`:
 
@@ -91,7 +88,7 @@ def plot_results(results: dict, out_path: str) -> None: ...
 
 - 折線圖:x 軸 = 資料量 n,y 軸 = 平均秒數(**y 軸用 log scale**,不然 O(n²) 會把其他線壓扁)
 - 每個演算法一條線(含 baseline 與加速版),輸出 `assets/benchmark.png`
-- 測試提示:用 `tempfile` 驗證 PNG 有產生且大小 > 0;`plot.py` 開頭加 `matplotlib.use("Agg")` 才能在無視窗環境(含 CI)跑
+- 測試需驗證 PNG 確實產生且非空檔;環境限制:`plot.py` 開頭加 `matplotlib.use("Agg")` 才能在無視窗環境跑
 - 在你的 `README.md` 貼圖並用 2–3 句解讀:誰最快?O(n²) 和 O(n log n) 的線斜率差在哪?加速比多少?
 
 ---

weeks/week-16/in_class/0611-sort-starter/test_sorts.py

@@ -2,13 +2,14 @@
 
 規格:sorts.py 的 bubble_sort / quick_sort / merge_sort 必須
   1. 回傳新的排序後 list,不可修改傳入的 list
-  2. 禁用內建 sorted() / list.sort()(那是 Stage 3 的對照組)
+  2. 禁用內建 sorted() / list.sort()(那是 Stage 3 的對照組;
+     測試裡拿 sorted() 當驗證標準則可以)
 
 設計要求:三個函式共用同一組測試——用迴圈 + subTest,不要複製貼上三份。
 
 待辦:
-  1. 自己打提示詞跟 AI 討論,補齊測試:
-     空 list、單元素、重複值、反向、隨機資料比對、原 list 未被修改
+  1. 自己打提示詞跟 AI 討論,補齊測試——一般案例、edge case、
+     「不可修改傳入 list」都要覆蓋;AI 給的齊不齊,自己驗收
   2. 跑 `python -m unittest` 確認全紅
   3. commit: "test: stage2 排序正確性測試"
   4. 寫 sorts.py,全綠後 commit: "feat: stage2 實作三種排序與 benchmark"
@@ -18,26 +19,19 @@
 
 # from sorts import bubble_sort, quick_sort, merge_sort  # 完成 sorts.py 後解除註解
 
-# 提示:把三個排序函式放進一個 list,每個測試用
-#   for sort_fn in SORT_FUNCTIONS:
-#       with self.subTest(sort_fn.__name__):
-#           ...
-# Stage 3 的加速版只要 append 進這個 list 就能吃到同一組測試。
+# 三個排序函式都放進這個 list,每個測試用 subTest 跑一輪;
+# Stage 3 的加速版 append 進來就能吃到同一組測試。
 SORT_FUNCTIONS = []  # 解除上面 import 後填入
 
 
 class TestSortFunctions(unittest.TestCase):
     def test_basic_cases(self):
-        # 提示:空 list、單元素、重複值、反向排序
         self.fail("尚未實作 — 自己打提示詞跟 AI 討論後補上")
 
     def test_random_data_matches_builtin(self):
-        # 提示:random.seed 固定後產生資料,結果與 sorted() 比對
-        #      (測試裡可以用 sorted() 當「驗證標準」,被測函式裡不行)
         self.fail("尚未實作")
 
     def test_input_not_mutated(self):
-        # 提示:排序前先複製一份,排序後驗證原 list 沒變
         self.fail("尚未實作")
 
 

weeks/week-16/in_class/0611-sort-starter/test_timing.py

@@ -20,15 +20,12 @@
 
 class TestTimeit(unittest.TestCase):
     def test_returns_original_result(self):
-        # 提示:裝飾一個簡單函式(例如回傳 a + b),驗證回傳值不變
         self.fail("尚未實作 — 自己打提示詞跟 AI 討論後補上")
 
     def test_preserves_function_metadata(self):
-        # 提示:驗證 __name__ 不是 'wrapper'
         self.fail("尚未實作")
 
     def test_records_elapsed_time(self):
-        # 提示:呼叫兩次,驗證 last_elapsed > 0 且 records 長度為 2
         self.fail("尚未實作")