This commit adds a new configuration setting for granian, updates dependencies for granian and typer packages, adds Docker Compose commands for deployment and container management and updates dependencies to their latest versions.

  - Added new configuration setting for granian, setting it to "*"
  - Updated versions of granian and typer packages in Dockerfile dependencies
 - Added Docker Compose commands for managing containers, building and running in detached mode, entering Bash Shell for migrations, and viewing container logs
 - Updated dependencies in requirements file to include latest versions of click, django, granian, orjson, and typer while removing older versions not needed

Author: vasudev-gm

.dockerignore

@@ -0,0 +1,36 @@
+# Generated by docker init
+# Include any files or directories that you don't want to be copied to your
+# container here (e.g., local build artifacts, temporary files, etc.).
+#
+# For more help, visit the .dockerignore file reference guide at
+# https://docs.docker.com/go/build-context-dockerignore/
+
+
+**/.DS_Store
+**/__pycache__
+**/.venv
+**/.classpath
+**/.dockerignore
+# **/.env
+**/.git
+**/.gitignore
+**/.project
+**/.settings
+**/.toolstarget
+**/.vs
+**/.vscode
+**/*.*proj.user
+**/*.dbmdl
+**/*.jfm
+**/bin
+**/charts
+**/docker-compose*
+**/compose*
+**/Dockerfile*
+**/node_modules
+**/npm-debug.log
+**/obj
+**/secrets.dev.yaml
+**/values.dev.yaml
+LICENSE
+README.md

Docker_HOWTO.md

@@ -0,0 +1,23 @@
+<!-- Generated by docker init -->
+### Building and running your application
+
+When you're ready, start your application by running:
+`docker compose up --build`.
+
+Your application will be available at http://localhost:8000.
+
+### Deploying your application to the cloud
+
+First, build your image, e.g.: `docker build -t myapp .`.
+If your cloud uses a different CPU architecture than your development
+machine (e.g., you are on a Mac M1 and your cloud provider is amd64),
+you'll want to build the image for that platform, e.g.:
+`docker build --platform=linux/amd64 -t myapp .`.
+
+Then, push it to your registry, e.g. `docker push myregistry.com/myapp`.
+
+Consult Docker's [getting started](https://docs.docker.com/go/get-started-sharing/)
+docs for more detail on building and pushing.
+
+### References
+* [Docker's Python guide](https://docs.docker.com/language/python/)

Dockerfile

@@ -0,0 +1,58 @@
+# Generated by docker init
+# syntax=docker/dockerfile:1
+
+# Comments are provided throughout this file to help you get started.
+# If you need more help, visit the Dockerfile reference guide at
+# https://docs.docker.com/go/dockerfile-reference/
+
+# Want to help us make this template better? Share your feedback here: https://forms.gle/ybq9Krt8jtBL3iCk7
+
+ARG PYTHON_VERSION=3.11
+FROM python:${PYTHON_VERSION}-slim as base
+
+# Prevents Python from writing pyc files.
+ENV PYTHONDONTWRITEBYTECODE=1
+
+# Keeps Python from buffering stdout and stderr to avoid situations where
+# the application crashes without emitting any logs due to buffering.
+ENV PYTHONUNBUFFERED=1
+
+WORKDIR /app
+
+# Create a non-privileged user that the app will run under.
+# See https://docs.docker.com/go/dockerfile-user-best-practices/
+ARG UID=10001
+RUN adduser \
+    --disabled-password \
+    --gecos "" \
+    --home "/nonexistent" \
+    --shell "/sbin/nologin" \
+    --no-create-home \
+    --uid "${UID}" \
+    appuser
+
+# Download dependencies as a separate step to take advantage of Docker's caching.
+# Leverage a cache mount to /root/.cache/pip to speed up subsequent builds.
+# Leverage a bind mount to requirements.txt to avoid having to copy them into
+# into this layer.
+RUN --mount=type=cache,target=/root/.cache/pip \
+    --mount=type=bind,source=requirement.txt,target=requirement.txt \
+    python -m pip install -r requirement.txt
+
+# Switch to the non-privileged user to run the application.
+USER appuser
+
+# Copy the source code into the container.
+COPY . .
+
+# Expose the port that the application listens on.
+EXPOSE 8000
+
+
+# Run the application.
+# For testing
+# CMD ["python", "apidemo/manage.py", "runserver", "0.0.0.0:8000"]
+# For WSGI interface
+CMD granian --interface wsgi apidemo/apidemo.wsgi:application --host 0.0.0.0 --port 8000 --workers 4 --threading-mode workers --http auto --log --log-level info
+# For ASGI interface
+# CMD granian --interface asgi apidemo/apidemo.asgi:application --host 0.0.0.0 --port 8000 --workers 4 --threading-mode workers --http auto --log --log-level info

Pipfile

@@ -18,6 +18,7 @@ python-dotenv = "*"
 sqlparse = "==0.4.4"
 typing-extensions = "==4.9.0"
 tzdata = "*"
+granian = "*"
 
 [dev-packages]
 

Pipfile.lock

@@ -1,3 +1,18 @@
 # django_ninja_tutorial
 Django Ninja with SQLite
 Basic CRUD API for Employees and Department using Django Ninja.
+Deployed using Granian
+# Docker Compose Commands
+
+### Get running containers:
+**docker ps**
+
+### Build and Run in detached mode:
+**docker compose up --build -d**
+
+### To enter Bash Shell for migrating db changes or static files
+**docker exec -it <container id from docker ps> bash**
+
+### To view logs of container. You can pass head to view first N lines or tail to view last N lines specified by argument after head/tail
+
+**docker logs --tail 1000 -f <container id from docker ps>**

README.md

@@ -0,0 +1,59 @@
+# Generated by docker init
+# Comments are provided throughout this file to help you get started.
+# If you need more help, visit the Docker Compose reference guide at
+# https://docs.docker.com/go/compose-spec-reference/
+
+# Here the instructions define your application as a service called "server".
+# This service is built from the Dockerfile in the current directory.
+# You can add other services your application may depend on here, such as a
+# database or a cache. For examples, see the Awesome Compose repository:
+# https://github.com/docker/awesome-compose
+services:
+  server:
+    build:
+      context: .
+    env_file:
+      - .env
+    ports:
+      - 8000:8000
+    healthcheck:
+      test: ["CMD", "python", "apidemo/manage.py", "check"]
+      interval: 1m30s
+      timeout: 30s
+      retries: 5
+      start_period: 30s
+
+
+# The commented out section below is an example of how to define a PostgreSQL
+# database that your application can use. `depends_on` tells Docker Compose to
+# start the database before your application. The `db-data` volume persists the
+# database data between container restarts. The `db-password` secret is used
+# to set the database password. You must create `db/password.txt` and add
+# a password of your choosing to it before running `docker compose up`.
+#     depends_on:
+#       db:
+#         condition: service_healthy
+#   db:
+#     image: postgres
+#     restart: always
+#     user: postgres
+#     secrets:
+#       - db-password
+#     volumes:
+#       - db-data:/var/lib/postgresql/data
+#     environment:
+#       - POSTGRES_DB=example
+#       - POSTGRES_PASSWORD_FILE=/run/secrets/db-password
+#     expose:
+#       - 5432
+#     healthcheck:
+#       test: [ "CMD", "pg_isready" ]
+#       interval: 10s
+#       timeout: 5s
+#       retries: 5
+# volumes:
+#   db-data:
+# secrets:
+#   db-password:
+#     file: db/password.txt
+

docker-compose.yml

@@ -1,15 +1,18 @@
 -i https://pypi.org/simple
 annotated-types==0.6.0; python_version >= '3.8'
 asgiref==3.7.2; python_version >= '3.7'
+click==8.1.7; python_version >= '3.7'
 colorama==0.4.6; python_version >= '2.7' and python_version not in '3.0, 3.1, 3.2, 3.3, 3.4, 3.5, 3.6'
-django==5.0.2; python_version >= '3.10'
+django==5.0.3; python_version >= '3.10'
 django-ninja==1.1.0; python_version >= '3.7'
-orjson==3.9.13; python_version >= '3.8'
+granian==1.1.1; python_version >= '3.8'
+orjson==3.9.15; python_version >= '3.8'
 packaging==23.2; python_version >= '3.7'
 pltable==1.1.0
 pydantic==2.5.3; python_version >= '3.7'
 pydantic-core==2.14.6; python_version >= '3.7'
 python-dotenv==1.0.1; python_version >= '3.8'
 sqlparse==0.4.4; python_version >= '3.5'
+typer==0.9.0; python_version >= '3.6'
 typing-extensions==4.9.0; python_version >= '3.8'
 tzdata==2024.1; python_version >= '2'