1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
|
``tornado.httpclient`` --- Asynchronous HTTP client
===================================================
.. automodule:: tornado.httpclient
HTTP client interfaces
----------------------
.. autoclass:: HTTPClient
:members:
.. autoclass:: AsyncHTTPClient
:members:
Request objects
---------------
.. autoclass:: HTTPRequest
:members:
Response objects
----------------
.. autoclass:: HTTPResponse
:members:
Exceptions
----------
.. autoexception:: HTTPClientError
:members:
.. exception:: HTTPError
Alias for `HTTPClientError`.
Command-line interface
----------------------
This module provides a simple command-line interface to fetch a url
using Tornado's HTTP client. Example usage::
# Fetch the url and print its body
python -m tornado.httpclient http://www.google.com
# Just print the headers
python -m tornado.httpclient --print_headers --print_body=false http://www.google.com
Implementations
~~~~~~~~~~~~~~~
.. automodule:: tornado.simple_httpclient
.. autoclass:: SimpleAsyncHTTPClient
:members:
.. module:: tornado.curl_httpclient
.. class:: CurlAsyncHTTPClient(max_clients=10, defaults=None)
``libcurl``-based HTTP client.
This implementation supports the following arguments, which can be passed
to ``configure()`` to control the global singleton, or to the constructor
when ``force_instance=True``.
``max_clients`` is the number of concurrent requests that can be in progress;
when this limit is reached additional requests will be queued.
``defaults`` is a dict of parameters that will be used as defaults on all
`.HTTPRequest` objects submitted to this client.
Example Code
~~~~~~~~~~~~
* `A simple webspider <https://github.com/tornadoweb/tornado/blob/master/demos/webspider/webspider.py>`_
shows how to fetch URLs concurrently.
* `The file uploader demo <https://github.com/tornadoweb/tornado/tree/master/demos/file_upload/>`_
uses either HTTP POST or HTTP PUT to upload files to a server.
|
