rlsbl v0.113.0 /rlsbl.ci_router
Updated
On this page

Shared CI-router discovery and job-key helpers: the single source of truth for which workflow files feed a monorepo project's inlined jobs in ci-router.yml.

#rlsbl.ci_router

#rlsbl.ci_router

Shared CI-router job-key helpers for monorepo workflows, providing the single source of truth for project-prefixed job keys in ci-router.yml.

The monorepo CI router (ci-router.yml) inlines every project's CI jobs, keyed <prefix>-<job> where the prefix is the CI file name minus .yml. These helpers are the single source of truth for those prefixes, consumed by the inline publish gate (commands.monorepo.publish_inline) and the workspace-ci-synced check. They live in this low-level module so the check layer can use them without importing from the command layer.

#discover_project_ci_sources

python
def discover_project_ci_sources(project_dir) -> list[str]

Absolute paths of project_dir's own CI workflow source files.

ci.yml plus every ci-*.yml except the generated router. This is the ONE discovery shared by monorepo sync (which inlines these files into the router, minting the job keys) and the release CI gate (which must know the check-run names those keys produce), so the router and the gate can never be derived from different file sets.

#router_ci_dest_name

python
def router_ci_dest_name(project_name: str, ci_basename: str) -> str

Router-side file name for one of project_name's CI files.

ci.yml -> {name}-ci.yml; ci-{target}.yml -> {name}-ci-{target}.yml. The name minus .yml is the job-key prefix the router stamps into every inlined job's display name.

#router_ci_files

python
def router_ci_files(project_name: str, project_dir) -> list[str]

The router file names project_name's own CI sources map to.

#_router_ci_job_keys

python
def _router_ci_job_keys(project, project_dir=None) -> list[str]

Return the CI router's job-key prefixes for project.

Mirrors sync._generate_router: every CI file uses the file name minus .yml as its job-key prefix. Reusable-workflow check runs are named <prefix> / <ci job name>, which is what the shared gate matches.

_ci_files is populated by monorepo sync. Callers outside sync (the release CI gate) pass project_dir instead, and the same discovery that fed sync recomputes the list from disk.

#_router_ci_check_regex

python
def _router_ci_check_regex(project, project_dir=None) -> str

Regex matching project's prefixed CI check-run names.

Search