mod component_reach

module component_reach

Easyconfigs and installed modules that carry a component in one generation.

Names match with ASCII case folded, so curl hits cURL. A compat-layer file is an input: those rows are not easyconfigs.

Variables

const COMPONENT_REACH_SCHEMA_VERSION: u32

Schema of ReachDocument.

Version 2 adds reach: cross-user, network-facing, local-only, not-reachable, or unclassified when the built-in names do not include the component. component-reach reads no site file.

Functions

fn component_reach(query: &ReachQuery<'_>) -> ReachDocument

Find carriers in one toolchain generation.

fn cve_reach(cve: &str, components: &[ResolvedComponent], notes: &[String], unresolved: &[String], scope: &ReachScope<'_>) -> CveReachDocument

Reach of every package in one OSV resolution.

fn cve_to_toml(document: &CveReachDocument) -> Result<String, toml::ser::Error>

TOML record for a CVE reach document.

fn fetch_easystack_urls(urls: &[String], client: &dyn RegistryClient) -> Result<Vec<StackEasystack>, String>

Download easystack YAML. Anything other than https:// is refused.

fn parse_compat_layer(text: &str) -> Vec<(String, String)>

name version or name==version, one per line. # comments are skipped.

fn purl_carrier_known(kind: &str) -> bool

generic and github name easyconfigs. The language types name extensions, bundled components, crates, and wheels of that language.

fn render_cve_markdown(document: &CveReachDocument) -> String

Markdown for CveReachDocument, one section per package.

fn render_markdown(document: &ReachDocument) -> String

Markdown tables of the carriers and the closure, in the pr-overlap shape.

fn to_toml(document: &ReachDocument) -> Result<String, toml::ser::Error>

TOML record with the same generated header as pr-overlap.

Structs and Unions

struct Carrier

One easyconfig or installed module that carries the component.

role: String

module, dependency, builddependency, extension, component, crate, wheel, source, patch, compat-layer, or installed.

version: String

Version that matched.

easyconfig: String

Easyconfig filename, empty for compat-layer and installed-only rows.

module: String

Name/version-toolchain.

installed: Option<bool>

Set when an installed list was passed.

struct CveReachDocument

One CVE, and the reach of every package OSV attached to it.

schema_version: u32

COMPONENT_REACH_SCHEMA_VERSION.

kind: String

cve, so this file is not read as one component document.

cve: String

Id that was resolved.

generated_at: String

When it was computed.

generation: String

Toolchain generation.

resolved: Vec<ResolvedComponent>

Packages the record named.

results: Vec<ReachDocument>

One reach document per resolved package.

notes: Vec<String>

Alias fetches that failed, and closure notes that are not per result.

unresolved: Vec<String>

Ranges and events OSV named that this tool could not parse.

struct ReachDocument

Carriers and, once filled, the rebuild closure.

schema_version: u32

COMPONENT_REACH_SCHEMA_VERSION.

generated_at: String

When it was computed.

component: String

Name that was asked for.

version_req: String

Version requirement that was asked for.

Empty when the match is the exact Self::versions list.

version_reqs: Vec<String>

Every requirement, when more than one was OR-ed together.

versions: Vec<String>

Exact versions from a CVE record.

purl: Option<String>

Package URL, when the query was a purl or a resolved CVE.

ecosystem: Option<String>

Ecosystem, when the query named one.

generation: String

Toolchain generation.

reach: String

Reach class of the component name.

cross-user and network-facing justify a backport. local-only and not-reachable do not. unclassified means the built-in names do not include this component.

carriers: Vec<Carrier>

Who carries it.

changed: Vec<String>

Recipes that contain the component, fed to the closure.

closure_counts: RebuildCounts

Closure counts. Zero until the closure is run.

closure_rows: Vec<RebuildRow>

Closure rows.

missing: Vec<String>

Changed filenames missing from the closure graph.

closure_unresolved: Vec<String>

Requirements no recipe in the trees resolves, so the closure has no edge for them.

notes: Vec<String>

Compat-layer hits and closure notes.

struct ReachQuery<'a>

One run. version_req is an exact version, *, or a requirement.

candidates: &'a [Candidate]

Easyconfigs, later trees already preferred.

component: &'a str

Component name.

version_req: &'a str

Version, *, or a requirement such as >=8,<9.

Empty when the match is only Self::exact_versions.

also_reqs: &'a [String]

Further requirements. A version matches when any requirement matches.

exact_versions: &'a [String]

Exact versions that match even when no requirement does.

purl: Option<&'a str>

Package URL that named this component, when there was one.

ecosystem: Option<&'a str>

Ecosystem from the purl or the OSV record.

generation: &'a str

Toolchain generation, for example 2026.1.

installed: Option<&'a BTreeSet<String>>

Installed Name/version-toolchain lines.

easystacks: &'a [StackEasystack]

Deployed easystacks. Empty uses the generation as the stack.

compat: &'a [(String, String)]

Compat-layer name / version rows.

filter_deps: &'a FilterDeps

--filter-deps, applied when the closure is filled in.

generated_at: &'a str

RFC 3339 timestamp.

struct ReachScope<'a>

Shared inputs of one generation scan.

candidates: &'a [Candidate]

Easyconfigs, later trees already preferred.

generation: &'a str

Toolchain generation, for example 2026.1.

installed: Option<&'a BTreeSet<String>>

Installed Name/version-toolchain lines.

easystacks: &'a [StackEasystack]

Deployed easystacks. Empty uses the generation as the stack.

compat: &'a [(String, String)]

Compat-layer name / version rows.

filter_deps: &'a FilterDeps

--filter-deps, applied when the closure is filled in.

generated_at: &'a str

RFC 3339 timestamp.