Test and document custom HTTP verb compliance

Author: pierreprinetti

README.md

@@ -33,9 +33,8 @@ import (
 func main() {
 	mux := methodmux.New()
 
-	getHandler := myNewGetHandler()
-
 	mux.Handle(http.MethodGet, "/some-endpoint/", getHandler)
+	mux.Handle("MYMETHOD", "/some-endpoint/", myMethodHandler)
 	mux.HandleFunc(http.MethodPost, "/some-endpoint/", func(rw http.ResponseWriter, req *http.Request) {
 		fmt.Fprintf(rw, "Hi! This the response to a POST call.")
 	})

mux.go

@@ -14,9 +14,8 @@ Example usage:
 	func main() {
 		mux := methodmux.New()
 
-		getHandler := myNewGetHandler()
-
 		mux.Handle(http.MethodGet, "/some-endpoint/", getHandler)
+		mux.Handle("MYMETHOD", "/some-endpoint/", myMethodHandler)
 		mux.HandleFunc(http.MethodPost, "/some-endpoint/", func(rw http.ResponseWriter, req *http.Request) {
 			fmt.Fprintf(rw, "Hi! This the response to a POST call.")
 		})

mux_test.go

@@ -83,6 +83,8 @@ func TestServe(t *testing.T) {
 		{"POST", "example.com", "/get-only", 405, ""},
 		{"PATCH", "example.com", "/get-only", 405, ""},
 
+		{"MYMETHOD", "example.com", "/dir/", 413, "/dir/"},
+
 		// The /foo -> /foo/ redirect applies to CONNECT requests
 		// but the path canonicalization does not.
 		{"CONNECT", "example.com", "/dir", 301, "/dir/"},
@@ -111,6 +113,7 @@ func TestServe(t *testing.T) {
 		{"PATCH", "sub.example.com/", serve(416)},
 		{"CONNECT", "/dir/", serve(200)},
 		{"CONNECT", "/search", serve(201)},
+		{"MYMETHOD", "/dir/", serve(413)},
 	}
 
 	for _, tc := range testCases {