Release Notes

This page provides links to release artifacts for each version of zLMDB.

For detailed changelog entries, see Changelog.

25.12.2

Release Date: 2025-12-12

Release Type: Stable release

Release Artifacts

Binary wheels are available for the following platforms:

Platform Support Matrix

Platform	Python	Arch	Wheel
Linux	CPython 3.11	x86_64	zlmdb-25.12.2-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Linux	CPython 3.11	ARM64	zlmdb-25.12.2-cp311-cp311-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl
Linux	CPython 3.12	x86_64	zlmdb-25.12.2-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Linux	CPython 3.12	ARM64	zlmdb-25.12.2-cp312-cp312-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl
Linux	CPython 3.13	x86_64	zlmdb-25.12.2-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Linux	CPython 3.13	ARM64	zlmdb-25.12.2-cp313-cp313-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl
Linux	CPython 3.14	x86_64	zlmdb-25.12.2-cp314-cp314-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Linux	CPython 3.14t	ARM64	zlmdb-25.12.2-cp314-cp314t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl
Linux	PyPy 3.11	x86_64	zlmdb-25.12.2-pp311-pypy311_pp73-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Linux	PyPy 3.11	ARM64	zlmdb-25.12.2-pp311-pypy311_pp73-manylinux_2_34_aarch64.whl
macOS	CPython 3.11	ARM64	zlmdb-25.12.2-cp311-cp311-macosx_15_0_arm64.whl
macOS	CPython 3.12	ARM64	zlmdb-25.12.2-cp312-cp312-macosx_15_0_arm64.whl
macOS	CPython 3.13	ARM64	zlmdb-25.12.2-cp313-cp313-macosx_15_0_arm64.whl
macOS	CPython 3.14	ARM64	zlmdb-25.12.2-cp314-cp314-macosx_15_0_arm64.whl
macOS	PyPy 3.11	ARM64	zlmdb-25.12.2-pp311-pypy311_pp73-macosx_15_0_arm64.whl
Windows	CPython 3.11	x86_64	zlmdb-25.12.2-cp311-cp311-win_amd64.whl
Windows	CPython 3.12	x86_64	zlmdb-25.12.2-cp312-cp312-win_amd64.whl
Windows	CPython 3.13	x86_64	zlmdb-25.12.2-cp313-cp313-win_amd64.whl
Windows	CPython 3.14	x86_64	zlmdb-25.12.2-cp314-cp314-win_amd64.whl

Source distribution: zlmdb-25.12.2.tar.gz

Release Links

• GitHub Release

• PyPI Package

• Documentation

Detailed Changes: See Changelog (25.12.2 section)

25.12.1

• GitHub Release

• PyPI Package

• Documentation

25.10.2

• GitHub Release

• PyPI Package

• Documentation

25.10.1

• GitHub Release

• PyPI Package

• Documentation

23.1.1

• GitHub Release

• PyPI Package

• Documentation

22.6.1

• GitHub Release

• PyPI Package

22.5.1

• GitHub Release

• PyPI Package

22.4.1

• GitHub Release

• PyPI Package

22.3.1

• GitHub Release

• PyPI Package

22.2.1

• GitHub Release

• PyPI Package

22.1.2

• GitHub Release

• PyPI Package

22.1.1

• GitHub Release

• PyPI Package

---

Release Workflow (for Maintainers)

This section documents the release process for maintainers.

Prerequisites

Before releasing, ensure you have:

• Push access to the repository

• PyPI credentials configured (or trusted publishing via GitHub Actions)

• just and uv installed

Step 1: Draft the Release

Generate changelog and release note templates:

# Generate changelog entry from git history (for catching up)
just prepare-changelog <version>

# Generate release draft with templates for both files
just draft-release <version>

This will:

• Add a changelog entry template to docs/changelog.rst

• Add a release entry template to docs/releases.rst

• Update the version in pyproject.toml

Step 2: Edit Changelog

Edit docs/changelog.rst and fill in the changelog details:

• New: New features and capabilities

• Fix: Bug fixes

• Other: Breaking changes, deprecations, other notes

Step 3: Validate the Release

Ensure everything is in place:

just prepare-release <version>

This validates:

• Changelog entry exists for this version

• Release entry exists for this version

• Version in pyproject.toml matches

• All tests pass

• Documentation builds successfully

Step 4: Disable Git Hooks (if needed)

git config core.hooksPath /dev/null
git config core.hooksPath

Step 5: Commit and Tag

git add docs/changelog.rst docs/releases.rst pyproject.toml
git commit -m "Release <version>"
git tag v<version>
git push && git push --tags

Step 6: Enable Git Hooks (if previously disabled)

git config core.hooksPath .ai/.githooks
git config core.hooksPath

Step 7: Automated Release

After pushing the tag:

1. GitHub Actions builds and tests the release

2. Wheels and source distributions are uploaded to GitHub Releases

3. PyPI publishing is triggered via trusted publishing (OIDC)

4. Read the Docs builds documentation for the tagged version

Manual PyPI Upload (if needed)

If automated publishing fails:

just download-github-release v<version>
just publish-pypi "" v<version>