Anthony Shaw


Python 3.7’s new builtin breakpoint — a quick tour

Debugging in Python has always felt a bit “awkward” compared with other languages I’ve worked in.

Most developers import the pdb module from the standard library and run pdb.set_trace() which enters an interactive debugging session in the console when executed.

There are some important issues with this approach:

  1. Writing import pdb; pdb.set_trace() is a little obtuse. Once you’ve typed it 100 times it goes into muscle memory but for new developers it’s not obvious.
  2. PDB is not the only debugger, it’s also the most basic. There are plenty of better options.
  3. What happens if you’re not writing a console app? What if the breakpoint get’s hit on a server, or a threaded task, where is the debugging session?

Python 3.7 implements PEP553, a new way of inserting breakpoints in your code.

The new breakpoint method

OK, first breakpoint is a function and NOT a keyword.

So just putting breakpoint on the line of code you want to break on does nothing. You need to call it as a method, ie. breakpoint()

The default implementation of breakpoint will import pdb and call pdb.set_trace() .

Yields a pdb session on the command line.

So this is already a lot more intuitive that current versions of Python.

But wait, there’s more

The new breakpoint method can be disabled using the PYTHONBREAKPOINT environment variable. So if you do leave breakpoints in your code and you want to execute it just once without having them stall execution. You can set the environment value to 0.


Calling the same script again just completes execution and skips calling the breakpoint.

But wait, there’s more!

The PYTHONBREAKPOINT environment variable can be set to the name of a callable. This can be the callable that starts a debugging session in another 3rd party debugger library.

pudb is one such library. Pudb is an interactive console debugger with similar key mappings as pdb, but just so much easier to work with. pudb has been around for ages, supported in Python 2 and 3.

To use pudb as your debugger, first make sure you have installed it, pip install pudb and then set the environment variable to pudb.set_trace.

Calling this on the command line:

PYTHONBREAKPOINT=pudb.set_trace python3.7

Is the equivalent to replacing the breakpoint() method with import pudb; pudb.set_trace()

Pretty neat.

What about remote debugging and threads?

This new breakpoint feature opens up an interesting use case.

Whilst you’re developing an application for distribution across multiple servers or threads, you can use a local debugger, like pudb.

When you deploy to a testing environment, you likely aren’t executing from the cli. You’re calling from gevent or WSGI etc. This is when you change the environment variable in your web service or test environment to another debugger that allows remote connections.

One such package you could use is web-pdb. Web-pdb is a remote debugger that starts a web server when the breakpoint hits and you can remotely connect via a browser and interactively debug the session.

If you pip install web-pdb then you can set export PYTHONBREAKPOINT=’web_pdb.set_trace’ now when the breakpoint() function is called (no matter if it’s in a background process) you can connect to the service locally by default on port 5555 and you’ll be greeted with this interface.

Still stuck on Python 2?

Check out my new course on Pluralsight for moving from Python 2 to 3.

More by Anthony Shaw

Topics of interest

More Related Stories