@saithodev/semantic-release-gitea

Publish release notes to Gitea

Usage no npm install needed!

<script type="module">
  import saithodevSemanticReleaseGitea from 'https://cdn.skypack.dev/@saithodev/semantic-release-gitea';
</script>

README

@saithodev/semantic-release-gitea

semantic-release plugin to publish a Gitea release.

Build Status semantic-release Commitizen friendly

Step Description
verifyConditions Verify the presence and the validity of the authentication (set via environment variables) and the assets option configuration.
publish Publish a Gitea release, optionally uploading file assets.
addChannel Update a Gitea release's pre-release field.

This plugin is based on the semantic-release GitHub plugin. Thanks to everyone who worked on that!

Install

$ npm install @saithodev/semantic-release-gitea -D

Usage

The plugin can be configured in the semantic-release configuration file:

{
  "plugins": [
    "@semantic-release/commit-analyzer",
    "@semantic-release/release-notes-generator",
    ["@saithodev/semantic-release-gitea", {
      "giteaUrl": "https://try.gitea.io",
      "assets": [
        {"path": "dist/asset.min.css", "label": "CSS distribution"},
        {"path": "dist/asset.min.js", "label": "JS distribution"}
      ]
    }],
  ]
}

With this example Gitea releases will be published with the file dist/asset.min.css and dist/asset.min.js.

Configuration

Gitea authentication

The Gitea authentication configuration is required and can be set via environment variables.

Create a API key token via your Gitea installation’s web interface: Settings | Applications | Generate New Token.. The token has to be made available in your CI environment via the GITEA_TOKEN environment variable. The user associated with the token must have push permission to the repository.

Environment variables

Variable Description
GITEA_TOKEN Required. The token used to authenticate with Gitea.
GITEA_URL Required. The URL to your Gitea instance.
GITEA_PREFIX The Gitea API prefix. (default: /api/v1)

Options

Option Description Default
giteaUrl The Gitea endpoint. GITEA_URL environment variable.
giteaApiPathPrefix The Gitea API prefix. GITEA_PREFIX environment variable.
assets An array of files to upload to the release. See assets. -

assets

Can be a glob or and Array of globs and Objects with the following properties:

Property Description Default
path Required. A glob to identify the files to upload. -
name The name of the downloadable file on the GitHub release. File name extracted from the path.
label Short description of the file displayed on the GitHub release. -

Each entry in the assets Array is globbed individually. A glob can be a String ("dist/**/*.js" or "dist/mylib.js") or an Array of Strings that will be globbed together (["dist/**", "!**/*.css"]).

If a directory is configured, all the files under this directory and its children will be included.

The name and label for each assets are generated with Lodash template. The following variables are available:

Parameter Description
branch The branch from which the release is done.
lastRelease Object with version, gitTag and gitHead of the last release.
nextRelease Object with version, gitTag, gitHead and notes of the release being done.
commits Array of commit Objects with hash, subject, body message and author.

Note: If a file has a match in assets it will be included even if it also has a match in .gitignore.

Note: The file types in this example are per default not allowed for release assets. Make sure to check your Gitea configuration for allowed file types (setting AttachmentAllowedTypes inside [attachment] scope).

assets examples

'dist/*.js': include all the js files in the dist directory, but not in its sub-directories.

[['dist', '!**/*.css']]: include all the files in the dist directory and its sub-directories excluding the css files.

[{path: 'dist/MyLibrary.js', label: 'MyLibrary JS distribution'}, {path: 'dist/MyLibrary.css', label: 'MyLibrary CSS distribution'}]: include the dist/MyLibrary.js and dist/MyLibrary.css files, and label them MyLibrary JS distribution and MyLibrary CSS distribution in the Gitea release.

[['dist/**/*.{js,css}', '!**/*.min.*'], {path: 'build/MyLibrary.zip', label: 'MyLibrary'}]: include all the js and css files in the dist directory and its sub-directories excluding the minified version, plus the build/MyLibrary.zip file and label it MyLibrary in the Gitea release.

[{path: 'dist/MyLibrary.js', name: 'MyLibrary-${nextRelease.gitTag}.js', label: 'MyLibrary JS (${nextRelease.gitTag}) distribution'}]: include the file dist/MyLibrary.js and upload it to the Gitea release with name MyLibrary-v1.0.0.js and label MyLibrary JS (v1.0.0) distribution which will generate the link:

[MyLibrary JS (v1.0.0) distribution](MyLibrary-v1.0.0.js)