mozey/httprouter-util

Example of using httprouter and other useful packages

httprouter-util's Issues

Caddy as a HTTPS endpoint, API gateway, and reverse proxy

Example Caddyfile for

• Automatic HTTPS (even on localhost?)
• API gateway to service running on a specific port
• Reverse proxy to another service

Browser and gRPC-compatible HTTP APIs

Protocol buffer is an alternative to tools like Swagger.

Besides the benefits of using a binary protocol, it's potentially also more efficient to develop. The "spec" / clients are generated from interfaces and structs, no comment annotations, or manually editing JSON spec is required.

connect-go is an alternative lib for "for building browser and gRPC-compatible HTTP APIs. If you're tired of hand-written boilerplate and turned off by massive frameworks, Connect is for you.". It has the following features

• supports "three protocols: gRPC, gRPC-Web, and Connect's own protocol"
• "works over HTTP/1.1 or HTTP/2"
• "any package that works with an http.Server, http.Client, or http.Handler also works with Connect"

The official Google implementation of gRPC has some disadvantages

• "has no browser support (due to vendors not implementing trailers)"
• "is 130 thousand lines of hand-written code"
• "uses its own implementation of HTTP/2. It's incompatible with the rest of Go's HTTP ecosystem"
• "Supporting common HTTP clients (like web browsers) requires elaborate translating proxies"

As per gotime episode gRPC & protocol buffers

Auth with go-oauth2

Auth with go-oauth2, using default store BuntDB: "Both Bolt and Bunt are ACID, and both persist data to disk. The biggest difference between them is that Bolt reads and writes from disk, while Bunt reads and writes from memory (and has an append-only file for durability)"

See OAuth2 explained with cute shapes, create examples as per this article

Endpoint for basic auth

See TODO

Swagger spec, docs, and client

Do the following

• Document endpoints in handler comments
• Generate spec with swag
• Endpoint to serve UI

Harden server for Internet exposure

Review recommendations made in these articles

• The complete guide to Go net/http timeouts
• So you want to expose Go on the Internet

Catch ctrl+c for graceful shutdown

"Shutdown gracefully shuts down the server without
interrupting any active connections...
does not attempt to close nor wait for... WebSockets"

https://golang.org/pkg/net/http/#Server.Shutdown

Gzip middleware

Example of using nytimes/gziphandler

Passwordless auth

Example of using johnsto/go-passwordless