CHANGELOG.md

@@ -5,6 +5,10 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.5.0] - 2024-01-16
+
+- `python-tox.yml` allows specifying a precise version of `tox` to use.
+
 ## [3.4.0] - 2024-01-03
 
 ### Changed

auto-devops/python-tox.yml

@@ -11,7 +11,7 @@ include:
   image: $PYTHON_IMAGE
   before_script:
     - echo -e "\e[0Ksection_start:`date +%s`:install_tox[collapsed=true]\r\e[0KInstall tox"
-    - pip install tox $TOX_ADDITIONAL_REQUIREMENTS
+    - pip install "${TOX_REQUIREMENT:-tox}" $TOX_ADDITIONAL_REQUIREMENTS
     - echo -e "\e[0Ksection_end:`date +%s`:install_tox\r\e[0K"
   script:
     - "tox $TOX_OPTS"

auto-devops/python.md

@@ -52,6 +52,9 @@ commit and merge requests pipelines in the "test" stage if a `tox.ini` file is
 present.
 
 The default behaviour is to run `tox` in the three most recent Python versions.
+By default the latest version of `tox` is installed and run. If you need to
+specify a particular version, use the `TOX_REQUIREMENT` variable. For example,
+setting it to `tox==4.12.0` specifies an exact version of `tox` to use.
 
 The job can be disabled by setting the `PYTHON_TOX_DISABLED` variable.