add uv.lock support

docs/detectors/uv.md

@@ -0,0 +1,6 @@
+# uv Detection
+## Requirements
+[uv](https://docs.astral.sh/uv/) detection relies on a [uv.lock](https://docs.astral.sh/uv/concepts/projects/layout/#the-lockfile) file being present.
+
+## Detection strategy
+uv detection is performed by parsing a <em>uv.lock</em> found under the scan directory.

src/Microsoft.ComponentDetection.Detectors/uv/UvDependency.cs

@@ -0,0 +1,10 @@
+#nullable enable
+namespace Microsoft.ComponentDetection.Detectors.Uv
+{
+    public class UvDependency
+    {
+        public required string Name { get; init; }
+
+        public string? Specifier { get; set; }
+    }
+}

src/Microsoft.ComponentDetection.Detectors/uv/UvLock.cs

@@ -0,0 +1,144 @@
+#nullable enable
+namespace Microsoft.ComponentDetection.Detectors.Uv
+{
+    using System;
+    using System.Collections.Generic;
+    using System.IO;
+    using Tomlyn;
+    using Tomlyn.Model;
+
+    public class UvLock
+    {
+        // a list of packages with their dependencies
+        public List<UvPackage> Packages { get; set; } = [];
+
+        // static method to parse the TOML stream into a UvLock model
+        public static UvLock Parse(Stream tomlStream)
+        {
+            using var reader = new StreamReader(tomlStream);
+            var tomlContent = reader.ReadToEnd();
+            var model = Toml.ToModel(tomlContent);
+            return new UvLock
+            {
+                Packages = ParsePackagesFromModel(model),
+            };
+        }
+
+        internal static List<UvPackage> ParsePackagesFromModel(object? model)
+        {
+            if (model is not TomlTable table)
+            {
+                throw new InvalidOperationException("TOML root is not a table");
+            }
+
+            if (!table.TryGetValue("package", out var packagesObj) || packagesObj is not TomlTableArray packages)
+            {
+                return [];
+            }
+
+            var result = new List<UvPackage>();
+            foreach (var pkg in packages)
+            {
+                var parsed = ParsePackage(pkg);
+                if (parsed is not null)
+                {
+                    result.Add(parsed);
+                }
+            }
+
+            return result;
+        }
+
+        internal static UvPackage? ParsePackage(object? pkg)
+        {
+            if (pkg is not TomlTable pkgTable)
+            {
+                return null;
+            }
+
+            if (pkgTable.TryGetValue("name", out var nameObj) && nameObj is string name &&
+                pkgTable.TryGetValue("version", out var versionObj) && versionObj is string version)
+            {
+                var uvPackage = new UvPackage
+                {
+                    Name = name,
+                    Version = version,
+                    Dependencies = [],
+                    MetadataRequiresDist = [],
+                    MetadataRequiresDev = [],
+                };
+
+                if (pkgTable.TryGetValue("dependencies", out var depsObj) && depsObj is TomlArray depsArray)
+                {
+                    uvPackage.Dependencies = ParseDependenciesArray(depsArray);
+                }
+
+                if (pkgTable.TryGetValue("metadata", out var metadataObj) && metadataObj is TomlTable metadataTable)
+                {
+                    ParseMetadata(metadataTable, uvPackage);
+                }
+
+                // Parse source
+                if (pkgTable.TryGetValue("source", out var sourceObj) && sourceObj is TomlTable sourceTable)
+                {
+                    var source = new UvSource
+                    {
+                        Registry = sourceTable.TryGetValue("registry", out var regObj) && regObj is string reg ? reg : null,
+                        Virtual = sourceTable.TryGetValue("virtual", out var virtObj) && virtObj is string virt ? virt : null,
+                    };
+                    uvPackage.Source = source;
+                }
+
+                return uvPackage;
+            }
+
+            return null;
+        }
+
+        internal static List<UvDependency> ParseDependenciesArray(TomlArray? depsArray)
+        {
+            var deps = new List<UvDependency>();
+            if (depsArray is null)
+            {
+                return deps;
+            }
+
+            foreach (var dep in depsArray)
+            {
+                if (dep is TomlTable depTable &&
+                    depTable.TryGetValue("name", out var depNameObj) && depNameObj is string depName)
+                {
+                    var depSpec = depTable.TryGetValue("specifier", out var specObj) && specObj is string s ? s : null;
+                    deps.Add(new UvDependency
+                    {
+                        Name = depName,
+                        Specifier = depSpec,
+                    });
+                }
+            }
+
+            return deps;
+        }
+
+        internal static void ParseMetadata(TomlTable? metadataTable, UvPackage uvPackage)
+        {
+            if (metadataTable is null)
+            {
+                return;
+            }
+
+            if (metadataTable.TryGetValue("requires-dist", out var requiresDistObj) && requiresDistObj is TomlArray requiresDistArr)
+            {
+                uvPackage.MetadataRequiresDist = ParseDependenciesArray(requiresDistArr);
+            }
+
+            if (metadataTable.TryGetValue("requires-dev", out var requiresDevObj) && requiresDevObj is TomlTable requiresDevTable)
+            {
+                if (requiresDevTable.TryGetValue("dev", out var devObj) && devObj is TomlArray devArr)
+                {
+                    uvPackage.MetadataRequiresDev = ParseDependenciesArray(devArr);
+                }
+            }
+        }
+    }
+}

src/Microsoft.ComponentDetection.Detectors/uv/UvLockComponentDetector.cs

@@ -0,0 +1,101 @@
+namespace Microsoft.ComponentDetection.Detectors.Uv
+{
+    using System;
+    using System.Collections.Generic;
+    using System.Linq;
+    using System.Threading;
+    using System.Threading.Tasks;
+    using Microsoft.ComponentDetection.Contracts;
+    using Microsoft.ComponentDetection.Contracts.Internal;
+    using Microsoft.ComponentDetection.Contracts.TypedComponent;
+    using Microsoft.Extensions.Logging;
+
+    public class UvLockComponentDetector : FileComponentDetector, IDefaultOffComponentDetector
+    {
+        public UvLockComponentDetector(
+            IComponentStreamEnumerableFactory componentStreamEnumerableFactory,
+            IObservableDirectoryWalkerFactory walkerFactory,
+            ILogger<UvLockComponentDetector> logger)
+        {
+            this.ComponentStreamEnumerableFactory = componentStreamEnumerableFactory;
+            this.Scanner = walkerFactory;
+            this.Logger = logger;
+        }
+
+        public override string Id => "UvLock";
+
+        public override IList<string> SearchPatterns { get; } = ["uv.lock"];
+
+        public override IEnumerable<ComponentType> SupportedComponentTypes => [ComponentType.Pip];
+
+        public override int Version => 1;
+
+        public override IEnumerable<string> Categories => ["Python"];
+
+        internal static bool IsRootPackage(UvPackage pck)
+        {
+            return pck.Source?.Virtual != null;
+        }
+
+        protected override Task OnFileFoundAsync(ProcessRequest processRequest, IDictionary<string, string> detectorArgs, CancellationToken cancellationToken = default)
+        {
+            var singleFileComponentRecorder = processRequest.SingleFileComponentRecorder;
+            var file = processRequest.ComponentStream;
+
+            try
+            {
+                // Parse the file stream into a UvLock model
+                file.Stream.Position = 0; // Ensure stream is at the beginning
+                var uvLock = UvLock.Parse(file.Stream);
+
+                var rootPackage = uvLock.Packages.FirstOrDefault(IsRootPackage);
+
+                var explicitPackages = new HashSet<string>();
+                foreach (var dep in rootPackage.MetadataRequiresDist)
+                {
+                    explicitPackages.Add(dep.Name);
+                }
+
+                var devPackages = new HashSet<string>();
+                foreach (var devDep in rootPackage.MetadataRequiresDev)
+                {
+                    devPackages.Add(devDep.Name);
+                }
+
+                foreach (var pkg in uvLock.Packages)
+                {
+                    if (IsRootPackage(pkg))
+                    {
+                        continue;
+                    }
+
+                    var pipComponent = new PipComponent(pkg.Name, pkg.Version);
+                    var isExplicit = explicitPackages.Contains(pkg.Name);
+                    var isDev = devPackages.Contains(pkg.Name);
+                    var detectedComponent = new DetectedComponent(pipComponent);
+                    singleFileComponentRecorder.RegisterUsage(detectedComponent, isDevelopmentDependency: isDev, isExplicitReferencedDependency: isExplicit);
+
+                    foreach (var dep in pkg.Dependencies)
+                    {
+                        var depPkg = uvLock.Packages.FirstOrDefault(p => p.Name.Equals(dep.Name, StringComparison.OrdinalIgnoreCase));
+                        if (depPkg != null)
+                        {
+                            var depComponentWithVersion = new PipComponent(depPkg.Name, depPkg.Version);
+                            singleFileComponentRecorder.RegisterUsage(new DetectedComponent(depComponentWithVersion), parentComponentId: pipComponent.Id);
+                        }
+                        else
+                        {
+                            this.Logger.LogWarning("Dependency {DependencyName} not found in uv.lock packages", dep.Name);
+                        }
+                    }
+                }
+            }
+            catch (Exception ex)
+            {
+                this.Logger.LogError(ex, "Failed to parse uv.lock file {File}", file.Location);
+            }
+
+            return Task.CompletedTask;
+        }
+    }
+}

src/Microsoft.ComponentDetection.Detectors/uv/UvPackage.cs

@@ -0,0 +1,23 @@
+#nullable enable
+namespace Microsoft.ComponentDetection.Detectors.Uv
+{
+    using System.Collections.Generic;
+
+    public class UvPackage
+    {
+        public required string Name { get; init; }
+
+        public required string Version { get; init; }
+
+        public List<UvDependency> Dependencies { get; set; } = [];
+
+        // Metadata dependencies (requires-dist)
+        public List<UvDependency> MetadataRequiresDist { get; set; } = [];
+
+        // Metadata dev dependencies (requires-dev)
+        public List<UvDependency> MetadataRequiresDev { get; set; } = [];
+
+        // Source property for uv.lock
+        public UvSource? Source { get; set; }
+    }
+}

src/Microsoft.ComponentDetection.Detectors/uv/UvSource.cs

@@ -0,0 +1,11 @@
+#nullable enable
+
+namespace Microsoft.ComponentDetection.Detectors.Uv
+{
+    public class UvSource
+    {
+        public string? Registry { get; set; }
+
+        public string? Virtual { get; set; }
+    }
+}

src/Microsoft.ComponentDetection.Orchestrator/Experiments/Configs/UvLockDetectorExperiment.cs

@@ -0,0 +1,23 @@
+namespace Microsoft.ComponentDetection.Orchestrator.Experiments.Configs;
+
+using Microsoft.ComponentDetection.Contracts;
+using Microsoft.ComponentDetection.Detectors.Pip;
+using Microsoft.ComponentDetection.Detectors.Uv;
+
+/// <summary>
+/// Experiment to validate UvLockComponentDetector against PipComponentDetector.
+/// </summary>
+public class UvLockDetectorExperiment : IExperimentConfiguration
+{
+    /// <inheritdoc />
+    public string Name => "UvLockDetectorExperiment";
+
+    /// <inheritdoc />
+    public bool IsInControlGroup(IComponentDetector componentDetector) => componentDetector is PipComponentDetector;
+
+    /// <inheritdoc />
+    public bool IsInExperimentGroup(IComponentDetector componentDetector) => componentDetector is UvLockComponentDetector;
+
+    /// <inheritdoc />
+    public bool ShouldRecord(IComponentDetector componentDetector, int numComponents) => true;
+}

src/Microsoft.ComponentDetection.Orchestrator/Extensions/ServiceCollectionExtensions.cs

@@ -21,6 +21,7 @@ namespace Microsoft.ComponentDetection.Orchestrator.Extensions;
 using Microsoft.ComponentDetection.Detectors.Rust;
 using Microsoft.ComponentDetection.Detectors.Spdx;
 using Microsoft.ComponentDetection.Detectors.Swift;
+using Microsoft.ComponentDetection.Detectors.Uv;
 using Microsoft.ComponentDetection.Detectors.Vcpkg;
 using Microsoft.ComponentDetection.Detectors.Yarn;
 using Microsoft.ComponentDetection.Detectors.Yarn.Parsers;
@@ -67,6 +68,7 @@ public static IServiceCollection AddComponentDetection(this IServiceCollection s
         services.AddSingleton<IExperimentConfiguration, RustCliDetectorExperiment>();
         services.AddSingleton<IExperimentConfiguration, RustSbomVsCliExperiment>();
         services.AddSingleton<IExperimentConfiguration, RustSbomVsCrateExperiment>();
+        services.AddSingleton<IExperimentConfiguration, UvLockDetectorExperiment>();
 
         // Detectors
         // CocoaPods
@@ -152,6 +154,9 @@ public static IServiceCollection AddComponentDetection(this IServiceCollection s
         // Swift Package Manager
         services.AddSingleton<IComponentDetector, SwiftResolvedComponentDetector>();
 
+        // uv
+        services.AddSingleton<IComponentDetector, UvLockComponentDetector>();
+
         return services;
     }
 }