conventional-changelog

Generate a markdown changelog from git commit metadata

Please update conventional-changelog to >1.0.0. If you are running the cli, use conventional-changelog-cli
Last updated 11 years ago by andytjoslin .
BSD · Repository · Bugs · Original npm · Tarball · package.json
$ gnpm install conventional-changelog 
SYNC missed versions from official npm registry.

NPM version Build Status Dependency Status Coverage Status

Generate a changelog from git metadata

Usage

You most likely only need to use this module if you're building a library that provides an abstraction on top of conventional commits, See Getting started if you're an end-user.

$ npm install --save conventional-changelog
var conventionalChangelog = require('conventional-changelog');

conventionalChangelog({
  preset: 'angular'
})
  .pipe(process.stdout); // or any writable stream

Or if you want to use your own custom preset:

var conventionalChangelog = require('conventional-changelog');

var config = require('@org/conventional-changelog-custom-preset');
conventionalChangelog({config})
  .pipe(process.stdout); // or any writable stream

API

conventionalChangelog([options, [context, [gitRawCommitsOpts, [parserOpts, [writerOpts]]]]])

Returns a readable stream.

options

See the conventional-changelog-core docs. The API is the same with the following changes or additions:

preset

Type: string Possible values: 'angular', 'atom', 'codemirror', 'conventionalcommits', 'ember', 'eslint', 'express', 'jquery', 'jshint'

It's recommended to use a preset so you don't have to define everything yourself. Presets are names of built-in config.

A scoped preset package such as @scope/conventional-changelog-custom-preset can be used by passing @scope/custom-preset to this option.

NOTE: options.config will be overwritten by the values of preset. You should use either preset or config, but not both.

Notes for parent modules

License

MIT

Current Tags

  • 5.1.0                                ...           latest (a year ago)
  • 3.1.24                                ...           next (4 years ago)

100 Versions

  • 5.1.0                                ...           a year ago
  • 5.0.0                                ...           a year ago
  • 4.0.0                                ...           2 years ago
  • 3.1.25                                ...           3 years ago
  • 3.1.24                                ...           4 years ago
  • 3.1.23                                ...           4 years ago
  • 3.1.22                                ...           4 years ago
  • 3.1.21                                ...           5 years ago
  • 3.1.20                                ...           5 years ago
  • 3.1.19                                ...           5 years ago
  • 3.1.18                                ...           5 years ago
  • 3.1.17                                ...           5 years ago
  • 3.1.16                                ...           5 years ago
  • 3.1.15                                ...           5 years ago
  • 3.1.14                                ...           5 years ago
  • 3.1.13                                ...           5 years ago
  • 3.1.12                                ...           5 years ago
  • 3.1.10                                ...           5 years ago
  • 3.1.9                                ...           6 years ago
  • 3.1.8                                ...           6 years ago
  • 3.1.7                                ...           6 years ago
  • 3.1.6                                ...           6 years ago
  • 3.1.5                                ...           6 years ago
  • 3.1.4                                ...           6 years ago
  • 3.1.3                                ...           6 years ago
  • 3.1.2                                ...           6 years ago
  • 3.1.1                                ...           6 years ago
  • 3.0.6                                ...           6 years ago
  • 3.0.5                                ...           6 years ago
  • 3.0.4                                ...           6 years ago
  • 3.0.3                                ...           6 years ago
  • 3.0.2                                ...           6 years ago
  • 3.0.1                                ...           6 years ago
  • 2.0.3                                ...           6 years ago
  • 2.0.2                                ...           6 years ago
  • 2.0.1                                ...           7 years ago
  • 2.0.0                                ...           7 years ago
  • 1.1.24                                ...           7 years ago
  • 1.1.23                                ...           7 years ago
  • 1.1.22                                ...           7 years ago
  • 1.1.21                                ...           7 years ago
  • 1.1.20                                ...           7 years ago
  • 1.1.19                                ...           7 years ago
  • 1.1.18                                ...           7 years ago
  • 1.1.17                                ...           7 years ago
  • 1.1.16                                ...           7 years ago
  • 1.1.15                                ...           7 years ago
  • 1.1.14                                ...           7 years ago
  • 1.1.12                                ...           7 years ago
  • 1.1.11                                ...           7 years ago
  • 1.1.10                                ...           7 years ago
  • 1.1.7                                ...           7 years ago
  • 1.1.6                                ...           7 years ago
  • 1.1.5                                ...           7 years ago
  • 1.1.4                                ...           8 years ago
  • 1.1.3                                ...           8 years ago
  • 1.1.2                                ...           8 years ago
  • 1.1.1                                ...           8 years ago
  • 1.1.0                                ...           9 years ago
  • 1.0.1                                ...           9 years ago
  • 1.0.0                                ...           9 years ago
  • 0.5.3 [deprecated]           ...           9 years ago
  • 0.5.2 [deprecated]           ...           9 years ago
  • 0.5.1 [deprecated]           ...           9 years ago
  • 0.5.0 [deprecated]           ...           9 years ago
  • 0.4.3 [deprecated]           ...           9 years ago
  • 0.4.2 [deprecated]           ...           9 years ago
  • 0.4.1 [deprecated]           ...           9 years ago
  • 0.4.0 [deprecated]           ...           9 years ago
  • 0.3.2 [deprecated]           ...           9 years ago
  • 0.3.0 [deprecated]           ...           9 years ago
  • 0.2.1 [deprecated]           ...           9 years ago
  • 0.2.0 [deprecated]           ...           9 years ago
  • 0.1.3 [deprecated]           ...           9 years ago
  • 0.1.2 [deprecated]           ...           9 years ago
  • 0.1.1 [deprecated]           ...           9 years ago
  • 0.1.0 [deprecated]           ...           9 years ago
  • 0.1.0-beta.3                                ...           9 years ago
  • 0.1.0-beta.2                                ...           9 years ago
  • 0.1.0-beta.1                                ...           9 years ago
  • 0.1.0-alpha.3                                ...           9 years ago
  • 0.1.0-alpha.2                                ...           9 years ago
  • 0.1.0-alpha.1                                ...           9 years ago
  • 0.0.17 [deprecated]           ...           10 years ago
  • 0.0.16 [deprecated]           ...           10 years ago
  • 0.0.15 [deprecated]           ...           10 years ago
  • 0.0.14 [deprecated]           ...           10 years ago
  • 0.0.13 [deprecated]           ...           10 years ago
  • 0.0.12 [deprecated]           ...           10 years ago
  • 0.0.11 [deprecated]           ...           11 years ago
  • 0.0.10 [deprecated]           ...           11 years ago
  • 0.0.9 [deprecated]           ...           11 years ago
  • 0.0.8 [deprecated]           ...           11 years ago
  • 0.0.7 [deprecated]           ...           11 years ago
  • 0.0.6 [deprecated]           ...           11 years ago
  • 0.0.5 [deprecated]           ...           11 years ago
  • 0.0.4 [deprecated]           ...           11 years ago
  • 0.0.3 [deprecated]           ...           11 years ago
  • 0.0.2 [deprecated]           ...           11 years ago
  • 0.0.1 [deprecated]           ...           11 years ago
Downloads
Today 0
This Week 0
This Month 42
Last Day 0
Last Week 42
Last Month 0
Dependencies (2)
Dev Dependencies (3)

Copyright 2013 - present © cnpmjs.org | Home |