Metadata-Version: 2.4
Name: snaketrail
Version: 0.1.0
Summary: Trace the snake: list transitive local imports and unused Python files.
Author-email: Jacques Fleischer <j.fleischer@ufl.edu>
License: MIT
Keywords: dependency-graph,imports,python,static-analysis
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# snaketrail

Trace the snake 🐍: list **transitive local imports** (files & namespace packages) and report **unused .py files** under your project root — without executing your code.

## Install
```bash
pip install snaketrail
```

lets say you have a Handler.py
thats your main entrypoint to your project,
and you want to see which files it uses.
but you more importantly want to see which files
it DOESNT use and to tell what is deprecated and 
just test files.

```
# from your project root
snaketrail Handler.py
snaketrail Handler.py --verbose
snaketrail Handler.py --root /path/to/project

> Unused local Python files:
>  - debug.py
>  - test.py

```

now you can safely burn those deprecated files
that your main program never touches, or tuck
them away into a deprecated/ folder and nobody will
ever look at them again.

probably.
