Construiește și testează instrumentul

Dezvoltare software cu Claude Code

Dani Zysman

AI Curriculum Manager @ DataCamp

De la plan la cod

recraft: half: Dezvoltator la birou scriind cod pentru un instrument CLI, cu terminal care afișează rezultate argparse

  • Specificația noastră din lecția 4.1:
    • --artist — numele artistului de interogat
    • --format — format de ieșire JSON sau CSV
    • --output — calea fișierului pentru rezultate
  • Claude va genera:
    • parsarea argumentelor cu argparse
    • interogarea bazei de date prin MCP
    • logica de scriere a fișierului
Dezvoltare software cu Claude Code

Tipare de argumente CLI

Tipar Exemplu Când se folosește
Obligatoriu --artist "AC/DC" Trebuie furnizat
Opțional --format json Are o valoare implicită
Flag --verbose Boolean activat/dezactivat
Pozițional reporter.py data.csv Intrare principală
  • Bune practici:
    • Adaugă descrieri --help pentru fiecare argument
    • Folosește valori implicite pentru a reduce intrările obligatorii
    • Validează devreme, eșuează rapid cu mesaje clare
Dezvoltare software cu Claude Code

Construirea Reporter-ului

> Use @PLAN.md to build reporter.py
Done! Created reporter.py following PLAN.md

Core functions:
- get_db_connection()     Read-only SQLite with validation
- fetch_artist_stats()    4 SQL queries for aggregates
- format_json/csv()       Output formatting
- write_output()          File writing
- parse_args() / main()   CLI orchestration

Features:
- Case-insensitive artist lookup
- Per-album breakdown with revenue
- All error messages as specified
- --db flag for test injection
Dezvoltare software cu Claude Code

Codul generat

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)
Dezvoltare software cu Claude Code

Testează instrumentul

flowchart: reporter.py, pytest, Verifică rezultatul

  • Testele verifică:
    • Un artist valid returnează date
    • Fișierul de ieșire este creat
    • Formatul JSON/CSV este corect
Dezvoltare software cu Claude Code

Testarea instrumentelor CLI

  • Teste unitare
    • Testează funcții individuale
    • Simulează apelurile către baza de date
    • Rapide, izolate, repetabile
  • Teste de integrare
    • Rulează comanda CLI reală
    • Folosește o bază de date reală
    • Mai lente, dar mai realiste
  • Ce trebuie testat:
    • Scenariul ideal — artist valid, rezultat corect
    • Cazuri de eroare — artist negăsit, format invalid
    • Cazuri limită — nume gol, caractere speciale
    • Gestionarea fișierelor — permisiuni de scriere, suprascriere
Dezvoltare software cu Claude Code

Testarea în practică

> Use @PLAN.md to build test_reporter.py
Created test_reporter.py: 31 tests across 7 classes

Coverage:
- Connection     Valid DB, missing file, invalid file
- Stats          Known/unknown artist, case-insensitive, multi-genre
- JSON           Format, indentation, round-trip serialization
- CSV            Two sections, pipe-delimited genres, row counts
- File I/O       Write, overwrite, unwritable path
- CLI args       Required args, choices validation
- Integration    JSON/CSV output, artist/DB not found, cleanup

Uses minimal seeded SQLite DB: independent of chinook.db

All 31 tests passing!
Dezvoltare software cu Claude Code

Hai să exersăm!

Dezvoltare software cu Claude Code

Preparing Video For Download...