Skip to main content

version_constraint, version_overrides

Some package attributes like asset and files may be different by it's version. For example, the asset structure of golang-migrate was changed from v4.15.0. In that case, the attributes version_constraint and version_overrides are useful.

e.g.

- type: github_release
  repo_owner: golang-migrate
  repo_name: migrate
  asset: 'migrate.{{.OS}}-{{.Arch}}.tar.gz'
  description: Database migrations. CLI and Golang library
  version_constraint: 'semver("> 4.14.1")'
  version_overrides:
  - version_constraint: 'semver("<= 4.14.1")'
    files:
    - name: migrate
      src: 'migrate.{{.OS}}-{{.Arch}}'

version_constraint is expr's expression. The evaluation result must be a boolean.

Currently, the following values and functions are accessible in the expression.

  • Version: (type: string) The package version
  • SemVer: (type: string) The package version that version_prefix is trimmed from Version. For example, if Version is cli/v1.0.0 and version_prefix is cli/, then SemVer is v1.0.0
  • semver: (type: func(string) bool) Tests if the package version satisfies all the constraints. hashicorp/go-version is used
  • semverWithVersion: (type: func(constraint, version string) bool) Tests if the package version satisfies all the constraints. hashicorp/go-version is used
  • trimPrefix: (type func(s, prefix string) string) Go's strings.TrimPrefix

version_overrides​

The list of version override.

The following attributes are supported.

  • asset
  • checksum
  • complete_windows_ext
  • files
  • format_overrides
  • format
  • overrides
  • path
  • replacements
  • repo_name
  • repo_owner
  • rosetta2
  • supported_envs
  • supported_if
  • type
  • url
  • windows_ext
  • version_prefix

e.g.

  version_overrides:
  - version_constraint: 'semver("<= 4.14.1")'
    files:
    - name: migrate
      src: 'migrate.{{.OS}}-{{.Arch}}'