Add pre-commit including config and GitHub workflow

.github/workflows/pre-commit.yml

@@ -0,0 +1,15 @@
+name: pre-commit
+
+on:
+    pull_request:
+        branches: [main]
+
+jobs:
+    pre-commit:
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v5
+            - uses: actions/setup-python@v6
+              with:
+                  python-version: "3.12"
+            - uses: pre-commit/action@v3.0.1

.pre-commit-config.yaml

@@ -0,0 +1,25 @@
+fail_fast: false
+minimum_pre_commit_version: 4.0.0
+default_stages: [pre-commit]
+
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-added-large-files
+      - id: check-case-conflict
+      - id: check-merge-conflict
+      - id: check-json
+      - id: check-toml
+      - id: check-yaml
+      - id: detect-private-key
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: "v0.13.0"
+    hooks:
+      - id: ruff-check
+        args: [--exit-non-zero-on-fix]
+      - id: ruff-format
+        args: [--exit-non-zero-on-fix]

CONTRIBUTING.md

@@ -4,7 +4,7 @@
 
 * [Docker](https://www.docker.com/get-started)
 * [docker-compose](https://docs.docker.com/compose)
-* Python 3.8 or 3.12
+* Python 3.12.x
 * [pipx](https://pypa.github.io/pipx/) - Install Python applications in isolated environments
 * [uv](https://github.com/astral-sh/uv) - Fast Python package installer and resolver
 * tox (install via `pipx install tox`)
@@ -49,7 +49,7 @@ If instead you'd prefer to set-up your project on the host machine, you are free
 
 ### 1. Python Version
 
-If you have [`pyenv`](https://github.com/pyenv/pyenv) installed already, the [python version](.python-version) should be set automatically for you based on the `.python-version` file. However if you do not, you should make sure that Python 3.8 or 3.12 is available on your host.
+If you have [`pyenv`](https://github.com/pyenv/pyenv) installed already, the [python version](.python-version) should be set automatically for you based on the `.python-version` file. However if you do not, you should make sure that 3.12.x is available on your host.
 
 ### 2. Install uv and Setup Environment
 
@@ -122,6 +122,20 @@ To run the tests with automatic setup and teardown of services simply run:
 tox
 ```
 
+### 8. Pre-commit
+
+We use [pre-commit](https://pre-commit.com/) to automatically enforce formatting and linting. Pre-commit runs automatically on all pull requests, but it's highly recommended to install the hook locally. Installing the hook locally catches formatting and linting issues early, allowing for quick remediation before you commit.
+
+To install the pre-commit hook locally:
+
+1. Ensure your [environment is set up](#2-install-uv-and-setup-environment).
+2. From the project root, run:
+   ```bash
+   uv run pre-commit install
+   ```
+
+After installation, pre-commit will run automatically on all future commits.
+
 ## Windows Systems
 
 TODO: see [#330](https://github.com/pyslackers/website/issues/330)

pyproject.toml

@@ -2,7 +2,7 @@
 name = "pyslackersweb"
 version = "0.1.0"
 description = "The website for the pythondev.slack.com community"
-requires-python = ">=3.8"
+requires-python = ">=3.12"
 dependencies = [
     # Web Framework
     "aiohttp==3.10.11",
@@ -38,7 +38,8 @@ test = [
     "pytest-asyncio>=0.23.5",
 ]
 lint = [
-    "ruff>=0.12.11",
+    "pre-commit>=4.3.0",
+    "ruff>=0.13.0",
 ]
 typing = [
     "mypy>=1.8.0",

pyslackersweb/website/static/vendor/remixicons-2.1.0/remixicon.css

@@ -1812,4 +1812,3 @@
 .ri-zoom-in-line:before { content: "\f0e7"; }
 .ri-zoom-out-fill:before { content: "\f0e8"; }
 .ri-zoom-out-line:before { content: "\f0e9"; }
-