debtscanner
debtscanner is a Python CLI that scans codebases for technical debt using AI and produces prioritized results in terminal and HTML.
Install
pip install -e .
Configure
Create a .env file in the project root:
GITHUB_TOKEN=ghp_your_token_here
Or export GITHUB_TOKEN in your shell.
Commands
debtscanner scan .
debtscanner scan src/ --output report.html
debtscanner report
debtscanner fix auth.py
Options
--ignore: skip specific folders (repeatable or comma-separated)--severity: minimum level to include (LOW,MEDIUM,HIGH,CRITICAL)
Supported languages
.py,.js,.ts,.jsx,.tsx,.java,.go,.rb
Behavior
- Skips:
node_modules,.git,__pycache__,dist,build,.env - Skips files larger than 100KB with warning
- Skips binary files automatically
- Retries once on API rate limits with a 2-second pause
1 maintainer
Metadata
1 maintainer
Release files for debtscanner 0.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| debtscanner-0.2.1.tar.gz | 13.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| debtscanner-0.2.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 28.2 kB
Release files / debtscanner-0.2.1.tar.gz
| Download URL | debtscanner-0.2.1.tar.gz |
|---|---|
| Size | 13.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1cadb681a5d7cefd77eb11c73d209d20f455598a304dbd0008a98094a0c5dc29
|
|
BLAKE2b-256 checksum How to use checksums |
e984e94539f3fa2251ffc4fc97e39bae7f6c5d768383ec2bf64783e7b1959fdc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.11
|
Release files / debtscanner-0.2.1-py3-none-any.whl
| Download URL | debtscanner-0.2.1-py3-none-any.whl |
|---|---|
| Size | 14.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
53830562cecad558d9707780b2cb4842b9fe3400e58e035f0b342a6a8b5906cb
|
|
BLAKE2b-256 checksum How to use checksums |
da0f8d9a3d8dd6bc06554cef8c2927f800eef4071e94aca8586b29f59c794f3c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.11
|
