gitform

README

gitform

A general purpose project template for golang CLI applications

• gitform
• Features
• Project Layout
• How to use this template
• Demo Application
• Makefile Targets
• Contribute

This template serves as a starting point for golang commandline applications it is based on golang projects that I consider high quality and various other useful blog posts that helped me understanding golang better.

Features

• goreleaser with deb. and .rpm package releasing
• golangci-lint for linting and formatting
• Github Actions Stages (Lint, Test, Build, Release)
• Gitlab CI Configuration (Lint, Test, Build, Release)
• cobra example setup including tests
• Makefile - with various useful targets and documentation (see Makefile Targets)
• Github Pages using jekyll-theme-minimal (checkout https://falcosuessgott.github.io/gitform/)
• pre-commit-hooks for formatting and validating code before committing

Project Layout

• assets/ => docs, images, etc
• cmd/ => commandline configurartions (flags, subcommands)
• pkg/ => packages that are okay to import for other projects
• internal/ => packages that are only for project internal purposes

• tools/ => for automatically shipping all required dependencies when running go get (or make bootstrap) such as golang-ci-lint (see: https://github.com/golang/go/wiki/Modules#how-can-i-track-tool-dependencies-for-a-module) )

How to use this template

bash <(curl -s https://raw.githubusercontent.com/jatalocks/gitform/main/install.sh)

Demo Application

$> gitform
golang-cli project template demo application

Usage:
  gitform [flags]
  gitform [command]

Available Commands:
  example     example subcommand which adds or multiplies two given integers
  help        Help about any command
  version     Displays d4sva binary version

Flags:
  -h, --help   help for gitform

Use "gitform [command] --help" for more information about a command.

$> gitform example 2 5 --add
7

$> gitform example 2 5 --multiply
10

Makefile Targets

$> make
bootstrap                      install build deps
build                          build golang binary
clean                          clean up environment
cover                          display test coverage
docker-build                   dockerize golang application
fmt                            format go files
help                           list makefile targets
install                        install golang binary
lint                           lint go files
pre-commit                     run pre-commit hooks
run                            run the app
test                           display test coverage

Contribute

If you find issues in that setup or have some nice features / improvements, I would welcome an issue or a PR :)