Skip to content

robertjdominguez/secret-santa

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 

Repository files navigation

secret-santa

🎄 🎄 🎄 Ho-Ho-Ho! 🎄 🎄 🎄

My wife and I needed to facilitate a "Secret Santa" group. So, of course I wrote something to automate matching the pairs and notifying each person. Python script using Twilio to automate the message component. Fun and easy.

How's it work?

Everyone in the secret santa group is assigned an index in a series. When the program runs, the order is shuffled and everyone is assigned their own position - n - and an elf (the person they're giving a gift to) at the position of n+1. Finally, when the end of the list is reached, the person at this position is assigned an elf of the person in the first position. It makes more sense to think of it as a circle instead of a linear series.

Requirements

  • Friends (okay...just people?)
  • A Twilio account
  • Holiday Spirit 🎁

Running

You'll need the Python Twilio library installed. Run

pip install twilio

Then, in config.py, update your list of secret santas and their phone numbers. Finally, modify the config variables for the Twilio account in main.py -- all this information can be found on your Twilio dashboard.

accountSID = 'your_acc_id'
authToken = 'your_auth_token'
twilio_cli = Client(accountSID, authToken)
twilio_number = 'your_twilio_number'

Run python main.py and pretend you're a hard-working, objective, caring person.

About

Quick and easy method of programmatically generating and notifying everyone in a secret santa group.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages