leviy/release-tool

Command line tool for releasing new versions of a project

, _(*1)

Release Tool

Inspired by Liip RMT, this release tool helps you to automate the release of new versions of your software. It is written in PHP but can be used for any type of project, as long as you have PHP installed on your machine., _(*2)

, _(*3)

Features

• Determines the next version number based on semantic versioning
• Creates an annotated Git tag and pushes it to the remote repository
• Creates a GitHub release with the name of the release and a changelog with changes since the previous version
• Supports pre-release (alpha/beta/rc) versions

Installation

Phar (recommended)

The recommended method of installing this package is using a phar file. This is because installing using Composer can possibly cause dependency conflicts. You can download the most recent phar from the Github Releases page., _(*4)

Global installation (linux)

Move the downloaded release-tool.phar file into your PATH (e.g. ~/bin/release-tool). Make sure to set the file to executable permissions (e.g. chmod 775 release-tool)., _(*5)

Composer

Alternatively, you can install this package using Composer:, _(*6)

composer require --dev leviy/release-tool

Configuration

GitHub personal access token

This tool requires a personal access token with repo scope to create GitHub releases. Create one here and store it in .release-tool/auth.yml in your home folder (~ on Linux, user folder on Windows):, _(*7)

credentials:
  github:
    token: <token>

Usage

Note: these usage instructions assume that you have downloaded the release-tool.phar file to your project directory. If you have installed it in a different location, update the commands accordingly. If you have installed the tool as a Composer dependency, use vendor/bin/release instead., _(*8)

Releasing a new version

Use release-tool.phar release <version> to release a version. For example:, _(*9)

release-tool.phar release 1.0.0

This will release version 1.0.0. By default, this will create a prefixed, annotated Git tag, in this case v1.0.0., _(*10)

Automatically generating a version number

After tagging a first version, you can let the tool calculate the new version number for you based on the current version and a number of questions. To do so, omit the version from the previous command:, _(*11)

release-tool.phar release

Pre-release versions

If you want to create a pre-release (alpha/beta/rc) version, run:, _(*12)

release-tool.phar release --pre-release

Other commands

Run release-tool.phar list to see a list of available commands., _(*13)

Updating the release tool

The following command will update the release tool to the latest version:, _(*14)

release-tool.phar self-update