Dagger
Search

go

No long description provided.

Installation

dagger install github.com/dagger/go@b992f9c0a628db70650844c1e6070aa6d568b411

Entrypoint

Return Type
Module !
Arguments
NameTypeDefault ValueDescription
pathString !-Path of the module directory in the workspace.
versionString !-Go version to use.
sourceDirectory !-Filtered workspace source mounted for Go commands.
testdataDirectory !-Filtered test fixture files mounted only while running tests.
workdirString !-Module directory path relative to the mounted workspace boundary.
Example
Function Module.Constructor is not accessible from the go module
Function Module.Constructor is not accessible from the go module
Function Module.Constructor is not accessible from the go module
Function Module.Constructor is not accessible from the go module

Entrypoint

Return Type
Go !
Arguments
NameTypeDefault ValueDescription
versionString -Go version to use.
includeExtraFiles[String ! ] -Extra workspace files to include when running Go commands. Use this for project-specific fixtures or generated assets needed by tests.
selectModules[String ! ] -Go module path globs to include when discovering modules. When unset, every discovered module is included.
selectModuleString -Single Go module path glob to include when legacy callers cannot pass arrays. Ignored when selectModules is set.
Example
dagger -m github.com/dagger/go@b992f9c0a628db70650844c1e6070aa6d568b411 call \
func (m *MyModule) Example() *dagger.Go  {
	return dag.
			Go()
}
@function
def example() -> dagger.Go:
	return (
		dag.go()
	)
@func()
example(): Go {
	return dag
		.go()
}

Types

Module 🔗

A discovered Go module in the workspace.

path() 🔗

Path of the module directory in the workspace.

Return Type
String !
Example
echo 'Custom types are not supported in shell examples'
func (m *MyModule) Example(ctx context.Context) string  {
	return dag.
			Go().
			Module().
			Path(ctx)
}
@function
async def example() -> str:
	return await (
		dag.go()
		.module()
		.path()
	)
@func()
async example(): Promise<string> {
	return dag
		.go()
		.module()
		.path()
}

test() 🔗

Run tests in this module.

Return Type
Void !
Example
echo 'Custom types are not supported in shell examples'
func (m *MyModule) Example(ctx context.Context)   {
	return dag.
			Go().
			Module().
			Test(ctx)
}
@function
async def example() -> None:
	return await (
		dag.go()
		.module()
		.test()
	)
@func()
async example(): Promise<void> {
	return dag
		.go()
		.module()
		.test()
}

Go 🔗

A Dagger module for Go - a programming language for building simple, secure, scalable systems. https://dagger.io https://golang.org

selectModules() 🔗

Go module path globs to include when discovering modules. When unset, every discovered module is included.

Return Type
[String ! ] 
Example
dagger -m github.com/dagger/go@b992f9c0a628db70650844c1e6070aa6d568b411 call \
 select-modules
func (m *MyModule) Example(ctx context.Context) []string  {
	return dag.
			Go().
			SelectModules(ctx)
}
@function
async def example() -> List[str]:
	return await (
		dag.go()
		.select_modules()
	)
@func()
async example(): Promise<string[]> {
	return dag
		.go()
		.selectModules()
}

selectModule() 🔗

Single Go module path glob to include when legacy callers cannot pass arrays. Ignored when selectModules is set.

Return Type
String 
Example
dagger -m github.com/dagger/go@b992f9c0a628db70650844c1e6070aa6d568b411 call \
 select-module
func (m *MyModule) Example(ctx context.Context) string  {
	return dag.
			Go().
			SelectModule(ctx)
}
@function
async def example() -> str:
	return await (
		dag.go()
		.select_module()
	)
@func()
async example(): Promise<string> {
	return dag
		.go()
		.selectModule()
}

version() 🔗

Go version to use.

Return Type
String !
Example
dagger -m github.com/dagger/go@b992f9c0a628db70650844c1e6070aa6d568b411 call \
 version
func (m *MyModule) Example(ctx context.Context) string  {
	return dag.
			Go().
			Version(ctx)
}
@function
async def example() -> str:
	return await (
		dag.go()
		.version()
	)
@func()
async example(): Promise<string> {
	return dag
		.go()
		.version()
}

includeExtraFiles() 🔗

Extra workspace files to include when running Go commands. Use this for project-specific fixtures or generated assets needed by tests.

Return Type
[String ! ] !
Example
dagger -m github.com/dagger/go@b992f9c0a628db70650844c1e6070aa6d568b411 call \
 include-extra-files
func (m *MyModule) Example(ctx context.Context) []string  {
	return dag.
			Go().
			IncludeExtraFiles(ctx)
}
@function
async def example() -> List[str]:
	return await (
		dag.go()
		.include_extra_files()
	)
@func()
async example(): Promise<string[]> {
	return dag
		.go()
		.includeExtraFiles()
}

modules() 🔗

Scan the workspace for Go modules.

Return Type
[Module ! ] !
Arguments
NameTypeDefault ValueDescription
wsWorkspace -No description provided
Example
echo 'Custom types are not supported in shell examples'
func (m *MyModule) Example() []*dagger.GoModule  {
	return dag.
			Go().
			Modules()
}
@function
def example() -> List[dagger.GoModule]:
	return (
		dag.go()
		.modules()
	)
@func()
example(): GoModule[] {
	return dag
		.go()
		.modules()
}

module() 🔗

Return the selected Go module.

Return Type
Module !
Arguments
NameTypeDefault ValueDescription
wsWorkspace -No description provided
Example
echo 'Custom types are not supported in shell examples'
func (m *MyModule) Example() *dagger.GoModule  {
	return dag.
			Go().
			Module()
}
@function
def example() -> dagger.GoModule:
	return (
		dag.go()
		.module()
	)
@func()
example(): GoModule {
	return dag
		.go()
		.module()
}

check() 🔗

Run tests in every discovered Go module.

Return Type
Void !
Arguments
NameTypeDefault ValueDescription
wsWorkspace -No description provided
Example
echo 'Custom types are not supported in shell examples'
func (m *MyModule) Example(ctx context.Context)   {
	return dag.
			Go().
			Check(ctx)
}
@function
async def example() -> None:
	return await (
		dag.go()
		.check()
	)
@func()
async example(): Promise<void> {
	return dag
		.go()
		.check()
}