gh-115988: Add missing ARM64 and RISCV filter in lzma module

Doc/library/lzma.rst

@@ -324,6 +324,27 @@ Miscellaneous
 
 .. _filter-chain-specs:
 
+
+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:: 3.13
+
+
+.. data:: LZMA_RUNTIME_VERSION
+
+   The version string of the lzma library actually loaded by the interpreter.
+
+   .. versionadded:: 3.13
+
+
 Specifying custom filter chains
 -------------------------------
 
@@ -343,12 +364,23 @@ options. Valid filter IDs are as follows:
 
 * Branch-Call-Jump (BCJ) filters:
 
-  * :const:`FILTER_X86`
-  * :const:`FILTER_IA64`
-  * :const:`FILTER_ARM`
-  * :const:`FILTER_ARMTHUMB`
-  * :const:`FILTER_POWERPC`
-  * :const:`FILTER_SPARC`
+  * :const:`!FILTER_X86`
+  * :const:`!FILTER_IA64`
+  * :const:`!FILTER_ARM`
+  * :const:`!FILTER_ARMTHUMB`
+  * :const:`!FILTER_POWERPC`
+  * :const:`!FILTER_SPARC`
+  * :const:`!FILTER_ARM64`
+
+    Only works if lzma runtime library version is 5.4.0 or later.
+
+    .. versionadded:: 3.13
+
+  * :const:`!FILTER_RISCV`
+
+    Only works if lzma runtime library version is 5.6.0 or later.
+
+    .. versionadded:: 3.13
 
 A filter chain can consist of up to 4 filters, and cannot be empty. The last
 filter in the chain must be a compression filter, and any other filters must be

Doc/whatsnew/3.13.rst

@@ -329,6 +329,20 @@
   than the specified batch size.
   (Contributed by Raymond Hettinger in :gh:`113202`.)
 
+lzma
+----
+
+* Add :const:`lzma.LZMA_VERSION` and :const:`lzma.LZMA_RUNTIME_VERSION`. The former
+  reports the version string of the underlying ``lzma`` library during build while
+  the later reports runtime version.
+  (Contributed by Chien Wong in :gh:`115988`.)
+
+* Add support of new BCJ filters ARM64 and RISC-V via :const:`lzma.FILTER_ARM64` and
+  :const:`lzma.FILTER_RISCV`.
+  Note that the new filters will work only if runtime library supports them. ARM64 filter
+  requires ``lzma`` 5.4.0 or newer while RISC-V requires 5.6.0 or newer.
+  (Contributed by Chien Wong in :gh:`115988`.)
+
 marshal
 -------
 

Lib/lzma.py

@@ -13,6 +13,7 @@
     "CHECK_ID_MAX", "CHECK_UNKNOWN",
     "FILTER_LZMA1", "FILTER_LZMA2", "FILTER_DELTA", "FILTER_X86", "FILTER_IA64",
     "FILTER_ARM", "FILTER_ARMTHUMB", "FILTER_POWERPC", "FILTER_SPARC",
+    "FILTER_ARM64", "FILTER_RISCV",
     "FORMAT_AUTO", "FORMAT_XZ", "FORMAT_ALONE", "FORMAT_RAW",
     "MF_HC3", "MF_HC4", "MF_BT2", "MF_BT3", "MF_BT4",
     "MODE_FAST", "MODE_NORMAL", "PRESET_DEFAULT", "PRESET_EXTREME",