Python-build-standalone permite crear distribuciones independientes y reubicables del intérprete Python, adaptadas a una amplia variedad de arquitecturas de hardware. Esta herramienta es esencial para desplegar aplicaciones Python en entornos heterogéneos, desde servidores convencionales hasta sistemas embebidos o de cómputo en el borde.
Concepto y Arquitecturas Soportadas
El soporte para múltiples arquitecturas se define en archivos de configuración YAML dentro del proyecto, como cpython-unix/targets.yml. Este enfoque proporciona flexibilidad y permite la personalización detallada para cada objetivo de compilación.
- Familia x86: Incluye objetivos para Linux (con libc glibc y musl, en variantes v2, v3, v4) y macOS 64-bit.
- Familia ARM: Cubre ARM64 para Linux (glibc/musl) y macOS con Apple Silicon, además de ARMv7 de 32-bit para Linux.
- RISC-V: Soporte para riscv64 en Linux, disponible para Python 3.10 en adelante.
- Otras arquitecturas: El proyecto también tiene configuraciones para loongarch64, mips, ppc64le, s390x, entre otras.
Práctica: De la Clonación a la Compilación
Para iniciar, se requiere clonar el repositorio del proyecto.
git clone https://gitcode.com/gh_mirrors/py/python-build-standalone
cd python-build-standalone
Las dependencias del proyecto varían según el sistema operativo destino. Los archivos requirements*.txt proporcionan estas listas. Ejecutar el gestor de paquetes de Python con el archivo adecuado instala las herramientas necesarias.
pip install -r requirements.txt
El proceso de compilación está orquestado por un archivo Justfile. La sintaxis genarel para lanzar una compilación es:
just build <triple-objetivo> <version-python>
A continuación, algunos ejemplos de invocación para distintas plataformas:
# Compilar Python 3.12 para Linux x86_64
just build x86_64-unknown-linux-gnu 3.12
# Compilar Python 3.13 para macOS en ARM64
just build aarch64-apple-darwin 3.13
# Compilar Python 3.14 para Linux RISC-V 64-bit
just build riscv64-unknown-linux-gnu 3.14
Internos de Configuración
Cada entrada en el archivo de objetivos (targets.yml) especifica parámetros críticos. Esto incluye el compilador (target_cc), los indicadores del compilador para optimización específica de arquitectura, y una lista de dependencias del sistema (needs) que deben estar presantes.
# Ejemplo de configuración para una variante optimizada de x86-64
x86_64_v3-unknown-linux-gnu:
target_cflags:
- '-march=x86-64-v3'
- '-fvisibility=hidden'
Para compilaciones cruzadas, el proyecto emplea contenedores Docker. La configuración de la imagen se adapta mediante sufijos. Por ejemplo, un objetivo RISC-V podría especificar docker_image_suffix: .cross-riscv64, apuntando a un Dockerfile particular que incluye las herramientas de cadena cruzada.
Solución de Problemas y Validación
Si la compilación falla por dependencias faltantes, el primer paso es revisar la sección needs del objetivo correspondiente en targets.yml y asegurarse de que todos los paquetes estén instalados en el sistema anfitrión.
Una vez generada la distribución, el proyecto proporciona scripts para la verfiicación. Ejecutar el script de pruebas en el directorio de salida valida la integridad del paquete resultante.
python test-distribution.py /ruta/al/paquete/compilado