You're Invited:Meet the Socket Team at BlackHat and DEF CON in Las Vegas, Aug 7-8.RSVP
Socket
Socket
Sign inDemoInstall

conventional-changelog-cli

Package Overview
Dependencies
Maintainers
1
Versions
67
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

Comparing version 0.0.0 to 0.0.1

CHANGELOG.md

41

package.json
{
"name": "conventional-changelog-cli",
"version": "0.0.0",
"version": "0.0.1",
"description": "Generate a changelog from git metadata",

@@ -12,30 +12,39 @@ "homepage": "https://github.com/stevemao/conventional-changelog-cli",

},
"bin": {
"conventional-changelog": "cli.js"
},
"files": [
"lib"
"cli.js"
],
"keywords": [
"cli",
"app",
"cli",
"cli-app",
"conventional-changelog",
"conventional",
"changelog",
"conventional",
"changelog",
"log"
],
"devDependencies": {
"gulp": "^3.6.0",
"gulp-eslint": "^0.8.0",
"gulp-istanbul": "^0.8.1",
"gulp-jscs": "^1.1.0",
"gulp-jshint": "^1.5.3",
"gulp-mocha": "^2.0.0",
"gulp-plumber": "^1.0.0",
"jshint-stylish": "^1.0.0",
"gulp-coveralls": "^0.1.0"
"chai": "^3.4.1",
"concat-stream": "^1.5.1",
"coveralls": "^2.11.6",
"jscs": "^2.7.0",
"jshint": "^2.8.0",
"mocha": "*",
"nyc": "^5.0.1",
"shelljs": "^0.5.3"
},
"dependencies": {
"add-stream": "^1.0.0",
"conventional-changelog": "^0.5.3",
"lodash": "^4.1.0",
"meow": "^3.7.0",
"tempfile": "^1.1.1"
},
"scripts": {
"test": "gulp"
"test": "nyc mocha --timeout 30000 && npm run-script lint",
"lint": "jshint *.js --exclude node_modules && jscs *.js",
"coveralls": "nyc report --reporter=text-lcov | coveralls"
},
"license": "MIT"
}

@@ -5,17 +5,67 @@ # conventional-changelog-cli [![NPM version][npm-image]][npm-url] [![Build Status][travis-image]][travis-url] [![Dependency Status][daviddm-image]][daviddm-url] [![Coverage percentage][coveralls-image]][coveralls-url]

## Install
## Quick start
```sh
$ npm install --save conventional-changelog-cli
$ npm install -g conventional-changelog-cli
$ cd my-project
$ conventional-changelog -p angular -i CHANGELOG.md -w
```
This will *not* overwrite any previous changelog. The above generates a changelog based on commits since the last semver tag that match the pattern of a "Feature", "Fix", "Performance Improvement" or "Breaking Changes".
## Usage
If you first time use this tool and want to generate all previous changelog, you could do
```js
var conventionalChangelogCli = require('conventional-changelog-cli');
conventionalChangelogCli('Rainbow');
```sh
$ conventional-changelog -p angular -i CHANGELOG.md -w -r 0
```
This *will* overwrite any previous changelog if exist.
All available command line parameters can be listed using [CLI](#cli) : `conventional-changelog --help`.
**Hint:** You can alias your command or add it to your package.json. EG: `"changelog": "conventional-changelog -p angular -i CHANGELOG.md -w -r 0"`.
## Recommended workflow
1. Make changes
2. Commit those changes
3. Make sure Travis turns green
4. Bump version in `package.json`
5. `conventionalChangelog`
6. Commit `package.json` and `CHANGELOG.md` files
7. Tag
8. Push
The reason why you should commit and tag after `conventionalChangelog` is that the CHANGELOG should be included in the new release, hence `gitRawCommitsOpts.from` defaults to the latest semver tag.
Please use this [gist](https://gist.github.com/stevemao/280ef22ee861323993a0) to make a release or change it to your needs.
## Example output
- https://github.com/ajoslin/conventional-changelog/blob/master/CHANGELOG.md
- https://github.com/karma-runner/karma/blob/master/CHANGELOG.md
- https://github.com/btford/grunt-conventional-changelog/blob/master/CHANGELOG.md
## Why
- Used by AngularJS and related projects.
- Ignoring reverted commits, templating with [handlebars.js](https://github.com/wycats/handlebars.js) and links to references, etc. Open an [issue](../../issues/new) if you want more reasonable features.
- Intelligently setup defaults but yet fully configurable with presets of popular projects.
- Everything internally or externally is pluggable.
- A lot of tests and actively maintained.
## Related
- [conventional-github-releaser](https://github.com/stevemao/conventional-github-releaser) - Make a new GitHub release from git metadata
- [conventional-recommended-bump](https://github.com/stevemao/conventional-recommended-bump) - Get a recommended version bump based on conventional commits
- [conventional-commits-detector](https://github.com/stevemao/conventional-commits-detector) - Detect what commit message convention your repository is using
- [commitizen](https://github.com/commitizen/cz-cli) - Simple commit conventions for internet citizens.
- [angular-precommit](https://github.com/ajoslin/angular-precommit) - Pre commit with angular conventions
## License

@@ -28,7 +78,7 @@

[npm-url]: https://npmjs.org/package/conventional-changelog-cli
[travis-image]: https://travis-ci.org//conventional-changelog-cli.svg?branch=master
[travis-url]: https://travis-ci.org//conventional-changelog-cli
[daviddm-image]: https://david-dm.org//conventional-changelog-cli.svg?theme=shields.io
[daviddm-url]: https://david-dm.org//conventional-changelog-cli
[coveralls-image]: https://coveralls.io/repos//conventional-changelog-cli/badge.svg
[coveralls-url]: https://coveralls.io/r//conventional-changelog-cli
[travis-image]: https://travis-ci.org/stevemao/conventional-changelog-cli.svg?branch=master
[travis-url]: https://travis-ci.org/stevemao/conventional-changelog-cli
[daviddm-image]: https://david-dm.org/stevemao/conventional-changelog-cli.svg?theme=shields.io
[daviddm-url]: https://david-dm.org/stevemao/conventional-changelog-cli
[coveralls-image]: https://coveralls.io/repos/stevemao/conventional-changelog-cli/badge.svg
[coveralls-url]: https://coveralls.io/r/stevemao/conventional-changelog-cli
SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc