Python-Django-Poetry-Starter

Requirements:

• Python (^3.12)
• Django (^5.0.6)
• Psycopg (^3.1.18)
• Uvicorn (^0.29.0)
• Gunicorn (^21.2.0)
• Django-cors-headers (^4.3.1)
• Django-rest-framework (^3.15.1)
• Pillow (^10.3.0)
• Drf-spectacular (^0.27.2)

Dev

• Mypy
• AutoPep8
• Isort
• Pytest
• Pytest-cov
• Pytest-django

Poetry workflow

More info about Poetry

1) Install poetry package manager or read official manual

pipx install poetry

2) After install all project dependencies (.env creates in project folder)

poetry install

3) Activate local env with poetry

poetry shell

4) Run your app

python manage.py runserver 8080

5) How deactivate poetry shell in terminal

exit

Docker workflow

Install docker on your local mashine. Use docker compose build for local fullstack project.

Django workflow

More info about Django

How create new django-app in project?

1) Goto root project root folder

cd src

2) Create new django-app folder (empty folder for new app)

mkdir apps/<django-app-name>

3) Create new django-app in your pre-exist apps/django-app-name

python manage.py startapp <django-app-name> ./apps/<django-app-name>

4) Create new django-app in your pre-exist app folder (using django-admin)

django-admin startapp <django-app-name> ./src/apps/<django-app-name>