A webscraping python bot that pulls data from SPU's "covid cases" site and notifies students when there are updates.

NOTICE: Project Sherlock stopped running in December 2020. If you are interested in bringing Sherlock back to life, please contact sorenrood (at) gmail (dot) com.

run python main.py

To run the bot, you'll need our creds.json file as well as an environment variable that contains credentials to send emails.

main.py -> Runs the program.

bot.py -> Contains the Bot class that manages the program as it loops through the three stages (Scrape, Validate, Communicate).

1. scraper.py -> scrapes the SPU webpage, handles server errors, formats data, and pushes result to sheets.

2. validator.py -> pulls data from sheets, determines if the scraper has picked up a new case or not and returns the decision (boolean).

3. courier.py -> pulls email list from sheets and sends each person an email notification of a new covid case at SPU.