test-generator

test-generator 技能是一種專門的代理程式實用工具，旨在簡化 Python 軟體專案的品質保證流程。此技能專為在 pydantic-deep 生態系統中工作的開發人員設計，透過分析函式定義、方法簽章和類別結構，自動建立完整的 pytest 測試套件。它作為專家助理，將程式碼需求轉化為強大的驗證邏輯，確保軟體透過嚴格的測試實踐維持高水準的可靠性和穩定性。此工具非常適合開發人員在綠地專案和舊程式碼重構中快速擴展測試覆蓋率，解決手動撰寫測試耗時的問題。

• 自動生成結構化的 pytest 程式碼，使用標準模式，包括類別式測試和具描述性的測試命名規範。

• 實作全面的測試類別覆蓋，透過建立快樂路徑測試、邊界情況驗證、錯誤條件處理和整合測試場景。

• 提供關於最佳實踐的智慧指導，例如利用 fixture 進行設定、應用 parametrize 裝飾器進行高效的大量輸入測試，以及模擬外部依賴項以確保測試隔離。

• 支援進階 Python 功能，包括透過 pytest-asyncio 測試非同步函式，以及驗證如空輸入、空指標和整數限制等邊界值。

• 使用 pytest.raises 促進錯誤條件測試，以確保應用程式堆疊中的穩健例外處理。

• 使用者應提供預計測試的具體模組或函式片段，以獲得最精確的程式碼生成結果。

• 優先為每個測試保持單一斷言原則，以維持清晰度並簡化測試失敗時的除錯過程。

• 始終審查生成的斷言，確認其符合專案特定的商業邏輯和預期的輸出限制。

• 測試複雜系統時，請確保正確識別外部依賴項，以便工具能提供適當的模擬策略。

• 雖然工具生成符合習慣的 pytest 程式碼，建議在 CI 管線中審查覆蓋率結果，以確保函式內的所有分支邏輯皆已充分執行。