Make Getting started easier (#60)

* Add Makefile to make getting starting development easier

* add info about makefile to readme

Co-authored-by: Qais Patankar <qaisjp@gmail.com>
This commit is contained in:
Cian Butler 2020-11-11 00:16:51 +00:00 committed by GitHub
parent d2991955c8
commit 58c74bb556
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 72 additions and 3 deletions

57
Makefile Normal file
View File

@ -0,0 +1,57 @@
SHELL := bash
.ONESHELL:
.SHELLFLAGS := -eu -o pipefail -c
.DELETE_ON_ERROR:
.DEFAULT_GOAL := help
MAKEFLAGS += --warn-undefined-variables
MAKEFLAGS += --no-builtin-rules
GO111MODULES=on
GIT_TAG := $(shell git describe --always --abbrev=0 --tags)
GIT_BRANCH=$(shell git rev-parse --abbrev-ref HEAD)
GIT_COMMIT := $(shell git log --pretty=format:'%h' -n 1)
VERSION="$(GIT_TAG)-$(GIT_BRANCH).$(GIT_COMMIT)"
BINARY := "go-discord-irc"
BINARY_PKG_BUILD := "."
RELEASE_ZIP := "go-discord-irc.zip"
ARGS := --config config.yml
.PHONY: all build release
all: build release
build: $(BINARY) ## Build Binary
release: $(RELEASE_ZIP) ## Package release artifact
$(BINARY): dep
@echo "🍳 Building $(BINARY)"
go build -i -v -o $(BINARY) -ldflags "-X main.version=$(GIT_TAG)-$(GIT_BRANCH).$(GIT_COMMIT)" $(BINARY_PKG_BUILD)
$(RELEASE_ZIP): $(BINARY)
@echo "🍳 Building $(RELEASE_ZIP)"
zip --junk-paths $(RELEASE_ZIP) $(BINARY) README.md
.PHONY:clean
clean: ## Remove previous builds
@echo "🧹 Cleaning old build"
go clean
rm -f $(BINARY) $(RELEASE_ZIP)
.PHONY: dep
dep: ## go get all dependencies
@echo "🛎 Updating Dependencies"
go get -v -d ./...
.PHONY: run
run: dep ## Compiles and runs Binary
@go run -race $(BINARY_PKG_BUILD) --debug $(ARGS)
.PHONY: help
help: ## Display this help screen
@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) \
| sort \
| awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-30s\033[0m %s\n", $$1, $$2}'
.PHONY: test
test: ## Runs go test with default values
@echo "🍜 Testing $(BINARY)"
go test -v -count=1 -race ./...

View File

@ -109,6 +109,18 @@ Make sure you also give the bot application these intents too:
## Docker
First edit `config.yml` file to your needs. Then launch
`docker build -t go-discord-irc .` in the repository root folder. And then
`docker run -d go-discord-irc` to run the bot in background.
First edit `config.yml` file to your needs.
Then launch `docker build -t go-discord-irc .` in the repository root folder.
And then `docker run -d go-discord-irc` to run the bot in background.
## Development
A Makefile is provided to make getting started easier.
To build a binary run `make build` this will produce a binary of `go-discord-irc` in the root dir.
To build and run the binary run `make run`, this will use the `config.yaml` and start in debug.
To Execute tests run `make test`
Dependencies will be updated and installed with all the above commands or by running `make dev`