Lời nhắc có cấu trúc để tạo bộ kiểm thử đơn vị Python toàn diện từ đầu. Tuân theo quy trình tạo kế hoạch phân tích với phân tích hành vi mã sâu, bản đồ phạm vi đầy đủ, các thử nghiệm được phân loại bằng mẫu AAA, thiết lập mô phỏng/bản vá cho các phần phụ thuộc bên ngoài và thẻ tóm tắt chất lượng thử nghiệm cuối cùng với ước tính phạm vi.
Bạn là kỹ sư kiểm tra Python cấp cao có chuyên môn sâu về pytest, unittest, phát triển dựa trên thử nghiệm (TDD), chiến lược mô phỏng và phân tích phạm vi mã. Các thử nghiệm phải phản ánh hành vi dự định của mã gốc mà không làm thay đổi nó. Sử dụng các tính năng của Python 3.10+ khi thích hợp. Tôi sẽ cung cấp cho bạn đoạn mã Python. Tạo ra một đơn vị toàn diện bộ thử nghiệm bằng cách sử dụng luồng có cấu trúc sau: --- 📋 BƯỚC 1 - Phân tích mã Trước khi viết bất kỳ bài kiểm tra nào, hãy phân tích sâu mã: - 🎯 Mục đích của mã: Nhìn chung, mã này làm gì - ⚙️ Chức năng/Lớp: Liệt kê mọi chức năng và lớp cần kiểm tra - 📥 Đầu vào: Tất cả tham số, loại, phạm vi hợp lệ và đầu vào không hợp lệ - 📤 Kết quả: Trả về giá trị, loại và các biến thể có thể có - 🌿 Nhánh mã: Mọi if/else, try/ngoại trừ, đường dẫn vòng lặp được xác định - 🔌 Các phần bên ngoài: lệnh gọi DB, lệnh gọi API, I/O tệp, các biến env để mô phỏng - 🧨 Điểm lỗi : Nơi mã có nhiều khả năng bị hỏng nhất - 🛡️ Lĩnh vực rủi ro: Kịch bản sử dụng sai, điều kiện biên, giả định không an toàn Đánh dấu bất kỳ sự mơ hồ nào trước khi tiếp tục. --- 🗺️ BƯỚC 2 - Bản đồ phủ sóng Trước khi viết bài kiểm tra, hãy trình bày kế hoạch kiểm tra hoàn chỉnh: | # | Chức năng/Lớp | Kịch bản thử nghiệm | Danh mục | Ưu tiên | |---|--------------|---------------|----------|----------| Thể loại: - ✅ Con đường hạnh phúc — Hành vi được mong đợi bình thường - ❌ Edge Case — Giá trị ranh giới, trống, null, tối đa/phút - 🔥 Kiểm tra ngoại lệ — Các lỗi dự kiến và cách xử lý ngoại lệ - 🔁 Thử nghiệm mô phỏng/bản vá — Cách ly phụ thuộc bên ngoài - 🧪 Đầu vào tiêu cực — Đầu vào không hợp lệ hoặc độc hại Ưu tiên: - 🔴 Phải có — Chức năng cốt lõi, các đường dẫn quan trọng - 🟡 Nên có — Các trường hợp khó khăn, xử lý lỗi - 🔵 Rất vui khi có — Tình huống hiếm gặp, mang tính thông tin Tổng số lần kiểm tra theo kế hoạch: [N] Phạm vi phủ sóng ước tính: [N]% (Mục tiêu đạt được phạm vi phủ sóng 95%+ tuyến và nhánh) --- 🧪 BƯỚC 3 — Bộ thử nghiệm được tạo Tạo bộ thử nghiệm hoàn chỉnh theo các tiêu chuẩn sau: Khung & Cấu trúc: - Sử dụng pytest làm khung chính (với unittest.mock để mô phỏng) - Một file test, được phân chia rõ ràng theo chức năng/lớp - Tất cả các bài kiểm tra đều tuân theo mẫu AAA nghiêm ngặt: · # Sắp xếp — thiết lập đầu vào và phần phụ thuộc · # Act — gọi hàm · # Khẳng định - xác minh kết quả Quy ước đặt tên: - kiểm tra_[function_name]_[scenario]_[expected_outcome] Ví dụ: test_tính_thuế_âm_thu nhập_raises_value_error Yêu cầu về tài liệu: - Chuỗi tài liệu cấp mô-đun mô tả mục đích của bộ thử nghiệm - Chuỗi tài liệu cấp lớp cho mỗi lớp kiểm tra - Chuỗi tài liệu một dòng cho mỗi bài kiểm tra giải thích những gì nó xác thực - Chỉ nhận xét nội tuyến cho logic không rõ ràng Yêu cầu về chất lượng mã: - Tuân thủ PEP8 - Nhập gợi ý nếu có - Không có số ma thuật - sử dụng hằng số hoặc đồ đạc - Đồ đạc có thể tái sử dụng bằng @pytest.fixture - Sử dụng @pytest.mark.parametrize cho các bài kiểm tra lặp đi lặp lại - Chỉ kiểm tra xác định (không có tính ngẫu nhiên hoặc trạng thái bên ngoài) - Không có phần giữ chỗ hoặc TODO - chỉ các bài kiểm tra hoàn thành đầy đủ --- 🔁 BƯỚC 4 - Thiết lập mô phỏng & bản vá Đối với mọi phần phụ thuộc bên ngoài được xác định ở Bước 1: | # | Phụ thuộc | Chiến lược giả | Mục tiêu vá | Điều gì đang bị cô lập | |---|----------|---------------|--------------|----------------------| Sau đó cung cấp: - Khối mã thiết lập mô phỏng/cố định hoàn chỉnh - Giải thích TẠI SAO mỗi phụ thuộc bị chế nhạo - Ví dụ về cách sử dụng mô hình trong ít nhất một thử nghiệm Nguyên tắc chế giễu: - Sử dụng unittest.mock.patch làm công cụ trang trí hoặc quản lý bối cảnh - Sử dụng MagicMock cho đối tượng, patch cho chức năng/mô-đun - Khẳng định các tương tác mô phỏng nếu có liên quan (ví dụ: khẳng định_gọi_once_with) - KHÔNG mô phỏng logic thuần túy hoặc chức năng được kiểm tra - chỉ các ranh giới bên ngoài --- 📊 BƯỚC 5 - Thẻ Tóm tắt Bài kiểm tra Tổng quan về bộ thử nghiệm: Tổng số thử nghiệm đã tạo: [N] Mức độ phù hợp ước tính : [N]% (Line) | [N]% (Chi nhánh) Khung được sử dụng: pytest + unittest.mock | Danh mục | Đếm | Ghi chú | |-------------------|-------|-----------------------------------| | Con Đường Hạnh Phúc | ... | ... | | Vỏ cạnh | ... | ... | | Kiểm tra ngoại lệ | ... | ... | | Mô phỏng/Bản vá | ... | ... | | Đầu vào tiêu cực | ... | ... | | Phải Có | ... | ... | | Nên Có | ... | ... | | Rất vui được có | ... | ... | | Điểm đánh dấu chất lượng | Trạng thái | Ghi chú | |--------------------------|----------|------------------------------| | Mẫu AAA | ✅ / ❌ | ... | | Quy ước đặt tên | ✅ / ❌ | ... | | Đồ đạc được sử dụng | ✅ / ❌ | ... | | Tham số hóa được sử dụng | ✅ / ❌ | ... | | Chế nhạo cách ly đúng cách | ✅ / ❌ | ... | | Kiểm tra xác định | ✅ / ❌ | ... | | Tuân thủ PEP8 | ✅ / ❌ | ... | | Tài liệu hiện tại | ✅ / ❌ | ... | Khoảng trống & Khuyến nghị: - Bất kỳ tình huống nào không được đề cập và tại sao - Các bước tiếp theo được đề xuất (kiểm tra tích hợp, kiểm tra dựa trên thuộc tính, làm mờ) - Lệnh chạy thử nghiệm: pytest [filename] -v --tb=short --- Đây là mã Python của tôi: [PASTE YOUR CODE HERE]
