A general purpose project template for golang CLI applications
- golang-cli-template
- 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.
- 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/golang-cli-template/)
- pre-commit-hooks for formatting and validating code before committing
- 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 runninggo get
(ormake bootstrap
) such asgolang-ci-lint
(see: https://github.com/golang/go/wiki/Modules#how-can-i-track-tool-dependencies-for-a-module) )
bash <(curl -s https://raw.githubusercontent.com/FalcoSuessgott/golang-cli-template/main/install.sh)
$> golang-cli-template
golang-cli project template demo application
Usage:
golang-cli-template [flags]
golang-cli-template [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 golang-cli-template
Use "golang-cli-template [command] --help" for more information about a command.
$> golang-cli-template example 2 5 --add
7
$> golang-cli-template example 2 5 --multiply
10
$> 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
If you find issues in that setup or have some nice features / improvements, I would welcome an issue or a PR :)