Tool bauen und testen

Softwareentwicklung mit Claude Code

Dani Zysman

AI Curriculum Manager @ DataCamp

Vom Plan zum Code

recraft: half: Entwickler:in am Schreibtisch, programmiert ein CLI-Tool; Terminal zeigt argparse-Ausgabe

  • Unsere Spezifikation aus Lektion 4.1:
    • --artist — Künstlername für die Abfrage
    • --format — Ausgabe als JSON oder CSV
    • --output — Dateipfad für Ergebnisse
  • Claude generiert:
    • Argument-Parsing mit argparse
    • Datenbankabfrage über MCP
    • Logik für Dateiausgabe
Softwareentwicklung mit Claude Code

CLI-Argumentmuster

Muster Beispiel Einsatz
Erforderlich --artist "AC/DC" Muss angegeben werden
Optional --format json Hat sinnvollen Standardwert
Flag --verbose Boolean an/aus
Positionsbasiert reporter.py data.csv Primäre Eingabe
  • Best Practices:
    • --help-Beschreibungen für jedes Argument
    • Defaults nutzen, um Pflichtangaben zu senken
    • Früh validieren, schnell mit klaren Meldungen abbrechen
Softwareentwicklung mit Claude Code

Den Reporter bauen

> Use @PLAN.md to build reporter.py
Fertig! reporter.py gemäß PLAN.md erstellt

Kernfunktionen:
- get_db_connection()     Read-only-SQLite mit Validierung
- fetch_artist_stats()    4 SQL-Abfragen für Aggregate
- format_json/csv()       Ausgabeformatierung
- write_output()          Dateischreiben
- parse_args() / main()   CLI-Orchestrierung

Funktionen:
- Groß-/Kleinschreibung-unabhängige Künstlersuche
- Aufschlüsselung pro Album mit Umsatz
- Alle Fehlermeldungen wie spezifiziert
- --db-Flag für Test-Injection
Softwareentwicklung mit Claude Code

Der generierte Code

import argparse, sqlite3, json, csv

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

    conn = sqlite3.connect("chinook.db")
    # Alben und Tracks des Künstlers abfragen ...

    if args.format == "json":
        with open(args.output, "w") as f:
            json.dump(data, f, indent=2)
Softwareentwicklung mit Claude Code

Tool testen

Flussdiagramm: reporter.py, pytest, Ausgabe prüfen

  • Tests prüfen:
    • Gültiger Künstler liefert Daten
    • Ausgabedatei wird erstellt
    • JSON/CSV-Format ist korrekt
Softwareentwicklung mit Claude Code

CLI-Tools testen

  • Unit-Tests
    • Einzelne Funktionen testen
    • Datenbankaufrufe mocken
    • Schnell, isoliert, reproduzierbar
  • Integrationstests
    • Tatsächlichen CLI-Befehl ausführen
    • Echte Datenbank verwenden
    • Langsamer, aber realistischer
  • Was testen:
    • Happy Path — gültiger Künstler, korrekte Ausgabe
    • Fehlerfälle — Künstler nicht gefunden, falsches Format
    • Edge Cases — leerer Name, Sonderzeichen
    • Dateihandling — Schreibrechte, Überschreiben
Softwareentwicklung mit Claude Code

Testing in Action

> Use @PLAN.md to build test_reporter.py
test_reporter.py erstellt: 31 Tests in 7 Klassen

Abdeckung:
- Connection     Gültige DB, fehlende Datei, ungültige Datei
- Stats          Bekannter/unbekannter Künstler, Case-insensitive, Multi-Genre
- JSON           Format, Einrückung, Roundtrip-Serialisierung
- CSV            Zwei Abschnitte, pipe-getrennte Genres, Zeilenzahlen
- File I/O       Schreiben, Überschreiben, nicht beschreibbarer Pfad
- CLI-Args       Erforderliche Args, Validierung von Auswahlwerten
- Integration    JSON/CSV-Ausgabe, Künstler/DB nicht gefunden, Cleanup

Verwendet minimale vorbefüllte SQLite-DB: unabhängig von chinook.db

Alle 31 Tests bestanden!
Softwareentwicklung mit Claude Code

Lass uns üben!

Softwareentwicklung mit Claude Code

Preparing Video For Download...