Switch Python linting and formatting to Ruff

.github/workflows/release-packages.yml

@@ -31,12 +31,10 @@ jobs:
         run: python -m pip install --upgrade uv
       - name: Install dependencies with uv
         run: uv pip install --system --editable . --group dev
-      - name: Lint with flake8
-        run: |
-          flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
-          flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
-      - name: Lint with ruff
-        run: ruff check --exit-zero .
+      - name: Check formatting with Ruff
+        run: uv run ruff format --check .
+      - name: Lint with Ruff
+        run: uv run ruff check .
       - name: Test with pytest
         run: |
           pytest

.pre-commit-config.yaml

@@ -2,40 +2,21 @@ minimum_pre_commit_version: "3.6.0"
 # All hooks must be local to allow offline usage
 
 # ─── PYTHON ────────────────────────────────────────────────────────────────────
-# NOTE: hooks run in the order they appear – isort before black is critical.
+# NOTE: hooks run in the order they appear so Ruff formats before it lints.
 repos:
   - repo: local
     hooks:
-      # 1️⃣  Sort imports **first** – with Black-compatible style
-      - id: isort
-        name: isort (black-profile)
-        entry: uv run isort --profile=black --filter-files
-        language: system
-        types: [python]
-
-  - repo: local
-    hooks:
-      # 2️⃣  Let Black format everything after isort touched the imports
-      - id: black
-        name: black
-        entry: uv run black --line-length 88
-        language: system
-        types: [python]
-
-  - repo: local
-    hooks:
-      # 3️⃣  Flake8 only checks; it should never re-write files
-      - id: flake8
-        name: flake8
-        entry: uv run flake8 --config=.flake8
+      - id: ruff-format
+        name: ruff format
+        entry: uv run ruff format
         language: system
         types: [python]
 
   - repo: local
     hooks:
       - id: ruff
-        name: ruff
-        entry: ruff check --exit-zero
+        name: ruff check
+        entry: uv run ruff check
         language: system
         types: [python]
 

AGENTS.md

@@ -1,7 +1,7 @@
 Keep commits small and focused.
 Use conventional commit messages.
-Format code with `black` and/or `prettier`
-Run `flake8` for lint checks.
+Format Python code with `ruff format` and front-end assets with `prettier`.
+Run `ruff check` for linting.
 Run `pre-commit run --all-files`.
 Run tests with `pytest`.
 Use `pyproject.toml` for dependencies; do not use requirements files.

Makefile

@@ -1,16 +1,16 @@
 .PHONY: format format-yaml lint test test-js precommit setup
 
 format:
-	uv run black .
-	prettier --write app/static/js/**/*.js app/static/css/**/*.css
+        uv run ruff format .
+        prettier --write app/static/js/**/*.js app/static/css/**/*.css
 
 format-yaml:
         prettier --write '*.yml'
 
 lint:
-	uv run flake8
-	uv run ruff check --exit-zero .
-	eslint 'app/static/js/**/*.js'
+        uv run ruff format --check .
+        uv run ruff check .
+        eslint 'app/static/js/**/*.js'
 
 test:
 	uv run pytest

README.md

@@ -220,7 +220,8 @@ To set up the project for development:
 
    ```sh
    uv run pre-commit run --all-files
-   uv run flake8
+   uv run ruff format --check .
+   uv run ruff check .
    uv run pytest
    npm test -- --coverage
    ```

app/AGENTS.md

@@ -1,5 +1,5 @@
-Keep Python modules PEP8 compliant with `black` formatting.
+Keep Python modules PEP8 compliant with `ruff format`.
 Use descriptive docstrings for all public functions and classes.
 Prefer type hints.
 Avoid introducing heavy dependencies without discussion.
-Run `flake8` and `pytest` before committing changes.
+Run `ruff check` and `pytest` before committing changes.

app/routes.py

@@ -1,4 +1,4 @@
-# flake8: noqa
+# ruff: noqa
 """HTTP route handlers and helper utilities.
 
 This module registers all Flask endpoints for the application. Routes handle

docs/ci_checks.md

@@ -6,7 +6,7 @@ and on pull requests targeting those branches.
 The workflow located at `.github/workflows/python-app.yml` performs the
 following tasks:
 
-- Formats Python code with `black`, sorts imports with `isort`, and lints with `ruff` and `flake8`.
+- Formats and lints Python code with Ruff.
 - Checks type hints with `mypy`.
 - Lints JavaScript with `eslint` and verifies formatting with `prettier`.
 - Executes `pytest` and `jest` test suites and uploads coverage.
@@ -15,8 +15,8 @@ following tasks:
 - Caches Python, Node, and pre-commit dependencies to speed up builds.
 - Skips the workflow when only documentation files change.
 
-Running `pre-commit run --all-files` locally will execute the same Black,
-isort, Flake8, and mypy checks before they fail in CI. These checks help catch
+Running `pre-commit run --all-files` locally will execute the same Ruff and
+Mypy checks before they fail in CI. These checks help catch
 regressions and security issues before code is merged.
 On pull requests the workflow lints only the files that changed, while pushes
 to `staging` or `main` run the linter across the entire repository.

docs/developer_guide.md

@@ -6,7 +6,6 @@ This guide provides tips for extending Glimpser, running tests, and contributing
 
 1. Clone the repository and create a virtual environment:
    ```sh
-   ruff check --exit-zero .
    git clone https://github.com/KristopherKubicki/glimpser.git
    cd glimpser
    python -m venv env
@@ -49,11 +48,11 @@ to the web interface.
 
 ## Running Tests
 
-The project uses `pytest` for testing and lints Python with `ruff` and `flake8`. After activating your environment, run:
+The project uses `pytest` for testing and relies on Ruff for formatting and linting. After activating your environment, run:
 
 ```sh
-ruff check --exit-zero .
-flake8
+uv run ruff format --check .
+uv run ruff check .
 pytest  # runs in parallel via pytest-xdist
 ```
 

docs/testing.md

@@ -9,11 +9,11 @@ python -m coverage html
 
 The HTML report will be generated in `htmlcov/index.html`.
 
-Before submitting a patch, lint the code with `ruff` and `flake8`:
+Before submitting a patch, lint and format the code with Ruff:
 
 ```sh
-ruff check --exit-zero .
-flake8
+uv run ruff format --check .
+uv run ruff check .
 ```
 
 Refer to [developer_guide.md](developer_guide.md) for setting up your environment.

pyproject.toml

@@ -70,10 +70,7 @@ glimpser-dashboard = "app.utils.console_dashboard:main"
 [project.optional-dependencies]
 dev = [
   # Core dev tooling - all required for building
-  "black>=25.1",
   "coverage>=7.9",
-  "flake8>=7.2",
-  "isort==6.0.1",
   "mkdocs>=1.6",
   "mypy>=1.16",
   "pre-commit>=4.2",
@@ -122,24 +119,18 @@ packages = ["app", "scripts"]
 # ─────────────────────────────────────────────────────────────────────────────
 # Tooling configuration
 # ─────────────────────────────────────────────────────────────────────────────
-[tool.black]
-line-length       = 88
-target-version    = ["py311"]
-required-version  = "25.1.0"
-
-[tool.isort]
-profile = "black"
-line_length = 88
-
-# Ruff replaces most flake8 / isort / pylint rules, but you can keep the
-# originals for now; just run Ruff first so they have little to flag.
 [tool.ruff]
 line-length    = 88
 target-version = "py311"
 exclude = [".git", "__pycache__", "build", "dist", "node_modules", "env", ".venv"]
 
-# Enable Ruff’s equivalents of common Flake8 & Pylint rules + isort style
-extend-select = ["E", "F", "I", "UP", "PL"]     # E=pycodestyle, F=pyflakes, I=isort, UP=pyupgrade, PL=pylint
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "PL"]     # E=pycodestyle, F=pyflakes, I=isort, UP=pyupgrade, PL=pylint
 
 # MyPy stays as-is
 [tool.mypy]
@@ -170,10 +161,7 @@ tag_format = "v$version"
 # Everything here installs with `pip install .[dev]`
 dev = [
   # ✂︎ existing dev deps kept (versions bumped where useful) ✂︎
-  "black>=25.1",
   "coverage>=7.9",      # keep for standalone HTML reports
-  "flake8>=7.2",
-  "isort==6.0.1",       # now mirrors runtime pin
   "mkdocs>=1.6",
   "mypy>=1.16",
   "pre-commit>=4.2",

tests/AGENTS.md

@@ -3,5 +3,5 @@
 - Write new tests for every feature or bug fix.
 - Use `pytest` for Python and Jest for JavaScript.
 - Keep tests isolated by using fixtures.
-- Run `flake8` and `pytest` (and `npm test` if JS tests change) before committing.
+- Run `ruff check` and `pytest` (and `npm test` if JS tests change) before committing.
 - The test environment has no network access after setup; design tests accordingly.