gotest

No long description provided.

Installation

dagger install github.com/Excoriate/daggerverse/gotest@v1.17.0

Entrypoint

Return Type

Gotest !

Arguments

Name	Type	Default Value	Description
version	String	-	version is the version of the GoReleaser to use, e.g., "v1.22.0".
image	String	-	image is the image to use as the base container.
ctr	Container	-	Ctrl is the container to use as a base container.
envVarsFromHost	String	-	EnvVarsFromHost is a list of environment variables to pass from the host to the container. Later on, in order to pass it to the container, it's going to be converted into a map.

Example

dagger -m github.com/Excoriate/daggerverse/gotest@ad19fa76c14b01850c15fbc471b1ae183154a341 call \

func (m *myModule) example() *Gotest  {
	return dag.
			Gotest()
}

@function
def example() -> dag.Gotest:
	return (
		dag.gotest()
	)

@func()
example(): Gotest {
	return dag
		.gotest()
}

Types

Gotest 🔗

Gotest is a module that provides functionality to run Go tests. The module can be used to run tests in a Go project.

src() 🔗

Src is the directory that contains all the source code, including the module directory.

Return Type

Directory !

Example

dagger -m github.com/Excoriate/daggerverse/gotest@ad19fa76c14b01850c15fbc471b1ae183154a341 call \
 src

func (m *myModule) example() *Directory  {
	return dag.
			Gotest().
			Src()
}

@function
def example() -> dagger.Directory:
	return (
		dag.gotest()
		.src()
	)

@func()
example(): Directory {
	return dag
		.gotest()
		.src()
}

ctr() 🔗

Ctr is the container to use as a base container.

Return Type

Container !

Example

dagger -m github.com/Excoriate/daggerverse/gotest@ad19fa76c14b01850c15fbc471b1ae183154a341 call \
 ctr

func (m *myModule) example() *Container  {
	return dag.
			Gotest().
			Ctr()
}

@function
def example() -> dagger.Container:
	return (
		dag.gotest()
		.ctr()
	)

@func()
example(): Container {
	return dag
		.gotest()
		.ctr()
}

base() 🔗

Base sets the base image and version, and creates the base container. The default image is “golang/alpine” and the default version is “latest”.

Return Type

Gotest !

Arguments

Name	Type	Default Value	Description
imageUrl	String !	-	No description provided

Example

dagger -m github.com/Excoriate/daggerverse/gotest@ad19fa76c14b01850c15fbc471b1ae183154a341 call \
 base --image-url string

func (m *myModule) example(imageUrl string) *Gotest  {
	return dag.
			Gotest().
			Base(imageUrl)
}

@function
def example(image_url: str) -> dag.Gotest:
	return (
		dag.gotest()
		.base(image_url)
	)

@func()
example(imageUrl: string): Gotest {
	return dag
		.gotest()
		.base(imageUrl)
}

setupGoTest() 🔗

SetupGoTest sets up the go test options, to either evaluate the container and run the test, or return the container to be evaluated later.

Return Type

Container !

Arguments

Name	Type	Default Value	Description
src	Directory !	-	The directory containing code to test.
packages	[String ! ]	-	Packages to test.
enableVerbose	Boolean	-	enableVerbose is a flag to run tests with -v.
race	Boolean	-	race is a flag to run tests with
testFlags	[String ! ]	-	Arbitrary flags to pass along to go test.
insecureRootCapabilities	Boolean	-	Whether to run tests insecurely, i.e. with special privileges.
enableNest	Boolean	-	Enable experimental Dagger nesting. It sets the ExperimentalPrivilegedNesting option in Dagger.
enableCache	Boolean	-	enableCache is a flag to enable cache volumes. If it's set, it'll enable the cache volumes for the Go module and build cache.
envVars	[String ! ]	-	envVars is a list of environment variables with the format "SOMETHING=SOMETHING,SOMETHING=SOMETHING".
printEnvVars	Boolean	-	printEnvVars is a flag to print the environment variables

Example

dagger -m github.com/Excoriate/daggerverse/gotest@ad19fa76c14b01850c15fbc471b1ae183154a341 call \
 setup-go-test --src DIR_PATH

func (m *myModule) example(src *Directory) *Container  {
	return dag.
			Gotest().
			SetupGoTest(src)
}

@function
def example(src: dagger.Directory) -> dagger.Container:
	return (
		dag.gotest()
		.setup_go_test(src)
	)

@func()
example(src: Directory): Container {
	return dag
		.gotest()
		.setupGoTest(src)
}

setupGoTestSum() 🔗

SetupGoTestSum sets up the go test options, to either evaluate the container and run the test, or return the container to be evaluated later.

Return Type

Container !

Arguments

Name	Type	Default Value	Description
src	Directory !	-	The directory containing code to test.
packages	[String ! ]	-	Packages to test.
testFlags	[String ! ]	-	Arbitrary flags to pass along to go test.
goTestSumFlags	[String ! ]	-	goTestSumFlags is a flag to pass along to go test -json.
format	String	-	format defines the option for the GoTestsum format to display
insecureRootCapabilities	Boolean	-	Whether to run tests insecurely, i.e. with special privileges.
enableNest	Boolean	-	Enable experimental Dagger nesting. It sets the ExperimentalPrivilegedNesting option in Dagger.
enableCache	Boolean	-	enableCache is a flag to enable cache volumes. If it's set, it'll enable the cache volumes for the Go module and build cache.
enablePretty	Boolean	-	enablePretty is a flag to enable pretty output.
envVars	[String ! ]	-	envVars is a list of environment variables to set with the format "SOMETHING=SOMETHING,SOMETHING=SOMETHING".
printEnvVars	Boolean	-	printEnvVars is a flag to print the environment variables

Example

dagger -m github.com/Excoriate/daggerverse/gotest@ad19fa76c14b01850c15fbc471b1ae183154a341 call \
 setup-go-test-sum --src DIR_PATH

func (m *myModule) example(src *Directory) *Container  {
	return dag.
			Gotest().
			SetupGoTestSum(src)
}

@function
def example(src: dagger.Directory) -> dagger.Container:
	return (
		dag.gotest()
		.setup_go_test_sum(src)
	)

@func()
example(src: Directory): Container {
	return dag
		.gotest()
		.setupGoTestSum(src)
}

withSource() 🔗

WithSource Set the source directory.

Return Type

Gotest !

Arguments

Name	Type	Default Value	Description
src	Directory !	-	Src is the directory that contains all the source code, including the module directory.
workdir	String	-	workdir is the working directory.

Example

dagger -m github.com/Excoriate/daggerverse/gotest@ad19fa76c14b01850c15fbc471b1ae183154a341 call \
 with-source --src DIR_PATH

func (m *myModule) example(src *Directory) *Gotest  {
	return dag.
			Gotest().
			WithSource(src)
}

@function
def example(src: dagger.Directory) -> dag.Gotest:
	return (
		dag.gotest()
		.with_source(src)
	)

@func()
example(src: Directory): Gotest {
	return dag
		.gotest()
		.withSource(src)
}

withPlatform() 🔗

WithPlatform Set GOOS, GOARCH and GOARM environment variables.

Return Type

Gotest !

Arguments

Name	Type	Default Value	Description
platform	Scalar !	-	Target platform in "[os]/[platform]/[version]" format (e.g., "darwin/arm64/v7", "windows/amd64", "linux/arm64").

Example

dagger -m github.com/Excoriate/daggerverse/gotest@ad19fa76c14b01850c15fbc471b1ae183154a341 call \
 with-platform

func (m *myModule) example(platform ) *Gotest  {
	return dag.
			Gotest().
			WithPlatform(platform)
}

@function
def example(platform: ) -> dag.Gotest:
	return (
		dag.gotest()
		.with_platform(platform)
	)

@func()
example(platform: ): Gotest {
	return dag
		.gotest()
		.withPlatform(platform)
}

withCgoEnabled() 🔗

WithCgoEnabled Set CGO_ENABLED environment variable to 1.

Return Type

Gotest !

Example

dagger -m github.com/Excoriate/daggerverse/gotest@ad19fa76c14b01850c15fbc471b1ae183154a341 call \
 with-cgo-enabled

func (m *myModule) example() *Gotest  {
	return dag.
			Gotest().
			WithCgoEnabled()
}

@function
def example() -> dag.Gotest:
	return (
		dag.gotest()
		.with_cgo_enabled()
	)

@func()
example(): Gotest {
	return dag
		.gotest()
		.withCgoEnabled()
}

withCgoDisabled() 🔗

WithCgoDisabled Set CGO_ENABLED environment variable to 0.

Return Type

Gotest !

Example

dagger -m github.com/Excoriate/daggerverse/gotest@ad19fa76c14b01850c15fbc471b1ae183154a341 call \
 with-cgo-disabled

func (m *myModule) example() *Gotest  {
	return dag.
			Gotest().
			WithCgoDisabled()
}

@function
def example() -> dag.Gotest:
	return (
		dag.gotest()
		.with_cgo_disabled()
	)

@func()
example(): Gotest {
	return dag
		.gotest()
		.withCgoDisabled()
}

withEnvironmentVariable() 🔗

WithEnvironmentVariable Set an environment variable.

Return Type

Gotest !

Arguments

Name	Type	Default Value	Description
name	String !	-	The name of the environment variable (e.g., "HOST").
value	String !	-	The value of the environment variable (e.g., "localhost").
expand	Boolean	-	Replace `${VAR}` or $VAR in the value according to the current environment variables defined in the container (e.g., "/opt/bin:$PATH").

Example

dagger -m github.com/Excoriate/daggerverse/gotest@ad19fa76c14b01850c15fbc471b1ae183154a341 call \
 with-environment-variable --name string --value string

func (m *myModule) example(name string, value string) *Gotest  {
	return dag.
			Gotest().
			WithEnvironmentVariable(name, value)
}

@function
def example(name: str, value: str) -> dag.Gotest:
	return (
		dag.gotest()
		.with_environment_variable(name, value)
	)

@func()
example(name: string, value: string): Gotest {
	return dag
		.gotest()
		.withEnvironmentVariable(name, value)
}

withModuleCache() 🔗

WithModuleCache sets the module cache for the Go module. The default cache volume is “godmodcache”, and the default mount path is “/go/pkg/mod”.

Return Type

Gotest !

Example

dagger -m github.com/Excoriate/daggerverse/gotest@ad19fa76c14b01850c15fbc471b1ae183154a341 call \
 with-module-cache

func (m *myModule) example() *Gotest  {
	return dag.
			Gotest().
			WithModuleCache()
}

@function
def example() -> dag.Gotest:
	return (
		dag.gotest()
		.with_module_cache()
	)

@func()
example(): Gotest {
	return dag
		.gotest()
		.withModuleCache()
}

withBuildCache() 🔗

WithBuildCache sets the build cache for the Go module. The default cache volume is “gobuildcache”, and the default mount path is “/go/build-cache”.

Return Type

Gotest !

Example

dagger -m github.com/Excoriate/daggerverse/gotest@ad19fa76c14b01850c15fbc471b1ae183154a341 call \
 with-build-cache

func (m *myModule) example() *Gotest  {
	return dag.
			Gotest().
			WithBuildCache()
}

@function
def example() -> dag.Gotest:
	return (
		dag.gotest()
		.with_build_cache()
	)

@func()
example(): Gotest {
	return dag
		.gotest()
		.withBuildCache()
}

withGoCache() 🔗

WithGoCache mounts the Go cache directories.

Return Type

Gotest !

Example

dagger -m github.com/Excoriate/daggerverse/gotest@ad19fa76c14b01850c15fbc471b1ae183154a341 call \
 with-go-cache

func (m *myModule) example() *Gotest  {
	return dag.
			Gotest().
			WithGoCache()
}

@function
def example() -> dag.Gotest:
	return (
		dag.gotest()
		.with_go_cache()
	)

@func()
example(): Gotest {
	return dag
		.gotest()
		.withGoCache()
}

withNewNetrcFileGitHub() 🔗

WithNewNetrcFileGitHub creates a new .netrc file with the GitHub credentials.

The .netrc file is created in the root directory of the container.

Return Type

Gotest !

Arguments

Name	Type	Default Value	Description
username	String !	-	No description provided
password	String !	-	No description provided

Example

dagger -m github.com/Excoriate/daggerverse/gotest@ad19fa76c14b01850c15fbc471b1ae183154a341 call \
 with-new-netrc-file-git-hub --username string --password string

func (m *myModule) example(username string, password string) *Gotest  {
	return dag.
			Gotest().
			WithNewNetrcFileGitHub(username, password)
}

@function
def example(username: str, password: str) -> dag.Gotest:
	return (
		dag.gotest()
		.with_new_netrc_file_git_hub(username, password)
	)

@func()
example(username: string, password: string): Gotest {
	return dag
		.gotest()
		.withNewNetrcFileGitHub(username, password)
}

withNewNetrcFileGitLab() 🔗

WithNewNetrcFileGitLab creates a new .netrc file with the GitLab credentials.

The .netrc file is created in the root directory of the container.

Return Type

Gotest !

Arguments

Name	Type	Default Value	Description
username	String !	-	No description provided
password	String !	-	No description provided

Example

dagger -m github.com/Excoriate/daggerverse/gotest@ad19fa76c14b01850c15fbc471b1ae183154a341 call \
 with-new-netrc-file-git-lab --username string --password string

func (m *myModule) example(username string, password string) *Gotest  {
	return dag.
			Gotest().
			WithNewNetrcFileGitLab(username, password)
}

@function
def example(username: str, password: str) -> dag.Gotest:
	return (
		dag.gotest()
		.with_new_netrc_file_git_lab(username, password)
	)

@func()
example(username: string, password: string): Gotest {
	return dag
		.gotest()
		.withNewNetrcFileGitLab(username, password)
}

withPrivateGoPkg() 🔗

WithPrivateGoPkg sets the GOPRIVATE environment variable.

Return Type

Gotest !

Arguments

Name	Type	Default Value	Description
privateHost	String !	-	No description provided

Example

dagger -m github.com/Excoriate/daggerverse/gotest@ad19fa76c14b01850c15fbc471b1ae183154a341 call \
 with-private-go-pkg --private-host string

func (m *myModule) example(privateHost string) *Gotest  {
	return dag.
			Gotest().
			WithPrivateGoPkg(privateHost)
}

@function
def example(private_host: str) -> dag.Gotest:
	return (
		dag.gotest()
		.with_private_go_pkg(private_host)
	)

@func()
example(privateHost: string): Gotest {
	return dag
		.gotest()
		.withPrivateGoPkg(privateHost)
}

withGcccompiler() 🔗

WithGCCCompiler installs the GCC compiler and musl-dev package.

Return Type

Gotest !

Example

dagger -m github.com/Excoriate/daggerverse/gotest@ad19fa76c14b01850c15fbc471b1ae183154a341 call \
 with-gcccompiler

func (m *myModule) example() *Gotest  {
	return dag.
			Gotest().
			WithGcccompiler()
}

@function
def example() -> dag.Gotest:
	return (
		dag.gotest()
		.with_gcccompiler()
	)

@func()
example(): Gotest {
	return dag
		.gotest()
		.withGcccompiler()
}

withGoTestSum() 🔗

WithGoTestSum installs the gotestsum CLI.

Return Type

Gotest !

Example

dagger -m github.com/Excoriate/daggerverse/gotest@ad19fa76c14b01850c15fbc471b1ae183154a341 call \
 with-go-test-sum

func (m *myModule) example() *Gotest  {
	return dag.
			Gotest().
			WithGoTestSum()
}

@function
def example() -> dag.Gotest:
	return (
		dag.gotest()
		.with_go_test_sum()
	)

@func()
example(): Gotest {
	return dag
		.gotest()
		.withGoTestSum()
}

runGoTest() 🔗

RunGoTest runs tests using the go test CLI. The default packages to test are “./…”.

Return Type

String !

Arguments

Name	Type	Default Value	Description
src	Directory !	-	The directory containing code to test.
packages	[String ! ]	-	Packages to test.
enableVerbose	Boolean	-	enableVerbose is a flag to run tests with -v.
race	Boolean	-	race is a flag to run tests with
testFlags	[String ! ]	-	Arbitrary flags to pass along to go test.
insecureRootCapabilities	Boolean	-	Whether to run tests insecurely, i.e. with special privileges.
nest	Boolean	-	Enable experimental Dagger nesting.
enableCache	Boolean	-	enableCache is a flag to enable cache volumes.
envVars	[String ! ]	-	No description provided
printEnvVars	Boolean	-	printEnvVars is a flag to print the environment variables

Example

dagger -m github.com/Excoriate/daggerverse/gotest@ad19fa76c14b01850c15fbc471b1ae183154a341 call \
 run-go-test --src DIR_PATH

func (m *myModule) example(ctx context.Context, src *Directory) string  {
	return dag.
			Gotest().
			RunGoTest(ctx, src)
}

@function
async def example(src: dagger.Directory) -> str:
	return await (
		dag.gotest()
		.run_go_test(src)
	)

@func()
async example(src: Directory): Promise<string> {
	return dag
		.gotest()
		.runGoTest(src)
}

runGoTestSum() 🔗

RunGoTestSum runs tests using the gotestsum CLI.

Return Type

String !

Arguments

Name	Type	Default Value	Description
src	Directory !	-	The directory containing code to test.
packages	[String ! ]	-	Packages to test.
testFlags	[String ! ]	-	Arbitrary flags to pass along to go test.
goTestSumFlags	[String ! ]	-	goTestSumFlags is a flag to pass along to go test -json.
format	String	-	format defines the option for the GoTestsum format to display
insecureRootCapabilities	Boolean	-	Whether to run tests insecurely, i.e. with special privileges.
enableNest	Boolean	-	Enable experimental Dagger nesting. It sets the ExperimentalPrivilegedNesting option in Dagger.
enableCache	Boolean	-	enableCache is a flag to enable cache volumes. If it's set, it'll enable the cache volumes for the Go module and build cache.
enablePretty	Boolean	-	enablePretty is a flag to enable pretty output.
envVars	[String ! ]	-	envVars list of environment variables to set in the container with format "SOMETHING=SOMETHING,SOMETHING=SOMETHING".
printEnvVars	Boolean	-	printEnvVars is a flag to print the environment variables

Example

dagger -m github.com/Excoriate/daggerverse/gotest@ad19fa76c14b01850c15fbc471b1ae183154a341 call \
 run-go-test-sum --src DIR_PATH

func (m *myModule) example(ctx context.Context, src *Directory) string  {
	return dag.
			Gotest().
			RunGoTestSum(ctx, src)
}

@function
async def example(src: dagger.Directory) -> str:
	return await (
		dag.gotest()
		.run_go_test_sum(src)
	)

@func()
async example(src: Directory): Promise<string> {
	return dag
		.gotest()
		.runGoTestSum(src)
}