 This notebook contains an excerpt from the Whirlwind Tour of Python by Jake VanderPlas; the content is available on GitHub.

The text and code are released under the CC0 license; see also the companion project, the Python Data Science Handbook.

# Generators¶

Here we'll take a deeper dive into Python generators, including generator expressions and generator functions.

## Generator Expressions¶

The difference between list comprehensions and generator expressions is sometimes confusing; here we'll quickly outline the differences between them:

### List comprehensions use square brackets, while generator expressions use parentheses¶

This is a representative list comprehension:

In :
[n ** 2 for n in range(12)]

Out:
[0, 1, 4, 9, 16, 25, 36, 49, 64, 81, 100, 121]

While this is a representative generator expression:

In :
(n ** 2 for n in range(12))

Out:
<generator object <genexpr> at 0x104a60518>

Notice that printing the generator expression does not print the contents; one way to print the contents of a generator expression is to pass it to the list constructor:

In :
G = (n ** 2 for n in range(12))
list(G)

Out:
[0, 1, 4, 9, 16, 25, 36, 49, 64, 81, 100, 121]

### A list is a collection of values, while a generator is a recipe for producing values¶

When you create a list, you are actually building a collection of values, and there is some memory cost associated with that. When you create a generator, you are not building a collection of values, but a recipe for producing those values. Both expose the same iterator interface, as we can see here:

In :
L = [n ** 2 for n in range(12)]
for val in L:
print(val, end=' ')

0 1 4 9 16 25 36 49 64 81 100 121
In :
G = (n ** 2 for n in range(12))
for val in G:
print(val, end=' ')

0 1 4 9 16 25 36 49 64 81 100 121

The difference is that a generator expression does not actually compute the values until they are needed. This not only leads to memory efficiency, but to computational efficiency as well! This also means that while the size of a list is limited by available memory, the size of a generator expression is unlimited!

An example of an infinite generator expression can be created using the count iterator defined in itertools:

In :
from itertools import count
count()

Out:
count(0)
In :
for i in count():
print(i, end=' ')
if i >= 10: break

0 1 2 3 4 5 6 7 8 9 10

The count iterator will go on happily counting forever until you tell it to stop; this makes it convenient to create generators that will also go on forever:

In :
factors = [2, 3, 5, 7]
G = (i for i in count() if all(i % n > 0 for n in factors))
for val in G:
print(val, end=' ')
if val > 40: break

1 11 13 17 19 23 29 31 37 41

You might see what we're getting at here: if we were to expand the list of factors appropriately, what we would have the beginnings of is a prime number generator, using the Sieve of Eratosthenes algorithm. We'll explore this more momentarily.

### A list can be iterated multiple times; a generator expression is single-use¶

This is one of those potential gotchas of generator expressions. With a list, we can straightforwardly do this:

In :
L = [n ** 2 for n in range(12)]
for val in L:
print(val, end=' ')
print()

for val in L:
print(val, end=' ')

0 1 4 9 16 25 36 49 64 81 100 121
0 1 4 9 16 25 36 49 64 81 100 121 

A generator expression, on the other hand, is used-up after one iteration:

In :
G = (n ** 2 for n in range(12))
list(G)

Out:
[0, 1, 4, 9, 16, 25, 36, 49, 64, 81, 100, 121]
In :
list(G)

Out:
[]

This can be very useful because it means iteration can be stopped and started:

In :
G = (n**2 for n in range(12))
for n in G:
print(n, end=' ')
if n > 30: break

print("\ndoing something in between")

for n in G:
print(n, end=' ')

0 1 4 9 16 25 36
doing something in between
49 64 81 100 121 

One place I've found this useful is when working with collections of data files on disk; it means that you can quite easily analyze them in batches, letting the generator keep track of which ones you have yet to see.

## Generator Functions: Using yield¶

We saw in the previous section that list comprehensions are best used to create relatively simple lists, while using a normal for loop can be better in more complicated situations. The same is true of generator expressions: we can make more complicated generators using generator functions, which make use of the yield statement.

Here we have two ways of constructing the same list:

In :
L1 = [n ** 2 for n in range(12)]

L2 = []
for n in range(12):
L2.append(n ** 2)

print(L1)
print(L2)

[0, 1, 4, 9, 16, 25, 36, 49, 64, 81, 100, 121]
[0, 1, 4, 9, 16, 25, 36, 49, 64, 81, 100, 121]


Similarly, here we have two ways of constructing equivalent generators:

In :
G1 = (n ** 2 for n in range(12))

def gen():
for n in range(12):
yield n ** 2

G2 = gen()
print(*G1)
print(*G2)

0 1 4 9 16 25 36 49 64 81 100 121
0 1 4 9 16 25 36 49 64 81 100 121


A generator function is a function that, rather than using return to return a value once, uses yield to yield a (potentially infinite) sequence of values. Just as in generator expressions, the state of the generator is preserved between partial iterations, but if we want a fresh copy of the generator we can simply call the function again.

## Example: Prime Number Generator¶

Here I'll show my favorite example of a generator function: a function to generate an unbounded series of prime numbers. A classic algorithm for this is the Sieve of Eratosthenes, which works something like this:

In :
# Generate a list of candidates
L = [n for n in range(2, 40)]
print(L)

[2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39]

In :
# Remove all multiples of the first value
L = [n for n in L if n == L or n % L > 0]
print(L)

[2, 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 23, 25, 27, 29, 31, 33, 35, 37, 39]

In :
# Remove all multiples of the second value
L = [n for n in L if n == L or n % L > 0]
print(L)

[2, 3, 5, 7, 11, 13, 17, 19, 23, 25, 29, 31, 35, 37]

In :
# Remove all multiples of the third value
L = [n for n in L if n == L or n % L > 0]
print(L)

[2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37]


If we repeat this procedure enough times on a large enough list, we can generate as many primes as we wish.

Let's encapsulate this logic in a generator function:

In :
def gen_primes(N):
"""Generate primes up to N"""
primes = set()
for n in range(2, N):
if all(n % p > 0 for p in primes):

2 3 5 7 11 13 17 19 23 29 31 37 41 43 47 53 59 61 67 71 73 79 83 89 97