Manual de referencia de la API en C de Python
*********************************************

Este manual documenta la API utilizada por los programadores de C y C
++ que desean escribir módulos de extensión o incorporar Python. Es un
complemento de Ampliación e incrustación del intérprete de Python, que
describe los principios generales de la escritura de extensión pero no
documenta las funciones API en detalle.

* Introducción

  * Language version compatibility

  * Estándares de codificación

  * Archivos de cabecera (*Include*)

  * Macros útiles

  * Objetos, tipos y conteos de referencias

  * Excepciones

  * Integración de Python

  * Depuración de compilaciones

  * Recommended third party tools

* Estabilidad de la API en C

  * Unstable C API

  * Interfaz binaria de aplicación estable

  * Consideraciones de la plataforma

  * Contenido de la API limitada

* La capa de muy alto nivel

* Conteo de referencias

* Manejo de excepciones

  * Impresión y limpieza

  * Lanzando excepciones

  * Emitir advertencias

  * Consultando el indicador de error

  * Manejo de señal

  * Clases de excepción

  * Objetos excepción

  * Objetos unicode de excepción

  * Control de recursión

  * Exception and warning types

* Defining extension modules

  * Multiple module instances

  * Initialization function

  * Multi-phase initialization

  * Legacy single-phase initialization

* Utilidades

  * Utilidades del sistema operativo

  * Funciones del Sistema

  * Control de procesos

  * Importando módulos

  * Soporte de empaquetado (*marshalling*) de datos

  * Analizando argumentos y construyendo valores

  * Conversión y formato de cadenas de caracteres

  * PyHash API

  * Reflexión

  * Registro de códec y funciones de soporte

  * PyTime C API

  * Soporte para Mapeo Perf

* Capa de objetos abstractos

  * Protocolo de objeto

  * Protocolo de llamada

  * Protocolo de números

  * Protocolo de secuencia

  * Protocolo de mapeo

  * Protocolo iterador

  * Protocolo búfer

* Capa de objetos concretos

  * Objetos fundamentales

  * Objetos numéricos

  * Objetos de secuencia

  * Objetos contenedor

  * Objetos de función

  * Otros objetos

* Inicialización, finalización e hilos

  * Antes de la inicialización de Python

  * Variables de configuración global

  * Inicializando y finalizando el intérprete

  * Parámetros de todo el proceso

  * Estado del hilo y el bloqueo global del intérprete

  * Soporte de subinterprete

  * Notificaciones asincrónicas

  * Perfilado y Rastreo

  * Rastreo de referencia

  * Soporte avanzado del depurador

  * Soporte de almacenamiento local de hilo

  * Primitivas de sincronización

* Configuración de inicialización de Python

  * PyInitConfig C API

  * Configuration Options

  * Runtime Python configuration API

  * PyConfig C API

  * Py_GetArgcArgv()

  * Delaying main module execution

* Gestión de la memoria

  * Visión general

  * Dominios del asignador

  * Interfaz de memoria sin procesar

  * Interfaz de memoria

  * Asignadores de objetos

  * Asignadores de memoria predeterminados

  * Personalizar asignadores de memoria

  * Configurar enlaces para detectar errores en las funciones del
    asignador de memoria de Python

  * El asignador pymalloc

  * El asignador mimalloc

  * tracemalloc C API

  * Ejemplos

* Soporte de implementación de objetos

  * Asignación de objetos en el montículo

  * Object Life Cycle

  * Estructuras de objetos comunes

  * Type Object Structures

  * Apoyo a la recolección de basura cíclica

* Versiones de API y ABI

  * Build-time version constants

  * Run-time version

  * Bit-packing macros

* Monitoring C API

* Generating Execution Events

  * Managing the Monitoring State
