This is an API for tracking social media profiles.

Highlights

• Modern Python development with Python 3.8+
• Bleeding edge Django 3.1+
• Fully dockerized, local development via docker-compose.
• PostgreSQL
• Full test coverage, continuous integration, and continuous deployment.
• Celery tasks
• Images stored via Amazon S3

Features built-in

• JSON Web Token authentication using Simple JWT
• Sentry setup
• Swagger API docs out-of-the-box
• CodeLinter (flake8) and CodeFormatter (yapf)
• Tests (with mocking and factories) with code-coverage support

API Docs

API documentation is automatically generated using Swagger. You can view documention by visiting this link.

Prerequisites

If you are familiar with Docker, then you just need Docker. If you don't want to use Docker, then you just need Python3 and Postgres installed.

Local Development with Docker

Start the dev server for local development:

cp .env.dist .env
docker-compose up

Run a command inside the docker container:

docker-compose run --rm web [command]

Local Development without Docker

Install

python3 -m venv env && source env/bin/activate                # activate venv
cp .env.dist .env                                             # create .env file and fill-in DB info
pip install -r requirements/dev.txt                           # install py requirements
./manage.py migrate                                           # run migrations
./manage.py collectstatic --noinput                           # collect static files
redis-server                                                  # run redis locally for celery
celery -A src.config worker --beat --loglevel=debug
  --pidfile="./celerybeat.pid"
  --scheduler django_celery_beat.schedulers:DatabaseScheduler # run celery beat and worker

Run dev server

This will run server on http://localhost:8000

./manage.py runserver

Create superuser

If you want, you can create initial super-user with next commad:

./manage.py createsuperuser

Running Tests

To run all tests with code-coverate report, simple run:

./manage.py test

You're now ready to ROCK! ✨ 💅 🛳