Santulator は、シークレット サンタの抽選を簡単かつ柔軟に実行するのに役立ちます。抽選に参加する人の名前を入力すると、誰が誰にプレゼントを贈るかシステムがランダムに選択します。たとえば、抽選で自分のパートナーを獲得しないようにするなど、確実にペアリングを避けたい場合は、除外を追加できます。抽選が行われると、誰にプレゼントを買うかを伝える PDF が各人に生成されます。誤ってすべての結果が表示されることを避けたい場合は、生成された PDF ファイルに秘密のパスワードを追加できます。
SantulatorはプロジェクトWebサイトのダウンロードページから無料で入手できます。システムの使用方法を説明する完全なチュートリアルがヘルプ ページにあります。
JDK 17 が必要です。 Santulator リリースのビルドに使用されるバージョンは、Adoptium の OpenJDK 17 with Hotspot です。
JDK がインストールされたら、このリポジトリのクローンを作成し、次のコマンドを実行して Santulator を起動できます。
./gradlew :gui:run
次のコマンドを使用してシステム全体を構築できます。
./gradlew clean build
デフォルトでは、GUI テストは標準 Gradle ビルドの一部としてヘッドレス モードで実行されます。非ヘッドレス モードで GUI テストを実行して、何が起こっているかを確認したい場合は、次のコマンドを使用します。
./gradlew :gui:test --tests io.github.santulator.gui.main.GuiTest --rerun-tasks -PnoHeadless
「jpackage を使用したインストール可能な Java アプリ」の記事では、Mac、Windows、および Linux 用のインストール可能なバンドルがどのように作成されるか、およびこれを独自のプロジェクトで行う方法について読むことができます。これらの自己完結型インストーラーを使用すると、ユーザーは最初に Java をインストールしなくても、コンピューターに Santulator をセットアップできます。
また、PACKAGING.md には、Santulator のインストール可能なバンドルを作成するための詳細な手順が記載されています。
King Tech Blog では、オープンソースと Secret Santa with Santulator のプロジェクトについて詳しく読むことができます。この記事には、JavaFX CSS を使用して Santulator にお祝いの配色を与える方法に関する情報が含まれています。