Resumen/xpkg — builder de paquetes

xpkg - Resumen y estado

Este es uno de los cuatro documentos que describen xpkg, el constructor de paquetes en Rust de la distribución X. Cubre qué es la herramienta, su rol en el ecosistema X y su estado honesto dentro de la iniciativa reboot de xlnux.

Documentos relacionados en esta carpeta:

• 02 - Uso
• 03 - Arquitectura
• 04 - Integración futura

Qué es xpkg

xpkg es el constructor de paquetes de la distribución X. Lee recetas de construcción (ficheros XBUILD o PKGBUILD heredados), obtiene fuentes, compila software en un entorno aislado y produce paquetes .xp listos para instalar con xpm. Es el compañero de desarrollo de xpm.

Piensa en él como el equivalente a makepkg + repo-add + namcap para el ecosistema X, escrito íntegramente en Rust.

Metadatos del proyecto: versión 0.1.0, edition 2021, licencia GPL-3.0-or-later, organización xlnux, repositorio https://github.com/xlnux/xpkg.

Relación con xpm

xpkg produce paquetes .xp que instala xpm. Ambos comparten el mismo formato de paquete y las mismas estructuras de metadatos, pero son binarios independientes.

Estado dentro del reboot de xlnux

La iniciativa reboot de xlnux (ver ROADMAP.md y DECISIONS.md en la raíz del workspace, fuera de este repo) reorganizó la organización y marcó una nueva dirección para la distribución. Su estatus para el tooling Rust es:

• La fase "Fase 4 - Tooling Rust (xpm/xpkg)" del roadmap del workspace está POSPUESTA. Por decisión del mantenedor, xpm/xpkg no se trabajan durante el reboot; el tooling se retoma solo cuando vuelva a necesitarse el stack Rust (resolver SAT, repositorio .xp).
• El empaquetado del payload de la distribución durante el reboot se hace con PKGBUILD + makepkg (paquete x-scripts), publicado en el repositorio binario x-repo. El reboot flow no usa xpkg actualmente.
• La decisión ADR-0004 registra que xpkg/xpm siguen siendo la base prevista de empaquetado y gestión de paquetes de la distribución, con una condición previa: el resolver SAT de xpm debe conectarse a install y deben funcionar las instalaciones locales de ficheros .xp antes de depender de xpm para el bootstrap del sistema.

En resumen: xpkg está en estado REBOOT PENDING. El código es funcional y se mantiene como futuro constructor de paquetes, pero está des-priorizado por ahora y no participa en el flujo de entrega actual del reboot.

Madurez del código

El ROADMAP.md propio del repositorio informa de:

• Sección "Current Status": fases 0-3 completas - workspace de Cargo montado, CLI con 8 subcomandos, parser de configuración TOML, parsers XBUILD/PKGBUILD, validación de recetas, generador de srcinfo, xpkg new, descargador HTTP con reintentos, verificación de checksums SHA-256/512, extracción de archivos (tar.gz/xz/bz2/zst, zip), soporte de clonado Git y caché de fuentes, con 72 tests unitarios pasando.
• Las listas de fases del mismo fichero marcan las fases posteriores (motor de build, generación de metadatos, creación de archivos, linting de paquetes, gestión de repositorios, comandos verify/info) como completas, quedando dos ítems abiertos en la Fase 9: tests de integración con xpm y benchmarks comparativos frente a makepkg. La Fase 10 (objetivos futuros post-v1.0) está íntegramente abierta.
• docs/realexample.md registra una ejecución real de punta a punta: se construyó un paquete xfetch a .xp con xpkg, se inspeccionó, se hizo lint, se añadió a una base de datos ALPM local y a un layout de repositorio file:// bajo x-repo, y xpm lo sincronizó.

Convención de versiones

El Cargo.toml del workspace declara actualmente la versión 0.1.0 para ambos crates.

Editar esta página en GitHub