APIFuture

异步操作的通用接口

类

表示将产生类型 T 值的异步操作的抽象泛型类。

包装 Python 的 concurrent.futures.Future 并支持 async/await 的具体实现。

async def result_async(timeout: Optional[float] = None) -> T

异步获取结果（非阻塞）。

参数：

抛出：操作未在 timeout 内完成则抛出 TimeoutError。

def result(timeout: Optional[float] = None) -> T

同步获取结果（阻塞）。

参数：

抛出：操作未在 timeout 内完成则抛出 TimeoutError。

def future() -> concurrent.futures.Future\[T\]

访问底层的 concurrent.futures.Future 对象。

api_future = await client.some_operation_async(...)
result = await api_future

api_future = client.some_operation(...)
result = api_future.result()

try:
    result = api_future.result(timeout=30.0)  # 30 秒
except TimeoutError:
    print("操作超时")