TranslateProject/translated/tech/20220302 How to use httpx, a web client for Python.md

如何使用 httpx，一个 Python web 客户端

Python 的 httpx 包是一个用于 HTTP 交互的一个优秀且灵活的模块。

Python 的 httpx 包是一个复杂的 web 客户端。当你安装它后，你就可以用它来从网站上获取数据。像往常一样，安装它的最简单方法是使用 pip 工具：

`$ python -m pip install httpx --user`

要使用它，把它导入到 Python 脚本中，然后使用 .get 函数从一个 web 地址获取数据：

import httpx
result = httpx.get("<https://httpbin.org/get?hello=world>")
result.json()["args"]

下面是这个简单脚本的输出：

`    {'hello': 'world'}`

HTTP 响应

默认情况下，httpx 不会在非 200 状态下引发错误。

试试这个代码：

result = httpx.get("<https://httpbin.org/status/404>")
result

结果是：

`    <Response [404 NOT FOUND]>`

可以明确地返回一个响应。添加这个异常处理：

try:
    result.raise_for_status()
except Exception as exc:
    print("woops", exc)

下面是结果：

    woops Client error '404 NOT FOUND' for url '<https://httpbin.org/status/404>'
    For more information check: <https://httpstatuses.com/404>

自定义客户端

除了最简单的脚本之外，使用一个自定义的客户端是值得的。除了不错的性能改进，比如连接池，这是一个配置客户端的好地方。

例如, 你可以设置一个自定义的基本 URL：

client = httpx.Client(base_url="<https://httpbin.org>")
result = client.get("/get?source=custom-client")
result.json()["args"]

输出示例：

`    {'source': 'custom-client'}`

这对一个典型的场景很有用，你用客户端与一个特定的服务器对话。例如，使用 base_url 和 auth，你可以为认证的客户端建立一个漂亮的抽象：

client = httpx.Client(
    base_url="<https://httpbin.org>",
    auth=("good_person", "secret_password"),
)
result = client.get("/basic-auth/good_person/secret_password")
result.json()

输出：

`    {'authenticated': True, 'user': 'good_person'}`

你可以用它来做一件更好的事情，就是在顶层的 “main” 函数中构建客户端，然后把它传递给其他函数。这可以让其他函数使用客户端，并让它们与连接到本地 WSGI 应用的客户端进行单元测试。

def get_user_name(client):
    result = client.get("/basic-auth/good_person/secret_password")
    return result.json()["user"]

get_user_name(client)
    'good_person'

def application(environ, start_response):
    start_response('200 OK', [('Content-Type', 'application/json')])
    return [b'{"user": "pretty_good_person"}']
fake_client = httpx.Client(app=application, base_url="<https://fake-server>")
get_user_name(fake_client)

输出：

`    'pretty_good_person'`

尝试 httpx

请访问 python-httpx.org 了解更多信息、文档和教程。我发现它是一个与 HTTP 交互的优秀而灵活的模块。试一试，看看它能为你做什么。

---

via: https://opensource.com/article/22/3/python-httpx

作者：Moshe Zadka 选题：lujun9972 译者：geekpi 校对：校对者ID

本文由 LCTT 原创编译，Linux中国 荣誉推出