Metadata-Version: 2.4
Name: viperis
Version: 0.1.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

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

| | |
|---|---|
| **PyPI** | `viperis` (scaffold) |
| **Status** | **Scaffold** — no parser implementation yet; use **`velarium.modelspec_build`** from dataclasses / `TypedDict` today |

## Planned responsibilities

- Walk Python AST for modules or file paths  
- Extract annotations and structural information  
- Feed normalized output into the shared IR (`velarium`)

## See also

- [docs/valarium.md](../../docs/valarium.md) — pipeline and component list  
- [docs/design.md](../../docs/design.md) — why the IR exists  
- [**velarium**](../velarium/README.md) — current IR implementation  
