parse-commit-message

An extensible parser for commit message that follows Conventional Commits v1 spec

You might also be interested in hela or in the other related projects.

Quality Assurance 💯

If you have any how-to kind of questions, please read Code of Conduct and join the chat rooms or open an issue.
You may also read the Contributing Guide. There, beside "How to contribute?", we describe everything stated by the badges.

Table of Contents

• Install
• API
• Related Projects
• Contributing
• Contributors
• Users
• License

(TOC generated by verb using markdown-toc)

Install

This project requires Node.js v8 or above. Install it using yarn v1 or above / npm v5 or above.

$ yarn add parse-commit-message

API

Review carefully the provided examples and the working tests.

const { parse } = require('parse-commit-message');

const commitMsg1 = `feat(ng-list): Allow custom separator
bla bla bla

BREAKING CHANGE: some breaking change.
Thanks @foobar
`;

const commit = parse(commitMsg1);
console.log(commit);
// => { type: 'feat',
//   scope: 'ng-list',
//   subject: 'Allow custom separator',
//   header: 'feat(ng-list): Allow custom separator',
//   body: 'bla bla bla',
//   footer: 'BREAKING CHANGE: some breaking change.\nThanks @stevemao' }

back to top

Related Projects

Some of these projects are used here or were inspiration for this one, others are just related. So, thanks for your existance!

• dush: Microscopic & functional event emitter in ~350 bytes, extensible through plugins | homepage
• execa: A better child_process | homepage
• gitcommit: Simple, small and stable helper & prompter for submitting conventional commits | homepage
• hela: Powerful & flexible task runner framework in 80 lines, based on [execa… more | homepage
• mri: Quickly scan for CLI flags and arguments | homepage
• p-map-series: Map over promises serially | homepage
• parse-git-log: Parse a git log output of a repository into an object with… more | homepage

back to top

Contributing

Please read the Contributing Guide and Code of Conduct documents for advices.
For bugs reports and feature requests, please create an issue or join us at our Flock chat rooms.

Contributors

Thanks to the hard work of these wonderful people this project is alive and it also follows the all-contributors specification.
Pull requests, stars and all kind of contributions are always welcome.

Users

You can see who uses parse-commit-message in the USERS.md file. Please feel free adding this file if it not exists.
If you or your organization are using this project, consider adding yourself to the list of users. Thank You!

License

Copyright (c) 2017-present, Charlike Mike Reagent <olsten.larck@gmail.com>.
Released under the Apache-2.0 License.

---

This file was generated by verb-generate-readme, v0.6.0, on November 24, 2017.
Project scaffolded and managed with hela.