<a href="https://www.python-httpx.org/"><img width="350" height="208" src="https://raw.githubusercontent.com/encode/httpx/master/docs/img/butterfly.png" alt='HTTPX'></a>
</p>
-<p align="center"><strong>HTTPX</strong> <em>- 适用于Python的次世代HTTP客户端 </em></p>
+<p align="center"><strong>HTTPX</strong> <em>- 适用于 Python 的下一代 HTTP 客户端</em></p>
<p align="center">
<a href="https://github.com/encode/httpx/actions">
</a>
</p>
-HTTPX是一个功能齐全的HTTP客户端python3库. 它集成了 **一个命令行客户端**, 支持 **HTTP/1.1 和 HTTP/2**, 而且提供了 **同步和异步API**.
-
-**注意！**: *0.21版本包括对集成命令行的一些改进。最新版本与重新设计的 `http核心`. 都应该自动更新到所需的版本，如果您遇到任何问题，那么您应该确保您安装的版本为 `httpx0.21.*` 且 `httpcore0.14.*` . 请参考 [the CHANGELOG](https://github.com/encode/httpx/blob/master/CHANGELOG.md) 来获得更多细节.*
+HTTPX 是适用于 Python3 的功能齐全的 HTTP 客户端。 它集成了 **一个命令行客户端**，同时支持 **HTTP/1.1 和 HTTP/2**，并提供了 **同步和异步 API**。
---
-通过pip安装httpx:
+通过 pip 安装 HTTPX：
```shell
$ pip install httpx
```
-使用httpx:
+使用 httpx：
```pycon
>>> import httpx
'<!doctype html>\n<html>\n<head>\n<title>Example Domain</title>...'
```
-或者使用命令行客户端.
+或者使用命令行客户端。
```shell
-$ pip install 'httpx[cli]' # å\8fªå®\89è£\85é\9b\86æ\88\90ç\9a\84å\91½ä»¤è¡\8cå\8a\9fè\83½
+$ pip install 'httpx[cli]' # å\91½ä»¤è¡\8cå\8a\9fè\83½æ\98¯å\8f¯é\80\89ç\9a\84ã\80\82
```
-它现在允许我们直接从命令行使用HTTPX
+它允许我们直接通过命令行来使用 HTTPX...
<p align="center">
<img width="700" src="docs/img/httpx-help.png" alt='httpx --help'>
## 特性
-HTTPX将并为您提供以下功能:
-
-* 广泛的 [requests-compatible API](https://www.python-httpx.org/compatibility/).
-* 内置的命令行客户端功能.
-* HTTP/1.1 [和 HTTP/2 支持](https://www.python-httpx.org/http2/).
-* 标准同步接口，也支持 [异步](https://www.python-httpx.org/async/).
-* 能够直接向 [WSGI 应用发送请求](https://www.python-httpx.org/advanced/#calling-into-python-web-apps) 或向 [ASGI 应用发送请求](https://www.python-httpx.org/async/#calling-into-python-web-apps).
-* 在任何地方设置详细的timeout.
-* å\85¨ç±»å\9e\8b注é\87\8a.
-* 全部代码均通过测试.
-
-加上这些应该具备的标准功能
-
-* å\9f\9få\90\8dä¸\8eURL
-* 保持活动状态
-* 具有Cookie持久性的会话
-* 浏览器风格的SSL验证
-* 身份验证
-* Elegant Key/Value Cookies
+HTTPX 建立在成熟的 requests 可用性基础上，为您提供以下功能：
+
+* 广泛的 [requests 兼容 API](https://www.python-httpx.org/compatibility/)。
+* 内置的命令行客户端功能。
+* HTTP/1.1 [和 HTTP/2 支持](https://www.python-httpx.org/http2/)。
+* 标准同步接口，也支持 [异步](https://www.python-httpx.org/async/)。
+* 能够直接向 [WSGI 应用发送请求](https://www.python-httpx.org/advanced/#calling-into-python-web-apps) 或向 [ASGI 应用发送请求](https://www.python-httpx.org/async/#calling-into-python-web-apps)。
+* 每一处严格的超时控制。
+* å®\8cæ\95´ç\9a\84ç±»å\9e\8b注解ã\80\82
+* 100% 测试。
+
+加上这些应该具备的标准功能...
+
+* å\9b½é\99\85å\8c\96å\9f\9få\90\8dä¸\8e URL
+* Keep-Alive & 连接池
+* Cookie 持久性会话
+* 浏览器风格的 SSL 验证
+* 基础或摘要身份验证
+* 优雅的键值 Cookies
* 自动解压缩
* 内容自动解码
-* Unicode Response Bodies
+* Unicode 响应正文
* 分段文件上传
-* 支持HTTP(S) 代理
-* 支持设定timeout
+* HTTP(S)代理支持
+* 可配置的连接超时
* 流式下载
-* 支持 .netrc
-* 接收Chunked编码
+* .netrc 支持
+* 分块请求
## 安装
-使用pip安装:
+使用 pip 安装：
```shell
$ pip install httpx
```
-安装HTTP/2支持:
+或者，安装可选的 HTTP/2 支持：
```shell
$ pip install httpx[http2]
```
-HTTPX 要求 Python 3.6版本或更高.
+HTTPX 要求 Python 3.7+ 版本。
## 文档
-项目文档现已就绪，请访问 [https://www.python-httpx.org/](https://www.python-httpx.org/) 来阅读！
+项目文档现已就绪，请访问 [https://www.python-httpx.org/](https://www.python-httpx.org/) 来阅读。
-想学习基础知识？请访问 [快速开始](https://www.python-httpx.org/quickstart/).
+要浏览所有基础知识，请访问 [快速开始](https://www.python-httpx.org/quickstart/)。
-æ\83³è\8e·å¾\97è¿\9bé\98¶å¸®å\8a©ï¼\9f 请访é\97® [Advanced Usage](https://www.python-httpx.org/advanced/) æ\9d¥è\8e·å¾\97ç\94æ¡\88, ä¸\8d妨æ\9d¥ç\9c\8bç\9c\8b [å¼\82æ¥æ\94¯æ\8c\81](https://www.python-httpx.org/async/) æ\88\96è\80\85 [HTTP/2](https://www.python-httpx.org/http2/)
+æ\9b´é«\98级ç\9a\84主é¢\98ï¼\8cå\8f¯å\8f\82é\98\85 [é«\98级ç\94¨æ³\95](https://www.python-httpx.org/advanced/) ç« è\8a\82, [å¼\82æ¥æ\94¯æ\8c\81](https://www.python-httpx.org/async/) æ\88\96è\80\85 [HTTP/2](https://www.python-httpx.org/http2/) ç« è\8a\82ã\80\82
-[Developer Interface](https://www.python-httpx.org/api/) 提供了全面的API参考。
+[Developer Interface](https://www.python-httpx.org/api/) 提供了全面的 API 参考。
-要了解与HTTPX集成的工具, 请访问 [第三方包](https://www.python-httpx.org/third_party_packages/).
+要了解与 HTTPX 集成的工具, 请访问 [第三方包](https://www.python-httpx.org/third_party_packages/)。
## 贡献
-如果您想对本项目做出贡献，请访问 [贡献者指南](https://www.python-httpx.org/contributing/) 来了解注意事项
+如果您想对本项目做出贡献，请访问 [贡献者指南](https://www.python-httpx.org/contributing/) 来了解如何开始。
## 依赖
-HTTPX项目依赖于这些优秀的库:
-
-* `httpcore` - The underlying transport implementation for `httpx`.
- * `h11` - HTTP/1.1 support.
- * `h2` - HTTP/2 support. *(Optional, with `httpx[http2]`)*
-* `certifi` - SSL certificates.
-* `rfc3986` - URL parsing & normalization.
- * `idna` - Internationalized domain name support.
-* `sniffio` - Async library autodetection.
-* `rich` - Rich terminal support. *(Optional, with `httpx[cli]`)*
-* `click` - Command line client support. *(Optional, with `httpx[cli]`)*
-* `brotli` or `brotlicffi` - Decoding for "brotli" compressed responses. *(Optional, with `httpx[brotli]`)*
-
-A huge amount of credit is due to `requests` for the API layout that
-much of this work follows, as well as to `urllib3` for plenty of design
-inspiration around the lower-level networking details.
-
-<p align="center">— ⭐️ —</p>
-<p align="center"><i>HTTPX 代码使用 <a href="https://github.com/encode/httpx/blob/master/LICENSE.md">BSD 开源协议</a>. 在英国布莱顿设计和构建。</i></p>
+HTTPX 项目依赖于这些优秀的库：
+
+* `httpcore` - `httpx` 基础传输接口实现。
+ * `h11` - HTTP/1.1 支持。
+* `certifi` - SSL 证书。
+* `rfc3986` - URL 解析与规范化。
+ * `idna` - 国际化域名支持。
+* `sniffio` - 异步库自动检测。
+
+以及这些可选的安装：
+
+* `h2` - HTTP/2 支持。 *(可选的，通过 `httpx[http2]`)*
+* `socksio` - SOCKS 代理支持。 *(可选的， 通过 `httpx[socks]`)*
+* `rich` - 丰富的终端支持。 *(可选的，通过 `httpx[cli]`)*
+* `click` - 命令行客户端支持。 *(可选的，通过 `httpx[cli]`)*
+* `brotli` 或者 `brotlicffi` - 对 “brotli” 压缩响应的解码。*(可选的，通过 `httpx[brotli]`)*
+
+这项工作的大量功劳都归功于参考了 `requests` 所遵循的 API 结构，以及 `urllib3` 中众多围绕底层网络细节的设计灵感。
+
+---
+
+<p align="center"><i>HTTPX 使用 <a href="https://github.com/encode/httpx/blob/master/LICENSE.md">BSD 开源协议</a> code。<br/>精心设计和制作。</i><br/>— 🦋 —</p>
projects / thirdparty / httpx.git / commitdiff
