tidyflow 的 CLI 与 Python API 用法

两种入口

CLI 适合直接处理一份 CSV、Excel 或 JSON 文件；Python API 适合把同一套清洗步骤写进脚本、notebook 或后续数据管线。

CLI 用法

清洗文件并生成报告：

tidyflow clean data.csv -o cleaned.csv --report

只检查问题而不修改数据：

tidyflow detect data.csv

查看文件基本信息：

tidyflow info data.csv

Python API

链式 API 按实际执行顺序表达清洗过程：

from tidyflow import Cleaner

result = (
    Cleaner("data.csv")
    .remove_duplicates()
    .fill_missing(strategy="mean")
    .to_snake_case()
    .strip_text()
    .clean()
)

result.save("cleaned.csv")
result.report("report.md")

Cleaner 保存清洗状态和操作链，CleanResult 负责保存、报告和其他结果输出。

使用边界

先诊断，再确认清洗范围。诊断不会改动原始数据；配置文件适合固化经常重复的规则，但不应隐藏一次清洗实际做了什么。

相关内容：CLI 模块边界、tidyflow 项目页。