Add Poetry package manager support for Python

src/Aspire.Hosting.Python/PoetryEnvironmentAnnotation.cs

@@ -0,0 +1,18 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using Aspire.Hosting.ApplicationModel;
+
+namespace Aspire.Hosting.Python;
+
+/// <summary>
+/// Represents environment variables to be set for Poetry operations.
+/// </summary>
+/// <param name="environmentVariables">The environment variables to set for Poetry.</param>
+internal sealed class PoetryEnvironmentAnnotation(IReadOnlyDictionary<string, string> environmentVariables) : IResourceAnnotation
+{
+    /// <summary>
+    /// Gets the environment variables to be set for Poetry operations.
+    /// </summary>
+    public IReadOnlyDictionary<string, string> EnvironmentVariables { get; } = environmentVariables;
+}

src/Aspire.Hosting.Python/PoetryInstallationManager.cs

@@ -0,0 +1,46 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using Aspire.Hosting.Utils;
+using Microsoft.Extensions.Logging;
+
+namespace Aspire.Hosting.Python;
+
+/// <summary>
+/// Validates that the poetry command is available on the system.
+/// </summary>
+#pragma warning disable ASPIREINTERACTION001 // Type is for evaluation purposes only and is subject to change or removal in future updates. Suppress this diagnostic to proceed.
+internal sealed class PoetryInstallationManager : RequiredCommandValidator
+{
+    private string? _resolvedCommandPath;
+
+    public PoetryInstallationManager(
+        IInteractionService interactionService,
+        ILogger<PoetryInstallationManager> logger)
+        : base(interactionService, logger)
+    {
+    }
+
+    /// <summary>
+    /// Ensures poetry is installed/available. This method is safe for concurrent callers;
+    /// only one validation will run at a time.
+    /// </summary>
+    /// <param name="throwOnFailure">Whether to throw an exception if poetry is not found. Default is true.</param>
+    /// <param name="cancellationToken">Cancellation token.</param>
+    public Task EnsureInstalledAsync(bool throwOnFailure = true, CancellationToken cancellationToken = default)
+    {
+        SetThrowOnFailure(throwOnFailure);
+        return RunAsync(cancellationToken);
+    }
+
+    protected override string GetCommandPath() => "poetry";
+
+    protected override Task OnValidatedAsync(string resolvedCommandPath, CancellationToken cancellationToken)
+    {
+        _resolvedCommandPath = resolvedCommandPath;
+        return Task.CompletedTask;
+    }
+
+    protected override string? GetHelpLink() => "https://python-poetry.org/docs/#installation";
+}
+#pragma warning restore ASPIREINTERACTION001