api.newsletter.com

REST API for storicard challenge, a simple newsletter app.

Contents

• Dependencies
• Configuration
• Run
• Authors

Dependencies

Configuration

Create an .env based on the .env.template:

cp .env.template .env

If you need to update any value here's the list of the environment variables definition:

Variable	Default value	Description
CELERY_BROKER_URL	redis://127.0.0.1:6379/0	Default broker URL. If running broker using docker the default value points to the newsletter_broker container at its 0 db.
CELERY_RESULT_BACKEND_URL	redis://127.0.0.1:6379/1	Default result backend URL. If running broker using docker the default value points to the newsletter_broker container at its 1 db.
DATABASE_URL	postgresql://postgres:iUFXkPr7_!nm98EY@127.0.0.1:5432/newsletter	Database to which SQLAlchemy will connect to.
FLASK_APP	manage.py	Project main module.
FLASK_DEBUG	True	If True then the flask's debug mode will be activated.
MAIL_DEBUG	True	If True, then the flask-mail debug model will be activated.
MAIL_DEFAULT_SENDER	test@email.com	Default mail sender. Use the default value if using Mailhog docker setup, otherwise change it to a real email.
MAIL_PASSWORD		Leave it blank if using Mailhog docker setup, if using gmail's SMTP server then this field should be supplied with an app password: https://support.google.com/accounts/answer/185833?hl=es
MAIL_PORT	1025	SMPT server port. Leave the default value if ussing Mailhog docker setup, otherwise change it to a real SMTP server port (587 for gmail's SMTP server for example).
MAIL_SERVER	127.0.0.1	SMTP server. Use the default value if using Mailhog docker setup, otherwise change it to a real SMTP server (smtp.gmail.com for example.)
MAIL_USERNAME		Email related to the MAIL_PASSWORD env variable. Leave it blank if using Mailhog docker setup, otherwise change it for a real email.
MAIL_USE_TLS	False	Enable TLS protocol. Change to True if using gmail's SMTP server (for example).

Run

The easiest and fastest way to run this project is through Docker, just open a terminal on the project's root and execute the following command:

docker-compose up --build -d

This command will build the following containers:

• PostgreSQL database
• Redis server (broker)
• SMTP server
• Celery worker
• Flask API

At this point you should be able to perform requests to the URL: http://0.0.0.0:8000/v1/.

By using this methods, dependencies and migrations are automatically installed and executed respectively.

Alternatives

If you would like to run the project without Docker, then:

Install project dependencies:

pipenv install

Execute migrations:

pipenv run migrate

Run Flask API and Celery worker:

pipenv run dev
pipenv run tasks

Authors

Carlos David Hernández Martínez - Davestring