Migrate to uv and dependency groups

Author: sloria

.github/dependabot.yml

@@ -1,11 +1,16 @@
 version: 2
 updates:
-- package-ecosystem: pip
+- package-ecosystem: uv
   directory: "/"
   schedule:
-    interval: daily
-  open-pull-requests-limit: 10
+    interval: monthly
+  groups:
+    all-dependencies:
+      patterns: ["*"]
 - package-ecosystem: "github-actions"
   directory: "/"
   schedule:
     interval: "monthly"
+  groups:
+    all-actions:
+      patterns: ["*"]

.github/workflows/build-release.yml

@@ -20,27 +20,22 @@ jobs:
           - { name: "mypy-madev", python: "3.13", tox: mypy-marshmallowdev }
     steps:
       - uses: actions/checkout@v6
-      - uses: actions/setup-python@v6
+      - uses: astral-sh/setup-uv@v7
         with:
           python-version: ${{ matrix.python }}
-      - run: python -m pip install tox
-      - run: python -m tox -e${{ matrix.tox }}
+          enable-cache: true
+      - run: uv run tox -e${{ matrix.tox }}
   build:
     name: Build package
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
-      - uses: actions/setup-python@v6
+      - uses: astral-sh/setup-uv@v7
         with:
           python-version: "3.13"
-      - name: Install pypa/build
-        run: python -m pip install build
-      - name: Build a binary wheel and a source tarball
-        run: python -m build
-      - name: Install twine
-        run: python -m pip install twine
-      - name: Check build
-        run: python -m twine check --strict dist/*
+          enable-cache: true
+      - run: uv build
+      - run: uvx twine check --strict dist/*
       - name: Store the distribution packages
         uses: actions/upload-artifact@v7
         with:
@@ -53,11 +48,11 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
-      - uses: actions/setup-python@v6
+      - uses: astral-sh/setup-uv@v7
         with:
           python-version: "3.13"
-      - run: python -m pip install tox
-      - run: python -m tox -e lint
+          enable-cache: true
+      - run: uv run tox -e lint
   publish-to-pypi:
     name: PyPI release
     if: startsWith(github.ref, 'refs/tags/')

.gitignore

@@ -35,6 +35,9 @@ nosetests.xml
 .project
 .pydevproject
 
+# Virtualenvs
+.venv
+
 # Complexity
 output/*.html
 output/*/index.html

.pre-commit-config.yaml

@@ -16,3 +16,7 @@ repos:
   hooks:
   - id: blacken-docs
     additional_dependencies: [black==25.1.0]
+- repo: https://github.com/astral-sh/uv-pre-commit
+  rev: 0.10.9
+  hooks:
+    - id: uv-lock

.readthedocs.yml

@@ -1,15 +1,19 @@
+# https://docs.readthedocs.com/platform/stable/build-customization.html#install-dependencies-with-uv
 version: 2
 sphinx:
   configuration: docs/conf.py
 formats:
   - pdf
 build:
-  os: ubuntu-22.04
+  os: ubuntu-24.04
   tools:
     python: "3.13"
-python:
-  install:
-    - method: pip
-      path: .
-      extra_requirements:
-        - docs
+  jobs:
+    pre_create_environment:
+      - asdf plugin add uv
+      - asdf install uv latest
+      - asdf global uv latest
+    create_environment:
+      - uv venv "${READTHEDOCS_VIRTUALENV_PATH}"
+    install:
+      - UV_PROJECT_ENVIRONMENT="${READTHEDOCS_VIRTUALENV_PATH}" uv sync --frozen --group docs

CONTRIBUTING.rst

@@ -18,21 +18,19 @@ Setting up for local development
     $ git clone https://github.com/marshmallow-code/marshmallow-sqlalchemy.git
     $ cd marshmallow-sqlalchemy
 
-2. Install development requirements. **It is highly recommended that you use a virtualenv.**
-   Use the following command to install an editable version of
-   marshmallow-sqlalchemy along with its development requirements.
+2. Install `uv <https://docs.astral.sh/uv/getting-started/installation/>`_.
+
+3. Install development requirements.
 
 .. code-block:: shell-session
 
-    # After activating your virtualenv
-    $ pip install -e '.[dev]'
+    $ uv sync
 
-3. Install the pre-commit hooks, which will format and lint your git staged files.
+4. (Optional but recommended) Install the pre-commit hooks, which will format and lint your git staged files.
 
 .. code-block:: shell-session
 
-    # The pre-commit CLI was installed above
-    $ pre-commit install
+    $ uv run pre-commit install --allow-missing-config
 
 Pull requests
 --------------
@@ -70,19 +68,19 @@ To run all tests:
 
 .. code-block:: shell-session
 
-    $ pytest
+    $ uv run pytest
 
 To run formatting and syntax checks:
 
 .. code-block:: shell-session
 
-    $ tox -e lint
+    $ uv run tox -e lint
 
 (Optional) To run tests in all supported Python versions in their own virtual environments (must have each interpreter installed):
 
 .. code-block:: shell-session
 
-    $ tox
+    $ uv run tox
 
 Documentation
 -------------
@@ -93,7 +91,7 @@ To build and serve the docs in "watch" mode:
 
 .. code-block:: shell-session
 
-   $ tox -e docs-serve
+   $ uv run tox -e docs-serve
 
 Changes to documentation will automatically trigger a rebuild.
 

pyproject.toml

@@ -28,17 +28,25 @@ Funding = "https://opencollective.com/marshmallow"
 Issues = "https://github.com/marshmallow-code/marshmallow-sqlalchemy/issues"
 Source = "https://github.com/marshmallow-code/marshmallow-sqlalchemy"
 
-[project.optional-dependencies]
+[dependency-groups]
 docs = [
-  "furo==2025.12.19",
-  "sphinx-copybutton==0.5.2",
-  "sphinx-design==0.6.1",
-  "sphinx-issues==5.0.1",
-  "sphinx==8.2.3; python_version >= '3.11'",
-  "sphinxext-opengraph==0.13.0",
+  "furo",
+  "sphinx-copybutton",
+  "sphinx-design",
+  "sphinx-issues",
+  "sphinx>=8.1; python_version >= '3.11'",
+  "sphinxext-opengraph",
 ]
-tests = ["pytest<10", "pytest-lazy-fixtures"]
-dev = ["marshmallow-sqlalchemy[tests]", "tox", "pre-commit>=3.5,<5.0"]
+tests = ["pytest", "pytest-lazy-fixtures"]
+dev = [
+  { include-group = "tests" },
+  "tox",
+  "tox-uv",
+  "pre-commit>=3.5,<5.0",
+]
+
+[tool.uv]
+default-groups = ["dev"]
 
 [build-system]
 requires = ["flit_core<4"]

tox.ini

@@ -8,7 +8,7 @@ envlist=
     docs
 
 [testenv]
-extras = tests
+dependency_groups = tests
 deps =
     marshmallow3: marshmallow>=3.18.0,<4.0.0
     marshmallowdev: https://github.com/marshmallow-code/marshmallow/archive/dev.tar.gz
@@ -29,14 +29,14 @@ skip_install = true
 commands = pre-commit run --all-files
 
 [testenv:docs]
-extras = docs
+dependency_groups = docs
 commands = sphinx-build docs/ docs/_build {posargs}
 
 ; Below tasks are for development only (not run in CI)
 
 [testenv:docs-serve]
 deps = sphinx-autobuild
-extras = docs
+dependency_groups = docs
 commands = sphinx-autobuild --port=0 --open-browser --delay=2 docs/ docs/_build {posargs} --watch src --watch CONTRIBUTING.rst --watch README.rst
 
 [testenv:readme-serve]