Metadata-Version: 2.4
Name: pyseu
Version: 0.1.0
Summary: Python Execution State Explorer — observe what Python executed and how state changed
Author: Pyseu
License: MIT
Keywords: debugging,tracing,education,development
Classifier: Development Status :: 4 - Beta
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: Topic :: Software Development :: Debuggers
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Pyseu — Python Execution State Explorer

Pyseu is a small, reliable, local Python developer utility that helps you understand what Python executed and what changed in program state after each executed line.

Pyseu is an **execution observer**, not a replacement Python interpreter.

## Install

```bash
pip install pyseu
```

Or from source:

```bash
pip install -e .
```

## Usage

```bash
pyseu program.py
```

## Example

Given `example.py`:

```python
x = 10
y = 20
z = x + y
print(z)
```

Run:

```bash
pyseu example.py
```

Output:

```
Pyseu — Python Execution State Explorer
[1] x = 10
    x: None → 10
[2] y = 20
    y: None → 20
[3] z = x + y
    z: None → 30
[4] print(z)
    PROGRAM OUTPUT: 30
Execution completed successfully.
```

## Features

- Traces actual Python line execution
- Tracks runtime variable state
- Detects meaningful variable changes between execution steps
- Captures and separates program stdout from trace output
- Supports functions, recursion, loops, conditionals, and exceptions
- Handles mutable objects (lists, dictionaries)
- Reports execution failures clearly

## Requirements

- Python 3.10+
- No third-party dependencies

## License

MIT
