livery.workshop._entry¶
livery.workshop._entry ¶
The workspace entry contract: the emitted setup.sh at the root.
One choke point owns machine readiness. The script ensures uv at the
lock's pinned version, syncs the venv against the lock, records the
sync receipt, and emits the environment: sourced by a shell it enters
that shell, and setup.sh github persists the emission into
GITHUB_ENV/GITHUB_PATH so every later CI step calls the
runner bare. A GitLab job sources setup.sh gitlab, and its shell
keeps the emission for the job's later lines. The script sets the
variables the workspace's extensions declare before its sync, and on a
CI job of either kind places each one that names {place} in the
job's own directory. Between entries the per-command reconcile
(livery.workshop._reconcile) keeps the venv following the lock.
The script is a generated artifact like the CI workflows: emitted by
livery.workshop._ci_generate.generate, written by
fm sync, judged by the drift check. POSIX only; a
Windows CI leg runs it under the runner's bash, and a pwsh spelling
is deferred to the tool-store port.
Functions:
| Name | Description |
|---|---|
locked_uv_version |
The uv version the workspace lock pins, or "". |
installer_url |
The uv installer URL, versioned when a pin exists. |
entry_script |
The emitted |
native_members |
The distribution names of the job-built members uv installs, in path order. |
locked_uv_version ¶
The uv version the workspace lock pins, or "".
uv rides the dev group, so uv.lock pins it exactly. A
workspace without a lock, or whose lock does not carry uv, has no
pin to derive and answers "": the emitters then leave the
bootstrap unpinned rather than inventing a version.
Source code in packages/workshop/src/livery/workshop/_entry.py
installer_url ¶
The uv installer URL, versioned when a pin exists.
entry_script ¶
The emitted setup.sh body for root, header not included.
The variables the extensions of root's set declare are rendered
from their declarations: each one's line, and in each CI branch the
check that the job names a directory of its own, once for each
variable that names {place}.
Raises:
| Type | Description |
|---|---|
Failed
|
when two of the extensions declare one variable, naming both. |
Source code in packages/workshop/src/livery/workshop/_entry.py
native_members ¶
The distribution names of the job-built members uv installs, in path order.
A member a job of the release point builds before the wave, the
workspace's job-built-members answer, carries native code its
install builds against the store's tools, so the entry installs it
after the tools are in the environment; every other member installs
in the first sync. A job-built member the uv workspace does not hold
is no uv install and is left out.