async-python-patterns

1# Async Python Patterns
2 
3Comprehensive guidance for implementing asynchronous Python applications using asyncio, concurrent programming patterns, and async/await for building high-performance, non-blocking systems.
4 
5## Use this skill when
6 
7- Building async web APIs (FastAPI, aiohttp, Sanic)
8- Implementing concurrent I/O operations (database, file, network)
9- Creating web scrapers with concurrent requests
10- Developing real-time applications (WebSocket servers, chat systems)
11- Processing multiple independent tasks simultaneously
12- Building microservices with async communication
13- Optimizing I/O-bound workloads
14- Implementing async background tasks and queues
15 
16## Do not use this skill when
17 
18- The workload is CPU-bound with minimal I/O.
19- A simple synchronous script is sufficient.
20- The runtime environment cannot support asyncio/event loop usage.
21 
22## Instructions
23 
24- Clarify workload characteristics (I/O vs CPU), targets, and runtime constraints.
25- Pick concurrency patterns (tasks, gather, queues, pools) with cancellation rules.
26- Add timeouts, backpressure, and structured error handling.
27- Include testing and debugging guidance for async code paths.
28- If detailed examples are required, open `resources/implementation-playbook.md`.
29 
30Refer to `resources/implementation-playbook.md` for detailed patterns and examples.
31 
32## Resources
33 
34- `resources/implementation-playbook.md` for detailed patterns and examples.