Skip to content

Commit b44ca89

Browse files
committed
Remove tox, recommend uv
tox has been popular in times when it was easier to run a full Python test matrix on your workstation, for example supported by `pyenv`, compared to provisioning and maintaining it on a Jenkins CI runner. Nowadays, it became so easy to run the full-version test matrix on GitHub Actions (GHA), so `tox` became obsolete in such environments that heavily use GHA. Now that recent advancements added `uv` to the table, sandbox environments don't need to feel ousted.
1 parent a2aae9b commit b44ca89

File tree

3 files changed

+9
-27
lines changed

3 files changed

+9
-27
lines changed

DEVELOP.rst

+9-12
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ CrateDB Python developer guide
55
Setup
66
=====
77

8-
Optionally install Python package and project manager ``uv``,
8+
Optionally install Python package and project manager `uv`_,
99
in order to significantly speed up the package installation::
1010

1111
{apt,brew,pip,zypper} install uv
@@ -67,16 +67,11 @@ To inspect the whole list of test cases, run::
6767

6868
bin/test --list-tests
6969

70-
You can run the tests against multiple Python interpreters with `tox`_::
71-
72-
tox
73-
74-
To do this, you will need the respective Python interpreter versions available
75-
on your ``$PATH``.
76-
77-
To run against a single interpreter, you can also invoke::
78-
79-
tox -e py37
70+
The CI setup on GitHub Actions (GHA) provides a full test matrix covering
71+
relevant Python versions. You can invoke the software tests against a specific
72+
Python interpreter or multiple `Python versions`_ on your workstation using
73+
`uv`_, by supplying the ``--python`` command-line option, or by defining the
74+
`UV_PYTHON`_ environment variable prior to invoking ``source bootstrap.sh``.
8075

8176
*Note*: Before running the tests, make sure to stop all CrateDB instances which
8277
are listening on the default CrateDB transport port to avoid side effects with
@@ -168,12 +163,14 @@ nothing special you need to do to get the live docs to update.
168163
.. _@crate/docs: https://github.com/orgs/crate/teams/docs
169164
.. _buildout: https://pypi.python.org/pypi/zc.buildout
170165
.. _PyPI: https://pypi.python.org/pypi
166+
.. _Python versions: https://docs.astral.sh/uv/concepts/python-versions/
171167
.. _Read the Docs: http://readthedocs.org
172168
.. _ReStructuredText: http://docutils.sourceforge.net/rst.html
173169
.. _Sphinx: http://sphinx-doc.org/
174170
.. _tests/assets/pki/*.pem: https://github.com/crate/crate-python/tree/main/tests/assets/pki
175-
.. _tox: http://testrun.org/tox/latest/
176171
.. _twine: https://pypi.python.org/pypi/twine
177172
.. _useful command-line options for zope-testrunner: https://pypi.org/project/zope.testrunner/#some-useful-command-line-options-to-get-you-started
173+
.. _uv: https://docs.astral.sh/uv/
174+
.. _UV_PYTHON: https://docs.astral.sh/uv/configuration/environment/#uv_python
178175
.. _versions hosted on ReadTheDocs: https://readthedocs.org/projects/crate-python/versions/
179176
.. _zope.testrunner: https://pypi.org/project/zope.testrunner/

setup.py

-1
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,6 @@ def read(path):
7070
"poethepoet<0.33",
7171
"ruff<0.10",
7272
"stopit>=1.1.2,<2",
73-
"tox>=3,<5",
7473
"pytz",
7574
"zc.customdoctests>=1.0.1,<2",
7675
"zope.testing>=4,<6",

tox.ini

-14
This file was deleted.

0 commit comments

Comments
 (0)