https://github.com/quynhnle135/secret-santa

Simple Secret Santa Matcher program coded in Python
https://github.com/quynhnle135/secret-santa

python3 secret-santa

Last synced: 7 months ago
JSON representation

Simple Secret Santa Matcher program coded in Python

• Host: GitHub
• URL: https://github.com/quynhnle135/secret-santa
• Owner: quynhnle135
• Created: 2023-12-06T03:00:47.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2023-12-24T20:55:38.000Z (almost 2 years ago)
• Last Synced: 2025-02-14T19:32:19.565Z (9 months ago)
• Topics: python3, secret-santa
• Language: Python
• Homepage:
• Size: 411 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Secret Santa Matcher

The Secret Santa Matcher is a simple, interactive program designed to randomly assign participants in a Secret Santa exchange. It offers three methods for generating pairings: using fake names for demonstration, a binary search method, and a circular assignment method for real participants:

- **Faker:** Generates fake names to demonstrate how the program works.

- **Binary Search:** Allows the input of real participants' names and applies a binary search method to match pairings.

- **Circular Assignment:** Accepts real participants' names and uses a circular assignment method to ensure everyone is matched without duplicates.

## Installation

- Clone the repository to your local machine:

```commandline

git clone https://github.com/quynhnle135/secret-santa.git

```

- Navigate to the program's directory

```commandline

cd secret-santa

```

- Run the program

```commandline

python3 main.py

```

# Screenshots

![secret_santa_1.png](screenshots%2Fsecret_santa_1.png)

![secret_santa_2.png](screenshots%2Fsecret_santa_2.png)

![secret_santa_3.png](screenshots%2Fsecret_santa_3.png)

---

Merry Christmas everyone! 🎅⛄❄️🎄🎁