Validate requirements format in hassfest (#55094)

Co-authored-by: Joakim Sørensen <joasoe@gmail.com>

script/hassfest/__main__.py

@@ -24,18 +24,19 @@ from . import (
 from .model import Config, Integration
 
 INTEGRATION_PLUGINS = [
-    json,
     codeowners,
     config_flow,
     dependencies,
+    dhcp,
+    json,
     manifest,
     mqtt,
+    requirements,
     services,
     ssdp,
     translations,
-    zeroconf,
-    dhcp,
     usb,
+    zeroconf,
 ]
 HASS_PLUGINS = [
     coverage,
@@ -103,9 +104,6 @@ def main():
 
     plugins = [*INTEGRATION_PLUGINS]
 
-    if config.requirements:
-        plugins.append(requirements)
-
     if config.specific_integrations:
         integrations = {}
 
@@ -122,7 +120,11 @@ def main():
         try:
             start = monotonic()
             print(f"Validating {plugin.__name__.split('.')[-1]}...", end="", flush=True)
-            if plugin is requirements and not config.specific_integrations:
+            if (
+                plugin is requirements
+                and config.requirements
+                and not config.specific_integrations
+            ):
                 print()
             plugin.validate(integrations, config)
             print(f" done in {monotonic() - start:.2f}s")

script/hassfest/requirements.py

@@ -9,6 +9,7 @@ import re
 import subprocess
 import sys
 
+from awesomeversion import AwesomeVersion, AwesomeVersionStrategy
 from stdlib_list import stdlib_list
 from tqdm import tqdm
 
@@ -61,6 +62,12 @@ def normalize_package_name(requirement: str) -> str:
 
 def validate(integrations: dict[str, Integration], config: Config):
     """Handle requirements for integrations."""
+    # Check if we are doing format-only validation.
+    if not config.requirements:
+        for integration in integrations.values():
+            validate_requirements_format(integration)
+        return
+
     ensure_cache()
 
     # check for incompatible requirements
@@ -74,8 +81,45 @@ def validate(integrations: dict[str, Integration], config: Config):
         validate_requirements(integration)
 
 
+def validate_requirements_format(integration: Integration) -> bool:
+    """Validate requirements format.
+
+    Returns if valid.
+    """
+    start_errors = len(integration.errors)
+
+    for req in integration.requirements:
+        if " " in req:
+            integration.add_error(
+                "requirements",
+                f'Requirement "{req}" contains a space',
+            )
+            continue
+
+        pkg, sep, version = req.partition("==")
+
+        if not sep and integration.core:
+            integration.add_error(
+                "requirements",
+                f'Requirement {req} need to be pinned "<pkg name>==<version>".',
+            )
+            continue
+
+        if AwesomeVersion(version).strategy == AwesomeVersionStrategy.UNKNOWN:
+            integration.add_error(
+                "requirements",
+                f"Unable to parse package version ({version}) for {pkg}.",
+            )
+            continue
+
+    return len(integration.errors) == start_errors
+
+
 def validate_requirements(integration: Integration):
     """Validate requirements."""
+    if not validate_requirements_format(integration):
+        return
+
     # Some integrations have not been fixed yet so are allowed to have violations.
     if integration.domain in IGNORE_VIOLATIONS:
         return