Rooba
/
tornado
mirror of https://github.com/tornadoweb/tornado.git
1
1
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Tornado is a Python web framework and asynchronous networking library, originally developed at FriendFeed.
1,484 Commits 26 Branches 75 Tags 35 MiB
Python 99.6%
Shell 0.3%
Go to file
Ben Darnell e97f9afef3 return_future and friends now pass the result, not the Future, to the callback. 
Functions and decorators that take an optional callback and return
a future (return_future, gen.concurrent, and run_executor) no longer pass
the Future object to the callback.  This results in somewhat less flexible
error handling, but is more consistent with prevailing practice without
Futures.
 		2013-03-03 18:17:29 -05:00
demos Use autoescape in websocket chat demo. 2013-03-03 12:23:28 -05:00
maint Upgrade requirement packages. 2013-03-02 19:43:59 -05:00
tornado return_future and friends now pass the result, not the Future, to the callback. 2013-03-03 18:17:29 -05:00
website Release note updates 2013-03-02 19:29:04 -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 Remove py25 from travis.yml 2013-01-13 22:30:22 -05:00
MANIFEST.in Remove epoll.c from MANIFEST.in 2013-02-13 13:31:02 -05:00
README.md Doc updates for py25 removal 2013-01-19 12:58:54 -05:00
runtests.sh Add a comment to runtests.sh about python 3. 2012-10-18 21:20:53 -04:00
setup.py Add pypi classifiers so we'll show up on python3-compatible lists. 2013-02-18 10:46:48 -05:00
tox.ini Add a c-ares-based resolver implementation. 2013-02-24 12:25:04 -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 the latest release from http://pypi.python.org/pypi/tornado

tar xvzf tornado-$VERSION.tar.gz
cd tornado-$VERSION
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.6+ and 3.2+. Both CPython and PyPy are supported.

There are no required dependencies outside the Python standard library, although unittest2 is required to run Tornado's unittest suite on Python 2.6.

Certain optional features require additional third-party modules:

  • tornado.curl_httpclient needs PycURL (version 7.18.2 or higher required; version 7.21.1 or higher recommended)
  • Multithreading support requires the concurrent.futures module, which is in the standard library for Python 3.2+ and available at http://pypi.python.org/pypi/futures for older versions.

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.