PragyaLint

Static dead-code analysis for Python that gets rid of the code, too.

PragyaLint builds a module graph from your entry points, traces what is actually reachable, and reports — then removes — unused files, exports, functions, imports, and circular imports. Pure Python. Zero dependencies. One command.

Why PragyaLint?

• Reachability, not regex. A real module graph from your entry points decides what is dead — the way a human would.
• Finds more than imports. Unreachable modules, unused exports, dead functions/classes, unused imports, and circular imports.
• Confidence-graded. Every finding is rated high / medium / low so you know what to trust and what to double-check.
• Fixes what it finds. --fix actually removes dead code, gated by confidence, with a --dry-run preview. Always commit first.
• Zero runtime deps. Only the standard library (ast). No parser to install, nothing to break.
• Native binaries. Windows EXE, Linux, and macOS executables on every release — no Python required at runtime.

What it catches

Demo

$ pragyalint

src/service.py
  :12       ⚠  [MEDIUM] export 'format_report' of module 'src.service' is never imported
  :31       ✖  [HIGH  ] import 'os' is never used

src/legacy/api.py
           ✖  [HIGH  ] module 'src.legacy.api' is not reachable from any entry point

11 findings in 24 files (20 reachable).
  6 high | 3 medium | 2 low

pragyalint analyzes the current directory by default. That's it.

Installation

pip install pragyalint     # or: pipx install pragyalint

Requires Python 3.11+. On Windows use py -m pragyalint to run it as a module.

No Python / no hassle? Grab a prebuilt executable from the Releases page — Windows, Linux, and macOS binaries are built and attached automatically on every release: commit.

Visual Studio Code extension

Find and fix dead code without leaving the editor — findings land in the Problems panel, colored by confidence, plus commands to preview and apply fixes.

code --install-extension IndianCoder3.sks-pragyalint

It shells out to the pragyalint CLI; set pragyalint.binaryPath if it can't find the binary.

In your CI

Gate your pipeline on dead code:

- uses: actions/checkout@v4
- run: pip install pragyalint
- run: pragyalint --fail-on high --sarif > sarif.json

--fail-on high exits non-zero when any high-confidence finding exists. --sarif (or --json) feeds GitHub code scanning and anything else that speaks the format.

Docs

• Overview — how the analysis works under the hood
• CLI reference — every flag, one table
• Configuration — pragyalint.toml, pyproject.toml, env-friendly defaults
• Fixes — dry runs, confidence gates, --force
• Errors & troubleshooting — Windows/Linux/macOS PATH fixes included
• Full API — Python-level usage

Development

git clone https://github.com/Sanskriti-Studios/PragyaLint
cd PragyaLint
python -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e ".[dev]"
pytest

License

GPL-3.0-or-later — free software, keep it that way.