Metadata-Version: 2.4
Name: ghost-runner
Version: 1.0.0
Summary: A developer tool for automatic temp file cleanup, log suppression, and zero-trace script execution for privacy-focused applications.
Author: Gurkirat Singh
License: MIT
Project-URL: Homepage, https://github.com/gurkiratsingh/ghost-runner
Keywords: ghost,cleanup,temp-files,privacy,zero-trace,log-suppression,file-management,developer-tools,automation,cache-cleanup
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Filesystems
Classifier: Topic :: Utilities
Classifier: Intended Audience :: Developers
Requires-Python: >=3.7
Description-Content-Type: text/markdown

# 👻 ghost-runner

> **Automatic temp file cleanup, log suppression, and zero-trace execution for Python scripts.**

[![Python](https://img.shields.io/badge/Python-3.7%2B-blue)](https://www.python.org)
[![License](https://img.shields.io/badge/License-MIT-green)](LICENSE)
[![Zero Dependencies](https://img.shields.io/badge/Dependencies-None-brightgreen)]()

---

## Install

```bash
pip install ghost-runner
```

---

## Quick Start

```python
import ghost

with ghost.run():
    with open("temp_data.txt", "w") as f:
        f.write("processing data...")

# temp_data.txt deleted automatically
# logs suppressed, cache removed, env restored
```

---

## Features

- Auto deletes files created inside the block
- Suppresses all logging output
- Removes .pyc and __pycache__ files
- Restores environment variables
- Cleans up even if your code crashes
- Zero external dependencies

---

## API

| Function | Description |
|---|---|
| `ghost.run()` | Main context manager |
| `ghost.track_file(path)` | Mark a file for deletion |
| `ghost.track_dir(path)` | Mark a folder for deletion |
| `ghost.wipe_now()` | Trigger cleanup immediately |
| `ghost.status()` | Get tracking status |

---

## License

MIT — **Gurkirat Singh**
