Merge pull request #933 from scop/docs/dev-python-deps

docs: Python dependency clarifications

Author: scop

.github/requirements.txt

@@ -1,3 +1,4 @@
 -r ../test/requirements-dev.txt
 
 gitlint==0.19.1
+pre-commit>=2.4.0

.pre-commit-config.yaml

@@ -1,4 +1,5 @@
 default_stages: [commit]
+minimum_pre_commit_version: 2.4.0
 
 repos:
 

CONTRIBUTING.md

@@ -199,6 +199,15 @@ Also, please bear the following coding guidelines in mind:
 - In addition to running the test suite, there are a few scripts in the test/
   dir that catch some common issues, see and use for example runLint.
 
+- Make sure you have Python 3.7 or later installed. This is required for
+  running the development tooling, linters etc. Rest of the development
+  Python dependencies are specified in `test/requirements-dev.txt` which
+  can be fed for example to `pip`:
+
+  ```shell
+  python3 -m pip install -r test/requirements-dev.txt
+  ```
+
 - Install pre-commit and set it up, see <https://pre-commit.com/>.
   That'll run a bunch of linters and the like, the same as the
   bash-completion CI does. Running it locally and fixing found issues before

doc/testing.md

@@ -23,7 +23,7 @@ dependencies are specified in the `test/requirements.txt` file. If using `pip`,
 this file can be fed directly to it, e.g. like:
 
 ```shell
-pip install -r test/requirements.txt
+python3 -m pip install -r test/requirements.txt
 ```
 
 ### Debian/Ubuntu

test/requirements-dev.txt

@@ -1,8 +1,7 @@
-# Python >= 3.6.1 required here
+# Python >= 3.7 required here
 
 -r requirements.txt
 
 black==23.1.0
 mypy==1.2.0
-pre-commit>=2.4.0
 ruff==0.0.247