Brief abstract/introduction/motivation. State what the chapter is about in 1-2 paragraphs. Then, have an introduction video:

from bookutils import YouTubeVideo



To use the code provided in this chapter, write

>>> from debuggingbook.Template import <identifier>

and then make use of the following features.

For those only interested in using the code in this chapter (without wanting to know how it works), give an example. This will be copied to the beginning of the chapter (before the first section) as text with rendered input and output.

You can use int_fuzzer() as:

>>> print(int_fuzzer())

Section 1


Section 2


All the Details

This text will only show up on demand (HTML) or not at all (PDF). This is useful for longer implementations, or repetitive, or specialized parts.

Section 3


If you want to introduce code, it is helpful to state the most important functions, as in:

  • random.randrange(start, end) - return a random number [start, end]
  • range(start, end) - create a list with integers from start to end. Typically used in iterations.
  • for elem in list: body executes body in a loop with elem taking each value from list.
  • for i in range(start, end): body executes body in a loop with i from start to end - 1.
  • chr(n) - return a character with ASCII code n
import random
def int_fuzzer() -> float:
    """A simple function that returns a random float"""
    return random.randrange(1, 100) + 0.5
# More code

Section 4


Lessons Learned

  • Lesson one
  • Lesson two
  • Lesson three

Next Steps

Link to subsequent chapters (notebooks) here, as in:


Cite relevant works in the literature and put them into context, as in:

The idea of ensuring that each expansion in the grammar is used at least once goes back to Burkhardt [Burkhardt et al, 1967], to be later rediscovered by Paul Purdom [Purdom et al, 1972].


Close the chapter with a few exercises such that people have things to do. To make the solutions hidden (to be revealed by the user), have them start with


Your solution can then extend up to the next title (i.e., any markdown cell starting with #).

Running make metadata will automatically add metadata to the cells such that the cells will be hidden by default, and can be uncovered by the user. The button will be introduced above the solution.

Exercise 1: Title

Text of the exercise

# Some code that is part of the exercise

Some more text for the exercise

Exercise 2: Title

Text of the exercise

Creative Commons License The content of this project is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License. The source code that is part of the content, as well as the source code used to format and display that content is licensed under the MIT License. Last change: 2023-11-11 18:05:06+01:00CiteImprint