Skip to main content
Version: 2.8 (deprecated)

go_mod

A first-party Go module (corresponding to a go.mod file).

Generates go_first_party_package targets for each directory from the package_sources field, and generates go_third_party_package targets based on the require directives in your go.mod.

If you have third-party packages, make sure you have an up-to-date go.sum. Run go mod tidy directly to update your go.mod and go.sum.

Backend: ``

description​

str | None
default: None

A human-readable description of the target.

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

package_sources​

Iterable[str] | None
default: ('**/*.go', '**/*.s')

What sources to generate go_first_party_package targets for.

Pants will generate one target per matching directory.

Pants does not yet support some file types like .c and .h files, along with cgo files. If you need to use these files, please open a feature request at https://github.com/pantsbuild/pants/issues/new/choose so that we know to prioritize adding support.

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.