# Ampliación e incrustación del intérprete de Python

Este documento describe cómo escribir módulos en C o C++ para extender el intérprete de Python con nuevos módulos. Esos módulos no solo pueden definir nuevas funciones sino también nuevos tipos de objetos y sus métodos. El documento también describe cómo incrustar el intérprete de Python en otra aplicación, para usarlo como un lenguaje de extensión. Finalmente, muestra cómo compilar y vincular módulos de extensión para que puedan cargarse dinámicamente (en tiempo de ejecución) en el intérprete, si el sistema operativo subyacente admite esta característica.

Este documento asume conocimientos básicos sobre Python. Para una introducción informal al lenguaje, consulte El tutorial de Python. Referencia del Lenguaje Python da una definición más formal del lenguaje. La Biblioteca Estándar de Python documenta los tipos de objetos, funciones y módulos existentes (tanto incorporados como escritos en Python) que le dan al lenguaje su amplio rango de aplicaciones.

Para obtener una descripción detallada de toda la API de Python/C, consulte el apartado separado Manual de referencia de la API en C de Python.

## Herramientas de terceros recomendadas

Esta guía solo cubre las herramientas básicas para crear extensiones proporcionadas como parte de esta versión de CPython. Herramientas de terceros como Cython, cffi, SWIG y Numba ofrecen enfoques más simples y sofisticados para crear extensiones C y C++ para Python.

Ver también

Guía del Usuario de Empaquetamiento de Python: Extensiones binarias

  La Guía del Usuario de Empaquetamiento de Python no solo cubre varias herramientas disponibles que simplifican la creación de extensiones binarias, sino que también discute las diversas razones por las cuales crear un módulo de extensión puede ser deseable en primer lugar.

## Crear extensiones sin herramientas de terceros

Esta sección de la guía cubre la creación de extensiones C y C++ sin la ayuda de herramientas de terceros. Está destinado principalmente a los creadores de esas herramientas, en lugar de ser una forma recomendada de crear sus propias extensiones C.

- 1. Extendiendo Python con C o C++
  - 1.1. Un ejemplo simple
  - 1.2. Intermezzo: errores y excepciones
  - 1.3. De vuelta al ejemplo
  - 1.4. La tabla de métodos del módulo y la función de inicialización
  - 1.5. Compilación y Enlazamiento
  - 1.6. Llamando funciones Python desde C
  - 1.7. Extracción de parámetros en funciones de extensión
  - 1.8. Parámetros de palabras clave para funciones de extensión
  - 1.9. Construyendo Valores Arbitrarios
  - 1.10. Conteo de Referencias
  - 1.11. Escribiendo Extensiones en C++
  - 1.12. Proporcionar una API C para un módulo de extensión
- 2. Definición de tipos de extensión: Tutorial
  - 2.1. Lo Básico
  - 2.2. Agregar datos y métodos al ejemplo básico
  - 2.3. Proporcionar un control más preciso sobre los atributos de datos
  - 2.4. Apoyo a la recolección de basura cíclica
  - 2.5. Subclases de otros tipos
- 3. Definición de tipos de extensión: temas variados
  - 3.1. Finalización y desasignación
  - 3.2. Presentación de Objetos
  - 3.3. Gestión de atributos
  - 3.4. Comparación de Objetos
  - 3.5. Soporte de protocolo abstracto
  - 3.6. Soporte de referencia débil
  - 3.7. Más Sugerencias
- 4. Construyendo Extensiones C y C++
  - 4.1. Construyendo Extensiones C y C++ con distutils
  - 4.2. Distribuyendo sus módulos de extensión
- 5. Creación de extensiones C y C++ en Windows
  - 5.1. Un enfoque de libro de cocina
  - 5.2. Diferencias entre Unix y Windows
  - 5.3. Usar DLL en la práctica

## Incrustar el tiempo de ejecución de CPython en una aplicación más grande

A veces, en lugar de crear una extensión que se ejecute dentro del intérprete de Python como la aplicación principal, es conveniente incorporar el tiempo de ejecución de CPython dentro de una aplicación más grande. Esta sección cubre algunos de los detalles involucrados en hacerlo con éxito.

- 1. Incrustando Python en Otra Aplicación
  - 1.1. Incrustación de muy alto nivel
  - 1.2. Más allá de la incrustación de muy alto nivel: una visión general
  - 1.3. Incrustación pura
  - 1.4. Extendiendo Python Incrustado
  - 1.5. Incrustando Python en C++
  - 1.6. Compilar y enlazar bajo sistemas tipo Unix