style: adding linting and formating checks

Author: Arden97

.github/workflows/lint.yml

@@ -0,0 +1,28 @@
+name: Lint (Python)
+
+on:
+  pull_request:
+    paths: ['src/**','tests/**','pyproject.toml','.ruff.toml','.github/workflows/lint.yml']
+  push:
+    branches: [ main ]
+    paths: ['src/**','tests/**','pyproject.toml','.ruff.toml','.github/workflows/lint.yml']
+
+concurrency:
+  group: lint-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+          cache: 'pip'
+      - name: Install Ruff
+        run: pip install ruff
+      - name: Ruff (lint)
+        run: ruff check . --config deploy/docker/pyproject.toml --output-format=github
+      - name: Ruff (format check)
+        run: ruff format --check . --config deploy/docker/pyproject.toml

.pre-commit-config.yaml

@@ -0,0 +1,21 @@
+exclude: |
+  (?x)^(
+    deploy/|
+    venv/|\.venv/|
+    build/|dist/
+  )
+
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.5.7            # pin to the same Ruff version you use in CI
+    hooks:
+      - id: ruff
+        args: [--fix]      # auto-fix lint issues on commit (drop if you prefer warnings only)
+      - id: ruff-format    # formatting (equivalent to: ruff format)
+
+  # Nice but optional hygiene hooks
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: end-of-file-fixer
+      - id: trailing-whitespace

deploy/docker/pyproject.toml

@@ -3,7 +3,6 @@ name = "supervisor-webui"
 version = "1.0"
 description = "SupervisorWebUI webserver"
 requires-python = ">=3.13"
-
 dependencies = [
     "psycopg2-binary>=2.9",
     "argparse",
@@ -13,3 +12,16 @@ dependencies = [
     "uvicorn[standard]>=0.27.1",
     "python-multipart"
 ]
+
+[tool.ruff]
+target-version = "py312"
+line-length = 100
+src = ["src"]
+extend-exclude = ["venv", ".venv", "build", "dist", "deploy"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM", "PL"]
+ignore = ["E203"]
+
+[tool.ruff.format]
+quote-style = "double"