Skip to main content

codequality

Lightweight, fast code quality analyzer for Python projects. No AI, no API costs.

A simple CLI tool that detects common code smells in your Python codebase. Designed to be a lightweight alternative to heavyweight solutions like SonarQube.

Why codequality?

  • ✅ No API costs - Pure static analysis, runs entirely on your machine
  • ✅ Fast - Analyzes thousands of files in seconds
  • ✅ No setup - Just pipx install codequality and run
  • ✅ Human-readable output - Markdown reports that your team will actually read
  • ✅ Open source - MIT license, code on GitHub

Installation

pipx install codequality

Or with pip:

pip install --user codequality

Usage

# Analyze current directory
codequality

# Analyze specific path
codequality analyze ./my-project

# Output as JSON
codequality analyze ./my-project --format json

# Output to file
codequality analyze ./my-project --output report.md

# Check only specific rules
codequality analyze ./my-project --only function-length,complexity

# CI-friendly output (exit non-zero on issues)
codequality analyze ./my-project --strict

What does it detect?

Rule Description Severity
function-length Functions longer than 50 lines Warning
file-length Files longer than 500 lines Warning
function-params Functions with more than 5 parameters Info
complexity Cyclomatic complexity > 10 Warning
nested-depth Nesting deeper than 4 levels Warning
returns Functions with more than 5 return statements Info

Pricing

Tier Price Features
Free $0/mes 1 repo, basic rules, markdown output
Pro $7/mes Unlimited repos, JSON output, CI integration, custom rules, dashboards
Team $25/mes Multi-repo dashboards, team analytics, priority support

License

MIT

Metadata

Release files for codequality-cli 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for codequality-cli 0.1.0
File Size Uploaded
codequality_cli-0.1.0.tar.gz 11.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for codequality-cli 0.1.0
File Interpreter ABI Platform
codequality_cli-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 21.7 kB

Release files / codequality_cli-0.1.0.tar.gz

Download URL codequality_cli-0.1.0.tar.gz
Size 11.5 kB
Tags Source
SHA-256 checksum
How to use checksums
18464c970941b5aa83669172625ac12dd7f9a0f809425463a0c1eb3dd71cea13
BLAKE2b-256 checksum
How to use checksums
a369e1cb0eea1ed9240b6e968e4367b515986aaaeaab9fc652f69c030cb814c5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release files / codequality_cli-0.1.0-py3-none-any.whl

Download URL codequality_cli-0.1.0-py3-none-any.whl
Size 10.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1fb66b8bb71db8cc1fd29f28aa7081e79ff0c5429c703e539881816e60b9386f
BLAKE2b-256 checksum
How to use checksums
b45b81ae20a017036865539c26808e0706bf8a28fad6f95c13e218ceecafa876
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page