Package Exports

niji

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (niji) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Changelog Generator

Generate changelog using your git commit messages into a digestible change-log / release-log in markdown using the Github Comparison API, and some extremely gnarly logic.

Rules

Commit messages must adhere to the Niji Commit Format, also supports Angular Commit Message Convention.
Comparisons must be made using tags (v2.10.4) or branches (release/v2.10.4) to take advantage of version numbers.

Install

$ npm install niji -g

Usage

  Usage: niji [options]

  Options:

    -h, --help               output usage information
    -V, --version            output the version number
    -o, --out [directory]    Location of the directory to output changelog
    -r, --repo [name]        Repository name
    -u, --user [name]        Repository username
    -h, --head [name]        Commit head
    -b, --base [name]        Commit base
    -f, --format [option]    Changelog Format Type (table (default), node)
    -s, --sort [option]      Sorting option (time (default), type, scope, author)
    -t, --token [token]      Github Token
    -c, --configure [token]  Configure github token for future reference

Configuring Github Token

$ niji -c <GITHUB_TOKEN>

You can grab your Github Token here.

Note

You can specify -t <GITHUB_TOKEN> to override a configured github token or to avoid saving your github token.

Formats

Default: Table view
Node: Commit list view

Example

After installing, run the command with your desired arguments, here is an example:

$ niji \
    -r <GITHUB_PROJECT_NAME> \
    -u <GITHUB_USERNAME> \
    -h <GITHUB_HEAD_TAG_OR_BRANCH_OR_SHA> \
    -b <GITHUB_BASE_TAG_OR_BRANCH_OR_SHA>

The script will output markdown like so, which you then are free to copy / paste anywhere:

## [2beff77] | 2016-06-17
*branch:[`2beff77`](https://github.com/niji-commit/generator/tree/2beff77)*

Type | Scope | Link | Description | References | Author
--- | --- | --- | --- | --- | ---
Documentation | readme | [`2beff77a01`](https://github.com/niji-commit/generator/commit/2beff77a01d3a9f5d1f38fd3ff41cf50815dc26c) |  Fix david dependency badge |  | Nijiko Yonskai

[2beff77]: https://github.com/niji-commit/generator/compare/3bcddd9...2beff77

Here is the above markdown as a preview:

2beff77 | 2016-06-17

branch:2beff77

Type	Scope	Link	Description	References	Author
Documentation	readme	`2beff77a01`	Fix david dependency badge		Nijiko Yonskai

License

Licensed under The MIT License.