dlvr

DLVR

DeLiVeR - Command Line Tool to automate releasing processes on GitHub/GitLab/npm

Install

npm install -g dlvr

Commands

Secrets Setup

dlvr secrets Opens a wizard which guides you through the configuration of a dotenv file which contains your secrets (webhooks and tokens)

Or define this ENV vars globally

DLVR_GITHUB
DLVR_SNYK
DLVR_GITLAB
DLVR_GITLAB_API
DLVR_SLACK_WEBHOOK

Write initial config

dlvr init [github|gitlab] Opens a Wizard which guides you through the release configuration ($PROJECT_ROOT/.dlvr), uses examplepaths for compress and release-assets.

Check, edit and get current Changelog

dlvr status

• Checks integrity of .dlvr config

• Checks if necessary secrets exist based on .dlvr configuration

• Warns you if you have changes in your branch

• Prints out current filtered Changelog

  • optional arguments:
    • -e [--edit] | Edit the current Changelog

Edited changelog generates a .changelog file in your root which gets deleted on successful release, you should add this file to your .gitignore

Release

dlvr release (major|minor|patch|auto)

• optional arguments:
  • -f [--force] | Omit the "do you want to release" prompt

Versions and Releases your Project based on your given configuration and release parameter.

If you use auto - SEMVER will be automatically determined by keywords "breaking" (x.0.0) and "feature, module or plugin" (0.x.0) in your changelog.

Config File

.dlvr

PATH: $PROJECT_DIR/.dlvr Possible Configuration

{
  "dotenv": ".env",
  "preRun": "npm run build",
  "postRun": "rm -rf ./dist",
  "snyk": true,
  "compress": [
    {
      "in": "./dist/myfile.bin",
      "out": "./dist/myfile.zip"
    }
  ],
  "logfilter": ".*#",
  "remote": "origin",
  "slack": {
    "channel": "#github",
    "icon_emoji": ":shipit:",
    "username": "dlvr.bot"
  },
  "githost": {
    "provider": "github",
    "repo": "username/repo",
    "release": {
      "draft": true,
      "assets": [
        {
          "file": "./dist/myfile.zip",
          "name": "myfile.zip"
        }
      ]
    }
  },
  "test": "npm run test",
  "npmpublish": false
}