Documentation
¶
Overview ¶
Package packagesload is the single sanctioned entry point for golang.org/x/tools/go/packages.Load across GoCell tooling. It forces every caller to declare the workspace Mode explicitly, so no loader silently inherits the ambient GOWORK from the committed repo-root go.work.
WHY: PR #1554 commits a go.work (`use .`), putting `go` into workspace mode repo-wide. Most loaders analyze either the root module or an isolated standalone module (the archtest / depgraph fixtures under testdata/*, or a release-pinned per-module build) and MUST use ModeModule (GOWORK=off) — workspace mode otherwise rejects any directory whose module is not in the `use` set ("directory ... does not contain modules listed in go.work"). A future cross-module archtest loader that genuinely wants to see every member module's AST through go.work (Plan D §"Cross-Module archtest") uses ModeWorkspace. Encoding the choice as a mandatory typed parameter — rather than an ad-hoc GOWORK=off ban on every packages.Config — keeps both intents expressible and prevents silent ambient inheritance.
Enforced by archtest PACKAGES-LOAD-FUNNEL-01: packages.Load may be called directly ONLY from this package.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Load ¶
Load runs packages.Load with the GOWORK semantics dictated by mode. The caller supplies cfg (Mode/Dir/Tests/BuildFlags/Context); Load owns cfg.Env, deriving GOWORK from mode (any caller-set cfg.Env is preserved, with GOWORK=off appended last for ModeModule so it wins). This is the only place in the repo permitted to call packages.Load directly (archtest PACKAGES-LOAD-FUNNEL-01).
Types ¶
type Mode ¶
type Mode int
Mode selects the module-resolution semantics for a load.
const ( // ModeModule forces module mode by appending GOWORK=off to the environment: // the load resolves against the target directory's own go.mod, ignoring any // repo-root go.work. Required for loading standalone modules not listed in // the workspace `use` set (archtest / depgraph testdata fixtures) and for // release-pinned per-module builds. ModeModule Mode = iota // ModeWorkspace uses the ambient workspace (the repo-root go.work): the load // resolves across all `use` member modules. For loaders that genuinely need // a cross-module view. GOWORK=off is rejected fail-closed here — under it the // `go` tool silently falls back to a single-module context, dropping every // non-core member from the scan (the exact silent-coverage-loss #1555 // prevents). See [applyMode]. ModeWorkspace )
Source Files