Mastering Python Coroutines: From Basics to Real-World File Search

1. Coroutine

Coroutine, also called micro‑thread, is a user‑level lightweight thread. Unlike OS‑scheduled threads, coroutines are scheduled by the programmer within a single thread, allowing a function to pause and resume at defined points.

Technically, a coroutine has its own register context and stack; when switched, these are saved and restored, preserving the state of the previous call.

1.1 Advantages

Eliminates thread‑context‑switch overhead, improving performance (though the programmer must handle scheduling and loses multi‑CPU utilization).

No need for atomic locks or synchronization.

Simplifies control‑flow switching and programming model.

Supports high concurrency and scalability; thousands of coroutines can run on a single CPU.

1.2 Disadvantages

Runs in a single thread, cannot fully utilize multiple CPU cores without combining with processes.

Blocking I/O operations block the entire program.

2. Implementing Coroutines with Python's yield

Using yield allows a function to pause and resume, enabling coroutine behavior.

Result shows that the function becomes a generator.

2.1 Sending values to a coroutine

First call next() to advance to the yield point, then use send() to provide a value and resume execution.

Result demonstrates the need to initialize with next() each time.

2.2 Simple coroutine applications

Example: feeding a virtual pet.

3. Procedural Programming Approach for a File‑Search Tool

The task is to implement a Linux‑style grep -rl error <directory> utility that walks a directory tree, opens each file, reads lines, filters those containing “error”, and prints the file name.

The os.walk method returns a tuple (path, directories, files). The solution follows five stages: find absolute paths, open files, read lines, filter “error”, and print matching file names.

Subsequent images illustrate each stage of the implementation.