Metadata-Version: 2.5
Name: traceclip
Version: 0.1.0
Summary: A fast, local linting wrapper specifically designed for AI-generated code.
Project-URL: Homepage, https://github.com/Prakhar3801b/Traceclip
Project-URL: Repository, https://github.com/Prakhar3801b/Traceclip
Project-URL: Bug Tracker, https://github.com/Prakhar3801b/Traceclip/issues
Author-email: Prakhar Bhardwaj <bhardwajprakhar02@gmail.com>
License: MIT
License-File: LICENSE
Keywords: ai,chatgpt,code-quality,copilot,linter,sanitizer,vibecheck
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.8
Requires-Dist: rich>=12.0.0
Description-Content-Type: text/markdown

# Traceclip (vibecheck) 🧼

**Traceclip** is a fast, local code sanitizer and linter designed specifically to prune and inspect AI-generated code. 

Rather than enforcing pedantic style formats like traditional linters, `vibecheck` hunts down common AI developer artifacts and "hallucinations":
- 🚫 **Unused Imports**: Bloat imported by AI but never referenced.
- 🪦 **Dead Functions**: Functions generated by the AI that are defined but never called or referenced.
- 🔑 **Placeholder Variables & Secrets**: Hardcoded templates like `API_KEY = "your_key_here"` or `URL = "https://example.com/api"`.
- 🕳️ **Stub Implementations**: Empty functions with only `pass`, `...`, or `raise NotImplementedError`.

It grades your script with a **Vibe Score** (out of 100). If your score drops too low, it fails!

---

## Installation

Inside the project directory, run:
```bash
pip install -e .
```

## Usage

Check a script:
```bash
vibecheck my_script.py
```

Check multiple files or directories:
```bash
vibecheck src/ tests/
```

Automatically sanitize and fix issues:
```bash
vibecheck my_script.py --fix
```

Enforce a minimum vibe score (ideal for CI/CD):
```bash
vibecheck my_script.py --min-score 80
```
