add the new neffos StackExchange feature to the type aliases and shortcuts of the websocket subpackage and auto-enable debug mode on websocket MVC application when iris logger's level is set to debug

Former-commit-id: 4d8cb79d01a4172fc1ed7a9b626da0228d902b3c

_examples/websocket/README.md

@@ -0,0 +1,14 @@
+# Websocket
+
+[WebSocket](https://wikipedia.org/wiki/WebSocket) is a protocol that enables two-way persistent communication channels over TCP connections. It is used for applications such as chat, stock tickers, games, anywhere you want real-time functionality in a web application.
+
+Iris websocket library is now merged with the [neffos real-time framework](https://github.com/kataras/neffos) and Iris-specific helpers and type aliases live on the [iris/websocket](https://github.com/kataras/iris/tree/master/websocket) subpackage. Learn neffos from its [wiki](https://github.com/kataras/neffos#learning-neffos).
+
+Helpers and type aliases improves your code speed when writing a websocket module.
+For example, instead of importing both `kataras/iris/websocket` - in order to use its `websocket.Handler` - and `github.com/kataras/neffos` - to create a new websocket server `neffos.New` - you can use the `websocket.New` instead, another example is the `neffos.Conn` which can be declared as `websocket.Conn`.
+
+All neffos and its subpackage's types and package-level functions exist as type aliases on the `kataras/iris/websocket` package too, there are too many of those and there is no need to write each one of those here, some common types: 
+
+- `github.com/kataras/neffos/#Conn`  -> `github.com/kataras/iris/websocket/#Conn`
+- `github.com/kataras/neffos/gorilla/#DefaultUpgrader` ->  `github.com/kataras/iris/websocket/#DefaultGorillaUpgrader`
+- `github.com/kataras/neffos/stackexchange/redis/#NewStackExchange` ->  `github.com/kataras/iris/websocket/#NewRedisStackExchange`

_examples/websocket/basic/go-client/client.go

@@ -10,8 +10,6 @@ import (
 	"time"
 
 	"github.com/kataras/iris/websocket"
-
-	"github.com/kataras/neffos"
 )
 
 const (
@@ -23,17 +21,17 @@ const (
 // this can be shared with the server.go's.
 // `NSConn.Conn` has the `IsClient() bool` method which can be used to
 // check if that's is a client or a server-side callback.
-var clientEvents = neffos.Namespaces{
-	namespace: neffos.Events{
-		neffos.OnNamespaceConnected: func(c *neffos.NSConn, msg neffos.Message) error {
+var clientEvents = websocket.Namespaces{
+	namespace: websocket.Events{
+		websocket.OnNamespaceConnected: func(c *websocket.NSConn, msg websocket.Message) error {
 			log.Printf("connected to namespace: %s", msg.Namespace)
 			return nil
 		},
-		neffos.OnNamespaceDisconnect: func(c *neffos.NSConn, msg neffos.Message) error {
+		websocket.OnNamespaceDisconnect: func(c *websocket.NSConn, msg websocket.Message) error {
 			log.Printf("disconnected from namespace: %s", msg.Namespace)
 			return nil
 		},
-		"chat": func(c *neffos.NSConn, msg neffos.Message) error {
+		"chat": func(c *websocket.NSConn, msg websocket.Message) error {
 			log.Printf("%s", string(msg.Body))
 			return nil
 		},
@@ -44,7 +42,7 @@ func main() {
 	ctx, cancel := context.WithDeadline(context.Background(), time.Now().Add(dialAndConnectTimeout))
 	defer cancel()
 
-	client, err := neffos.Dial(ctx, websocket.DefaultGorillaDialer, endpoint, clientEvents)
+	client, err := websocket.Dial(ctx, websocket.DefaultGorillaDialer, endpoint, clientEvents)
 	if err != nil {
 		panic(err)
 	}

_examples/websocket/basic/server.go

@@ -6,8 +6,6 @@ import (
 	"github.com/kataras/iris"
 	"github.com/kataras/iris/websocket"
 
-	"github.com/kataras/neffos"
-
 	// Used when "enableJWT" constant is true:
 	"github.com/dgrijalva/jwt-go"
 	jwtmiddleware "github.com/iris-contrib/middleware/jwt"
@@ -17,10 +15,10 @@ import (
 const enableJWT = true
 const namespace = "default"
 
-// if namespace is empty then simply neffos.Events{...} can be used instead.
-var serverEvents = neffos.Namespaces{
-	namespace: neffos.Events{
-		neffos.OnNamespaceConnected: func(nsConn *neffos.NSConn, msg neffos.Message) error {
+// if namespace is empty then simply websocket.Events{...} can be used instead.
+var serverEvents = websocket.Namespaces{
+	namespace: websocket.Events{
+		websocket.OnNamespaceConnected: func(nsConn *websocket.NSConn, msg websocket.Message) error {
 			// with `websocket.GetContext` you can retrieve the Iris' `Context`.
 			ctx := websocket.GetContext(nsConn.Conn)
 
@@ -29,11 +27,11 @@ var serverEvents = neffos.Namespaces{
 				ctx.RemoteAddr())
 			return nil
 		},
-		neffos.OnNamespaceDisconnect: func(nsConn *neffos.NSConn, msg neffos.Message) error {
+		websocket.OnNamespaceDisconnect: func(nsConn *websocket.NSConn, msg websocket.Message) error {
 			log.Printf("[%s] disconnected from namespace [%s]", nsConn, msg.Namespace)
 			return nil
 		},
-		"chat": func(nsConn *neffos.NSConn, msg neffos.Message) error {
+		"chat": func(nsConn *websocket.NSConn, msg websocket.Message) error {
 			// room.String() returns -> NSConn.String() returns -> Conn.String() returns -> Conn.ID()
 			log.Printf("[%s] sent: %s", nsConn, string(msg.Body))
 
@@ -48,7 +46,7 @@ var serverEvents = neffos.Namespaces{
 
 func main() {
 	app := iris.New()
-	websocketServer := neffos.New(
+	websocketServer := websocket.New(
 		websocket.DefaultGorillaUpgrader, /* DefaultGobwasUpgrader can be used too. */
 		serverEvents)
 
@@ -76,7 +74,7 @@ func main() {
 		//
 		// Check for token through the jwt middleware
 		// on websocket connection or on any event:
-		/* websocketServer.OnConnect = func(c *neffos.Conn) error {
+		/* websocketServer.OnConnect = func(c *websocket.Conn) error {
 		ctx := websocket.GetContext(c)
 		if err := j.CheckJWT(ctx); err != nil {
 			// will send the above error on the client

_examples/websocket/native-messages/main.go

@@ -5,8 +5,6 @@ import (
 
 	"github.com/kataras/iris"
 	"github.com/kataras/iris/websocket"
-
-	"github.com/kataras/neffos"
 )
 
 type clientPage struct {
@@ -26,8 +24,8 @@ func main() {
 	// and contains only one registered event which is the `OnNativeMessage`.
 	// When `Events{...}` is used instead of `Namespaces{ "namespaceName": Events{...}}`
 	// then the namespace is empty "".
-	ws := neffos.New(websocket.DefaultGorillaUpgrader, neffos.Events{
-		neffos.OnNativeMessage: func(nsConn *neffos.NSConn, msg neffos.Message) error {
+	ws := websocket.New(websocket.DefaultGorillaUpgrader, websocket.Events{
+		websocket.OnNativeMessage: func(nsConn *websocket.NSConn, msg websocket.Message) error {
 			log.Printf("Server got: %s from [%s]", msg.Body, nsConn.Conn.ID())
 
 			nsConn.Conn.Server().Broadcast(nsConn, msg)
@@ -35,12 +33,12 @@ func main() {
 		},
 	})
 
-	ws.OnConnect = func(c *neffos.Conn) error {
+	ws.OnConnect = func(c *websocket.Conn) error {
 		log.Printf("[%s] Connected to server!", c.ID())
 		return nil
 	}
 
-	ws.OnDisconnect = func(c *neffos.Conn) {
+	ws.OnDisconnect = func(c *websocket.Conn) {
 		log.Printf("[%s] Disconnected from server", c.ID())
 	}