Sends you a customized email every morning, with information of interest, such as the upcoming weather forecast for your zip code.
Fork this repo, then clone or download the forked repo onto your local computer (for example to the Desktop), then navigate there from the command-line:
cd ~/Desktop/daily-briefings-py/
Use Anaconda to create and activate a new virtual environment, perhaps called "briefings-env":
conda create -n briefings-env python=3.8
conda activate briefings-env
Then, within an active virtual environment, install package dependencies:
pip install -r requirements.txt
Follow these SendGrid setup instructions to sign up for a SendGrid account, configure your account's email address (i.e. SENDER_EMAIL_ADDRESS
), and obtain an API key (i.e. SENDGRID_API_KEY
).
Create a new file called ".env" in the root directory of this repo, and paste the following contents inside, using your own values as appropriate:
# these are example contents for the ".env" file:
# required vars:
SENDGRID_API_KEY="_______________"
SENDER_EMAIL_ADDRESS="_______________"
# optional vars:
#APP_ENV="development"
#COUNTRY_CODE="US"
#ZIP_CODE="10017"
#USER_NAME="Jon Snow"
Printing today's weather forecast (to test the Weather.gov API):
python -m app.weather_service
# in production mode:
APP_ENV="production" COUNTRY_CODE="US" ZIP_CODE="20057" python -m app.weather_service
Sending an example email (to test the SendGrid service):
python -m app.email_service
NOTE: the SendGrid emails might first start showing up in spam, until you designate them as coming from a trusted source (i.e. "Looks Safe")
Sending the weather forecast in an email:
python -m app.daily_briefing
# in production mode:
APP_ENV="production" COUNTRY_CODE="US" ZIP_CODE="20057" python -m app.daily_briefing
# mac:
FLASK_APP=web_app flask run
# windows:
export FLASK_APP=web_app
flask run
Running tests:
pytest
# in CI mode:
CI=true pytest
Follow the deployment instructions to deploy the app to a remote server and schedule the server to send you the weather forecast email every day.