HTTP Client
Ascender Framework includes a lightweight HTTP client built on top of HTTPX. The client integrates with the framework's dependency injection system and supports request/response interceptors and reactive streaming.
Providing a client
bootstrap.py
from ascender.common.http import provideHTTPClient, HTTPClient
from ascender.core.types import IBootstrap
bootstrap: IBootstrap = {
"providers": [
provideHTTPClient(base_url="https://api.example.com")
]
}
The factory registers HTTPClient so it can be injected anywhere in the application:
main_controller.py
from ascender.core import Controller, Get
from ascender.common.http import HTTPClient
@Controller(standalone=True)
class MainController:
def __init__(self, http: HTTPClient):
self.http = http
@Get()
async def list_users(self):
return await self.http.get(url="/users")
Typed responses
Responses can be parsed into Pydantic models by passing the expected type:
usage.py
from pydantic import BaseModel
class User(BaseModel):
id: int
name: str
user = await http.get(User, url="/users/1")
Interceptors
provideHTTPClient accepts interceptors that can modify requests or responses. Interceptors can be async functions or classes extending Interceptor.
interceptors.py
from ascender.common.http import provideHTTPClient, Interceptor
from httpx import Request, Response
class AuthInterceptor(Interceptor):
async def handle_request(self, request: Request) -> Request:
request.headers["Authorization"] = "Bearer <token>"
return request
async def handle_response(self, response: Response):
return response
async def log_request(request: Request) -> Request:
print(request.url)
return request
providers = [
provideHTTPClient(interceptors=[AuthInterceptor, log_request])
]
Streaming responses
The stream method returns an RxPY Observable for consuming streamed data such as server-sent events.