Handbook
101-01 — Install and smoke
A clean virtual environment with forge-lcdl installed in editable mode and a passing offline compile + test sweep.
Updated
What you will build
A clean virtual environment with forge-lcdl installed in editable mode and a passing offline compile + test sweep.
Prerequisites
- Python 3.11+
- Terminal at
forge-lcdlrepository root
Files you will touch
None (environment only).
Step 1 — Create venv
cd forge-lcdl
python3 -m venv .venv
. .venv/bin/activate
Step 2 — Editable install
pip install -e ".[dev]"
Step 3 — Compile check
python -m compileall -q src tests
Step 4 — Tests
pytest -q
Expected output
compileall: silent success (exit 0).pytest: all collected tests pass; integration tests markedgraniteare not collected by default.
Common failures
| Symptom | Likely cause | Fix |
|---|---|---|
No module named forge_lcdl |
Forgot install / wrong venv | pip install -e . inside activated .venv |
| Missing pytest | Dev extra not installed | pip install -e ".[dev]" |
Verify
python -c "import forge_lcdl; print('ok')"
What changed
You can import forge_lcdl from tests and scripts with PYTHONPATH=src or the editable install.