Use uv for dependencies and packaging

.github/workflows/tests.yml

@@ -14,17 +14,14 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v5
 
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v6
+      - name: Install uv and set the Python version
+        uses: astral-sh/setup-uv@v6
         with:
           python-version: ${{ matrix.python-version }}
+          enable-cache: true
 
       - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install -r requirements.txt
-          pip install -r test_requirements.txt
+        run: uv sync --locked --dev
 
       - name: Run tests
-        run: python -m pytest
-        continue-on-error: false
+        run: uv run pytest

.python-version

@@ -0,0 +1 @@
+3.10

CONTRIBUTING.rst

@@ -6,18 +6,20 @@ Setup
 
 First fork the repository and clone your fork.
 
-Install the dependencies:
+We use [uv](https://docs.astral.sh/uv/) to manage dependencies.
+All `uv` commands will implicitly install the required dependencies,
+however you can also explicitly install them with `uv sync`:
 
 .. code-block:: console
 
-    pip install -r requirements.txt -r test_requirements.txt
+    uv sync
 
 Running the tests
 -----------------
 
 .. code-block:: console
 
-    pytest
+    uv run pytest
 
 This also runs E2E tests that verify that `mutmut run` produces the same output as before. If your code changes should change the output of `mutmut run` and this test fails, try to delete the `snapshots/*.json` files (as described in the test errors).
 

README.rst

@@ -206,7 +206,7 @@ You can add and override pytest arguments:
 .. code-block:: python
 
     # for CLI args that select or deselect tests, use `pytest_add_cli_args_test_selection`
-    pytest_add_cli_args_test_selection = ["-m", "not fail", "-k=test_include"]
+    pytest_add_cli_args_test_selection = ["-m", "not fail", "-k", "test_include"]
 
     # for other CLI args, use `pytest_add_cli_args`
     pytest_add_cli_args = ["-p", "no:some_plugin"] # disable a plugin

pyproject.toml

@@ -0,0 +1,62 @@
+[project]
+name = "mutmut"
+version = "3.3.1"
+description = "mutation testing for Python 3"
+keyowrds = ["mutmut", "mutant", "mutation", "test", "testing"]
+authors = [
+    { name = "Anders Hovmöller", email = "[email protected]" },
+]
+requires-python = ">=3.10"
+readme = "README.rst"
+license = "BSD-3-Clause"
+license-files = ["LICENSE"]
+
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Natural Language :: English",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+]
+
+dependencies = [
+    "click>=8.0.0",
+    "coverage>=7.3.0",
+    "libcst>=1.8.5",
+    "pytest>=6.2.5",
+    "setproctitle>=1.1.0",
+    "textual>=1.0.0",
+    "toml>=0.10.2 ; python_full_version < '3.11'",
+]
+
+[project.urls]
+Homepage = "https://github.com/boxed/mutmut"
+Documentation = "https://mutmut.readthedocs.io/en/latest/"
+Repository = "https://github.com/boxed/mutmut"
+Issues = "https://github.com/boxed/mutmut/issues"
+Changelog = "https://github.com/boxed/mutmut/blob/main/HISTORY.rst"
+
+
+[project.scripts]
+mutmut = "mutmut.__main__:cli"
+
+[build-system]
+requires = ["uv_build>=0.9.5,<0.10.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+source-include = ["HISTORY.rst"]
+
+[dependency-groups]
+dev = [
+    "pytest-asyncio>=1.0.0",
+]
+
+[tool.pytest.ini_options]
+testpaths = [
+    "tests",
+]

mutmut/__init__.py → src/mutmut/__init__.py

@@ -1,6 +1,7 @@
+import importlib.metadata
 from collections import defaultdict
 
-__version__ = '3.3.1'
+__version__ = importlib.metadata.version("mutmut")
 
 
 duration_by_test = defaultdict(float)

mutmut/__main__.py → src/mutmut/__main__.py

@@ -475,7 +475,7 @@ def pytest_runtest_makereport(self, item, call):
             return int(self.execute_pytest(pytest_args, plugins=[stats_collector]))
 
     def run_tests(self, *, mutant_name, tests):
-        pytest_args = ['-x', '-q', '-p no:randomly', '-p no:random-order']
+        pytest_args = ['-x', '-q', '-p', 'no:randomly', '-p', 'no:random-order']
         if tests:
             pytest_args += list(tests)
         else:
@@ -806,7 +806,7 @@ def load_config():
 
 
 @click.group()
-@click.version_option(mutmut.__version__)
+@click.version_option()
 def cli():
     pass