feat: code complexity analyzer toolkit

[Johnnyevans32]

Code Complexity Analyzer Toolkit for Goose

Resolves #62

Overview

The Code Complexity Analyzer Toolkit automates the analysis of Python codebases, evaluating key complexity metrics to assess code quality and maintainability.

Features

• Analyzes Python files in a given directory for:
  • Cyclomatic Complexity: Measures independent code paths.
  • Halstead Complexity: Quantifies complexity using operators and operands.
  • Maintainability Index: Estimates the codebase's ease of maintenance.
• Aggregates results for a comprehensive overview.

Usage

1. Add the toolkit to your profiles.yaml:

my-profile:
  provider: openai
  processor: gpt-4o
  accelerator: gpt-4o-mini
  moderator: passive
  toolkits:
    - developer
    - complexity_analyzer

2. Run Goose with the profile:

goose session start --profile my-profile

3. Use the toolkit:

analyze complexity "<directory_path>"

Output

The toolkit returns a dictionary with the following keys:

• avg_cyclomatic_complexity: Average cyclomatic complexity across all files.
• avg_halstead_complexity: Average Halstead complexity.
• avg_maintainability_index: Average maintainability index.
• errors: Any errors encountered during analysis.

Example:

{
    "avg_cyclomatic_complexity": 5.2,
    "avg_halstead_complexity": 140.1,
    "avg_maintainability_index": 68.5,
    "errors": []
}

Testing

Run tests using unittest:

 uv run pytest tests -m "not integration" 

🛠️ Adding to goose-plugins

pyproject.toml

[project.entry-points."goose.toolkit"]
complexity_analyzer = "goose.toolkit.complexity_analyzer:CodeComplexityToolkit"