Tornado is a Python web framework and asynchronous networking library, originally developed at FriendFeed.
Go to file
Ben Darnell 50f1890e3e Version bump and release notes for 4.4.3 2017-03-30 09:17:36 -04:00
demos demos/benchmark: use current() instead of instance() 2016-07-10 09:54:22 -04:00
docs Version bump and release notes for 4.4.3 2017-03-30 09:17:36 -04:00
maint Mass update of dependency versions 2016-04-10 15:41:29 -04:00
tornado Version bump and release notes for 4.4.3 2017-03-30 09:17:36 -04:00
.coveragerc Add .coveragerc for test coverage reporting. 2012-01-21 14:10:00 -08:00
.gitignore Add .mypy_cache to gitignore 2016-04-24 12:17:21 -04:00
.travis.yml Add monotonic as an alternative to Monotime 2015-11-07 14:01:40 +08:00
LICENSE Add top level LICENSE file 2013-08-22 19:28:35 -04:00
MANIFEST.in test Content-Type for static compressed files 2015-07-30 13:12:56 -07:00
README.rst Merge pull request #1544 from gitter-badger/gitter-badge 2016-07-12 22:52:05 -04:00
appveyor.yml Verify extension build on appveyor 2015-09-30 00:01:08 -04:00
codecov.yml Disable intrusive codecov features 2016-05-21 18:51:33 -04:00
runtests.sh Remove some vestigial references to 2to3. 2014-01-19 18:55:53 -05:00
setup.py Version bump and release notes for 4.4.3 2017-03-30 09:17:36 -04:00
tox.ini Convert readthedocs link for their .org -> .io migration for hosted projects 2016-05-29 15:04:33 +01:00

README.rst

Tornado Web Server
==================

.. image:: https://badges.gitter.im/Join%20Chat.svg
   :alt: Join the chat at https://gitter.im/tornadoweb/tornado
   :target: https://gitter.im/tornadoweb/tornado?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge

`Tornado <http://www.tornadoweb.org>`_ is a Python web framework and
asynchronous networking library, originally developed at `FriendFeed
<http://friendfeed.com>`_.  By using non-blocking network I/O, Tornado
can scale to tens of thousands of open connections, making it ideal for
`long polling <http://en.wikipedia.org/wiki/Push_technology#Long_Polling>`_,
`WebSockets <http://en.wikipedia.org/wiki/WebSocket>`_, and other
applications that require a long-lived connection to each user.

Hello, world
------------

Here is a simple "Hello, world" example web app for Tornado:

.. code-block:: python

    import tornado.ioloop
    import tornado.web

    class MainHandler(tornado.web.RequestHandler):
        def get(self):
            self.write("Hello, world")

    def make_app():
        return tornado.web.Application([
            (r"/", MainHandler),
        ])

    if __name__ == "__main__":
        app = make_app()
        app.listen(8888)
        tornado.ioloop.IOLoop.current().start()

This example does not use any of Tornado's asynchronous features; for
that see this `simple chat room
<https://github.com/tornadoweb/tornado/tree/stable/demos/chat>`_.

Documentation
-------------

Documentation and links to additional resources are available at
http://www.tornadoweb.org