it is not a focus of development and most applications should be written to use Tornado’s own interfaces (such as tornado.web) directly instead of using WSGI. In general, Tornado code is not thread-safe which do every- thing they are going to do before returning). There are many styles of asynchronous interfaces: • Callback argument • Return a placeholder (Future, Promise, Deferred) • Deliver to a queue fetch("http://friendfeed-api.com/v2/feed/bret") json = tornado.escape.json_decode(response.body) self.write("Fetched " + str(len(json["entries"])) + " entries " "from the FriendFeed API") 26 Chapter 6. DocumentationTornado

it is not a focus of development and most applications should be written to use Tornado’s own interfaces (such as tornado.web) directly instead of using WSGI. In general, Tornado code is not thread-safe which do everything they are going to do before returning). There are many styles of asynchronous interfaces: Callback argument Return a placeholder (Future, Promise, Deferred) Deliver to a queue Callback http = tornado.httpclient.AsyncHTTPClient() response = await http.fetch("http://friendfeed- api.com/v2/feed/bret") json = tornado.escape.json_decode(response.body) self.write("Fetched

Promotion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195 16 Interfaces 199 16.1 Iteration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491 38.2 Public API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492CONTENTS viii 38 Idioms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1132 50.3 API docs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1133 50.4 Implementation

Promotion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195 16 Interfaces 199 16.1 Iteration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491 38.2 Public API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492CONTENTS viii 38 Idioms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1132 50.3 API docs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1133 50.4 Implementation

Promotion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195 16 Interfaces 199 16.1 Iteration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491 38.2 Public API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492CONTENTS viii 38 Idioms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1132 50.3 API docs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1133 50.4 Implementation

Promotion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 15 Interfaces 189 15.1 Iteration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457 37.2 Public API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458 37.3 Sessions Rounding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1112 65.9 API reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1114 66 Delimited

Promotion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 15 Interfaces 189 15.1 Iteration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457 37.2 Public API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458 37.3 Sessions Rounding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1112 65.9 API reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1114 66 Delimited

Promotion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195 16 Interfaces 199 16.1 Iteration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502 38.2 Public API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503 38.3 Sessions Idioms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1181 51.3 API docs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1182 51.4 Implementation

Promotion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195 16 Interfaces 199 16.1 Iteration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503 38.2 Public API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504 38.3 Sessions Idioms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1179 51.3 API docs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1180 51.4 Implementation

Promotion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195 16 Interfaces 199 16.1 Iteration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502 38.2 Public API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503 38.3 Sessions Idioms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1178 51.3 API docs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1179 51.4 Implementation