httpx:一個(gè) Python Web 客戶端
Python 的 ??httpx?
? 包是一個(gè)復(fù)雜的 Web 客戶端。當(dāng)你安裝它后,你就可以用它來(lái)從網(wǎng)站上獲取數(shù)據(jù)。像往常一樣,安裝它的最簡(jiǎn)單方法是使用 ??pip?
? 工具:
$ python -m pip install httpx --user
要使用它,把它導(dǎo)入到 Python 腳本中,然后使用 ??.get?
? 函數(shù)從一個(gè) web 地址獲取數(shù)據(jù):
import httpx
result = httpx.get("https://httpbin.org/get?hello=world")
result.json()["args"]
下面是這個(gè)簡(jiǎn)單腳本的輸出:
{'hello': 'world'}
HTTP 響應(yīng)
默認(rèn)情況下,??httpx?
? 不會(huì)在非 200 狀態(tài)下引發(fā)錯(cuò)誤。
試試這個(gè)代碼:
result = httpx.get("https://httpbin.org/status/404")
result
結(jié)果是:
<Response [404 NOT FOUND]>
可以明確地返回一個(gè)響應(yīng)。添加這個(gè)異常處理:
try:
result.raise_for_status()
except Exception as exc:
print("woops", exc)
下面是結(jié)果:
woops Client error '404 NOT FOUND' for url 'https://httpbin.org/status/404'
For more information check: https://httpstatuses.com/404
自定義客戶端
除了最簡(jiǎn)單的腳本之外,使用一個(gè)自定義的客戶端是有意義的。除了不錯(cuò)的性能改進(jìn),比如連接池,這也是一個(gè)配置客戶端的好地方。
例如, 你可以設(shè)置一個(gè)自定義的基本 URL:
client = httpx.Client(base_url="https://httpbin.org")
result = client.get("/get?source=custom-client")
result.json()["args"]
輸出示例:
{'source': 'custom-client'}
這對(duì)用客戶端與一個(gè)特定的服務(wù)器對(duì)話的典型場(chǎng)景很有用。例如,使用 ??base_url?
? 和 ??auth?
?,你可以為認(rèn)證的客戶端建立一個(gè)漂亮的抽象:
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'}
你可以用它來(lái)做一件更棒的事情,就是在頂層的 “主” 函數(shù)中構(gòu)建客戶端,然后把它傳遞給其他函數(shù)。這可以讓其他函數(shù)使用客戶端,并讓它們與連接到本地 WSGI 應(yīng)用的客戶端進(jìn)行單元測(cè)試。
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
請(qǐng)?jiān)L問(wèn) python-httpx.org 了解更多信息、文檔和教程。我發(fā)現(xiàn)它是一個(gè)與 HTTP 交互的優(yōu)秀而靈活的模塊。試一試,看看它能為你做什么。