goserve

Collection of packages for hosting gRPC, HTTP, or other endpoints.

It is generally better to just use the standard libraries directly. Less bloat and more control over configuration. See:

• net/http: https://golang.org/pkg/net/http
• gRPC: https://github.com/grpc/grpc-go

Installation

go get -u github.com/eleniums/goserve

HTTP

Import the relevant packages:

import (
	gs "github.com/eleniums/goserve"
	gshttp "github.com/eleniums/goserve/http"
)

Build an HTTP server and listen:

// create TLS configuration
tlsConfig, err = gs.NewTLS(certFile, keyFile)
if err != nil {
	return err
}

// build the server
s := gshttp.New().
	HandleFunc("/ping", ping).
	HandleFunc("/items", items).
	WithTLS(tlsConfig).
	WithMiddleware(telemetry).
	Build()

// create a listener
lis, err := tls.Listen("tcp", "127.0.0.1:9090", tlsConfig)
if err != nil {
	return err
}

// serve the endpoint
err = s.Serve(lis)
if err != nil {
    return err
}

gRPC

Import the relevant packages:

import (
	gs "github.com/eleniums/goserve"
	gsgrpc "github.com/eleniums/goserve/grpc"
)

Build a gRPC server and listen:

// create TLS configuration
tlsConfig, err = gs.NewTLS(certFile, keyFile)
if err != nil {
	return err
}

// build the server
s := gsgrpc.New().
	Register(itempb.RegisterItemServer, srv).
	Register(pingpb.RegisterPingServer, srv).
	WithTLS(tlsConfig).
	WithUnaryInterceptors(telemetry).
	WithMaxSendMsgSize(maxSendMsgSize).
	WithMaxRecvMsgSize(maxRecvMsgSize).
	Build()

// create a listener
lis, err := net.Listen("tcp", "127.0.0.1:50051")
if err != nil {
	return err
}

// serve the endpoint
err = s.Serve(lis)
if err != nil {
    return err
}