# gohttpserver

[![Build Status](https://drone.datavi.be/api/badges/sneak/gohttpserver/status.svg)](https://drone.datavi.be/sneak/gohttpserver)

This is my boilerplate for a go HTTP server, designed to be a
starting point template for new projects.

Many ideas are taken from Mat Ryer's talk titled "How I Write HTTP Web Services
after Eight Years" at GopherCon 2019, seen here:

https://www.youtube.com/watch?v=rWBSMsLG8po

# Contributing

Contributions are welcome!  Please send me an email if you'd like an account
on this server to submit PRs.

Alternately, even just feedback is great:
[sneak@sneak.berlin](mailto:sneak@sneak.berlin)

# Features

* Basic logging middleware
* Stub Authentication middleware
* Helper functions for encoding/decoding json
* Healthcheck route
* No global state

# Design Decisions

* TLS is terminated somewhere else, like on a sidecar or reverse proxy.
* logging: [rs/zerolog](https://github.com/rs/zerolog)
* configuration: [spf13/viper](https://github.com/spf13/viper)
* mux/router: [gorilla/mux](https://github.com/gorilla/mux)
    * thinking about switching to
      [go-chi/chi](https://github.com/go-chi/chi) which supports contexts
      and HandlerFunc-wrapping middleware
* templating: TBD (suggestions welcome)
* database: TBD (thinking about [go-gorm/gorm](https://github.com/go-gorm/gorm))

# TODO

* Database Boilerplate
* sync.Once example for precompiling templates
* Bundling Static Assets Into Binary
* Metrics Endpoint / Request Statistic Aggregation

# Author

* [sneak@sneak.berlin](mailto:sneak@sneak.berlin)
* https://sneak.berlin
* [@sneak@sneak.berlin](https://s.sneak.berlin/@sneak)

# License

WTFPL (aka public domain):

```
            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
                    Version 2, December 2004

 Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>

 Everyone is permitted to copy and distribute verbatim or modified
 copies of this license document, and changing it is allowed as long
 as the name is changed.

            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION

  0. You just DO WHAT THE FUCK YOU WANT TO.
```