palace-util

Small, dependency-light utilities shared across Palace Project Python packages. Lives in the palace.util namespace.

This package exists so that the handful of cross-cutting helpers that every Palace package needs — a common exception hierarchy, timezone-aware datetime handling, a standardized LoggerMixin — can be depended on without pulling in the heavier palace-manager application. Packages that need only these primitives depend on palace-util directly; palace-manager is also just a consumer.

Scope

palace-util sits at the bottom of the Palace dependency graph: other Palace packages depend on palace-util; palace-util depends on no other Palace package.

If a utility is only useful inside the Palace Manager application, it does not belong here — keep it in src/palace/manager/util/. Candidates for palace-util should be:

Reusable outside the manager application (e.g., by other Palace services, CLI tools, or by future extracted packages like palace-opds).
Runtime-dependency-light — stdlib-only is the ideal, and in the rare case a third-party library is justified it must be tiny and widely-used. Consumers of palace-util should be able to add it to their pyproject.toml without materially growing their install footprint.
No intra-Palace dependencies.
Stable enough that the wider ecosystem can rely on it without expecting frequent breaking changes.

Development

This package is a uv workspace member of the main circulation repository. Work on it from the repo root — uv sync picks up all workspace members automatically; tox -e py312-docker runs the full test suite. Tests for this package live at the repository root under tests/palace_util/ (workspace-member tests are kept under the root tests/ tree so they share the repo's pytest fixtures and conftest plugins).

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

palace_util-45.3.0.tar.gz (6.0 kB view details)

Uploaded Aug 19, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

palace_util-45.3.0-py3-none-any.whl (7.0 kB view details)

Uploaded Aug 19, 2026 Python 3

File details

Details for the file palace_util-45.3.0.tar.gz.

File metadata

Download URL: palace_util-45.3.0.tar.gz
Upload date: Aug 19, 2026
Size: 6.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for palace_util-45.3.0.tar.gz
Algorithm	Hash digest
SHA256	`b88fdf1a4f861613670dd7f228101998dd29aa353056e725da771b456dc7a063`
MD5	`a295f939502f385211626f6c1f4a4685`
BLAKE2b-256	`12f6dc1510457eb5b66270c480dbcf8b0e174af35574816799a8f59ee7148488`

See more details on using hashes here.

Provenance

The following attestation bundles were made for palace_util-45.3.0.tar.gz:

Publisher: publish-pypi.yml on ThePalaceProject/circulation

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: palace_util-45.3.0.tar.gz
- Subject digest: b88fdf1a4f861613670dd7f228101998dd29aa353056e725da771b456dc7a063
- Sigstore transparency entry: 2510824549
- Sigstore integration time: Aug 19, 2026
Source repository:
- Permalink: ThePalaceProject/circulation@02ed105f0774452c15fc2bae9dee3d1d989dac1f
- Branch / Tag: refs/tags/v45.3.0
- Owner: https://github.com/ThePalaceProject
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-pypi.yml@02ed105f0774452c15fc2bae9dee3d1d989dac1f
- Trigger Event: release