Tornado is a Python web framework and asynchronous networking library, originally developed at FriendFeed.

asynchronous python starred-repo starred-tornadoweb-repo

Go to file

Ben Darnell 8b40fafec7 Add tornado.util.u and a fixer script to start using it.		2013-01-13 18:40:18 -05:00
demos	Remove tornado.database, which is now distributed separately.	2012-09-16 14:02:49 -07:00
maint	Add tornado.util.u and a fixer script to start using it.	2013-01-13 18:40:18 -05:00
tornado	Add tornado.util.u and a fixer script to start using it.	2013-01-13 18:40:18 -05:00
website	Allow tuples for the IOStream.close exc_info argument.	2012-12-22 12:08:03 -05:00
.coveragerc	Add .coveragerc for test coverage reporting.	2012-01-21 14:10:00 -08:00
.gitignore	Run the tests in optimized mode too to ensure that things still work	2012-06-13 10:58:15 -07:00
.travis.yml	Add futures to travis and vm tests, update assorted dependency versions.	2012-09-29 17:47:41 -07:00
MANIFEST.in	Encourage "python -m tornado.test.runtests" as the way to run the tests.	2012-06-24 18:45:27 -07:00
README.md	Mv README so github web interface recognize its markup language	2012-11-02 18:29:40 -03:00
runtests.sh	Add a comment to runtests.sh about python 3.	2012-10-18 21:20:53 -04:00
setup.py	Remove now-redundant entries from next.rst, bump version to 2.4.post2.	2012-11-24 22:28:13 -05:00
tox.ini	Drop py25 from the main tox.ini	2013-01-13 18:40:17 -05:00

README.md

Tornado

Tornado is an open source version of the scalable, non-blocking web server and and tools that power FriendFeed. Documentation and downloads are available at http://www.tornadoweb.org/

Tornado is licensed under the Apache Licence, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0.html).

Automatic installation

Tornado is listed in PyPI and can be installed with pip or easy_install. Note that the source distribution includes demo applications that are not present when Tornado is installed in this way, so you may wish to download a copy of the source tarball as well.

Manual installation

Download https://github.com/downloads/facebook/tornado/tornado-2.3.tar.gz

tar xvzf tornado-2.3.tar.gz
cd tornado-2.3
python setup.py build
sudo python setup.py install

The Tornado source code is hosted on GitHub: https://github.com/facebook/tornado

On Python 2.6 and 2.7, it is also possible to simply add the tornado directory to your PYTHONPATH instead of building with setup.py, since the standard library includes epoll support.

Prerequisites

Tornado runs on Python 2.5, 2.6, 2.7 and 3.2.

On Python 2.6 and 2.7, there are no dependencies outside the Python standard library, although PycURL (version 7.18.2 or higher required; version 7.21.1 or higher recommended) may be used if desired.

On Python 2.5, PycURL is required, along with simplejson and the Python development headers (typically obtained by installing a package named something like python-dev from your operating system).

On Python 3.2, the distribute package is required. Note that Python 3 support is relatively new and may have bugs.

Platforms

Tornado should run on any Unix-like platform, although for the best performance and scalability only Linux and BSD (including BSD derivatives like Mac OS X) are recommended.