Switch from pre-commit to prek (#5037)

Author: leoll2

.github/labeler.yml

@@ -32,11 +32,11 @@ BUILD:
       - any-glob-to-any-file:
           - ".ci/**/*"
           - ".github/**/*"
-          - ".pre-commit-config.yaml"
-          - "markdownlint.rb"
+          - "**/.pre-commit-config.yaml"
           - "**/pyproject.toml"
           - "**/tox.ini"
           - "**/Dockerfile"
+          - "markdownlint.yaml"
           - "MANIFEST.in"
 
 DEPENDENCY:

.markdownlint.yaml

@@ -27,14 +27,14 @@ MD033: false # Inline HTML
 # If a page is printed, it helps if the URL is viewable.
 MD034: false # Bare URL used
 
+# Either disable this one or MD024 - Multiple headers with the same content.
+MD036: false # Emphasis used instead of a header
+
 # fenced-code-language: Fenced code blocks should have a language
 MD040: false
 
 # Some md files have comments or links at the top of the files.
 MD041: false # First line in file should be a top level header
 
-#===============================================================================
-# Exclude rules for pragmatic reasons.
-
-# Either disable this one or MD024 - Multiple headers with the same content.
-MD036: false # Emphasis used instead of a header
+# Link text like '[here]' is acceptable if the context is descriptive enough.
+MD059: false

.pre-commit-config.yaml

@@ -1,76 +1,40 @@
+# Pre-commit configuration file for code quality and formatting checks
+# In this repository we use 'prek' instead of 'pre-commit' to manage hooks.
+# Ensure that 'prek' is installed and used to run these hooks (documentation -> https://github.com/j178/prek).
+
+minimum_prek_version: "0.2.19"
+
 default_language_version:
-  node: 16.15.0
-  ruby: 2.7.2
+  node: 24.11.1
   python: python3.12
 
 repos:
-  # yaml formatting
+  # Ruff - Python linter and formatter
+  - repo: https://github.com/charliermarsh/ruff-pre-commit
+    rev: v0.11.13
+    hooks:
+      - id: ruff-check
+        args: [--fix, --unsafe-fixes]
+      - id: ruff-format
+
+  # Prettier - Code formatter for UI files
   - repo: https://github.com/pre-commit/mirrors-prettier
     rev: v3.0.3
     hooks:
       - id: prettier
         exclude: ^application/ui/
 
-  - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: "v1.6.1"
-    hooks:
-      - id: mypy
-        alias: mypy_lib
-        name: mypy (library)
-        files: '^library/(src/otx)/.*\.py'
-        additional_dependencies:
-          [
-            types-PyYAML,
-            attrs==21.2.*,
-            types-aiofiles,
-            types-requests,
-            types-Deprecated,
-            types-docutils,
-            types_futures,
-            types-setuptools,
-            types-python-dateutil,
-            tokenize-rt==3.2.0,
-          ]
-        args: [--disallow-untyped-calls, --config-file, library/pyproject.toml]
-
-  - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: "v1.12.0"
-    hooks:
-      - id: mypy
-        alias: mypy_backend
-        name: mypy (backend)
-        files: '^application/backend/.*\.py'
-        additional_dependencies: [types-PyYAML, types-aiofiles, types-requests]
-        args:
-          [
-            --disallow-untyped-calls,
-            --config-file,
-            application/backend/pyproject.toml,
-          ]
-
+  # Hadolint - Dockerfile linter
   - repo: https://github.com/AleksaC/hadolint-py
     rev: v2.12.0.3
     hooks:
       - id: hadolint
-        name: Lint Dockerfiles
+        name: hadolint
         description: Runs hadolint to lint Dockerfiles
 
-  - repo: https://github.com/shellcheck-py/shellcheck-py
-    rev: v0.9.0.6
-    hooks:
-      - id: shellcheck # TODO remove this when all shell scripts have been removed from otx
-
-  # markdown linting
+  # Markdownlint - Markdown linter
   - repo: https://github.com/igorshubovych/markdownlint-cli
-    rev: v0.37.0
+    rev: v0.46.0
     hooks:
       - id: markdownlint
         args: [--config=.markdownlint.yaml]
-
-  # Ruff
-  - repo: https://github.com/charliermarsh/ruff-pre-commit
-    rev: v0.11.13
-    hooks:
-      - id: ruff-check
-        args: [--fix, --unsafe-fixes]
-      - id: ruff-format

README.md

@@ -229,7 +229,7 @@ For those who would like to contribute to the library, see [CONTRIBUTING.md](CON
 Thank you! we appreciate your support!
 
 <a href="https://github.com/open-edge-platform/training_extensions/graphs/contributors">
-  <img src="https://contrib.rocks/image?repo=open-edge-platform/training_extensions" />
+  <img src="https://contrib.rocks/image?repo=open-edge-platform/training_extensions" alt="Contributors" />
 </a>
 
 ---

application/backend/.pre-commit-config.yaml

@@ -0,0 +1,17 @@
+default_language_version:
+  python: python3.13 # Should match the Python version used by the app (set in backend/pyproject.toml)
+
+repos:
+  - repo: https://github.com/astral-sh/uv-pre-commit
+    rev: "0.9.7"
+    hooks:
+      - id: uv-lock
+        name: uv lock
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: "v1.16.1"
+    hooks:
+      - id: mypy
+        alias: mypy_backend
+        name: mypy (backend)
+        additional_dependencies: [types-PyYAML, types-aiofiles, types-requests]
+        args: [--disallow-untyped-calls, --config-file, pyproject.toml]

application/backend/pyproject.toml

@@ -44,17 +44,17 @@ mqtt = [
 
 [dependency-groups]
 dev = [
-    "testcontainers~=4.10.0",
     "pytest~=8.4",
     "pytest-asyncio~=1.1.0",
-    "types-aiofiles==24.1.0.20240626",
+    "testcontainers~=4.10.0",
     "time-machine~=2.19.0",
 ]
 lint = [
-    "ruff==0.11.13",
     "mypy~=1.16.1",
-    "types-PyYAML~=6.0.12",
+    "ruff==0.11.13",
+    "types-aiofiles~=25.1.0",  # should match aiofiles version
     "types-requests~=2.32.4",
+    "types-pyyaml~=6.0.12",  # should match pyyaml version
 ]
 
 [tool.uv]

application/backend/uv.lock

@@ -0,0 +1,18 @@
+default_language_version:
+  python: python3.10 # Should match the lowest Python version supported by the library (set in library/pyproject.toml)
+
+repos:
+  - repo: https://github.com/astral-sh/uv-pre-commit
+    rev: "0.9.7"
+    hooks:
+      - id: uv-lock
+        name: uv lock
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: "v1.6.1"
+    hooks:
+      - id: mypy
+        alias: mypy_lib
+        name: mypy (library)
+        files: '^src/otx/.*\.py'
+        additional_dependencies: [types-PyYAML]
+        args: [--disallow-untyped-calls, --config-file, pyproject.toml]

library/.pre-commit-config.yaml

@@ -55,7 +55,6 @@ dependencies = [
 
 [dependency-groups]
 dev = [
-    "pre-commit==4.2.0",
     "pytest>=5.3.5",
     "pytest-cov>=4.0.0",
     "pytest-stress",