Setup Debug Environment

With Docker

Starting local server

docker-compose -f docker-compose-dev.yml build
docker-compose -f docker-compose-dev.yml up -d

This shall run your local server along with nice browsable APIs at 127.0.0.1:8000

Running Unit Tests

docker-compose -f docker-compose-dev.yml exec web_monolith /bin/bash run_tests.sh

Running Migrations

This will always be required when setting up dev env for first time

docker-compose -f docker-compose-dev.yml exec web_monolith python manage.py migrate

Stop local server

Note: Your DB will presist data across container restarts

docker-compose -f docker-compose-dev.yml  down

Without Docker

Not sure, if you need to setup with docker of without? If you need to use this, you will already know why_

Start with setting virtual environment

virtualenv --python=python3 ~/.virtualenvs/django_web_template

source ~/.virtualenvs/django_web_template/bin/activate

pip install -r requirements.txt

IDE setup

Make sure you are using Python 3.6.9

python --version

Install pep8 for Python formatter

PostgreSQL setup for local DEV

sudo su - postgres

psql -p <port>

CREATE DATABASE django_web;
CREATE USER django_web_user WITH PASSWORD 'django_web_user_pwd';
ALTER ROLE django_web_user SET client_encoding TO 'utf8';
ALTER ROLE django_web_user SET default_transaction_isolation TO 'read committed';
ALTER ROLE django_web_user SET timezone TO 'UTC';
GRANT ALL PRIVILEGES ON DATABASE django_web TO django_web_user;

ALTER ROLE  django_web_user CREATEDB ; #Required only for running Unit tests locally.
\q

The DB connection string is postgres://django_web_user:django_web_user_pwd@localhost:5433/django_web

Udpdate your .env file's DATABASE_URL

Connect to DB from command line using psql -

psql -d postgres://django_web_user:django_web_user_pwd@localhost:5433/django_web

Running Tests

./run_tests.sh

Running locally

python manage.py runserver

This shall run your local server along with nice browsable APIs

mahoriR/django-dockerized-template