https://github.com/mmiller42/create-github-release
Tool for generating GitHub releases after publishing a module.
https://github.com/mmiller42/create-github-release
cli create-github-release github github-releases nodejs npm release-notes
Last synced: 3 months ago
JSON representation
Tool for generating GitHub releases after publishing a module.
- Host: GitHub
- URL: https://github.com/mmiller42/create-github-release
- Owner: mmiller42
- License: mit
- Created: 2017-09-16T02:58:58.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-04-05T14:57:52.000Z (about 7 years ago)
- Last Synced: 2025-03-11T01:09:58.477Z (3 months ago)
- Topics: cli, create-github-release, github, github-releases, nodejs, npm, release-notes
- Language: JavaScript
- Size: 207 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# create-github-release
[](https://circleci.com/gh/mmiller42/create-github-release) [](https://greenkeeper.io/)
Tool for generating GitHub releases after publishing a module.
Generates a summary of the commits and changes between the given tag and the previously released tag. The previously released tag will always be the tag with the next lesser semantic version, i.e. all tags will be sorted, then a diff will be computed between the given tag and the tag immediately behind it.
## Installation
```bash
npm install --save-dev create-github-release
```
## CLI
```
create-github-release [--config=] [--preview=true] [--overwrite=true] [...]
```
The CLI tool requires you to define a configuration file in your repository. By default, it will look for a file in your repository root called `github-release.config.js`.
You may also specify a different path by using the `--config` option.
If you provide the `--preview=true` option, the release notes will be echoed to stdout instead of saved.
If you provide the `--overwrite=true` option, it is equivalent to setting `overwrite` to true (see [Configuration](#configuration)).
### Configuration
The configuration file must export an object, which can have the following properties:
| Property | Type | Description | Default |
| --------------------- | -------- | --------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| `authenticateOptions` | object | An object defining the authentication method. [See methods](https://github.com/mikedeboer/node-github#authentication) | *Required* |
| `owner` | string | The GitHub username or organization name that owns the repository. | *Required* |
| `repo` | string | The name of the repository. | *Required* |
| `template` | string | The path to a Mustache template that will be used to generate the release notes. | [`DEFAULT_TEMPLATE`](src/defaultTemplate.md.hbs) |
| `templateProps` | object | Additional data to pass to the template renderer. | `{}` |
| `render` | function | A function to manually render the release notes, instead of using Mustache. | [`Mustache.render`](https://github.com/janl/mustache.js) |
| `showDiff` | function | A function that accepts a file object and determines whether the diff should be rendered in the template. | `() => true` |
| `apiOptions` | object | Additional options to provide the [`node-github`](https://github.com/mikedeboer/node-github) constructor. | `{}` |
| `overwrite` | boolean | If true, will overwrite existing GitHub release notes, if any. By default, the script fails if notes already exist. | `false` |
### Example
```js
// github-release.config.js
module.exports = {
authenticateOptions: {
type: 'oauth',
token: 'b5ef45e4a2c245a5a4243b2882034a9f',
},
owner: 'mmiller42',
repo: 'html-webpack-externals-plugin',
showDiff: file => file.filename !== 'package-lock.json',
}
```
```bash
$(npm bin)/create-github-release v1.2.3
```
## API
You can also use create-github-release programmatically by importing it into your application.
### Configuration
This module exports a function which accepts all the same arguments as the configuration file detailed above, in addition to the `tag` and `preview` properties:
| Property | Type | Description | Default |
| --------- | ------- | ------------------------------------------------------------------- | ---------- |
| `tag` | string | The tag to release. | *Required* |
| `preview` | boolean | If true, resolves with the release notes and does not publish them. | `false` |
### Example
```js
import createRelease from 'create-github-release'
createRelease({
authenticateOptions: {
type: 'oauth',
token: 'b5ef45e4a2c245a5a4243b2882034a9f',
},
owner: 'mmiller42',
repo: 'html-webpack-externals-plugin',
tag: 'v1.2.3',
showDiff: file => file.filename !== 'package-lock.json',
})
.then(url => console.log(url))
.catch(err => console.error(err))
```