Skip to content

Commit 5e4f7e0

Browse files
committed
docs: add changelog and release notes for v25.12.2
Add documentation for the 25.12.2 release including: - Changelog entry with Build & CI/CD, FlatBuffers, and Other sections - Release notes with highlights, artifact verification links, and release links - Add missing changelog Sphinx label for cross-references Note: This work was completed with AI assistance (Claude Code).
1 parent e97953b commit 5e4f7e0

2 files changed

Lines changed: 83 additions & 0 deletions

File tree

docs/changelog.rst

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,36 @@
11
:tocdepth: 1
22

3+
.. _changelog:
4+
35
Changelog
46
=========
57

8+
25.12.2
9+
-------
10+
11+
**Build & CI/CD**
12+
13+
* Synchronize CI/CD, FlatBuffers vendoring, and wamp-ai/wamp-cicd submodules between autobahn-python and zlmdb (#1822)
14+
* Switch manylinux container from 2_34 to 2_28 for x86_64 ISA compatibility (fixes auditwheel flatc bundling)
15+
* Increase ARM64 build timeout to 60 minutes for QEMU emulation
16+
* Add .github/workflows/README.md documenting CI/CD architecture
17+
* Consolidate download-github-release and download-release-artifacts recipes
18+
* Add checksum verification to artifact download workflow
19+
20+
**FlatBuffers**
21+
22+
* Simplify vendored FlatBuffers - use upstream as-is
23+
* Track vendored FlatBuffers in git (like zlmdb approach)
24+
* Add version() function to vendored FlatBuffers runtime
25+
* Add check_zlmdb_flatbuffers_version_in_sync() for cross-project compatibility
26+
* Generate .bfbs files for WAMP schemas during wheel build
27+
28+
**Other**
29+
30+
* Rename install-flatc to install-flatc-system with prominent warning
31+
* Remove legacy readthedocs.yml to activate .readthedocs.yaml
32+
* Remove dev-latest optional dependency (PyPI rejects direct URLs)
33+
634
25.12.1
735
-------
836

docs/release-notes.rst

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,61 @@ Release Notes
88
This page provides a high-level overview of important changes in each release.
99
For detailed technical changes, see the :ref:`changelog <changelog>`.
1010

11+
25.12.2 (2025-12-15)
12+
--------------------
13+
14+
**Release Type:** Stable release
15+
16+
**Source Build:** `master-202512150317 <https://github.com/crossbario/autobahn-python/releases/tag/master-202512150317>`__
17+
18+
Highlights
19+
^^^^^^^^^^
20+
21+
This release synchronizes the CI/CD infrastructure and FlatBuffers vendoring
22+
between autobahn-python and zlmdb, ensuring consistent behavior for applications
23+
using both libraries (like Crossbar.io).
24+
25+
Key changes:
26+
27+
* **manylinux compatibility fix**: Switched from manylinux_2_34 to manylinux_2_28
28+
containers to avoid x86_64_v2 ISA requirements that caused auditwheel failures
29+
when bundling the flatc compiler.
30+
31+
* **FlatBuffers version sync**: Added ``check_zlmdb_flatbuffers_version_in_sync()``
32+
function to verify autobahn and zlmdb use compatible FlatBuffers runtimes.
33+
34+
* **Improved release workflow**: Consolidated artifact download recipes with
35+
checksum verification for supply chain security.
36+
37+
Artifact Verification
38+
^^^^^^^^^^^^^^^^^^^^^
39+
40+
All release artifacts include SHA256 checksums for integrity verification.
41+
42+
* `wheels-CHECKSUMS.sha256 <https://github.com/crossbario/autobahn-python/releases/download/master-202512150317/wheels-CHECKSUMS.sha256>`__
43+
* `docker-CHECKSUMS.sha256 <https://github.com/crossbario/autobahn-python/releases/download/master-202512150317/docker-CHECKSUMS.sha256>`__
44+
* `arm64-CHECKSUMS.sha256 <https://github.com/crossbario/autobahn-python/releases/download/master-202512150317/arm64-CHECKSUMS.sha256>`__
45+
46+
To verify a downloaded artifact:
47+
48+
.. code-block:: bash
49+
50+
# Download checksum file
51+
curl -LO https://github.com/crossbario/autobahn-python/releases/download/master-202512150317/wheels-CHECKSUMS.sha256
52+
53+
# Verify a wheel (example)
54+
openssl sha256 autobahn-25.12.2-cp311-cp311-manylinux_2_28_x86_64.whl
55+
# Compare output with corresponding line in CHECKSUMS file
56+
57+
Release Links
58+
^^^^^^^^^^^^^
59+
60+
* `GitHub Release <https://github.com/crossbario/autobahn-python/releases/tag/v25.12.2>`__
61+
* `PyPI Package <https://pypi.org/project/autobahn/25.12.2/>`__
62+
* `Documentation <https://autobahn.readthedocs.io/en/v25.12.2/>`__
63+
64+
**Detailed Changes:** See :ref:`changelog` (25.12.2 section)
65+
1166
25.12.1 (2025-12-10)
1267
--------------------
1368

0 commit comments

Comments
 (0)