githubwrangler

Program for managing Github repository expectations

Usage no npm install needed!

<script type="module">
  import githubwrangler from 'https://cdn.skypack.dev/githubwrangler';
</script>

README

githubwrangler

Program for managing Github repository expectations

Installation

npm install -g githubwrangler

Usage

Save a configuration file, then call githubwrangler and pass it as a parameter.

githubwrangler -f example.json

Example:

{
  org: "myorganisation",
  checks: [
    {
      type: "webhook",
      url: "https://youdomain.com/webhook",
      events: [
        "push"
      ]
    },
    {
      type: "team",
      team: "ci",
      access: "pull"
    },
    {
      type: "label",
      name: "do not merge",
      colour: "FF0000"
    }
  ]
}

Example when running

Type of checks

webhook

Options:

  • name (string, optional) - A description for this webhook (only used for CLI output)
  • url (string) - The URL of the webhook that should be checked.
  • events (array of strings) - An array of event names that the URL should be activated on.

team

Options:

  • team (string) - The slug for the team you wish to add.
  • access (string) - Level of access you wish to give this team ('pull', 'push' or 'admin')

label

  • name (string) - Name of the label
  • color (string) - Hex colour of the label