A release automation tool for gitea repos.
Go to file
Cadey Ratio e7672c694b
continuous-integration/drone/push Build is failing Details
add Creator's Code
2020-06-12 07:42:17 -04:00
nix nix/docker builds 2020-05-31 15:35:00 -04:00
src Allow users to customize the default branch name (#5) 2020-06-12 11:18:13 +00:00
testdata VERSION file parsing 2020-05-31 13:05:32 -04:00
.drone.yml Update '.drone.yml' 2020-06-12 11:27:28 +00:00
.envrc initial commit 2020-05-30 10:57:18 -04:00
.gitignore nix/docker builds 2020-05-31 15:35:00 -04:00
CHANGELOG.md Allow users to customize the default branch name (#5) 2020-06-12 11:18:13 +00:00
CODE_OF_CONDUCT.md add Creator's Code 2020-06-12 07:42:17 -04:00
Cargo.lock Allow users to customize the default branch name (#5) 2020-06-12 11:18:13 +00:00
Cargo.toml Allow users to customize the default branch name (#5) 2020-06-12 11:18:13 +00:00
LICENSE initial commit 2020-05-30 10:57:18 -04:00
README.md Allow users to customize the default branch name (#5) 2020-06-12 11:18:13 +00:00
TODO.org cmd/release: exit if the tag already exists 2020-06-05 10:50:34 -04:00
VERSION Allow users to customize the default branch name (#5) 2020-06-12 11:18:13 +00:00
default.nix nix/docker builds 2020-05-31 15:35:00 -04:00
docker.nix lol oops cacert 2020-05-31 16:00:26 -04:00
shell.nix Allow users to customize the default branch name (#5) 2020-06-12 11:18:13 +00:00

README.md

gitea-release

built with nix Build Status

A small command line tool to automate releases for Gitea repositories that reads from CHANGELOG and VERSION files. This is a clone of github-release, but more suited for my individual needs. This may also turn into a generic webhook handler, but one thing at a time. :)

Installation

With Nix

$ nix-env -if https://tulpa.dev/cadey/gitea-release/archive/master.tar.gz

With cargo

$ cargo install --git https://tulpa.dev/cadey/gitea-release.git

Drone Plugin

To use this as a drone plugin, add the following to your .drone.yml under the steps key:

- name: auto-release
  image: xena/gitea-release:0.2.7
  settings:
    auth_username: cadey
    changelog_path: ./CHANGELOG.md
    gitea_server: https://tulpa.dev
    gitea_token:
      from_secret: GITEA_TOKEN
  when:
    event:
      - push
    branch:
      - master

Replace the values of the settings as makes sense for your gitea server. The changelog_path attribute is optional, and will be ./CHANGELOG.md by default.

Note that Drone doesn't clone git tags by default. You will need to add a tag-fetching step to your Drone config until #4 is fixed. You can do that by adding this before your auto-release step:

  - name: fetch tags
    image: alpine/git
    commands:
    - git fetch --tags

CHANGELOG.md and VERSION files

The CHANGELOG.md file is based on the Keep a Changelog format, but modified slightly to make it easier for this tool. Here is an example changelog that this tool accepts:

# Changelog
All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## 0.1.0

Hi there this is a test!

### ADDED

- something

The VERSION file plays into this as well. The VERSION file MUST be a single line containing a semantic version string. When this tool is run with the release subcommand, the following actions take place:

  • The VERSION file is read and loaded as the desired tag for the repo
  • The CHANGELOG.md file is read and the changes for the VERSION are cherry-picked out of the file
  • The git repo is checked to see if that tag already exists
    • If the tag exists, the tool exits and does nothing
  • If the tag does not exist, it is created (with the changelog fragment as the body of the tag) and pushed to the gitea server
  • A gitea release is created using the changelog fragment and the release name is generated from the VERSION string