Using a GUI Python Debugger with Sage (PUDB)

Introduction

The PUDB Python debugger provides a colorful ncurses-based "text-GUI" debugger that can be called by the local Sage python interpreter to debug Python scripts that interface with built-in Sage functions and types. In this tutorial, we provide a small sample script that interfaces with Sage and detail howto debug with PUDB in this case. The separate non-math-related tutorial for PUDB located at the link is a primary reference here, though we only reproduce the highlights of that full introduction to PUDB in this tutorial. We also cover installation of the PUDB module with the separate local Python that comes bundled with Sage in the next section, which is somewhat different than installing the module with a package-manager such as apt. Another video tutorial giving a concise overview of the PUDB debugger is found at this link.

Installation of PUDB in Sage

Add the sage-pudb alias to the local .bashrc

An Example Program

Core Features of PUDB

Configuration

Line Numbers

Configuring Printed Variable Representations