Topic 25130 min readStructured Tutorial

Asyncio in Python

Quick Answer

Asyncio explains asyncio is a powerful Python library used to write concurrent code using the async/await syntax.

Learning Objectives

Explain the purpose of Asyncio in a practical learning context.
Identify the main ideas, terms, and decisions involved in Asyncio.
Apply Asyncio in a simple real-world scenario or practice task.

Introduction

Asyncio is a powerful Python library used to write concurrent code using the async/await syntax.

It allows you to run multiple tasks seemingly at the same time without using multiple threads or processes.

This tutorial will guide you through the basics of asyncio, its core concepts, and practical examples.

Concurrency is not parallelism.

What is Asyncio?

Asyncio is a library to write asynchronous code in Python. It uses an event loop to manage and schedule tasks.

Unlike threading, asyncio uses cooperative multitasking, where tasks voluntarily yield control to allow other tasks to run.

Built into Python's standard library since version 3.4.
Uses async/await syntax introduced in Python 3.5 for clearer asynchronous code.
Ideal for I/O-bound and high-level structured network code.

Core Concepts of Asyncio

Understanding asyncio requires familiarity with several key concepts: event loop, coroutine, task, and future.

Asyncio Core Concepts
Concept	Description
Event Loop	Central loop that runs asynchronous tasks and callbacks.
Coroutine	Special function declared with async that can pause and resume execution.
Task	Wrapper for a coroutine scheduled in the event loop.
Future	An object representing a result that may not be available yet.

Writing Your First Asyncio Program

Let's write a simple asyncio program that runs two coroutines concurrently.

Example: Concurrent Hello

This example demonstrates running two asynchronous functions concurrently using asyncio.

Managing Tasks and the Event Loop

Tasks are used to schedule coroutines concurrently on the event loop.

You can create tasks explicitly or let asyncio.run handle the event loop for you.

Use asyncio.create_task() to schedule a coroutine as a task.
asyncio.run() is the recommended entry point to run the main coroutine.

When to Use Asyncio

Asyncio is best suited for I/O-bound and high-level structured network code.

It is not ideal for CPU-bound tasks, which should use multiprocessing or threading.

Network servers and clients
Web scraping with asynchronous HTTP requests
Concurrent database queries
Handling multiple socket connections

Practical Example

This example runs two 'say_hello' coroutines concurrently, printing 'Hello' twice, then after a 1 second pause, 'World' twice.

Examples

Simple Asyncio Hello World

import asyncio

async def say_hello():
    print('Hello')
    await asyncio.sleep(1)
    print('World')

async def main():
    await asyncio.gather(say_hello(), say_hello())

asyncio.run(main())

This example runs two 'say_hello' coroutines concurrently, printing 'Hello' twice, then after a 1 second pause, 'World' twice.

Best Practices

Use asyncio.run() to start your main coroutine for proper event loop management.
Avoid blocking calls like time.sleep() inside async functions; use asyncio.sleep() instead.
Handle exceptions inside coroutines to prevent silent failures.
Use asyncio.gather() to run multiple coroutines concurrently and wait for all to complete.
Keep coroutines short and non-blocking to maintain responsiveness.

Common Mistakes

Calling blocking functions inside async code causing the event loop to freeze.
Forgetting to await coroutines, leading to unexpected behavior.
Using time.sleep() instead of asyncio.sleep() inside async functions.
Creating multiple event loops in the same thread.
Not handling exceptions in asynchronous tasks.

Hands-on Exercise

Create an Asyncio Timer

Write an asyncio coroutine that prints a message every second for 5 seconds.

Expected output: Message printed once every second for 5 times.

Hint: Use asyncio.sleep() inside a loop to wait asynchronously.

Fetch Multiple URLs Asynchronously

Use asyncio and aiohttp to fetch content from multiple URLs concurrently.

Expected output: Content of all URLs fetched asynchronously.

Hint: Use asyncio.gather() and async HTTP requests.

Interview Questions

What is the difference between threading and asyncio in Python?

Interview

Threading uses multiple OS threads for concurrency, which can run in parallel but have overhead and complexity. Asyncio uses a single-threaded event loop with cooperative multitasking, which is efficient for I/O-bound tasks but not suitable for CPU-bound tasks.

How do you run multiple coroutines concurrently in asyncio?

Interview

You can use asyncio.gather() to run multiple coroutines concurrently and wait for all of them to complete.

What is a coroutine in Python asyncio?

Interview

A coroutine is a special function declared with async that can pause execution with await and resume later, enabling asynchronous programming.