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

pinstall

package module

Go to main page

Versions in this module

v1

v1.0.2

Jul 30, 2026

v1.0.1

Jul 29, 2026

v1.0.0

Jul 29, 2026

Changes in this version

+ var ErrDigestMismatch = errors.New("archive SHA-256 mismatch")

+ var ErrNoVersion = errors.New("no complete version is installed")

+ var ErrUnsupportedArch = errors.New("unsupported architecture")

+ var ErrVersionMismatch = errors.New("binary reported a version its install directory does not claim")

+ func LastFieldOfFirstLine(out string) string

+ func UnpackZip(ctx context.Context, archive, dir string) error

+ type ArchiveInstaller struct

+ Args []string

+ HomeEnv string

+ Path string

+ Timeout time.Duration

+ type Assertion struct

+ Args []string

+ Name string

+ Required bool

+ type Config struct

+ Assert []Assertion

+ Digests map[string]string

+ GOARCH string

+ LinkDir string

+ MaxAttempts int

+ Optional []string

+ Purge *Purge

+ Release Release

+ Require []string

+ Retain int

+ RetryBackoff time.Duration

+ Root string

+ URLTemplate string

+ Untrusted bool

+ Version string

+ type Manager struct

+ func New(cfg *Config) (*Manager, error)

+ func (m *Manager) Active() (State, bool)

+ func (m *Manager) Ensure(ctx context.Context) error

+ func (m *Manager) EnsureWithRetry(ctx context.Context) error

+ func (m *Manager) Path() string

+ func (m *Manager) PathEntry() string

+ func (m *Manager) Ready() (ready bool, why Reason)

+ func (m *Manager) Rescan(ctx context.Context) (bool, error)

+ type Purge struct

+ Artifacts []string

+ Marker string

+ Names []string

+ StagePrefix string

+ type Reason uint8

+ const ReasonAssertion

+ const ReasonInstalling

+ const ReasonReady

+ const ReasonRetrying

+ const ReasonUnavailable

+ func (r Reason) String() string

+ type Release struct

+ ArchTokens map[string]string

+ ArtifactDir string

+ Binary string

+ Installer *ArchiveInstaller

+ Mandatory []Assertion

+ Name string

+ Notice string

+ ParseVersion func(out string) string

+ ProbeArgs []string

+ URLTemplate string

+ Unpack Unpacker

+ type State struct

+ ActiveVersion string

+ AssertionsOK bool

+ Dir string

+ LastError string

+ Pinned string

+ UpdatedAt time.Time

+ type Unpacker func(ctx context.Context, archive, dir string) error