Plan software-layer pull requests that do not overlap¶
What it does: stack batch plans European Environment for Scientific
Software Installations (EESSI) software-layer pull requests whose builds
do not overlap. A root’s set is its closure over the robot path minus
the installed modules, the same set pr-overlap computes for one
easystack line. Roots whose sets meet go in one pull request. A root
whose set meets an open pull request waits for that pull request. The
rest are packed --size roots per pull request.
Why you’d use it: stack gap writes roots.txt for the recipes the
generation can already build. Those roots should not all land in one
pull request, and two pull requests must not build the same module.
One root beside an installed version¶
tests/batch_versions_fixtures has GROMACS 2025.4 installed and a
recipe for GROMACS 2026.2 on foss/2026.1, generation 2026.1 of EESSI
2026.06. One root is one batch. The second version in that generation
is a warning, not a failed plan.
eb-stack stack batch \
--root GROMACS-2026.2-foss-2026.1.eb \
--easyconfigs tests/batch_versions_fixtures/easyconfigs \
--installed tests/batch_versions_fixtures/installed-gromacs-2025.txt \
--eessi-version 2026.06 \
--easybuild-version 5.4.1 \
--generation 2026.1 \
--generated-at 2026-10-30T00:00:00Z \
--out-dir /tmp/batches
That command printed:
batches=1 roots=1 waits=0 unresolved=0 deployed=0 digest=cd1b5856e678c2d8fbd7bc563a861edf706a9afe7cece55596aaa892a235b080 out=/tmp/batches
/tmp/batches/plan.md names the batch and the warning:
## batch-01-gromacs
{2026.06}[foss/2026.1] GROMACS 2026.2
1 module(s) to build.
1 second-version warning(s); `pr-body.md` has the details.
The batch directory holds the EESSI easystacks, a lock, a CycloneDX
software bill of materials, reproduce.sh, batch.json, and
pr-body.md. The pull-request body includes:
Second versions in one generation, from `eb-stack stack generation`:
GROMACS has 2 versions in generation 2026.1: 2025.4 (already in the stack), 2026.2 (added: GROMACS-2026.2-foss-2026.1.eb); pass --allow-versions GROMACS@2026.1 to accept
--allow-versions GROMACS@2026.1 accepts that pair.
--generated-at fixes the time written into the plan, so the same
inputs give the same digest. --roots-file reads the roots.txt that
stack gap writes. An entry the architecture cannot build exits 1 and
writes nothing. eb_stack_batch is the same command. See
the second-version check and
the CLI reference.