Resumen/xpm — gestor de paquetes

xpm — Uso

Referencia de uso completa del binario xpm, basada en crates/xpm/src/cli.rs, crates/xpm/src/main.rs y el README del proyecto.

Flags globales

Estas flags las acepta cualquier subcomando.

La CLI está definida con clap y exige un subcomando (arg_required_else_help = true).

Comandos

sync — Sincronizar bases de datos de paquetes

Alias: Sy. Descarga los archivos de base de datos .db (y .files best-effort) más recientes de cada repositorio configurado y los parsea en bases de datos de sync locales.

xpm sync [OPTIONS]
xpm Sy [OPTIONS]

Nota de implementación: cmd_sync en main.rs lanza workers de sync por repositorio en chunks paralelos, prueba cada mirror configurado con reintentos, informa qué mirror respondió y luego parsea los .db / .files descargados para poder mostrar el recuento local de paquetes. Los fallos de sync remoto se avisan sin abortar toda la ejecución.

install — Instalar paquetes

Alias: S. Instala uno o más paquetes por nombre desde las bases de datos sincronizadas.

xpm install <PACKAGES>... [OPTIONS]
xpm S <PACKAGES>... [OPTIONS]

Comportamiento (de main.rs): se cargan todas las bases sincronizadas configuradas y los requisitos pedidos (nombre o nombre=versión) se resuelven con el solver SAT, que elige candidatos, respeta depends/conflicts y los provides sin versión, y devuelve el cierre en orden de dependencias. Cada paquete se descarga al directorio de caché, se comprueba contra un .sig remoto según el sig_level efectivo y contra el sha256sum cuando la entrada lo incluye, y luego se commitea como operaciones de instalación sobre un Transaction (los pedidos quedan explícitos; las dependencias arrastradas, como deps; --as-deps/--as-explicit lo sobrescriben). Con --download-only la ejecución se detiene tras descargar. En caso contrario xpm pide confirmación (salvo --no-confirm) y la transacción extrae los archivos y registra cada paquete en la base de datos local.

remove — Eliminar paquetes

Alias: R. Elimina paquetes instalados usando el manifest de archivos registrado en la base de datos local.

xpm remove <PACKAGES>... [OPTIONS]
xpm R <PACKAGES>... [OPTIONS]

El paquete debe estar registrado en la base de datos local (si no, xpm informa de que no está instalado). Se pide confirmación salvo --no-confirm.

upgrade — Actualización del sistema

Alias: Su. Actualiza todos los paquetes instalados a las versiones más recientes disponibles.

xpm upgrade [OPTIONS]
xpm Su [OPTIONS]

upgrade refresca siempre primero las bases de datos (equivalente a pacman -Syu) y luego resuelve el cierre transitivo de los paquetes con versión más nueva, de modo que las dependencias nuevas o que ahora se requieren se instalan en la misma pasada. Los paquetes actualizados conservan su razón de instalación; las dependencias arrastradas se registran como deps. Sin paquetes instalados informa de que no hay nada que hacer.

query — Consultar la base de datos local

Alias: Q. Lista los paquetes instalados desde la base de datos local.

xpm query [FILTER] [OPTIONS]
xpm Q [FILTER] [OPTIONS]

Nota de implementación: implementado contra las bases local y sync (filtro por nombre más --explicit, --deps y --upgrades). --orphans lista paquetes de dependencia que ningún paquete explícito requiere, usando las aristas depends/provides registradas al instalar; las entradas legacy sin registro se omiten.

search — Buscar paquetes

Alias: Ss. Busca paquetes por nombre, descripción o provides.

xpm search <QUERY> [OPTIONS]
xpm Ss <QUERY> [OPTIONS]

Nota de implementación: implementado como match case-insensitive sobre nombre, descripción y provides; --local matchea nombres de paquetes instalados.

info — Información de paquete

Alias: Si. Muestra información detallada de un paquete.

xpm info <PACKAGE> [OPTIONS]
xpm Si <PACKAGE> [OPTIONS]

Nota de implementación: implementado; combina la entrada instalada con la entrada sync de mayor prioridad, y --local limita la salida a la base instalada.

files — Listar archivos de un paquete

Alias: Ql. Lista todos los archivos que pertenecen a un paquete instalado.

xpm files <PACKAGE>
xpm Ql <PACKAGE>

Nota de implementación: implementado; lee el manifiesto files registrado al instalar (vacío para instalaciones legacy).

history, rollback, diff — Journal y generaciones

• xpm history [--json] — transacciones registradas, la más nueva primero. Las terminadas enlazan la generación que produjeron (gen:NNNN, si el directorio de estado es legible).
• xpm rollback [--last | --journal <ID>] [--dry-run] — reaplica la inversa de una transacción exitosa usando la caché de paquetes; aborta antes de tocar nada si falta un paquete viejo.
• xpm diff <GENERATION> [--json] — compara los paquetes instalados contra el packages.tsv de una generación (current resuelve el id por defecto).

Los archivos de configuración declarados con backup en .PKGINFO siguen la semántica de pacman: .pacnew al instalar/actualizar y .pacsave al eliminar (se desactiva con --nosave). Los hooks estilo pacman de /usr/share/libalpm/hooks y /etc/pacman.d/hooks corren alrededor de cada transacción.

repo — Gestión de repositorios

Gestiona los repositorios añadidos por el usuario (temporales). Los predefinidos vienen de /etc/xpm.conf; los añadidos por el usuario se guardan como archivos TOML bajo /etc/xpm.d/.

xpm repo list                 # repositorios predefinidos + añadidos por el usuario
xpm repo add <NAME> <URL>     # añade un repositorio temporal
xpm repo remove <NAME>        # elimina un repositorio añadido por el usuario

Ejemplos (del help integrado):

xpm repo add chaotic-aur https://cdn-mirror.chaotic.cx/$repo/$arch
xpm repo add my-repo https://username.github.io/my-repo/$arch
xpm repo add local file:///srv/packages/$arch

repo add se niega a sobrescribir una entrada existente del mismo nombre. Tras añadir un repositorio, ejecuta xpm sync para traer su base de datos.

usage — Ayuda integrada

Muestra ayuda de uso detallada para toda la herramienta o para un tema/comando.

xpm usage                    # visión general
xpm usage commands           # lista todos los comandos
xpm usage config             # formato del archivo de configuración
xpm usage repos              # gestión de repositorios
xpm usage <command>          # ayuda de un comando concreto (sync, install, remove, upgrade, ...)

xpm <command> --help también funciona vía clap.

Aliases estilo pacman

Flujo de trabajo típico

xpm sync                       # refresca las bases de datos de paquetes
xpm install <package>          # instala un paquete
xpm upgrade                    # actualiza los paquetes instalados (hace sync primero)
xpm query                      # lista los paquetes instalados
xpm remove <package>           # elimina un paquete

El uso no interactivo (scripts) necesita --no-confirm. Para experimentos aislados/sin root usa --config, --root, --dbpath y --cachedir apuntando a directorios temporales; cuando la raíz de instalación no es /, xpm activa la integración de shell y crea shims de comandos en ~/.local/bin (con líneas de export de PATH en ~/.bashrc y ~/.zshrc).

Variables de entorno y códigos de salida

RUST_LOG se respeta a través del EnvFilter de tracing-subscriber para controlar la verbosidad de los logs. docs/CLI.md documenta además XPM_CONFIG, XPM_CACHE_DIR, XPM_HOOKS_DIR, XPM_ALPM_HOOKS_DIRS, X_GEN_STATE y NO_COLOR.

docs/CLI.md documenta una matriz de códigos de salida (0 éxito, 1 error general, 2 error de uso, hasta 7 base de datos bloqueada). Nota: esa matriz es intención documentada más que un contrato impuesto en el código actual; en la práctica clap reporta errores de uso, anyhow reporta fallos en runtime y el resto de códigos documentados aún no los emite main.rs. Verifícalo contra el código antes de depender de un código concreto.

Referencias

• Referencia CLI existente: ../CLI.md
• Objetivos de fetch y layout de mirrors: ../FETCH_TARGETS.md
• Guía rápida de install/upgrade: ../INSTALL_AND_UPGRADE.md
• Configuración de ejemplo: ../../etc/xpm.conf.example
• Definición de comandos: ../../crates/xpm/src/cli.rs, despacho: ../../crates/xpm/src/main.rs

Editar esta página en GitHub