From 2582f286f592c881fefeed0b639edecd41d81e4c Mon Sep 17 00:00:00 2001
From: Miguel Grinberg <miguel.grinberg@gmail.com>
Date: Tue, 7 Mar 2017 22:24:09 -0800
Subject: [PATCH] websocket support for sanic

---
 README.rst                |  3 ++-
 docs/index.rst            | 37 ++++++++++++++++++++++++++++++++-----
 examples/sanic/README.rst |  4 ++--
 examples/sanic/app.py     |  6 +++++-
 4 files changed, 41 insertions(+), 9 deletions(-)

diff --git a/README.rst b/README.rst
index 9d47553..ea9d85f 100644
--- a/README.rst
+++ b/README.rst
@@ -19,7 +19,8 @@ Features
   Socket.IO specification.
 - Compatible with Python 2.7 and Python 3.3+.
 - Supports large number of clients even on modest hardware when used with an
-  asynchronous server based on `asyncio <https://docs.python.org/3/library/asyncio.html>`_,
+  asynchronous server based on `asyncio <https://docs.python.org/3/library/asyncio.html>`_
+  (`sanic <http://sanic.readthedocs.io/>`_ and `aiohttp <http://aiohttp.readthedocs.io/>`_),
   `eventlet <http://eventlet.net/>`_ or `gevent <http://gevent.org/>`_. For
   development and testing, any WSGI complaint multi-threaded server can also be
   used.
diff --git a/docs/index.rst b/docs/index.rst
index 2f9676a..8c9856f 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -19,9 +19,10 @@ features:
   Socket.IO specification.
 - Compatible with Python 2.7 and Python 3.3+.
 - Supports large number of clients even on modest hardware when used with an
-  asynchronous server based on `asyncio <https://docs.python.org/3/library/asyncio.html>`_,
-  `eventlet <http://eventlet.net/>`_ or `gevent <http://gevent.org/>`_. For
-  development and testing, any WSGI complaint multi-threaded server can also be
+  asynchronous server based on `asyncio <https://docs.python.org/3/library/asyncio.html>`_
+  (`sanic <http://sanic.readthedocs.io/>`_ and `aiohttp <http://aiohttp.readthedocs.io/>`_),
+  `eventlet <http://eventlet.net/>`_ or `gevent <http://gevent.org>`_. For
+  development and testing, any WSGI compliant multi-threaded server can also be
   used.
 - Includes a WSGI middleware that integrates Socket.IO traffic with standard
   WSGI applications.
@@ -458,14 +459,40 @@ Deployment
 The following sections describe a variety of deployment strategies for
 Socket.IO servers.
 
-Aiohttp
+Sanic
+~~~~~
+
+`Sanic <http://sanic.readthedocs.io/>`_ is a very efficient asynchronous web
+server for Python 3.5 and newer.
+
+Instances of class ``socketio.AsyncServer`` will automatically use Sanic for
+asynchronous operations if the framework is installed. To request its use
+explicitly, the ``async_mode`` option can be given in the constructor::
+
+    sio = socketio.AsyncServer(async_mode='sanic')
+
+A server configured for aiohttp must be attached to an existing application::
+
+    app = web.Application()
+    sio.attach(app)
+
+The Sanic application can define regular routes that will coexist with the
+Socket.IO server. A typical pattern is to add routes that serve a client
+application and any associated static files.
+
+The Sanic application is then executed in the usual manner::
+
+    if __name__ == '__main__':
+        app.run()
+
+aiohttp
 ~~~~~~~
 
 `Aiohttp <http://aiohttp.readthedocs.io/>`_ is a framework with support for HTTP
 and WebSocket, based on asyncio. Support for this framework is limited to Python
 3.5 and newer.
 
-Instances of class ``engineio.AsyncServer`` will automatically use aiohttp
+Instances of class ``socketio.AsyncServer`` will automatically use aiohttp
 for asynchronous operations if the library is installed. To request its use
 explicitly, the ``async_mode`` option can be given in the constructor::
 
diff --git a/examples/sanic/README.rst b/examples/sanic/README.rst
index c748df7..53b4160 100644
--- a/examples/sanic/README.rst
+++ b/examples/sanic/README.rst
@@ -5,8 +5,8 @@ This directory contains example Socket.IO applications that are compatible with
 asyncio and the sanic framework. These applications require Python 3.5 or
 later.
 
-Note that because sanic does not support the WebSocket protocol, the only
-transport is long-polling at this time.
+Note that Sanic versions older than 0.4.0 do not support the WebSocket
+protocol, so on those versions the only available transport is long-polling.
 
 app.py
 ------
diff --git a/examples/sanic/app.py b/examples/sanic/app.py
index 712f0dd..8eeb689 100755
--- a/examples/sanic/app.py
+++ b/examples/sanic/app.py
@@ -20,6 +20,11 @@ async def background_task():
                        namespace='/test')
 
 
+@app.listener('before_server_start')
+def before_server_start(sanic, loop):
+    sio.start_background_task(background_task)
+
+
 @app.route('/')
 async def index(request):
     with open('app.html') as f:
@@ -85,5 +90,4 @@ app.static('/static', './static')
 
 
 if __name__ == '__main__':
-    sio.start_background_task(background_task)
     app.run()