type Build struct {// Repo is a path to the root Go module for the build.Repostring// Out is where build artifacts are written.Outstring// Verbose is whether to print all command output, rather than just failed// commands.Verbosebool// WebClientSource is a path to the source for the web client.// If non-empty, web client assets will be built.WebClientSourcestring// Tmp is a temporary directory that gets deleted when the Builder is closed.Tmpstring// Go is the path to the Go binary to use for building.Gostring// Yarn is the path to the yarn binary to use for building the web client assets.Yarnstring// Version is the version info of the build.Versionmkversion.VersionInfo// Time is the timestamp of the build.Timetime.Time// contains filtered or unexported fields}

funcNewBuild¶

func NewBuild(repo, outstring) (*Build,error)

NewBuild creates a new Build rooted at repo, and writing artifacts to out.

func (*Build)AddOnCloseFunc¶added inv1.66.0

func (b *Build) AddOnCloseFunc(f func()error)

func (*Build)Build¶

func (b *Build) Build(targets []Target) (files []string, errerror)

Build builds all targets concurrently.

func (*Build)BuildGoBinary¶

func (b *Build) BuildGoBinary(pathstring, env map[string]string) (string,error)

BuildGoBinary builds the Go binary at path and returns the path to thebinary. Builds are cached by path and env, so each build only happens onceper process execution.

func (*Build)BuildGoBinaryWithTags¶added inv1.46.0

func (b *Build) BuildGoBinaryWithTags(pathstring, env map[string]string, tags []string) (string,error)

BuildGoBinaryWithTags builds the Go binary at path and returns thepath to the binary. Builds are cached by path, env and tags, soeach build only happens once per process execution.

The passed in tags override gocross's automatic selection of buildtags, so you will have to figure out and specify all the tagsrelevant to your build.

func (*Build)BuildWebClientAssets¶added inv1.50.0

func (b *Build) BuildWebClientAssets()error

BuildWebClientAssets builds the JS and CSS assets used by the web client.If b.WebClientSource is non-empty, assets are built in a "build" sub-directory of that path.Otherwise, no assets are built.

func (*Build)Close¶

func (b *Build) Close()error

Close ends the build, cleans up temporary files,and runs any onCloseFuncs.

func (*Build)Command¶

func (b *Build) Command(dir, cmdstring, args ...string) *Command

Command prepares an exec.Cmd to run [cmd, args...] in dir.

func (*Build)Extra¶

func (b *Build) Extra(keyany, constructor func()any)any

Extra returns a value from the build's extra state, creating it if necessary.

func (*Build)GoPkg¶

func (b *Build) GoPkg(pkgstring) (string,error)

GoPkg returns the path on disk of pkg.The module of pkg must be imported in b.Repo's go.mod.

func (*Build)Once¶

func (b *Build) Once(namestring, fn func()error)error

Once runs fn if Once hasn't been called with name before.

func (*Build)TmpDir¶

func (b *Build) TmpDir()string

TmpDir creates and returns a new empty temporary directory.The caller does not need to clean up the directory after use, it will getdeleted by b.Close().

type Command struct {Cmd    *exec.CmdOutputbytes.Buffer}

func (*Command)CombinedOutput¶

func (c *Command) CombinedOutput() (string,error)

CombinedOutput is like c.Cmd.CombinedOutput, but returns the output as astring instead of a byte slice.

func (*Command)Run¶

func (c *Command) Run()error

Run is like c.Cmd.Run, but if the command fails, its output is printed toos.Stdout before returning the error.

type Memoize[Oany] struct {// contains filtered or unexported fields}

func (*Memoize[O])Do¶

func (m *Memoize[O]) Do(keyany, fnMemoizedFn[O]) (ret O, errerror)

Do runs fn and returns its result.fn is only run once per unique key. Subsequent Do calls with the same keyreturn the memoized result of the first call, even if fn is a differentfunction.

type MemoizedFn[Tany] func() (T,error)

type Signer func(io.Reader) ([]byte,error)

func (Signer)SignFile¶added inv1.50.0

func (sSigner) SignFile(filePath, sigPathstring)error

SignFile signs the file at filePath with s and writes the signature tosigPath.

type Target interface {String()stringBuild(build *Build) ([]string,error)}

funcFilterTargets¶

func FilterTargets(targets []Target, filters []string) ([]Target,error)

FilterTargets returns the subset of targets that match any of the filters.If filters is empty, returns all targets.