Blazingly fast cognitive complexity analysis for Python, written in Rust.

Installation •Quick Start •Integrations •Documentation

What is Cognitive Complexity?

Installation

pip install complexipy# oruv add complexipy

Quick Start

Command Line

# Analyze current directorycomplexipy.# Analyze specific file/directorycomplexipy path/to/code.py# Analyze with custom thresholdcomplexipy. --max-complexity-allowed 10# Save results to JSON/CSVcomplexipy. --output-json --output-csv# Analyze current directory while excluding specific filescomplexipy. --exclude path/to/exclude.py --exclude path/to/other/exclude.py

Python API

fromcomplexipyimportfile_complexity,code_complexity# Analyze a fileresult=file_complexity("app.py")print(f"File complexity:{result.complexity}")forfuncinresult.functions:print(f"{func.name}:{func.complexity}")# Analyze code stringsnippet="""def complex_function(data):    if data:        for item in data:            if item.is_valid():                process(item)"""result=code_complexity(snippet)print(f"Complexity:{result.complexity}")

Integrations

Configuration

TOML Configuration Files

Example Configuration

# complexipy.toml or .complexipy.tomlpaths = ["src","tests"]max-complexity-allowed =10quiet =falseignore-complexity =falsedetails ="normal"color ="auto"sort ="asc"exclude = [][output]csv =truejson =true

# pyproject.toml[tool.complexipy]paths = ["src","tests"]max-complexity-allowed =10quiet =falseignore-complexity =falsedetails ="normal"color ="auto"sort ="asc"exclude = [][tool.complexipy.output]csv =truejson =true

CLI Options

# Exclude only top-level 'tests' directory under the provided rootcomplexipy . --exclude tests# This will not exclude './complexipy/utils.py' if you pass '--exclude utils' at repo root,# because there is no './utils' directory or file at that level.

Inline Ignores

deflegacy_adapter(x,y):# noqa: complexipy (safe wrapper)ifxandy:returnx+yreturn0

API Reference

# Core functionsfile_complexity(path:str)->FileComplexitycode_complexity(source:str)->CodeComplexity# Return typesFileComplexity:  ├─path:str  ├─complexity:int    └─functions:List[FunctionComplexity]FunctionComplexity:  ├─name:str  ├─complexity:int  ├─line_start:int  └─line_end:int

_{Inspired by theCognitive Complexity research by SonarSource, G. Ann Campbell}

Documentation •PyPI •GitHub

_{Built with ❤️ by@rohaquinlop andcontributors}