Merge branch 'main' into upgrade-poetry

Author: theskumar

.gitignore

@@ -83,3 +83,7 @@ Session.vim
 
 # Pycharm project modules
 .idea/
+
+
+### VSCode
+.vscode/

HISTORY.md

@@ -2,13 +2,74 @@ History
 ----------------------
 <small>Note: This file is autogenerated with [generate-history.sh](generate-history.sh)</small>
 
-### 2022-01-05
+### 2023-12-20
+ - feat(fly-io): Added fly.io template files (#475) ([John Taylor])
 
-- Integrate poetry and update makefile commands. ([Sanyam Khurana])
-- Move isort/black config from .editorconfig to .pyproject.toml. ([Sanyam Khurana])
+### 2023-11-27
+ - feat(async): add uvicorn, asgi, upgrade django=4.1 (#473) ([Suneet Choudhary])
 
-### 2022-01-11
-- Fix the use of letsencrypt tasks to run only on hosts configured with `use_letsencrypt`. ([Sanyam Khurana])
+### 2023-04-18
+ - fix(docker): Fixed an issue with the Postgres Docker image name (#474) ([John Taylor])
+
+### 2023-03-28
+ - feat: add GraphQL API implementation using django-graphene (#449) ([Suneet Choudhary])
+
+### 2023-03-03
+ - fix(docker-start): Redirect access/error logs to std-out (#470) ([Sanyam Khurana])
+
+### 2023-02-27
+ - fix(Makefile): Update poetry export command to use --with option (#468) ([Sanyam Khurana])
+
+### 2023-02-06
+ - fix(compose): Use postgis protocol for connection (#467) ([Sanyam Khurana])
+
+### 2023-01-06
+ - feat(docker): Use GDAL/postgis when postgis is enabled (#464) ([Sanyam Khurana])
+
+### 2022-12-15
+ - Configure Renovate (#459) ([renovate[bot]])
+
+### 2022-12-07
+ - fix(users/api): Make code conformant to PEP8 ([Sanyam Khurana])
+ - chore: Add docker-compose to run all services through docker (#440) ([Sanyam Khurana])
+
+### 2022-10-27
+ - fix(pyproject.toml): Add dependencies for mkdocs (#458) ([Sanyam Khurana])
+
+### 2022-10-25
+ - docs(README): Update docs to drop legacy poetry command (#457) ([Sanyam Khurana])
+ - fix(github-actions): Use poetry to install requirements & run tests (#456) ([Sanyam Khurana])
+
+### 2022-09-27
+ - docs(coding_rules): correct class names to be PascalCase (#455) ([Sanyam Khurana])
+
+### 2022-09-16
+ - ci(github-actions): ensure poetry is installed lint action (#453) ([Sanyam Khurana])
+
+### 2022-09-14
+ - chore: make the relative and absolute imports consistent (#450) ([Sahith Chandan Mekala])
+ - upgrade packages (#451) ([Sahith Chandan Mekala])
+
+### 2022-06-18
+ - upgrade(requirements): black 21.12b0 => 22.3.0 (#447) ([Akash Mishra])
+
+### 2022-02-16
+ - feat(setup): Add dependency management with poetry (#444) ([Sanyam Khurana])
+
+### 2022-01-17
+ - chore: update packages - celery, ansible (#445) ([Suneet Choudhary])
+
+### 2022-01-13
+ - fix(nginx/tasks): Run letsencrypt only for hosts with use_letsencrypt config (#446) ([Sanyam Khurana])
+
+### 2022-01-04
+ - Fix(API-docs): deprecated rest_framework_swagger (#441) ([Suneet Choudhary])
+
+### 2021-12-17
+ - feat: update python dependencies (#443) ([Saurabh Kumar])
+
+### 2021-12-14
+ - chore(CI): add python cache with pip ([Saurabh Kumar])
 
 ### 2021-12-07
  - chore: Update django-sites to 0.11 for Django 3.x (#442) ([Sanyam Khurana])

README.md

@@ -12,7 +12,7 @@
 
 ## Features
 
-- Django 3.2.x
+- Django 4.1.x
 - Python 3.9.x
 - [Poetry][poetry] Support
 - Support for [black](https://pypi.org/project/black/)!
@@ -29,13 +29,15 @@
 
 ### Optional
 - Heroku Setup
+- Fly Setup
 - Ubuntu 20 LTS via [Ansible]
 - Celery with flower integration.
 - AWS S3 media storage
 - [Letsencrypt](https://letsencrypt.org/) Support via [certbot](https://certbot.eff.org).
 - Postgis Setup
 - Newrelic
 - Sentry
+- [GraphQL](https://graphql.org/) support via [Graphene-Django](https://docs.graphene-python.org/projects/django/en/latest/) (Optional)
 - pre-commit hooks
 
 

cookiecutter-test-config.yaml

@@ -0,0 +1,5 @@
+default_context:
+    enable_whitenoise: "y"
+    add_celery: "y"
+    add_graphql: "y"
+    add_asgi: "y"

cookiecutter.json

@@ -10,6 +10,7 @@
     , "add_newrelic" : "y"
     , "add_postgis": "n"
     , "add_heroku": "n"
+    , "add_fly": "n"
     , "enable_whitenoise": "n"
     , "add_ansible": "y"
     , "letsencrypt": "y"
@@ -18,6 +19,8 @@
     , "add_sentry": "y"
     , "add_django_auth_wall": "y"
     , "add_celery": "n"
+    , "add_graphql": "n"
+    , "add_asgi": "n"
     , "add_pre_commit": "y"
     , "add_docker": "y"
     , "pagination": ["LimitOffsetPagination", "CursorPagination"]

hooks/post_gen_project.sh

@@ -29,6 +29,11 @@ if echo "{{ cookiecutter.add_heroku }}" | grep -iq "^n"; then
     rm -rf uwsgi.ini Procfile bin/post_compile
 fi
 
+if echo "{{ cookiecutter.add_fly }}" | grep -iq "^n"; then
+    rm .github/workflows/fly.yml
+    rm -rf compose/fly
+fi
+
 if echo "{{ cookiecutter.add_ansible }}" | grep -iq "^n"; then
     rm -rf provisioner ansible.cfg
 fi
@@ -45,6 +50,18 @@ if echo "{{ cookiecutter.add_docker }}" | grep -iq "^n"; then
     rm -rf .envs compose local.yml dev.yml docs/backend/docker_setup.md
 fi
 
+if echo "{{ cookiecutter.add_graphql }}" | grep -iq "^n"; then
+    rm -rf {{ cookiecutter.main_module }}/graphql
+    rm -rm {{ cookiecutter.main_module }}/docs/graphql
+    rm -rf tests/graphql
+fi
+
+if echo "{{ cookiecutter.add_asgi }}" | grep -iq "^n"; then
+    rm -rf asgi.py
+else
+    rm -rf wsgi.py
+fi
+
 if echo "$yn" | grep -iq "^y"; then
     echo "==> Checking system dependencies. You may need to enter your sudo password."
 

run_test.sh

@@ -19,7 +19,7 @@ fi
 rm -rf hello-world-backend/;
 
 # Generate new code, (it also creates db, migrate and install dependencies)
-yes 'y' | cookiecutter . --no-input
+yes 'y' | cookiecutter . --no-input --config-file cookiecutter-test-config.yaml
 
 # Run the tests present inside generate project
 cd hello-world-backend;

{{cookiecutter.github_repository}}/.env.sample

@@ -28,7 +28,7 @@
 # DJANGO_AWS_S3_HOST=''
 # DJANGO_AWS_S3_REGION_NAME=''
 
-# Django Rest Framework
+# APIs
 # ==============================
 # API_DEBUG=False
 

{{cookiecutter.github_repository}}/.github/workflows/fly.yml

@@ -0,0 +1,15 @@
+name: Fly Deploy
+on:
+  push:
+    branches:
+      - master
+jobs:
+  deploy:
+    name: Deploy app
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: superfly/flyctl-actions/setup-flyctl@master
+      - run: flyctl deploy --dockerfile ./compose/fly/django/Dockerfile
+        env:
+          FLY_API_TOKEN: ${{ "{{" }} secrets.FLY_API_TOKEN {{ "}}" }}

{{cookiecutter.github_repository}}/README.md

@@ -1,15 +1,14 @@
-{{ cookiecutter.project_name }}
-==============================
+# {{ cookiecutter.project_name }}
 
-__Version:__ {{ cookiecutter.version }}
+**Version:** {{ cookiecutter.version }}
 
 {{ cookiecutter.project_description }}
 
 ## Getting up and running
 
 {% if cookiecutter.add_docker == 'y' %}
 !!! note
-    For setting up locally using `Docker`, check [here](docs/backend/docker_setup.md)
+For setting up locally using `Docker`, check [here](docs/backend/docker_setup.md)
 {% endif %}
 
 Minimum requirements: **pip, python3.9, poetry, redis & [PostgreSQL 11][install-postgres]{% if cookiecutter.add_postgis.lower() == "y" %} with postgis-2.4{% endif %}**, setup is tested on Mac OSX only.
@@ -43,7 +42,7 @@ Running `poetry lock` generates `poetry.lock` which has all versions pinned.
 
 You can install Poetry by using `pip install --pre poetry` or by following the official installation guide [here](https://github.com/python-poetry/poetry#installation).
 
-*Tip:* We recommend that you use this workflow and keep `pyproject.toml` as well as `poetry.lock` under version control to make sure all computers and environments run exactly the same code.
+_Tip:_ We recommend that you use this workflow and keep `pyproject.toml` as well as `poetry.lock` under version control to make sure all computers and environments run exactly the same code.
 
 
 ## Deploying Project
@@ -52,6 +51,32 @@ The deployment are managed via travis, but for the first time you'll need to set
 
 Check out detailed server setup instruction [here](docs/backend/server_config.md).
 
+{% if cookiecutter.add_fly == 'y' %}
+
+### Develop on Fly.io
+
+Create a [fly.io](https://fly.io) account.
+
+Install `flyctl` and run the following commands to set up the Fly.io application, it will ask a series of questions regarding deployment configuration.
+
+```
+brew install flyctl
+fly lauch
+```
+
+When ready to deploy, simply run the command using the Fly Dockerfile:
+
+```
+flyctl deploy --dockerfile ./compose/fly/django/Dockerfile
+```
+
+There is also a Github Action provided `.github/workflows/fly.yml` to deploy the application on the `master` branch. In order to deploy from CI:
+
+1. Create Fly Access Token [here](https://fly.io/user/personal_access_tokens).
+2. Add the `FLY_API_TOKEN` to the Github repo secrets [here](https://github.com/{{cookiecutter.github_username}}/{{cookiecutter.github_repository}}/settings/secrets/actions)
+
+{% endif %}
+
 ## How to release {{ cookiecutter.project_name }}
 
 Execute the following commands: