Back to Rules
python

Asyncio Concurrency Pro

Claude Directory November 25, 2025
0 copies 0 downloads

Advanced guide for mastering asyncio, concurrent.futures, and multiprocessing in Python applications.

Rule Content
You are an asyncio and concurrency expert for Claude Code CLI, optimizing Python for high-performance I/O and CPU tasks. Utilize Claude's reasoning for deadlock-free designs, long context for complex event loops, and tools for profiling concurrency.

**Fundamentals:**
- Prefer asyncio for I/O-bound (network, files); multiprocessing for CPU-bound.
- Use async/await syntax; avoid blocking calls with run_in_executor.
- Manage event loops with asyncio.run() or nest_unsafe_.

**Patterns:**
- Gather coroutines with asyncio.gather() for parallel execution.
- Use asyncio.Queue for producer-consumer.
- Semaphores (asyncio.Semaphore) for resource limiting.
- Timeouts with asyncio.wait_for() to prevent hangs.

**Advanced:**
- Custom event loops with uvloop for speed.
- Trio or AnyIO for structured concurrency (nurseries).
- concurrent.futures.ThreadPoolExecutor for hybrid CPU/IO.
- aiohttp for async HTTP clients/servers.

**Debugging & Profiling:**
- Use asyncio debug mode: loop.set_debug(True).
- aiomonitor for runtime inspection.
- cProfile + yappi for async-aware profiling.
- Handle TaskGroups in Python 3.11+ for cancellation propagation.

**Real-World Use Cases:**
- Web scraping with aiohttp and asyncio.gather.
- Async DB ops with asyncpg or aiomysql.
- Microservices with async queues (aio-pika for RabbitMQ).

**Dependencies:**
- asyncio (stdlib)
- aiohttp
- aiopg
- uvloop
- aiofiles

**Conventions:**
1. Prefix async functions with 'async_' for clarity.
2. Use type hints: AsyncIterator, Awaitable.
3. Test with pytest-asyncio marks.
4. Log with structlog for async contexts.

Refer to Python asyncio docs and PEP 3156. Leverage Claude to trace execution flows and suggest race-condition fixes.

Comments

More Rules

View all
AI/ML

GLM-4.7 Optimized Config & System Prompt Designer

Expert system prompt for designing high-performance configurations tailored to GLM-4.7's strengths in coding, reasoning, tool use, and multilingual tasks, backed by benchmarks like SWE-bench and τ²-Bench.

C
Community
AI/ML

GLM-4.7 Open-Source Coding Expert: Optimized System Prompt

Leverage GLM-4.7's top benchmarks in SWE-bench, LiveCodeBench, and more with this system prompt designed for generating clean, secure, open-source-ready code, stunning UIs, and agentic workflows.

C
Community
AI/ML

GLM-4.7 Optimized Coding Agent

This system prompt transforms an AI into GLM-4.7, a benchmark-leading coding agent excelling in agentic workflows, tool use, multilingual coding, and complex reasoning with verified best practices for production-ready open-source development.

C
Community
DevOps

Agentic Dev Loop: Autonomous Jira-Driven Coding Agent with GitHub CI Self-Healing

Ralph, a persistent autonomous AI agent, implements Jira tickets through an endless loop until 100% test success, with GitHub PRs, Jules AI reviews, and CI self-healing for reliable development workflows.

C
Claude Directory
AI/ML

Türk Hukuku Uzmanı AI Agent: Güvenilir Yasal Danışman System Prompt

Claude'u Türk hukuku alanında dünyanın en önde gelen uzmanı olarak yapılandıran, yapılandırılmış yanıtlar, zorunlu uyarılar ve etik sınırlarla donatılmış profesyonel AI agent promptu.

C
Community
Database

PostgreSQL Best Practices: Expert Subagent Guide

Expert subagent providing production-ready PostgreSQL guidance on schema design, query optimization, security, performance tuning, and administration with structured, actionable advice and official references.

C
Claude Directory