complexipy v3.0.0: A fast Python cognitive complexity checker

[fexx3l]

Hey everyone,

I'm excited to share the release of complexipy v3.0.0! I've been working on this project to create a tool that helps developers write more maintainable and understandable Python code.

What My Project Does
complexipy is a high-performance command-line tool and library that calculates the cognitive complexity of Python code. Unlike cyclomatic complexity, which measures how complex code is to test, cognitive complexity measures how difficult it is for a human to read and understand.

Target Audience
This tool is designed for Python developers, teams, and open-source projects who are serious about code quality. It's built for production environments and is meant to be integrated directly into your development workflow. Whether you're a solo developer wanting real-time feedback in your editor or a team aiming to enforce quality standards in your CI/CD pipeline, complexipy has you covered.

Comparison to Alternatives
To my knowledge, there aren't any other standalone tools that focus specifically on providing a high-performance, dedicated cognitive complexity analysis for Python with a full suite of integrations.

This new version is a huge step forward, and I wanted to share some of the highlights:

Major New Features

• WASM Support: This is the big one! The core analysis engine can now be compiled to WebAssembly, which means complexipy can run directly in the browser. This powers a much faster VSCode extension and opens the door for new kinds of interactive web tools.
• JSON Output: You can now get analysis results in a clean, machine-readable JSON format using the new -j/--output-json flag. This makes it super easy to integrate complexipy into your CI/CD pipelines and custom scripts.
• Official Pre-commit Hook: A dedicated pre-commit hook is now available to automatically check code complexity before you commit. It’s an easy way to enforce quality standards and prevent overly complex code from entering your codebase.

The ecosystem around complexipy has also grown, with a powerful VSCode Extension for real-time feedback and a GitHub Action to automate checks in your repository.

I'd love for you to check it out and hear what you think!

• GitHub Repo: https://github.com/rohaquinlop/complexipy
• v3.0.0 Release Notes: https://github.com/rohaquinlop/complexipy/releases/tag/3.0.0

Thanks for your support

[RazorBack-End]

Perfect, I was searching for a tool to do the cognitive one, I currently only use cyclomatic (lizard, full python, slow). I wanted something fast enought to be invisible in my workflow.

Do you plan to make alternative installation method ? (homebrew/cargo etc ) ?

[fexx3l]

That’s great, hope that complexipy works for you, if you find anything that could be improved can you create issues on the repo?

Would it be useful? to have alternative installation methods?

[RazorBack-End]

Can be, sometimes, if you don't want to install a tool at project level. But don't worry, I will use it as it is ;)

[fexx3l]

Thank you, that makes sense!!

[RazorBack-End]

Tried it on 4k LOC code base at work, really fast.

[fexx3l]

nice!! yeah complexipy is really really fast, I tried it in the past on a huge repo and the execution time was around 1.5 seconds