jcia 0.2.0__tar.gz

jcia-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 JCIA Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

jcia-0.2.0/PKG-INFO

@@ -0,0 +1,281 @@
+Metadata-Version: 2.4
+Name: jcia
+Version: 0.2.0
+Summary: Java Code Impact Analyzer - 代码变更影响分析工具
+Author: JCIA Team
+License: MIT
+Project-URL: Homepage, https://github.com/boyingliu01/jcia
+Project-URL: Documentation, https://github.com/boyingliu01/jcia#readme
+Project-URL: Repository, https://github.com/boyingliu01/jcia
+Project-URL: Issues, https://github.com/boyingliu01/jcia/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0.0
+Requires-Dist: pydriller>=2.6.0
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: jinja2>=3.1.2
+Requires-Dist: requests>=2.31.0
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: defusedxml>=0.7.1
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.12.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: ruff==0.15.5; extra == "dev"
+Requires-Dist: import-linter>=2.0; extra == "dev"
+Requires-Dist: pyright>=1.1.340; extra == "dev"
+Requires-Dist: bandit[toml]>=1.7.6; extra == "dev"
+Requires-Dist: pre-commit>=3.6.0; extra == "dev"
+Requires-Dist: mypy>=1.7.0; extra == "dev"
+Provides-Extra: ai
+Requires-Dist: openai>=1.0.0; extra == "ai"
+Dynamic: license-file
+
+# JCIA - Java Code Impact Analyzer
+
+[![Python Version](https://img.shields.io/badge/python-3.10%2B-blue.svg)]
+[![License](https://img.shields.io/badge/license-MIT-green.svg)]
+[![Code Coverage](https://img.shields.io/badge/coverage-93%25-brightgreen.svg)]
+
+**JCIA** 是一个 Python 工具，用于分析 Java 代码变更的影响范围，智能选择需要运行的测试用例，并提供回归分析能力。
+
+## 特性
+
+- 🔍 **变更代码影响分析** - 自动分析 Git 提交，识别变更的文件和方法
+- 📊 **影响图构建** - 构建调用链图，计算受影响的类和方法
+- 🌐 **跨服务远程调用检测** - 识别 Dubbo/Feign/HTTP/MQ 远程调用并融合进影响图，评估跨服务变更风险（`--detect-remote-calls`）
+- 🎯 **智能测试选择** - 基于 STARTS 算法和影响范围选择测试用例
+- 🤖 **AI 测试生成** - 集成 LLM 服务，自动生成测试用例建议
+- 📈 **多格式报告** - 支持 HTML、JSON、Markdown 格式报告
+- 🔄 **回归分析** - 对比基线测试和回归测试结果，识别回归问题
+
+## 快速开始
+
+### 安装
+
+```bash
+# 克隆仓库
+git clone https://github.com/boyingliu01/jcia.git
+cd jcia
+
+# 创建虚拟环境
+python -m venv .venv
+.venv\Scripts\Activate.ps1  # Windows PowerShell
+
+# 安装依赖
+pip install -e ".[dev]"
+```
+
+### 配置
+
+创建配置文件 `jcia.yaml`（可选）：
+
+```yaml
+repository:
+  path: /path/to/your/java/project
+
+analyzer:
+  max_depth: 10
+  include_test_files: false
+
+report:
+  format: html
+  output_dir: ./reports
+
+ai:
+  provider: volcengine
+  model: gpt-4
+```
+
+### 使用
+
+```bash
+# 分析变更影响
+jcia analyze --repo-path /path/to/repo --from-commit abc123 --to-commit def456
+
+# 分析变更影响并检测跨服务远程调用（Dubbo/Feign/HTTP/MQ）
+jcia analyze --repo-path /path/to/repo --commit-range abc123..def456 --detect-remote-calls
+
+# 生成测试用例
+jcia test --repo-path /path/to/project --target-class com.example.Service
+
+# 生成报告
+jcia report --output-dir ./reports --format html
+
+# 配置管理
+jcia config --show
+jcia config --set analyzer.max_depth=15
+```
+
+## 核心概念
+
+### 变更分析
+
+JCIA 使用 PyDriller 解析 Git 仓库，识别：
+
+- 文件级变更（新增、修改、删除、重命名）
+- 方法级变更（方法签名变更）
+- 提交信息（作者、时间、消息）
+
+### 影响图
+
+影响图展示代码变更的传播路径：
+
+- **直接影响** - 直接调用变更方法的代码
+- **间接影响** - 通过调用链间接影响的代码
+- **严重程度** - HIGH/MEDIUM/LOW
+- **影响深度** - 变更传播的最大深度
+
+### 测试选择
+
+JCIA 支持多种测试选择策略：
+
+- **ALL** - 运行所有测试
+- **STARTS** - 使用 STARTS 算法选择
+- **IMPACT_BASED** - 基于影响范围选择
+- **HYBRID** - 混合策略
+
+## 架构
+
+JCIA 采用**清洁架构**（Clean Architecture）：
+
+```
+Adapters Layer (Git, Maven, AI, Database)
+    ↓
+Infrastructure Layer (Repositories, Config, Logging)
+    ↓
+Use Cases Layer (Business Orchestration)
+    ↓
+Services Layer (Domain Logic)
+    ↓
+Entities Layer (Domain Models)
+```
+
+### 依赖规则
+
+- 外部依赖（Git、Maven、AI）在适配器层
+- 业务逻辑在核心层
+- 核心层不依赖适配器层
+- 通过接口（ABC）解耦
+
+## 开发
+
+### 设置开发环境
+
+```bash
+# 安装开发依赖
+pip install -e ".[dev]"
+
+# 配置 pre-commit hooks
+make setup-hooks
+```
+
+### 运行测试
+
+```bash
+# 运行所有测试
+make test
+
+# 运行单元测试
+pytest tests/unit -v
+
+# 运行集成测试
+pytest tests/integration -v
+
+# 运行带覆盖率的测试
+pytest tests/unit --cov=jcia --cov-report=html
+```
+
+### 代码质量
+
+```bash
+# Lint 检查
+make lint
+
+# 格式化代码
+make format
+
+# 类型检查
+pyright jcia tests
+
+# 安全扫描
+make security
+
+# 完整检查
+make check
+```
+
+## 配置选项
+
+### CLI 选项
+
+| 命令 | 选项 | 说明 |
+|-------|------|------|
+| `analyze` | `--repo-path` | Git 仓库路径 |
+| | `--from-commit` | 起始提交哈希 |
+| | `--to-commit` | 结束提交哈希 |
+| | `--commit-range` | 提交范围（如 abc123..def456）|
+| | `--max-depth` | 最大追溯深度 |
+| `test` | `--repo-path` | 项目路径 |
+| | `--target-class` | 目标类（可多次使用）|
+| | `--coverage-file` | 覆盖率报告文件 |
+| | `--min-confidence` | 最低置信度阈值 |
+| `report` | `--output-dir` | 报告输出目录（必填）|
+| | `--format` | 报告格式（json/html/markdown/console，默认 json）|
+| | `--include-details` | 包含详细信息 |
+| `config` | `--show` | 显示当前配置项 |
+| | `--set` | 设置配置项（如 analyzer.max_depth=15）|
+
+### 环境变量
+
+| 变量 | 说明 |
+|-------|------|
+| `VOLCENGINE_ACCESS_KEY` | Volcengine 访问密钥 |
+| `VOLCENGINE_SECRET_KEY` | Volcengine 密钥 |
+| `VOLCENGINE_APP_ID` | Volcengine 应用 ID |
+
+## 性能
+
+- 单次提交分析：< 10 秒
+- 影响图构建：< 5 秒
+- 测试选择：< 3 秒
+- 支持 1000+ 测试用例
+- 选择性测试加速：≥ 50%
+
+## 许可证
+
+[MIT License](LICENSE)
+
+## 贡献
+
+欢迎贡献！请查看 [CONTRIBUTING.md](CONTRIBUTING.md) 了解详细信息。
+
+## 支持
+
+- 🐛 Issues: [GitHub Issues](https://github.com/boyingliu01/jcia/issues)
+- 📖 Docs: [项目文档](https://github.com/boyingliu01/jcia#readme)
+
+## 更新日志
+
+查看 [CHANGELOG.md](CHANGELOG.md) 了解版本历史。
+
+## 致谢
+
+感谢所有贡献者和开源项目的支持：
+
+- [PyDriller](https://github.com/ishepard/pydriller) - Git 仓库分析
+- [Click](https://click.palletsprojects.com/) - 命令行界面
+- [Pytest](https://docs.pytest.org/) - 测试框架

jcia-0.2.0/README.md

@@ -0,0 +1,235 @@
+# JCIA - Java Code Impact Analyzer
+
+[![Python Version](https://img.shields.io/badge/python-3.10%2B-blue.svg)]
+[![License](https://img.shields.io/badge/license-MIT-green.svg)]
+[![Code Coverage](https://img.shields.io/badge/coverage-93%25-brightgreen.svg)]
+
+**JCIA** 是一个 Python 工具，用于分析 Java 代码变更的影响范围，智能选择需要运行的测试用例，并提供回归分析能力。
+
+## 特性
+
+- 🔍 **变更代码影响分析** - 自动分析 Git 提交，识别变更的文件和方法
+- 📊 **影响图构建** - 构建调用链图，计算受影响的类和方法
+- 🌐 **跨服务远程调用检测** - 识别 Dubbo/Feign/HTTP/MQ 远程调用并融合进影响图，评估跨服务变更风险（`--detect-remote-calls`）
+- 🎯 **智能测试选择** - 基于 STARTS 算法和影响范围选择测试用例
+- 🤖 **AI 测试生成** - 集成 LLM 服务，自动生成测试用例建议
+- 📈 **多格式报告** - 支持 HTML、JSON、Markdown 格式报告
+- 🔄 **回归分析** - 对比基线测试和回归测试结果，识别回归问题
+
+## 快速开始
+
+### 安装
+
+```bash
+# 克隆仓库
+git clone https://github.com/boyingliu01/jcia.git
+cd jcia
+
+# 创建虚拟环境
+python -m venv .venv
+.venv\Scripts\Activate.ps1  # Windows PowerShell
+
+# 安装依赖
+pip install -e ".[dev]"
+```
+
+### 配置
+
+创建配置文件 `jcia.yaml`（可选）：
+
+```yaml
+repository:
+  path: /path/to/your/java/project
+
+analyzer:
+  max_depth: 10
+  include_test_files: false
+
+report:
+  format: html
+  output_dir: ./reports
+
+ai:
+  provider: volcengine
+  model: gpt-4
+```
+
+### 使用
+
+```bash
+# 分析变更影响
+jcia analyze --repo-path /path/to/repo --from-commit abc123 --to-commit def456
+
+# 分析变更影响并检测跨服务远程调用（Dubbo/Feign/HTTP/MQ）
+jcia analyze --repo-path /path/to/repo --commit-range abc123..def456 --detect-remote-calls
+
+# 生成测试用例
+jcia test --repo-path /path/to/project --target-class com.example.Service
+
+# 生成报告
+jcia report --output-dir ./reports --format html
+
+# 配置管理
+jcia config --show
+jcia config --set analyzer.max_depth=15
+```
+
+## 核心概念
+
+### 变更分析
+
+JCIA 使用 PyDriller 解析 Git 仓库，识别：
+
+- 文件级变更（新增、修改、删除、重命名）
+- 方法级变更（方法签名变更）
+- 提交信息（作者、时间、消息）
+
+### 影响图
+
+影响图展示代码变更的传播路径：
+
+- **直接影响** - 直接调用变更方法的代码
+- **间接影响** - 通过调用链间接影响的代码
+- **严重程度** - HIGH/MEDIUM/LOW
+- **影响深度** - 变更传播的最大深度
+
+### 测试选择
+
+JCIA 支持多种测试选择策略：
+
+- **ALL** - 运行所有测试
+- **STARTS** - 使用 STARTS 算法选择
+- **IMPACT_BASED** - 基于影响范围选择
+- **HYBRID** - 混合策略
+
+## 架构
+
+JCIA 采用**清洁架构**（Clean Architecture）：
+
+```
+Adapters Layer (Git, Maven, AI, Database)
+    ↓
+Infrastructure Layer (Repositories, Config, Logging)
+    ↓
+Use Cases Layer (Business Orchestration)
+    ↓
+Services Layer (Domain Logic)
+    ↓
+Entities Layer (Domain Models)
+```
+
+### 依赖规则
+
+- 外部依赖（Git、Maven、AI）在适配器层
+- 业务逻辑在核心层
+- 核心层不依赖适配器层
+- 通过接口（ABC）解耦
+
+## 开发
+
+### 设置开发环境
+
+```bash
+# 安装开发依赖
+pip install -e ".[dev]"
+
+# 配置 pre-commit hooks
+make setup-hooks
+```
+
+### 运行测试
+
+```bash
+# 运行所有测试
+make test
+
+# 运行单元测试
+pytest tests/unit -v
+
+# 运行集成测试
+pytest tests/integration -v
+
+# 运行带覆盖率的测试
+pytest tests/unit --cov=jcia --cov-report=html
+```
+
+### 代码质量
+
+```bash
+# Lint 检查
+make lint
+
+# 格式化代码
+make format
+
+# 类型检查
+pyright jcia tests
+
+# 安全扫描
+make security
+
+# 完整检查
+make check
+```
+
+## 配置选项
+
+### CLI 选项
+
+| 命令 | 选项 | 说明 |
+|-------|------|------|
+| `analyze` | `--repo-path` | Git 仓库路径 |
+| | `--from-commit` | 起始提交哈希 |
+| | `--to-commit` | 结束提交哈希 |
+| | `--commit-range` | 提交范围（如 abc123..def456）|
+| | `--max-depth` | 最大追溯深度 |
+| `test` | `--repo-path` | 项目路径 |
+| | `--target-class` | 目标类（可多次使用）|
+| | `--coverage-file` | 覆盖率报告文件 |
+| | `--min-confidence` | 最低置信度阈值 |
+| `report` | `--output-dir` | 报告输出目录（必填）|
+| | `--format` | 报告格式（json/html/markdown/console，默认 json）|
+| | `--include-details` | 包含详细信息 |
+| `config` | `--show` | 显示当前配置项 |
+| | `--set` | 设置配置项（如 analyzer.max_depth=15）|
+
+### 环境变量
+
+| 变量 | 说明 |
+|-------|------|
+| `VOLCENGINE_ACCESS_KEY` | Volcengine 访问密钥 |
+| `VOLCENGINE_SECRET_KEY` | Volcengine 密钥 |
+| `VOLCENGINE_APP_ID` | Volcengine 应用 ID |
+
+## 性能
+
+- 单次提交分析：< 10 秒
+- 影响图构建：< 5 秒
+- 测试选择：< 3 秒
+- 支持 1000+ 测试用例
+- 选择性测试加速：≥ 50%
+
+## 许可证
+
+[MIT License](LICENSE)
+
+## 贡献
+
+欢迎贡献！请查看 [CONTRIBUTING.md](CONTRIBUTING.md) 了解详细信息。
+
+## 支持
+
+- 🐛 Issues: [GitHub Issues](https://github.com/boyingliu01/jcia/issues)
+- 📖 Docs: [项目文档](https://github.com/boyingliu01/jcia#readme)
+
+## 更新日志
+
+查看 [CHANGELOG.md](CHANGELOG.md) 了解版本历史。
+
+## 致谢
+
+感谢所有贡献者和开源项目的支持：
+
+- [PyDriller](https://github.com/ishepard/pydriller) - Git 仓库分析
+- [Click](https://click.palletsprojects.com/) - 命令行界面
+- [Pytest](https://docs.pytest.org/) - 测试框架

jcia-0.2.0/jcia/__init__.py

@@ -0,0 +1,13 @@
+"""JCIA - Java Code Impact Analyzer.
+
+代码变更影响分析工具，支持Maven项目的一键式代码变更影响分析、测试生成与回归验证。
+"""
+
+__version__ = "0.2.0"
+__author__ = "JCIA Team"
+
+from jcia.core.entities.change_set import ChangeSet
+from jcia.core.entities.impact_graph import ImpactGraph
+from jcia.core.entities.test_case import TestCase
+
+__all__ = ["ChangeSet", "ImpactGraph", "TestCase"]

jcia-0.2.0/jcia/adapters/__init__.py

@@ -0,0 +1 @@
+"""外部适配器层."""

jcia-0.2.0/jcia/adapters/ai/__init__.py

@@ -0,0 +1,7 @@
+"""AI 服务适配器."""
+
+from jcia.adapters.ai.openai_adapter import OpenAIAdapter
+from jcia.adapters.ai.skywalking_adapter import SkyWalkingAdapter
+from jcia.adapters.ai.volcengine_adapter import VolcengineAdapter
+
+__all__ = ["OpenAIAdapter", "SkyWalkingAdapter", "VolcengineAdapter"]

jcia-0.2.0/jcia/adapters/ai/llm_adapter.py

@@ -0,0 +1,37 @@
+"""LLM 适配器工厂.
+
+提供对不同 AI 服务提供商的统一访问。
+"""
+
+from typing import Any
+
+from jcia.adapters.ai.volcengine_adapter import VolcengineAdapter
+from jcia.core.interfaces.ai_service import AIAnalyzer, AIProvider, AITestGenerator
+
+
+class LLMAdapterFactory:
+    """LLM 适配器工厂类."""
+
+    @staticmethod
+    def create_adapter(
+        provider: AIProvider | str,
+        **kwargs: Any,
+    ) -> AITestGenerator | AIAnalyzer:
+        """根据提供商创建对应的适配器实例.
+
+        Args:
+            provider: AI 服务提供商
+            **kwargs: 适配器初始化参数
+
+        Returns:
+            AITestGenerator | AIAnalyzer: 适配器实例
+
+        Raises:
+            ValueError: 不支持的提供商
+        """
+        provider_val = provider.value if isinstance(provider, AIProvider) else str(provider).lower()
+
+        if provider_val == AIProvider.VOLCENGINE.value:
+            return VolcengineAdapter(**kwargs)
+
+        raise ValueError(f"Unsupported AI provider: {provider_val}")