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-utilshould be able to add it to theirpyproject.tomlwithout 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).
Metadata
Release files for palace-util 48.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| palace_util-48.1.0.tar.gz | 6.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| palace_util-48.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 13.0 kB
Release files / palace_util-48.1.0.tar.gz
| Download URL | palace_util-48.1.0.tar.gz |
|---|---|
| Size | 6.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9bf0b3fce6ebe92b7b5d38903ed829fd12b87948e9a41c15a8b7efaa1454158f
|
|
BLAKE2b-256 checksum How to use checksums |
f031b4d87b50be72a6f60d4dfc2a78d140c7a0f414d17f39b9a003f3376ed8d2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 29, 2026.
Transparency logRelease files / palace_util-48.1.0-py3-none-any.whl
| Download URL | palace_util-48.1.0-py3-none-any.whl |
|---|---|
| Size | 7.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
722db9cc58e14f5d2c237e9f6b0851a3e5433dedb545a706c5588ffa1033881f
|
|
BLAKE2b-256 checksum How to use checksums |
560b5a1ab3b1e2cc2eac289cdb127f66cce2074cfdf7f24565ceff97e037a1b6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 29, 2026.
Transparency log
