Mark Aspire.Hosting.Python as experimental (#6340)

Fixes #6298

Author: sebastienros

src/Aspire.Hosting.Python/Directory.Build.props

@@ -0,0 +1,9 @@
+<Project>
+    <PropertyGroup>
+      <!-- This needs to be set to true before importing parent Directory.Build.props -->
+      <!-- In preview until the public API is validated. -->
+      <SuppressFinalPackageVersion>true</SuppressFinalPackageVersion>
+    </PropertyGroup>
+  
+    <Import Project="$([MSBuild]::GetPathOfFileAbove('Directory.Build.props', '$(MSBuildThisFileDirectory)../'))" />
+  </Project>

src/Aspire.Hosting.Python/PythonAppResource.cs

@@ -8,7 +8,7 @@
 namespace Aspire.Hosting.Python;
 
 /// <summary>
-/// A resource that represents a python executible or app.
+/// A resource that represents a python executable or app.
 /// </summary>
 /// <param name="name">The name of the resource.</param>
 /// <param name="executablePath">The path to the executable used to run the python app.</param>
@@ -18,4 +18,4 @@ public class PythonAppResource(string name, string executablePath, string projec
 {
     private static string ThrowIfNull([NotNull] string? argument, [CallerArgumentExpression(nameof(argument))] string? paramName = null)
         => argument ?? throw new ArgumentNullException(paramName);
-}
+}

src/Aspire.Hosting.Python/PythonAppResourceBuilderExtensions.cs

@@ -44,8 +44,8 @@ public static class PythonAppResourceBuilderExtensions
     /// </para>
     /// </remarks>
     /// <example>
-    /// Add a python app or executible to the application model. In this example the python code entry point is located in the <c>PythonProject</c> directory
-    /// if this path is relative then it is assumed to be relative to the AppHost directory, and the virtual enviroment path if relative
+    /// Add a python app or executable to the application model. In this example the python code entry point is located in the <c>PythonProject</c> directory
+    /// if this path is relative then it is assumed to be relative to the AppHost directory, and the virtual environment path if relative
     /// is relative to the project directory. In the example below, if the app host directory is <c>$HOME/repos/MyApp/src/MyApp.AppHost</c> then
     /// the ProjectPath would be <c>$HOME/repos/MyApp/src/MyApp.AppHost/PythonProject</c> and the virtual environment path (defaulted) would
     /// be <c>$HOME/repos/MyApp/src/MyApp.AppHost/PythonProject/.venv</c>.
@@ -93,8 +93,8 @@ public static IResourceBuilder<PythonAppResource> AddPythonApp(
     /// </para>
     /// </remarks>
     /// <example>
-    /// Add a python app or executible to the application model. In this example the python code is located in the <c>PythonProject</c> directory
-    /// if this path is relative then it is assumed to be relative to the AppHost directory, and the virtual enviroment path if relative
+    /// Add a python app or executable to the application model. In this example the python code is located in the <c>PythonProject</c> directory
+    /// if this path is relative then it is assumed to be relative to the AppHost directory, and the virtual environment path if relative
     /// is relative to the project directory. In the example below, if the app host directory is <c>$HOME/repos/MyApp/src/MyApp.AppHost</c> then
     /// the ProjectPath would be <c>$HOME/repos/MyApp/src/MyApp.AppHost/PythonProject</c> and the virtual environment path (defaulted) would
     /// be <c>$HOME/repos/MyApp/src/MyApp.AppHost/PythonProject/.venv</c>.
@@ -177,4 +177,4 @@ private static void AddOpenTelemetryArguments(CommandLineArgsCallbackContext con
         context.Args.Add("--metrics_exporter");
         context.Args.Add("otlp");
     }
-}
+}

src/Aspire.Hosting.Python/PythonProjectResourceBuilderExtensions.cs

@@ -46,7 +46,7 @@ public static class PythonProjectResourceBuilderExtensions
     /// </remarks>
     /// <example>
     /// Add a python project to the application model. In this example the project is located in the <c>PythonProject</c> directory
-    /// if this path is relative then it is assumed to be relative to the AppHost directory, and the virtual enviroment path if relative
+    /// if this path is relative then it is assumed to be relative to the AppHost directory, and the virtual environment path if relative
     /// is relative to the project directory. In the example below, if the app host directory is <c>$HOME/repos/MyApp/src/MyApp.AppHost</c> then
     /// the ProjectPath would be <c>$HOME/repos/MyApp/src/MyApp.AppHost/PythonProject</c> and the virtual environment path (defaulted) would
     /// be <c>$HOME/repos/MyApp/src/MyApp.AppHost/PythonProject/.venv</c>.
@@ -96,7 +96,7 @@ public static IResourceBuilder<PythonProjectResource> AddPythonProject(
     /// </remarks>
     /// <example>
     /// Add a python project to the application model. In this example the project is located in the <c>PythonProject</c> directory
-    /// if this path is relative then it is assumed to be relative to the AppHost directory, and the virtual enviroment path if relative
+    /// if this path is relative then it is assumed to be relative to the AppHost directory, and the virtual environment path if relative
     /// is relative to the project directory. In the example below, if the app host directory is <c>$HOME/repos/MyApp/src/MyApp.AppHost</c> then
     /// the ProjectPath would be <c>$HOME/repos/MyApp/src/MyApp.AppHost/PythonProject</c> and the virtual environment path (defaulted) would
     /// be <c>$HOME/repos/MyApp/src/MyApp.AppHost/PythonProject/.venv</c>.