sergio/takana

1# CPython 3.12.10 — dependencia de build del frente rust (variante b, SDD 11 §7.2b).
2#
3# El bootstrap de rust/LLVM corre scripts python3 (mrustc README: "python3, required for building llvm
4# in rustc"). El toolchain Alpine lo trae como paquete; esta receta lo construye desde fuente para
5# de-Alpinizar el camino de bootstrap de rust.
6#
7# python3 es una HERRAMIENTA del toolchain (corre scripts en build-time, no se enlaza en el 4/4): no
8# necesita casar byte-a-byte con el de Alpine, sólo interpretar igual. Build vainilla, sin patches.
9#
10# CPython usa autotools (./configure). zlib viene de recipes/zlib.toml (deps.build → materialize en
11# /usr); --without-ensurepip evita la red (pip), --disable-test-modules acorta el build (no se necesita
12# el test-suite). Enlace dinámico: el intérprete linkea libpython/libc; estático no aporta a una
13# herramienta de build-time y CPython estático es frágil. El sandbox exporta CC="zig cc -mcpu=baseline".
14#
15# CC=gcc/CXX=g++ (NO zig): igual que cmake, el intérprete `_bootstrap_python` compilado con `zig cc`
16# SEGFAULTEA al correr (paso de "freeze modules" del build) — zig 0.16 miscompila binarios musl
17# grandes (un hello-world dinámico zig sí corre; cmake y python no). Alpine compila python con gcc; el
18# toolchain trae gcc/g++ nativos y funcionales en el sandbox. Es herramienta, no input del 4/4 ⇒ el
19# compilador da igual mientras el intérprete corra. Con gcc, -Wdate-time ni siquiera molesta (gcc SÍ
20# honra SOURCE_DATE_EPOCH para silenciarlo); se deja CFLAGS=-Wno-error=date-time por robustez.
21
22name    = "python3"
23version = "3.12.10"
24license = "Python-2.0"
25
26[source]
27tarball = "https://www.python.org/ftp/python/3.12.10/Python-3.12.10.tgz"
28sha256  = "15d9c623abfd2165fe816ea1fb385d6ed8cf3c664661ab357f1782e3036a6dac"
29
30[build]
31compiler    = "zig-cc"
32target      = "x86_64-linux-musl"
33link        = "dynamic"
34# zig 0.13.0 (NO gcc): con zig 0.14+ el intérprete `_bootstrap_python` SEGFAULTEA en "freeze modules"
35# (regresión 0.14 en C/musl, misma clase que flex). 0.13.0 la esquiva ⇒ gcc deja de hacer falta.
36# CFLAGS=-Wno-error=date-time se conserva: clang (zig cc) NO silencia -Wdate-time vía SOURCE_DATE_EPOCH.
37zig_version = "0.13.0"
38
39[deps]
40# `libffi` NO es opcional aunque el build no falle sin él: sin libffi el `configure` de CPython
41# construye un intérprete SIN el módulo `_ctypes`, y lo hace en SILENCIO — sella un python3 que
42# arranca perfectamente y revienta más tarde, en otra receta, con
43# `ModuleNotFoundError: No module named '_ctypes'` (destapado 2026-08-11 en gjs y en el build de
44# mozjs). **310 recetas dependen de python3**, así que el fallo no se parece a su causa ni de lejos.
45#
46# Por qué aparece AHORA: el rootfs del lab trae `libffi` (runtime) pero NO sus headers — no hay
47# `libffi-dev` en el lock. El artefacto viejo de python3 sí tenía `_ctypes` porque el rootfs de
48# entonces los traía, y el cache-hit lo mantuvo congelado hasta que el corpus se re-hasheó entero.
49# Mismo patrón que `make`/`--disable-load`: reconstruir destapa lo que la caché sostenía.
50#
51# El arreglo va en `[deps]`, NUNCA engordando el rootfs: `recipes/libffi.toml` instala los headers
52# y el `.pc`, y `pkgconf` (ya declarado) los encuentra en la capa overlay.
53#
54# NO es sólo libffi. CPython omite EN SILENCIO cada módulo opcional cuyos headers no encuentra, y el
55# rootfs del lab trae los runtime pero casi ningún `-dev` (5 de 92 paquetes). Sin esta lista salen
56# intérpretes mutilados que arrancan bien: `_curses` faltaba además de `_ctypes` (gdm, 2026-08-11).
57# El corpus tiene receta propia para todas, así que declararlas es además de-Alpinizar.
58#
59# ⚠ `openssl` NO va, y es deliberado: el del corpus está de-Alpinizado como libcrypto ESTÁTICA para
60# el kernel y se construye SIN threads, así que CPython aborta con «OPENSSL_THREADS is not defined,
61# Python requires thread-safe OpenSSL» (probado 2026-08-11). ⇒ este python3 NO trae `ssl`. Ninguna
62# receta del corpus lo necesita para construir (meson/ninja no usan TLS), pero sí lo necesitaría
63# `pip`. Habilitarlo pide hacer thread-safe la receta de openssl, lo que mueve su hash y toca al
64# kernel: es una decisión aparte, no un olvido.
65#
66# ⚠ Y NO se pueden añadir todas: CPython construye sus módulos opcionales como `.so` COMPARTIDOS, y
67# las `.a` del corpus NO son PIC ⇒ `sqlite`/`bzip2`/`xz`/`readline`/`expat` fallan al enlazar con
68# «relocation R_X86_64_64 cannot be used against local symbol; recompile with -fPIC» (probado
69# 2026-08-11 con `_lzma`). Es la familia del `.a` no-PIC ya conocida en este repo. ⇒ este python3
70# NO trae `sqlite3`, `bz2`, `lzma` ni `readline`. Ninguna receta del corpus los necesita para
71# construir; habilitarlos pide recetas PIC de esas libs, que es un frente aparte.
72# Se declara sólo lo que arregla un fallo MEDIDO: libffi (_ctypes) y ncurses (_curses).
73build = ["zlib", "pkgconf"]
74
75[build.phases]
76configure = "./configure --prefix=/usr --without-ensurepip --disable-test-modules --with-ensurepip=no CFLAGS=\"-Wno-error=date-time\""
77compile   = "make -j\"$(nproc)\""
78# El `install` VERIFICA los módulos opcionales, no sólo copia. Es el guardián del fallo silencioso:
79# `configure` omite un módulo sin fallar, `make` termina 0 y el artefacto se sella mutilado — el
80# error aparece días después en otra receta (`ModuleNotFoundError`) y no se parece a su causa.
81# Importarlos aquí convierte eso en un fallo de build, en la receta correcta y en el momento correcto.
82# Se usa el intérprete recién instalado en /out, no el del rootfs, o no probaría nada.
83install   = '''make install DESTDIR=/out && \
84LD_LIBRARY_PATH=/out/usr/lib /out/usr/bin/python3 -c "import _ctypes, _curses, readline, sqlite3, bz2, lzma, zlib, pyexpat; print('modulos opcionales: OK')"'''