Santulator vous aide à organiser votre tirage au sort Secret Santa de manière simple et flexible. Vous pouvez saisir les noms des personnes participant au tirage au sort et le système choisira au hasard qui offrira des cadeaux à qui. Si vous souhaitez éviter certaines paires, par exemple pour vous assurer que les gens n'obtiennent pas leur propre partenaire lors du tirage au sort, vous pouvez ajouter des exclusions. Lors du tirage au sort, un PDF sera généré pour chaque personne lui indiquant pour qui acheter un cadeau. Si vous souhaitez éviter de voir accidentellement tous les résultats, vous pouvez ajouter un mot de passe secret aux fichiers PDF générés.
Santulator est disponible gratuitement sur la page de téléchargement du site Web du projet. Vous pouvez trouver un tutoriel complet expliquant comment utiliser le système sur la page d'aide.
Vous aurez besoin de JDK 17. La version utilisée pour créer les versions de Santulator est OpenJDK 17 avec Hotspot, d'Adoptium.
Une fois votre JDK installé, vous pouvez ensuite cloner ce référentiel et exécuter ce qui suit pour démarrer Santulator :
./gradlew :gui:run
Vous pouvez créer l'intégralité du système avec la commande suivante :
./gradlew clean build
Par défaut, le test GUI s'exécute dans le cadre de la version standard de Gradle, en mode sans tête. Si vous souhaitez exécuter le test de l'interface graphique en mode sans interface graphique afin de voir ce qui se passe, utilisez la commande suivante :
./gradlew :gui:test --tests io.github.santulator.gui.main.GuiTest --rerun-tasks -PnoHeadless
Dans l'article Applications Java installables avec jpackage, vous pouvez découvrir comment les bundles installables pour Mac, Windows et Linux sont créés et comment vous pouvez le faire dans votre propre projet. Ces programmes d'installation autonomes permettent aux utilisateurs de configurer Santulator sur leur ordinateur sans avoir besoin d'installer Java au préalable.
Vous pouvez également trouver des instructions complètes, étape par étape, pour créer le bundle installable Santulator dans PACKAGING.md.
Sur le blog King Tech, vous pouvez en savoir plus sur le projet dans Open Source & Secret Santa avec Santulator. L'article comprend des informations sur la façon dont JavaFX CSS est utilisé pour donner à Santulator une palette de couleurs festive.