Tornado 4.3文檔翻譯: 首頁

時間 2019-11-06

原文原文鏈接

譯者說

Tornado 4.3於2015年11月6日剛發佈，該版本正式支持Python3.5的async/await關鍵字，而且用舊版本CPython編譯Tornado一樣可使用這兩個關鍵字，這無疑是一種進步。其次，這是最後一個支持Python2.6和Python3.2的版本了，在後續的版本了會移除對它們的兼容。如今網絡上尚未Tornado4.3的中文文檔，因此爲了讓更多的朋友能接觸並學習到它，我開始了這個翻譯項目，但願感興趣的小夥伴能夠一塊兒參與翻譯，項目地址是tornado-zh on Github，翻譯好的文檔會優先發布在Read the Docs上。歡迎Issues or PR。html

Tornado Web Server

Tornado是一個Python web框架和異步網絡庫，起初在FriendFeed開發.經過使用非阻塞網絡I/O，Tornado能夠支撐上萬級的鏈接，處理長鏈接,WebSockets和其餘須要與每一個用戶保持長久鏈接的應用.python

Hello, world

這是一個簡單的Tornado的web應用::app

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()

這個例子沒有使用Tornado的任何異步特性;瞭解詳情請看 simple chat room.框架

安裝

自動安裝::curl

pip install tornado

Tornado在 PyPI列表中，可使用 pip 或 easy_install 安裝. 注意源碼發佈中包含的示例應用可能不會出如今這種方式安裝的代碼中，因此你也可能但願經過下載一份源碼包的拷貝來進行安裝.

手動安裝: 下載當前4.3版本:

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

Tornado的源碼託管在 hosted on GitHub.

Prerequisites: Tornado 4.3 運行在Python 2.6, 2.7, 和 3.2+
(對Python 2.6 和 3.2的支持是不推薦的並將在下個版本中移除). 對Python 2的2.7.9或更新版強烈
推薦提升對SSL支持. 另外Tornado的依賴包可能經過 pip or setup.py install 被自動安裝,
下面這些可選包多是有用的:

unittest2是用來在Python 2.6上運行Tornado的測試用例的(更高版本的Python是不須要的)
concurrent.futures是推薦配合Tornado使用的線程池而且能夠支持 tornado.netutil.ThreadedResolver 的用法. 它只在Python 2中被須要，Python 3已經包括了這個標準庫.
pycurl是在
tornado.curl_httpclient 中可選使用的.須要Libcurl 7.19.3.1 或更高版本;推薦使用7.21.1或更高版本.
Twisted會在
tornado.platform.twisted 中使用.
pycares是一個當線程不適用狀況下的非阻塞DNS解決方案.
Monotime添加對monotonic clock的支持,當環境中的時鐘被頻繁調整的時候，改善其可靠性. 在Python 3.3中再也不須要.

平臺: Tornado能夠運行在任何類Unix平臺上,雖然爲了最好的性能和可擴展性
只有Linux(使用 epoll)和BSD(使用 kqueue)是推薦的產品部署環境(儘管Mac OS X經過BSD發展來而且支持kqueue,但它的網絡質量不好，因此它只適合開發使用)
Tornado也能夠運行在Windows上，雖然它的配置不是官方支持的,同時也僅僅推薦開發使用.