Santulator membantu Anda menjalankan undian Rahasia Santa dengan sederhana dan fleksibel. Anda dapat memasukkan nama orang yang berpartisipasi dalam pengundian dan sistem akan memilih secara acak siapa yang akan memberikan hadiah kepada siapa. Jika Anda ingin menghindari pasangan tertentu, misalnya untuk memastikan bahwa orang tidak mendapatkan pasangannya sendiri dalam undian, Anda dapat menambahkan pengecualian. Saat pengundian dijalankan, PDF akan dibuat untuk setiap orang yang memberi tahu mereka untuk siapa membeli hadiah. Jika Anda ingin menghindari melihat semua hasilnya secara tidak sengaja, Anda dapat menambahkan kata sandi rahasia ke file PDF yang dihasilkan.
Santulator tersedia secara gratis dari halaman unduh situs proyek. Anda dapat menemukan tutorial lengkap yang menjelaskan cara menggunakan sistem di halaman bantuan.
Anda memerlukan JDK 17. Versi yang digunakan untuk membuat rilis Santulator adalah OpenJDK 17 dengan Hotspot, dari Adoptium.
Dengan JDK terinstal, Anda kemudian dapat mengkloning repositori ini dan menjalankan perintah berikut untuk memulai Santulator:
./gradlew :gui:run
Anda dapat membangun keseluruhan sistem dengan perintah berikut:
./gradlew clean build
Secara default, pengujian GUI dijalankan sebagai bagian dari build Gradle standar, dalam mode tanpa kepala. Jika Anda ingin menjalankan pengujian GUI dalam mode non-headless sehingga Anda dapat melihat apa yang terjadi, gunakan perintah berikut:
./gradlew :gui:test --tests io.github.santulator.gui.main.GuiTest --rerun-tasks -PnoHeadless
Dalam artikel Aplikasi Java yang Dapat Diinstal dengan jpackage Anda dapat membaca tentang bagaimana bundel yang dapat diinstal untuk Mac, Windows dan Linux dibuat dan bagaimana Anda dapat melakukannya di proyek Anda sendiri. Penginstal mandiri ini memungkinkan pengguna untuk mengatur Santulator di komputer mereka tanpa perlu menginstal Java terlebih dahulu.
Anda juga dapat menemukan petunjuk lengkap langkah demi langkah untuk membuat bundel Santulator yang dapat diinstal di PACKAGING.md.
Di Blog King Tech Anda dapat membaca lebih lanjut tentang proyek di Open Source & Secret Santa dengan Santulator. Artikel ini berisi informasi tentang bagaimana JavaFX CSS digunakan untuk memberi Santulator skema warna yang meriah.