Cython para C++: guía completa con ejemplos prácticos

¡Bienvenido a PythonLib! Hoy nos sumergimos en el fascinante mundo de Cython, una herramienta poderosa que combina la flexibilidad de Python con el rendimiento de C y C++. Si alguna vez soñaste con escribir extensiones de alto rendimiento para Python en C++ sin abandonar la sintaxis familiar de Python, este artículo es para ti.

1. ¿Qué es Cython y por qué usarlo?

Cython es un lenguaje de programación compilado que es un superconjunto de Python. Permite escribir código que se traduce a código C/C++ eficiente y luego se compila en bibliotecas dinámicas (extensiones de Python). El objetivo principal de Cython es acelerar la ejecución de programas Python y proporcionar acceso directo a bibliotecas de C/C++.

¿Por qué es necesario? Python, al ser un lenguaje interpretado, a menudo pierde rendimiento frente a los lenguajes compilados. Cython resuelve este problema permitiendo:

• Acelerar secciones críticas de código entre 10 y 100 veces gracias a la tipificación estática y la compilación.
• Integrar bibliotecas C/C++ existentes (por ejemplo, OpenCV, NumPy, TensorFlow) sin necesidad de escribir envoltorios en C puro.
• Crear módulos Python de alto rendimiento para computación científica, procesamiento de datos, aprendizaje automático y videojuegos.
• Usar la sintaxis familiar de Python con cambios mínimos para alcanzar la velocidad de C.

Cython es especialmente popular en el ecosistema científico de Python (SciPy, scikit-learn, pandas), donde el rendimiento es crítico. También se utiliza en frameworks web (como uWSGI) y motores de juegos (Pygame).

2. Instalación de Cython

Instalar Cython es sencillo y se hace a través del gestor de paquetes estándar de Python: pip. Para trabajar con C++, también necesitarás un compilador de C++ (g++, clang++ o MSVC).

# Instalación de Cython
pip install cython

# Para desarrollo también es útil instalar setuptools
pip install setuptools

# Verificar la instalación
python -c "import cython; print(cython.__version__)"

Nota: Si usas Anaconda, Cython ya viene preinstalado. Para compilar código C++, asegúrate de tener un compilador instalado:

• Linux: sudo apt install g++
• macOS: xcode-select --install
• Windows: Instala Build Tools for Visual Studio

3. Inicio rápido: ejemplo mínimo funcional

Crearemos una extensión Cython muy simple que suma dos números. Esto muestra el ciclo básico de trabajo: escribir un archivo .pyx, crear un setup.py y compilar.

Paso 1: Crea el archivo hello.pyx

# hello.pyx
def add(int a, int b):
    return a + b

Paso 2: Crea el archivo setup.py

# setup.py
from setuptools import setup
from Cython.Build import cythonize

setup(
    ext_modules=cythonize("hello.pyx", language="c++"),  # language="c++" para C++
)

Paso 3: Compila la extensión

python setup.py build_ext --inplace

Después de la compilación, aparecerá un archivo hello.cpython-3XX-*.so (o .pyd en Windows).

Paso 4: Usa el módulo en Python

# test.py
import hello
print(hello.add(5, 3))  # Salida: 8

¡Listo! Acabas de crear tu primera extensión Cython en C++. Detrás de escena, Cython generó código C++, lo compiló y creó una biblioteca dinámica.