构建并测试工具

使用 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 参数模式

模式 示例 适用场景
必填 --artist "AC/DC" 必须提供
可选 --format json 有合理默认值
标志 --verbose 布尔开关
位置参数 reporter.py data.csv 主要输入
  • 最佳实践:
    • 为每个参数添加 --help 描述
    • 用默认值减少必填输入
    • 及早校验,明确报错并快速失败
使用 Claude Code 进行软件开发

构建 Reporter

> Use @PLAN.md to build reporter.py
完成!已按 PLAN.md 创建 reporter.py

核心函数:
- get_db_connection()     只读 SQLite,带校验
- fetch_artist_stats()    4 条聚合 SQL 查询
- 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 工具

  • 单元测试
    • 测试单个函数
    • Mock 数据库调用
    • 快速、隔离、可复现
  • 集成测试
    • 运行实际 CLI 命令
    • 使用真实数据库
    • 更慢但更真实
  • 测试要点:
    • Happy path——艺人有效,输出正确
    • 错误场景——未找到艺人、格式不合法
    • 边界情况——空名称、特殊字符
    • 文件处理——写入权限、覆盖写入
使用 Claude Code 进行软件开发

测试实战

> Use @PLAN.md to build test_reporter.py
已创建 test_reporter.py:31 项测试,覆盖 7 个类

覆盖范围:
- Connection     有效 DB、缺失文件、非法文件
- Stats          已知/未知艺人、不区分大小写、多流派
- JSON           格式、缩进、序列化往返
- CSV            两个分区、管道分隔的流派、行数
- File I/O       写入、覆盖、不可写路径
- CLI args       必需参数、选项校验
- Integration    JSON/CSV 输出、未找到艺人/DB、清理

使用最小种子 SQLite DB:独立于 chinook.db

31 项测试全部通过!
使用 Claude Code 进行软件开发

让我们一起练习吧!

使用 Claude Code 进行软件开发

Preparing Video For Download...