Skip to content

Latest commit

 

History

History
21 lines (12 loc) · 1.12 KB

File metadata and controls

21 lines (12 loc) · 1.12 KB

PySanta

A Python module for organising secret Santa gift exchanges. No more dubious websites that spam you with constant emails!

Based off a code written by Leo Mullholland.

A Ball Python wearing a Santa hat

Image credit: Susan Frontera

Quickstart

The hardest step is to create a gmail account to send the emails from. I recommend making a dummy account instead of using your personal email. You need to make sure 2 factor Authentication is enabled. Then create an app password, this will be the password you use in the script NOT the actual password of the gmail account.

To run the code, you'll first need to create a comma seperated variable .csv file. It should be formatted like example.csv in this repository. It's easy to create one of these from the results of a google/microsoft form.

Then simply run the script with the path to the file, e.g:

python pysanta.py -f /PATH/TO/PARTICIPANTS.csv