git-cliff

GitCliff is a highly customizable changelog generator.

Installation

dagger install github.com/act3-ai/dagger/git-cliff@8702497e3fc992703ce1923f5e55674b05dacf64

Entrypoint

Return Type

GitCliff !

Arguments

Name	Type	Default Value	Description
source	Directory !	-	Git repository source.
version	String	"latest"	Version (image tag) to use as a git-cliff binary source.

Example

dagger -m github.com/act3-ai/dagger/git-cliff@8702497e3fc992703ce1923f5e55674b05dacf64 call \
 --source DIR_PATH

func (m *myModule) example(source *dagger.Directory) *dagger.GitCliff  {
	return dag.
			GitCliff(source)
}

@function
def example(source: dagger.Directory, ) -> dagger.GitCliff:
	return (
		dag.git_cliff(source)
	)

@func()
example(source: Directory, ): GitCliff {
	return dag
		.gitCliff(source)
}

Types

GitCliff 🔗

container() 🔗

Return Type

Container !

Example

dagger -m github.com/act3-ai/dagger/git-cliff@8702497e3fc992703ce1923f5e55674b05dacf64 call \
 --source DIR_PATH container

func (m *myModule) example(source *dagger.Directory) *dagger.Container  {
	return dag.
			GitCliff(source).
			Container()
}

@function
def example(source: dagger.Directory, ) -> dagger.Container:
	return (
		dag.git_cliff(source)
		.container()
	)

@func()
example(source: Directory, ): Container {
	return dag
		.gitCliff(source)
		.container()
}

withEnvVariable() 🔗

WithEnvVariable adds an environment variable to the git-cliff container.

This is useful for reusability and readability by not breaking the calling chain.

Return Type

GitCliff !

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/act3-ai/dagger/git-cliff@8702497e3fc992703ce1923f5e55674b05dacf64 call \
 --source DIR_PATH with-env-variable --name string --value string

func (m *myModule) example(source *dagger.Directory, name string, value string) *dagger.GitCliff  {
	return dag.
			GitCliff(source).
			WithEnvVariable(name, value)
}

@function
def example(source: dagger.Directory, name: str, value: str) -> dagger.GitCliff:
	return (
		dag.git_cliff(source)
		.with_env_variable(name, value)
	)

@func()
example(source: Directory, name: string, value: string): GitCliff {
	return dag
		.gitCliff(source)
		.withEnvVariable(name, value)
}

withSecretVariable() 🔗

WithSecretVariable adds an env variable containing a secret to the git-cliff container.

This is useful for reusability and readability by not breaking the calling chain.

Return Type

GitCliff !

Arguments

Name	Type	Default Value	Description
name	String !	-	The name of the environment variable containing a secret (e.g., "PASSWORD").
secret	Secret !	-	The value of the environment variable containing a secret.

Example

dagger -m github.com/act3-ai/dagger/git-cliff@8702497e3fc992703ce1923f5e55674b05dacf64 call \
 --source DIR_PATH with-secret-variable --name string --secret env:MYSECRET

func (m *myModule) example(source *dagger.Directory, name string, secret *dagger.Secret) *dagger.GitCliff  {
	return dag.
			GitCliff(source).
			WithSecretVariable(name, secret)
}

@function
def example(source: dagger.Directory, name: str, secret: dagger.Secret) -> dagger.GitCliff:
	return (
		dag.git_cliff(source)
		.with_secret_variable(name, secret)
	)

@func()
example(source: Directory, name: string, secret: Secret): GitCliff {
	return dag
		.gitCliff(source)
		.withSecretVariable(name, secret)
}

withNetrc() 🔗

Add netrc credentials.

Return Type

GitCliff !

Arguments

Name	Type	Default Value	Description
netrc	Secret !	-	NETRC credentials

Example

dagger -m github.com/act3-ai/dagger/git-cliff@8702497e3fc992703ce1923f5e55674b05dacf64 call \
 --source DIR_PATH with-netrc --netrc env:MYSECRET

func (m *myModule) example(source *dagger.Directory, netrc *dagger.Secret) *dagger.GitCliff  {
	return dag.
			GitCliff(source).
			WithNetrc(netrc)
}

@function
def example(source: dagger.Directory, netrc: dagger.Secret) -> dagger.GitCliff:
	return (
		dag.git_cliff(source)
		.with_netrc(netrc)
	)

@func()
example(source: Directory, netrc: Secret): GitCliff {
	return dag
		.gitCliff(source)
		.withNetrc(netrc)
}

withConfig() 🔗

Sets the configuration file.

e.g. git-cliff --config <config>.

Return Type

GitCliff !

Arguments

Name	Type	Default Value	Description
config	File !	-	git-cliff configuration file, i.e. cliff.toml.

Example

dagger -m github.com/act3-ai/dagger/git-cliff@8702497e3fc992703ce1923f5e55674b05dacf64 call \
 --source DIR_PATH with-config --config file:path

func (m *myModule) example(source *dagger.Directory, config *dagger.File) *dagger.GitCliff  {
	return dag.
			GitCliff(source).
			WithConfig(config)
}

@function
def example(source: dagger.Directory, config: dagger.File) -> dagger.GitCliff:
	return (
		dag.git_cliff(source)
		.with_config(config)
	)

@func()
example(source: Directory, config: File): GitCliff {
	return dag
		.gitCliff(source)
		.withConfig(config)
}

run() 🔗

Run git-cliff with all options previously provided.

Run MAY be used as a “catch-all” in case functions are not implemented.

Return Type

Container !

Arguments

Name	Type	Default Value	Description
args	[String ! ]	-	arguments and flags, without `git-cliff`

Example

dagger -m github.com/act3-ai/dagger/git-cliff@8702497e3fc992703ce1923f5e55674b05dacf64 call \
 --source DIR_PATH run

func (m *myModule) example(source *dagger.Directory) *dagger.Container  {
	return dag.
			GitCliff(source).
			Run()
}

@function
def example(source: dagger.Directory, ) -> dagger.Container:
	return (
		dag.git_cliff(source)
		.run()
	)

@func()
example(source: Directory, ): Container {
	return dag
		.gitCliff(source)
		.run()
}

bumpedVersion() 🔗

Prints bumped version for unreleased changes.

Return Type

String !

Example

dagger -m github.com/act3-ai/dagger/git-cliff@8702497e3fc992703ce1923f5e55674b05dacf64 call \
 --source DIR_PATH bumped-version

func (m *myModule) example(ctx context.Context, source *dagger.Directory) string  {
	return dag.
			GitCliff(source).
			BumpedVersion(ctx)
}

@function
async def example(source: dagger.Directory, ) -> str:
	return await (
		dag.git_cliff(source)
		.bumped_version()
	)

@func()
async example(source: Directory, ): Promise<string> {
	return dag
		.gitCliff(source)
		.bumpedVersion()
}

withGithubToken() 🔗

Sets the GitHub API token.

e.g. GITHUB_TOKEN=<token> git-cliff.

Return Type

GitCliff !

Arguments

Name	Type	Default Value	Description
token	Secret !	-	GitHub API token.

Example

dagger -m github.com/act3-ai/dagger/git-cliff@8702497e3fc992703ce1923f5e55674b05dacf64 call \
 --source DIR_PATH with-github-token --token env:MYSECRET

func (m *myModule) example(source *dagger.Directory, token *dagger.Secret) *dagger.GitCliff  {
	return dag.
			GitCliff(source).
			WithGithubToken(token)
}

@function
def example(source: dagger.Directory, token: dagger.Secret) -> dagger.GitCliff:
	return (
		dag.git_cliff(source)
		.with_github_token(token)
	)

@func()
example(source: Directory, token: Secret): GitCliff {
	return dag
		.gitCliff(source)
		.withGithubToken(token)
}

withGitlabToken() 🔗

Sets the GitLab API token.

e.g. GITLAB_TOKEN=<token> git-cliff.

Return Type

GitCliff !

Arguments

Name	Type	Default Value	Description
token	Secret !	-	GitLab API token.

Example

dagger -m github.com/act3-ai/dagger/git-cliff@8702497e3fc992703ce1923f5e55674b05dacf64 call \
 --source DIR_PATH with-gitlab-token --token env:MYSECRET

func (m *myModule) example(source *dagger.Directory, token *dagger.Secret) *dagger.GitCliff  {
	return dag.
			GitCliff(source).
			WithGitlabToken(token)
}

@function
def example(source: dagger.Directory, token: dagger.Secret) -> dagger.GitCliff:
	return (
		dag.git_cliff(source)
		.with_gitlab_token(token)
	)

@func()
example(source: Directory, token: Secret): GitCliff {
	return dag
		.gitCliff(source)
		.withGitlabToken(token)
}

withGiteaToken() 🔗

Sets the Gitea API token.

e.g. GITEA_TOKEN=<token> git-cliff.

Return Type

GitCliff !

Arguments

Name	Type	Default Value	Description
token	Secret !	-	Gitea API token.

Example

dagger -m github.com/act3-ai/dagger/git-cliff@8702497e3fc992703ce1923f5e55674b05dacf64 call \
 --source DIR_PATH with-gitea-token --token env:MYSECRET

func (m *myModule) example(source *dagger.Directory, token *dagger.Secret) *dagger.GitCliff  {
	return dag.
			GitCliff(source).
			WithGiteaToken(token)
}

@function
def example(source: dagger.Directory, token: dagger.Secret) -> dagger.GitCliff:
	return (
		dag.git_cliff(source)
		.with_gitea_token(token)
	)

@func()
example(source: Directory, token: Secret): GitCliff {
	return dag
		.gitCliff(source)
		.withGiteaToken(token)
}

withBump() 🔗

Bump the version for unreleased changes. Optionally with specified version.

e.g. git-cliff --bump.

Return Type

GitCliff !

Arguments

Name	Type	Default Value	Description
version	String	-	specified version

Example

dagger -m github.com/act3-ai/dagger/git-cliff@8702497e3fc992703ce1923f5e55674b05dacf64 call \
 --source DIR_PATH with-bump

func (m *myModule) example(source *dagger.Directory) *dagger.GitCliff  {
	return dag.
			GitCliff(source).
			WithBump()
}

@function
def example(source: dagger.Directory, ) -> dagger.GitCliff:
	return (
		dag.git_cliff(source)
		.with_bump()
	)

@func()
example(source: Directory, ): GitCliff {
	return dag
		.gitCliff(source)
		.withBump()
}

withLatest() 🔗

Processes the commits starting from the latest tag.

e.g. git-cliff --latest.

Return Type

GitCliff !

Example

dagger -m github.com/act3-ai/dagger/git-cliff@8702497e3fc992703ce1923f5e55674b05dacf64 call \
 --source DIR_PATH with-latest

func (m *myModule) example(source *dagger.Directory) *dagger.GitCliff  {
	return dag.
			GitCliff(source).
			WithLatest()
}

@function
def example(source: dagger.Directory, ) -> dagger.GitCliff:
	return (
		dag.git_cliff(source)
		.with_latest()
	)

@func()
example(source: Directory, ): GitCliff {
	return dag
		.gitCliff(source)
		.withLatest()
}

withCurrent() 🔗

Processes the commits that belog to the current tag.

e.g. git-cliff --current

Return Type

GitCliff !

Example

dagger -m github.com/act3-ai/dagger/git-cliff@8702497e3fc992703ce1923f5e55674b05dacf64 call \
 --source DIR_PATH with-current

func (m *myModule) example(source *dagger.Directory) *dagger.GitCliff  {
	return dag.
			GitCliff(source).
			WithCurrent()
}

@function
def example(source: dagger.Directory, ) -> dagger.GitCliff:
	return (
		dag.git_cliff(source)
		.with_current()
	)

@func()
example(source: Directory, ): GitCliff {
	return dag
		.gitCliff(source)
		.withCurrent()
}

withUnreleased() 🔗

Processes the commits that do not belog to a tag.

e.g. git-cliff --unreleased.

Return Type

GitCliff !

Example

dagger -m github.com/act3-ai/dagger/git-cliff@8702497e3fc992703ce1923f5e55674b05dacf64 call \
 --source DIR_PATH with-unreleased

func (m *myModule) example(source *dagger.Directory) *dagger.GitCliff  {
	return dag.
			GitCliff(source).
			WithUnreleased()
}

@function
def example(source: dagger.Directory, ) -> dagger.GitCliff:
	return (
		dag.git_cliff(source)
		.with_unreleased()
	)

@func()
example(source: Directory, ): GitCliff {
	return dag
		.gitCliff(source)
		.withUnreleased()
}

withTopoOrder() 🔗

Sorts the tags topologically.

e.g. git-cliff --topo-order.

Return Type

GitCliff !

Example

dagger -m github.com/act3-ai/dagger/git-cliff@8702497e3fc992703ce1923f5e55674b05dacf64 call \
 --source DIR_PATH with-topo-order

func (m *myModule) example(source *dagger.Directory) *dagger.GitCliff  {
	return dag.
			GitCliff(source).
			WithTopoOrder()
}

@function
def example(source: dagger.Directory, ) -> dagger.GitCliff:
	return (
		dag.git_cliff(source)
		.with_topo_order()
	)

@func()
example(source: Directory, ): GitCliff {
	return dag
		.gitCliff(source)
		.withTopoOrder()
}

withRepository() 🔗

Sets the git repository.

e.g. git-cliff --repository <repo>....

Return Type

GitCliff !

Arguments

Name	Type	Default Value	Description
repo	[String ! ] !	-	git repository (one or more)

Example

dagger -m github.com/act3-ai/dagger/git-cliff@8702497e3fc992703ce1923f5e55674b05dacf64 call \
 --source DIR_PATH with-repository --repo string1 --repo string2

func (m *myModule) example(source *dagger.Directory, repo []string) *dagger.GitCliff  {
	return dag.
			GitCliff(source).
			WithRepository(repo)
}

@function
def example(source: dagger.Directory, repo: List[str]) -> dagger.GitCliff:
	return (
		dag.git_cliff(source)
		.with_repository(repo)
	)

@func()
example(source: Directory, repo: string[]): GitCliff {
	return dag
		.gitCliff(source)
		.withRepository(repo)
}

withSkipCommit() 🔗

Sets comits that will be skipped in the changelog.

e.g. git-cliff --skip-commit <sha1>....

Return Type

GitCliff !

Arguments

Name	Type	Default Value	Description
sha1	[String ! ] !	-	Commits

Example

dagger -m github.com/act3-ai/dagger/git-cliff@8702497e3fc992703ce1923f5e55674b05dacf64 call \
 --source DIR_PATH with-skip-commit --sha-1 string1 --sha-1 string2

func (m *myModule) example(source *dagger.Directory, sha1 []string) *dagger.GitCliff  {
	return dag.
			GitCliff(source).
			WithSkipCommit(sha1)
}

@function
def example(source: dagger.Directory, sha1: List[str]) -> dagger.GitCliff:
	return (
		dag.git_cliff(source)
		.with_skip_commit(sha1)
	)

@func()
example(source: Directory, sha1: string[]): GitCliff {
	return dag
		.gitCliff(source)
		.withSkipCommit(sha1)
}

withPrepend() 🔗

Prepends entries to the given changelog file.

e.g. git-cliff --prepend <changelog>.

Return Type

GitCliff !

Arguments

Name	Type	Default Value	Description
changelog	String !	-	Path to changelog, relative to source git directory

Example

dagger -m github.com/act3-ai/dagger/git-cliff@8702497e3fc992703ce1923f5e55674b05dacf64 call \
 --source DIR_PATH with-prepend --changelog string

func (m *myModule) example(source *dagger.Directory, changelog string) *dagger.GitCliff  {
	return dag.
			GitCliff(source).
			WithPrepend(changelog)
}

@function
def example(source: dagger.Directory, changelog: str) -> dagger.GitCliff:
	return (
		dag.git_cliff(source)
		.with_prepend(changelog)
	)

@func()
example(source: Directory, changelog: string): GitCliff {
	return dag
		.gitCliff(source)
		.withPrepend(changelog)
}

withOutput() 🔗

Writes output to the fiven file.

e.g. git-cliff --output <path>.

Return Type

GitCliff !

Arguments

Name	Type	Default Value	Description
path	String !	-	Write output to file, relative to source git directory.

Example

dagger -m github.com/act3-ai/dagger/git-cliff@8702497e3fc992703ce1923f5e55674b05dacf64 call \
 --source DIR_PATH with-output --path string

func (m *myModule) example(source *dagger.Directory, path string) *dagger.GitCliff  {
	return dag.
			GitCliff(source).
			WithOutput(path)
}

@function
def example(source: dagger.Directory, path: str) -> dagger.GitCliff:
	return (
		dag.git_cliff(source)
		.with_output(path)
	)

@func()
example(source: Directory, path: string): GitCliff {
	return dag
		.gitCliff(source)
		.withOutput(path)
}

withStrip() 🔗

Strips the given parts from the changelog.

e.g. git-cliff --strip <part>.

Return Type

GitCliff !

Arguments

Name	Type	Default Value	Description
part	String !	-	Part of changelog to strip. Possible values: header, footer, all.

Example

dagger -m github.com/act3-ai/dagger/git-cliff@8702497e3fc992703ce1923f5e55674b05dacf64 call \
 --source DIR_PATH with-strip --part string

func (m *myModule) example(source *dagger.Directory, part string) *dagger.GitCliff  {
	return dag.
			GitCliff(source).
			WithStrip(part)
}

@function
def example(source: dagger.Directory, part: str) -> dagger.GitCliff:
	return (
		dag.git_cliff(source)
		.with_strip(part)
	)

@func()
example(source: Directory, part: string): GitCliff {
	return dag
		.gitCliff(source)
		.withStrip(part)
}