Migrate from Poetry to uv (PP-3973) (#243)

## Summary
- Switch dependency management and build tooling from Poetry to
[uv](https://docs.astral.sh/uv/), matching the pattern introduced in
[circulation#3221](ThePalaceProject/circulation#3221).
- Rewrite \`pyproject.toml\` using PEP 621 \`[project]\` + \`hatchling\`
build backend; dev/ci deps move to PEP 735 \`[dependency-groups]\`; git
subdirectory deps move to \`[tool.uv.sources]\` (with \`palace-util\`
now resolved transitively via palace-opds).
- Replace \`poetry.lock\` with \`uv.lock\`.
- \`tox.ini\` uses the \`uv-venv-lock-runner\` from \`tox-uv\`.
- GitHub workflows use \`astral-sh/setup-uv\`; lint workflow gains a
pre-commit cache.
- Dependabot switches from \`pip\` to \`uv\` ecosystem.
- README documents uv-based setup; \`.python-version\` now pins a real
version (was a pyenv-virtualenv name).

> Stacked on top of #242. Please review/merge that one first.

## Test plan
- [x] \`uv run mypy\` clean
- [x] \`uv run pytest\` (154 tests) passes
- [x] \`tox\` (py312), \`tox -e mypy\`, \`tox -e lint\` all green

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>`.