sneak f417e834f2
check / check (push) Successful in 1m21s
check / check (pull_request) Successful in 53s
Remove references to our own servers (closes #28)
Drop the README build badge, which linked to a CI server of ours, and
the commented-out `.drone.yml` line carrying one of our host addresses.
Rewrite the README opening paragraph, now the top of the file, in short
sentences.

Model: opus-5-5
2026-11-16 06:29:12 +00:00
2022-11-28 00:19:47 +00:00
2023-01-29 03:06:05 +00:00
2023-01-29 03:06:05 +00:00
2026-01-11 04:05:39 -08:00
2026-01-11 04:05:39 -08:00
2025-12-27 12:43:30 +07:00
2025-12-27 12:43:30 +07:00
2020-09-29 23:35:07 -07:00
2025-12-27 12:43:30 +07:00

gohttpserver

This is my boilerplate for a Go HTTP server: a starting point for new projects. Most things are stubbed out with sane defaults, ready to customize.

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

Features

  • Basic logging middleware
  • Stub Authentication middleware
  • Helper functions for encoding/decoding json
  • Healthcheck route
  • Prometheus metrics endpoint
  • No global state of our own
    • some deps have some, such as the metrics collector and Sentry

Design Decisions

Pending Design Decisions

  • database: TBD (thinking about go-gorm/gorm)
  • templating: TBD (suggestions welcome)

TODO

  • Basic HTML Templates
  • Database Boilerplate
  • Sessions Middleware
  • sync.Once example for re-compiling templates
  • Bundling static assets into binary

Known Bugs (more TODO)

  • Chi recovery middleware logs non-json when in non-tty stdout mode, breaking validity of stdout as a json stream

Author

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.
S
Description
This is my boilerplate for a Go http server project. Feedback and suggestions are encouraged!
Readme
354 KiB
0 Stars 1 Watchers 0 Forks
Languages
Go 73.4%
HTML 20.1%
Makefile 2.7%
Dockerfile 2.2%
CSS 1.6%