# grunt-conventional-changelog

> Generate a changelog using conventional-changelog

Latest version **6.1.0** (published 2016-02-13) · MIT license · 0 weekly downloads

## Install

```sh
npm install grunt-conventional-changelog
pnpm add grunt-conventional-changelog
yarn add grunt-conventional-changelog
bun add grunt-conventional-changelog
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 6.1.0 |
| Published | 2016-02-13 |
| First published | 2013-04-06 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=0.10.0 |
| Dependencies | 5 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 241 |
| Author | Brian Ford |
| Maintainers | btford, andytjoslin, stevemao |
| Keywords | grunt, gruntplugin, conventional-changelog, conventional, changelog, log |

## Links

- npm: https://www.npmjs.com/package/grunt-conventional-changelog
- Repository: https://github.com/btford/grunt-conventional-changelog
- Homepage: https://github.com/btford/grunt-conventional-changelog#readme
- Issues: https://github.com/btford/grunt-conventional-changelog/issues
- npm.io page: https://npm.io/package/grunt-conventional-changelog

## Dependencies (5)

- [q](https://npm.io/package/q.md) ^1.4.1
- [plur](https://npm.io/package/plur.md) ^2.0.0
- [chalk](https://npm.io/package/chalk.md) ^1.1.0
- [concat-stream](https://npm.io/package/concat-stream.md) ^1.5.0
- [conventional-changelog](https://npm.io/package/conventional-changelog.md) ^1.1.0

## Alternatives

- [cli-color](https://npm.io/package/cli-color.md) — 3.4M weekly downloads
- [log](https://npm.io/package/log.md) — 1.3M weekly downloads
- [logstash-client](https://npm.io/package/logstash-client.md) — 4.5K weekly downloads
- [@nocobase/plugin-logger](https://npm.io/package/@nocobase/plugin-logger.md) — 2.0K weekly downloads
- [child-process-debug](https://npm.io/package/child-process-debug.md) — 695 weekly downloads

## Recent versions

- 6.1.0 (latest) — 2016-02-13
- 6.0.1 — 2016-02-11
- 6.0.0 — 2016-02-11
- 5.0.0 — 2015-09-30
- 4.1.0 — 2015-08-15
- 4.0.0 — 2015-08-09
- 3.0.0 — 2015-07-24
- 2.0.2 — 2015-07-22
- 2.0.1 — 2015-07-20
- 2.0.0 — 2015-07-20
- 1.2.2 — 2015-05-02
- 1.2.1 — 2015-04-03
- 1.2.0 — 2015-03-31
- 1.1.0 — 2014-02-11
- 1.0.0 — 2013-07-17
- … 5 more at https://npm.io/package/grunt-conventional-changelog/versions

## README

#  [![NPM version][npm-image]][npm-url] [![Build Status][travis-image]][travis-url] [![Dependency Status][daviddm-image]][daviddm-url] [![Coverage Status][coveralls-image]][coveralls-url]

> Generate a changelog using [conventional-changelog](https://github.com/ajoslin/conventional-changelog)

*Issues with the output should be reported on the `conventional-changelog` [issue tracker](https://github.com/ajoslin/conventional-changelog/issues).*


## Install

```
$ npm install --save-dev grunt-conventional-changelog
```


## Usage

```js
grunt.loadNpmTasks('grunt-conventional-changelog');

grunt.initConfig({
  conventionalChangelog: {
    options: {
      changelogOpts: {
        // conventional-changelog options go here
        preset: 'angular'
      },
      context: {
        // context goes here
      },
      gitRawCommitsOpts: {
        // git-raw-commits options go here
      },
      parserOpts: {
        // conventional-commits-parser options go here
      },
      writerOpts: {
        // conventional-changelog-writer options go here
      }
    },
    release: {
      src: 'CHANGELOG.md'
    }
  }
});

grunt.registerTask('default', ['conventionalChangelog']);
```


## API

See the [conventional-changelog](https://github.com/ajoslin/conventional-changelog) docs.

There are some changes:

### changelogOpts

#### warn

It is `grunt.verbose.writeln`.


## Edit your changelog manually

Sometimes after auto-generating the changelog you want to be able to review the generated changes or add some notes to the current release, you can polish your changelog manually without changing your workflow (you might use `grunt-release` in the workflow but need grunt to wait until you have finished polishing your changelog).

Here are some examples of how to achieve this.

```js
grunt.initConfig({

  // grunt-shell
  shell: {
    changelog: {
      options: {
        stdinRawMode: true
      },
      command: 'subl -w CHANGELOG.md',
    }
  },

  // or grunt-spawn
  spawn: {
    changelog: {
      command: 'vim',
      pattern: 'CHANGELOG.md',
      commandArgs: ['{0}'],
      opts: {
        stdio: 'inherit'
      }
    }
  },

});

...

grunt.registerTask('publish', ['conventionalChangelog', 'shell:changelog', 'release']);

// or

grunt.registerTask('publish', ['conventionalChangelog', 'spawn:changelog', 'release']);
```


## License

MIT


[npm-image]: https://badge.fury.io/js/grunt-conventional-changelog.svg
[npm-url]: https://npmjs.org/package/grunt-conventional-changelog
[travis-image]: https://travis-ci.org/btford/grunt-conventional-changelog.svg?branch=master
[travis-url]: https://travis-ci.org/btford/grunt-conventional-changelog
[daviddm-image]: https://david-dm.org/btford/grunt-conventional-changelog.svg?theme=shields.io
[daviddm-url]: https://david-dm.org/btford/grunt-conventional-changelog
[coveralls-image]: https://coveralls.io/repos/github/btford/grunt-conventional-changelog/badge.svg
[coveralls-url]: https://coveralls.io/r/btford/grunt-conventional-changelog

---
_Source: https://npm.io/package/grunt-conventional-changelog · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._