Adding public API test coverage for Aspire.Hosting.Python

src/Aspire.Hosting.Python/PythonProjectResourceBuilderExtensions.cs

@@ -60,6 +60,8 @@ public static class PythonProjectResourceBuilderExtensions
     public static IResourceBuilder<PythonProjectResource> AddPythonProject(
         this IDistributedApplicationBuilder builder, string name, string projectDirectory, string scriptPath, params string[] scriptArgs)
     {
+        ArgumentNullException.ThrowIfNull(builder);
+
         return builder.AddPythonProject(name, projectDirectory, scriptPath, ".venv", scriptArgs);
     }
 
@@ -108,7 +110,12 @@ public static IResourceBuilder<PythonProjectResource> AddPythonProject(
         this IDistributedApplicationBuilder builder, string name, string projectDirectory, string scriptPath,
         string virtualEnvironmentPath, params string[] scriptArgs)
     {
+        ArgumentNullException.ThrowIfNull(builder);
+        ArgumentNullException.ThrowIfNull(name);
+        ArgumentNullException.ThrowIfNull(projectDirectory);
+        ArgumentNullException.ThrowIfNull(scriptPath);
         ArgumentNullException.ThrowIfNull(virtualEnvironmentPath);
+        ArgumentNullException.ThrowIfNull(scriptArgs);
 
         projectDirectory = PathNormalizer.NormalizePathForCurrentPlatform(Path.Combine(builder.AppHostDirectory, projectDirectory));
         var virtualEnvironment = new VirtualEnvironment(Path.IsPathRooted(virtualEnvironmentPath)

tests/Aspire.Hosting.Python.Tests/PythonPublicApiTests.cs

@@ -0,0 +1,277 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using Xunit;
+
+namespace Aspire.Hosting.Python.Tests;
+
+public class PythonPublicApiTests
+{
+    #region PythonProjectResource
+
+    [Fact]
+    public void CtorPythonProjectResourceShouldThrowWhenNameIsNull()
+    {
+        string name = null!;
+        const string executablePath = "/src/python";
+        const string projectDirectory = "/data/python";
+
+        var action = () => new PythonProjectResource(name, executablePath, projectDirectory);
+
+        var exception = Assert.Throws<ArgumentNullException>(action);
+        Assert.Equal(nameof(name), exception.ParamName);
+    }
+
+    [Fact]
+    public void CtorPythonProjectResourceShouldThrowWhenExecutablePathIsNull()
+    {
+        const string name = "Python";
+        string executablePath = null!;
+        const string projectDirectory = "/data/python";
+
+        var action = () => new PythonProjectResource(name, executablePath, projectDirectory);
+
+        var exception = Assert.Throws<ArgumentNullException>(action);
+        Assert.Equal("command", exception.ParamName);
+    }
+
+    [Fact]
+    public void CtorPythonProjectResourceShouldThrowWhenProjectDirectoryIsNull()
+    {
+        const string name = "Python";
+        const string executablePath = "/src/python";
+        string projectDirectory = null!;
+
+        var action = () => new PythonProjectResource(name, executablePath, projectDirectory);
+
+        var exception = Assert.Throws<ArgumentNullException>(action);
+        Assert.Equal("workingDirectory", exception.ParamName);
+    }
+
+    #endregion
+
+    #region PythonProjectResourceBuilderExtensions
+
+    [Fact]
+    public void AddPythonProjectShouldThrowWhenBuilderIsNull()
+    {
+        IDistributedApplicationBuilder builder = null!;
+        const string name = "Python";
+        const string projectDirectory = "/src/python";
+        const string scriptPath = "scripts";
+        string[] scriptArgs = ["--traces"];
+
+        var action = () => builder.AddPythonProject(
+            name,
+            projectDirectory,
+            scriptPath,
+            scriptArgs);
+
+        var exception = Assert.Throws<ArgumentNullException>(action);
+        Assert.Equal(nameof(builder), exception.ParamName);
+    }
+
+    [Fact]
+    public void AddPythonProjectShouldThrowWhenNameIsNull()
+    {
+        var builder = DistributedApplication.CreateBuilder();
+        string name = null!;
+        const string projectDirectory = "/src/python";
+        const string scriptPath = "scripts";
+        string[] scriptArgs = ["--traces"];
+
+        var action = () => builder.AddPythonProject(
+            name,
+            projectDirectory,
+            scriptPath,
+            scriptArgs);
+
+        var exception = Assert.Throws<ArgumentNullException>(action);
+        Assert.Equal(nameof(name), exception.ParamName);
+    }
+
+    [Fact]
+    public void AddPythonProjectShouldThrowWhenProjectDirectoryIsNull()
+    {
+        var builder = DistributedApplication.CreateBuilder();
+        const string name = "Python";
+        string projectDirectory = null!;
+        const string scriptPath = "scripts";
+        string[] scriptArgs = ["--traces"];
+
+        var action = () => builder.AddPythonProject(
+            name,
+            projectDirectory,
+            scriptPath,
+            scriptArgs);
+
+        var exception = Assert.Throws<ArgumentNullException>(action);
+        Assert.Equal(nameof(projectDirectory), exception.ParamName);
+    }
+
+    [Fact]
+    public void AddPythonProjectShouldThrowWhenScriptPathIsNull()
+    {
+        var builder = DistributedApplication.CreateBuilder();
+        const string name = "Python";
+        const string projectDirectory = "/src/python";
+        string scriptPath = null!;
+        string[] scriptArgs = ["--traces"];
+
+        var action = () => builder.AddPythonProject(
+            name,
+            projectDirectory,
+            scriptPath,
+            scriptArgs);
+
+        var exception = Assert.Throws<ArgumentNullException>(action);
+        Assert.Equal(nameof(scriptPath), exception.ParamName);
+    }
+
+    [Fact]
+    public void AddPythonProjectShouldThrowWhenScriptArgsIsNull()
+    {
+        var builder = DistributedApplication.CreateBuilder();
+        const string name = "Python";
+        const string projectDirectory = "/src/python";
+        const string scriptPath = "scripts";
+        string[] scriptArgs = null!;
+
+        var action = () => builder.AddPythonProject(
+            name,
+            projectDirectory,
+            scriptPath,
+            scriptArgs);
+
+        var exception = Assert.Throws<ArgumentNullException>(action);
+        Assert.Equal(nameof(scriptArgs), exception.ParamName);
+    }
+
+    [Fact]
+    public void AddPythonProjectWithVirtualEnvironmentPathShouldThrowWhenBuilderIsNull()
+    {
+        IDistributedApplicationBuilder builder = null!;
+        const string name = "Python";
+        const string projectDirectory = "/src/python";
+        const string scriptPath = "scripts";
+        var virtualEnvironmentPath = ".venv";
+        string[] scriptArgs = ["--traces"]; ;
+
+        var action = () => builder.AddPythonProject(
+            name,
+            projectDirectory,
+            scriptPath,
+            virtualEnvironmentPath,
+            scriptArgs);
+
+        var exception = Assert.Throws<ArgumentNullException>(action);
+        Assert.Equal(nameof(builder), exception.ParamName);
+    }
+
+    [Fact]
+    public void AddPythonProjectWithVirtualEnvironmentPathShouldThrowWhenNameIsNull()
+    {
+        var builder = DistributedApplication.CreateBuilder();
+        string name = null!;
+        const string projectDirectory = "/src/python";
+        const string scriptPath = "scripts";
+        const string virtualEnvironmentPath = ".venv";
+        string[] scriptArgs = ["--traces"]; ;
+
+        var action = () => builder.AddPythonProject(
+            name,
+            projectDirectory,
+            scriptPath,
+            virtualEnvironmentPath,
+            scriptArgs);
+
+        var exception = Assert.Throws<ArgumentNullException>(action);
+        Assert.Equal(nameof(name), exception.ParamName);
+    }
+
+    [Fact]
+    public void AddPythonProjectWithVirtualEnvironmentPathShouldThrowWhenProjectDirectoryIsNull()
+    {
+        var builder = DistributedApplication.CreateBuilder();
+        const string name = "Python";
+        string projectDirectory = null!;
+        const string scriptPath = "scripts";
+        const string virtualEnvironmentPath = ".venv";
+        string[] scriptArgs = ["--traces"]; ;
+
+        var action = () => builder.AddPythonProject(
+            name,
+            projectDirectory,
+            scriptPath,
+            virtualEnvironmentPath,
+            scriptArgs);
+
+        var exception = Assert.Throws<ArgumentNullException>(action);
+        Assert.Equal(nameof(projectDirectory), exception.ParamName);
+    }
+
+    [Fact]
+    public void AddPythonProjectWithVirtualEnvironmentPathShouldThrowWhenScriptPathIsNull()
+    {
+        var builder = DistributedApplication.CreateBuilder();
+        const string name = "Python";
+        const string projectDirectory = "/src/python";
+        string scriptPath = null!;
+        const string virtualEnvironmentPath = ".venv";
+        string[] scriptArgs = ["--traces"]; ;
+
+        var action = () => builder.AddPythonProject(
+            name,
+            projectDirectory,
+            scriptPath,
+            virtualEnvironmentPath,
+            scriptArgs);
+
+        var exception = Assert.Throws<ArgumentNullException>(action);
+        Assert.Equal(nameof(scriptPath), exception.ParamName);
+    }
+
+    [Fact]
+    public void AddPythonProjectWithVirtualEnvironmentPathShouldThrowWhenVirtualEnvironmentPathIsNull()
+    {
+        var builder = DistributedApplication.CreateBuilder();
+        const string name = "Python";
+        const string projectDirectory = "/src/python";
+        const string scriptPath = "scripts";
+        string virtualEnvironmentPath = null!;
+        string[] scriptArgs = ["--traces"]; ;
+
+        var action = () => builder.AddPythonProject(
+            name,
+            projectDirectory,
+            scriptPath,
+            virtualEnvironmentPath,
+            scriptArgs);
+
+        var exception = Assert.Throws<ArgumentNullException>(action);
+        Assert.Equal(nameof(virtualEnvironmentPath), exception.ParamName);
+    }
+
+    [Fact]
+    public void AddPythonProjectWithVirtualEnvironmentPathShouldThrowWhenScriptArgsIsNull()
+    {
+        var builder = DistributedApplication.CreateBuilder();
+        const string name = "Python";
+        const string projectDirectory = "/src/python";
+        const string scriptPath = "scripts";
+        const string virtualEnvironmentPath = ".venv";
+        string[] scriptArgs = null!;
+
+        var action = () => builder.AddPythonProject(
+            name,
+            projectDirectory,
+            scriptPath,
+            virtualEnvironmentPath,
+            scriptArgs);
+
+        var exception = Assert.Throws<ArgumentNullException>(action);
+        Assert.Equal(nameof(scriptArgs), exception.ParamName);
+    }
+
+    #endregion
+}