Skip to contents

Does the installed 'fresh' provide what the pipeline calls?

Source: R/lnk_preflight_fresh.R
lnk_preflight_fresh.Rd

link calls fresh:: in a dozen places with no requireNamespace() guard, including a default argument on an exported function (lnk_wsg_downstream_check(), whose outlets defaults to fresh::frs_wsg_outlets()). A fresh that is merely present is therefore not enough — it has to export the symbols.

Usage

lnk_preflight_fresh(
  required = .lnk_fresh_required(),
  required_internal = .lnk_fresh_required_internal(),
  min_version = .lnk_fresh_floor(),
  quiet = FALSE
)

Arguments

required

Character vector of fresh exports the pipeline cannot run without. Defaults to the curated list in .lnk_fresh_required().

required_internal

Character vector of non-exported fresh objects reached via utils::getFromNamespace().

min_version

Minimum acceptable fresh version. Defaults to the floor declared in link's own DESCRIPTION, so the pin lives in one place.

quiet

Suppress the human-readable report. The report is the point on a cypher, where the log is all the operator gets.

Value

Invisibly, a list with ok, version, version_ok, missing, missing_internal and message.

Details

On the cypher droplets the installed version is whatever was baked into the machine image, and the failure mode is silent: wsg_run_one.R catches the missing-symbol error and quit(status = 1)s, the bucket loop logs [WARN] and continues, the host exits 0, and the watershed groups are simply absent from the persist. Nothing downstream can tell "not modelled" from "modelled empty". That is the 2026-08 failure this exists to stop (link#246).

Symbols are checked rather than a version string because a version is a proxy that fails in both directions: it can read 0.33.0 on a partial install or against a shadowing library path, and it can read "wrong" while every needed symbol is present. Loading the namespace also exercises fresh's own Imports resolution, which reading a DESCRIPTION off disk does not.

See also

Other preflight: lnk_fanout_judge(), lnk_preflight_parity(), lnk_preflight_stamp(), lnk_preflight_vintage()

Examples

res <- lnk_preflight_fresh(quiet = TRUE)
res$ok
#> [1] TRUE
res$version
#> [1] "0.33.0"

# A symbol fresh does not export fails, and is named in the report:
bad <- lnk_preflight_fresh(required = "frs_not_a_real_export", quiet = TRUE)
bad$missing
#> [1] "frs_not_a_real_export"