(GH-538) Move DscRepoSchema into dsc-lib-jsonschema

Prior to this change, types in `dsc-lib` depended on the`DscRepoSchema`
trait defined in the same crate for generating the set of recognized
schema URIs and validating them.

This change migrates this JSON Schema specific code into the
`dsc-lib-jsonschema` crate for better organization and reuse, since
this is actually required for any schema published from the DSC
repository, even if those crates don't depend on `dsc-lib`.

This migration also takes advantage of some improvements in code
organization for compilation and testing, migrating the separate
related types, like `SchemaForm` and `SchemaUriPrefix`, into their
own private modules with the parent module re-exporting those types.

Finally, this migration also incorporates a build script, which
checks the git tags for the project to generate the variants for the
`RecognizedSchemaVersion` enum. Prior to this implementation, the
developers were required to manually update the enum definition prior
to every release.

This change does _not_ update any other crates to use the new
implementation. A separate, future change will modify the other crates.

Author: michaeltlombardi

Cargo.lock

@@ -1 +1 @@
-doc-valid-idents = ["IntelliSense", ".."]
+doc-valid-idents = ["IntelliSense", "PowerShell", ".."]

lib/dsc-lib-jsonschema/.clippy.toml

@@ -0,0 +1,16 @@
+{
+  "latestMajor": "V3",
+  "latestMinor": "V3_1",
+  "latestPatch": "V3_1_2",
+  "all": [
+    "V3",
+    "V3_1_2",
+    "V3_1_1",
+    "V3_1_0",
+    "V3_1",
+    "V3_0_2",
+    "V3_0_1",
+    "V3_0_0",
+    "V3_0"
+  ]
+}

lib/dsc-lib-jsonschema/.versions.json

@@ -0,0 +1,88 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
+<#
+    .SYNOPSIS
+    Generate the version info for the DSC project.
+
+    .DESCRIPTION
+    This script inspects the git tags for the project and uses them to construct data representing
+    those versions, saving it to `.versions.json` in the same directory as this script.
+
+    The data file contains every non-prerelease version tag as well as the latest major, minor, and
+    patch version releases.
+
+    The versions are saved as:
+
+    - `V<Major>`, like `V3`, for every major version number.
+    - `V<Major>_<Minor>`, like `V3_1`, for every minor version number.
+    - `V<Major>_<Minor>_<Patch>`, like `V3_1_0`, for every non-prerelease version number.
+
+    This data is used by `build.rs` to generate the contents for the `RecognizedSchemaVersion`
+    enum type definition and trait implementations.
+#>
+
+[CmdletBinding()]
+param()
+
+begin {
+    function Get-DscProjectTagVersion {
+        [cmdletbinding()]
+        [OutputType([semver])]
+        param()
+
+        process {
+            $null = git fetch --all --tags
+            git tag -l
+            | Where-Object -FilterScript {$_ -match '^v\d+(\.\d+){2}$' }
+            | ForEach-Object -Process { [semver]($_.Substring(1)) }
+        }
+    }
+
+    function Export-DscProjectTagVersion {
+        [cmdletbinding()]
+        param()
+
+        process {
+            $publishedVersions = Get-DscProjectTagVersion
+            | Sort-Object -Descending
+
+            [System.Collections.Generic.HashSet[string]]$majorVersions = @()
+            [System.Collections.Generic.HashSet[string]]$minorVersions = @()
+            [System.Collections.Generic.HashSet[string]]$patchVersions = @()
+
+            foreach ($version in $publishedVersions) {
+                $null = $majorVersions.Add("V$($version.Major)")
+                $null = $minorVersions.Add("V$($version.Major)_$($version.Minor)")
+                $null = $patchVersions.Add("V$($version.Major)_$($version.Minor)_$($version.Patch)")
+            }
+
+            $allVersions = @($majorVersions | Sort-Object -Descending) +
+                        @($minorVersions + $patchVersions | Sort-Object -Descending)
+
+            $data = [ordered]@{
+                latestMajor = $majorVersions | Sort-Object -Descending | Select-Object -First 1
+                latestMinor = $minorVersions | Sort-Object -Descending | Select-Object -First 1
+                latestPatch = $patchVersions | Sort-Object -Descending | Select-Object -First 1
+                all = $allVersions
+            }
+
+            $dataJson = $data
+            | ConvertTo-Json
+            | ForEach-Object -Process { $_ -replace "`r`n", "`n"}
+
+            $dataPath = Join-Path -Path $PSScriptRoot -ChildPath '.versions.json'
+            $dataContent = Get-Content -Raw -Path $dataPath
+
+            if ($dataJson.Trim() -ne $dataContent.Trim()) {
+                $dataJson | Set-Content -Path $PSScriptRoot/.versions.json
+            }
+
+            $dataJson
+        }
+    }
+}
+
+process {
+    Export-DscProjectTagVersion
+}

lib/dsc-lib-jsonschema/.versions.ps1

@@ -13,6 +13,7 @@ rust-i18n = { workspace = true }
 schemars = { workspace = true }
 serde = { workspace = true }
 serde_json = { workspace = true }
+thiserror = { workspace = true }
 tracing = { workspace = true }
 url = { workspace = true }
 urlencoding = { workspace = true }
@@ -21,5 +22,9 @@ urlencoding = { workspace = true }
 # Helps review complex comparisons, like schemas
 pretty_assertions = { workspace = true }
 
+[build-dependencies]
+serde = { workspace = true }
+serde_json = { workspace = true }
+
 [lints.clippy]
 pedantic = { level = "deny" }