Metadata-Version: 2.4
Name: morphra
Version: 0.7.0
Summary: Velarium IR to Pydantic models — scaffold
Project-URL: Homepage, https://github.com/eddiethedean/velarium
Project-URL: Repository, https://github.com/eddiethedean/velarium
Project-URL: Documentation, https://github.com/eddiethedean/velarium/blob/main/docs/README.md
Project-URL: Changelog, https://github.com/eddiethedean/velarium/blob/main/CHANGELOG.md
Author: Velarium contributors
License: MIT
Keywords: ir,pydantic,typing,velarium
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# morphra

[![PyPI version](https://img.shields.io/pypi/v/morphra.svg)](https://pypi.org/project/morphra/)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/eddiethedean/velarium/blob/main/LICENSE)

**Role in Velarium:** **IR → Pydantic** — map Velarium (`ModelSpec` / `TypeSpec`) into Pydantic v2 models (generated source or runtime construction), preserving validation intent where the IR allows. This is **codegen from IR**, distinct from **ingesting** existing Pydantic models into IR (that lives in [**velarium**](https://pypi.org/project/velarium/) — see [docs/model-sources.md](https://github.com/eddiethedean/velarium/blob/main/docs/model-sources.md)).

| | |
|---|---|
| **PyPI** | [pypi.org/project/morphra](https://pypi.org/project/morphra/) *(scaffold)* |
| **Repository** | [github.com/eddiethedean/velarium](https://github.com/eddiethedean/velarium) |
| **Python** | 3.10+ (when implemented) |
| **Status** | **Scaffold** — no code generation yet |
| **Related** | [**velotype** on PyPI](https://pypi.org/project/velotype/) — IR → `.pyi` for static types today |

## Planned use cases

- FastAPI / service layers that want models aligned with the same IR as stubs  
- Shared typing story between static stubs ([**velotype**](https://pypi.org/project/velotype/)) and runtime validation  

## See also

- [docs/valarium.md](https://github.com/eddiethedean/velarium/blob/main/docs/valarium.md) — backend placement in the pipeline  
- [docs/modelspec-ir.md](https://github.com/eddiethedean/velarium/blob/main/docs/modelspec-ir.md) — `ModelSpec` / `TypeSpec` schema  
- [docs/supported-annotations.md](https://github.com/eddiethedean/velarium/blob/main/docs/supported-annotations.md) — what the IR can represent today  
- [docs/model-sources.md](https://github.com/eddiethedean/velarium/blob/main/docs/model-sources.md) — Pydantic → IR ingestion in **velarium** (this package is the reverse direction)  
- [docs/stub-compatibility.md](https://github.com/eddiethedean/velarium/blob/main/docs/stub-compatibility.md) — how **velotype** renders `.pyi` today  
- [Roadmap](https://github.com/eddiethedean/velarium/blob/main/docs/ROADMAP.md)  
- [Repository README](https://github.com/eddiethedean/velarium/blob/main/README.md)  
- [Documentation index](https://github.com/eddiethedean/velarium/blob/main/docs/README.md)  
- [**velarium** on PyPI](https://pypi.org/project/velarium/) — IR types morphra will consume  

## License

MIT — see [LICENSE](https://github.com/eddiethedean/velarium/blob/main/LICENSE).
