README.md

Secret Santa

Takes a list of names and mobile numbers to sms everybody their secret Santa.

Requirements

• python 3
• AWS Account

Setup

install boto3

pip install --user boto3

create the list of people

cp people.json.example people.json

open people.json in your favourite text editor and add the people with their mobile phone numbers

[
  {
    "name": "John",
    "number": "+61400000000"
  },
  {
    "name": "Sally",
    "number": "+61411111111"
  }
]

Generate the list

run

python generator.py

Generates .secret_santa.json file with the matches

[
  {
    "santa": "John",
    "reciever": "Sally",
    "number": "+61400000000"
  },
  {
    "santa": "Sally",
    "reciever": "John",
    "number": "+61411111111"
  }
]

Notify

To SMS people their secret Santa

run

python sms.py

to resend a individual person

python sms.py Sally

Retrieve

To retrieve a specific secret Santa

run

python whois.py Sally
-> John