eimlav/webhookit

Tool built in Go for verifying the integrity of GitHub web hooks and providing the option to delete web hooks based off of multiple parameters.

webhookit

Tool built in Go for verifying the integrity of GitHub web hooks and providing the option to delete web hooks based off of multiple parameters.

Usage

• export WEBHOOKIT_API_KEY=<api-key> Ensure api key has privileges to modify web hooks in your repositories.
• go build
• ./webhookit <action> [options]

Actions

• --c Check repos for broken webhooks. Cannot be used along with -destroy.
• --d Destroy broken webhooks. Cannot be used along with -check.

Options

• -f <string> File path of JSON file containing repos. Uses filepath as argument. Cannot be used along with -repo.
• -r <string> A single specified repo using the syntax namespace/repo. Cannot be used along with -filepath.
• -t <string> CSV list of HTTP status code types to destroy e.g. 2XX, 501 e.g. 2XX, 501 or none to disable HTTP status code matching (default "3XX,4XX,5XX").
• -b <string> Backup webhooks to JSON file. Uses filepath as argument.
• -ds Include duplicates webhooks when destroying.
• -l List hooks to be destroyed before confirmation.
• -u Include untriggered webhooks when destroying.

Encountering duplicates

With the -ds option specified, a dialog will appear on encountering a duplicate. This shows a diff of all the duplicates found for that particular webhook and then allows you to choose which webhooks to destroy, through the use of a CSV list.

Repos JSON file syntax

{
    "repos": [
        {
            "name": "eimlav/api-testing"
        }
    ]
}