server

package module

v0.1.9 Latest Latest Go to latest Published: Apr 22, 2025 License: Apache-2.0 Imports: 16 Imported by: 6

Details

GitHub release

A simple library for quickly developing web services. Supports HTTP, HTTPS, AWS Gateway Lambda, and AWS Lambda.

The goal is simple, enable a development of Service APIs - not the scaffolding.

go get github.com/go-obvious/server

Check out the github.com/go-obvious/server-example for an example...

View Source

const (
	AwsGatewayLambda   = "aws-gateway-v1"
	AwsGatewayV2Lambda = "aws-gateway-v2"
	Https              = "https"
	Http               = "http"
)

This section is empty.

This section is empty.

type API interface {
	Name() string
	Register(app Server) error
}

type ListenAndServeFunc func(addr string, router http.Handler) error

func AWSGatewayLambdaListener() ListenAndServeFunc

func AWSGatewayV2LambdaListener() ListenAndServeFunc

func HTTPListener() ListenAndServeFunc

func TLSListener(tlsProvider func() *tls.Config) ListenAndServeFunc

type Middleware func(next http.Handler) http.Handler

Middleware abstraction

type Server interface {
	Router() interface{}
	WithListener(l ListenAndServeFunc) Server
	Run(ctx context.Context)
}

func New(
	version *ServerVersion,
	middleware []Middleware,
	apis ...API,
) Server

type ServerVersion = about.ServerVersion

Expose the Version struct