From e666eceaee05962220e16018b545666191694ca6 Mon Sep 17 00:00:00 2001
From: snyh <snyh@snyh.org>
Date: Sun, 6 Sep 2015 15:23:02 +0800
Subject: [PATCH] Add  Engine.RunCustom method

By this API the user can pass any net.Listener object to Engine.

It can be used by user's test code which run a Engine and bind to
a free port, then pass the real addres to the test function.

And I think if we added this API then the Engine.RunUnix is
unnecessary.
---
 gin.go | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/gin.go b/gin.go
index 3834d67e..dd55fd66 100644
--- a/gin.go
+++ b/gin.go
@@ -225,6 +225,19 @@ func iterate(path, method string, routes RoutesInfo, root *node) RoutesInfo {
 	return routes
 }
 
+// RunCustom, run server by a net.Listener
+// the main usage is to test, by a custom net.Listener we can let os to choose a free
+// port and get it.
+//
+//     r := gin.Default()
+//     l, err := net.Listen(":0")
+//     l.Addr()
+//     r.RunCustom(l)
+func (engine *Engine) RunCustom(l net.Listener) error {
+	debugPrint("Listening and serving HTTP on %s\n", l.Addr())
+	return http.Serve(l, engine)
+}
+
 // Run attaches the router to a http.Server and starts listening and serving HTTP requests.
 // It is a shortcut for http.ListenAndServe(addr, router)
 // Note: this method will block the calling goroutine undefinitelly unless an error happens.