crud

README

Go API Boilerplates - gin/gorm/crud

---

This is a basic example of Go API with gin-gonic/gin, PostgreSQL and GORM.

A full list of libraries used can be found in Dependencies section.

Table of Contents

• Development
  • Tools
  • Documentation
• Dependencies
  • API
  • Database
  • Testing

Development

This project can be booted up either

• natively with Go installed locally (assuming dependencies like PostgresSQL, Redis, etc. also exist)
• or by Docker Compose (PostgreSQL, Redis, etc. are included out of the box)

Please refer to Makefile or docker-compose.yml for details.

By default, the server will run at http://localhost:3333, but everything is configurable via .env file.

Tools

Some common development tools are introduced for better local development experience.

• cosmtrek/air - Live reload for Go apps
• GoTestTools/gotestfmt - go test output for humans
• swaggo/swag - Automatically generate RESTful API documentation with Swagger 2.0 for Go.

go install github.com/cosmtrek/air@latest
go install github.com/gotesttools/gotestfmt/v2/cmd/gotestfmt@latest
go install github.com/swaggo/swag/cmd/swag@latest

Alternatively, use make install to install the required Go tooling locally.

Documentation

This service has integrated swaggo/swag to create OpenAPI documentation automatically.

Use command make generate/api or swag init to run the generation.

Then navigate to http://localhost:3333/swagger/index.html to view the API documentation.

Dependencies

API

• gin-gonic/gin - Gin is a HTTP web framework written in Go (Golang).
  • gin-contrib/cors - Official CORS gin's middleware
  • gin-contrib/requestid - Request ID middleware for Gin Framework
• joho/godotenv - A Go port of Ruby's dotenv library (Loads environment variables from .env files)
• spf13/viper - Go configuration with fangs
• uber-go/zap - Blazing fast, structured, leveled logging in Go.
• go-ozzo/ozzo-validation - An idiomatic Go (golang) validation package. Supports configurable and extensible validation rules (validators) using normal language constructs instead of error-prone struct tags.
• swaggo/gin-swagger - gin middleware to automatically generate RESTful API documentation with Swagger 2.0.

Database

• PostgreSQL - The World's Most Advanced Open Source Relational Database
• go-gorm/gorm - The fantastic ORM library for Golang, aims to be developer friendly

Testing

• stretchr/testify - A toolkit with common assertions and mocks that plays nicely with the standard library
• ory/dockertest - Write better integration tests! Dockertest helps you boot up ephermal docker images for your Go tests with minimal work.