# `go_source`

Reusable Go package sources, embedded files, data, and dependency metadata.

`go_source` performs no compilation. Connect it to `go_library`, `go_binary`,
or `go_test` through the `embed` dependency role to compile its sources into
the consuming package.

## Common Go Attributes

The following attributes are also accepted by `go_library`, `go_binary`, and
`go_test`.

| Attribute | Type | Default | Description |
| --- | --- | --- | --- |
| `module_root` | string | manifest package | Workspace-relative Go module root |
| `package`, `package_root` | string | target package | Go package pattern, with `package_root` as the Buck2-compatible alias |
| `go_work` | string | empty | Workspace-relative `go.work` file, otherwise `GOWORK=off` |
| `mod_mode` | string | `vendor` | `vendor` or `readonly`; external modules require the vendor mode |
| `go` | string | Go on `PATH` | Go command override |
| `goos`, `goarch` | string | host | Destination operating system and architecture |
| `cc`, `cxx` | string | host commands | C and C++ compilers used by cgo |
| `importpath`, `importmap` | string | empty | Public and compiler import identities |
| `package_name` | string | empty | Buck2-compatible public import identity |
| `importpath_aliases` | list<string> | `[]` | Bazel-compatible migration aliases |
| `embedsrcs`, `embed_srcs` | list<string> | `[]` | Files consumed by `//go:embed`, with Bazel and Buck2 spellings |
| `headers` | list<string> | `[]` | Buck2-compatible cgo header inputs |
| `header_namespace` | string | empty | Buck2-compatible logical header namespace retained during migration |
| `data`, `resources` | list<string> | `[]` | Runtime data globs and their Buck2-compatible spelling |
| `gc_goopts`, `compiler_flags` | list<string> | `[]` | Go compiler options using Bazel or Buck2 spelling |
| `assembler_flags` | list<string> | `[]` | Go assembler options |
| `tags`, `gotags`, `build_tags` | list<string> | `[]` | Go build constraint tags |
| `cgo` | bool | `false` | Enable cgo |
| `pure` | string | `auto` | Bazel-compatible cgo policy: `on`, `off`, or `auto` |
| `copts`, `cppopts`, `cxxopts`, `clinkopts` | list<string> | `[]` | Native compile, preprocessing, and link options propagated through cgo |
| `env` | map<string, string> | `{}` | Environment passed to Go build actions |
| `trimpath` | bool | `true` | Remove host paths from compiled artifacts |
| `race` | string | `auto` | Race detector mode: `auto`, `on`, or `off` |
| `msan`, `asan` | string | `auto` | Memory or address sanitizer mode: `auto`, `on`, or `off` |
| `pgoprofile` | string | empty | Package-relative profile for profile-guided optimization |
| `coverage`, `coverage_enabled` | bool | `false` | Enable coverage instrumentation |
| `coverage_mode` | string | empty | Coverage mode: `set`, `count`, or `atomic` |

## Dependency Edges

| Edge | Accepts | Description |
| --- | --- | --- |
| `deps` | `go_package`, `go_dependency_set`, `c_provider` | Go packages, locked modules, and native providers |
| `embed` | `go_package` | Sources compiled into the same Go package |
| `cdeps` | `c_provider` | Native dependencies consumed through cgo |

## Providers and Capabilities

The target emits `go_package` and exposes `build` with no output group.