A modern opinionated project generator for django

Built with cookiecutter

Opinionated means:

• Using poetry to manage dependencies

• Using django-configurations to setup a class based, different environments in settings, most configurations defined with environment variables

• Postgresql as a default db

• Gunicorn for production serving

• Django's goodies including:

  • django-storages for storage backends.
  • django-extensions.
  • django-import-export plugin for the admin

• Cors middleware and querycount middleware, timezone middleware

• Django rest framework for api

• My very own: poor man's service locator, helping to provide abstraction

• Deployable: Built in aws codebuild, Working dockerfile, nginx to serve static files, aws boto for s3 integration

• health check endpoint

• Ready with initial ci for github actions or codebuild aws ci

Easy local development for frontend users

Ability to run this whole project with

docker-compose up --build

Expected configuration:

• project_name in underscore format
• git_repo link

Prerequisite

1. Pipx - The recommended way to install and run cookiecutter - Install Pipx instructions

2. Cookiecutter - Install cookiecutter with pipx Documentation

   pipx install cookiecutter

How to work with this

1. Install the prerequisites
2. Run cookiecutter with this template

   pipx run cookiecutter https://github.com/alonisser/django-poetry-opinionated-cookiecutter