Add platform schema

Author: theory

schema/v2/platform.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://pgxn.org/meta/v2/platform.schema.json",
+  "title": "Platform",
+  "description": "A *Platform* identifies a computing platform as a one to three dash-delimited substrings: An OS name, the OS version, and the architecture: `$os-$version-$architecture`.\n\nIf the string contains no dash, it represents only the OS. If it contains a single dash, the first value represents the OS and second value is a version if it starts with an integer followed by a dot and the architecture if it does not start with a digit.",
+  "type": "string",
+  "pattern": "^(?:(any)|([a-zA-Z][a-zA-Z0-9]+)(?:-(?:0|[1-9]\\d*)[.][^\\s-]+[^-\\s]*)?(?:-([a-zA-Z0-9]+))?)$",
+  "$comment": "https://regex101.com/r/vJv9cK",
+  "examples": [
+    "any",
+    "linux",
+    "gnulinux",
+    "musllinux",
+    "linux-amd64",
+    "gnulinux-amd64",
+    "musllinux-1.2",
+    "musllinux-1.2-arm64",
+    "darwin",
+    "darwin-arm64",
+    "darwin-23.5.0",
+    "darwin-23.5.0-arm64"
+  ]
+}

tests/v2_schema_test.rs

@@ -280,3 +280,87 @@ fn test_v2_purl() -> Result<(), Box<dyn Error>> {
     }
     Ok(())
 }
+
+#[test]
+fn test_v2_platform() -> Result<(), Box<dyn Error>> {
+    // Load the schemas and compile the semver schema.
+    let mut compiler = new_compiler("schema/v2")?;
+    let mut schemas = Schemas::new();
+    let id = id_for(SCHEMA_VERSION, "platform");
+    let idx = compiler.compile(&id, &mut schemas)?;
+
+    // Test valid relative platforms.
+    for os in [
+        "any",
+        "linux",
+        "darwin",
+        "freebsd",
+        "openbsd",
+        "android",
+        "dragonfly",
+        "illumos",
+        "ios",
+        "js",
+        "netbsd",
+        "plan9",
+        "solaris",
+        "wasip1",
+        "windows",
+    ] {
+        let platform = json!(os);
+        if let Err(e) = schemas.validate(&platform, idx) {
+            panic!("path pattern {} failed: {e}", platform);
+        }
+
+        let architectures = [
+            "386", "amd64", "arm", "arm64", "loong64", "mips", "mips64", "mips64le", "mipsle",
+            "ppc64", "ppc64le", "riscv64", "s390x", "sparc64", "wasm", "ppc64", "arm64", "amd64",
+        ];
+
+        for arch in architectures {
+            let platform = json!(format!("{os}-{arch}"));
+            if let Err(e) = schemas.validate(&platform, idx) {
+                panic!("path pattern {} failed: {e}", platform);
+            }
+        }
+
+        for version in [
+            VALID_SEMVERS,
+            &["1.0", "3.2.5", "2.1+beta", "3.14", "16.beta1", "17.+foo"],
+        ]
+        .concat()
+        {
+            if version.contains('-') {
+                continue;
+            }
+            let platform = json!(format!("{os}-{version}"));
+            if let Err(e) = schemas.validate(&platform, idx) {
+                panic!("path pattern {} failed: {e}", platform);
+            }
+
+            for arch in architectures {
+                let platform = json!(format!("{os}-{version}-{arch}"));
+                if let Err(e) = schemas.validate(&platform, idx) {
+                    panic!("path pattern {} failed: {e}", platform);
+                }
+            }
+        }
+    }
+
+    // Test invalid platforms.
+    for invalid_platform in [
+        json!("darwin amd64"),
+        json!("linux/amd64"),
+        json!("darwin_23.5.0_arm64"),
+        json!(null),
+        json!("0"),
+        json!(0),
+        json!("\n\t"),
+        json!("()"),
+    ] {
+        if schemas.validate(&invalid_platform, idx).is_ok() {
+            panic!("{} unexpectedly passed!", invalid_platform)
+        }
+    }
+    Ok(())
+}