Add Gunicorn configuration.

Author: toddbirchard

Makefile

@@ -24,27 +24,32 @@ all help:
 
 env: $(VIRTUAL_ENV)
 
+
 $(VIRTUAL_ENV):
 	if [ ! -d $(VIRTUAL_ENV) ]; then \
 		echo "Creating Python virtual env in \`${VIRTUAL_ENV}\`"; \
 		python3 -m venv $(VIRTUAL_ENV); \
 	fi
 
+
 .PHONY: run
 run: env
 	$(LOCAL_PYTHON) -m gunicorn -w 4 wsgi:app
 
+
 .PHONY: install
 install: env
 	$(LOCAL_PYTHON) -m pip install --upgrade pip setuptools wheel && \
 	$(LOCAL_PYTHON) -m pip install -r requirements.txt && \
 	echo Installed dependencies in \`${VIRTUAL_ENV}\`;
 
+
 .PHONY: deploy
 deploy:
 	make install && \
 	make run
 
+
 .PHONY: test
 test: env
 	$(LOCAL_PYTHON) -m \
@@ -53,18 +58,21 @@ test: env
 		coverage html --title='Coverage Report' -d .reports && \
 		open .reports/index.html
 
+
 .PHONY: update
 update: env
 	$(LOCAL_PYTHON) -m pip install --upgrade pip setuptools wheel && \
 	poetry update && \
 	poetry export -f requirements.txt --output requirements.txt --without-hashes && \
 	echo Installed dependencies in \`${VIRTUAL_ENV}\`;
 
+
 .PHONY: format
 format: env
 	$(LOCAL_PYTHON) -m isort --multi-line=3 . && \
 	$(LOCAL_PYTHON) -m black .
 
+
 .PHONY: lint
 lint: env
 	$(LOCAL_PYTHON) -m flake8 . --count \
@@ -73,6 +81,7 @@ lint: env
 			--show-source \
 			--statistics
 
+
 .PHONY: clean
 clean:
 	find . -name '.coverage' -delete && \

README.md

@@ -1,7 +1,7 @@
 # Flask-SQLAlchemy Tutorial
 
 ![Python](https://img.shields.io/badge/Python-v^3.10-blue.svg?logo=python&longCache=true&logoColor=white&colorB=5e81ac&style=flat-square&colorA=4c566a)
-![Flask](https://img.shields.io/badge/Flask-v2.3.3-blue.svg?longCache=true&logo=flask&style=flat-square&logoColor=white&colorB=5e81ac&colorA=4c566a)
+![Flask](https://img.shields.io/badge/Flask-v3.0.3-blue.svg?longCache=true&logo=flask&style=flat-square&logoColor=white&colorB=5e81ac&colorA=4c566a)
 ![Flask-SQLAlchemy](https://img.shields.io/badge/Flask--SQLAlchemy-3.1.1-red.svg?longCache=true&style=flat-square&logo=flask&logoColor=white&colorA=4c566a&colorB=5e81ac)
 ![GitHub Last Commit](https://img.shields.io/github/last-commit/google/skia.svg?style=flat-square&colorA=4c566a&colorB=a3be8c)
 [![GitHub Issues](https://img.shields.io/github/issues/hackersandslackers/flask-sqlalchemy-tutorial.svg?style=flat-square&colorA=4c566a&colorB=ebcb8b&logo=Github)](https://github.com/hackersandslackers/flask-sqlalchemy-tutorial/issues)
@@ -11,7 +11,7 @@
 ![Flask-SQLAlchemy Tutorial](https://github.com/hackersandslackers/flask-sqlalchemy-tutorial/blob/master/.github/flask-sqlachemy@2x.jpg?raw=true)
 
 Connect your Flask app to a database using Flask-SQLAlchemy.
- 
+
 * **Tutorial**: [https://hackersandslackers.com/manage-database-models-with-flask-sqlalchemy/](https://hackersandslackers.com/manage-database-models-with-flask-sqlalchemy/)
 * **Demo**: [https://flasksqlalchemy.hackersandslackers.com](https://flasksqlalchemy.hackersandslackers.com)
 

config.py

@@ -1,4 +1,5 @@
 """Flask configuration variables."""
+
 from os import environ, path
 
 from dotenv import load_dotenv

flask_sqlalchemy_tutorial/__init__.py

@@ -1,4 +1,5 @@
 """Initialize Flask app."""
+
 from flask import Flask
 from flask_sqlalchemy import SQLAlchemy
 

flask_sqlalchemy_tutorial/models.py

@@ -1,4 +1,5 @@
 """Database models."""
+
 from . import db
 
 

flask_sqlalchemy_tutorial/routes.py

@@ -1,4 +1,5 @@
 """Application routes."""
+
 from datetime import datetime
 
 from flask import current_app as app

gunicorn.conf.py

@@ -0,0 +1,32 @@
+"""Gunicorn configuration file."""
+
+from os import environ, path
+
+from dotenv import load_dotenv
+
+# Read environment variables from ".env" file.
+basedir = path.abspath(path.dirname(__file__))
+load_dotenv(path.join(basedir, ".env"))
+
+# Fetch deployment environment from environment variables.
+ENVIRONMENT = environ.get("ENVIRONMENT")
+
+proc_name = "flasksession"
+wsgi_app = "wsgi:app"
+bind = "unix:flask.sock"
+threads = 4
+workers = 2
+
+if ENVIRONMENT == "development" or ENVIRONMENT is None:
+    reload = True
+    workers = 1
+    threads = 1
+    bind = ["127.0.0.1:8000"]
+elif ENVIRONMENT == "production":
+    daemon = True
+    accesslog = "/var/log/flasksession/access.log"
+    errorlog = "/var/log/flasksession/error.log"
+    loglevel = "trace"
+    dogstatsd_tags = "env:prod,service:flasksession,language:python"
+else:
+    raise ValueError(f"Unknown environment provided: `{ENVIRONMENT}`. Must be `development` or `production`.")

poetry.lock

@@ -24,7 +24,7 @@ mypy = "*"
 gunicorn = "^21.2.0"
 
 [tool.poetry.scripts]
-run = "main:app"
+run = "wsgi:app"
 
 [tool.poetry.urls]
 issues = "https://github.com/hackersandslackers/flask-sqlalchemy-tutorial/issues"
@@ -36,7 +36,9 @@ build-backend = "poetry.masonry.api"
 [tool.black]
 line-length = 120
 target-version = ['py310']
-src_paths = ["flask_sqlalchemy_tutorial", "config", "main"]
+
+[tool.isort]
+profile = "black"
 
 [tool.pylint.'MESSAGES CONTROL']
 disable = "C0103,C0301,W0703,W0621"

pyproject.toml

@@ -1,27 +1,27 @@
-black==23.9.1 ; python_version >= "3.10" and python_version < "4.0"
-blinker==1.6.2 ; python_version >= "3.10" and python_version < "4.0"
+black==24.4.0 ; python_version >= "3.10" and python_version < "4.0"
+blinker==1.7.0 ; python_version >= "3.10" and python_version < "4.0"
 click==8.1.7 ; python_version >= "3.10" and python_version < "4.0"
 colorama==0.4.6 ; python_version >= "3.10" and python_version < "4.0" and (sys_platform == "win32" or platform_system == "Windows")
-exceptiongroup==1.1.3 ; python_version >= "3.10" and python_version < "3.11"
+exceptiongroup==1.2.0 ; python_version >= "3.10" and python_version < "3.11"
 flask-sqlalchemy==3.1.1 ; python_version >= "3.10" and python_version < "4.0"
-flask==2.3.3 ; python_version >= "3.10" and python_version < "4.0"
-greenlet==2.0.2 ; python_version >= "3.10" and python_version < "4.0" and (platform_machine == "aarch64" or platform_machine == "ppc64le" or platform_machine == "x86_64" or platform_machine == "amd64" or platform_machine == "AMD64" or platform_machine == "win32" or platform_machine == "WIN32")
+flask==3.0.3 ; python_version >= "3.10" and python_version < "4.0"
+greenlet==3.0.3 ; python_version >= "3.10" and python_version < "4.0" and (platform_machine == "aarch64" or platform_machine == "ppc64le" or platform_machine == "x86_64" or platform_machine == "amd64" or platform_machine == "AMD64" or platform_machine == "win32" or platform_machine == "WIN32")
 gunicorn==21.2.0 ; python_version >= "3.10" and python_version < "4.0"
 iniconfig==2.0.0 ; python_version >= "3.10" and python_version < "4.0"
-isort==5.12.0 ; python_version >= "3.10" and python_version < "4.0"
+isort==5.13.2 ; python_version >= "3.10" and python_version < "4.0"
 itsdangerous==2.1.2 ; python_version >= "3.10" and python_version < "4.0"
-jinja2==3.1.2 ; python_version >= "3.10" and python_version < "4.0"
-markupsafe==2.1.3 ; python_version >= "3.10" and python_version < "4.0"
+jinja2==3.1.3 ; python_version >= "3.10" and python_version < "4.0"
+markupsafe==2.1.5 ; python_version >= "3.10" and python_version < "4.0"
 mypy-extensions==1.0.0 ; python_version >= "3.10" and python_version < "4.0"
-mypy==1.5.1 ; python_version >= "3.10" and python_version < "4.0"
-packaging==23.1 ; python_version >= "3.10" and python_version < "4.0"
-pathspec==0.11.2 ; python_version >= "3.10" and python_version < "4.0"
-platformdirs==3.10.0 ; python_version >= "3.10" and python_version < "4.0"
-pluggy==1.3.0 ; python_version >= "3.10" and python_version < "4.0"
+mypy==1.9.0 ; python_version >= "3.10" and python_version < "4.0"
+packaging==24.0 ; python_version >= "3.10" and python_version < "4.0"
+pathspec==0.12.1 ; python_version >= "3.10" and python_version < "4.0"
+platformdirs==4.2.0 ; python_version >= "3.10" and python_version < "4.0"
+pluggy==1.4.0 ; python_version >= "3.10" and python_version < "4.0"
 pymysql==1.1.0 ; python_version >= "3.10" and python_version < "4.0"
-pytest==7.4.2 ; python_version >= "3.10" and python_version < "4.0"
-python-dotenv==1.0.0 ; python_version >= "3.10" and python_version < "4.0"
-sqlalchemy==2.0.20 ; python_version >= "3.10" and python_version < "4.0"
+pytest==8.1.1 ; python_version >= "3.10" and python_version < "4.0"
+python-dotenv==1.0.1 ; python_version >= "3.10" and python_version < "4.0"
+sqlalchemy==2.0.29 ; python_version >= "3.10" and python_version < "4.0"
 tomli==2.0.1 ; python_version >= "3.10" and python_version < "3.11"
-typing-extensions==4.8.0 ; python_version >= "3.10" and python_version < "4.0"
-werkzeug==2.3.7 ; python_version >= "3.10" and python_version < "4.0"
+typing-extensions==4.11.0 ; python_version >= "3.10" and python_version < "4.0"
+werkzeug==3.0.2 ; python_version >= "3.10" and python_version < "4.0"