Skip to content

F9.8 — Accept packages in scaffolded applications

State Closed
Parent E9
Iteration Release 1
Closed Date 2026-09-26
Predecessors ADR-0008

Stories: 4 Closed

Story State Depends on
S9.8.1 — A command-line application Closed (2026-09-26) —
S9.8.2 — A tool with a lifecycle Closed (2026-09-26) —
S9.8.3 — A FastAPI service Closed (2026-09-26) —
S9.8.4 — A Django application Closed (2026-09-26) —

Workspace tests import each package from source, beside every other package. They cannot show that a package works in an application that installs it the way a consumer does. Each story here scaffolds one kind of application in a temporary directory, installs the packages it needs from wheels built from the current commit, and exercises it. The application shapes are the ones pykit's packages are built for.

Design

  • The tests share one helper that builds the needed wheels once per session and installs them into a fresh virtual environment under tmp_path, with no workspace source override. If it is generic enough, it belongs in rn_forge.commons.testing; otherwise it is a root conftest.py fixture.
  • They carry a scaffold marker, registered at the root and in each package that uses it, because they are slower than unit tests. CI runs them in their own job.
  • The django-extras CI job already builds wheels and installs them into a clean environment; reuse its approach rather than inventing another.

S9.8.1 — A command-line application

State: Closed (2026-09-26)

Acceptance: a scaffolded project declares its commands through rn-forge-cli, with no hand-written application construction. Installed from built rn-forge-commons and rn-forge-cli wheels, its console script runs a command, prints help, and maps an application error to its exit code.

S9.8.2 — A tool with a lifecycle

State: Closed (2026-09-26)

Acceptance: a scaffolded tool declares a [lifecycle] table and builds its app with rn_forge.tooling's build_tool_app. Installed from built wheels, with $RNF_HOME pointing at a temporary directory, it runs install, status, upgrade and uninstall, and each leaves the documented layout.

S9.8.3 — A FastAPI service

State: Closed (2026-09-26)

Acceptance: a scaffolded service assembled with rn-forge-fastapi's FastApiApp, installed from built wheels, passes every case in rn_forge.web.conformance.CASES over HTTP.

S9.8.4 — A Django application

State: Closed (2026-09-26)

Acceptance: a scaffolded Django project using rn-forge-django, installed from built wheels with its drf extra, passes every case in rn_forge.web.conformance.CASES over HTTP.

The conformance fixture also needs the transfer, openapi, security, cors and otel extras, so the project installs them too.

Acceptance

Each story is a test, so the feature's acceptance is that they run in CI and pass.

set -euo pipefail
uv run pytest -q -m scaffold    # S9.8.1–S9.8.4