Restructure solution layout by module

2025-10-28 15:10:40 +02:00
parent 95daa159c4
commit d870da18ce
4103 changed files with 192899 additions and 187024 deletions
--- a/src/Scanner/__Tests/StellaOps.Scanner.Analyzers.Lang.Tests/Determinism/LanguageAnalyzerHarnessTests.cs
+++ b/src/Scanner/__Tests/StellaOps.Scanner.Analyzers.Lang.Tests/Determinism/LanguageAnalyzerHarnessTests.cs
@@ -0,0 +1,102 @@
+using StellaOps.Scanner.Analyzers.Lang;
+using StellaOps.Scanner.Analyzers.Lang.Tests.Harness;
+using StellaOps.Scanner.Analyzers.Lang.Tests.TestUtilities;
+
+namespace StellaOps.Scanner.Analyzers.Lang.Tests.Determinism;
+
+public sealed class LanguageAnalyzerHarnessTests
+{
+    [Fact]
+    public async Task HarnessProducesDeterministicOutputAsync()
+    {
+        var fixturePath = TestPaths.ResolveFixture("determinism", "basic", "input");
+        var goldenPath = TestPaths.ResolveFixture("determinism", "basic", "expected.json");
+        var cancellationToken = TestContext.Current.CancellationToken;
+
+        var analyzers = new ILanguageAnalyzer[]
+        {
+            new FakeLanguageAnalyzer(
+                "fake-java",
+                LanguageComponentRecord.FromPurl(
+                    analyzerId: "fake-java",
+                    purl: "pkg:maven/org.example/example-lib@1.2.3",
+                    name: "example-lib",
+                    version: "1.2.3",
+                    type: "maven",
+                    metadata: new Dictionary<string, string?>
+                    {
+                        ["groupId"] = "org.example",
+                        ["artifactId"] = "example-lib",
+                    },
+                    evidence: new []
+                    {
+                        new LanguageComponentEvidence(LanguageEvidenceKind.File, "pom.properties", "META-INF/maven/org.example/example-lib/pom.properties", null, "abc123"),
+                    }),
+                LanguageComponentRecord.FromExplicitKey(
+                    analyzerId: "fake-java",
+                    componentKey: "bin::sha256:deadbeef",
+                    purl: null,
+                    name: "example-cli",
+                    version: null,
+                    type: "bin",
+                    metadata: new Dictionary<string, string?>
+                    {
+                        ["sha256"] = "deadbeef",
+                    },
+                    evidence: new []
+                    {
+                        new LanguageComponentEvidence(LanguageEvidenceKind.File, "binary", "usr/local/bin/example", null, "deadbeef"),
+                    })),
+            new FakeLanguageAnalyzer(
+                "fake-node",
+                LanguageComponentRecord.FromPurl(
+                    analyzerId: "fake-node",
+                    purl: "pkg:npm/example-package@4.5.6",
+                    name: "example-package",
+                    version: "4.5.6",
+                    type: "npm",
+                    metadata: new Dictionary<string, string?>
+                    {
+                        ["workspace"] = "packages/example",
+                    },
+                    evidence: new []
+                    {
+                        new LanguageComponentEvidence(LanguageEvidenceKind.File, "package.json", "packages/example/package.json", null, null),
+                    },
+                    usedByEntrypoint: true)),
+        };
+
+        await LanguageAnalyzerTestHarness.AssertDeterministicAsync(fixturePath, goldenPath, analyzers, cancellationToken);
+
+        var first = await LanguageAnalyzerTestHarness.RunToJsonAsync(fixturePath, analyzers, cancellationToken);
+        var second = await LanguageAnalyzerTestHarness.RunToJsonAsync(fixturePath, analyzers, cancellationToken);
+        Assert.Equal(first, second);
+    }
+
+    private sealed class FakeLanguageAnalyzer : ILanguageAnalyzer
+    {
+        private readonly IReadOnlyList<LanguageComponentRecord> _components;
+
+        public FakeLanguageAnalyzer(string id, params LanguageComponentRecord[] components)
+        {
+            Id = id;
+            DisplayName = id;
+            _components = components ?? Array.Empty<LanguageComponentRecord>();
+        }
+
+        public string Id { get; }
+
+        public string DisplayName { get; }
+
+        public async ValueTask AnalyzeAsync(LanguageAnalyzerContext context, LanguageComponentWriter writer, CancellationToken cancellationToken)
+        {
+            await Task.Delay(5, cancellationToken).ConfigureAwait(false); // ensure asynchrony is handled
+
+            // Intentionally add in reverse order to prove determinism.
+            foreach (var component in _components.Reverse())
+            {
+                writer.Add(component);
+            }
+        }
+    }
+}