Gitea Branch

“branch” defines the name of the branch to check.

compatible:

• condition

default: the output of the associated source.

example:

• branch: main

“owner” defines the owner of the Gitea repository.

compatible:

• source
• condition

example:

• owner: updatecli

“repository” defines the name of the Gitea repository for a specific owner.

compatible:

• source
• condition

example:

• repository: updatecli

“token” defines the credential used to authenticate with the Gitea API.

remark:

• a token is sensitive information. Do not set it directly in the manifest. Use an environment variable or a SOPS file instead.
• {{ requiredEnv "GITEA_TOKEN" }} retrieves the token from the environment variable “GITEA_TOKEN”.
• {{ .gitea.token }} retrieves the token from a SOPS file. See https://github.com/getsops/sops for more information about SOPS files.
• in a “gitea/pullrequest” action, the value is inherited from the scm when unset.

“url” defines the Gitea url to interact with.

remark:

• “https://” is added when the url has no “https://” or “http://” prefix.
• in a “gitea/pullrequest” action, the value is inherited from the scm when unset.

example:

• url: gitea.com
• url: https://gitea.example.com

“username” defines the username used to authenticate with the Gitea API.

remark:

• in a “gitea/pullrequest” action, the value is inherited from the scm when unset.

“versionfilter” defines the version pattern and kind used to select a branch.

compatible:

• source

default: kind: latest

remark:

• accepted kinds include “latest”, “semver” and “regex”.

example:

• versionfilter: kind: semver pattern: “~1.2”

“kind” defines the versioning scheme used to select a version.

default: latest

remark:

• accepted values are “latest”, “semver”, “regex”, “regex/semver”, “time”, “regex/time”, “lex” and “pep440”.
• “latest” returns the last version of the list.
• “lex” sorts the versions lexicographically and returns the last one.
• “pep440” follows https://peps.python.org/pep-0440/

example:

• kind: semver

“pattern” defines the version pattern, according to “kind”.

default:

• latest: “latest”
• semver and pep440: “*”
• regex: “.*”
• time and regex/time: “2006-01-02”

remark:

• for “latest”, “latest” returns the last version, any other value must match a version exactly.
• for “semver” and “regex/semver”, it is a semantic versioning constraint.
• for “pep440”, it is a pep440 version specifier.
• for “regex”, it is a regular expression.
• for “time” and “regex/time”, it is a Go date layout.
• ignored by “lex”.

example:

• pattern: ~1.2
• pattern: “>=1.0.0 <2.0.0”
• pattern: ^v\d+.\d+.\d+$

“regex” defines the regular expression extracting the version from each entry.

remark:

• only used by the kinds “regex/semver” and “regex/time”.
• the value of the first capture group is used as the version.

example:

• regex: ^v(\d+.\d+.\d+)$

“replaceall” applies a regular expression replacement to each version before filtering.

remark:

• only used by the kinds “regex”, “regex/semver” and “regex/time”.
• the replacement runs before “pattern” or “regex” is evaluated.

example:

replaceall:
  pattern: "_"
  replacement: "."

turns “curl-8_15_0” into “curl-8.15.0”.

“strict” enforces strict semantic versioning rules when parsing versions.

default: false

remark:

• only used by the kinds “semver” and “regex/semver”.