Switch from pre-commit to prek in docs and fix local hook

Update contributor guide and styleguide to recommend prek instead of
pre-commit. Fix the update-algo-selection-code hook to use
importlib + uv instead of pip, which is not available in prek
environments.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: timmens

.tools/update_algo_selection_hook.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python
+import importlib.util
 import subprocess
 import sys
 from pathlib import Path
@@ -8,19 +9,15 @@
 
 # sys.executable guarantees we stay inside the pre‑commit venv
 PYTHON = [sys.executable]
-# "-m" lets us call std‑lib modules (e.g. pip) the same way
-PYTHON_MINUS_M = [*PYTHON, "-m"]
 
 
 def run(cmd: list[str], **kwargs: Any) -> None:
     subprocess.check_call(cmd, cwd=ROOT, **kwargs)
 
 
 def ensure_optimagic_is_locally_installed() -> None:
-    try:
-        run(PYTHON_MINUS_M + ["pip", "show", "optimagic"], stdout=subprocess.DEVNULL)
-    except subprocess.CalledProcessError:
-        run(PYTHON_MINUS_M + ["pip", "install", "-e", "."])
+    if importlib.util.find_spec("optimagic") is None:
+        run(["uv", "pip", "install", "--python", sys.executable, "-e", "."])
 
 
 def main() -> int:

docs/source/development/how_to_contribute.md

@@ -44,14 +44,14 @@ For regular contributors: **Clone** the [repository](https://github.com/optimagi
    local optimagic repository:
 
    ```console
-   $ pre-commit install
+   $ prek install
    ```
 
    This activates pre-commit hooks for linting and style formatting.
 
    ```{note}
-   `pre-commit` is not managed by pixi and must be installed globally. We recommend
-   installing it globally using pixi or uv.
+   `prek` is not managed by pixi and must be installed globally. You can find
+   installation instructions at [github.com/janosg/prek](https://github.com/janosg/prek).
    ```
 
    You can then run the test suite with:
@@ -90,8 +90,8 @@ For regular contributors: **Clone** the [repository](https://github.com/optimagi
    You can also run the test suite locally for
    [debugging](https://effective-programming-practices.vercel.app/debugging/pdbp/objectives_materials.html).
 
-   With pre-commit installed, linters run before each commit. Commits are rejected if
-   any checks fail. Note that some linters may automatically fix errors by modifying the
+   With prek installed, linters run before each commit. Commits are rejected if any
+   checks fail. Note that some linters may automatically fix errors by modifying the
    code in-place. Remember to re-stage the files after such modifications.
 
 ```{tip}
@@ -109,9 +109,9 @@ Skip the next paragraph if you haven't worked on the documentation.
    `docs/build/html/index.html` or any other file. Similar to the online documentation,
    you can navigate to different pages simply by clicking on the links.
 
-1. Once all tests and pre-commit hooks pass locally, push your changes to your forked
-   repository and create a pull request through GitHub: Go to the Github repository of
-   your fork. A banner on your fork's GitHub repository will prompt you to open a PR.
+1. Once all tests and hooks pass locally, push your changes to your forked repository
+   and create a pull request through GitHub: Go to the Github repository of your fork. A
+   banner on your fork's GitHub repository will prompt you to open a PR.
 
    ```{note}
    Regular contributors with push access can directly push their local branch to the remote optimagic repository and initiate a PR from there.

docs/source/development/styleguide.md

@@ -105,9 +105,9 @@ Your contribution should fulfill the criteria provided below.
   refactoring, it is sufficient if the function that calls it is tested. But all
   functions that are exposed to the user must have unit tests.
 
-- Enable pre-commit hooks by executing `pre-commit install` in a terminal in the root of
-  the optimagic repository. This makes sure that your formatting is consistent with what
-  we expect.
+- Enable pre-commit hooks by executing `prek install` in a terminal in the root of the
+  optimagic repository. This makes sure that your formatting is consistent with what we
+  expect.
 
 - Use `pathlib` for all file paths operations. : You can find the pathlib documentation
   [here](https://docs.python.org/3/library/pathlib.html)