Thin wrapper around Go's HTTP server to provide simple command line functionality, config loading, request logging, graceful connection shutdown, and daemonization.
Switch branches/tags
Nothing to show
Clone or download
Jeremie Castagna
Latest commit feecad6 Sep 12, 2014

README.md

Go Walker githalytics.com alpha

GoSrv

GoSrv is a thin wrapper around Go's HTTP server, to provide basic command-line functionality, env-specific configuration, request logging, graceful shutdowns, and daemonization.

Command Line

$ myserver -h

Usage: myserver [options]

-a: ":9000"  Server address
-pid: "myserver.pid" Server PID File
-c: "myserver.cfg"  Config file
-e: "dev" Environment to run server in
-d: false Run server as daemon
-stop: false  Stop running server and exit
-restart: false Stop running server and boot daemon
-kill: false Force kill running server and exit

Config File

[DEFAULT]
addr=":9000"
pidFile=path/to/file.pid
readTimeout=5s
writeTimeout=500ms
certFile=path/to/myserver.cert
keyFile=path/to/myserver.key

timeFormat=(02/01/2006 15:04:05)
logFormat=$RemoteAddr - $RemoteUser $Time "$Request" $Status $BodyBytes
logFile=path/to/myserver.log

customThing=foobar

[dev]
customThing=baz

[prod]
readTimeout=2s

Go Code

package main

import (
  "fmt"
  "gosrv"
  "net/http"
)


func main() {
  s, err := gosrv.NewFromFlag()
  if err != nil { panic(err) }

  customThing, err := s.Config.String("customThing")
  if err != nil { fmt.Println("Custom thing is "+customThing+" for environment "+s.Config.Env) }

  s.HandleFunc("/", handler)

  err = s.ListenAndServe()
  if err != nil { panic(err) }
}


func handler(w http.ResponseWriter, r *http.Request) {
  w.Write([]byte("Hello World!\n"))

  res := w.(*gosrv.Response)

  for i := 0; i < 100; i++ {
    // Some long running request
    time.Sleep(50 * time.Millisecond)

    // Check to see if the server is trying to shut down
    if res.StopSignal() {
      break
    }
  }
}