From: Kevin Anderson <77035713+2601677867@users.noreply.github.com> Date: Mon, 22 Nov 2021 12:22:45 +0000 (+0800) Subject: readmes/README.scn.md (#1946) X-Git-Tag: 0.21.2~15 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=e232226d77b5faecc64cc618687b4d52d24ab1db;p=thirdparty%2Fhttpx.git readmes/README.scn.md (#1946) * Create README_chinese.md * Update README_chinese.md * Update README_chinese.md * Update README_chinese.md * Update README_chinese.md --- diff --git a/README_chinese.md b/README_chinese.md new file mode 100644 index 00000000..0daa78c6 --- /dev/null +++ b/README_chinese.md @@ -0,0 +1,146 @@ +

+ HTTPX +

+ +

HTTPX - 适用于Python的次世代HTTP客户端

+ +

+ + Test Suite + + + Package version + +

+ +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) 来获得更多细节.* + +--- + +通过pip安装httpx: + +```shell +$ pip install httpx +``` + +使用httpx: + +```pycon +>>> import httpx +>>> r = httpx.get('https://www.example.org/') +>>> r + +>>> r.status_code +200 +>>> r.headers['content-type'] +'text/html; charset=UTF-8' +>>> r.text +'\n\n\nExample Domain...' +``` + +或者使用命令行客户端. + +```shell +$ pip install 'httpx[cli]' # 只安装集成的命令行功能 +``` + +它现在允许我们直接从命令行使用HTTPX + +

+ httpx --help +

+ +发送一个请求... + +

+ httpx http://httpbin.org/json +

+ +## 特性 + +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. +* 全类型注释. +* 全部代码均通过测试. + +加上这些应该具备的标准功能 + +* 域名与URL +* 保持活动状态 +* 具有Cookie持久性的会话 +* 浏览器风格的SSL验证 +* 身份验证 +* Elegant Key/Value Cookies +* 自动解压缩 +* 内容自动解码 +* Unicode Response Bodies +* 分段文件上传 +* 支持HTTP(S) 代理 +* 支持设定timeout +* 流式下载 +* 支持 .netrc +* 接收Chunked编码 + +## 安装 + +使用pip安装: + +```shell +$ pip install httpx +``` + +安装HTTP/2支持: + +```shell +$ pip install httpx[http2] +``` + +HTTPX 要求 Python 3.6版本或更高. + +## 文档 + +项目文档现已就绪，请访问 [https://www.python-httpx.org/](https://www.python-httpx.org/) 来阅读！ + +想学习基础知识？请访问 [快速开始](https://www.python-httpx.org/quickstart/). + +想获得进阶帮助？ 请访问 [Advanced Usage](https://www.python-httpx.org/advanced/) 来获得答案, 不妨来看看 [异步支持](https://www.python-httpx.org/async/) 或者 [HTTP/2](https://www.python-httpx.org/http2/) + +[Developer Interface](https://www.python-httpx.org/api/) 提供了全面的API参考。 + +要了解与HTTPX集成的工具, 请访问 [第三方包](https://www.python-httpx.org/third_party_packages/). + +## 贡献 + +如果您想对本项目做出贡献，请访问 [贡献者指南](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. +* `charset_normalizer` - Charset auto-detection. +* `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]`)* +* `async_generator` - Backport support for `contextlib.asynccontextmanager`. *(Only required for Python 3.6)* + +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. + +

— ⭐️ —

+

HTTPX 代码使用 BSD 开源协议. 在英国布莱顿设计和构建。