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# ⚠ DEP DE EJECUCIÓN (2026-09-06). Este artefacto sale con `NEEDED libreadline.so.8` y hasta hoy
41# ningún artefacto del cierre publicaba ese soname: la `readline` del catálogo es `--disable-shared`.
42# En el rootfs hidratado se resolvía contra el sysroot Alpine DEL LAB — que en la máquina de
43# desarrollo está y en la distro no. Lo venía reportando `scripts/vigia-sonames.py` en los cuatro
44# perfiles. `runtime` NO entra en el ArtifactHash, así que esto NO re-hashea: cambia la CLAUSURA.
45# Las CUATRO que `python3` pide por soname y que el cierre no publicaba (lo reporta
46# `scripts/vigia-sonames.py`): readline para el REPL, y sqlite/lzma/bz2 para los módulos `sqlite3`,
47# `lzma` y `bz2` de la stdlib, que se cargan por `dlopen` y por eso no rompen el arranque sino un
48# `import` — un fallo que aparece lejos y no menciona a python.
49runtime = ["readline-shared", "sqlite-shared", "xz-shared", "bzip2-shared"]
50# `libffi` NO es opcional aunque el build no falle sin él: sin libffi el `configure` de CPython
51# construye un intérprete SIN el módulo `_ctypes`, y lo hace en SILENCIO — sella un python3 que
52# arranca perfectamente y revienta más tarde, en otra receta, con
53# `ModuleNotFoundError: No module named '_ctypes'` (destapado 2026-08-11 en gjs y en el build de
54# mozjs). **310 recetas dependen de python3**, así que el fallo no se parece a su causa ni de lejos.
55#
56# Por qué aparece AHORA: el rootfs del lab trae `libffi` (runtime) pero NO sus headers — no hay
57# `libffi-dev` en el lock. El artefacto viejo de python3 sí tenía `_ctypes` porque el rootfs de
58# entonces los traía, y el cache-hit lo mantuvo congelado hasta que el corpus se re-hasheó entero.
59# Mismo patrón que `make`/`--disable-load`: reconstruir destapa lo que la caché sostenía.
60#
61# El arreglo va en `[deps]`, NUNCA engordando el rootfs: `recipes/libffi.toml` instala los headers
62# y el `.pc`, y `pkgconf` (ya declarado) los encuentra en la capa overlay.
63#
64# NO es sólo libffi. CPython omite EN SILENCIO cada módulo opcional cuyos headers no encuentra, y el
65# rootfs del lab trae los runtime pero casi ningún `-dev` (5 de 92 paquetes). Sin esta lista salen
66# intérpretes mutilados que arrancan bien: `_curses` faltaba además de `_ctypes` (gdm, 2026-08-11).
67# El corpus tiene receta propia para todas, así que declararlas es además de-Alpinizar.
68#
69# ✅ `openssl-threads` SÍ va (2026-08-27) — y con él este python3 TRAE `ssl`.
70#
71# Antes decía acá que era imposible sin tocar la receta de openssl. Lo que faltaba era la causa real:
72# **el `no-threads` no venía de openssl, venía de `link = "static"`**. `takana-build/src/lib.rs:285`
73# inyecta `LDFLAGS=-static`, y el `Configure` de openssl (línea 1514) hace
74# `disable('static','pic','threads')` en cuanto ve `-static` en LDFLAGS. Por eso el `OPENSSL_THREADS`
75# no aparecía y CPython abortaba con «Python requires thread-safe OpenSSL».
76#
77# `recipes/openssl-threads.toml` es la MISMA receta con `link = "dynamic"` (sigue con `no-shared`,
78# o sea sigue emitiendo `.a`). Se usa una VARIANTE y no se toca `recipes/openssl.toml` porque de la
79# canónica cuelgan los CUATRO kernels (linux, linux-generic, linux-metal, linux-metal-dual) y su
80# reproducción bit a bit es un resultado cerrado: moverle el hash la invalidaría.
81#
82# ⚠ `ssl` entra además en la asserción del install de abajo. Sin eso, el día que vuelva a romperse
83# se sellaría un python3 mudo otra vez — que es exactamente cómo esto estuvo escondido meses.
84#
85# ⚠ Y NO se pueden añadir todas: CPython construye sus módulos opcionales como `.so` COMPARTIDOS, y
86# las `.a` del corpus NO son PIC ⇒ `sqlite`/`bzip2`/`xz`/`readline`/`expat` fallan al enlazar con
87# «relocation R_X86_64_64 cannot be used against local symbol; recompile with -fPIC» (probado
88# 2026-08-11 con `_lzma`). Es la familia del `.a` no-PIC ya conocida en este repo. ⇒ este python3
89# NO trae `sqlite3`, `bz2`, `lzma` ni `readline`. Ninguna receta del corpus los necesita para
90# construir; habilitarlos pide recetas PIC de esas libs, que es un frente aparte.
91# Se declara sólo lo que arregla un fallo MEDIDO: libffi (_ctypes) y ncurses (_curses).
92build = ["zlib", "pkgconf", "openssl-threads"]
93
94[build.phases]
95configure = "./configure --prefix=/usr --without-ensurepip --disable-test-modules --with-ensurepip=no CFLAGS=\"-Wno-error=date-time\""
96compile   = "make -j\"$(nproc)\""
97# El `install` VERIFICA los módulos opcionales, no sólo copia. Es el guardián del fallo silencioso:
98# `configure` omite un módulo sin fallar, `make` termina 0 y el artefacto se sella mutilado — el
99# error aparece días después en otra receta (`ModuleNotFoundError`) y no se parece a su causa.
100# Importarlos aquí convierte eso en un fallo de build, en la receta correcta y en el momento correcto.
101# Se usa el intérprete recién instalado en /out, no el del rootfs, o no probaría nada.
102install   = '''make install DESTDIR=/out && \
103LD_LIBRARY_PATH=/out/usr/lib /out/usr/bin/python3 -c "import ssl, _ctypes, _curses, readline, sqlite3, bz2, lzma, zlib, pyexpat; print('modulos opcionales: OK')"'''