Skip to content

Latest commit

 

History

History
95 lines (65 loc) · 2.67 KB

README.md

File metadata and controls

95 lines (65 loc) · 2.67 KB
Raw

Python - Django Rest Framework boilerplate

This is boilerplate for starting fresh new DRF projects. It's built using cookiecutter-django-rest.

Highlights

  • Modern Python development with Python 3.6+
  • Bleeding edge Django 3.0+
  • Fully dockerized, local development via docker-compose.
  • MySQL
  • Full test coverage, continuous integration, and continuous deployment.
  • Celery tasks

Features built-in

  • Token-based Auth system
  • Social (FB + G+) signup/sigin
  • API Throttling enabled
  • Password reset endpoints
  • User model with profile picture field using Easy Thumbnails
  • 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 MySQL 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.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

MySQL - privileges issue

If you experience any problems with DB user privileges during migrations run query below:

GRANT ALL PRIVILEGES ON [mydb].* TO '[user]'@'localhost';

You're now ready to ROCK! ✨ 💅 🛳