utils.env.handlers package

Subpackages

Submodules

utils.env.handlers.act_platform_image module

ACT_PLATFORM_IMAGE: act runner platform image, resolved from the svc-runner role’s act-runner service declaration.

utils.env.handlers.act_platform_image.apply(eb: EnvBuilder, ctx: BuildContext) → None

utils.env.handlers.gha_passthrough module

GHA-only static-env passthrough: keys from default.env that are only seeded when running on real GitHub Actions.

utils.env.handlers.gha_passthrough.apply(eb: EnvBuilder, ctx: BuildContext) → None

utils.env.handlers.github_repository_owner module

GITHUB_REPOSITORY_OWNER: lowercased GHA repository owner, derived from GITHUB_REPOSITORY_OWNER / OWNER / GITHUB_REPOSITORY. Fatal if unresolvable on GHA.

utils.env.handlers.github_repository_owner.apply(eb: EnvBuilder, ctx: BuildContext) → None

utils.env.handlers.nix_config module

NIX_CONFIG: pass-through of the caller’s access-tokens line, when present.

.env is consumed by bash source and docker-compose –env-file, neither of which round-trips multi-line values; the writer therefore rejects them. Other NIX_CONFIG settings (accept-flake-config, experimental-features, …) belong in /etc/nix/nix.conf (Dockerfile injects them inside the dev container; host operators set them once in ~/.config/nix/nix.conf).

utils.env.handlers.nix_config.apply(eb: EnvBuilder, ctx: BuildContext) → None

utils.env.handlers.passthrough module

Static-env passthrough: copy every declared key from default.env with caller-env-wins (setdefault) semantics. Comments come from ctx.static_comments (parsed from default.env).

utils.env.handlers.passthrough.apply(eb: EnvBuilder, ctx: BuildContext) → None

Module contents

Handler registry. ORDERED_HANDLERS is iterated by build_env().

Each handler module exposes apply(eb, ctx) -> None. Cross-handler data flows via utils.env.builder.EnvBuilder; handlers must not import each other.