README
multi release
Cli wrapper for Semantic Release which allows forwarding additional global options. The primary target case is for managing the release process of multi / mono repos
Installation
$ npm install @codedependant/multi-release --save-dev
Expose as an npm script called release
for consistency.
// package.json
{
"name": "my-mono-repo"
, "version": "0.0.0"
, "scripts": {
"release": "multi-release"
}
}
Release Configuration
// package.json
{
"name": "my-mono-repo"
, "version": "0.0.0"
, "workspaces": ["packages/*", "services/my-service"]
, "scripts": {
"release": "multi-release"
}
, "release": {
"branches": ["master", "next"]
, "extends": "@internal/my-release-config"
, ...
}
}
Command Line Options
The following flags are passed specifically to the multi-release handler prior to execution.
Flag | Type | Description | Default |
---|---|---|---|
--sequential |
Boolean | Avoid concurrent initialization collisions by running serially | false |
--debug |
Boolean | Output debugging information | false |
--current |
Boolean | Apply commit filtering to current branch only | false |
--branches |
Boolean | The branches on which releases should happen | |
--sequential |
Boolean | Run releases sequentially rather than concurrently | false |
--dry-run |
Boolean | Runs all releases in dry run mode | false |
--ci |
Boolean | Force semantic-release to run as if it were in a CI environment |
Any and all command line options will be injected as global options to plugins through the plugin context key
options
. Additionally, the directory the command was executed from will be injected as root. This is done to compensate for the fact that semantic release sets cwd
to the directory of the package being released during execution.
Authors
- Eric Satterwhite <eric.satterwhite@logdna.com>