深入解析Python `httpx`源码，探索现代HTTP客户端的秘密！

🔸 第一部分：httpx请求入口

我们从最常用的入口开始，看看如何使用httpx库发送HTTP请求。通常，我们会使用 httpx.get() 或 httpx.post() 方法：

import httpxresponse = httpx.get('https://example.com')
print(response.status_code)
print(response.text)

🔹 这些方法的背后到底发生了什么呢？我们从httpx.get()方法的实现看起。

---

🔸 第二部分：get方法的实现

httpx.get() 只是对 httpx.request() 方法的简单封装：

# httpx/_api.py
def get(url: str, *, params: dict = None, headers: dict = None, cookies: dict = None, auth = None, timeout = None, allow_redirects: bool = True, **kwargs):return request("GET", url, params=params, headers=headers, cookies=cookies, auth=auth, timeout=timeout, allow_redirects=allow_redirects, **kwargs)

🔹 get()方法将请求方法设置为"GET"，然后调用内部的 request() 方法。让我们深入 request() 方法。

---

🔸 第三部分：request方法揭秘

request() 方法是 httpx 库的核心方法，负责处理所有类型的HTTP请求：

# httpx/_api.py
def request(method: str,url: str,*,params: dict = None,data: dict = None,json: dict = None,headers: dict = None,cookies: dict = None,files: dict = None,auth = None,timeout = None,allow_redirects: bool = True,**kwargs
):with Client() as client:return client.request(method, url, params=params, data=data, json=json, headers=headers, cookies=cookies, files=files, auth=auth, timeout=timeout, allow_redirects=allow_redirects, **kwargs)

🔹 request() 方法创建一个 Client 对象，并调用 client.request() 来实际发送请求。接下来，我们看看 Client 对象的实现。

---

🔸 第四部分：Client对象的奥秘

Client 对象在httpx库中扮演了重要角色。它不仅可以发送请求，还能管理会话和连接：

# httpx/_client.py
class Client(BaseClient):def request(self,method: str,url: str,*,params: dict = None,data: dict = None,json: dict = None,headers: dict = None,cookies: dict = None,files: dict = None,auth = None,timeout = None,allow_redirects: bool = True,**kwargs):request = self.build_request(method, url, params=params, data=data, json=json, headers=headers, cookies=cookies, files=files, auth=auth)response = self.send(request, timeout=timeout, allow_redirects=allow_redirects, **kwargs)return response

🔹 Client 对象的 request() 方法中首先调用 build_request() 方法来构建 Request 对象。然后调用 send() 方法来发送请求。

---

🔸 第五部分：Request对象的构建

build_request() 方法负责构建一个 Request 对象：

# httpx/_client.py
class Client(BaseClient):def build_request(self,method: str,url: str,*,params: dict = None,data: dict = None,json: dict = None,headers: dict = None,cookies: dict = None,files: dict = None,auth = None) -> Request:request = Request(method=method,url=url,params=params,data=data,json=json,headers=headers,cookies=cookies,files=files,auth=auth,)return request

🔹 build_request() 方法中，将请求的方法、URL、头信息、数据等封装到 Request 对象中。

---

🔸 第六部分：发送请求

当请求准备好后，Client 对象的 send() 方法负责实际发送HTTP请求：

# httpx/_client.py
class Client(BaseClient):def send(self,request: Request,*,stream: bool = False,timeout = None,allow_redirects: bool = True,**kwargs) -> Response:response = self._send_handling_redirects(request, timeout=timeout, allow_redirects=allow_redirects, **kwargs)return response

🔹 send() 方法会处理重定向和超时等情况，通过调用 _send_handling_redirects() 方法来实际发送请求。

---

🔸 第七部分：处理重定向

_send_handling_redirects() 方法负责处理请求的重定向逻辑：

# httpx/_client.py
class Client(BaseClient):def _send_handling_redirects(self,request: Request,*,timeout = None,allow_redirects: bool = True,**kwargs) -> Response:response = self._send_single_request(request, timeout=timeout, **kwargs)while response.is_redirect and allow_redirects:request = self.build_request("GET", response.headers["location"])response = self._send_single_request(request, timeout=timeout, **kwargs)return response

🔹 通过检查响应的重定向状态并构建新的请求对象，_send_handling_redirects() 方法确保了所有重定向都能被正确处理。

---

🔸 第八部分：发送单个请求

_send_single_request() 方法通过底层的transport来实际发送请求：

# httpx/_client.py
class Client(BaseClient):def _send_single_request(self, request: Request, timeout = None, **kwargs) -> Response:transport = self._transport_for_url(request.url)response = transport.handle_request(request, timeout=timeout)return response

🔹 _send_single_request() 方法中最重要的一步是调用 transport.handle_request() 方法来实际发送请求。

---

🔸 总结

🔹 通过以上解析，我们了解了 httpx 库从发送请求到接收响应的全过程。从 httpx.get() 方法开始，经过 Client 对象的处理、Request 的构建、请求的发送和重定向的处理，最终构建 Response 对象。这一系列流程确保了 httpx 库能够简洁、高效地处理HTTP请求，让开发者可以专注于业务逻辑的实现。