Metadata-Version: 2.4
Name: traceframe
Version: 0.1.1
Summary: Track and detect suspicious dataframe transformations.
Project-URL: Homepage, https://github.com/amanmukati09/ghosttrace
Project-URL: Repository, https://github.com/amanmukati09/ghosttrace
Author: Aman Mukati
License: MIT
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: rich
Provides-Extra: dev
Requires-Dist: mypy; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Description-Content-Type: text/markdown

# TraceFrame

![Python](https://img.shields.io/badge/python-3.11+-blue)
![License](https://img.shields.io/badge/license-MIT-green)
Track and detect suspicious pandas dataframe transformations.

TraceFrame helps developers debug silent dataframe corruption,
unexpected scaling issues, and transformation anomalies.

## Features

- Track dataframe mutations
- Detect suspicious numeric shifts
- Generate readable reports
- Lightweight and local-first
- Simple API

---

## Installation

```bash
pip install traceframe
```

---

## Quick Start

```python
import pandas as pd

from traceframe import watch

df = pd.DataFrame(
    {
        "salary": [50000, 60000, 70000]
    }
)

df = watch(df)

df["salary"] = df["salary"] / 1000

df.trace_report()
```

---

## Example Output

```text
[traceframe warning]
- Large scale shift detected in 'salary'

TraceFrame Report
```

---

## Development

Clone repository:

```bash
git clone YOUR_REPO_URL
```

Install dependencies:

```bash
uv sync
```

Run tests:

```bash
uv run pytest
```

---

## License

MIT