Files
go-router/router_test.go
2021-07-19 21:13:03 -07:00

348 lines
8.3 KiB
Go

package router
import (
"fmt"
"io/ioutil"
"net/http"
"net/http/httptest"
"testing"
)
var testLevel = 1
func TestAddRouter(t *testing.T) {
describeTests("Test AddRouter method")
router := Router{}
testAddRoot(router, t)
testAddOneSegment(router, t)
testAddManySegments(router, t)
testAddDuplicateEndpoint(router, t)
}
func TestServeHTTP(t *testing.T) {
describeTests("Test ServeHTTP method")
router := Router{}
testMatchesRoot(router, t)
testMatchesLongPath(router, t)
testMatchesPathParam(router, t)
testDefaultNotFound(router, t)
testCustomNotFound(router, t)
}
func TestPathParams(t *testing.T) {
describeTests("Test PathParams method")
router := Router{}
testParamValues(router, t)
}
func addAndCheckRoute(r *Router, method string, path string, callback http.HandlerFunc) (err error) {
routeCount := len(r.routes)
err = r.AddRoute(method, path, callback)
if err != nil {
return
}
if len(r.routes) != routeCount+1 {
err = fmt.Errorf("Expected there to be %d route(s), but there are %d", routeCount+1, len(r.routes))
return
}
route := r.routes[len(r.routes)-1]
if route.method != method {
err = fmt.Errorf("Expected the route method to be %s, but it was %s", method, route.method)
return
}
if route.path != path {
err = fmt.Errorf("Expected the route path to be %s, but it was %s", path, route.path)
return
}
if route.callback == nil {
err = fmt.Errorf("Expected route to have a callback function, but the callback was nil")
return
}
return
}
// checkLookup prints out the various saved routes. It's not needed for any test, but is a helpful debugging tool.
func checkLookup(curr *segment) {
fmt.Printf("%p { methods: %v, children: %v, parameter: %v\"}\n", curr, curr.endpoints, curr.children, curr.parameter)
for _, v := range curr.children {
checkLookup(v)
}
if curr.parameter.segment != nil {
checkLookup(curr.parameter.segment)
}
}
func describeTests(message string) {
fmt.Printf("%d. %s\n", testLevel, message)
testLevel++
}
func matchAndCheckRoute(r *Router, method string, path string, expectedBody string, expectedCode int) (err error) {
request, err := http.NewRequest(method, path, nil)
rr := httptest.NewRecorder()
if err != nil {
err = fmt.Errorf("Could not create request")
return
}
r.ServeHTTP(rr, request)
if rr.Code != expectedCode {
err = fmt.Errorf("The returned callback did not write %d to the header. Found %d", expectedCode, rr.Code)
return
}
body, _ := ioutil.ReadAll(rr.Body)
if string(body) != string([]byte(expectedBody)) {
err = fmt.Errorf(
"The returned callback did not write the expected body. Expected: %s. Actual: %s",
expectedBody,
string(body),
)
return
}
return
}
func testAddDuplicateEndpoint(router Router, t *testing.T) {
defer testOutcome("add duplicate endpoints", t)
err := addAndCheckRoute(&router, http.MethodGet, "/dupe", func(http.ResponseWriter, *http.Request) {})
if err != nil {
t.Error("The route was not correctly added to the routoer", err)
}
err = addAndCheckRoute(&router, http.MethodPost, "/dupe", func(http.ResponseWriter, *http.Request) {})
if err != nil {
t.Error("The route was not correctly added to the routoer", err)
}
err = addAndCheckRoute(&router, http.MethodGet, "/dupe", func(http.ResponseWriter, *http.Request) {})
if err == nil {
t.Error("Adding a duplicate route should throw an error.")
}
}
func testAddManySegments(router Router, t *testing.T) {
defer testOutcome("add many multiple segments", t)
err := addAndCheckRoute(&router, http.MethodDelete, "/items/thing/man/bird/horse/poop", func(http.ResponseWriter, *http.Request) {})
if err != nil {
t.Error("The route was not correctly added to the router: ", err)
}
err = addAndCheckRoute(&router, http.MethodDelete, "/items/thing/man/bird/cat/poop", func(http.ResponseWriter, *http.Request) {})
if err != nil {
t.Error("The route was not correctly added to the router: ", err)
}
}
func testAddOneSegment(router Router, t *testing.T) {
defer testOutcome("add callbacks to a single segment", t)
err := addAndCheckRoute(&router, http.MethodPatch, "/items", func(http.ResponseWriter, *http.Request) {})
if err != nil {
t.Error("The route was not correctly added to the router: ", err)
}
}
func testAddRoot(router Router, t *testing.T) {
defer testOutcome("add callbacks to root", t)
err := addAndCheckRoute(&router, http.MethodGet, "/", func(http.ResponseWriter, *http.Request) {})
if err != nil {
t.Error("The route was not correctly added to the router: ", err)
}
err = addAndCheckRoute(&router, http.MethodPost, "/", func(http.ResponseWriter, *http.Request) {})
if err != nil {
t.Error("The route was not correctly added to the router: ", err)
}
}
func testCustomNotFound(router Router, t *testing.T) {
defer testOutcome("custom NotFoundHandler", t)
expectedBody := "Forbidden"
expectedCode := 401
path := "/gibberish/forbidden"
router.NotFoundHandler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(expectedCode)
w.Write([]byte(expectedBody))
})
err := matchAndCheckRoute(&router, http.MethodPatch, path, expectedBody, expectedCode)
if err != nil {
t.Error("Did not call the custom handler.", err)
return
}
}
func testDefaultNotFound(router Router, t *testing.T) {
defer testOutcome("default NotFoundHandler", t)
expectedBody := "Not Found."
expectedCode := 404
path := "/gibberish"
err := matchAndCheckRoute(&router, http.MethodDelete, path, expectedBody, expectedCode)
if err != nil {
t.Error("Did not find the expected callback handler", err)
return
}
}
func testMatchesLongPath(router Router, t *testing.T) {
defer testOutcome("match long path", t)
path := "/items/things/stuff"
expectedBody := "I am /items/things/stuff"
expectedCode := 200
router.AddRoute(http.MethodGet, path, func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(expectedCode)
w.Write([]byte(expectedBody))
})
err := matchAndCheckRoute(&router, http.MethodGet, path, expectedBody, expectedCode)
if err != nil {
t.Error("Did not find the expected callback handler", err)
return
}
}
func testMatchesPathParam(router Router, t *testing.T) {
defer testOutcome("match path with parameter", t)
expectedBody := "I have a path param"
expectedCode := 200
path := "/items/:itemid/edit"
reqPath := "/items/this-is-an-id/edit"
router.AddRoute(http.MethodGet, path, func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(expectedCode)
w.Write([]byte(expectedBody))
})
err := matchAndCheckRoute(&router, http.MethodGet, reqPath, expectedBody, expectedCode)
if err != nil {
t.Error("Did not find the expected callback handler", err)
return
}
}
func testMatchesRoot(router Router, t *testing.T) {
defer testOutcome("match root path", t)
expectedBody := "I am /"
expectedCode := 200
path := "/"
router.AddRoute(http.MethodGet, path, func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(expectedCode)
w.Write([]byte(expectedBody))
})
err := matchAndCheckRoute(&router, http.MethodGet, path, expectedBody, expectedCode)
if err != nil {
t.Error("Did not find the expected callback handler", err)
return
}
}
func testParamValues(router Router, t *testing.T) {
defer testOutcome("returns param names and values", t)
method := http.MethodOptions
path := "/users/:userID/edit/:status"
userID := "46"
status := "inactive"
expectedBody := "done"
expectedStatus := 200
reqPath := fmt.Sprintf("/users/%s/edit/%s", userID, status)
router.AddRoute(method, path, func(w http.ResponseWriter, r *http.Request) {
params := PathParams(r)
if len(params) != 2 {
t.Errorf("Received the wrong number of parameters. Expected 2, recieved %d", len(params))
}
if params["userID"] != userID {
t.Errorf("userID should be %s, but it is %s", userID, params["userID"])
}
if params["status"] != status {
t.Errorf("status should be %s, but it is %s", status, params["status"])
}
w.WriteHeader(expectedStatus)
w.Write([]byte(expectedBody))
})
err := matchAndCheckRoute(&router, method, reqPath, expectedBody, expectedStatus)
if err != nil {
t.Error("Did not find the expected callback handler", err)
return
}
}
func testOutcome(message string, t *testing.T) {
var status string
if t.Failed() {
status = "\u001b[31mx\u001b[0m"
} else {
status = "\u001b[32m✓\u001b[0m"
}
fmt.Printf("\t%s %s\n", status, message)
}