rn-forge-commons¶
rn-forge-commons is the shared utility layer for the rn-forge-* Python
packages.
It provides:
- structured logging and audit helpers
- nested collection, JSON, and YAML utilities
- config loading with interpolation and inheritance
- dataclass serialization helpers
- subprocess and task-pool abstractions
- managed blocks, structured findings, and testing helpers
- a locked JSON state store and a generation engine (plan, diff, atomic apply)
The developer-tooling surface — console, Typer wiring, local state and installer
mechanics — lives in rn-forge-tooling, which depends on this package.
Install¶
dependencies = ["rn-forge-commons>=0.9,<0.10"]
Extras: json, structlog, resilience, otel, pydantic, markdown,
templates, testing and all; see Installation.
Minimum example: Quickstart. Failures a caller handles
are AppExceptions carrying a message, an integer error_code and
error_data.
Use the guides for common workflows and the API reference for module details.