Metadata-Version: 2.4
Name: viperis
Version: 0.5.0
Summary: Python source to Velarium IR (frontend parser) — 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
License-File: LICENSE
Keywords: ir,static-analysis,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

# viperis

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

**Role in Velarium:** **Python source → Velarium IR** — parse modules or files, resolve type hints where possible, and emit [**velarium**](https://pypi.org/project/velarium/)-compatible `ModelSpec` / `TypeSpec` graphs. This is the planned *frontend* that complements **`velarium`**’s class-based builders.

| | |
|---|---|
| **PyPI** | [pypi.org/project/viperis](https://pypi.org/project/viperis/) *(scaffold)* |
| **Repository** | [github.com/eddiethedean/velarium](https://github.com/eddiethedean/velarium) |
| **Python** | 3.10+ (when implemented; aligns with **velarium**) |
| **Status** | **Scaffold** — no parser implementation yet; use **`velarium`** class-based builders ([docs/model-sources.md](https://github.com/eddiethedean/velarium/blob/main/docs/model-sources.md)) today |

## Planned responsibilities

- Walk Python AST for modules or file paths  
- Extract annotations and structural information  
- Feed normalized output into the shared IR ([**velarium** on PyPI](https://pypi.org/project/velarium/))

## See also

- [docs/valarium.md](https://github.com/eddiethedean/velarium/blob/main/docs/valarium.md) — pipeline and component list  
- [docs/design.md](https://github.com/eddiethedean/velarium/blob/main/docs/design.md) — why the IR exists  
- [docs/supported-annotations.md](https://github.com/eddiethedean/velarium/blob/main/docs/supported-annotations.md) — annotation → IR matrix (what **viperis** will eventually preserve from source)  
- [docs/modelspec-ir.md](https://github.com/eddiethedean/velarium/blob/main/docs/modelspec-ir.md) — IR schema **viperis** will emit  
- [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/) — current IR implementation  

## License

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