Goppy Microservice Toolkit

GitHub

Installation

go get -u go.osspkg.com/goppy

Features

Config auto generation
Custom pool of HTTP servers with configuration via config
Group APIs with middleware hanging on each group
Extensible middleware framework
Application customization via plugins
Built-in dependency container
Data binding for JSON
Command support
Database support and automatic migration

Plugins

Plugin	Comment	Import
metrics	Profiling application (pprof) and metrics collection (prometheus) with access via HTTP.	`go.osspkg.com/goppy/metrics` `metrics.WithServer()`
http	Out of the box multi-server launch of web servers with separate routing. Grouping of routers with connection to a group of dedicated middleware. HTTP clients pool.	`go.osspkg.com/goppy/web` `web.WithServer()` `web.WithClient()`
websocket	Ready-made websocket handler for server and client. Websocket server pool.	`go.osspkg.com/goppy/ws` `ws.WithServer()` `ws.WithClient()` `ws.WithServerPool()`
unixsocket	Requests via unix socket.	`go.osspkg.com/goppy/unix` `unix.WithServer()` `unix.WithClient()`
database	Multiple connection pools with MySQL, SQLite, Postgre databases (with automatic migration setup).	`go.osspkg.com/goppy/ormmysql` `ormmysql.WithClient()` `go.osspkg.com/goppy/ormsqlite` `ormsqlite.WithClient()` `go.osspkg.com/goppy/ormpgsql` `ormpgsql.WithClient()`
geoip	Definition of geo-IP information.	`go.osspkg.com/goppy/geoip` `geoip.WithMaxMindGeoIP()` + `geoip.CloudflareMiddleware()` `geoip.MaxMindMiddleware()`
oauth	Authorization via OAuth provider (Yandex, Google). JWT Cookie.	`go.osspkg.com/goppy/auth` `auth.WithOAuth()` `auth.WithJWT()` + `auth.JWTGuardMiddleware()`

Quick Start

Config:

env: dev
level: 4 # 0-Fatal, 1-Error, 2-Warning, 3-Info, 4-Debug
log: /dev/stdout

http:
  main:
    addr: 127.0.0.1:8080

Code:

package main

import (
	"fmt"
	"os"

	"go.osspkg.com/goppy"
	"go.osspkg.com/goppy/plugins"
	"go.osspkg.com/goppy/web"
)

func main() {
	// Specify the path to the config via the argument: `--config`.
	// Specify the path to the pidfile via the argument: `--pid`.
	app := goppy.New()
	app.AppName("demo_app")
	app.AppVersion("v1.0.0")
	app.Plugins(
		web.WithServer(),
	)
	app.Plugins(
		plugins.Plugin{
			Inject: NewController,
			Resolve: func(routes web.RouterPool, c *Controller) {
				router := routes.Main()
				router.Use(web.ThrottlingMiddleware(100))
				router.Get("/users", c.Users)

				api := router.Collection("/api/v1", web.ThrottlingMiddleware(100))
				api.Get("/user/{id}", c.User)
			},
		},
	)
	app.Command("env", func() {
		fmt.Println(os.Environ())
	})
	app.Run()
}

type Controller struct{}

func NewController() *Controller {
	return &Controller{}
}

func (v *Controller) Users(ctx web.Context) {
	data := []int64{1, 2, 3, 4}
	ctx.JSON(200, data)
}

func (v *Controller) User(ctx web.Context) {
	id, _ := ctx.Param("id").Int()
	ctx.String(200, "user id: %d", id)
	ctx.Log().Infof("user - %d", id)
}