Learn how to write your own framework in Python!

You'll learn how to develop your own Python web framework to see how all the magic works beneath the scenes in Flask, Django, and the other Python-based web frameworks.

Jahongir Rahmonov

I'm a Software Engineer at Delivery Hero. Avid reader. WIUT graduate. Blogger and an amateur speaker.

I write about Python, Django, Kubernetes and sometimes something non-technical.

Welcome to my corner

Fri 08 December 2017

Python GIL

In this blog post, we will look at Python GIL, Threads, Processes and AsyncIO.

Let's say that we want to write a function that takes a number as an argument and simply counts down. Pretty easy:

def count_down(n):
    while n > 0:
        n -= 1

Let's call this function with a big number and measure how much it takes:

from time import time

before = time()
after = time()


On my machine, it takes 8.54 seconds. Now, let's call it twice and measure that:

from time import time

before = time()
after = time()


On my machine, it takes 17.38 seconds.

It is working fine but our boss is not happy. He wants us to make it faster. How do we make it faster? We use threads so that these two function calls run in parallel, right? In theory, running a function twice in parallel should take as much as running it once. Because, well, those two function calls run in parallel. Let's try this out by calling the function twice but in different threads:

from threading import Thread
from time import time

before = time()

thread1 = Thread(target=count_down, args=(100000000,))
thread2 = Thread(target=count_down, args=(100000000,))



after = time()

It takes around 18.4 seconds on my machine. Wait, WHAT? It not only did not take as much as calling the function once but in fact it was even slower than calling the function twice without Threads. Try that with Python2.7 and you will get even worse results. A prominent software developer, David Beazly reported that it even took almost 2x time in his talk Inside the Python GIL.

But, WHY?

Please, welcome the notorious GIL - Global Interpreter Lock. This guy is to blame for all the problems in the world. GIL allows only one thread to run at a time. In the above example, when we thought we were using two threads, we were only using just one, because the big boss GIL did not allow us to. That's why, it did not run faster. But, why was it even slower? That's because every now and then Python tries to switch Threads as we asked him to use two. GIL does not allow him to do so. However, when he tries to switch to no avail, there is some overhead associated with it. Thus, the end result is even slower.

But, WHY?

We all know that Threads can be a good thing and help us make our programs run much faster. Why does the GIL exist, then? Damn you, GIL! You are like Negan from the Walking Dead.

Well, it turns out GIL is not the villain after all. Actually, GIL is the good guy. It turns out that Python's memory management is not thread-safe! That is, if you run multiple threads, your program may behave in weird and even catastrophic ways. GIL is there to help us from such scenarios.

But, wouldn't it be easier to remove the Thread class instead?

Excellent question! Instead of writing an additional tool that would prevent Threads from doing bad things to our programs, why not just delete the Thread classes so that programmers simply won't be able to use them? We are not allowed to use them anyways.

Turns out, there are some cases when Thread can be of use. All above examples were CPU bound, meaning that they need only CPU to run, they wait on CPU. However, if your code is IO bound or image processing or NumPy number crunching, GIL won't be in your way as these operations happen outside the GIL. That's where you can use the Thread class safely and effectively.

Let's write some IO bound function. A function that requests a web url and returns its content as a text:

import requests

def get_content(url):
    response = requests.get(url)
    return response.text

Calling this function once with the argument https://google.com takes 0.88 seconds on my machine. Calling it twice - 1.72 seconds, of course. Now, let's call it twice in different threads and see the Thread's effect:

before = time()

thread1 = Thread(target=get_content, args=('https://google.com',))
thread2 = Thread(target=get_content, args=('https://google.com',))



after = time()

print(after - before)

It takes 0.89 seconds. Hooray! Calling the function twice in different threads took as much as calling it just once. Once again, it worked because our function was IO bound. The same thing did not work above when the function was CPU bound.

There is a catch

Each thread takes some additional memory and thread switching takes some time. Although it is not a lot, it adds up when you have thousands of threads running. Think gigabytes of extra RAM and at least 5% of CPU time spent only for context switching.

In order to solve this, Python developers came up with the asyncio library. Basically, it has its own event loop to control the execution of functions in an asynchronous way inside a single thread. If Threads were controlled by the underlying OS, asyncio knows when to switch tasks with the help of some keywords written by developers themselves. That's right! You get to decide when to switch. Let's convert the above example to use asyncio:

import asyncio
import aiohttp

loop = asyncio.get_event_loop()
session = aiohttp.ClientSession(loop=loop)

async def get_content(pid, url):
    async with session.get(url) as response:
        content = await response.read()
        print(pid, content)

loop.create_task(get_content(1, 'http://asyncio.readthedocs.io/'))
loop.create_task(get_content(2, 'http://asyncio.readthedocs.io/'))
loop.create_task(get_content(3, 'http://asyncio.readthedocs.io/'))
loop.create_task(get_content(4, 'http://asyncio.readthedocs.io/'))
loop.create_task(get_content(5, 'http://asyncio.readthedocs.io/'))


Note that we are using aiohttp instead of requests because it is an asynchronous http library. Without going into the details, what this code does is define an async function (aka coroutine) and call it 5 times with some id (just to illustrate asynchronicity). Output would be something like this:

3 b'<!DOCTYPE html PUBLIC...
4 b'<!DOCTYPE html PUBLIC...
2 b'<!DOCTYPE html PUBLIC...
1 b'<!DOCTYPE html PUBLIC...
5 b'<!DOCTYPE html PUBLIC...

Note that ids are not in the order they were called, meaning that the tasks were switched when they encountered the keyword await. We get the same results as using Threads but asyncio uses less overhead and you control the switching process.

Although this does not explain the details of asyncio, I hope it at least explains why it is useful.

Okay, now that we dealt with IO bound tasks, let's go back to our first CPU bound problem.

There is still hope for CPU bound tasks!

Turns out there is multiprocessing.Process class in Python which offers similar functionality and interface to the Thread class. The difference is that it uses sub-processes instead of threads. That's why, it won't be blocked by the GIL. Awesome! Let's try that out with the above examples. As I said, it offers a similar interface to the Thread class and thus we will just have to replace Thread with Process and we are done:

from multiprocessing import Process
from time import time

before = time()

process1 = Process(target=count_down, args=(100000000,))
process2 = Process(target=count_down, args=(100000000,))



after = time()

It took ~8 seconds on my machine. That is as much as it took when we called the function just once. Cool! Try adding one more process and it will still take the same time. That is awesome! However, do keep in mind that processes run in a separate memory space thus can't share data with each other, whereas, threads can.

Also keep in mind that we are talking about the CPython here. Other implementations such Jython and IronPython don't have GIL so they can use Threads. If you don't know what Jython or IronPython are, refer to this post of mine.

Thanks for reading and make sure to leave a comment if you have any questions.

Fight on!


If you liked what you read, subscribe below. Once in a while, I will send you a list of my new posts.