Sample code for: Python HTTPX: Making HTTP Requests With HTTPX2 (#820)

* Sample code for: Python HTTPX: Making HTTP Requests With HTTPX2

* Sync python-httpx with the updated tutorial

- custom_timeouts.py: write=5.0 instead of None
- timeout_fires.py: catch TimeoutException
- Add timeout_fires_async.py, stream_download_async.py, slow_endpoint.py
- Remove handle_errors_async.py (replaced in the tutorial)
- requirements.txt: httpx2 2.13.1

Every .py file now matches the tutorial's code blocks, formatted with
the repo's ruff config.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Stephen Gruppetta <stephen@realpython.com>
Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Co-authored-by: Real Python Bot <42617967+realpython-bot@users.noreply.github.com>

Author: 4 people

python-httpx/README.md

@@ -0,0 +1,3 @@
+# Python HTTPX: Making HTTP Requests With HTTPX2
+
+This folder provides the code examples for the Real Python tutorial [Python HTTPX: Making HTTP Requests With HTTPX2](https://realpython.com/python-httpx/)

python-httpx/async_request.py

@@ -0,0 +1,12 @@
+import asyncio
+
+import httpx2
+
+
+async def main():
+    async with httpx2.AsyncClient(base_url="https://api.github.com") as client:
+        response = await client.get("/events")
+        print(response.status_code)
+
+
+asyncio.run(main())

python-httpx/auth_header.py

@@ -0,0 +1,14 @@
+import httpx2
+
+with httpx2.Client(
+    base_url="https://api.github.com",
+    headers={
+        "Authorization": "Bearer your-token",
+        "Accept": "application/vnd.github+json",
+    },
+) as client:
+    first = client.get("/events")
+    second = client.get("/repos/python/cpython")
+
+print(first.status_code, second.status_code)
+print(second.request.headers["Accept"])

python-httpx/closed_client_error.py

@@ -0,0 +1,6 @@
+import httpx2
+
+with httpx2.Client() as client:
+    pass
+
+client.get("https://api.github.com/events")

python-httpx/custom_timeouts.py

@@ -0,0 +1,7 @@
+import httpx2
+
+timeout = httpx2.Timeout(connect=5.0, read=10.0, write=5.0, pool=5.0)
+
+with httpx2.Client(timeout=timeout) as client:
+    response = client.get("https://api.github.com/events")
+    print(response.status_code)

python-httpx/default_timeout_error.py

@@ -0,0 +1,3 @@
+import httpx2
+
+httpx2.get("https://httpbin.org/delay/6")

python-httpx/fetch_all.py

@@ -0,0 +1,14 @@
+import asyncio
+
+import httpx2
+
+
+async def fetch_all(paths):
+    async with httpx2.AsyncClient(base_url="https://api.github.com") as client:
+        coroutines = [client.get(path) for path in paths]
+        responses = await asyncio.gather(*coroutines)
+        return [response.status_code for response in responses]
+
+
+paths = ["/events", "/repos/python/cpython", "/repos/psf/requests"]
+print(asyncio.run(fetch_all(paths)))

python-httpx/first_request.py

@@ -0,0 +1,5 @@
+import httpx2
+
+response = httpx2.get("https://api.github.com/events")
+print(response.status_code)
+print(response.json())

python-httpx/handle_errors.py

@@ -0,0 +1,20 @@
+import httpx2
+
+timeout = httpx2.Timeout(5.0)
+
+with httpx2.Client(timeout=timeout) as client:
+    try:
+        response = client.get("https://api.github.com/nonexistent")
+        response.raise_for_status()
+    except httpx2.ConnectTimeout:
+        print("Timed out while connecting to the host.")
+    except httpx2.ReadTimeout:
+        print("Timed out while receiving data from the host.")
+    except httpx2.WriteTimeout:
+        print("Timed out while sending data to the host.")
+    except httpx2.PoolTimeout:
+        print("Timed out waiting for a pool connection.")
+    except httpx2.HTTPStatusError as error:
+        print(f"Bad response: {error.response.status_code}")
+    except httpx2.RequestError as error:
+        print(f"A network problem occurred: {error}")

python-httpx/http2_client.py

@@ -0,0 +1,5 @@
+import httpx2
+
+with httpx2.Client(http2=True) as client:
+    response = client.get("https://api.github.com/events")
+    print(response.http_version)