@@ -1,6 +1,6 @@
# Change these variables as necessary.
MAIN_PACKAGE_PATH : = ./cmd/example
BINARY_NAME : = example
main_package_path = ./cmd/example
binary_name = example
# ==================================================================================== #
# HELPERS
@@ -9,72 +9,73 @@ BINARY_NAME := example
# # help: print this help message
.PHONY : help
help :
@echo ' Usage:'
@sed -n ' s/^##//p' ${MAKEFILE_LIST} | column -t -s ' :' | sed -e ' s/^/ /'
@echo 'Usage :'
@sed -n 's/^##//p' ${MAKEFILE_LIST} | column -t -s ' :' | sed -e 's/^/ /'
.PHONY : confirm
confirm :
@echo -n ' Are you sure? [y/N] ' && read ans && [ $$ {ans:-N} = y ]
@echo -n 'Are you sure? [y/N] ' && read ans && [ $${ans :-N} = y ]
.PHONY : no-dirty
no-dirty :
git diff --exit-code
@test -z "$(shell git status --porcelain)"
# ==================================================================================== #
# QUALITY CONTROL
# ==================================================================================== #
# # tidy: format code and tidy modfile
.PHONY : tidy
tidy :
go fmt ./...
go mod tidy -v
# # audit: run quality control checks
.PHONY : audit
audit :
go mod verify
go vet ./...
go run honnef.co/go/tools/cmd/staticcheck@latest -checks=all,-ST1000,-U1000 ./...
go run golang.org/x/vuln/cmd/govulncheck@latest ./...
go test -race -buildvcs -vet=off ./...
# ==================================================================================== #
# DEVELOPMENT
# ==================================================================================== #
audit : test
go mod tidy -diff
go mod verify
test -z "$(shell gofmt -l .)"
go vet ./...
go run honnef.co/go/tools/cmd/staticcheck@latest -checks=all,-ST1000,-U1000 ./...
go run golang.org/x/vuln/cmd/govulncheck@latest ./...
# # test: run all tests
.PHONY : test
test :
go test -v -race -buildvcs ./...
go test -v -race -buildvcs ./...
# # test/cover: run all tests and display coverage
.PHONY : test/cover
test/cover :
go test -v -race -buildvcs -coverprofile=/tmp/coverage.out ./...
go tool cover -html=/tmp/coverage.out
go test -v -race -buildvcs -coverprofile=/tmp/coverage.out ./...
go tool cover -html=/tmp/coverage.out
# ==================================================================================== #
# DEVELOPMENT
# ==================================================================================== #
# # tidy: tidy modfiles and format .go files
.PHONY : tidy
tidy :
go mod tidy -v
go fmt ./...
# # build: build the application
.PHONY : build
build :
# Include additional build steps, like TypeScript, SCSS or Tailwind compilation here...
go build -o=/tmp/bin/${BINARY_NAME } ${MAIN_PACKAGE_PATH }
# Include additional build steps, like TypeScript, SCSS or Tailwind compilation here...
go build -o=/tmp/bin/${binary_name } ${main_package_path }
# # run: run the application
.PHONY : run
run : build
/tmp/bin/${BINARY_NAME }
/tmp/bin/${binary_name }
# # run/live: run the application with reloading on file changes
.PHONY : run/live
run/live :
go run github.com/cosmtrek/[email protected] \
--build.cmd " make build" --build.bin " /tmp/bin/${BINARY_NAME } " --build.delay " 100" \
--build.exclude_dir " " \
--build.include_ext " go, tpl, tmpl, html, css, scss, js, ts, sql, jpeg, jpg, gif, png, bmp, svg, webp, ico" \
--misc.clean_on_exit " true"
go run github.com/cosmtrek/[email protected] \
--build.cmd "make build" --build.bin "/tmp/bin/${binary_name }" --build.delay "100" \
--build.exclude_dir "" \
--build.include_ext "go, tpl, tmpl, html, css, scss, js, ts, sql, jpeg, jpg, gif, png, bmp, svg, webp, ico" \
--misc.clean_on_exit "true"
# ==================================================================================== #
@@ -83,13 +84,12 @@ run/live:
# # push: push changes to the remote Git repository
.PHONY : push
push : tidy audit no-dirty
git push
push : confirm audit no-dirty
git push
# # production/deploy: deploy the application to production
.PHONY : production/deploy
production/deploy : confirm tidy audit no-dirty
GOOS=linux GOARCH=amd64 go build -ldflags=' -s' -o=/tmp/bin/linux_amd64/${BINARY_NAME} ${MAIN_PACKAGE_PATH}
upx -5 /tmp/bin/linux_amd64/${BINARY_NAME}
# Include additional deployment steps here...
production/deploy : confirm audit no-dirty
GOOS =linux GOARCH=amd64 go build -ldflags='-s' -o=/tmp/bin/linux_amd64/${binary_name} ${main_package_path}
upx -5 /tmp/bin/linux_amd64/${binary_name}
# Include additional deployment steps here...