Tach项目依赖报告功能升级：统一内外依赖分析接口

在Python项目开发中，依赖管理是一个关键环节，特别是当项目包含多个内部包和外部依赖时。Tach作为一款依赖分析工具，近期对其报告功能进行了重要升级，简化了依赖分析的工作流程。

功能背景

许多Python项目采用类似monorepo的结构组织代码，其中包含多个内部包（如common目录下的各个子包）。这些内部包通常通过工具（如uv）进行管理，每个包都有自己的pyproject.toml文件声明依赖关系。开发者需要经常检查这些依赖关系，包括：

1. 获取所有依赖（内部和外部）
2. 验证依赖声明是否与实际使用一致
3. 防止未声明的依赖被引入项目

原有功能痛点

Tach原本提供两个独立的命令来处理依赖分析：

• report命令：分析内部模块依赖
• report-external命令：分析外部依赖

这种分离的设计导致开发者需要分别运行两个命令并手动合并结果，效率较低且容易出错。特别是在需要同时分析内外依赖时，工作流程不够流畅。

功能升级

最新版本（0.16.0）对报告功能进行了统一和增强：

1. 统一接口：现在可以通过单个report命令获取完整的依赖信息
2. 灵活选项：新增--dependencies和--external参数控制输出内容
3. 清晰格式：使用注释分隔内部和外部依赖，便于解析

典型使用示例：

tach report common/api-models --dependencies --external --raw

输出格式：

# Module Dependencies
blueprinter
database
mapbox
respawned_models
utils
# External Dependencies
pydantic

实际应用场景

这一改进特别适合以下场景：

1. 依赖审计：快速检查项目中使用的所有依赖项
2. CI/CD集成：在构建流程中验证依赖声明
3. 开发辅助：新成员快速了解项目依赖结构
4. 代码质量检查：确保没有未声明的依赖被引入

技术实现要点

为了实现这一改进，Tach项目：

1. 重构了依赖分析的核心逻辑
2. 统一了内部和外部依赖的报告流程
3. 保持了与现有配置的兼容性
4. 优化了输出格式的可读性和可解析性

最佳实践建议

1. 在项目根目录的tach.toml中配置source_roots指向内部包目录
2. 结合pre-commit等工具自动化依赖检查
3. 定期运行依赖报告以保持依赖关系的清晰和准确
4. 对于大型项目，考虑将报告输出集成到文档系统中

这一改进显著提升了Tach在复杂项目中的实用性，使依赖管理变得更加高效和可靠。