Criar e testar a ferramenta

Desenvolvimento de Software com Claude Code

Dani Zysman

AI Curriculum Manager @ DataCamp

Do plano ao código

recraft: half: Desenvolvedor na mesa codando uma ferramenta de CLI com terminal mostrando saída do argparse

  • Nossa especificação da Lição 4.1:
    • --artist — nome do artista para consultar
    • --format — saída JSON ou CSV
    • --output — caminho do arquivo para resultados
  • Claude vai gerar:
    • parsing de argumentos com argparse
    • Consulta ao banco via MCP
    • Lógica de gravação em arquivo
Desenvolvimento de Software com Claude Code

Padrões de argumentos de CLI

Padrão Exemplo Quando usar
Obrigatório --artist "AC/DC" Deve ser fornecido
Opcional --format json Tem padrão sensato
Flag --verbose Booleano liga/desliga
Posicional reporter.py data.csv Entrada principal
  • Boas práticas:
    • Adicione descrições em --help para todos os argumentos
    • Use padrões para reduzir entradas obrigatórias
    • Valide cedo e falhe rápido com mensagens claras
Desenvolvimento de Software com Claude Code

Construindo o Reporter

> Use @PLAN.md to build reporter.py
Concluído! Created reporter.py following PLAN.md

Funções centrais:
- get_db_connection()     SQLite somente leitura com validação
- fetch_artist_stats()    4 consultas SQL para agregações
- format_json/csv()       Formatação da saída
- write_output()          Gravação em arquivo
- parse_args() / main()   Orquestração da CLI

Recursos:
- Busca de artista sem diferenciar maiúsculas/minúsculas
- Detalhamento por álbum com receita
- Todas as mensagens de erro conforme especificado
- Flag --db para injeção em testes
Desenvolvimento de Software com Claude Code

O código gerado

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)
Desenvolvimento de Software com Claude Code

Testar a ferramenta

fluxograma: reporter.py, pytest, Verificar saída

  • Os testes verificam:
    • Artista válido retorna dados
    • Arquivo de saída é criado
    • Formato JSON/CSV está correto
Desenvolvimento de Software com Claude Code

Testando ferramentas de CLI

  • Testes de unidade
    • Testar funções isoladas
    • Simular chamadas ao banco
    • Rápidos, isolados, repetíveis
  • Testes de integração
    • Executar o comando CLI real
    • Usar banco de dados real
    • Mais lentos, porém realistas
  • O que testar:
    • Caminho feliz — artista válido, saída correta
    • Erros — artista não encontrado, formato inválido
    • Casos limite — nome vazio, caracteres especiais
    • Arquivos — permissões de escrita, sobrescrita
Desenvolvimento de Software com Claude Code

Testes em ação

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

Cobertura:
- Conexão       DB válido, arquivo ausente, arquivo inválido
- Estatísticas  Artista conhecido/desconhecido, case-insensitive, multi-gênero
- JSON          Formato, indentação, serialização ida-e-volta
- CSV           Duas seções, gêneros separados por pipe, contagem de linhas
- E/S de arquivo Escrita, sobrescrita, caminho sem permissão
- Args da CLI   Args obrigatórios, validação de escolhas
- Integração    Saída JSON/CSV, artista/DB não encontrados, limpeza

Usa SQLite mínimo com seed: independente de chinook.db

Todos os 31 testes aprovados!
Desenvolvimento de Software com Claude Code

Vamos praticar!

Desenvolvimento de Software com Claude Code

Preparing Video For Download...