✨ ⚡ Introducing RouteFn as a signature for documentation handlers to be defined by.

Author: kaynetik

examples/main.go

@@ -13,7 +13,7 @@ func main() {
 	apiSetExternalDocs(&apiDoc)
 	apiSetComponents(&apiDoc)
 
-	apiDoc.AttachRoutes([]interface{}{
+	apiDoc.AttachRoutes([]docs.RouteFn{
 		handleCreateUserRoute,
 		handleGetUserRoute,
 	})

routing.go

@@ -6,9 +6,16 @@ import (
 	"strings"
 )
 
-type RegRoutes map[string]interface{}
+type (
+	// RouteFn represents a typeFunc which needs to be satisfied in order to use default routes attaching method.
+	RouteFn func(index int, oas *OAS)
 
-func (o *OAS) AttachRoutes(fns []interface{}) {
+	// RegRoutes represent a map of RouteFn's.
+	// TODO: Will this get Deprecated?
+	RegRoutes map[string]RouteFn
+)
+
+func (o *OAS) AttachRoutes(fns []RouteFn) {
 	for _, fn := range fns {
 		fnDeclaration := runtime.FuncForPC(reflect.ValueOf(fn).Pointer()).Name()
 		fields := strings.SplitAfter(fnDeclaration, ".")