bitexpert/captainhook-validateauthor

Captain Hook Plugin to check if commit author is valid (e.g. email in whitelist)

v0.8.0 2023-01-01 19:02 UTC

README

This package provides an action for Captain Hook which will reject a commit when author name or email does not match a regex defined in the captainhook.json configuration file. Use this action if you want to make sure that your private email address does not end up in your companies' git repositories.

Build Status Coverage Status Mastodon Follow

Installation

The preferred way of installing bitexpert/captainhook-validateauthor is through Composer. You can add bitexpert/captainhook-validateauthor as a dev dependency, as follows:

composer.phar require --dev bitexpert/captainhook-validateauthor

Usage

Add the following code to your captainhook.json configuration file:

{
  "pre-commit": {
    "enabled": true,
    "actions": [
      {
        "action": "\\bitExpert\\CaptainHook\\ValidateAuthor\\ValidateAuthorAction",
        "options": {
            "name": "/^[A-Za-z0-09]+$/",
            "email": "/@example.com$/"
        }
      }
    ]
  }
}

Captain Hook will now check on every commit if author name and email match the defined regex. If not, the commit will be canceled.

Contribute

Please feel free to fork and extend existing or add new features and send a pull request with your changes! To establish a consistent code quality, please provide unit tests for all your changes and adapt the documentation.

Want To Contribute?

If you feel that you have something to share, then we’d love to have you. Check out the contributing guide to find out how, as well as what we expect from you.

License

Captain Hook Validate Author Action is released under the Apache 2.0 license.