Change: adding wildcard support to CPE Part; unrequire product, vendor (#1099)

y0urself · web-flow · commit 2926d37c80f9 · 2025-03-07T12:42:10.000+01:00
* Change: adding wildcard support to CPE Part; unrequire product

* Change: unrequire vendor
diff --git a/pontos/cpe/_cpe.py b/pontos/cpe/_cpe.py
@@ -36,6 +36,7 @@ class Part(StrEnum):
     APPLICATION = "a"
     OPERATING_SYSTEM = "o"
     HARDWARE_DEVICE = "h"
+    WILDCARD = "*"  # wildcard for requesting "all" possible cpe parts
 
 
 def is_uri_binding(cpe: str) -> bool:
@@ -427,8 +428,8 @@ class CPEWellFormed:
     """
 
     part: Part
-    vendor: str
-    product: str
+    vendor: Optional[str] = None
+    product: Optional[str] = None
     version: Optional[str] = None
     update: Optional[str] = None
     edition: Optional[str] = None
@@ -495,8 +496,8 @@ def __init__(
         *,
         cpe_string: Optional[str] = None,
         part: Part,
-        vendor: str,
-        product: str,
+        vendor: Optional[str] = None,
+        product: Optional[str] = None,
         version: Optional[str] = None,
         update: Optional[str] = None,
         edition: Optional[str] = None,
diff --git a/tests/cpe/test_cpe.py b/tests/cpe/test_cpe.py
@@ -456,6 +456,22 @@ def test_uri_unbind_examples(self):
         self.assertIsNone(cpe.target_hw)
         self.assertIsNone(cpe.other)
 
+        # example 7a
+        cpe = CPE.from_string("cpe:2.3:*:Microsoft")
+        self.assertFalse(cpe.is_uri_binding())
+        self.assertTrue(cpe.is_formatted_string_binding())
+        self.assertEqual(cpe.part, Part.WILDCARD)
+        self.assertEqual(cpe.vendor, "microsoft")
+        self.assertIsNone(cpe.product)
+        self.assertIsNone(cpe.version)
+        self.assertIsNone(cpe.update)
+        self.assertIsNone(cpe.language)
+        self.assertIsNone(cpe.edition)
+        self.assertIsNone(cpe.sw_edition)
+        self.assertIsNone(cpe.target_sw)
+        self.assertIsNone(cpe.target_hw)
+        self.assertIsNone(cpe.other)
+
         # example 8
         with self.assertRaisesRegex(
             CPEParsingError,
