@thebespokepixel/guppy-cli

Commandline functionality for git-guppy

Usage no npm install needed!

<script type="module">
  import thebespokepixelGuppyCli from 'https://cdn.skypack.dev/@thebespokepixel/guppy-cli';
</script>

README

guppy-cli

Install git-hooks for use with git-guppy.

Special git-hooks that invoke git-guppy can be installed using the commandline utility or by requiring guppy-cli as a dependency and calling the provided methods.

Commandline Usage

Install with npm install -g guppy-cli

Usage: guppy <hookname>|all|standard|flow|everything [-d <path>]

Commands:
  hookname Install a git-hook by name, for a list, see --hooks
  standard Install all available standard git-hooks. (Use caution!)
  flow     Install all available git-flow-hooks. (Use caution!)
  all      Installs all available hooks! (Use caution!)

Options:
  -d, --dest  Destination path for git-hook (default: ./.git/hooks/)
  --hooks     Print a complete list of available git-hooks
  -h, --help  Show help                                                         [boolean]
  --version   Show version number                                               [boolean]

Examples:
  guppy pre-commit
  guppy pre-commit -d some/where
  guppy all

Existing git-hooks will be backed up the first time. If a backup already exists, it will not be overwritten. The extension .guppy will be appended to the filename of existing git-hooks when backing up.

Pre-packaged installers

For convenience, each type of git-hook has an installer package.

Install any package as a dev-dependency to install the associated git-hook automatically.

npm install --save-dev <package>

This fork also includes the following hooks for git-flow-avh

Dependency Usage

To use guppy-cli as a dependency, install with:

npm install --save guppy-cli

Available methods:

  • gup.install(hookname, destination, callback(err, result)) - Install the named hook to destination.
  • gup.installAll(destination, callback(err)) - Install all standard hooks to destination.
  • gup.installSet(destination, ['all'|'standard'|'flow'|'everything'] callback(err)) - Install hook sets to destination.