Gin Boilerplate

This repository contains a golang API using hexagonal architecture.

Features

• Decoupled components (using Ports and Adapters)
• Handmade Swagger documentation
• Mocks generation using Mockery
• Full suite of tests using Testify

Toolkit

Included on dependencies

• Gin Gonic Web framework
• Testify Assert + Mocks
• GORM SQL ORM
• Cobra Command line framework
• Viper Config files toolkit

External tools

• Revive Some linters
• Secure Go Security Checker
• Mockery Generate Mocks
• Air Live Reload
• Delve Debug

Endpoints

Method	URL
GET	/health
POST	/v1/pets
GET	/v1/pets
GET	/v1/pet/{petId}
PATCH	/v1/pet/{petId}
DELETE	/v1/pet/{petId}
GET	/v1/tags
POST	/v1/categories
GET	/v1/categories
GET	/v1/category/{categoryId}
DELETE	/v1/category/{categoryId}
POST	/v1/orders
GET	/v1/orders
GET	/v1/order/{orderId}

CLI Usage

• app
• app serve
• app migrate
• app seed
• app create config