Metadata-Version: 2.4
Name: speedi
Version: 0.1.0
Summary: Speedi – A typed, stateful, high-performance CLI framework for Python
Author: Muonry Team
License: MIT
Project-URL: Homepage, https://github.com/muonry/speedi
Project-URL: Repository, https://github.com/muonry/speedi.git
Project-URL: Issues, https://github.com/muonry/speedi/issues
Keywords: cli,framework,typed,async,concurrency
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Provides-Extra: rich
Requires-Dist: rich>=13.0.0; extra == "rich"

# Speedi

A typed, stateful, high-performance CLI framework for Python.

- Declarative, Typer-like API
- Type-hint aware parsing and validation (Satya-ready stubs)
- Stateful session (in-memory, optional persistence)
- Async-first with simple parallel primitives
- Optional Rust core (PyO3) scaffold

## Quickstart (local, no install)

```bash
python examples/speedi_example.py --help
python examples/speedi_example.py greet Alice 30 --loud
```

Example output:

```
Hello Alice, age 30
HELLO ALICE
```

## Session (optional persistence)

```bash
python examples/speedi_example.py login --user alice
python examples/speedi_example.py whoami
```

To persist session between runs, pass `--persist` to commands that mutate session or set env `SPEEDI_PERSIST=1`.

Session file path (if persisted): `~/.speedi/session.json`

## Project Layout

- `speedi/` – core Python package
  - `app.py` – `App` and command system
  - `session.py` – session management
  - `concurrency.py` – `parallel` helper
  - `validation.py` – type validation stubs
  - `engine.py` – optional Rust bridge (stub)
  - `__init__.py` – exports
- `examples/` – example CLI
- `rust/speedi_core/` – optional Rust core (PyO3) scaffold
- `tests/` – minimal tests

## Rust core (optional)

A PyO3 stub is included under `rust/speedi_core`. It's not required to run the Python example.

## License

MIT
