python · serhiy-storchaka · Mar 31, 2024 · Mar 31, 2024 · May 20, 2026 · May 20, 2026
diff --git a/Doc/library/bz2.rst b/Doc/library/bz2.rst
@@ -307,6 +307,31 @@ One-shot (de)compression
    .. versionchanged:: 3.3
       Support for multi-stream inputs was added.
 
+
+Miscellaneous
+-------------
+
+Information about the version of the bzip2 compression library in use
+is available through the following constants:
+
+
+.. data:: BZLIB_VERSION
+
+   The version string of the bzip2 compression library.
+
+   .. versionadded:: next
+
+
+.. data:: bzlib_version
+
+   A named tuple containing the three components of the bzip2 compression
+   library version: *major*, *minor*, and *patch*.  All values are integers.
+   The components can also be accessed by name, so ``bz2.bzlib_version[0]``
+   is equivalent to ``bz2.bzlib_version.major`` and so on.
+
+   .. versionadded:: next
+
+
 .. _bz2-usage-examples:
 
 Examples of usage

diff --git a/Doc/library/lzma.rst b/Doc/library/lzma.rst
@@ -335,6 +335,48 @@ Miscellaneous
    feature set.
 
 
+Information about the version of the lzma library in use is available through
+the following constants:
+
+
+.. data:: LZMA_VERSION
+
+   The version string of the lzma library that was used for building the module.
+   This may be different from the lzma library actually used at runtime, which
+   is available as :const:`LZMA_RUNTIME_VERSION`.
+
+   .. versionadded:: next
+
+
+.. data:: LZMA_RUNTIME_VERSION
+
+   The version string of the lzma library actually loaded by the interpreter.
+
+   .. versionadded:: next
+
+
+.. data:: lzma_version
+
+   A named tuple containing the four components of the lzma library
+   version that was used for building the module:
+   *major*, *minor*, *patch*, and *stability*.
+   All values except *stability* are integers; *stability* is ``'alpha'``,
+   ``'beta'``, or ``'stable'``.
+   The components can also be accessed by name, so ``lzma.lzma_version[0]``
+   is equivalent to ``lzma.lzma_version.major`` and so on.
+   This may be different from the lzma library actually used at runtime, which
+   is available as :const:`lzma_runtime_version`.
+
+   .. versionadded:: next
+
+
+.. data:: lzma_runtime_version
+
+   A named tuple containing the lzma library version actually loaded by the interpreter.
+
+   .. versionadded:: next
+
+
 .. _filter-chain-specs:
 
 Specifying custom filter chains

@@ -489,17 +489,63 @@ the following constants:
    .. versionadded:: 3.3
 
 
+.. data:: zlib_version
+
+   A named tuple containing the four components of the zlib library
+   version that was used for building the module:
+   *major*, *minor*, *revision*, and *subversion*.
+   All values are integers.
+   The components can also be accessed by name, so ``zlib.zlib_version[0]``
+   is equivalent to ``zlib.zlib_version.major`` and so on.
+   This may be different from the zlib library actually used at runtime, which
+   is available as :const:`zlib_runtime_version`.
+
+   .. versionadded:: next
+
+
+.. data:: zlib_runtime_version
+
+   A named tuple containing the zlib library version actually loaded by the interpreter.
+
+   .. versionadded:: next
+
+
+The following constants are only present if zlib-ng was used to build
+the module:
+
+
 .. data:: ZLIBNG_VERSION
 
    The version string of the zlib-ng library that was used for building the
    module if zlib-ng was used. When present, the :data:`ZLIB_VERSION` and
    :data:`ZLIB_RUNTIME_VERSION` constants reflect the version of the zlib API
    provided by zlib-ng.
 
-   If zlib-ng was not used to build the module, this constant will be absent.
-
    .. versionadded:: 3.14
 
+.. data:: ZLIBNG_RUNTIME_VERSION
+
+   The version string of the zlib-ng library actually loaded
+   by the interpreter.
+
+   .. versionadded:: next
+
+
+.. data:: zlibng_version
+
+   A named tuple containing the version of the zlib-ng library that was
+   used for building the module if zlib-ng was used.
+
+   .. versionadded:: next
+
+
+.. data:: zlibng_runtime_version
+
+   A named tuple containing the zlib-ng library version actually loaded
+   by the interpreter.
+
+   .. versionadded:: next
+
 
 .. seealso::
 

diff --git a/Lib/bz2.py b/Lib/bz2.py
@@ -5,7 +5,7 @@
 """
 
 __all__ = ["BZ2File", "BZ2Compressor", "BZ2Decompressor",
-           "open", "compress", "decompress"]
+           "open", "compress", "decompress", "BZLIB_VERSION", "bzlib_version"]
 
 __author__ = "Nadeem Vawda <[email protected]>"
 
@@ -14,7 +14,7 @@
 import io
 import os
 
-from _bz2 import BZ2Compressor, BZ2Decompressor
+from _bz2 import BZ2Compressor, BZ2Decompressor, BZLIB_VERSION, bzlib_version
 
 
 # Value 0 no longer used

diff --git a/Lib/lzma.py b/Lib/lzma.py
@@ -19,6 +19,7 @@
 
     "LZMACompressor", "LZMADecompressor", "LZMAFile", "LZMAError",
     "open", "compress", "decompress", "is_check_supported",
+    "LZMA_VERSION", "lzma_version", "LZMA_RUNTIME_VERSION", "lzma_runtime_version",
 ]
 
 import builtins

diff --git a/Lib/test/test_bz2.py b/Lib/test/test_bz2.py
@@ -1207,6 +1207,31 @@ def test_newline(self):
             self.assertEqual(f.readlines(), [text])
 
 
+class MiscTests(unittest.TestCase):
+
+    def test_bzlib_version(self):
+        if support.verbose:
+            print(f'BZLIB_VERSION = {bz2.BZLIB_VERSION}', flush=True)
+            print(f'bzlib_version = {bz2.bzlib_version}', flush=True)
+        v = bz2.bzlib_version
+        self.assertIsInstance(v[:], tuple)
+        self.assertEqual(len(v), 3)
+        self.assertIsInstance(v[0], int)
+        self.assertIsInstance(v[1], int)
+        self.assertIsInstance(v[2], int)
+        self.assertIsInstance(v.major, int)
+        self.assertIsInstance(v.minor, int)
+        self.assertIsInstance(v.patch, int)
+        self.assertEqual(v[0], v.major)
+        self.assertEqual(v[1], v.minor)
+        self.assertEqual(v[2], v.patch)
+        self.assertGreaterEqual(v.major, 0)
+        self.assertGreaterEqual(v.minor, 0)
+        self.assertGreaterEqual(v.patch, 0)
+
+        self.assertEqual(bz2.BZLIB_VERSION.split(',')[0], '%d.%d.%d' % v)
+
+
 def tearDownModule():
     support.reap_children()
 

diff --git a/Lib/test/test_lzma.py b/Lib/test/test_lzma.py
@@ -1507,6 +1507,43 @@ def test_x_mode(self):
 
 class MiscellaneousTestCase(unittest.TestCase):
 
+    def _test_lzma_version(self, v, string):
+        self.assertIsInstance(v[:], tuple)
+        self.assertEqual(len(v), 4)
+        self.assertIsInstance(v[0], int)
+        self.assertIsInstance(v[1], int)
+        self.assertIsInstance(v[2], int)
+        self.assertIsInstance(v[3], str)
+        self.assertIsInstance(v.major, int)
+        self.assertIsInstance(v.minor, int)
+        self.assertIsInstance(v.patch, int)
+        self.assertIsInstance(v.stability, str)
+        self.assertEqual(v[0], v.major)
+        self.assertEqual(v[1], v.minor)
+        self.assertEqual(v[2], v.patch)
+        self.assertEqual(v[3], v.stability)
+        self.assertGreaterEqual(v.major, 0)
+        self.assertGreaterEqual(v.minor, 0)
+        self.assertGreaterEqual(v.patch, 0)
+        self.assertIn(v.stability, {'alpha', 'beta', 'stable'})
+
+        if v.stability == 'stable':
+            self.assertEqual(string, '%d.%d.%d' % v[:3])
+        else:
+            self.assertTrue(string.startswith('%d.%d.%d%s' % v))
+
+    def test_lzma_version(self):
+        if support.verbose:
+            print(f'LZMA_VERSION = {lzma.LZMA_VERSION}', flush=True)
+            print(f'lzma_version = {lzma.lzma_version}', flush=True)
+        self._test_lzma_version(lzma.lzma_version, lzma.LZMA_VERSION)
+
+    def test_lzma_runtime_version(self):
+        if support.verbose:
+            print(f'LZMA_RUNTIME_VERSION = {lzma.LZMA_RUNTIME_VERSION}', flush=True)
+            print(f'lzma_runtime_version = {lzma.lzma_runtime_version}', flush=True)
+        self._test_lzma_version(lzma.lzma_runtime_version, lzma.LZMA_RUNTIME_VERSION)
+
     def test_is_check_supported(self):
         # CHECK_NONE and CHECK_CRC32 should always be supported,
         # regardless of the options liblzma was compiled with.

@@ -19,20 +19,17 @@
         'requires Decompress.copy()')
 
 
-def _zlib_runtime_version_tuple(zlib_version=zlib.ZLIB_RUNTIME_VERSION):
+def _parse_version(version):
     # Register "1.2.3" as "1.2.3.0"
     # or "1.2.0-linux","1.2.0.f","1.2.0.f-linux"
-    v = zlib_version.split('-', 1)[0].split('.')
-    if len(v) < 4:
+    v = version.split('-', 1)[0].split('.')
+    if not v[-1].isnumeric():
+        v.pop()
+    while len(v) < 4:
         v.append('0')
-    elif not v[-1].isnumeric():
-        v[-1] = '0'
     return tuple(map(int, v))
 
 
-ZLIB_RUNTIME_VERSION_TUPLE = _zlib_runtime_version_tuple()
-
-
 # bpo-46623: When a hardware accelerator is used (currently only on s390x),
 # using different ways to compress data with zlib can produce different
 # compressed data.
@@ -72,6 +69,61 @@ def test_library_version(self):
         # was compiled), and the API is stable between minor versions, so
         # testing only the major versions avoids spurious failures.
         self.assertEqual(zlib.ZLIB_RUNTIME_VERSION[0], zlib.ZLIB_VERSION[0])
+        self.assertEqual(zlib.zlib_runtime_version[0], zlib.zlib_version[0])
+        if hasattr(zlib, 'ZLIBNG_VERSION'):
+            self.assertEqual(zlib.zlibng_runtime_version[0], zlib.zlibng_version[0])
+
+    def _test_zlib_version(self, v):
+        self.assertIsInstance(v[:], tuple)
+        self.assertEqual(len(v), 4)
+        self.assertIsInstance(v[0], int)
+        self.assertIsInstance(v[1], int)
+        self.assertIsInstance(v[2], int)
+        self.assertIsInstance(v[3], int)
+        self.assertIsInstance(v.major, int)
+        self.assertIsInstance(v.minor, int)
+        self.assertIsInstance(v.revision, int)
+        self.assertIsInstance(v.subversion, int)
+        self.assertEqual(v[0], v.major)
+        self.assertEqual(v[1], v.minor)
+        self.assertEqual(v[2], v.revision)
+        self.assertEqual(v[3], v.subversion)
+        self.assertGreaterEqual(v.major, 0)
+        self.assertGreaterEqual(v.minor, 0)
+        self.assertGreaterEqual(v.revision, 0)
+        self.assertGreaterEqual(v.subversion, 0)
+
+    def test_zlib_version(self):
+        if support.verbose:
+            print(f'ZLIB_VERSION = {zlib.ZLIB_VERSION}', flush=True)
+            print(f'zlib_version = {zlib.zlib_version}', flush=True)
+        self._test_zlib_version(zlib.zlib_version)
+        self.assertEqual(zlib.zlib_version, _parse_version(zlib.ZLIB_VERSION))
+
+    def test_zlib_runtime_version(self):
+        if support.verbose:
+            print(f'ZLIB_RUNTIME_VERSION = {zlib.ZLIB_RUNTIME_VERSION}', flush=True)
+            print(f'zlib_runtime_version = {zlib.zlib_runtime_version}', flush=True)
+        self._test_zlib_version(zlib.zlib_runtime_version)
+        self.assertEqual(zlib.zlib_runtime_version,
+                         _parse_version(zlib.ZLIB_RUNTIME_VERSION))
+
+    @unittest.skipUnless(hasattr(zlib, 'ZLIBNG_VERSION'), 'requires zlib-ng')
+    def test_zlibng_version(self):
+        if support.verbose:
+            print(f'ZLIB_VERSION = {zlib.ZLIBNG_VERSION}', flush=True)
+            print(f'zlib_version = {zlib.zlibng_version}', flush=True)
+        self._test_zlib_version(zlib.zlibng_version)
+        self.assertEqual(zlib.zlibng_version, _parse_version(zlib.ZLIBNG_VERSION))
+
+    @unittest.skipUnless(hasattr(zlib, 'ZLIBNG_VERSION'), 'requires zlib-ng')
+    def test_zlibng_runtime_version(self):
+        if support.verbose:
+            print(f'ZLIB_RUNTIME_VERSION = {zlib.ZLIBNG_RUNTIME_VERSION}', flush=True)
+            print(f'zlib_runtime_version = {zlib.zlibng_runtime_version}', flush=True)
+        self._test_zlib_version(zlib.zlibng_runtime_version)
+        self.assertEqual(zlib.zlibng_runtime_version,
+                         _parse_version(zlib.ZLIBNG_RUNTIME_VERSION))
 
 
 class ChecksumTestCase(unittest.TestCase):
@@ -604,7 +656,7 @@ def test_flushes(self):
                     'Z_PARTIAL_FLUSH']
 
         # Z_BLOCK has a known failure prior to 1.2.5.3
-        if ZLIB_RUNTIME_VERSION_TUPLE >= (1, 2, 5, 3):
+        if zlib.zlib_version >= (1, 2, 5, 3):
             sync_opt.append('Z_BLOCK')
 
         sync_opt = [getattr(zlib, opt) for opt in sync_opt
@@ -918,7 +970,7 @@ def test_large_unconsumed_tail(self, size):
 
     def test_wbits(self):
         # wbits=0 only supported since zlib v1.2.3.5
-        supports_wbits_0 = ZLIB_RUNTIME_VERSION_TUPLE >= (1, 2, 3, 5)
+        supports_wbits_0 = zlib.zlib_version >= (1, 2, 3, 5)
 
         co = zlib.compressobj(level=1, wbits=15)
         zlib15 = co.compress(HAMLET_SCENE) + co.flush()