用于人类的 Python HTTP。
项目描述
使用 OpenSSL 请求 SSL_v3
==========================
我为什么要做这个 fork？
-------------------------
如果您收到如下错误：
SSLError: [Errno 1] _ssl.c:504: error:1407742E:SSL routines :SSL23_GET_SERVER_HELLO:tlsv1 警报协议版本
尝试使用这个 fork。这主要是 Ubuntu 的 OpenSSL 库无法与 python ssl 库配合使用的问题。
我将尝试通过 [official requests repo](https://github.com/kennethreitz/requests) 尽可能保持最新状态。
为什么不对请求提出问题？
------------ ------------------------------------
如果你搜索官方请求 repo 的问题，你会看到很多问题
关于无法轻松选择 SSL 版本的问题。该问题似乎是
由某些 Ubuntu 机器上的 OpenSSL 引起的，但 requests 尚未适应此
问题。
大多数问题的解决方案是“升级你的 Python”或“升级 OpenSSL”，
这两种方法都不适合我。所以这个分支将包含我
在 [#1788](https://github.com/kennethreitz/requests/pull/1788) 中找到的
hack 是 (https://github.com/kennethreitz/requests) 的更新版本/pull/799) 使
请求与实施 SSLv3 的站点一起工作。
感谢：
https ://github.com/kennethreitz/requests
和
https://github.com/joequery/requests-sslv3
请求：HTTP for Humans
================ ========
.. 图片:: https://badge.fury.io/py/requests.png
:target: http://badge.fury.io/py/requests
.. 图片:: https://pypip.in/d /requests/badge.png
:target: https://crate.io/packages/requests/
Requests 是一个 Apache2 许可的 HTTP 库，用 Python 编写，供
人类使用。
大多数现有的用于发送 HTTP 请求的 Python 模块都非常
冗长和繁琐。
Python 的内置 urllib2 模块提供了您应该需要的大部分HTTP 功能，但是 api 被彻底破坏了。执行最简单的任务
需要大量工作（甚至方法覆盖） 。事情不应该是这样的。不是在 Python 中。.. 代码块:: pycon
>>> r = requests.get('https://api.github.com', auth=('user', 'pass'))
>>> r.status_code
204
>>> r.headers['content- type']
'application/json'
>>> r.text
...
查看`相同的代码，没有请求<https://gist.github.com/973705>`_。
请求允许您发送 HTTP/1.1 请求。您可以使用简单的 Python 字典添加标题、表单数据、
多部分文件和参数，并
以相同的方式访问响应数据。它由 httplib 和 `urllib3
<https://github.com/shazow/urllib3>`_ 提供支持，但它
为您完成了所有艰苦的工作和疯狂的黑客攻击。
- 保持活动和连接池
- 具有 Cookie 持久性的会话
- 浏览器式 SSL 验证
- 基本/摘要式身份验证
- 优雅的键/值 Cookie
- 自动解压缩
- Unicode 响应体
- 多部分文件上传
- 连接超时
- 线程安全
- HTTP( S) proxy support
Installation
------------
要安装 Requests，只需：
.. code-block:: bash
$ pip install requests
或者，如果你绝对必须：
.. code-block:: bash
$ easy_install requests
但是，你真的不应该那样做。
文档
-------------
文档可在 http://docs.python-requests.org/ 获得。
贡献
----------
#。检查未解决的问题或打开新问题以围绕功能想法或错误开始讨论。有一个 `Contributor Friendly`_ 标记对于那些对代码库不太熟悉的人来说应该是理想的。
#. 如果您对某个问题或您的更改感到不舒服或不确定，请随时发送电子邮件至@sigmavirus24，他将很乐意通过电子邮件、Skype、远程配对或任何您喜欢的方式为您提供帮助。
#. 在 GitHub 上 fork `the repository`_ 以开始对 **master** 分支（或分支）进行更改。
#. 编写一个测试，表明该错误已修复或该功能按预期工作。
#. 发送拉取请求并错误维护维护者，直到它被合并和发布。:) 确保将自己添加到 AUTHORS_。
.. _`存储库`：http
://github.com/kennethreitz/requests
.. _AUTHORS：https://github.com/kennethreitz/requests/blob/master/AUTHORS.rst .._Contributor 友好：https：/ /github.com/kennethreitz/requests/issues?direction=desc&labels=Contributor+Friendly&page=1&sort=updated&state=open
.. :changelog:
Release History
---------------
2.1.0 ( 2013-12-05)
++++++++++++++++++
- 当然更新了 CA Bundle。
- 当我们在分块上传期间遇到问题时清理连接，而不是泄漏它们。
- 当分块上传成功时，将连接返回到池，而不是泄漏它。
- 匹配 HTTPbis 推荐的 HTTP 301 重定向。
- 在收到 401 时使用流式上传和 Digest Auth 时防止挂起。
- 请求设置的标头值现在始终是本机字符串类型。
- 修复以前损坏的 SNI 支持。
- 修复使用代理身份验证访问 HTTP 代理。
- 对从 URL 中提取的 HTTP Basic 用户名和密码进行解密。
- 支持 no_proxy 环境变量的 IP 地址范围
- 当用户覆盖默认的 ``Host:`` 标头时正确解析标头。
- 避免在区分大小写的服务器的情况下修改 URL。
- 对非 HTTP/HTTPS url 进行更宽松的 URL 处理。
- 接受 Python 2.6 和 2.7 中的 unicode 方法。
- 更有弹性的 cookie 处理。
- 使“响应”对象可腌制。
- 实际上在 Digest Auth 中添加了 MD5-sess，而不是上次假装喜欢。
- 更新了内部 urllib3。
- 修正了@Lukasa 缺乏品味的问题。
2.0.1 (2013-10-24)
++++++++++++++++++++
- 更新了包含的 CA Bundle，包含新的不信任和未来的自动化流程
- 在 Digest Auth 中添加了 MD5-sess
- 接受多部分文件 POST 消息中的每个文件标题。
- 修正：不要在 CONNECT 消息中发送完整的 URL。
- 修正：正确小写重定向方案。
- 修正：通过功能 API 设置时 Cookie 不持久。
- 修正：将 urllib3 ProxyError 转换为从 ConnectionError 派生的请求 ProxyError。
- 更新了内部 urllib3 和 chardet。
2.0.0 (2013-09-24)
++++++++++++++++++++
**API 更改：**
- Headers 字典中的键现在是所有 Python 版本的本机字符串，
即 Python 2 上的字节串，Python 3 上的 unicode。
- 代理 URL 现在 *必须* 有一个明确的方案。
如果不这样做，将引发“MissingSchema”异常。
- 如果“Stream=False”，现在超时适用于读取时间。
- “RequestException”现在是“IOError”的子类，而不是“RuntimeError”。
- 为“PreparedRequest”对象添加了新方法：“PreparedRequest.copy()”。
- 为“Session”对象添加了新方法：“Session.update_request()”。这个
方法使用存储在 Session 上的数据（例如 cookie）更新一个 Request 对象
。
- 为“Session”对象添加了新方法：“Session.prepare_request()”。此
方法更新并准备一个“Request”对象，并返回
相应的“PreparedRequest”对象。
- 为“HTTPAdapter”对象添加了新方法：“HTTPAdapter.proxy_headers()”。
这不应该直接调用，而是改进了子类接口。
- 由不正确的分块编码引起的``httplib.IncompleteRead`` 异常
现在将引发请求``ChunkedEncodingError``。
- 无效的百分比转义序列现在会引发 Requests ``InvalidURL``
异常。
- HTTP 208 不再使用原因短语“im_used”。正确使用
``"already_reported"``。
- 添加了 HTTP 226 原因（``"im_used"``）。
**错误修正：**
- 大大改进了代理支持，包括 CONNECT 动词。特别感谢
为此改进而努力的许多贡献者。
- 现在
收到 401 身份验证响应时会正确管理 Cookie。
- 分块编码修复。
- 支持混合案例方案。
- 更好地处理流式下载。
- 从更多位置检索环境代理。
- 小 cookie 修复。
- 改进了重定向行为。
- 改进了流媒体行为，特别是对于压缩数据。
- 各种小的 Python 3 文本编码错误。
- ``.netrc`` 不再覆盖显式身份验证。
- 由钩子设置的 Cookies 现在可以正确地保存在 Sessions 上。
- 修复在其主机字段中指定端口号的 cookie 的问题。
- ``BytesIO`` 可用于执行流式上传。
- 更慷慨地解析“no_proxy”环境变量。
- 非字符串对象可以与文件一起传入数据值。
1.2.3 (2013-05-25)
++++++++++++++++++++
- 简单打包修复
1.2.2 (2013-05-23)
++++++++ ++++++++++
- 简单打包修复
1.2.1 (2013-05-20)
++++++++++++++++++
- Python 3.3.2 兼容性
- 始终百分比编码位置标头
- 修复连接适配器匹配为最具体的第一个
- 用于传递块参数的默认连接适配器的新参数
- 在没有链接头时防止 KeyError
1.2.0 (2013-03-31)
+++++++ +++++++++++
- 修复了会话和请求上的 cookie
- 显着改变了 hooks 的调度方式 - hooks 现在接收
用户在发出请求时指定的所有参数，因此 hooks 可以
使用相同的参数。
这对于身份验证处理程序作者来说尤其必要
- 证书支持已被删除
- 修复了使用带有 body ``signature_type`` 的 OAuth 1 未发送数据的错误
- 感谢 @Lukasa 的主要代理工作，包括
从代理 url解析代理身份验证
- 修复 DigestAuth 处理过多的 401
- 更新供应商的 urllib3 以包括 SSL 错误修复
- 允许将关键字参数传递给 ``json.loads()``通过
`Response.json()` 方法- 默认情况下不要在 `GET` 或 `HEAD` 请求
中发送 `Content-Length` 标头- 将 `elapsed` 属性添加到` `Response` 对象表示请求 花费了多长时间。- 修复 ``RequestsCookieJar`` - 会话和适配器现在是可挑选的，即可以与 多处理库一起使用- 将 charade 更新到版本 1.0.3
分发钩子的方式的变化可能会导致很多
问题。
1.1.0 (2013-01-10)
++++++++++++++++++++
- CHUNKED REQUESTS
- 支持可迭代的响应主体
- 假设服务器保持重定向参数
- 允许显式内容类型为文件数据指定
- 查找键时使 merge_kwargs 不区分大小写
1.0.3 (2012-12-18)
++++++++++++++++++
- 修复文件上传编码错误
- 修复cookie 行为
1.0.2 (2012-12-17)
++++++++++++++++++
- HTTPAdapter 的代理修复。
1.0.1 (2012-12-17)
++++++++++++++++++++
- 证书验证异常错误。
- HTTPAdapter 的代理修复。
1.0.0 (2012-12-17)
++++++++++++++++++++
- 大规模重构和简化
- 切换到 Apache 2.0 许可证
- 可交换连接适配器
- 可安装连接适配器
- 可变 ProcessedRequest链
- /s/prefetch/stream
- 删除所有配置
- 标准库日志记录
- 使 Response.json() 可调用，而不是属性。
- 使用新的 charade 项目，它提供 python 2 和 3 同时 chardet。
- 删除除“响应”之外的所有挂钩
- 删除所有身份验证助手（OAuth、Kerberos）
这不是向后兼容的更改。
0.14.2 (2012-10-27)
+++++++++++++++++++++
- 改进了 MIME 兼容的 JSON 处理
- 代理修复
- 路径 hack 修复
- 不区分大小写的内容编码标头
- 支持表单帖子中的 CJK 参数
0.14.1 (2012-10-01)
+++++++++++++++++ ++
- Python 3.3 兼容性
- 简单地默认接受编码
-错误
修复 0.14.0 (2012-09-02)
++++++++++++++++++++++
- 如果没有更多 iter_content 错误已经下载了。
0.13.9 (2012-08-25)
+++++++++++++++++++
- 修复 OAuth + POSTs
- 从 dispatch_hook 中删除异常
- 一般错误修复
0.13.8 (2012- 08-21)
+++++++++++++++++++
- 令人难以置信的链接头支持:)
0.13.7 (2012-08-19)
++++++++++ +++++++++
- 到处都支持（键，值）列表。
- 摘要身份验证改进。
- 确保代理排除正常工作。
- 更清晰的 UnicodeError 异常。
- 自动将 URL 转换为 tsrings（fURL 等）
- 错误修正。
0.13.6 (2012-08-06)
+++++++++++++++++++++
- 期待已久的挂起连接修复！
0.13.5 (2012-07-27)
+++++++++++++++++++
- 打包修复
0.13.4 (2012-07-27)
++++++++ +++++++++++
- GSSAPI/Kerberos 身份验证！
- App Engine 2.7 修复！
- 修复泄漏连接（来自 urllib3 更新）
- OAuthlib 路径黑客修复
- OAuthlib URL 参数修复。
0.13.3 (2012-07-12)
+++++++++++++++++++
- 如果可用，请使用 simplejson。
- 不要在超时后面隐藏 SSLErrors。
- 使用包含片段的 url 修复了参数处理。
- 显着改进了用户代理中的信息。
- 当 verify=False
0.13.2 (2012-06-28)
+++++++++++++++++++++时忽略客户端证书
- 零依赖（再次）！
- 新：Response.reason
- 在 OAuth 1.0 中签名查询字符串参数
- 当 verify=False 时不再忽略客户端证书
- 添加 openSUSE 证书支持
0.13.1 (2012-06-07)
++++++++++++ +++++++
- 允许将文件或类似文件的对象作为数据传递。
- 允许挂钩返回指示错误的响应。
- 修复无正文响应的 Response.text 和 Response.json。
0.13.0 (2012-05-29)
+++++++++++++++++++++
- 删除 Requests.async 以支持 `grequests <https://github.com/kennethreitz /grequests>`_
- 允许禁用 cookie 持久性。
- 安全模式的新实现
- cookies.get 现在支持默认参数
- 当使用 return_response=False 调用 Session.request 时不保存会话 cookie
- 环境：no_proxy 支持。
- RequestsCookieJar 改进。
- 各种错误修复。
0.12.1 (2012-05-08)
+++++++++++++++++++++
- 新的``Response.json`` 属性。
- 能够添加字符串文件上传。
- 修复 iter_lines 超出范围的问题。
- 修复 iter_content 默认大小。
- 修复包含文件的 POST 重定向。
0.12.0 (2012-05-02)
+++++++++++++++++++++
- 实验 OAUTH 支持！
- 正确的 CookieJar 支持的 cookie 界面，具有令人敬畏的类 dict 界面。
- 非迭代内容块的速度修复。
- 将“pre_request”移动到更有用的地方。
- 新的“pre_send”钩子。
- 懒惰地编码数据、参数、文件。
- 如果“certify”不可用，则加载系统证书包。
- 清理，修复。
0.11.2 (2012-04-22)
+++++++++++++++++++++
- 如果“certifi”不可用，尝试使用操作系统的证书包。
- 无限摘要身份验证重定向修复。
- 多部分文件上传改进。
- 修复 URL 中无效 %encodings 的解码。
- 如果响应中没有内容，不要在第二次尝试读取该内容时抛出错误。
- 上传重定向数据。
0.11.1 (2012-03-30)
+++++++++++++++++++++
* POST 重定向现在打破 RFC 以执行浏览器所做的事情：跟进 GET。
* 新的“strict_mode”配置禁用新的重定向行为。
0.11.0 (2012-03-14)
+++++++++++++++++++
* 私有 SSL 证书支持
* 从 Gevent 猴子补丁中删除 select.poll
* 删除用于分块传输编码的冗余生成器* 修复：Response.ok 在安全模式 0.10.8 (2012-03-09)
中引发超时异常+++++++++++++++++++++
* 生成分块 ValueError 修复
* 通过环境变量配置代理
* 简化 iter_lines。
* 用于禁用系统/环境提示的新 `trust_env` 配置。
* 抑制 cookie 错误。
0.10.7 (2012-03-07)
+++++++++++++++++++
* `encode_uri` = 假
0.10.6 (2012-02-25)
+++++ ++++++++++++++
* 允许 '=' 在 cookie 中。
0.10.5 (2012-02-25)
+++++++++++++++++++++
* 0 内容长度修复的响应正文。
* 新的 async.imap。
* 不要在 netrc 上失败。
0.10.4 (2012-02-20)
+++++++++++++++++++
*荣誉netrc。
0.10.3 (2012-02-20)
+++++++++++++++++++
* HEAD 请求不再遵循重定向。
* raise_for_status() 不再为 3xx 加注。
* 使会话对象可挑选。
* 无效架构 URL 的 ValueError。
0.10.2 (2012-01-15)
+++++++++++++++++++++
* 大大改进了 URL 引用。
* 额外允许的 cookie 键值。
* 尝试修复“打开的文件过多”错误
* 在第一次通过时替换 unicode 错误，不需要第二次通过。
* 在查询插入之前将“/”附加到裸域 url。
* 异常现在继承自 RuntimeError。
* 二进制上传 + 身份验证修复。
* Bug修复。
0.10.1 (2012-01-23)
+++++++++++++++++++++
* Python 3 支持！
* 放弃 2.5 支持。(*向后不兼容*)
0.10.0 (2012-01-21)
+++++++++++++++++++
* ``Response.content`` 现在是字节。（*向后不兼容*）
*新的 ``Response.text`` 是 unicode-only。
* 如果没有指定 ``Response.encoding`` 并且 ``chardet`` 可用，``Respoonse.text`` 将猜测编码。
* 默认为“文本”子类型的 ISO-8859-1（西方）编码。
*删除`decode_unicode`。（*向后不兼容*）
* 新的多钩系统。
* 新的 ``Response.register_hook`` 用于在管道中注册钩子。
* ``Response.url`` 现在是 Unicode。
0.9.3 (2012-01-18)
++++++++++++++++++++
* SSL 验证=错误修正（在 Windows 机器上明显）。
0.9.2 (2012-01-18)
++++++++++++++++++++
* 异步 async.send 方法。
*支持具有边界的正确块流。
* 会话类的会话参数。
* 打印整个钩子回溯，而不仅仅是异常实例。
* 修复待处理的下一行的 response.iter_lines。
* 修复但在带有查询字符串的 URI 的 HTTP-digest auth 中。
* 修复事件挂钩部分。
* Urllib3 更新。
0.9.1 (2012-01-06)
++++++++++++++++++
* 自动 Response.raise_for_status() 的危险模式
* Response.iter_lines 重构
0.9.0 (2011-12- 28)
++++++++++++++++++++
* 验证 ssl 是默认的。
0.8.9 (2011-12-28)
++++++++++++++++++++
* 包装修复。
0.8.8 (2011-12-28)
++++++++++++++++++++
* SSL 证书验证！
* Cerifi 的发布：Mozilla 的证书列表。
* SSL 请求的新“验证”参数。
* Urllib3 更新。
0.8.7 (2011-12-24)
++++++++++++++++++
* iter_lines 最后一行截断修复
* 强制异步请求的安全模式
* 更一致地处理安全模式异常
* 修复迭代关于
安全模式 0.8.6 (2011-12-18)中的空响应
++++++++++++++++++
* 套接字超时修复。
*代理授权支持。
0.8.5 (2011-12-14)
++++++++++++++++++++
* Response.iter_lines！
0.8.4 (2011-12-11)
++++++++++++++++++++
* 预取错误修复。
* 为已安装版本添加了许可证。
0.8.3 (2011-11-27)
++++++++++++++++++++
* 将身份验证系统转换为使用更简单的可调用对象。
* API 方法的新会话参数。
* 登录时显示完整的 URL。
0.8.2 (2011-11-19)
++++++++++++++++++++
* 新的 Unicode 解码系统，基于可覆盖的 `Response.encoding`。
* 正确的 URL 斜杠引号处理。
* 允许使用带有“[”、“]”和“_”的 Cookie。
0.8.1 (2011-11-15)
++++++++++++++++++++
* URL 请求路径修复
* 代理修复。
* 超时修复。
0.8.0 (2011-11-13)
++++++++++++++++++++
* Keep-alive 支持！
* 完全删除 Urllib2
* 完全删除海报
* 完全删除 CookieJars
* 引发新的 ConnectionError
* Safe_mode 用于错误捕获
* 请求方法的预取参数
* OPTION 方法
* 异步池大小限制
* 文件上传发送实名
* 在 urllib3
0.7.6 (2011-11 ) 中提供-07)
++++++++++++++++++
* Digest authentication bugfix (attach query data to path)
0.7.5 (2011-11-04)
++++++++ ++++++++++
* Response.content = None 如果有无效的响应。
* 重定向授权处理。
0.7.4 (2011-10-26)
++++++++++++++++++++
* 会话挂钩修复。
0.7.3 (2011-10-23)
++++++++++++++++++++
*摘要身份验证修复。
0.7.2 (2011-10-23)
++++++++++++++++++++
*补丁修复。
0.7.1 (2011-10-23)
++++++++++++++++++++
* 远离 urllib2 身份验证处理。
* 完全删除 AuthManager、AuthObject 等。
* 新的基于元组的身份验证系统，带有处理程序回调。
0.7.0 (2011-10-22)
++++++++++++++++++++
* 会话现在是主要接口。
* 已弃用 InvalidMethodException。
*补丁修复。
*新的配置系统（没有更多的全局设置）。
0.6.6 (2011-10-19)
++++++++++++++++++++
* 会话参数错误修复（参数合并）。
0.6.5 (2011-10-18)
++++++++++++++++++++
* 离线（快速）测试套件。
* 会话字典参数合并。
0.6.4 (2011-10-13)
++++++++++++++++++++
* 基于 HTTP 标头的 unicode 自动解码。
*新的``decode_unicode``设置。
*删除“r.read/close”方法。
* 用于高级响应使用的新 ``r.faw`` 接口。*
* 参数化标头的自动扩展。
0.6.3 (2011-10-13)
++++++++++++++++++++
* 美丽的``requests.async`` 模块，用于使用 gevent 发出异步请求。
0.6.2 (2011-10-09)
++++++++++++++++++++
* GET/HEAD 遵循 allow_redirects=False。
0.6.1 (2011-08-20)
++++++++++++++++++++
* 增强状态码体验``\o/``
* 设置最大重定向数（``settings.max_redirects``）
* 完整的 Unicode URL 支持
* 支持无协议重定向。
* 允许任意请求类型。
* 错误修正
0.6.0 (2011-08-17)
++++++++++++++++++++
* 新的回调挂钩系统
* 新的持久会话对象和上下文管理器
* 透明的 Dict-cookie 处理
*状态代码参考对象
* 已删除 Response.cached
* 添加了 Response.request
* 所有 args 都是 kwargs
* 相对重定向支持
* HTTPError 处理改进
* 改进 https 测试
* 错误修正
0.5.1 (2011-07-23)
+++++++ +++++++++++++
* 国际域名支持！
* 访问标头而不获取整个正文（``read()``）
* 使用列表作为参数的 dicts
* 添加强制基本身份验证
* 强制基本是默认身份验证类型
* ``python-requests.org`` 默认用户代理标头
* CaseInsensitiveDict 小写缓存
* Response.history 错误修正
0.5.0 (2011-06-21)
++++++++++++++++++++
* PATCH 支持
* 支持代理
* HTTPBin 测试套件
* 重定向修复
* settings.verbose 流写入
* 所有方法的查询字符串
* URLErrors（连接被拒绝、超时、无效 URL）被视为明确提出
``r.requests.get('hwe://blah'); r.raise_for_status()``
0.4.1 (2011-05-22)
++++++++++++++++++++
* 改进的重定向处理
* 新的 'allow_redirects' 参数用于跟随非 GET /HEAD 重定向
* 设置模块重构
0.4.0 (2011-05-15)
++++++++++++++++++
* Response.history：重定向响应列表
* 不区分大小写的标题字典！
* Unicode URL
0.3.4 (2011-05-14)
++++++++++++++++++++
* Urllib2 HTTPAuthentication 递归修复（基本/摘要）
* 内部重构
* 字节数据上传错误修复
0.3 .3 (2011-05-12)
++++++++++++++++++
* 请求超时
* Unicode url 编码数据
* 设置上下文管理器和模块
0.3.2 (2011-04-15)
++++++++++++++++++++
* GZip 编码内容的自动解压缩
* AutoAuth 支持 Tupled HTTP Auth
0.3。 1 (2011-04-01)
++++++++++++++++++
* Cookie 更改
* Response.read()
* 海报修复
0.3.0 (2011-02-25)
++ ++++++++++++++++++
* 自动身份验证 API 更改
* 更智能的查询 URL 参数化
* 允许文件上传和 POST 数据一起
* 新的身份验证管理器系统
- 更简单的基本 HTTP 系统
- 支持所有内置urllib2 Auths
- 允许自定义身份验证处理程序
0.2.4 (2011-02-19)
++++++++++++++++++
* Python 2.5 支持
* PyPy-c v1.4 支持
* 自动身份验证测试
* 改进的请求对象构造函数
0.2.3 (2011-02-15)
++++++++++++++++++
* 新的 HTTPHandling 方法
- Response.__nonzero__（如果 HTTP 状态不正确，则为 false）
- Response.ok（如果预期 HTTP 状态为 True ） - Response.error（如果 HTTP 状态
不正确，则记录 HTTPError）
- Response.raise_for_status()（引发存储的 HTTPError）
0.2 .2 (2011-02-14)
++++++++++++++++++++
* 在发生 HTTPError 时仍然处理请求。（问题 #2）
* Eventlet 和 Gevent Monkeypatch 支持。
* Cookie 支持（问题 #1）
0.2.1 (2011-02-14)
++++++++++++++++++
* 为多部分编码文件上传的 POST 和 PUT 请求添加了文件属性。
* 为上下文添加 Request.url 属性并重定向
0.2.0 (2011-02-14)
++++++++++++++++++
* 诞生！
0.0.1 (2011-02-13)
++++++++++++++++++++
* 挫折
* 构想
==========================
我为什么要做这个 fork？
-------------------------
如果您收到如下错误：
SSLError: [Errno 1] _ssl.c:504: error:1407742E:SSL routines :SSL23_GET_SERVER_HELLO:tlsv1 警报协议版本
尝试使用这个 fork。这主要是 Ubuntu 的 OpenSSL 库无法与 python ssl 库配合使用的问题。
我将尝试通过 [official requests repo](https://github.com/kennethreitz/requests) 尽可能保持最新状态。
为什么不对请求提出问题？
------------ ------------------------------------
如果你搜索官方请求 repo 的问题，你会看到很多问题
关于无法轻松选择 SSL 版本的问题。该问题似乎是
由某些 Ubuntu 机器上的 OpenSSL 引起的，但 requests 尚未适应此
问题。
大多数问题的解决方案是“升级你的 Python”或“升级 OpenSSL”，
这两种方法都不适合我。所以这个分支将包含我
在 [#1788](https://github.com/kennethreitz/requests/pull/1788) 中找到的
hack 是 (https://github.com/kennethreitz/requests) 的更新版本/pull/799) 使
请求与实施 SSLv3 的站点一起工作。
感谢：
https ://github.com/kennethreitz/requests
和
https://github.com/joequery/requests-sslv3
请求：HTTP for Humans
================ ========
.. 图片:: https://badge.fury.io/py/requests.png
:target: http://badge.fury.io/py/requests
.. 图片:: https://pypip.in/d /requests/badge.png
:target: https://crate.io/packages/requests/
Requests 是一个 Apache2 许可的 HTTP 库，用 Python 编写，供
人类使用。
大多数现有的用于发送 HTTP 请求的 Python 模块都非常
冗长和繁琐。
Python 的内置 urllib2 模块提供了您应该需要的大部分HTTP 功能，但是 api 被彻底破坏了。执行最简单的任务
需要大量工作（甚至方法覆盖） 。事情不应该是这样的。不是在 Python 中。.. 代码块:: pycon
>>> r = requests.get('https://api.github.com', auth=('user', 'pass'))
>>> r.status_code
204
>>> r.headers['content- type']
'application/json'
>>> r.text
...
查看`相同的代码，没有请求<https://gist.github.com/973705>`_。
请求允许您发送 HTTP/1.1 请求。您可以使用简单的 Python 字典添加标题、表单数据、
多部分文件和参数，并
以相同的方式访问响应数据。它由 httplib 和 `urllib3
<https://github.com/shazow/urllib3>`_ 提供支持，但它
为您完成了所有艰苦的工作和疯狂的黑客攻击。
- 保持活动和连接池
- 具有 Cookie 持久性的会话
- 浏览器式 SSL 验证
- 基本/摘要式身份验证
- 优雅的键/值 Cookie
- 自动解压缩
- Unicode 响应体
- 多部分文件上传
- 连接超时
- 线程安全
- HTTP( S) proxy support
Installation
------------
要安装 Requests，只需：
.. code-block:: bash
$ pip install requests
或者，如果你绝对必须：
.. code-block:: bash
$ easy_install requests
但是，你真的不应该那样做。
文档
-------------
文档可在 http://docs.python-requests.org/ 获得。
贡献
----------
#。检查未解决的问题或打开新问题以围绕功能想法或错误开始讨论。有一个 `Contributor Friendly`_ 标记对于那些对代码库不太熟悉的人来说应该是理想的。
#. 如果您对某个问题或您的更改感到不舒服或不确定，请随时发送电子邮件至@sigmavirus24，他将很乐意通过电子邮件、Skype、远程配对或任何您喜欢的方式为您提供帮助。
#. 在 GitHub 上 fork `the repository`_ 以开始对 **master** 分支（或分支）进行更改。
#. 编写一个测试，表明该错误已修复或该功能按预期工作。
#. 发送拉取请求并错误维护维护者，直到它被合并和发布。:) 确保将自己添加到 AUTHORS_。
.. _`存储库`：http
://github.com/kennethreitz/requests
.. _AUTHORS：https://github.com/kennethreitz/requests/blob/master/AUTHORS.rst .._Contributor 友好：https：/ /github.com/kennethreitz/requests/issues?direction=desc&labels=Contributor+Friendly&page=1&sort=updated&state=open
.. :changelog:
Release History
---------------
2.1.0 ( 2013-12-05)
++++++++++++++++++
- 当然更新了 CA Bundle。
- 当我们在分块上传期间遇到问题时清理连接，而不是泄漏它们。
- 当分块上传成功时，将连接返回到池，而不是泄漏它。
- 匹配 HTTPbis 推荐的 HTTP 301 重定向。
- 在收到 401 时使用流式上传和 Digest Auth 时防止挂起。
- 请求设置的标头值现在始终是本机字符串类型。
- 修复以前损坏的 SNI 支持。
- 修复使用代理身份验证访问 HTTP 代理。
- 对从 URL 中提取的 HTTP Basic 用户名和密码进行解密。
- 支持 no_proxy 环境变量的 IP 地址范围
- 当用户覆盖默认的 ``Host:`` 标头时正确解析标头。
- 避免在区分大小写的服务器的情况下修改 URL。
- 对非 HTTP/HTTPS url 进行更宽松的 URL 处理。
- 接受 Python 2.6 和 2.7 中的 unicode 方法。
- 更有弹性的 cookie 处理。
- 使“响应”对象可腌制。
- 实际上在 Digest Auth 中添加了 MD5-sess，而不是上次假装喜欢。
- 更新了内部 urllib3。
- 修正了@Lukasa 缺乏品味的问题。
2.0.1 (2013-10-24)
++++++++++++++++++++
- 更新了包含的 CA Bundle，包含新的不信任和未来的自动化流程
- 在 Digest Auth 中添加了 MD5-sess
- 接受多部分文件 POST 消息中的每个文件标题。
- 修正：不要在 CONNECT 消息中发送完整的 URL。
- 修正：正确小写重定向方案。
- 修正：通过功能 API 设置时 Cookie 不持久。
- 修正：将 urllib3 ProxyError 转换为从 ConnectionError 派生的请求 ProxyError。
- 更新了内部 urllib3 和 chardet。
2.0.0 (2013-09-24)
++++++++++++++++++++
**API 更改：**
- Headers 字典中的键现在是所有 Python 版本的本机字符串，
即 Python 2 上的字节串，Python 3 上的 unicode。
- 代理 URL 现在 *必须* 有一个明确的方案。
如果不这样做，将引发“MissingSchema”异常。
- 如果“Stream=False”，现在超时适用于读取时间。
- “RequestException”现在是“IOError”的子类，而不是“RuntimeError”。
- 为“PreparedRequest”对象添加了新方法：“PreparedRequest.copy()”。
- 为“Session”对象添加了新方法：“Session.update_request()”。这个
方法使用存储在 Session 上的数据（例如 cookie）更新一个 Request 对象
。
- 为“Session”对象添加了新方法：“Session.prepare_request()”。此
方法更新并准备一个“Request”对象，并返回
相应的“PreparedRequest”对象。
- 为“HTTPAdapter”对象添加了新方法：“HTTPAdapter.proxy_headers()”。
这不应该直接调用，而是改进了子类接口。
- 由不正确的分块编码引起的``httplib.IncompleteRead`` 异常
现在将引发请求``ChunkedEncodingError``。
- 无效的百分比转义序列现在会引发 Requests ``InvalidURL``
异常。
- HTTP 208 不再使用原因短语“im_used”。正确使用
``"already_reported"``。
- 添加了 HTTP 226 原因（``"im_used"``）。
**错误修正：**
- 大大改进了代理支持，包括 CONNECT 动词。特别感谢
为此改进而努力的许多贡献者。
- 现在
收到 401 身份验证响应时会正确管理 Cookie。
- 分块编码修复。
- 支持混合案例方案。
- 更好地处理流式下载。
- 从更多位置检索环境代理。
- 小 cookie 修复。
- 改进了重定向行为。
- 改进了流媒体行为，特别是对于压缩数据。
- 各种小的 Python 3 文本编码错误。
- ``.netrc`` 不再覆盖显式身份验证。
- 由钩子设置的 Cookies 现在可以正确地保存在 Sessions 上。
- 修复在其主机字段中指定端口号的 cookie 的问题。
- ``BytesIO`` 可用于执行流式上传。
- 更慷慨地解析“no_proxy”环境变量。
- 非字符串对象可以与文件一起传入数据值。
1.2.3 (2013-05-25)
++++++++++++++++++++
- 简单打包修复
1.2.2 (2013-05-23)
++++++++ ++++++++++
- 简单打包修复
1.2.1 (2013-05-20)
++++++++++++++++++
- Python 3.3.2 兼容性
- 始终百分比编码位置标头
- 修复连接适配器匹配为最具体的第一个
- 用于传递块参数的默认连接适配器的新参数
- 在没有链接头时防止 KeyError
1.2.0 (2013-03-31)
+++++++ +++++++++++
- 修复了会话和请求上的 cookie
- 显着改变了 hooks 的调度方式 - hooks 现在接收
用户在发出请求时指定的所有参数，因此 hooks 可以
使用相同的参数。
这对于身份验证处理程序作者来说尤其必要
- 证书支持已被删除
- 修复了使用带有 body ``signature_type`` 的 OAuth 1 未发送数据的错误
- 感谢 @Lukasa 的主要代理工作，包括
从代理 url解析代理身份验证
- 修复 DigestAuth 处理过多的 401
- 更新供应商的 urllib3 以包括 SSL 错误修复
- 允许将关键字参数传递给 ``json.loads()``通过
`Response.json()` 方法- 默认情况下不要在 `GET` 或 `HEAD` 请求
中发送 `Content-Length` 标头- 将 `elapsed` 属性添加到` `Response` 对象表示请求 花费了多长时间。- 修复 ``RequestsCookieJar`` - 会话和适配器现在是可挑选的，即可以与 多处理库一起使用- 将 charade 更新到版本 1.0.3
分发钩子的方式的变化可能会导致很多
问题。
1.1.0 (2013-01-10)
++++++++++++++++++++
- CHUNKED REQUESTS
- 支持可迭代的响应主体
- 假设服务器保持重定向参数
- 允许显式内容类型为文件数据指定
- 查找键时使 merge_kwargs 不区分大小写
1.0.3 (2012-12-18)
++++++++++++++++++
- 修复文件上传编码错误
- 修复cookie 行为
1.0.2 (2012-12-17)
++++++++++++++++++
- HTTPAdapter 的代理修复。
1.0.1 (2012-12-17)
++++++++++++++++++++
- 证书验证异常错误。
- HTTPAdapter 的代理修复。
1.0.0 (2012-12-17)
++++++++++++++++++++
- 大规模重构和简化
- 切换到 Apache 2.0 许可证
- 可交换连接适配器
- 可安装连接适配器
- 可变 ProcessedRequest链
- /s/prefetch/stream
- 删除所有配置
- 标准库日志记录
- 使 Response.json() 可调用，而不是属性。
- 使用新的 charade 项目，它提供 python 2 和 3 同时 chardet。
- 删除除“响应”之外的所有挂钩
- 删除所有身份验证助手（OAuth、Kerberos）
这不是向后兼容的更改。
0.14.2 (2012-10-27)
+++++++++++++++++++++
- 改进了 MIME 兼容的 JSON 处理
- 代理修复
- 路径 hack 修复
- 不区分大小写的内容编码标头
- 支持表单帖子中的 CJK 参数
0.14.1 (2012-10-01)
+++++++++++++++++ ++
- Python 3.3 兼容性
- 简单地默认接受编码
-错误
修复 0.14.0 (2012-09-02)
++++++++++++++++++++++
- 如果没有更多 iter_content 错误已经下载了。
0.13.9 (2012-08-25)
+++++++++++++++++++
- 修复 OAuth + POSTs
- 从 dispatch_hook 中删除异常
- 一般错误修复
0.13.8 (2012- 08-21)
+++++++++++++++++++
- 令人难以置信的链接头支持:)
0.13.7 (2012-08-19)
++++++++++ +++++++++
- 到处都支持（键，值）列表。
- 摘要身份验证改进。
- 确保代理排除正常工作。
- 更清晰的 UnicodeError 异常。
- 自动将 URL 转换为 tsrings（fURL 等）
- 错误修正。
0.13.6 (2012-08-06)
+++++++++++++++++++++
- 期待已久的挂起连接修复！
0.13.5 (2012-07-27)
+++++++++++++++++++
- 打包修复
0.13.4 (2012-07-27)
++++++++ +++++++++++
- GSSAPI/Kerberos 身份验证！
- App Engine 2.7 修复！
- 修复泄漏连接（来自 urllib3 更新）
- OAuthlib 路径黑客修复
- OAuthlib URL 参数修复。
0.13.3 (2012-07-12)
+++++++++++++++++++
- 如果可用，请使用 simplejson。
- 不要在超时后面隐藏 SSLErrors。
- 使用包含片段的 url 修复了参数处理。
- 显着改进了用户代理中的信息。
- 当 verify=False
0.13.2 (2012-06-28)
+++++++++++++++++++++时忽略客户端证书
- 零依赖（再次）！
- 新：Response.reason
- 在 OAuth 1.0 中签名查询字符串参数
- 当 verify=False 时不再忽略客户端证书
- 添加 openSUSE 证书支持
0.13.1 (2012-06-07)
++++++++++++ +++++++
- 允许将文件或类似文件的对象作为数据传递。
- 允许挂钩返回指示错误的响应。
- 修复无正文响应的 Response.text 和 Response.json。
0.13.0 (2012-05-29)
+++++++++++++++++++++
- 删除 Requests.async 以支持 `grequests <https://github.com/kennethreitz /grequests>`_
- 允许禁用 cookie 持久性。
- 安全模式的新实现
- cookies.get 现在支持默认参数
- 当使用 return_response=False 调用 Session.request 时不保存会话 cookie
- 环境：no_proxy 支持。
- RequestsCookieJar 改进。
- 各种错误修复。
0.12.1 (2012-05-08)
+++++++++++++++++++++
- 新的``Response.json`` 属性。
- 能够添加字符串文件上传。
- 修复 iter_lines 超出范围的问题。
- 修复 iter_content 默认大小。
- 修复包含文件的 POST 重定向。
0.12.0 (2012-05-02)
+++++++++++++++++++++
- 实验 OAUTH 支持！
- 正确的 CookieJar 支持的 cookie 界面，具有令人敬畏的类 dict 界面。
- 非迭代内容块的速度修复。
- 将“pre_request”移动到更有用的地方。
- 新的“pre_send”钩子。
- 懒惰地编码数据、参数、文件。
- 如果“certify”不可用，则加载系统证书包。
- 清理，修复。
0.11.2 (2012-04-22)
+++++++++++++++++++++
- 如果“certifi”不可用，尝试使用操作系统的证书包。
- 无限摘要身份验证重定向修复。
- 多部分文件上传改进。
- 修复 URL 中无效 %encodings 的解码。
- 如果响应中没有内容，不要在第二次尝试读取该内容时抛出错误。
- 上传重定向数据。
0.11.1 (2012-03-30)
+++++++++++++++++++++
* POST 重定向现在打破 RFC 以执行浏览器所做的事情：跟进 GET。
* 新的“strict_mode”配置禁用新的重定向行为。
0.11.0 (2012-03-14)
+++++++++++++++++++
* 私有 SSL 证书支持
* 从 Gevent 猴子补丁中删除 select.poll
* 删除用于分块传输编码的冗余生成器* 修复：Response.ok 在安全模式 0.10.8 (2012-03-09)
中引发超时异常+++++++++++++++++++++
* 生成分块 ValueError 修复
* 通过环境变量配置代理
* 简化 iter_lines。
* 用于禁用系统/环境提示的新 `trust_env` 配置。
* 抑制 cookie 错误。
0.10.7 (2012-03-07)
+++++++++++++++++++
* `encode_uri` = 假
0.10.6 (2012-02-25)
+++++ ++++++++++++++
* 允许 '=' 在 cookie 中。
0.10.5 (2012-02-25)
+++++++++++++++++++++
* 0 内容长度修复的响应正文。
* 新的 async.imap。
* 不要在 netrc 上失败。
0.10.4 (2012-02-20)
+++++++++++++++++++
*荣誉netrc。
0.10.3 (2012-02-20)
+++++++++++++++++++
* HEAD 请求不再遵循重定向。
* raise_for_status() 不再为 3xx 加注。
* 使会话对象可挑选。
* 无效架构 URL 的 ValueError。
0.10.2 (2012-01-15)
+++++++++++++++++++++
* 大大改进了 URL 引用。
* 额外允许的 cookie 键值。
* 尝试修复“打开的文件过多”错误
* 在第一次通过时替换 unicode 错误，不需要第二次通过。
* 在查询插入之前将“/”附加到裸域 url。
* 异常现在继承自 RuntimeError。
* 二进制上传 + 身份验证修复。
* Bug修复。
0.10.1 (2012-01-23)
+++++++++++++++++++++
* Python 3 支持！
* 放弃 2.5 支持。(*向后不兼容*)
0.10.0 (2012-01-21)
+++++++++++++++++++
* ``Response.content`` 现在是字节。（*向后不兼容*）
*新的 ``Response.text`` 是 unicode-only。
* 如果没有指定 ``Response.encoding`` 并且 ``chardet`` 可用，``Respoonse.text`` 将猜测编码。
* 默认为“文本”子类型的 ISO-8859-1（西方）编码。
*删除`decode_unicode`。（*向后不兼容*）
* 新的多钩系统。
* 新的 ``Response.register_hook`` 用于在管道中注册钩子。
* ``Response.url`` 现在是 Unicode。
0.9.3 (2012-01-18)
++++++++++++++++++++
* SSL 验证=错误修正（在 Windows 机器上明显）。
0.9.2 (2012-01-18)
++++++++++++++++++++
* 异步 async.send 方法。
*支持具有边界的正确块流。
* 会话类的会话参数。
* 打印整个钩子回溯，而不仅仅是异常实例。
* 修复待处理的下一行的 response.iter_lines。
* 修复但在带有查询字符串的 URI 的 HTTP-digest auth 中。
* 修复事件挂钩部分。
* Urllib3 更新。
0.9.1 (2012-01-06)
++++++++++++++++++
* 自动 Response.raise_for_status() 的危险模式
* Response.iter_lines 重构
0.9.0 (2011-12- 28)
++++++++++++++++++++
* 验证 ssl 是默认的。
0.8.9 (2011-12-28)
++++++++++++++++++++
* 包装修复。
0.8.8 (2011-12-28)
++++++++++++++++++++
* SSL 证书验证！
* Cerifi 的发布：Mozilla 的证书列表。
* SSL 请求的新“验证”参数。
* Urllib3 更新。
0.8.7 (2011-12-24)
++++++++++++++++++
* iter_lines 最后一行截断修复
* 强制异步请求的安全模式
* 更一致地处理安全模式异常
* 修复迭代关于
安全模式 0.8.6 (2011-12-18)中的空响应
++++++++++++++++++
* 套接字超时修复。
*代理授权支持。
0.8.5 (2011-12-14)
++++++++++++++++++++
* Response.iter_lines！
0.8.4 (2011-12-11)
++++++++++++++++++++
* 预取错误修复。
* 为已安装版本添加了许可证。
0.8.3 (2011-11-27)
++++++++++++++++++++
* 将身份验证系统转换为使用更简单的可调用对象。
* API 方法的新会话参数。
* 登录时显示完整的 URL。
0.8.2 (2011-11-19)
++++++++++++++++++++
* 新的 Unicode 解码系统，基于可覆盖的 `Response.encoding`。
* 正确的 URL 斜杠引号处理。
* 允许使用带有“[”、“]”和“_”的 Cookie。
0.8.1 (2011-11-15)
++++++++++++++++++++
* URL 请求路径修复
* 代理修复。
* 超时修复。
0.8.0 (2011-11-13)
++++++++++++++++++++
* Keep-alive 支持！
* 完全删除 Urllib2
* 完全删除海报
* 完全删除 CookieJars
* 引发新的 ConnectionError
* Safe_mode 用于错误捕获
* 请求方法的预取参数
* OPTION 方法
* 异步池大小限制
* 文件上传发送实名
* 在 urllib3
0.7.6 (2011-11 ) 中提供-07)
++++++++++++++++++
* Digest authentication bugfix (attach query data to path)
0.7.5 (2011-11-04)
++++++++ ++++++++++
* Response.content = None 如果有无效的响应。
* 重定向授权处理。
0.7.4 (2011-10-26)
++++++++++++++++++++
* 会话挂钩修复。
0.7.3 (2011-10-23)
++++++++++++++++++++
*摘要身份验证修复。
0.7.2 (2011-10-23)
++++++++++++++++++++
*补丁修复。
0.7.1 (2011-10-23)
++++++++++++++++++++
* 远离 urllib2 身份验证处理。
* 完全删除 AuthManager、AuthObject 等。
* 新的基于元组的身份验证系统，带有处理程序回调。
0.7.0 (2011-10-22)
++++++++++++++++++++
* 会话现在是主要接口。
* 已弃用 InvalidMethodException。
*补丁修复。
*新的配置系统（没有更多的全局设置）。
0.6.6 (2011-10-19)
++++++++++++++++++++
* 会话参数错误修复（参数合并）。
0.6.5 (2011-10-18)
++++++++++++++++++++
* 离线（快速）测试套件。
* 会话字典参数合并。
0.6.4 (2011-10-13)
++++++++++++++++++++
* 基于 HTTP 标头的 unicode 自动解码。
*新的``decode_unicode``设置。
*删除“r.read/close”方法。
* 用于高级响应使用的新 ``r.faw`` 接口。*
* 参数化标头的自动扩展。
0.6.3 (2011-10-13)
++++++++++++++++++++
* 美丽的``requests.async`` 模块，用于使用 gevent 发出异步请求。
0.6.2 (2011-10-09)
++++++++++++++++++++
* GET/HEAD 遵循 allow_redirects=False。
0.6.1 (2011-08-20)
++++++++++++++++++++
* 增强状态码体验``\o/``
* 设置最大重定向数（``settings.max_redirects``）
* 完整的 Unicode URL 支持
* 支持无协议重定向。
* 允许任意请求类型。
* 错误修正
0.6.0 (2011-08-17)
++++++++++++++++++++
* 新的回调挂钩系统
* 新的持久会话对象和上下文管理器
* 透明的 Dict-cookie 处理
*状态代码参考对象
* 已删除 Response.cached
* 添加了 Response.request
* 所有 args 都是 kwargs
* 相对重定向支持
* HTTPError 处理改进
* 改进 https 测试
* 错误修正
0.5.1 (2011-07-23)
+++++++ +++++++++++++
* 国际域名支持！
* 访问标头而不获取整个正文（``read()``）
* 使用列表作为参数的 dicts
* 添加强制基本身份验证
* 强制基本是默认身份验证类型
* ``python-requests.org`` 默认用户代理标头
* CaseInsensitiveDict 小写缓存
* Response.history 错误修正
0.5.0 (2011-06-21)
++++++++++++++++++++
* PATCH 支持
* 支持代理
* HTTPBin 测试套件
* 重定向修复
* settings.verbose 流写入
* 所有方法的查询字符串
* URLErrors（连接被拒绝、超时、无效 URL）被视为明确提出
``r.requests.get('hwe://blah'); r.raise_for_status()``
0.4.1 (2011-05-22)
++++++++++++++++++++
* 改进的重定向处理
* 新的 'allow_redirects' 参数用于跟随非 GET /HEAD 重定向
* 设置模块重构
0.4.0 (2011-05-15)
++++++++++++++++++
* Response.history：重定向响应列表
* 不区分大小写的标题字典！
* Unicode URL
0.3.4 (2011-05-14)
++++++++++++++++++++
* Urllib2 HTTPAuthentication 递归修复（基本/摘要）
* 内部重构
* 字节数据上传错误修复
0.3 .3 (2011-05-12)
++++++++++++++++++
* 请求超时
* Unicode url 编码数据
* 设置上下文管理器和模块
0.3.2 (2011-04-15)
++++++++++++++++++++
* GZip 编码内容的自动解压缩
* AutoAuth 支持 Tupled HTTP Auth
0.3。 1 (2011-04-01)
++++++++++++++++++
* Cookie 更改
* Response.read()
* 海报修复
0.3.0 (2011-02-25)
++ ++++++++++++++++++
* 自动身份验证 API 更改
* 更智能的查询 URL 参数化
* 允许文件上传和 POST 数据一起
* 新的身份验证管理器系统
- 更简单的基本 HTTP 系统
- 支持所有内置urllib2 Auths
- 允许自定义身份验证处理程序
0.2.4 (2011-02-19)
++++++++++++++++++
* Python 2.5 支持
* PyPy-c v1.4 支持
* 自动身份验证测试
* 改进的请求对象构造函数
0.2.3 (2011-02-15)
++++++++++++++++++
* 新的 HTTPHandling 方法
- Response.__nonzero__（如果 HTTP 状态不正确，则为 false）
- Response.ok（如果预期 HTTP 状态为 True ） - Response.error（如果 HTTP 状态
不正确，则记录 HTTPError）
- Response.raise_for_status()（引发存储的 HTTPError）
0.2 .2 (2011-02-14)
++++++++++++++++++++
* 在发生 HTTPError 时仍然处理请求。（问题 #2）
* Eventlet 和 Gevent Monkeypatch 支持。
* Cookie 支持（问题 #1）
0.2.1 (2011-02-14)
++++++++++++++++++
* 为多部分编码文件上传的 POST 和 PUT 请求添加了文件属性。
* 为上下文添加 Request.url 属性并重定向
0.2.0 (2011-02-14)
++++++++++++++++++
* 诞生！
0.0.1 (2011-02-13)
++++++++++++++++++++
* 挫折
* 构想
