go/template

go/template provides a blueprint for production-ready Go project layouts.

Credit to Renée French for the Go Gopher logo
Credit to Go Authors for the official Go logo

Batteries included

• Makefile for most common tasks
• optimized Dockerfile
• golangci-lint default configuration
• pre-push git hook to ensure no linting issues
• gRPC support
• folder structure based on github.com/golang-standards/project-layout
• enforced default packages
  • go.uber.org/zap for logging
  • go.uber.org/automaxprocs to be safe in container environments (see this article for more information)

Usage

Installation

From source

If you have Go 1.16+, you can directly install by running:

go install github.com/schwarzit/go-template/cmd/gt@latest

From the released binaries

Download the desired version for your operating system and processor architecture from the go-template releases page. Make the file executable and place it in a directory available in your $PATH.

Preconditions

go/template's gt CLI requires at least the following executables on $PATH to run succesfully:

• Go >= 1.15
• Git

These are used at the end of gt new's execution to initialize Git and Go modules in the newly created project repository.

Initialize your repo from the template

Use the template to generate your repo:

gt new

Initialize the project:

cd <your project>
make all

Options

To get an overview of all options that can be set for the template you can take a look at the options definition file, run the CLI or check out the testing example values file.

Maintainers

Name	Email
@brumhard	tobias.brumhard@mail.schwarz
@linuxluigi	steffen.exler@mail.schwarz
@danielzwink	daniel.zwink@mail.schwarz

Contribution

If you want to contribute to go/template please have a look at our contribution guidelines.