สร้างและทดสอบเครื่องมือ

การพัฒนาซอฟต์แวร์ด้วย Claude Code

Dani Zysman

AI Curriculum Manager @ DataCamp

จากแผนสู่โค้ด

recraft: half: นักพัฒนานั่งทำงานที่โต๊ะ เขียนโค้ดเครื่องมือ CLI พร้อมเทอร์มินัลที่แสดงผลลัพธ์จาก argparse

  • ข้อกำหนดจากบทเรียนที่ 4.1:
    • --artist — ชื่อศิลปินที่ต้องการค้นหา
    • --format — รูปแบบผลลัพธ์เป็น JSON หรือ CSV
    • --output — พาธไฟล์สำหรับผลลัพธ์
  • Claude จะสร้าง:
    • การแยกวิเคราะห์อาร์กิวเมนต์ด้วย argparse
    • การคิวรีฐานข้อมูลผ่าน MCP
    • ตรรกะการเขียนไฟล์ผลลัพธ์
การพัฒนาซอฟต์แวร์ด้วย Claude Code

รูปแบบอาร์กิวเมนต์ของ CLI

รูปแบบ ตัวอย่าง เมื่อใดควรใช้
Required --artist "AC/DC" ต้องระบุเสมอ
Optional --format json มีค่าเริ่มต้นที่เหมาะสม
Flag --verbose ค่าบูลีนเปิด/ปิด
Positional reporter.py data.csv อินพุตหลัก
  • แนวทางปฏิบัติที่ดี:
    • เพิ่มคำอธิบาย --help ให้ทุกอาร์กิวเมนต์
    • ใช้ค่าเริ่มต้นเพื่อลดอินพุตที่ต้องระบุ
    • ตรวจสอบความถูกต้องตั้งแต่ต้น และแจ้งข้อผิดพลาดด้วยข้อความที่ชัดเจนโดยเร็ว
การพัฒนาซอฟต์แวร์ด้วย Claude Code

สร้าง Reporter

> ใช้ @PLAN.md เพื่อสร้าง reporter.py
เสร็จแล้ว! สร้างไฟล์ reporter.py ตามที่ระบุใน PLAN.md

ฟังก์ชันหลัก:
- get_db_connection()     เชื่อมต่อ SQLite แบบอ่านอย่างเดียวพร้อมการตรวจสอบ
- fetch_artist_stats()    คิวรี SQL 4 รายการสำหรับค่าสรุป
- format_json/csv()       จัดรูปแบบผลลัพธ์
- write_output()          เขียนไฟล์
- parse_args() / main()   ควบคุมการทำงานของ CLI

ฟีเจอร์:
- ค้นหาชื่อศิลปินแบบไม่สนตัวพิมพ์เล็ก-ใหญ่
- สรุปข้อมูลแยกตามอัลบั้มพร้อมรายได้
- ข้อความแจ้งข้อผิดพลาดครบตามที่กำหนด
- แฟล็ก --db สำหรับใช้ฐานข้อมูลทดสอบ
การพัฒนาซอฟต์แวร์ด้วย Claude Code

โค้ดที่สร้างขึ้น

import argparse, sqlite3, json, csv

def main():
    parser = argparse.ArgumentParser()
    ...
    args = parser.parse_args()

    conn = sqlite3.connect("chinook.db")
    # Query artist's albums and tracks...

    if args.format == "json":
        with open(args.output, "w") as f:
            json.dump(data, f, indent=2)
การพัฒนาซอฟต์แวร์ด้วย Claude Code

ทดสอบเครื่องมือ

ผังงาน: reporter.py, pytest, ตรวจสอบผลลัพธ์

  • การทดสอบตรวจสอบ:
    • ศิลปินที่ถูกต้องให้ผลลัพธ์ข้อมูล
    • มีการสร้างไฟล์ผลลัพธ์
    • รูปแบบ JSON/CSV ถูกต้อง
การพัฒนาซอฟต์แวร์ด้วย Claude Code

การทดสอบเครื่องมือ CLI

  • Unit Tests
    • ทดสอบฟังก์ชันแต่ละตัว
    • จำลองการเรียกฐานข้อมูล (mock)
    • รวดเร็ว แยกอิสระ ทำซ้ำได้
  • Integration Tests
    • รันคำสั่ง CLI จริง
    • ใช้ฐานข้อมูลจริง
    • ช้ากว่าแต่สมจริงกว่า
  • สิ่งที่ควรทดสอบ:
    • กรณีปกติ — ศิลปินถูกต้อง ผลลัพธ์ถูกต้อง
    • กรณีข้อผิดพลาด — ไม่พบศิลปิน รูปแบบไม่ถูกต้อง
    • กรณีขอบเขต — ชื่อว่าง อักขระพิเศษ
    • การจัดการไฟล์ — สิทธิ์การเขียน การเขียนทับ
การพัฒนาซอฟต์แวร์ด้วย Claude Code

การทดสอบในทางปฏิบัติ

> ใช้ @PLAN.md เพื่อสร้าง test_reporter.py
สร้าง test_reporter.py แล้ว: 31 รายการทดสอบใน 7 คลาส

ขอบเขตการทดสอบ:
- Connection     ฐานข้อมูลถูกต้อง ไฟล์หาย ไฟล์ไม่ถูกต้อง
- Stats          ศิลปินที่รู้จัก/ไม่รู้จัก ไม่สนตัวพิมพ์เล็ก-ใหญ่ หลายแนวเพลง
- JSON           รูปแบบ การเยื้อง การแปลงกลับไป-กลับมา
- CSV            สองส่วน การคั่นแนวเพลงด้วย pipe จำนวนแถว
- File I/O       การเขียน การเขียนทับ พาธที่เขียนไม่ได้
- CLI args       อาร์กิวเมนต์ที่จำเป็น การตรวจสอบตัวเลือก
- Integration    ผลลัพธ์ JSON/CSV ไม่พบศิลปิน/ฐานข้อมูล การล้างข้อมูล

ใช้ฐานข้อมูล SQLite ที่กำหนดค่าเริ่มต้นแบบย่อ: แยกอิสระจาก chinook.db

ผ่านการทดสอบทั้งหมด 31 รายการ!
การพัฒนาซอฟต์แวร์ด้วย Claude Code

มาฝึกกันเถอะ!

การพัฒนาซอฟต์แวร์ด้วย Claude Code

Preparing Video For Download...