Denoh

A script for generating Git hooks by extending Deno’s configuration file.

Installation or Running

You can install denoh globally by running deno install https://deno.land/x/denoh/denoh.ts command, or run by running deno run https://deno.land/x/denoh/denoh.ts.

Usage

Since Git hooks are set by extending Deno’s configuration file, we need to create a Deno config file (Deno.json{,c}) if it does not exist. Denoh looks for githooks key of the configuration file, so to create a Git hook, pass any valid Git hook name to githooks object, and pass your script/task commands inside an array of strings. Let’s say our Deno configuration file is this example below:

For auto completion in githooks field in Deno configuration file, schema.json JSON schema file can be used, as can be seen here. Denoh JSON schema extends Deno’s latest JSON schema, so it’s safe to use Denoh’s schema, even after Deno changes theirs.

{
  "tasks": {
    "lint": "deno lint",
    "lint:fmt": "deno fmt --check"
  },
  // All hook values must be array of strings.
  "githooks": {
    // You can pass a Deno task by writing the exact name of it:
    "pre-commit": ["lint"],
    // Or you can pass any shell command with an exclamation point (!) at the beginning of the string:
    "post-commit": ["!echo 'Added commit'"],
    // And you can mix them together:
    "post-checkout": [
      "!echo 'Changed branch, running lint tasks...'",
      "lint ; lint:fmt", // denoh supports logical AND, OR and command separators
      "!echo 'Tasks ran successfully.'"
    ]
  }
}

To generate Git hooks, run denoh. This will create pre-commit, post-commit and post-checkout hooks in the current folder with the following contents:

## file -> .git/hooks/pre-commit

#!/bin/sh
deno task lint

## file -> .git/hooks/post-commit

#!/bin/sh
echo 'Added commit'

## file -> .git/hooks/post-checkout

#!/bin/sh
echo 'Changed branch, running lint tasks...'
deno task lint ; deno task lint:fmt
echo 'Tasks ran successfully.'

For help and information about flags, please refer to src/constants.ts, or run denoh -h.

Running at different folder or configuration files

You can pass folder name or configuration file name by passing its path as an argument. If the entered path is different, it will create Git hooks in the entered folder.

❯ denoh ../my-beautiful-project
❯ denoh deno.dev.jsonc -g dev-hooks/

Exit Codes