基本用法
Request
您需要一个PoolManager实例来发出请求。 此对象处理连接池和线程安全的所有详细信息：
- 创建一个poolManager
- 使用poolManager的request()发送数据包
它的返回是是一个HTTPResponse对象，可以使用这个request发送各种格式的HTTP请求
PoolManager ---- 允许任意请求，同时透明地跟踪您所需的连接池。
http = urllib3.PoolManager()
r = http.request('GET', 'http://httpbin.org/robots.txt')
r = http.request('POST', 'http://httpbin.org/post', fields={'hello': 'world'})
HTTPResponse包含
- status
- data
- header
Request Data
您可以在headers参数指定一个字典为header
r = http.request('GET', 'http://httpbin.org/headers', headers={'X-Something': 'value'})
对于GET，HEAD和DELETE请求，您只需将query参数作为字典传入fields参数
r = http.request('GET','http://httpbin.org/get',fields={'arg': 'value'})
对于POST，PUT请求, 如果是需要在URL中加入参数，那么需要进行
手动编码
from urllib.parse import urlencode
encoded_args = urlencode({'arg': 'value'})
url = 'http://httpbin.org/post?' + encoded_args
r = http.request('POST', url)
如果使用form data 作为POST的参数，怎么可以直接在field中填入参数。
r = http.request('POST','http://httpbin.org/post',fields={'field': 'value'})
也可以指定一个json对象作为POST的body，但是这时需要设置
Content-Type为 application/json
data = {'attribute': 'value'}
encoded_data = json.dumps(data).encode('utf-8')
r = http.request('POST', 'http://httpbin.org/post', body=encoded_data, headers={'Content-Type': 'application/json'})
发送文件， 首先读入文件，然后使用fields来传送数据
with open('example.txt') as fp:
... file_data = fp.read()
r = http.request('POST', 'http://httpbin.org/post', fields={'filefield': ('example.txt', file_data),})
对HTTPS的支持
默认urllib3不去比verify HTTPS requests
如果需要验证的话需要安装certifi，并且在创建PoolManager的时候加入certifi
pip install certifi
http = urllib3.PoolManager(cert_reqs='CERT_REQUIRED',ca_certs=certifi.where())
如果证书验证失败就会raise SSLError
使用Timeout，
- request函数可以加入一个timeout参数
- 使用TimeOut对象， 这是可以指定connect timeout，或者read timeout
- 直接为PoolManager指定一个timeout
http.request('GET', 'http://httpbin.org/delay/3', timeout=urllib3.Timeout(connect=1.0, read=2.0))
http = urllib3.PoolManager(timeout=3.0)
http = urllib3.PoolManager(timeout=urllib3.Timeout(connect=1.0, read=2.0))
urllib3可以自动重试幂等请求 (同样的机制也处理重定向)
指定request函数中的retries参数（默认会re-try3次）
http.requests('GET', 'http://httpbin.org/ip', retries=10)
这个参数也可以指定给PoolManager
高级用法
PoolManager 会自动创建ConnectionPool，默认会keep最多10个ConnectionPool实例
如果需要连接更多的host，那么可以加大这个max pool
http = urllib3.PoolManager(num_pools=50)
同样，ConnectionPool类保留一个单独的HTTPConnection实例池。 这些连接在单个请求期间使用，并在请求完成时返回到池中。 默认情况下，只保存一个连接以供重复使用。 如果您同时向同一主机发出许多请求，则可能会提高性能以增加此数量：
http = urllib3.PoolManager(maxsize=10)
http = urllib3.HTTPConnectionPool('google.com', maxsize=10)
HTTPConnectionPool 针对一个特定的host产出连接
ConnectionPool的池的行为与PoolManager不同。 默认情况下，如果发出新请求且池中没有空闲连接，则将创建新连接。 但是，如果存在多个maxsize连接，则不会保存此连接。 这意味着maxsize不确定可以向特定主机打开的最大连接数，而只是确定要保留在池中的最大连接数。 但是，如果指定block = True，则最多可以打开特定主机的maxsize连接：
Proxies
通过ProxyManager来使用http proxy，用法就和PoolManager一样
proxy = urllib3.ProxyManager('http://localhost:3128/')
proxy.request('GET', 'http://google.com/')
这里直接通过proxy去发送请求
如果使用socks5的话需要使用SOCKProxyManager，这时需要安装pysocks 包
from urllib3.contrib.socks import SOCKSProxyManager
proxy = SOCKSProxyManager('socks5://localhost:8889/')
proxy.request('GET', 'http://google.com/')
取消https的验证
urllib3.disable_warnings()
