Metadata-Version: 2.4
Name: astrapeum
Version: 0.1.0
Summary: Geometry and tuning tools for the Astrapeum basin system.
Author: WitchMithras
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == "dev"

# Astrapeum

Astrapeum is a small Python workspace for modeling and tuning a reflective basin, mirror crown, and wall target system.

## Quick Start

For local development, install the package in editable mode:

```powershell
python -m pip install -e ".[dev]"
```

Then run the checks and CLI:

```powershell
python -m pytest
python -m astrapeum simulate --az 93.11 --alt 19.3
python -m astrapeum mirrors --output draconic_mirrors.generated.json
```

Without installing, PowerShell can run the package with `PYTHONPATH` pointed at `src`:

```powershell
$env:PYTHONPATH = "src"
python -m astrapeum simulate --az 93.11 --alt 19.3
```

## Project Shape

- `src/astrapeum/geometry.py`: vector math and ray helpers.
- `src/astrapeum/models.py`: physical model dataclasses.
- `src/astrapeum/simulation.py`: basin-to-wall reflection simulation.
- `src/astrapeum/tuning.py`: mirror crown and lion-sector tuning helpers.
- `src/astrapeum/data.py`: packaged JSON data loading.
- `src/astrapeum/cli.py`: command-line entry points.
- `tests/`: executable guardrails for the scaffold.

The original `src/astrapeum/wall.py` remains as a compatibility facade.
