chore: pin lint tooling (ruff, pyright, pre-commit) as project-scoped deps (#44)

* chore: run lint hooks via uv run

* chore: pin ruff pyright and pre-commit in dev lint group

* docs: document uv run and project-scoped tooling

Author: fkdosilovic

.pre-commit-config.yaml

@@ -3,19 +3,19 @@ repos:
     hooks:
       - id: ruff-check
         name: ruff check
-        entry: uv tool run ruff check --fix
+        entry: uv run ruff check --fix
         language: unsupported
         types: [python]
 
       - id: ruff-format
         name: ruff format
-        entry: uv tool run ruff format
+        entry: uv run ruff format
         language: unsupported
         types: [python]
 
       - id: pyright
         name: pyright
-        entry: uv tool run pyright src tests
+        entry: uv run pyright src tests
         language: unsupported
         types: [python]
         pass_filenames: false

CHANGELOG.md

@@ -8,4 +8,6 @@
 - Parse Judge0 UTC timestamps as timezone-aware values and validate submission
 - Replace Flake8 and ufmt checks with pinned Ruff and Pyright hooks.
   source code and batch tokens before serialization.
+- Pin Ruff, Pyright, and pre-commit as project-scoped dependencies in the dev
+  `lint` group, replacing global `uv tool` installs for reproducible setups.
 - Add `AGENTS.md` and `CHANGELOG.md`

docs/source/contributors_guide/contributing.rst

@@ -18,23 +18,16 @@ Preparing the development setup
 
     $ uv sync --group dev
 
-4. Install the necessary development tools:
+4. Install the pre-commit hooks:
 
 .. code-block:: console
 
-    $ uv tool install pre-commit
+    $ uv run pre-commit install
 
-5. Make sure all the necessary tools are installed:
-
-.. code-block:: console
-
-    $ uv tool list
-
-6. Finally, install the pre-commit hooks:
-
-.. code-block:: console
-
-    $ uv tool run pre-commit install
+All project tooling — including the test, documentation, and linting dependencies
+(``pytest``, Sphinx, ``ruff``, ``pyright``, and ``pre-commit``) — is project-scoped.
+Everything is installed by ``uv sync --group dev`` and invoked with ``uv run``,
+so there is no need to install any tools globally.
 
 Building documentation
 ----------------------
@@ -88,17 +81,23 @@ To run the tests locally, you can use the following command:
 
 .. code-block:: console
 
-    $ pytest tests -k '<test_name>'
+    $ uv run pytest tests -k '<test_name>'
 
 This will enable you to run a single test, without incurring the cost of
 running the full test suite. If you want to run the full test suite, you can
 use the following command:
 
 .. code-block:: console
 
-    $ pytest tests
+    $ uv run pytest tests
 
 or you can create a draft PR and let the CI pipeline run the tests for you.
 The CI pipeline will run the tests on every PR, using a private instance
 of Judge0, so you can be sure that your changes are not breaking the existing
 functionality.
+
+Before committing, run all linting and type-checking checks with pre-commit:
+
+.. code-block:: console
+
+    $ uv run pre-commit run --all-files

pyproject.toml

@@ -46,7 +46,12 @@ docs = [
     "sphinx-multiversion==0.2.4",
     "sphinx-autobuild>=2024.10.3",
 ]
-dev = [{ include-group = "test" }, { include-group = "docs" }]
+dev = [{ include-group = "test" }, { include-group = "docs" }, { include-group = "lint" }]
+lint = [
+    "pre-commit==4.6.0",
+    "pyright==1.1.409",
+    "ruff==0.15.12",
+]
 
 
 [tool.ruff.lint.per-file-ignores]