Core HTTP 共享客户端库，适用于 Python

corehttp 为 Python SDK 客户端库提供共享异常和模块。

入门指南

通常，您不需要安装 corehttp，因为它将在您使用它的客户端库之一进行安装时一起安装。

传输方式

要使用 corehttp，您需要选择一个传输实现。 corehttp 提供以下传输方式

同步传输

• RequestsTransport - 基于 Requests 库的同步传输。
• HttpXTransport - 基于 HTTPX 库的同步传输。

异步传输

• AioHttpTransport - 基于 aiohttp 库的异步传输。
• AsyncHttpXTransport - 基于 HTTPX 库的异步传输。

每个传输都有自己的依赖项，您可以使用 corehttp 的扩展来安装它们

# Install individually.
pip install corehttp[requests]
pip install corehttp[aiohttp]
pip install corehttp[httpx]

# Install multiple.
pip install corehttp[requests,httpx]

如果没有指定传输方式，corehttp 将默认使用 RequestsTransport 进行同步管道请求，并使用 AioHttpTransport 进行异步管道请求。

贡献

本项目欢迎贡献和建议。大多数贡献需要您同意贡献者许可协议（CLA），声明您有权并且确实授予我们使用您贡献的权利。有关详细信息，请访问 https://cla.microsoft.com。

当您提交拉取请求时，CLA机器人将自动确定您是否需要提供CLA，并适当装饰PR（例如，标签、注释）。只需遵循机器人的说明。您在整个使用我们的CLA的仓库中只需这样做一次。

本项目采用了Microsoft开源行为准则。更多信息，请参阅行为准则FAQ或通过opencode@microsoft.com联系以提出任何额外的问题或评论。

发布历史

1.0.0b5（2024-02-29）

其他更改

• 接受浮点数作为retry_after头部的值。

1.0.0b4（2024-02-23）

其他更改

• 在Pipeline构造函数中放宽类型检查，只检查每个用户提供的策略对象是否具有send方法或同时具有on_request和on_response方法。这允许更灵活的策略实现。#34296

1.0.0b3（2024-02-01）

新增功能

• 支持为corehttp.rest.HttpRequest中的files值添加元组输入 #34082
• 支持同时将files和data字段输入到corehttp.rest.HttpRequest中 #34082

1.0.0b2（2023-11-14）

新增功能

• 添加了HTTPX传输的初始实现。#32813

破坏性更改

• 将requests从corehttp的默认依赖项中移除。现在这是一个“额外”依赖项，可以通过corehttp[requests]安装。#32813
• 将aio额外项重命名为aiohttp。#32813

已修复的bug

• 修复了异步传输中multipart/form-data的问题，其中data未编码到请求体中。#32473
• 修复了connection_verify、connection_cert和connection_timeout未传递到底层传输的问题。#33057
• 修复了传输默认不使用SSL的问题。#33057

其他更改

• 为httpx添加了额外项。#32813

1.0.0b1（2023-10-18）

• 初始发布