Dagger
Search

version

In general, it attempts to follow go's psedudoversioning:
https://go.dev/doc/modules/version-numbers

Installation

dagger install github.com/vito/dagger/version@99c31338bf51ec2bf3c4fecca16c86bab5a6c941

Entrypoint

Return Type
Version !
Arguments
NameTypeDefault ValueDescription
gitDirectory -A git repository containing the source code of the artifact to be versioned.
inputsDirectory -A directory containing all the inputs of the artifact to be versioned. An input is any file that changes the artifact if it changes. This directory is used to compute a digest. If any input changes, the digest changes. - To avoid false positives, only include actual inputs - To avoid false negatives, include *all* inputs
nextVersionFileFile -File containing the next release version (e.g. .changes/.next)
Example
dagger -m github.com/vito/dagger/version@99c31338bf51ec2bf3c4fecca16c86bab5a6c941 call \
func (m *MyModule) Example() *dagger.Version  {
	return dag.
			Version()
}
@function
def example() -> dagger.Version:
	return (
		dag.version()
	)
@func()
example(): Version {
	return dag
		.version()
}

Types

Version 🔗

gitDir() 🔗

Return Type
Directory !
Example
dagger -m github.com/vito/dagger/version@99c31338bf51ec2bf3c4fecca16c86bab5a6c941 call \
 git-dir
func (m *MyModule) Example() *dagger.Directory  {
	return dag.
			Version().
			GitDir()
}
@function
def example() -> dagger.Directory:
	return (
		dag.version()
		.git_dir()
	)
@func()
example(): Directory {
	return dag
		.version()
		.gitDir()
}

version() 🔗

Generate a version string from the current context

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

imageTag() 🔗

Return the tag to use when auto-downloading the engine image from the CLI

Return Type
String !
Example
dagger -m github.com/vito/dagger/version@99c31338bf51ec2bf3c4fecca16c86bab5a6c941 call \
 image-tag
func (m *MyModule) Example(ctx context.Context) string  {
	return dag.
			Version().
			ImageTag(ctx)
}
@function
async def example() -> str:
	return await (
		dag.version()
		.image_tag()
	)
@func()
async example(): Promise<string> {
	return dag
		.version()
		.imageTag()
}

dirty() 🔗

Return Type
Boolean !
Example
dagger -m github.com/vito/dagger/version@99c31338bf51ec2bf3c4fecca16c86bab5a6c941 call \
 dirty
func (m *MyModule) Example(ctx context.Context) bool  {
	return dag.
			Version().
			Dirty(ctx)
}
@function
async def example() -> bool:
	return await (
		dag.version()
		.dirty()
	)
@func()
async example(): Promise<boolean> {
	return dag
		.version()
		.dirty()
}

currentTag() 🔗

Return Type
String !
Example
dagger -m github.com/vito/dagger/version@99c31338bf51ec2bf3c4fecca16c86bab5a6c941 call \
 current-tag
func (m *MyModule) Example(ctx context.Context) string  {
	return dag.
			Version().
			CurrentTag(ctx)
}
@function
async def example() -> str:
	return await (
		dag.version()
		.current_tag()
	)
@func()
async example(): Promise<string> {
	return dag
		.version()
		.currentTag()
}

nextReleaseVersion() 🔗

NextReleaseVersion returns the next release version from .changes/.next

Return Type
String !
Example
dagger -m github.com/vito/dagger/version@99c31338bf51ec2bf3c4fecca16c86bab5a6c941 call \
 next-release-version
func (m *MyModule) Example(ctx context.Context) string  {
	return dag.
			Version().
			NextReleaseVersion(ctx)
}
@function
async def example() -> str:
	return await (
		dag.version()
		.next_release_version()
	)
@func()
async example(): Promise<string> {
	return dag
		.version()
		.nextReleaseVersion()
}