75 lines
2.2 KiB
Markdown
75 lines
2.2 KiB
Markdown
# gohttpserver
|
|
|
|
[](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, with most things conveniently
|
|
stubbed out and ready for simple and fast customization, with sane defaults.
|
|
|
|
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.
|
|
```
|
|
|