Extract palace.opds and palace.util into uv workspace packages

Convert the repo into a uv workspace with two new namespace packages
under packages/:

- palace-util (palace.util): shared exceptions, datetime helpers, and
  LoggerMixin previously living in palace.manager.{core.exceptions,
  util.datetime_helpers, util.log}.
- palace-opds (palace.opds): the OPDS/RWPM/ODL/LCP/Palace Pydantic
  models previously living in palace.manager.opds, depending on
  palace-util for its small set of cross-cutting utilities.

palace.manager.{core.exceptions, util.datetime_helpers, util.log} are
kept as thin re-export shims so the ~316 callers across the codebase
keep working unchanged. palace.manager.util.log keeps log_elapsed_time,
elapsed_time_logging, pluralize, and ExtraDataLoggerAdapter (which
depend on palace-manager-specific bits).

Imports of palace.manager.opds across src/ and tests/ are rewritten to
palace.opds. Tests for the moved code move with it; opds tests that
use OPDS2FilesFixture only for type annotations now import it under
TYPE_CHECKING so the package tests don't need tests.fixtures.files at
import time.

Tooling updates:
- pyproject.toml: workspace + sources, mypy/coverage/pytest paths,
  test override extended for the new test module names.
- tox.ini: pytest now uses testpaths from pyproject.toml.
- docker/Dockerfile: copy workspace pyproject.toml files in the cache
  layer; switch to --no-install-workspace.
- .pre-commit-config.yaml: namespace-package check now matches any
  src/palace/__init__.py, not just the root one.
- README.md: new "Repository Layout" section linking to the package
  READMEs.
- CLAUDE.md: project-structure section reflects the workspace and
  documents the re-export shims.

Author: jonathangreen

.pre-commit-config.yaml

@@ -76,8 +76,8 @@ repos:
       -   id: check-namespace-package
           name: Check that palace is a namespace package
           language: fail
-          entry: Please remove src/palace/__init__.py
-          files: ^src/palace/__init__.py$
+          entry: Please remove src/palace/__init__.py - palace must remain a PEP 420 namespace.
+          files: (^|/)src/palace/__init__\.py$
 
 # Exclude test files, since they may be intentionally malformed
 exclude: ^tests/files/

CLAUDE.md

@@ -49,7 +49,10 @@ through mobile and web applications.
 
 ## Project Structure
 
-- `/src/palace/manager` - Main application source code
+This repository is a [`uv` workspace](https://docs.astral.sh/uv/concepts/projects/workspaces/). The main
+`palace-manager` application is at the repo root; reusable namespace packages live under `/packages`.
+
+- `/src/palace/manager` - Main application source code (`palace-manager`)
   - `/api` - REST API endpoints for mobile applications
     - `/admin` - Administrative API endpoints for the web dashboard
   - `/celery` - Background worker processes and task definitions
@@ -58,18 +61,27 @@ through mobile and web applications.
   - `/data_layer` - Pydantic models for content import and validation
   - `/feed` - OPDS (Open Publication Distribution System) feed generation
   - `/integration` - Third-party service integrations and content provider APIs
-  - `/opds` - Pydantic models for OPDS feed parsing and validation
   - `/scripts` - Legacy CLI utilities (**deprecated - no new code**)
   - `/search` - OpenSearch integration and indexing logic
   - `/service` - Dependency injection container and service layer
   - `/sqlalchemy` - Database models and schema definitions
   - `/util` - Reusable utility functions and helpers
-- `/tests` - Test files
+- `/packages` - Workspace member packages (each is independently buildable/publishable)
+  - `/palace-util` - Shared utilities under the `palace.util` namespace: exceptions
+    (`BasePalaceException`, `PalaceValueError`, `PalaceTypeError`), datetime helpers, `LoggerMixin`.
+    `palace.manager.util.{datetime_helpers,log}` and `palace.manager.core.exceptions` re-export from
+    here for backward compatibility — new code can import from either path.
+  - `/palace-opds` - Pydantic models for OPDS 2.0, RWPM, ODL, LCP, and Palace-specific extensions
+    under the `palace.opds` namespace.
+- `/tests` - Test files for `palace-manager`
   - `/files` - Test fixture files
   - `/fixtures` - pytest fixtures shared across test functions
   - `/manager` - pytest test files (should mirror `src/palace/manager` structure)
   - `/migration` - Database migration tests
   - `/mocks` - Test mocks (**being phased out - avoid in new code**)
+- Each workspace package owns its own `tests/` directory under `packages/<name>/tests/`. The full
+  pytest suite (configured via `testpaths` in `pyproject.toml`) runs them all together so
+  root-conftest plugins remain available to package tests.
 
 ## Architecture Overview
 

README.md

@@ -15,6 +15,17 @@ Palace Manager is a backend service for digital library systems, maintained by [
 - [Patron Blocking Rules — Allowed Functions](docs/FUNCTIONS.md) —
   Reference for the functions available in patron blocking rule expressions.
 
+## Repository Layout
+
+This repository is a [`uv` workspace](https://docs.astral.sh/uv/concepts/projects/workspaces/). The main
+`palace-manager` application lives at the repo root (`src/palace/manager/`). Reusable namespace packages
+live under `packages/`:
+
+- [`palace-util`](packages/palace-util/README.md) — shared utilities (exceptions, datetime helpers,
+  `LoggerMixin`) under the `palace.util` namespace.
+- [`palace-opds`](packages/palace-opds/README.md) — Pydantic models for OPDS 2.0, RWPM, ODL, LCP, and
+  Palace extensions under the `palace.opds` namespace.
+
 ## Installation
 
 Docker images created from this code are available at:

docker/Dockerfile

@@ -18,8 +18,12 @@ COPY --chmod=644 docker/services/logrotate /etc/
 RUN mv /etc/cron.daily/logrotate /etc/cron.hourly/logrotate
 
 # Copy our uv files into the image and install our dependencies.
+# We copy the workspace-member pyproject.toml files (but not their source) so that
+# uv can resolve workspace members without invalidating this layer on source changes.
 COPY --chown=palace:palace uv.lock pyproject.toml /var/www/circulation/
-RUN uv sync --frozen --no-dev --no-install-project
+COPY --chown=palace:palace packages/palace-util/pyproject.toml /var/www/circulation/packages/palace-util/
+COPY --chown=palace:palace packages/palace-opds/pyproject.toml /var/www/circulation/packages/palace-opds/
+RUN uv sync --frozen --no-dev --no-install-workspace
 
 COPY --chown=palace:palace . /var/www/circulation
 

packages/palace-opds/README.md

@@ -0,0 +1,16 @@
+# palace-opds
+
+Pydantic models for OPDS 2.0, RWPM, ODL, LCP, Authentication for OPDS, and Palace Project extensions.
+Exposes the `palace.opds` namespace module.
+
+Top-level modules:
+
+- `palace.opds.opds2` — OPDS 2.0 publication and feed models.
+- `palace.opds.rwpm` — Readium Web Publication Manifest.
+- `palace.opds.authentication` — Authentication for OPDS 1.0.
+- `palace.opds.palace` — Palace-specific extensions.
+- `palace.opds.a11y` — W3C accessibility metadata.
+- `palace.opds.schema_org` — Schema.org vocabulary.
+- `palace.opds.types.*` — Shared Pydantic types (`BaseLink`, language, date, currency).
+- `palace.opds.odl.*` — ODL 1.0 license metadata and status.
+- `palace.opds.lcp.*` — LCP license and loan status documents.

packages/palace-opds/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+build-backend = "hatchling.build"
+requires = ["hatchling"]
+
+[project]
+authors = [{name = "The Palace Project", email = "info@thepalaceproject.org"}]
+dependencies = [
+    "palace-util",
+    "pycountry>=26.2.16,<27",
+    "pydantic-xml>=2.17.0,<3",
+    "pydantic[email]>=2.12,<3",
+    "uritemplate==4.2.0",
+]
+description = "Pydantic models for OPDS 2.0, RWPM, ODL, LCP, and Palace Project extensions."
+license = "Apache-2.0"
+name = "palace-opds"
+readme = "README.md"
+requires-python = ">=3.12,<4"
+version = "0"
+
+[project.urls]
+Homepage = "https://thepalaceproject.org"
+Repository = "https://github.com/ThePalaceProject/circulation"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/palace"]
+
+[tool.uv.sources]
+palace-util = {workspace = true}

src/palace/manager/opds/__init__.py …/palace-opds/src/palace/opds/__init__.pysrc/palace/manager/opds/__init__.py renamed to packages/palace-opds/src/palace/opds/__init__.py src/palace/manager/opds/__init__.py renamed to packages/palace-opds/src/palace/opds/__init__.py

@@ -14,8 +14,8 @@
 
 from pydantic import Field, SerializerFunctionWrapHandler, model_serializer
 
-from palace.manager.opds.base import BaseOpdsModel
-from palace.manager.opds.util import StrOrTuple, drop_if_falsy, obj_or_tuple_to_tuple
+from palace.opds.base import BaseOpdsModel
+from palace.opds.util import StrOrTuple, drop_if_falsy, obj_or_tuple_to_tuple
 
 
 class AccessMode(StrEnum):

src/palace/manager/opds/a11y.py …ages/palace-opds/src/palace/opds/a11y.pysrc/palace/manager/opds/a11y.py renamed to packages/palace-opds/src/palace/opds/a11y.py src/palace/manager/opds/a11y.py renamed to packages/palace-opds/src/palace/opds/a11y.py

@@ -5,9 +5,9 @@
 
 from pydantic import BaseModel, Field, field_validator
 
-from palace.manager.core.exceptions import PalaceValueError
-from palace.manager.opds.rwpm import Link
-from palace.manager.opds.types.link import CompactCollection
+from palace.opds.rwpm import Link
+from palace.opds.types.link import CompactCollection
+from palace.util.exceptions import PalaceValueError
 
 
 class AuthenticationLabels(BaseModel):