Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

toolchain

package

Go to main page

Versions in this module

v0

v0.7.0

Jul 11, 2026

Changes in this version

+ const LockfileVersion

+ const TrustChecksum

+ const TrustPinned

+ const TrustTOFU

+ func CacheRoot() string

+ func CargoCacheDir() string

+ func CargoTargetDir(key string) string

+ func EnsureRustLlvmTools(cargoPath, version string) error

+ func FetchArtifactSHA256(tool, version string) (string, error)

+ func LockPath(rootDir string) string

+ func ResolveRustVersion(dir, repoRoot string) string

+ func SubstrateCacheDir() string

+ func TrustLabel(trust string) string

+ func WriteLock(rootDir string, l *Lock) error

+ type GoInstallSource struct

+ GoVersion string

+ Module string

+ func (s GoInstallSource) Materialize(req SourceRequest) (SourceResult, error)

+ type Lock struct

+ LockfileVersion int

+ Toolchains []LockEntry

+ func ReadLock(rootDir string) (*Lock, error)

+ func (l *Lock) Get(name string) (LockEntry, bool)

+ func (l *Lock) Resolved(name string) string

+ func (l *Lock) Set(name, resolved, sha256 string) bool

+ type LockEntry struct

+ Name string

+ Resolved string

+ SHA256 string

type Metadata

+ Trust string

type Result

+ Trust string

+ func ResolvePinned(rootDir, tool, version, sha256 string) (Result, error)

+ type SourceRequest struct

+ BinPath string

+ Def ToolDef

+ GOARCH string

+ GOOS string

+ InstallDir string

+ PinnedSHA string

+ RootDir string

+ Version string

+ type SourceResult struct

+ SHA256 string

+ SourceURL string

+ Trust string

type ToolDef

+ ReleaseSource string

+ Source ToolSource

+ func (d ToolDef) ReleaseSourceKind() string

+ type ToolSource interface

+ Materialize func(req SourceRequest) (SourceResult, error)

v0.6.1

Jun 5, 2026

Changes in this version

+ func GoCacheDirs() (gomod, gocache string)

+ func GoCacheStatus() (gomod, gocache string, warm bool)

v0.6.0

Jun 4, 2026

Changes in this version

+ func AcquireInstallLock(dir string, timeout time.Duration) (*os.File, error) — darwin/amd64, linux/amd64

+ func CacheBinPathIn(root, tool, version, binary string) string

+ func CacheDirIn(root, tool, version string) string

+ func CleanEnv() []string

+ func InstallRoot(rootDir string) string

+ func ManagedToolNames() []string

+ func MetadataPathIn(root, tool, version string) string

+ func PersistentCacheRoot() string

+ func ReadRoots(rootDir string) []string

+ func ReleaseInstallLock(f *os.File) — darwin/amd64, linux/amd64

+ func RenderPanel(w io.Writer, results []Result, cacheRoot string, elapsed fmt.Stringer)

+ func Report(w io.Writer, r Result)

+ func ResolveGoVersion(dir, repoRoot string) string

+ func ResolveVersion(tool, requestedVersion string, desired map[string]config.ToolPinConfig) (version string, isPinned bool)

+ func SeedDesired() map[string]config.ToolPinConfig

+ func StampMetadata(m *Metadata)

+ type Metadata struct

+ BinSHA256 string

+ InstalledAt string

+ InstalledBy string

+ Platform string

+ SHA256 string

+ SourceURL string

+ Tool string

+ Version string

+ type Result struct

+ BinSHA256 string

+ CacheHit bool

+ Path string

+ SHA256 string

+ SourceURL string

+ Tool string

+ Version string

+ func Resolve(rootDir, tool, version string) (Result, error)

+ type ToolDef struct

+ ArchiveStrip string

+ BinaryName string

+ ChecksumURL func(version, goos, goarch string) string

+ DefaultVer string

+ DownloadURL func(version, goos, goarch string) string

+ Format string

+ GitHubOwner string

+ GitHubRepo string

+ Name string

+ func AllTools() []ToolDef

+ func LookupTool(name string) (ToolDef, bool)