poppins-check-commit

mary-poppins plugin for checking commit message format

Usage no npm install needed!

<script type="module">
  import poppinsCheckCommit from 'https://cdn.skypack.dev/poppins-check-commit';
</script>

README

poppins-check-commit

A Mary Poppins plugin for checking commit message format. It was designed to enforce this commit message format, but it can be used with other conventions as well. Requires the pr-checklist plugin.

Install

npm install poppins-check-commit

Configure

To use this plugin, you need to load it in your config file with couldYouPlease:

// config.js
module.exports = function (poppins) {

  poppins.config = { /*...*/ };

  // pr checklist config
  poppins.couldYouPlease('pr-checklist');
  poppins.plugins.prChecklist.greeting = 'Hello';
  poppins.plugins.prChecklist.closing = 'Farewell';

  // check commit config
  poppins.couldYouPlease('check-commit');
};

Options

Options are available on popins.plugins.checkCommit. They should be fairly self-explanatory if you read the plugin's source.

popins.plugins.checkCommit.message

String. Defaults to "PR's commit messages follow the [commit message format](https://docs.google.com/document/d/1QrDFcIiPjSLDn3EL15IJygNPiHORgU1_OOAqWjiDU5Y/edit#)"

popins.plugins.checkCommit.condition

Function. Returns promise that resolves to a bool as to whether or not the PR follows the guidelines.

popins.plugins.checkCommit.check

Function. Run on each commit to determine its validity.

License

MIT