woocommerce/plugins/woocommerce-admin/bin/changelog/README.md

3.1 KiB

Changelog Script

This folder contains the logic for a changelog script that can be used for generating changelog entries from either pull requests added to a Github milestone, or pull requests that are part of a Zenhub release.

Usage:

By default, changelog entries will use the title of pull requests. However, you can also customize the changelog entry by adding to the description of the pull custom text in the following format.

### Changelog

> Fix bug in Safari and other Webkit browsers.

You can implement the script in your package.json in the simplest form by adding the following to the "scripts" property (assuming it is installed in ./bin):

{
  "scripts": {
    "changelog": "node ./bin/changelog",
  }
}

Configuration

The following configuration options can be set for the changelog script. Note: you can use all of these options but environment variables overwrite package.json config and command line arguments overwrite environment variables.

package.json configuration should be added on a top level changelog property.

The 'variable' in the following table can be used in package.json or as a cli arg.

variable description
labelPrefix Any labels prefixed with this string will be used to derive the "type" of change (defaults to type:).
skipLabel Any pull having this label will be skipped for the changelog (defaults to no-changelog).
defaultPrefix When there is no label with the labelPrefix on a pull, this is the default type that will be used for the changelog entry (defaults to dev).
changelogSrcType Either "MILESTONE" (default) or "ZENHUB_RELEASE". This determines what will serve as the source for the changelog entries.
devNoteLabel If a pull has this label then [DN] will be appended to the end of the changelog. It's a good way to indicate what entries have (or will have) dev notes.
repo This is the namespace for the github repository used as the source for pulls used in the changelog entries. Example: 'woocommerce/woocommerce-gutenberg-products-block'
ghApiToken You can pass your github api token to the script. NOTE: Strongly recommend you use environment variable for this.
zhApiKey You can pass your zenhub api key to the script using this config. NOTE: Strongly recommend you use environment variable for this.

The two environment variables you can use are:

Environment Variable Description
GH_API_TOKEN Github API token for authorizing on the github API.
ZH_API_TOKEN Zenhub api token used for authorizing against the zenhub API.

Examples:

package.json:

{
  "changelog": {
    "labelPrefix": "type:",
    "skipLabel": "skip-changelog",
    "defaultPrefix": "dev",
    "repo": "woocommerce/woocommerce-gutenberg-products-block"
  },
}

Environment Variable

GH_API_TOKEN="1343ASDFQWER13241REASD" node ./bin/changelog

Command Line

node ./bin/changelog --labelPrefix="type:" --skipLabel="skip-changelog" --defaultPrefix="dev" --repo="woocommerce/woocommerce-gutenberg-products-block" --ghApiToken="1343ASDFQWER13241REASD"