async-patterns

To run coroutines concurrently with a timeout, use safe_gather with its optional timeout support. This enforces fail-fast cancellation to abort pending tasks if the specified duration is exceeded, preventing hanging operations.

You should migrate from asyncio.gather to safe_gather for new code or existing code where benefits justify the change. safe_gather enforces fail-safe defaults, including automatic fail-fast cancellation and deterministic cleanup, which standard asyncio.gather lacks.

To ensure deterministic cleanup across concurrent asyncio tasks, coordinate them using safe_gather. It provides structured patterns for initialization, data gathering, validation, and cleanup, guaranteeing resources are released properly even during failures.

Yes, you can use safe_gather for both full-success and partial-result workflows. It provides centralized guidance to switch between fail-fast cancellation for full-success operations and return_exceptions for workflows requiring partial results.