V5.6.0 (#93)

* v5.6.0
- *Enhancement:* The `RunAsync` methods updated to support `ValueTask` as well as `Task` for the `TypeTester` and `GenericTester` (.NET 9+ only).
- *Enhancement:* Added `HttpResultAssertor` for ASP.NET Minimal APIs `Results` (e.g. `Results.Ok()`, `Results.NotFound()`, etc.) to enable assertions via the `ToHttpResponseMessageAssertor`.
- *Enhancement:* `TesterBase`, `GenericTester` and `TypeTester` updated to support keyed services.
- *Enhancement:* `GenericTester` and `TypeTester` updated to support the test run execution within a DI scope (using `UseRunAsScoped`).
- *Fixed:* The `ExpectationsArranger` updated to `Clear` versus `Reset` after an assertion run to ensure no cross-test contamination.

* Add `Delay`.

* ScopedTypeTester

* Clean up tweaks

* Update changelog.

* Fix pull request errors.

* Fix CI vers path.

Author: chullybun

.github/workflows/ci.yml

@@ -30,8 +30,8 @@ jobs:
 
     - name: Explicit MSTest test
       run: |
-        cp tests/UnitTestEx.Api/bin/Debug/net6.0/UnitTestEx.Api.deps.json tests/UnitTestEx.MSTest.Test/bin/Debug/net6.0
-        cd tests/UnitTestEx.MSTest.Test/bin/Debug/net6.0
+        cp tests/UnitTestEx.Api/bin/Debug/net8.0/UnitTestEx.Api.deps.json tests/UnitTestEx.MSTest.Test/bin/Debug/net8.0
+        cd tests/UnitTestEx.MSTest.Test/bin/Debug/net8.0
         dotnet test UnitTestEx.MSTest.Test.dll --no-build --verbosity normal
 
     - name: Explicit NUnit test

CHANGELOG.md

@@ -2,6 +2,14 @@
 
 Represents the **NuGet** versions.
 
+## v5.6.0
+- *Enhancement:* The `RunAsync` methods updated to support `ValueTask` as well as `Task` for the `TypeTester` and `GenericTester` (.NET 9+ only).
+- *Enhancement:* Added `HttpResultAssertor` for ASP.NET Minimal APIs `Results` (e.g. `Results.Ok()`, `Results.NotFound()`, etc.) to enable assertions via the `ToHttpResponseMessageAssertor`.
+- *Enhancement:* `TesterBase<TSelf>` updated to support keyed services.
+- *Enhancement* `ScopedTypeTester` created to support pre-instantiated scoped service where multiple tests can be run against the same scoped instance. The existing `TypeTester` will continue to directly execute a one-off scoped instance. These now exist on the `TesterBase<TSelf>` enabling broader usage.
+- *Enhancement:* Added `TesterBase<TSelf>.Delay` method to enable delays to be added in a test where needed.
+- *Fixed:* The `ExpectationsArranger` updated to `Clear` versus `Reset` after an assertion run to ensure no cross-test contamination.
+
 ## v5.5.0
 - *Enhancement:* The `GenericTester` where using `.NET8.0` and above will leverage the new `IHostApplicationBuilder` versus existing `IHostBuilder` (see Microsoft [documentation](https://learn.microsoft.com/en-us/dotnet/core/extensions/generic-host) and [recommendation](https://github.com/dotnet/runtime/discussions/81090#discussioncomment-4784551)). Additionally, if a `TEntryPoint` is specified with a method signature of `public void ConfigureApplication(IHostApplicationBuilder builder)` then this will be automatically invoked during host instantiation. This is a non-breaking change as largely internal.
 

Common.targets

@@ -1,6 +1,6 @@
 <Project>
 	<PropertyGroup>
-		<Version>5.5.0</Version>
+		<Version>5.6.0</Version>
 		<LangVersion>preview</LangVersion>
 		<Authors>Avanade</Authors>
 		<Company>Avanade</Company>

UnitTestEx.sln

@@ -23,6 +23,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution
 	ProjectSection(SolutionItems) = preProject
 		.gitignore = .gitignore
 		CHANGELOG.md = CHANGELOG.md
+		.github\workflows\ci.yml = .github\workflows\ci.yml
 		CODE_OF_CONDUCT.md = CODE_OF_CONDUCT.md
 		Common.targets = Common.targets
 		CONTRIBUTING.md = CONTRIBUTING.md

src/UnitTestEx.Azure.Functions/Azure/Functions/FunctionTesterBase.cs

@@ -139,7 +139,7 @@ private IHost GetHost()
                 var ep2 = ep as FunctionsStartup;
                 var ep3 = new EntryPoint(ep);
 
-                return _host = new HostBuilder()
+                _host = new HostBuilder()
                     .UseEnvironment(UnitTestEx.TestSetUp.Environment)
                     .ConfigureLogging((lb) => { lb.SetMinimumLevel(SetUp.MinimumLogLevel); lb.ClearProviders(); lb.AddProvider(LoggerProvider); })
                     .ConfigureHostConfiguration(cb =>
@@ -180,6 +180,10 @@ private IHost GetHost()
                         SetUp.ConfigureServices?.Invoke(sc);
                         AddConfiguredServices(sc);
                     }).Build();
+
+                OnHostStartUp();
+
+                return _host;
             }
         }
 
@@ -223,13 +227,6 @@ protected override void ResetHost()
         /// <returns>The <see cref="HttpTriggerTester{TFunction}"/>.</returns>
         public HttpTriggerTester<TFunction> HttpTrigger<TFunction>() where TFunction : class => new(this, HostExecutionWrapper(() => GetHost().Services.CreateScope()));
 
-        /// <summary>
-        /// Specifies the <see cref="Type"/> of <typeparamref name="T"/> that is to be tested.
-        /// </summary>
-        /// <typeparam name="T">The <see cref="Type"/> to be tested.</typeparam>
-        /// <returns>The <see cref="TypeTester{TFunction}"/>.</returns>
-        public TypeTester<T> Type<T>() where T : class => new(this, HostExecutionWrapper(() => GetHost().Services.CreateScope()));
-
         /// <summary>
         /// Specifies the <i>Function</i> <see cref="Type"/> that utilizes the <see cref="ServiceBusTriggerAttribute"/> that is to be tested.
         /// </summary>

src/UnitTestEx.Azure.Functions/Azure/Functions/HttpTriggerTester.cs

@@ -36,7 +36,7 @@ namespace UnitTestEx.Azure.Functions
     /// </list>
     /// The above checks are generally neccessary to assist in ensuring that the function is being invoked correctly given the parameters have to be explicitly passed in separately.
     /// </remarks>
-    public class HttpTriggerTester<TFunction> : HostTesterBase<TFunction>, IExpectations<HttpTriggerTester<TFunction>> where TFunction : class
+    public class HttpTriggerTester<TFunction> : HostTesterBase<TFunction, HttpTriggerTester<TFunction>>, IExpectations<HttpTriggerTester<TFunction>> where TFunction : class
     {
         private bool _methodCheck = true;
         private RouteCheckOption _routeCheckOption = RouteCheckOption.PathAndQuery;
@@ -47,7 +47,7 @@ public class HttpTriggerTester<TFunction> : HostTesterBase<TFunction>, IExpectat
         /// </summary>
         /// <param name="owner">The owning <see cref="TesterBase"/>.</param>
         /// <param name="serviceScope">The <see cref="IServiceScope"/>.</param>
-        public HttpTriggerTester(TesterBase owner, IServiceScope serviceScope) : base(owner, serviceScope)
+        public HttpTriggerTester(TesterBase owner, IServiceScope serviceScope) : base(owner, serviceScope.ServiceProvider)
         { 
             ExpectationsArranger = new ExpectationsArranger<HttpTriggerTester<TFunction>>(owner, this);
             this.SetHttpMethodCheck(owner.SetUp);
@@ -448,9 +448,9 @@ private void LogResponse(IActionResult res, Exception? ex, double ms, IEnumerabl
                 }
             }
 
-            Implementor.WriteLine("");
-            Implementor.WriteLine(new string('=', 80));
-            Implementor.WriteLine("");
+            //Implementor.WriteLine("");
+            //Implementor.WriteLine(new string('=', 80));
+            //Implementor.WriteLine("");
         }
     }
 }

src/UnitTestEx.Azure.Functions/Azure/Functions/ServiceBusTriggerTester.cs

@@ -31,7 +31,7 @@ public class ServiceBusTriggerTester<TFunction> : HostTesterBase<TFunction>, IEx
         /// </summary>
         /// <param name="owner">The owning <see cref="TesterBase"/>.</param>
         /// <param name="serviceScope">The <see cref="IServiceScope"/>.</param>
-        public ServiceBusTriggerTester(TesterBase owner, IServiceScope serviceScope) : base(owner, serviceScope) => ExpectationsArranger = new ExpectationsArranger<ServiceBusTriggerTester<TFunction>>(owner, this);
+        public ServiceBusTriggerTester(TesterBase owner, IServiceScope serviceScope) : base(owner, serviceScope.ServiceProvider) => ExpectationsArranger = new ExpectationsArranger<ServiceBusTriggerTester<TFunction>>(owner, this);
 
         /// <summary>
         /// Gets the <see cref="ExpectationsArranger{TSelf}"/>.
@@ -81,7 +81,7 @@ public async Task<VoidAssertor> RunAsync(Expression<Func<TFunction, Task>> expre
 
                 if (validateTriggerProperties && a is not null)
                 {
-                    var config = ServiceScope.ServiceProvider.GetRequiredService<IConfiguration>();
+                    var config = Services.GetRequiredService<IConfiguration>();
                     var sbta = a as Microsoft.Azure.WebJobs.ServiceBusTriggerAttribute;
                     if (sbta is not null)
                         VerifyServiceBusTriggerProperties(config, sbta);
@@ -261,9 +261,9 @@ private void LogOutput(Exception? ex, double ms, object? value, WebJobsServiceBu
             ssba?.LogResult();
             wsba?.LogResult();
 
-            Implementor.WriteLine("");
-            Implementor.WriteLine(new string('=', 80));
-            Implementor.WriteLine("");
+            //Implementor.WriteLine("");
+            //Implementor.WriteLine(new string('=', 80));
+            //Implementor.WriteLine("");
         }
     }
 }

src/UnitTestEx.Azure.ServiceBus/UnitTestEx.Azure.ServiceBus.csproj

@@ -10,7 +10,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Azure.Messaging.ServiceBus" Version="7.18.2" />
+    <PackageReference Include="Azure.Messaging.ServiceBus" Version="7.20.1" />
   </ItemGroup>
 
   <ItemGroup>

src/UnitTestEx.MSTest/WithApiTester.cs

@@ -17,7 +17,7 @@ public abstract class WithApiTester<TEntryPoint> : IDisposable where TEntryPoint
         private ApiTester<TEntryPoint>? _apiTester = ApiTester.Create<TEntryPoint>();
 
         /// <summary>
-        /// Gets the shared <see cref="ApiTester{TEntryPoint}"/> for testing.
+        /// Gets the underlying <see cref="ApiTester{TEntryPoint}"/> for testing.
         /// </summary>
         public ApiTester<TEntryPoint> Test => _apiTester ?? throw new ObjectDisposedException(nameof(Test));
 

src/UnitTestEx.NUnit/WithApiTester.cs

@@ -17,7 +17,7 @@ public abstract class WithApiTester<TEntryPoint> : IDisposable where TEntryPoint
         private ApiTester<TEntryPoint>? _apiTester = ApiTester.Create<TEntryPoint>();
 
         /// <summary>
-        /// Gets the shared <see cref="ApiTester{TEntryPoint}"/> for testing.
+        /// Gets the underlying <see cref="ApiTester{TEntryPoint}"/> for testing.
         /// </summary>
         public ApiTester<TEntryPoint> Test => _apiTester ?? throw new ObjectDisposedException(nameof(Test));