Async Patterns

Core Rules

1. Prefer safe_gather for all new async code - fail-fast, timeout support, cleaner cancellation
2. Use return_exceptions=True for partial-results patterns
3. Always consider timeout for long-running operations
4. Don't migrate existing cleanup code (low priority, both work fine)

safe_gather vs asyncio.gather

safe_gather is better in ALL cases because it provides:

• Fail-fast cancellation (when not using return_exceptions=True)
• Timeout support with automatic cleanup
• Cleaner cancellation handling

See references/safe-gather.md for implementation.

Pattern: All Tasks Must Succeed (fail-fast)