ComplexityRipper 1.0.0

ComplexityRipper

A Roslyn-based code complexity analyzer that scans C# repositories for long functions, high cyclomatic complexity, and deep nesting. Generates self-contained HTML reports with hyperlinks to source files in Azure DevOps and GitHub.

Installation

dotnet tool install -g ComplexityRipper

Quick Start

Scan a directory of repos and generate an HTML report with default thresholds (200 lines, 25 complexity):

complexityripper run --root C:\src\my-repos

This produces two files: stats.json (raw metrics) and code-complexity-report.html (the report).

Usage Examples

Scan a single repo

--root can point to a single git repo or a directory containing multiple repos. ComplexityRipper auto-detects which case it is by checking for a .git directory.

complexityripper run --root C:\src\MyProject

Scan multiple repos

complexityripper run --root C:\src\all-repos

Custom output paths

complexityripper run --root C:\src\my-repos --output my-report.html --stats my-stats.json

Custom thresholds

Flag functions with 300+ lines or cyclomatic complexity of 20+:

complexityripper run --root C:\src\my-repos --threshold-lines 300 --threshold-complexity 20

Include/exclude repos

complexityripper run --root C:\src\my-repos --include "ProjectA|ProjectB"
complexityripper run --root C:\src\my-repos --exclude "Tests|Legacy"

Two-step workflow: analyze once, adjust thresholds later

Generate the JSON once (the slow part), then re-generate the HTML report with different thresholds without re-scanning:

complexityripper analyze --root C:\src\my-repos --output stats.json

complexityripper report --input stats.json --threshold-lines 100 --output strict-report.html
complexityripper report --input stats.json --threshold-lines 500 --output lenient-report.html

Analyze only (JSON output)

complexityripper analyze --root C:\src\my-repos --output stats.json

Generate report from existing JSON

complexityripper report --input stats.json --output report.html --threshold-lines 200 --threshold-complexity 25

Commands

Options

run

analyze

report

How It Works

C# Analysis (Roslyn)

For C# files, ComplexityRipper uses the Roslyn compiler APIs (Microsoft.CodeAnalysis.CSharp) for accurate syntax tree parsing. It finds all methods, constructors, property accessors, and local functions, then computes:

Line count -- total lines of the function body. Cyclomatic complexity -- decision points (see table below). Parameter count -- number of parameters. Max nesting depth -- deepest nesting of control flow blocks.

Hyperlinks

The HTML report generates clickable hyperlinks for every repo, file, class, and function. Remote URLs are parsed from git remote -v and support Azure DevOps (dev.azure.com and legacy visualstudio.com) and GitHub remotes.

HTML Report

The generated report is a self-contained HTML file (inline CSS + JS, no external dependencies) that includes:

Summary table -- total repos, files, functions, and flagged counts as a plain numbers breakdown. Repository ranking -- all repos ranked by a weighted concern score (worst first), sortable and filterable. Per-repository details -- for each repo with flagged functions: distribution bar charts for function length and complexity, followed by combined risk, long functions, and high complexity tables. All tables are sortable and filterable.

Metrics

Cyclomatic Complexity

Each of the following adds 1 to the complexity score (starting from a base of 1):

License

MIT