Debugging and profiling
***********************

Estas bibliotecas le ayudan con el desarrollo de Python: el depurador
le permite recorrer paso a paso el código, analizar marcos de pila y
establecer puntos de interrupción, etc., y los perfiladores ejecutan
código y le proporcionan un desglose detallado de los tiempos de
ejecución, lo que le permite identificar cuellos de botella en sus
programas. Los eventos de auditoría proporcionan visibilidad de los
comportamientos en tiempo de ejecución que, de lo contrario,
requerirían depuración o parches intrusivos.

* Tabla de auditoría de eventos

* "bdb" --- Debugger framework

* "faulthandler" --- Dump the Python traceback

  * Volcar el rastreo

  * Dumping the C stack

    * C Stack Compatibility

  * Estado del gestor de fallos

  * Volcar los rastreos después de un tiempo de espera

  * Volcar el rastreo en una señal del usuario

  * Problema con descriptores de archivo

  * Ejemplo

* "pdb" --- El Depurador de Python

  * Command-line interface

  * Debugger commands

* "profiling" --- Python profilers

  * Introduction to profiling

  * Choosing a profiler

    * When to use statistical sampling

    * When to use deterministic tracing

  * Quick start

    * Statistical profiling

    * Deterministic profiling

  * Understanding profile output

  * Legacy compatibility

    * "profiling.tracing" --- Deterministic profiler

      * What is deterministic profiling?

      * Command-line interface

      * Programmatic usage examples

        * Basic profiling

        * Using the "Profile" class

      * Module reference

      * Using a custom timer

      * Limitations

    * "profiling.sampling" --- Statistical profiler

      * What is statistical profiling?

        * How time is estimated

        * When to use a different approach

      * Quick examples

      * Commands

        * The "run" command

        * The "attach" command

        * The "replay" command

        * Profiling in production

        * Platform requirements

        * Version compatibility

      * Sampling configuration

        * Sampling rate and duration

        * Thread selection

        * Blocking mode

        * Special frames

        * Opcode-aware profiling

        * Real-time statistics

        * Subprocess profiling

        * Sampling efficiency

      * Profiling modes

        * Wall-clock mode

        * CPU mode

        * Comparing wall-clock and CPU profiles

        * GIL mode

        * Exception mode

      * Output formats

        * pstats format

        * Collapsed stacks format

        * Flame graph format

        * Gecko format

        * Heatmap format

        * Binary format

      * Record and replay workflow

      * Live mode

        * Keyboard commands

      * Async-aware profiling

        * Async modes

        * Task markers and stack reconstruction

        * Option restrictions

      * Command-line interface

        * Global options

        * Sampling options

        * Mode options

        * Output options

        * pstats display options

        * Run command options

* "pstats" --- Statistics for profilers

  * Reading and displaying profile data

    * Working with statistics

    * Filtering output

    * Analyzing call relationships

    * Combining multiple profiles

  * The "Stats" class

  * Command-line interface

* "timeit" --- Measure execution time of small code snippets

  * Ejemplos básicos

  * Interfaz de Python

  * Interfaz de línea de comandos

  * Ejemplos

* "trace" --- Trace or track Python statement execution

  * Uso de la línea de comandos

    * Opciones principales

    * Modificadores

    * Filtros

  * Interfaz programática

* "tracemalloc" --- Trace memory allocations

  * Ejemplos

    * Mostrar los 10 principales

    * Calcula las diferencias

    * Consigue el seguimiento del bloque de memoria

    * "Los 10 más bonitos"

      * Graba los tamaños actual y máximo de todos los bloques de
        memoria rastreados

  * API

    * Funciones

    * Filtro de dominio

    * Filtro

    * Cuadro

    * Captura instantánea

    * Estadística

    * StatisticDiff

    * Rastro

    * Seguimiento
