PPPSYS-56851 Run Ruff in CI and add pyproject lint config

Author: DareYouS

.github/workflows/lint.yaml

@@ -9,11 +9,22 @@ jobs:
     timeout-minutes: 10
     steps:
       - name: Check out repository code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
 
-      - name: Run linters
-        uses: PiwikPRO/actions/python/lint@master
+      - name: Install uv
+        uses: astral-sh/setup-uv@eb1897b8dc4b5d5bfe39a428a8f2304605e0983c
         with:
-          use-black: true
-          use-flake: true
-          use-isort: true
+          version: "latest"
+          enable-cache: true
+          cache-dependency-glob: |
+            pyproject.toml
+            uv.lock
+
+      - name: Sync dev dependencies
+        run: uv sync --frozen --group dev-local
+
+      - name: Run ruff linting
+        run: uv run ruff check . --config pyproject.toml
+
+      - name: Check ruff formatting
+        run: uv run ruff format --check . --config pyproject.toml

CHANGELOG.md

@@ -5,6 +5,7 @@
 - PPPSYS-56851 Require Python 3.10 or newer (3.9 and older are end-of-life); CI tests 3.10 through 3.14
 - PPPSYS-56851 Migrated packaging and CI from Poetry to uv (PEP 621, setuptools, committed `uv.lock`); PyPI releases use `uv publish`.
 - PPPSYS-56851 Added local multi-version testing with tox (`tox.ini`, environments `py310`–`py314` aligned with CI); optional `dev-local` uv dependency group installs tox and tox-uv (see README).
+- PPPSYS-56851 Replaced legacy Black/Flake8/isort GitHub Action with **Ruff** (`ruff check` / `ruff format --check` in CI; configuration in `pyproject.toml`).
 
 ## [5.2.1] - 2023-11-09
 

README.md

@@ -20,6 +20,8 @@ Use `uv run tox -e py312` for one version, or `uv run tox -- test_main.py -q` to
 
 If you skip `dev-local`, use `uvx tox` or a globally installed `tox` against this `tox.ini` (install **tox-uv** alongside tox if your default interpreter comes from uv and tox envs fail to start).
 
+Lint and format with [Ruff](https://docs.astral.sh/ruff/) (same style as the Piwik PRO MCP repo): `uv run ruff check .` and `uv run ruff format .` (CI runs `ruff format --check`).
+
 ## Getting started
 
 1. Download this git repository `git clone git@github.com:PiwikPRO/log-analytics.git`. The script uses only python standard library, so no external packages are required. Alternatively you can download our PyPi package - `pip install piwik-pro-log-analytics`.

pyproject.toml

@@ -21,9 +21,36 @@ packages = ["piwik_pro_log_analytics"]
 [tool.uv]
 package = true
 
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+src = ["piwik_pro_log_analytics", "tests"]
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "W",
+    "I",
+    "A",
+    "ERA",
+    "PL",
+    "UP",
+]
+ignore = [
+    "PLR2004",
+    "PLR0913",
+]
+
+# Legacy importer and tests predate stricter pylint-style and pyupgrade rules.
+[tool.ruff.lint.per-file-ignores]
+"piwik_pro_log_analytics/import_logs.py" = ["A", "ERA", "PL", "UP"]
+"tests/**" = ["A", "ERA", "PL", "UP"]
+
 [dependency-groups]
 dev-local = [
     "tox>=4.21",
     "pytest>=7",
     "tox-uv>=1.33.4",
+    "ruff>=0.12.7",
 ]