Add option to add an extra lib name tag to wheel's short hash

src/auditwheel/main_repair.py

@@ -2,6 +2,7 @@
 
 import argparse
 import logging
+import os
 from os.path import abspath, basename, exists, isfile
 
 from auditwheel.patcher import Patchelf
@@ -100,6 +101,12 @@ def configure_parser(sub_parsers):
         help="Do not check for higher policy compatibility",
         default=False,
     )
+    p.add_argument(
+        "--extra-lib-name-tag",
+        dest="EXTRA_LIB_NAME_TAG",
+        help="Extra, optional tag for copied library names",
+        default=os.environ.get("AUDITWHEEL_EXTRA_LIB_NAME_TAG", None),
+    )
     p.set_defaults(func=execute)
 
 
@@ -180,6 +187,7 @@ def execute(args, p):
             patcher=patcher,
             exclude=exclude,
             strip=args.STRIP,
+            extra_lib_name_tag=args.EXTRA_LIB_NAME_TAG,
         )
 
         if out_wheel is not None:

src/auditwheel/repair.py

@@ -42,6 +42,7 @@ def repair_wheel(
     patcher: ElfPatcher,
     exclude: frozenset[str],
     strip: bool = False,
+    extra_lib_name_tag: str | None = None,
 ) -> str | None:
     external_refs_by_fn = get_wheel_elfdata(wheel_policy, wheel_path, exclude)[1]
 
@@ -83,7 +84,9 @@ def repair_wheel(
 
                 if not exists(dest_dir):
                     os.mkdir(dest_dir)
-                new_soname, new_path = copylib(src_path, dest_dir, patcher)
+                new_soname, new_path = copylib(
+                    src_path, dest_dir, patcher, extra_lib_name_tag=extra_lib_name_tag
+                )
                 soname_map[soname] = (new_soname, new_path)
                 replacements.append((soname, new_soname))
             if replacements:
@@ -127,7 +130,12 @@ def strip_symbols(libraries: Iterable[str]) -> None:
         check_call(["strip", "-s", lib])
 
 
-def copylib(src_path: str, dest_dir: str, patcher: ElfPatcher) -> tuple[str, str]:
+def copylib(
+    src_path: str,
+    dest_dir: str,
+    patcher: ElfPatcher,
+    extra_lib_name_tag: str | None = None,
+) -> tuple[str, str]:
     """Graft a shared library from the system into the wheel and update the
     relevant links.
 
@@ -143,6 +151,9 @@ def copylib(src_path: str, dest_dir: str, patcher: ElfPatcher) -> tuple[str, str
     with open(src_path, "rb") as f:
         shorthash = hashfile(f)[:8]
 
+    if extra_lib_name_tag:
+        shorthash = f"{extra_lib_name_tag}-{shorthash}"
+
     src_name = os.path.basename(src_path)
     base, ext = src_name.split(".", 1)
     if not base.endswith("-%s" % shorthash):