docs: more examples

Author: podhmo

examples/01greeting/clock.go

@@ -0,0 +1,13 @@
+package greeting
+
+import "time"
+
+type Clock interface {
+	Now() time.Time
+}
+
+type ClockFunc func() time.Time
+
+func (f ClockFunc) Now() time.Time {
+	return f()
+}

examples/01greeting/greeting.go

@@ -0,0 +1,30 @@
+package greeting
+
+import (
+	"fmt"
+	"net/http"
+)
+
+func Greeting(hour int) string {
+	if hour < 12 {
+		return "Good morning"
+	} else if 12 < hour && hour < 18 {
+		return "Good afternoon"
+	} else {
+		return "Good evening"
+	}
+}
+
+type App struct {
+	Clock Clock
+}
+
+func (app *App) Greeting(w http.ResponseWriter, r *http.Request) {
+	now := app.Clock.Now()
+	w.Header().Set("Content-Type", "application/json")
+	fmt.Fprintf(w, `{"message": %q, "time": %q}`, Greeting(now.Hour()), now)
+}
+
+func (app *App) Mount(mux *http.ServeMux) {
+	mux.HandleFunc("/greeting", app.Greeting)
+}

examples/01greeting/greeting_test.go

@@ -0,0 +1,37 @@
+package greeting
+
+import (
+	"net/http"
+	"testing"
+	"time"
+
+	"github.com/podhmo/go-rfc3339"
+	"github.com/podhmo/go-webtest"
+	"github.com/podhmo/go-webtest/jsonequal"
+	"github.com/podhmo/go-webtest/tripperware"
+	"github.com/podhmo/noerror"
+)
+
+func TestIt(t *testing.T) {
+	app := &App{
+		Clock: ClockFunc(func() time.Time {
+			return rfc3339.MustParse("2000-01-01T00:00:00Z")
+		}),
+	}
+
+	var want interface{}
+	client := webtest.NewClientFromHandler(http.HandlerFunc(app.Greeting))
+	got, err := client.Get("/",
+		webtest.WithTripperware(
+			tripperware.ExpectCode(t, 200),
+			tripperware.GetExpectedDataFromSnapshot(t, &want),
+		),
+	)
+	noerror.Must(t, err)
+	noerror.Should(t,
+		jsonequal.ShouldBeSame(
+			jsonequal.FromRawWithBytes(got.JSONData(), got.Body()),
+			jsonequal.FromRaw(want),
+		),
+	)
+}

examples/01greeting/testdata/TestIt.golden

@@ -0,0 +1,16 @@
+{
+  "modifiedAt": "2020-08-09T00:59:03.193201+09:00",
+  "data": {
+    "request": {
+      "method": "GET",
+      "path": "/"
+    },
+    "response": {
+      "data": {
+        "message": "Good morning",
+        "time": "2000-01-01 00:00:00 +0000 UTC"
+      },
+      "statusCode": 200
+    }
+  }
+}