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
=====================================

This guide only covers the basic tools for creating extensions
provided as part of this version of CPython. Third party tools like
Cython, cffi, SWIG and Numba offer both simpler and more sophisticated
approaches to creating C and C++ extensions for 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
