Santulator te ayuda a ejecutar tu sorteo de Secret Santa de forma sencilla y flexible. Puedes introducir los nombres de las personas que participan en el sorteo y el sistema elegirá aleatoriamente quién le dará regalos a quién. Si desea evitar ciertamente los emparejamientos, por ejemplo para asegurarse de que las personas no tengan sus propios compañeros en el sorteo, puede agregar exclusiones. Cuando se realice el sorteo, se generará un PDF para cada persona indicándole a quién comprarle un regalo. Si desea evitar ver todos los resultados accidentalmente, puede agregar una contraseña secreta a los archivos PDF generados.
Santulator está disponible de forma gratuita desde la página de descargas del sitio web del proyecto. Puede encontrar un tutorial completo que explica cómo utilizar el sistema en la página de ayuda.
Necesitará JDK 17. La versión utilizada para crear versiones de Santulator es OpenJDK 17 con Hotspot, de Adoptium.
Con su JDK instalado, puede clonar este repositorio y ejecutar lo siguiente para iniciar Santulator:
./gradlew :gui:run
Puede construir todo el sistema con el siguiente comando:
./gradlew clean build
De forma predeterminada, la prueba de GUI se ejecuta como parte de la compilación estándar de Gradle, en modo sin cabeza. Si desea ejecutar la prueba de GUI en modo no autónomo para poder ver lo que está sucediendo, use el siguiente comando:
./gradlew :gui:test --tests io.github.santulator.gui.main.GuiTest --rerun-tasks -PnoHeadless
En el artículo Aplicaciones Java instalables con jpackage puedes leer sobre cómo se crean los paquetes instalables para Mac, Windows y Linux y cómo puedes hacerlo en tu propio proyecto. Estos instaladores autónomos permiten a los usuarios configurar Santulator en su computadora sin la necesidad de instalar Java primero.
También puede encontrar instrucciones completas paso a paso para crear el paquete instalable de Santulator en PACKAGING.md.
En el blog de King Tech puedes leer más sobre el proyecto en Open Source & Secret Santa con Santulator. El artículo incluye información sobre cómo se utiliza JavaFX CSS para darle a Santulator una combinación de colores festivos.