Add a setting to manually specify wheel tags

Signed-off-by: Cristian Le <[email protected]>

Author: LecrisUT

README.md

@@ -260,6 +260,12 @@ wheel.exclude = []
 # The build tag to use for the wheel. If empty, no build tag is used.
 wheel.build-tag = ""
 
+# Manually specify the wheel tags to use, ignoring other inputs such as
+# ``wheel.py-api``. Each tag must be of the format
+# {interpreter}-{abi}-{platform}. If not specified, these tags are automatically
+# calculated.
+wheel.tags = []
+
 # If CMake is less than this value, backport a copy of FindPython. Set to 0
 # disable this, or the empty string.
 backport.find-python = "3.26.1"

src/scikit_build_core/build/wheel.py

@@ -10,6 +10,7 @@
 from typing import TYPE_CHECKING, Any, Literal
 
 from packaging.requirements import Requirement
+from packaging.tags import Tag
 from packaging.utils import canonicalize_name
 
 from .._compat import tomllib
@@ -260,6 +261,10 @@ def _build_wheel_impl_impl(
         f"{{red}}({state})",
     )
 
+    override_wheel_tags = None
+    if settings.wheel.tags:
+        override_wheel_tags = {Tag(*tag.split("-")) for tag in settings.wheel.tags}
+
     with tempfile.TemporaryDirectory() as tmpdir:
         build_tmp_folder = Path(tmpdir)
         wheel_dir = build_tmp_folder / "wheel"
@@ -364,7 +369,7 @@ def _build_wheel_impl_impl(
             wheel = WheelWriter(
                 metadata,
                 Path(metadata_directory),
-                tags.as_tags_set(),
+                override_wheel_tags or tags.as_tags_set(),
                 WheelMetadata(
                     root_is_purelib=targetlib == "purelib",
                     build_tag=settings.wheel.build_tag,
@@ -480,7 +485,7 @@ def _build_wheel_impl_impl(
         with WheelWriter(
             metadata,
             Path(wheel_directory),
-            tags.as_tags_set(),
+            override_wheel_tags or tags.as_tags_set(),
             WheelMetadata(
                 root_is_purelib=targetlib == "purelib",
                 build_tag=settings.wheel.build_tag,

src/scikit_build_core/resources/scikit-build.schema.json

@@ -243,6 +243,13 @@
           "type": "string",
           "default": "",
           "description": "The build tag to use for the wheel. If empty, no build tag is used."
+        },
+        "tags": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Manually specify the wheel tags to use, ignoring other inputs such as ``wheel.py-api``. Each tag must be of the format {interpreter}-{abi}-{platform}. If not specified, these tags are automatically calculated."
         }
       }
     },
@@ -570,6 +577,9 @@
                   },
                   "exclude": {
                     "$ref": "#/$defs/inherit"
+                  },
+                  "tags": {
+                    "$ref": "#/$defs/inherit"
                   }
                 }
               },

src/scikit_build_core/settings/skbuild_model.py

@@ -244,6 +244,13 @@ class WheelSettings:
     The build tag to use for the wheel. If empty, no build tag is used.
     """
 
+    tags: List[str] = dataclasses.field(default_factory=list)
+    """
+    Manually specify the wheel tags to use, ignoring other inputs such as
+    ``wheel.py-api``. Each tag must be of the format {interpreter}-{abi}-{platform}.
+    If not specified, these tags are automatically calculated.
+    """
+
 
 @dataclasses.dataclass
 class BackportSettings: