This is boilerplate for starting fresh new DRF projects. It's built using cookiecutter-django-rest.
- 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
- JSON Web Token authentication using Simple JWT
- Social (FB + G+) signup/sigin
- API Throttling enabled
- Password reset endpoints
- User model with profile picture field using Easy Thumbnails
- Files management (thumbnails generated automatically for images)
- Sentry setup
- Swagger API docs out-of-the-box
- Code formatter black
- Tests (with mocking and factories) with code-coverage support
API documentation is automatically generated using Swagger. You can view documention by visiting this link.
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.
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]
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
This will run server on http://localhost:8000
./manage.py runserver
If you want, you can create initial super-user with next commad:
./manage.py createsuperuser
To run all tests with code-coverate report, simple run:
./manage.py test
You're now ready to ROCK! ✨ 💅 🛳