feat: PEP 794 support

Signed-off-by: Henry Schreiner <[email protected]>

Author: henryiii

pyproject_metadata/__init__.py

@@ -271,6 +271,8 @@ class StandardMetadata:
     keywords: list[str] = dataclasses.field(default_factory=list)
     scripts: dict[str, str] = dataclasses.field(default_factory=dict)
     gui_scripts: dict[str, str] = dataclasses.field(default_factory=dict)
+    import_names: list[str] = dataclasses.field(default_factory=list)
+    import_namespaces: list[str] = dataclasses.field(default_factory=list)
     dynamic: list[Dynamic] = dataclasses.field(default_factory=list)
     """
     This field is used to track dynamic fields. You can't set a field not in this list.
@@ -460,6 +462,14 @@ def from_pyproject(  # noqa: C901
                     project.get("gui-scripts", {}), "project.gui-scripts"
                 )
                 or {},
+                import_names=pyproject.ensure_list(
+                    project.get("import-names", []), "project.import-names"
+                )
+                or [],
+                import_namespaces=pyproject.ensure_list(
+                    project.get("import-namespaces", []), "project.import-namespaces"
+                )
+                or [],
                 dynamic=dynamic,
                 dynamic_metadata=dynamic_metadata or [],
                 metadata_version=metadata_version,
@@ -504,6 +514,7 @@ def validate(self, *, warn: bool = True) -> None:  # noqa: C901
         - ``license`` is an SPDX license expression if metadata_version >= 2.4
         - ``license_files`` is supported only for metadata_version >= 2.4
         - ``project_url`` can't contain keys over 32 characters
+        - ``import-names(paces)`` is only supported on metadata_version >= 2.5
         """
         errors = ErrorCollector(collect_errors=self.all_errors)
 
@@ -570,6 +581,20 @@ def validate(self, *, warn: bool = True) -> None:  # noqa: C901
                 msg = "{key} names cannot be more than 32 characters long"
                 errors.config_error(msg, key="project.urls", got=name)
 
+        if (
+            self.import_names
+            and self.auto_metadata_version in constants.PRE_2_5_METADATA_VERSIONS
+        ):
+            msg = "{key} is only supported when emitting metadata version >= 2.5"
+            errors.config_error(msg, key="project.import_names")
+
+        if (
+            self.import_namespaces
+            and self.auto_metadata_version in constants.PRE_2_5_METADATA_VERSIONS
+        ):
+            msg = "{key} is only supported when emitting metadata version >= 2.5"
+            errors.config_error(msg, key="project.import_namespaces")
+
         errors.finalize("Metadata validation failed")
 
     def _write_metadata(  # noqa: C901
@@ -637,6 +662,10 @@ def _write_metadata(  # noqa: C901
             if self.readme.content_type:
                 smart_message["Description-Content-Type"] = self.readme.content_type
             smart_message.set_payload(self.readme.text)
+        for import_name in self.import_names:
+            smart_message["Import-Name"] = import_name
+        for import_namespace in self.import_namespaces:
+            smart_message["Import-Namespace"] = import_namespace
         # Core Metadata 2.2
         if self.auto_metadata_version != "2.1":
             for field in self.dynamic_metadata:

pyproject_metadata/constants.py

@@ -24,8 +24,9 @@ def __dir__() -> list[str]:
     return __all__
 
 
-KNOWN_METADATA_VERSIONS = {"2.1", "2.2", "2.3", "2.4"}
+KNOWN_METADATA_VERSIONS = {"2.1", "2.2", "2.3", "2.4", "2.5"}
 PRE_SPDX_METADATA_VERSIONS = {"2.1", "2.2", "2.3"}
+PRE_2_5_METADATA_VERSIONS = {"2.1", "2.2", "2.3", "2.4"}
 
 PROJECT_TO_METADATA = {
     "authors": frozenset(["Author", "Author-Email"]),
@@ -46,6 +47,8 @@ def __dir__() -> list[str]:
     "scripts": frozenset(),
     "urls": frozenset(["Project-URL"]),
     "version": frozenset(["Version"]),
+    "import-names": frozenset(["Import-Name"]),
+    "import-namespaces": frozenset(["Import-Namespaces"]),
 }
 
 KNOWN_TOPLEVEL_FIELDS = {"build-system", "project", "tool", "dependency-groups"}
@@ -83,6 +86,8 @@ def __dir__() -> list[str]:
     "summary",
     "supported-platform",  # Not specified via pyproject standards
     "version",  # Can't be in dynamic
+    "import-name",
+    "import-namespace",
 }
 
 KNOWN_MULTIUSE = {
@@ -100,4 +105,6 @@ def __dir__() -> list[str]:
     "requires",  # Deprecated
     "obsoletes",  # Deprecated
     "provides",  # Deprecated
+    "import-name",
+    "import-namespace",
 }

pyproject_metadata/project_table.py

@@ -68,6 +68,8 @@ class LicenseTable(TypedDict, total=False):
     "scripts",
     "urls",
     "version",
+    "import-names",
+    "import-namespaces",
 ]
 
 ProjectTable = TypedDict(
@@ -90,6 +92,8 @@ class LicenseTable(TypedDict, total=False):
         "keywords": List[str],
         "scripts": Dict[str, str],
         "gui-scripts": Dict[str, str],
+        "import-names": List[str],
+        "import-namespaces": List[str],
         "dynamic": List[Dynamic],
     },
     total=False,