Hopping Hare

A tool for generating project files using Gruntwork’s Boilerplate as a library.

Cheatsheet

# Generate a project from a template
hoppinghare generate --template-url PATH --output-folder PATH [--var NAME=VALUE] [--var-file FILE]

# List available templates
hoppinghare list-templates --template-dir DIRECTORY

# Show version information
hoppinghare version

Installation

go install github.com/gkwa/hoppinghare@latest

Quick Start

# Generate a project from a template
hoppinghare generate --template-url ~/templates/go-api --output-folder ~/my-new-project

# Generate with custom variables
hoppinghare generate --template-url ~/templates/go-api --output-folder ~/my-new-project --var "ProjectName=MyAPI" --var "GoVersion=1.20"

# Generate with variables from a file
hoppinghare generate --template-url ~/templates/go-api --output-folder ~/my-new-project --var-file vars.yml

Examples

See the `example/demo` directory for a full demonstration of Hopping Hare’s capabilities:

# Run the demo (requires just command runner)
cd example/demo
just demo

# Or run individual commands
just generate-cli-vars
just generate-with-file

To install Just:

# MacOS
brew install just

# Linux
curl --proto '=https' --tlsv1.2 -sSf https://just.systems/install.sh | bash -s -- --to /usr/local/bin