Metadata-Version: 2.4
Name: debtx
Version: 0.1.0
Summary: AI-generated code debt scanner. Grade your codebase A-F.
Project-URL: Homepage, https://github.com/loplop-h/debtx
Project-URL: Repository, https://github.com/loplop-h/debtx
Project-URL: Issues, https://github.com/loplop-h/debtx/issues
Author: Max Huisman
License-Expression: MIT
License-File: LICENSE
Keywords: ai,claude-code,code-quality,copilot,linter,static-analysis,technical-debt,vibe-coding
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.10
Requires-Dist: click>=8.0
Requires-Dist: rich>=13.0
Provides-Extra: dev
Requires-Dist: pytest-cov>=4.0; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# debtx

AI-generated code debt scanner. Grade your codebase A-F.

## Install

```bash
pip install debtx
```

## Usage

```bash
debtx scan .
debtx scan ./src --format md
debtx scan . --strict
debtx badge
```

## What it detects

12 categories of "vibe code" anti-patterns that AI coding agents commonly produce:

| Detector | What it catches |
|----------|----------------|
| Giant Functions | Functions over 100 lines |
| Empty Catches | Silent error swallowing |
| Hardcoded Values | URLs, IPs, secrets, magic numbers |
| Duplicated Blocks | Copy-paste code patterns |
| Missing Error Handling | IO ops without try/except |
| Orphaned Imports | Unused imports |
| No Test Coverage | Source files with no tests |
| Massive Files | Files over 500 lines |
| TODO/FIXME Comments | Unresolved markers |
| Inconsistent Naming | Mixed camelCase/snake_case |
| Deep Nesting | 4+ levels of indentation |
| Dead Code | Unreachable code after return/break |

## Grading Scale

| Grade | Score | Meaning |
|-------|-------|---------|
| A | 90-100 | Clean codebase |
| B | 75-89 | Minor issues |
| C | 55-74 | Needs attention |
| D | 35-54 | Significant debt |
| F | 0-34 | Critical debt |

## License

MIT
