newspaper_wedding/aidlc/spaces/default/intents/260913-newspaper-gen/construction/build-and-test/build-instructions.md

Build Instructions — Wedding Newspaper Generator

Dependencies

• uv (0.11.x) — the confirmed local runtime (Python 3.12 in the venv).
• newspaper/.venv created by uv sync; pytest installed as a dev extra.

Install

cd newspaper && uv sync --extra dev

Build

This is a pure-Python static generator — there is no compile/bundle step. The "build" is producing the packaged newspaper package importable and the CLI working:

uv run --project newspaper python -c "import newspaper.generator, newspaper.ai_draft, newspaper.funnies; print('packages import OK')"

Verify

• Run the full test suite (see integration-test-instructions.md).
• Generate a sample issue:

uv run --project newspaper python -m newspaper.generator.cli --project <sample_dir>

and open/eyeball the A4 print in the browser (the real print acceptance).

Troubleshooting

• ModuleNotFoundError: newspaper → run with UV_PROJECT_PATH/from repo root, or uv sync && uv run --project newspaper pytest.
• Missing deps → rerun uv sync --extra dev.
• __pycache__ artifacts → ignored via .gitignore (never commit).