jcci：Java代码提交影响分析工具

项目介绍

jcci 是一个纯 Python 库，专注于Java代码提交影响分析。它能够分析Java项目两次git提交之间的差异，并确定这些差异对项目的影响范围。通过生成树形图数据，jcci 可以直观地展示代码改动的影响链路，帮助开发者快速理解代码变更对整个项目的影响。

项目技术分析

jcci 的核心是基于代码语法分析和git差异解析技术。以下是该项目的技术构成：

• javalang: 用于Java文件语法解析的库，可以获取Java文件的import、class、extends、implements、declarators、methods等信息。
• unidiff: 用于解析git diff信息，包括diff file、added_line_num、removed_line_num等。
• 本地环境执行: 确保代码分析的安全性，所有操作都在本地环境执行，没有代码收集和日志上报。

项目及应用场景

jcci 的应用场景主要集中在以下几个方面：

1. 代码改动影响分析: 当一个Java项目发生改动时，jcci 可以分析这些改动对项目其他部分的影响，帮助开发者快速定位潜在的问题区域。
2. 代码审查: 在代码审查过程中，使用jcci可以直观地展示代码变更的影响范围，提高审查效率。
3. 项目重构: 在进行项目重构时，jcci 可以帮助开发者理解代码变更对整个项目结构的影响，从而做出更合理的重构决策。
4. 问题追踪: 当项目出现问题时，jcci 可以帮助追踪问题的根源，找到导致问题的代码改动。

项目特点

jcci 的特点如下：

1. 安全性: 所有分析都在本地环境执行，确保用户代码和数据的安全。
2. 直观展示: 通过树形图数据，直观展示代码变更的影响链路。
3. 多场景适用: 适用于代码改动分析、代码审查、项目重构等多种场景。
4. 简单易用: 提供了清晰的安装教程和使用说明，使得开发者可以快速上手。
5. 广泛支持: 支持Python 3.9及以上版本，以及sqlite3 3.38及以上版本。

以下是jcci的使用示例：

from path.to.jcci.src.jcci.analyze import JCCI

# 同一分支不同commit分析
commit_analyze = JCCI('[e-mail]', 'username1')
commit_analyze.analyze_two_commit('master', 'commit_id1', 'commit_id2')

# 分析一个类的方法影响
class_analyze = JCCI('[e-mail]', 'username1')
class_analyze.analyze_class_method('master', 'commit_id1', 'package/src/main/java/ClassA.java', '20,81')

# 不同分支分析
branch_analyze = JCCI('[e-mail]', 'username1')
branch_analyze.analyze_two_branch('branch_new', 'branch_old')

jcci 通过这些功能为Java项目的代码管理和维护提供了强大的支持，使得开发者能够更加高效地管理代码变更。

总结来说，jcci 是一个功能强大的Java代码提交影响分析工具，它通过直观的树形图展示了代码变更的影响链路，适用于多种开发场景，是Java项目开发者的得力助手。