Go Web Skeleton

A complete Golang web application skeleton.

中文说明

Contains:

• Can be used for API interface applications, CLI command line applications, WEB applications
• Log library logrus configuration used
• swagger API documentation configuration generation
• Multi-language support, view rendering, request data validation
• Configure read management, load according to environment, multi-file support
• Contains redis, mysql, mongo for initialization and simple use
• Use go mod to install the management dependencies

Project Structure

Github Project https://github.com/inhere/go-web-skeleton

api/ API interface application handlers
  |- controller/
  |- middleware/
  |_ routes.go
app/ Common directory (public methods, application initialization, public components, etc.)
cmd/ CLI command line application commands
  |_ cliapp/ command line application entry file (main)
config/ Application configuration directory (basic configuration plus various environment configurations)
model/  Data and logic code directory
  |- form/  Request form structure data definition, form validation configuration
  |- logic/ Logic processing
  |- mongo/ MongoDB data collection model definition
  |- mysql/ MySQL data form model definition
  |_ rds/   Redis data model definition
resource/   Non-code resources used by some projects (language files, view template files, etc.)
runtime/    Temporary file directory (file cache, log files, etc.)
static/     Static resource directory (js, css, etc.)
main.go     Web application entry file
Dockerfile  Dockerfile
Makefile    Has written some common shortcut commands to help package, build docker, generate documentation, run tests, etc.
...

Used Packages

• Http routing: gookit/rux
• Configure read management:
  • Multiple format configurations: gookit/config
  • INI configuration: gookit/ini
• Logging:
  • sirupsen/logrus
    • Log splitting: rifflock/lfshook
    • Log splitting: lestrrat-go/file-rotatelogs
  • go.uber.org/zap
• Mysql, etc.:
  • go-xorm/xorm
  • jinzhu/gorm
• Mongodb: github.com/globalsign/mgo
• Cache: gookit/cache
• Redis
  • go-redis/redis
  • gomodule/redigo
• I18n language: gookit/i18n
• View rendering: gookit/view
• Command line application: gookit/gcli
• Form data verification:
  • gookit/validate
  • go-playground/validator
• High-performance json serialization library: json-iterator/go
• eureka client: PDOK/go-eureka-client Not used

Auxiliary Library

• swagger document generation:    - go-swagger documents are more complex and more powerful    - swaggo/swag Documents and usage are relatively simple, only generating documents is enough
• Test the auxiliary library for quick assertion [stretchr/testify] (https://github.com/stretchr/testify)
• Debugging tool: [davecgh/go-spew] (https://github.com/davecgh/go-spew) Deep printing golang variable data

Additional components

• swagger UI: swagger document rendering
• Dockerfile: docker image build script for production environment, based on alpine, build a project image with an estimated size of around 30 M
• makefile: Some quick-on make commands have been built to help quickly generate documentation and build images.

Start

• First, clone the skeleton repository to your local directory
• Rename the go-web-skeleton directory to your project name.
• Go to the project and replace github.com/inhere/go-web-skeleton with your project name (for go file)
• Search again and replace all go-web-skeleton with your project name (mainly Dockerfile, makefile)
• Run dep ensure to install dependent libraries to the vendor
• Run the project: go run main.go

Swagger Docs Generation

installation:

Go get -u github.com/swaggo/swag/cmd/swag

Please check the documentation and examples of swaggo/swag

Generated to the specified directory:

Swag init -s static
# This file will be generated at the same time. It can be deleted if it is not needed.
rm docs/docs.go

Notice:

swaggo/swag is the parsing field description information from the comment of the field

type SomeModel struct {
	// the name description
	Name   string `json:"name" example:"tom"`
}	

Help

• Run the test

Go test
// output coverage
Go test -cover

• Formatting project

go fmt ./...

• Run GoLint check

Note: You need to install GoLint first.

golint ./...

Refer

• golang-standards/project-layout

License

MIT