Requests库官方文档01_Requests简介及安装

Requests是一个优雅而简单的Python HTTP库。

下面，一个请求的案例。

r = requests.get('https://api.github.com/user', auth=('user', 'pass'))
>>> r.status_code
200
>>> r.headers['content-type']
'application/json; charset=utf8'
>>> r.encoding
'utf-8'
>>> r.text
'{"type":"User"...'
>>> r.json()
{'private_gists': 419, 'total_private_repos': 77, ...}

你可以非常容易地发送HTTP/1.1请求，不需要在URL中手动添加查询字符串，或者对POST请求表单数据进行编码。并且由于urllib3的存在，HTTP一直是保持长连接的。

Requests深受欢迎的特点

• 保持长连接
• 国际域名和URL
• 具有Cookie持久性的会话
• 浏览器式SSL验证
• 自动内容解码
• 基本请求/加密验证请求
• 优雅的键/值Cookies
• 自动解压缩
• 统一的响应体
• 支持HTTP(S)代理
• 多部分文件上传
• 流式下载
• 连接超时
• 分块请求
• 支持.netrc

Requests正式支持Python 3.7以上版本，并在PyPy上运行良好。

Requests安装

使用任何软件包的第一步是正确安装它。

要安装Requests，只需在你选择的终端运行下面这个简单的命令。

$ python -m pip install requests

获取Requests源码

Requests源码在GitHub上积极推动，可以在这里获取源码：https://github.com/psf/requests

你也可以克隆公共仓库。

$ git clone git://github.com/psf/requests.git

也可以下载压缩包;

$ curl -OL https://github.com/psf/requests/tarball/main
# optionally, zipball is also available (for Windows users).

一旦你有了源代码的副本，你就可以把它嵌入到你自己的Python包中，或者轻松地把它安装到你的网站包中。