This is a simple secret santa script built with Python 3.
It randomly pairs up all participants, then sends each participant an email telling them who they got paired with.
All modules used are included in the python standard library.
Python >= 3.2 is required.
- Clone the repo
git clone [email protected]:brendenwaits/secret-santa.git
- Add your email username and password to the config file for smtp
- Add all player names and emails, as well as bad pairs
- Customize the email that will be sent to all players
- To test matching, run the script like so
python secret-santa.py
- To run the script and send emails to all participants with their match
python secret-santa.py -s
Here is a list of features I am working on trying to add:
- Ability to force a match
- Integration testing script
- Determine the logistics of ensuring all matches are in big circle
- An efficient way to determine if correct matches will be possible to compute
Crazy and/or weird ideas:
- Running the script bring up an interactable prompt with numbered options
- Save or email a backup file with every pairing