Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 56 lines (40 sloc) 1.901 kb
07e5e8c @finiteloop Wrote initial README file
finiteloop authored
1 Tornado
2 =======
3 Tornado is an open source version of the scalable, non-blocking web server
2afa973 @finiteloop Move Tornado project to Github
finiteloop authored
4 and and tools that power FriendFeed. Documentation and downloads are
5 available at http://www.tornadoweb.org/
07e5e8c @finiteloop Wrote initial README file
finiteloop authored
6
7 Tornado is licensed under the Apache Licence, Version 2.0
8 (http://www.apache.org/licenses/LICENSE-2.0.html).
9
72e1330 @bdarnell Update README to match tornadoweb.org
bdarnell authored
10 Automatic installation
11 ----------------------
07e5e8c @finiteloop Wrote initial README file
finiteloop authored
12
72e1330 @bdarnell Update README to match tornadoweb.org
bdarnell authored
13 Tornado is listed in PyPI and can be installed with pip or
14 easy_install. Note that the source distribution includes demo
15 applications that are not present when Tornado is installed in this
16 way, so you may wish to download a copy of the source tarball as well.
17
18 Manual installation
19 -------------------
20
21 Download https://github.com/downloads/facebook/tornado/tornado-2.3.tar.gz
22
23 tar xvzf tornado-2.3.tar.gz
24 cd tornado-2.3
07e5e8c @finiteloop Wrote initial README file
finiteloop authored
25 python setup.py build
26 sudo python setup.py install
27
72e1330 @bdarnell Update README to match tornadoweb.org
bdarnell authored
28 The Tornado source code is hosted on GitHub: https://github.com/facebook/tornado
29
30 On Python 2.6 and 2.7, it is also possible to simply add the tornado
31 directory to your PYTHONPATH instead of building with setup.py, since
32 the standard library includes epoll support.
33
34 Prerequisites
35 -------------
07e5e8c @finiteloop Wrote initial README file
finiteloop authored
36
72e1330 @bdarnell Update README to match tornadoweb.org
bdarnell authored
37 Tornado runs on Python 2.5, 2.6, 2.7 and 3.2.
07e5e8c @finiteloop Wrote initial README file
finiteloop authored
38
72e1330 @bdarnell Update README to match tornadoweb.org
bdarnell authored
39 On Python 2.6 and 2.7, there are no dependencies outside the Python
40 standard library, although PycURL (version 7.18.2 or higher required;
41 version 7.21.1 or higher recommended) may be used if desired.
07e5e8c @finiteloop Wrote initial README file
finiteloop authored
42
72e1330 @bdarnell Update README to match tornadoweb.org
bdarnell authored
43 On Python 2.5, PycURL is required, along with simplejson and the
44 Python development headers (typically obtained by installing a package
45 named something like python-dev from your operating system).
07e5e8c @finiteloop Wrote initial README file
finiteloop authored
46
72e1330 @bdarnell Update README to match tornadoweb.org
bdarnell authored
47 On Python 3.2, the distribute package is required. Note that Python 3
48 support is relatively new and may have bugs.
4973e29 @bdarnell Update installation instructions in README.
bdarnell authored
49
72e1330 @bdarnell Update README to match tornadoweb.org
bdarnell authored
50 Platforms
51 ---------
4973e29 @bdarnell Update installation instructions in README.
bdarnell authored
52
72e1330 @bdarnell Update README to match tornadoweb.org
bdarnell authored
53 Tornado should run on any Unix-like platform, although for the best
54 performance and scalability only Linux and BSD (including BSD
55 derivatives like Mac OS X) are recommended.
Something went wrong with that request. Please try again.