search.py documentation, comments and type annotations

.github/workflows/docker.yml

@@ -24,7 +24,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v3
         with:
-          python-version: 3.8
+          python-version: 3.12
 
       - name: Install and Run Pre-commit
         uses: pre-commit/action@v3.0.1

README.md

@@ -284,7 +284,12 @@ Run the `src/loaddata.sh` script to load this:
 
 ### 9. Requirements
 
-Requirements are applied when the containers are built.
+To get a virtual environment outside of your docker environment (for example, to make your editor's language server work correctly), use `uv` (from the base directory):
+
+```bash
+uv venv --python 3.12
+uv pip install --requirements src/requirements/local.txt
+```
 
 ### 10. Pre-commit
 

src/.pre-commit-config.yaml

@@ -26,7 +26,7 @@ repos:
       - id: isort
 
   - repo: https://github.com/pycqa/flake8
-    rev: 6.0.0
+    rev: 7.3.0
     hooks:
       - id: flake8
         additional_dependencies: [flake8-isort]