chore(ci): instalar binarios y documentar dependencias

- Añade sección en README.md con instrucciones para p7zip (7z) y chdman
- Actualiza .gitea/workflows/ci.yaml para intentar instalar p7zip-full y mame-tools/mame (continue-on-error)
- Ajusta importService para validar ruta y pasar logger desde la ruta de import
This commit is contained in:
2026-02-09 18:19:45 +01:00
parent 4298b003d9
commit 12636aefc3
9 changed files with 276 additions and 9 deletions

View File

@@ -35,3 +35,27 @@ Quasar es una aplicación web para al gestión de una biblioteca personal de vid
| Fireshare | Distribución de Juegos | Comparte clips de juegos, videos u otros medios mediante enlaces únicos. | Comparte contenido multimedia de forma sencilla. | Compartir capturas o videos de juegos con amigos. | [GitHub - Fireshare](https://github.com/fireshare/fireshare) |
| Crafty Controller | Herramientas para Minecraft | Panel de control y lanzador para servidores de Minecraft. | Gestión simplificada de servidores de Minecraft. | Administrar servidores de Minecraft de forma visual. | [GitHub - Crafty Controller](https://github.com/crafty-controller/crafty-controller) |
| Steam Headless | Herramientas para Steam | Servidor remoto de Steam sin cabeza (headless) mediante Docker. | Permite gestionar juegos de Steam en un servidor remoto. | Usuarios que quieren acceder a su biblioteca de Steam desde un servidor. | [GitHub - Steam Headless](https://github.com/steamheadless/steamheadless) |
## Dependencias nativas para tests de integración
Algunos tests de integración (p. ej. verificación de DATs, lectura de CHD/7z)
requieren herramientas nativas instaladas en el sistema donde se ejecuten
los tests (local o CI). A continuación está la lista mínima y cómo instalarlas:
- `7z` / `p7zip` — necesario para extraer/leer ZIP y 7z.
- Debian/Ubuntu: `sudo apt update && sudo apt install -y p7zip-full p7zip-rar`
- macOS (Homebrew): `brew install p7zip`
- `chdman` — herramienta de MAME para manejar archivos CHD (opcional,
requerida para tests que trabajen con imágenes CHD).
- Debian/Ubuntu: intentar `sudo apt install -y mame-tools` o `sudo apt install -y mame`.
- macOS (Homebrew): `brew install mame`
- Si no hay paquete disponible, descargar o compilar MAME/CHDTools desde
las fuentes oficiales.
Notas:
- En CI se intentará instalar estas herramientas cuando sea posible; si no
están disponibles los tests de integración que dependan de ellas pueden
configurarse para ejecutarse condicionalmente.
- La variable de entorno `INTEGRATION=1` controla si se ejecutan pruebas
más pesadas y dependientes de binarios.