My App API

Getting Started

1. Make sure you have Go installed.
2. Clone the repo

git clone https://grest.dev/cmd/codegentemplate.git

3. Go to the directory and run go mod tidy to add missing requirements and to drop unused requirements

cd codegentemplate && go mod tidy

3. Setup your .env file

cp .env-example .env && vi .env

4. Start

go run main.go

Code Documentation

1. Install godoc

go install golang.org/x/tools/cmd/godoc@latest

2. Run godoc in codegentemplate directory

godoc -http=:6060

3. Open http://localhost:6060/pkg/grest.dev/cmd/codegentemplate in browser

Open API Documentation

1. Update your open api documentation

go run main.go update

2. Start

go run main.go

3. Open http://localhost:4001/api/docs in browser

Test

1. Make sure you have db with name main_test.db with credentials same as DB_XXX
2. Test all with verbose output that lists all of the tests and their results.

ENV_FILE=$(pwd)/.env go test ./... -v

3. Test all with benchmark.

ENV_FILE=$(pwd)/.env go test ./... -bench=.

Build for production

1. Compile packages and dependencies

go build -o codegentemplate main.go

2. Setup .env file for production

cp .env-example .env && vi .env

3. Run executable file with systemd, supervisor, pm2 or other process manager

./codegentemplate