@@ -164,44 +164,14 @@ Links:
164164- < https://microsoft.github.io/pyright>
165165- < https://google.github.io/pytype>
166166
167- With ` tox` , developers can run the full test suite for Python 2.7 and 3.x.
168- The same test suite is used in GitHub CI:
167+ With ` tox` , developers can run the full test suite with several Python versions.
168+ The same test suite is used in GitHub CI.
169+ To install the latest version of ` tox` , in an activated Python ` venv` , run:
169170
170171` ` ` bash
171- pip3 install --user --upgrade ' py>=1.11.0 ' ' virtualenv<20.22 ' ' tox==4.5.1 ' ; hash -r; tox
172+ pip3 install --user --upgrade tox; hash -r; tox
172173` ` `
173174
174- Explanation:
175-
176- - ` tox> =4` is needed in order to fix reading the python2.7 dependencies from ` pyproject.toml`
177- - ` tox==4.5.1` is the last version not depending on ` virtualenv> =20.23` (breaks Python 2.7)
178- - The latest versions of ` tox` need ` ' py>=1.11.0' ` . This ensures that it is at least ` 1.11` .
179- - ` virtualenv-20.22` breaks using python2.7 for the ` py27` , so has to be ` virtualenv< 20.22` .
180-
181- # # Installation of all development dependencies
182-
183- Using pip-tools, you can extract the requirements and extras from ` pyptoject.toml` :
184-
185- ` ` ` bash
186- PYTHON=python3.10
187- EXTRAS=.,test,mypy,pyright,pytype,tox
188- PFLAGS=" --no-warn-conflicts"
189- $PYTHON -m pip install pip-tools==7.3.0
190- $PYTHON -m piptools compile --extra=$EXTRAS -o - pyproject.toml |
191- $PYTHON -m pip install -r /dev/stdin $PFLAGS
192- ` ` `
193-
194- With this, you can run most of the CI tests run by ` tox` and GitHub CI also from the shell.
195-
196- You can use e.g.: ` tox -e py27-test -e py3.10-covcombine-check`
197- The syntax is ` -e py< python-version> -< factor1> [-factor2]` .
198- A few of the factors are:
199-
200- - ` test` : runs ` pytest`
201- - ` cov` : runs ` pytest --cov` and generates ` XML` and ` HTML` reports in ` .tox/py< ver> -cov/logs/`
202- - ` check` : runs ` mypy`
203- - ` fox` : runs like ` cov` but then opens the ` HTML` reports in Firefox
204-
205175# # Recommended `tox` and `pytest` plugins for development
206176
207177When updating existing tests or developing new code with new test coverage, we might want to
@@ -270,7 +240,7 @@ To run `podman` as your user, run these as your user:
270240` ` ` bash
271241systemctl enable --now --user podman.socket # Only configures the podman socket
272242systemctl start --user podman.socket # Start the docker-compatible unix socket
273- # Ubuntu only, Fedora 37 configures it already with more unqualifies search registries:
243+ # Ubuntu only, Fedora configures unqualified search registries out-of-the-box :
274244echo ' unqualified-search-registries = ["docker.io"]' | sudo tee -a /etc/containers/registries.conf
275245sudo touch /etc/containers/nodocker # Quiet the docker emulation notification
276246echo " --container-daemon-socket unix://$XDG_RUNTIME_DIR /podman/podman.sock" >> ~/.actrc
0 commit comments