Skip to main content
Version: 2.10 (deprecated)

go_binary


A Go binary.

Backend: pants.backend.experimental.go


description

str | None
default: None

A human-readable description of the target.

Use ./pants list --documented :: to see all targets with descriptions.

main

str | None
default: None

Address of the go_package with the main for this binary.

If not specified, will default to the go_package for the same directory as this target's BUILD file. You should usually rely on this default.

output_path

str | None
default: None

Where the built asset should be located.

If undefined, this will use the path to the BUILD file, followed by the target name. For example, src/python/project:app would be src.python.project/app.ext.

When running ./pants package, this path will be prefixed by --distdir (e.g. dist/).

Warning: setting this value risks naming collisions with other package targets you may have.

restartable

bool
default: False

If true, runs of this target with the run goal may be interrupted and restarted when its input files change.

tags

Iterable[str] | None
default: None

Arbitrary strings to describe a target.

For example, you may tag some test targets with 'integration_test' so that you could run ./pants --tag='integration_test' test :: to only run on targets with that tag.