Migrate from Poetry to uv

Switch dependency management and build tooling from Poetry to uv,
matching the configuration pattern used in the circulation repo
(PR ThePalaceProject/circulation#3221).

- Rewrite pyproject.toml using PEP 621 [project] + hatchling build
  backend; move dev/ci deps to PEP 735 [dependency-groups]; git
  subdirectory deps move to [tool.uv.sources] (palace-util now
  resolves transitively via palace-opds).
- Replace poetry.lock with uv.lock.
- tox.ini uses the uv-venv-lock-runner (tox-uv).
- GitHub workflows use astral-sh/setup-uv; lint workflow gets a
  pre-commit cache.
- Dependabot switches from pip to uv ecosystem.
- README documents uv-based setup.

Author: jonathangreen

.github/dependabot.yml

@@ -3,11 +3,13 @@
 
 version: 2
 updates:
-  - package-ecosystem: "pip"
+  - package-ecosystem: "uv"
     directory: "/"
     schedule:
       interval: "daily"
     versioning-strategy: increase-if-necessary
+    cooldown:
+      default-days: 4
 
   - package-ecosystem: "github-actions"
     directory: "/"

.github/workflows/lint.yml

@@ -13,22 +13,23 @@ jobs:
     steps:
       - uses: actions/checkout@v6
 
-      - name: Set up Python
-        uses: actions/setup-python@v6
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.0.0
         with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
           python-version: ${{ env.PYTHON_VERSION }}
-
-      - name: Install Poetry
-        uses: ThePalaceProject/circulation/.github/actions/poetry@main
-        with:
-          version: "2.2.1"
-          cache: false
+          activate-environment: true
 
       - name: Install Pre-commit
-        run: |
-          poetry install --only ci
-        env:
-          POETRY_VIRTUALENVS_CREATE: false
+        run: uv sync --frozen --only-group ci
+
+      - name: Restore pre-commit cache
+        uses: actions/cache@v5
+        with:
+          path: ~/.cache/pre-commit
+          key: pre-commit-${{ runner.os }}-py${{ env.PYTHON_VERSION }}-${{ hashFiles('.pre-commit-config.yaml') }}
+          restore-keys: pre-commit-${{ runner.os }}-py${{ env.PYTHON_VERSION }}
 
       - name: Lint
         run: pre-commit run --all-files --show-diff-on-failure

.github/workflows/mypy.yml

@@ -12,24 +12,16 @@ jobs:
     steps:
       - uses: actions/checkout@v6
 
-      - name: Set up Python 🐍
-        uses: actions/setup-python@v6
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.0.0
         with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
           python-version: ${{ env.PYTHON_VERSION }}
-
-      - name: Install Poetry 🎸
-        uses: ThePalaceProject/circulation/.github/actions/poetry@main
-        with:
-          version: "2.2.1"
-          cache: true
-          cache-name: without-ci
-
-      - name: Install OS Packages 🧰
-        run: |
-          sudo apt-get update
+          activate-environment: true
 
       - name: Install Python Packages 📦
-        run: poetry install --without ci
+        run: uv sync --frozen --no-group ci
 
       - name: Run MyPy 🪄
-        run: poetry run mypy
+        run: mypy

.github/workflows/test.yml

@@ -12,24 +12,16 @@ jobs:
     steps:
       - uses: actions/checkout@v6
 
-      - name: Set up Python 🐍
-        uses: actions/setup-python@v6
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.0.0
         with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
           python-version: ${{ env.PYTHON_VERSION }}
+          activate-environment: true
 
-      - name: Install Poetry 🎸
-        uses: ThePalaceProject/circulation/.github/actions/poetry@main
-        with:
-          version: "2.2.1"
-          cache: true
-          cache-name: without-ci
-
-      - name: Install OS Packages 🧰
-        run: |
-          sudo apt-get update
-
-      - name: Install Python Packages 📦
-        run: poetry install --without ci
+      - name: Install Tox 🧪
+        run: uv sync --frozen --only-group ci
 
-      - name: Run Tests with Tox 🧪
-        run: poetry run tox
+      - name: Run Tests 🧪
+        run: tox

.gitignore

@@ -14,6 +14,7 @@ __pycache__/
 env/
 env2/
 venv/
+.venv/
 build/
 develop-eggs/
 dist/

.pre-commit-config.yaml

@@ -14,6 +14,7 @@ repos:
       - id: check-executables-have-shebangs
       - id: check-merge-conflict
       - id: check-added-large-files
+        exclude: ^uv\.lock$
       - id: mixed-line-ending
 
   - repo: https://github.com/asottile/pyupgrade

README.md

@@ -49,39 +49,21 @@ manifest conforming to the [Audiobook Profile](https://github.com/readium/webpub
 
 ## Working as a developer on this project
 
-### pyenv
+### uv
 
-[pyenv](https://github.com/pyenv/pyenv) lets you easily switch between multiple versions of Python. It can be
-[installed](https://github.com/pyenv/pyenv-installer) using the command `curl https://pyenv.run | bash`. You can then
-install the version of Python you want to work with.
+This project uses [uv](https://docs.astral.sh/uv/) for Python and dependency management.
+If you plan to work on this project, you will need `uv`.
 
-It is recommended that [pyenv-virtualenv](https://github.com/pyenv/pyenv-virtualenv) be used to allow `pyenv`
-to manage _virtual environments_ in a manner that can be used by the [poetry](#poetry) tool. The `pyenv-virtualenv`
-plugin can be installed by cloning the relevant repository into the `plugins` subdirectory of your `$PYENV_ROOT`:
+uv can be installed with `curl -LsSf https://astral.sh/uv/install.sh | sh`. See the
+[uv documentation](https://docs.astral.sh/uv/getting-started/installation/) for other
+installation options.
 
-```sh
-mkdir -p $PYENV_ROOT/plugins
-cd $PYENV_ROOT/plugins
-git clone https://github.com/pyenv/pyenv-virtualenv
-```
-
-After cloning the repository, `pyenv` now has a new `virtualenv` command:
+Once uv is installed, you can install the required Python version with:
 
 ```sh
-$ pyenv virtualenv
-pyenv-virtualenv: no virtualenv name given.
+uv python install 3.12
 ```
 
-### Poetry
-
-This project uses [poetry](https://python-poetry.org/) for dependency management.
-If you plan to work on this project, you will need `poetry`.
-
-Poetry can be installed using the command `curl -sSL https://install.python-poetry.org | python3 -`.
-
-More information about installation options can be found in the
-[poetry documentation](https://python-poetry.org/docs/master/#installation).
-
 ## Installation
 
 This package is not currently available oon PyPI, but it can be installed and run locally in a couple of
@@ -111,8 +93,7 @@ If installation is successful, `pipx` will list the apps that are installed with
 
 - Clone the repository.
 - Change into the cloned directory.
-- Run `pyenv virtualenv <python-version> <virtualenv-name>` to create a Python virtual environment.
-- Run `pyenv local <virtualenv-name>` to use that virtual environment whenever in the cloned directory.
-- Run `poetry install` to install the project dependencies and the CLI tools into the virtual environment.
+- Run `uv sync --all-groups` to install the project dependencies and the CLI tools into a
+  `.venv` virtual environment.
 
-At this point, you should be able to run the CLI tools using `poetry run <cli-command-and-args>`.
+At this point, you should be able to run the CLI tools using `uv run <cli-command-and-args>`.