跳转到主要内容

下一代HTTP客户端。

项目描述

HTTPX

HTTPX - 一个面向Python的下一代HTTP客户端。

Test Suite Package version

HTTPX是一个适用于Python 3的全功能HTTP客户端库。它包括一个集成的命令行客户端,支持HTTP/1.1和HTTP/2,并提供同步和异步API。


使用pip安装HTTPX

pip install httpx

现在,让我们开始吧

>>> import httpx
>>> r = httpx.get('https://www.example.org/')
>>> r
<Response [200 OK]>
>>> r.status_code
200
>>> r.headers['content-type']
'text/html; charset=UTF-8'
>>> r.text
'<!doctype html>\n<html>\n<head>\n<title>Example Domain</title>...'

或者,使用命令行客户端。

pip install 'httpx[cli]'  # The command line client is an optional dependency.

现在可以直接从命令行使用 HTTPX...

httpx --help

发送请求...

httpx http://httpbin.org/json

功能

HTTPX 基于 requests 的良好可用性,为您提供了

以及 requests 的所有标准功能...

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

安装

使用 pip 安装

pip install httpx

或者,为了包含可选的 HTTP/2 支持,请使用

pip install httpx[http2]

HTTPX 需要 Python 3.8+。

文档

项目文档可在 https://www.python-httpx.org/ 查找。

要了解所有基础知识,请访问 快速入门

有关更高级的主题,请参阅 高级用法 部分、异步支持 部分或 HTTP/2 部分。

开发者接口 提供了全面的 API 参考。

要了解与 HTTPX 集成的工具,请参阅 第三方软件包

贡献

如果您想为 HTTPX 贡献,请查看 贡献指南 以了解如何开始。

依赖关系

HTTPX 项目依赖于以下优秀的库

  • httpcore - httpx 的底层传输实现。
    • h11 - HTTP/1.1 支持。
  • certifi - SSL 证书。
  • idna - 国际化域名支持。
  • sniffio - 异步库自动检测。

以及以下可选安装

  • h2 - HTTP/2 支持。 (可选,使用 httpx[http2])
  • socksio - SOCKS 代理支持。 (可选,使用 httpx[socks])
  • rich - 丰富的终端支持。 (可选,使用 httpx[cli])
  • click - 命令行客户端支持。 (可选,使用 httpx[cli])
  • brotlibrotlicffi - 对 "brotli" 压缩响应的解码。 (可选,使用 httpx[brotli])
  • zstandard - 对 "zstd" 压缩响应的解码。 (可选,使用 httpx[zstd])

许多工作都遵循 requests 的 API 布局,这要归功于 requests,以及许多关于底层网络细节的设计灵感来自 urllib3,因此对它们的贡献表示巨大的感谢。


HTTPX 是 BSD 许可证 代码。
精心设计与制作。

— 🦋 —

发布信息

修复

  • 重新引入了假设为私有的 URLTypes 快捷方式。 (#2673)

完整的变更日志

项目详情


发布历史 发布通知 | RSS 源

下载文件

下载适合您平台的文件。如果您不确定该选择哪个,请了解更多关于安装包的信息。

源分布

httpx-0.27.2.tar.gz (144.2 kB 查看哈希值)

上传时间:

构建分布

httpx-0.27.2-py3-none-any.whl (76.4 kB 查看哈希值)

上传时间: Python 3

支持者:

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误日志 StatusPage StatusPage 状态页面