mod provided¶
- module provided¶
Fail when a build list names software a baseline already provides.
A site layer is the software EESSI does not install. stack solve –build-list-excludes-baseline writes that list. A later edit can put an EESSI module back on it.
stack providedreads the list and the baseline (an installed-module listing, a stack lock, or both) and fails when a line’s package name is one the baseline has, ignoring version and toolchain.--allowkeeps a second version the site was asked for.The same pass also rejects a toolchain other than the foss-2026.1 hierarchy (GCCcore-15.2.0 below it), a per-line
--hooksor--hookflag, and a name that only a separate family lock covers. Those are errors. Group-restricted names are warnings, and only when--licensedor--licensed-filenames them.Functions
- fn run_provided(args: &ProvidedRequest) -> Result<ProvidedReport>¶
Read the lists and compare each line’s package name with the baseline.
Enums
- enum ProvidedFormat¶
How
stack providedprints.- Text¶
The
provided/unparsedlines, then any further findings, then a count.
- Github¶
GitHub Actions workflow commands.
- Json¶
One JSON document.
Implementations
- impl ProvidedFormat¶
Functions
- fn parse(value: &str) -> Result<Self>¶
text,github, orjson.
Structs and Unions
- struct LineNote¶
One further finding on a build-list line.
- list: String¶
Build list the line came from.
- line: usize¶
1-based line in that file.
- file: String¶
The line’s easyconfig, as written.
- name: String¶
Package name parsed from that filename.
- detail: String¶
The rest of the message, after the file, name, list, and line.
- struct ProvidedHit¶
One build-list line whose package the baseline already provides.
- list: String¶
Build list the line came from.
- file: String¶
The line’s easyconfig, as written.
- name: String¶
Package name parsed from that filename.
- line: usize¶
1-based line in the build list.
- struct ProvidedReport¶
What
stack providedfound.- hits: Vec<ProvidedHit>¶
Lines whose package the baseline provides and
--allowdoes not name.
- unparsed: Vec<UnparsedLine>¶
.eblines whose filename names no package.
- allowed: usize¶
Lines
--allowkept offhits.
- provided: usize¶
Distinct package names the baseline provides.
- strict: bool¶
Whether a licensed warning fails the command.
- stdout: String¶
Text for stdout. JSON when the request asked for it.
Implementations
- impl ProvidedReport¶
Functions
- fn failure(&self) -> Option<String>¶
The stderr line when the check failed, or
Nonewhen it passed.
- struct ProvidedRequest¶
Arguments for
stack provided.- build_lists: Vec<PathBuf>¶
Jenkins or path-style build lists. Repeatable.
- installed: Vec<PathBuf>¶
Installed-module listings,
Name/Versionor a bare name. Repeatable.
- baseline_lock: Option<PathBuf>¶
Stack lock whose package names count as provided.
- allow: Vec<String>¶
Package names that may stay on the list. Matched without regard to case.
This skips a provided hit and a family-lock hit. It does not skip a wrong toolchain or a
--hooksflag.
- family_locks: Vec<PathBuf>¶
Stack locks of families the foss baseline cannot see, such as lfoss. A name that is only in one of these is not reported as site layer.
- licensed: Vec<String>¶
Extra group-restricted names. Combined with
--licensed-file.
- licensed_file: Option<PathBuf>¶
Name list that replaces passing each group-restricted name as
--licensed. Absent, and with no--licensed, there is no warning.
- json: bool¶
Print the report as JSON. Wins over
formatwhen set.
- format: ProvidedFormat¶
Text, GitHub workflow commands, or JSON.
- strict: bool¶
Exit 1 when a group-restricted warning remains.