async-python-patterns
Master Python asyncio, concurrent programming, and async/await patterns for high-performance applications. Use when building async APIs, concurrent systems, or I/O-bound applications requiring non-blocking operations.
By wshobson · 15,997 installs
npx skills add wshobson/agents --skill async-python-patterns
Source repository · Upstream listing
Async Python Patterns
Comprehensive guidance for implementing asynchronous Python applications using asyncio, concurrent programming patterns, and async/await for building high performance, non blocking systems.
When to Use This Skill
Building async web APIs (FastAPI, aiohttp, Sanic)
Implementing concurrent I/O operations (database, file, network)
Creating web scrapers with concurrent requests
Developing real time applications (WebSocket servers, chat systems)
Processing multiple independent tasks simultaneously
Building microservices with async communication
Optimizing I/O bound workloads
Implementing async background tasks and queues
Sync vs Async Decision Guide
Before adopting async, consider whether it's the right choice for your use case.
Use Case Recommended Approach
Many concurrent network/DB calls asyncio
CPU bound computation multiprocessing or thread pool
Mixed I/O + CPU Offload CPU work with asyncio.to thread()
Simple scripts, few connections Sync (simpler, easier to debug)
Web APIs with high concurrency Async frameworks (FastAPI, aiohttp)
Key Rule: Stay fully sync or fully async within a call path. Mixing creates hidden blocking and complexity.
Core Concepts
1. Event Loop
The event loop is the heart of asyncio, managing and scheduling asynchronous tasks.
Key characteristics:
Single threaded cooperative multitasking
Schedules coroutines for execution
Handles I/O operations without blocking
Manages callbacks and futures
2. Coroutines
Functions defined with async def that can be paused and resumed.
Syntax:
3. Tasks
Scheduled coroutines that run concurrently on the event loop.
4. Futures
Low level objects representing eventual results of async operations.
5. Async Context Managers
Resources that support async with for proper cleanup.
6. Async Iterators
Objects that support async for for iterating over async data sources.
Quick Start
Fundamental Patterns
Pattern 1: Basic Async/Await
Pattern 2: Concurrent Execution with gather()
Pattern 3: Task Creation and Management
Pattern 4: Error Handling in Async Code
Pattern 5: Timeout Handling
Detailed worked examples and patterns
Detailed sections (starting with Advanced Patterns ) live in references/details.md . Read that file when the navigation summary above is insufficient.
Common Pitfalls
1. Forgetting await
2. Blocking the Event Loop
3. Not Handling Cancellation
4. Mixing Sync and Async Code
Testing Async Code