Contributors

• Serge S. Koval

• Taras Drapalyuk

Introduction

This is python server implementation of the Socket.IO realtime transport library on top of the Tornado framework.

TornadIO2 is compatible with 0.7+ version of the Socket.IO and implements most of the features found in original Socket.IO server software.

Key features:

• Supports Socket.IO 0.8 protocol and related features

• Full unicode support

• Support for generator-based asynchronous code (tornado.gen API)

• Statistics capture (packets per second, etc)

What is Socket.IO?

Socket.IO aims to make realtime apps possible in every browser and mobile device, blurring the differences between the different transport mechanisms. It’s care-free realtime 100% in JavaScript.

You can use it to build push service, games, etc. Socket.IO will adapt to the clients browser and will use most effective transport protocol available.

Getting Started

In order to start working with the TornadIO2 library, you have to have some basic Tornado knowledge. If you don’t know how to use it, please read Tornado tutorial, which can be found here.

If you’re familiar with Tornado, do following to add support for Socket.IO to your application:

1. Derive from tornadio2.SocketConnection class and override on_message method (on_open/on_close are optional):

   class MyConnection(tornadio2.SocketConnection):
       def on_message(self, message):
           pass

2. Create TornadIO2 server for your connection:

   MyRouter = tornadio2.TornadioRouter(MyConnection)

3. Add your handler routes to the Tornado application:

   application = tornado.web.Application(
       MyRouter.urls,
       socket_io_port = 8000)

4. Start your application

5. You have your socket.io server running at port 8000. Simple, right?

Starting Up

We provide customized version (shamelessly borrowed from the SocketTornad.IO library) of the HttpServer, which simplifies start of your TornadIO server.

To start it, do following (assuming you created application object before):

if __name__ == "__main__":
    socketio_server = SocketServer(application)

SocketServer will automatically start Flash policy server, if required.

If you don’t want to start IOLoop immediately, pass auto_start = False as one of the constructor options and then manually start IOLoop.

More information

For more information, check TornadIO2 documentation and sample applications.