mod arch_support

module arch_support

Architectures that cannot build an EasyBuild entry.

EESSI builds one shared easystack on every CPU architecture. An entry that cannot be built on one of them fails that architecture’s bot run, even when the pull request added something else. The list in data/arch-unsupported.toml names those entries. A plan that includes one, or depends on one, stops before anything is written.

The other check is cheaper and does not read recipes. An entry in a shared easystack that the architecture has never installed, and that is not in that architecture’s additional_arch easystack, is flagged.

Variables

const BUNDLED_UNSUPPORTED: &str

The list shipped with eb-stack.

Functions

fn arch_family(arch: &str) -> &str

riscv64/generic and riscv64 are the same family.

fn easyconfig_name(filename: &str) -> Option<String>

EasyBuild name from an easyconfig filename.

The name is every dash-separated part before the first part that opens with a digit, which is the version: bwa-mem2-2.3-GCC-14.3.0.eb is bwa-mem2, and GDRCopy-2.5.2-GCCcore-15.2.0.eb is GDRCopy.

fn easystack_filenames(paths: &[PathBuf]) -> Result<BTreeSet<String>>

Read easyconfig filenames from easystack files and, when path is a directory, from every easystack under it.

fn module_from_filename(filename: &str) -> Option<String>

Module string for an easyconfig filename: Name/version-toolchain.

fn run_arch_check(request: &ArchCheckRequest) -> Result<ArchCheckReport>

Check a plan against the unsupported list, and flag shared entries the architecture has never installed.

fn unproven_entries(arch: &str, shared: &[EasystackEntry], additional: &BTreeSet<String>, installed: &BTreeSet<String>) -> Vec<UnprovenFlag>

Shared-easystack entries installed has never seen on arch that additional also does not name.

installed is Name/VersionFull lines. additional is easyconfig filenames. Matching the install uses the filename’s own module string, so a different version does not count as this entry.

fn unsupported_in_plan(list: &UnsupportedList, arches: &[String], candidates: &[Candidate], starts: &[String]) -> Vec<PlanHit>

Entries in starts that this list rejects for arches, including dependencies of those entries. arches empty means every family in the list.

Structs and Unions

struct ArchCheckReport

What stack arch prints.

stdout: String

Stdout, including the count line.

parse_failed: Vec<String>

Arch-specific parse failures for easystack entries.

unsupported: Vec<String>

Unsupported-entry lines. Non-empty fails the command.

flagged: Vec<String>

Cheap-check lines. Non-empty fails the command.

source_findings: Vec<String>

Source probe findings. Non-empty fails the command.

struct ArchCheckRequest

Arguments for stack arch.

arches: Vec<String>

Architectures to check. Empty checks every family in the list.

easystacks: Vec<PathBuf>

Shared easystacks, or the plan’s easystack. Repeatable.

easyconfigs: Vec<PathBuf>

Robot trees the dependency closure is read from. Empty checks only the filenames the easystacks name.

installed: Vec<String>

path for the sole architecture, or arch=path. Repeatable.

additional: Vec<String>

path for the sole architecture, or arch=path. A directory is every easystack under it. Repeatable.

unsupported: Option<PathBuf>

Override data/arch-unsupported.toml.

source_probe: Option<SourceProbeRequest>

Optional per-architecture source probe.

struct PlanHit

One unsupported entry a plan includes or depends on.

file: String

Easyconfig filename of the unsupported entry.

arch: String

Architecture family.

reason: String

Why that architecture cannot build it.

sources: Vec<String>

Pull requests the list cites for this entry.

required_by: BTreeSet<String>

Plan entries that depend on file. Empty when the plan names file.

Implementations

impl PlanHit

Functions

fn message(&self) -> String

The line the command prints and the error repeats.

struct SourceProbeRequest

Arguments for the optional source probe of stack arch. The probe runs on the architecture families ArchCheckRequest::arches names, or on every family when that is empty.

retries: u32

Extra probe attempts after the first one.

timeout: Duration

Per-request timeout.

struct UnprovenFlag

One shared-easystack entry the cheap check flags.

file: String

Easyconfig filename.

arch: String

Architecture the check was asked about.

Implementations

impl UnprovenFlag

Functions

fn message(&self) -> String

The line the command prints.

struct UnsupportedEntry

One package an architecture cannot build.

arch: String

Architecture family, riscv64 or aarch64.

name: String

EasyBuild name, GDRCopy. Every version of that name is covered.

reason: String

Why the bot cannot build it.

sources: Vec<String>

Software-layer pull requests the entry was seeded from.

struct UnsupportedList

The unsupported list, keyed by architecture family and EasyBuild name.

Implementations

impl UnsupportedList

Functions

fn arches(&self) -> Vec<String>

Architecture families the list mentions, in order.

fn bundled() -> Result<Self>

The list shipped in data/arch-unsupported.toml.

fn get(&self, arch: &str, name: &str) -> Option<&UnsupportedEntry>

The entry for name on arch, if this architecture cannot build it.

arch may be a family (riscv64) or a target (riscv64/generic). The family is the text before the first slash.

fn load(path: &Path) -> Result<Self>

Read a list from path. An empty file is an empty list.

fn parse(text: &str) -> Result<Self>

Parse the TOML document.