httpserve

HTTPServe is a simple and lightweight HTTP framework. It's intended to make HTTP controller setup fast and easy.

Features

• Parameter and non-restrictive routing
• Middleware support
• Simple TLS configuration (http2 by default)

Benchmarks

Routing

# httpserve's router
BenchmarkRouter-4             20000000      55.0 ns/op      48 B/op        1 allocs/op
# github.com/julienschmidt/httprouter
BenchmarkJulianSchmidt-4      20000000      72.9 ns/op      32 B/op        1 allocs/op
# github.com/missionMeteora/apiserv/router
BenchmarkAPIServe-4            5000000       284 ns/op      64 B/op        2 allocs/op

String splitting

# httpserve.getParts
BenchmarkGetPartsSmall-4        20000000                93.4 ns/op            48 B/op          1 allocs/op
# Standard library
BenchmarkStringsSpitSmall-4     10000000               120 ns/op              48 B/op          1 allocs/op

# httpserve.getParts
BenchmarkGetPartsMedium-4       20000000               104 ns/op              48 B/op          1 allocs/op
# Standard library
BenchmarkStringsSpitMedium-4    10000000               134 ns/op              64 B/op          1 allocs/op

# httpserve.getParts
BenchmarkGetPartsLarge-4        10000000               116 ns/op              48 B/op          1 allocs/op
# Standard library
BenchmarkStringsSpitLarge-4     10000000               156 ns/op              80 B/op          1 allocs/op

Usage

// Function example
package main

import (
	"log"

	"github.com/Hatch1fy/httpserve"
)

func main() {
	var (
		srv *httpserve.Serve
		err error
	)

	srv = httpserve.New()
	defer srv.Close()

	srv.GET("/ping", func(ctx *httpserve.Context) (res httpserve.Response) {
		return httpserve.NewTextResponse(200, []byte("pong"))
	})

	srv.Set404(func(ctx *httpserve.Context) (res httpserve.Response) {
		return httpserve.NewTextResponse(404, []byte("Oh shoot, this page doesn't exist"))
	})

	if err = srv.Listen(8080); err != nil {
		log.Fatal(err)
	}
}

// Method example
package main

import (
	"log"

	"github.com/Hatch1fy/httpserve"
)

func main() {
	var (
		srv *httpserve.Serve
		svc Service
		err error
	)

	srv = httpserve.New()
	defer srv.Close()

	srv.GET("/ping", svc.Ping)
	srv.Set404(svc.NotFound)

	if err = srv.Listen(8080); err != nil {
		log.Fatal(err)
	}
}

// Service manages a web service
type Service struct{}

// Ping is the ping endpoint handler
func (s *Service) Ping(ctx *httpserve.Context) (res httpserve.Response) {
	return httpserve.NewTextResponse(200, []byte("pong"))
}

// NotFound is the 404 handler
func (s *Service) NotFound(ctx *httpserve.Context) (res httpserve.Response) {
	return httpserve.NewTextResponse(404, []byte("Oh shoot, this page doesn't exist"))
}