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

builder

package

Go to main page

Versions in this module

v0

v0.51.0

Jun 30, 2026

Changes in this version

type BuildConfig

+ Dirs []string

+ DiskSize string

type Config

+ func LoadConfigFile(path string) (*Config, error)

v0.50.0

Jun 29, 2026

v0.49.0

Jun 29, 2026

Changes in this version

+ const ConfigFileName

+ const UnignoreFile

+ var DefaultIgnorePatterns = []string

+ func CacheKey(dir string, lang Lang, entrypoint string, extraFiles []string) (string, error)

+ type BuildCache struct

+ func NewBuildCache(dir string) (*BuildCache, error)

+ func (bc *BuildCache) Get(key string) (*CacheEntry, error)

+ func (bc *BuildCache) Has(key string) bool

+ func (bc *BuildCache) Store(entry CacheEntry) error

+ type BuildConfig struct

+ Args []string

+ Entrypoint string

+ Lang string

+ Run []string

+ type BuildResult struct

+ BinaryPath string

+ Entrypoint string

+ Env map[string]string

+ Packages []string

+ SourceDir string

+ type CacheEntry struct

+ ImageDigest string

+ Key string

+ Lang string

+ SourceDir string

+ type Config struct

+ Build BuildConfig

+ Env EnvConfig

+ Program ProgramConfig

+ Run RunConfig

+ Stages []StageConfig

+ func LoadConfig(dir string) (*Config, error)

+ func (c *Config) HasStages() bool

+ func (c *Config) LangHint() Lang

+ type CopyFromConfig struct

+ Dst string

+ Src string

+ Stage string

+ type Driver interface

+ Build func(ctx context.Context, dir string, opts Options) (BuildResult, error)

+ Detect func(dir string) bool

+ Lang func() Lang

+ func AvailableDrivers() []Driver

+ func GetDriver(lang Lang) (Driver, error)

+ type EnvConfig map[string]string

+ type GoDriver struct

+ func (g *GoDriver) Build(ctx context.Context, dir string, opts Options) (BuildResult, error)

+ func (g *GoDriver) Detect(dir string) bool

+ func (g *GoDriver) Lang() Lang

+ type IgnoreMatcher struct

+ func LoadIgnoreFile(dir string) (*IgnoreMatcher, error)

+ func NewIgnoreMatcher(patterns []string) *IgnoreMatcher

+ func (m *IgnoreMatcher) Match(relPath string, isDir bool) bool

+ type Lang int

+ const LangGo

+ const LangNode

+ const LangPython

+ const LangRaw

+ const LangRust

+ const LangUnknown

+ func DetectLanguage(dir string, langHint Lang) (Lang, error)

+ func ParseLang(s string) (Lang, error)

+ func (l Lang) String() string

+ type NodeDriver struct

+ func (n *NodeDriver) Build(ctx context.Context, dir string, opts Options) (BuildResult, error)

+ func (n *NodeDriver) Detect(dir string) bool

+ func (n *NodeDriver) Lang() Lang

+ type Options struct

+ BuildArgs []string

+ Entrypoint string

+ Env []string

+ Output io.Writer

+ PkgFiles []string

+ Platform Platform

+ type Platform struct

+ Arch string

+ OS string

+ func DefaultPlatform() Platform

+ func KnownPlatforms() []Platform

+ func ParsePlatform(s string) (Platform, error)

+ func (p Platform) GoCrossCompileEnv() []string

+ func (p Platform) GoEnv() (goos, goarch string)

+ func (p Platform) IsNative() bool

+ func (p Platform) RustTarget() string

+ func (p Platform) String() string

+ type ProgramConfig struct

+ Args []string

+ Path string

+ type PythonDriver struct

+ func (p *PythonDriver) Build(ctx context.Context, dir string, opts Options) (BuildResult, error)

+ func (p *PythonDriver) Detect(dir string) bool

+ func (p *PythonDriver) Lang() Lang

+ type RawDriver struct

+ func (r *RawDriver) Build(ctx context.Context, dir string, opts Options) (BuildResult, error)

+ func (r *RawDriver) Detect(dir string) bool

+ func (r *RawDriver) Lang() Lang

+ type RunConfig struct

+ CPUs int

+ Memory string

+ Ports []string

+ type RustDriver struct

+ func (r *RustDriver) Build(ctx context.Context, dir string, opts Options) (BuildResult, error)

+ func (r *RustDriver) Detect(dir string) bool

+ func (r *RustDriver) Lang() Lang

+ type StageConfig struct

+ Args []string

+ CopyFrom []CopyFromConfig

+ Entrypoint string

+ Lang string

+ Name string

v0.48.0

Jun 26, 2026