Feat/time provider support

src/Digitall.Testing/Extensions/FakedDataverseBuilderExtensions.cs

@@ -32,4 +32,17 @@ public static FakedDataverseBuilder AddOrganizationRequests(this FakedDataverseB
         builder.OrganizationService.AddRequests(requests);
         return builder;
     }
+
+    /// <summary>
+    /// Retrieves the underlying FakedDataverse service from the FakedDataverseBuilder at call time.
+    /// </summary>
+    /// <param name="builder">The FakedDataverseBuilder instance.</param>
+    /// <param name="service">The output parameter for the FakedDataverse service.</param>
+    /// <returns>The same FakedDataverseBuilder instance for method chaining.</returns>
+    public static FakedDataverseBuilder GetFakedDataverse(this FakedDataverseBuilder builder, out FakedDataverse service)
+    {
+        // Assign the OrganizationService from the builder to the output parameter
+        service = builder.OrganizationService;
+        return builder;
+    }
 }

src/Digitall.Testing/FakedDataverseBuilder.cs

@@ -7,15 +7,41 @@ namespace Digitall.Testing;
 
 public class FakedDataverseBuilder : PluginExecutionContextBuilder
 {
+    /// <summary>
+    /// Creates a new instance of <see cref="FakedDataverseBuilder"/> with a default instance of <see cref="FakedDataverse"/>.
+    /// </summary>
     public FakedDataverseBuilder()
     {
         OrganizationService = new FakedDataverse();
         OrganizationService.AddDefaultRequests();
     }
 
+    /// <summary>
+    /// Creates a new instance of <see cref="FakedDataverseBuilder"/> with an instance of <see cref="FakedDataverse"/>
+    /// that uses the given <see cref="TimeProvider"/>.
+    /// </summary>
+    public FakedDataverseBuilder(TimeProvider timeProvider)
+    {
+        // Create a new FakedDataverse instance with the given TimeProvider
+        OrganizationService = new FakedDataverse(timeProvider);
+
+        // Add all default requests to the OrganizationService
+        OrganizationService.AddDefaultRequests();
+    }
+
+    /// <summary>
+    /// Creates a new instance of <see cref="FakedDataverseBuilder"/> with the provided <see cref="FakedDataverse"/> instance.
+    /// </summary>
+    /// <param name="fakedDataverse">An existing instance of <see cref="FakedDataverse"/> to use as the organization service.</param>
+    public FakedDataverseBuilder(FakedDataverse fakedDataverse)
+    {
+        // Assign the provided FakedDataverse instance to the OrganizationService
+        OrganizationService = fakedDataverse;
+    }
+
     public new FakedDataverse OrganizationService
     {
         get => base.OrganizationService as FakedDataverse ?? throw new InvalidOperationException(@"¯\_(ツ)_/¯");
-        set { base.OrganizationService = value; }
+        private set { base.OrganizationService = value; }
     }
 }

tests/Digitall.Testing.Tests/PluginExecutionContextBuilderTests.cs

@@ -3,6 +3,7 @@
 using Digitall.Testing.Tests.Fixtures;
 using Digitall.Testing.Tests.Fixtures.SamplePlugin;
 using FluentAssertions;
+using Microsoft.Extensions.Time.Testing;
 using Microsoft.Xrm.Sdk;
 using Microsoft.Xrm.Sdk.Query;
 using NSubstitute;
@@ -176,4 +177,37 @@ public void TestPlugin_Durchstich()
 
         tracingService.Received().Trace("TestPlugin: Execute");
     }
+
+    [TestMethod]
+    public void GetFakedDataverse_Should_Return_FakedDataverse()
+    {
+        var serviceProvider = new FakedDataverseBuilder()
+            .GetFakedDataverse(out var service)
+            .BuildServiceProvider();
+
+        service.Should().NotBeNull().And.BeOfType<FakedDataverse>();
+    }
+
+    [TestMethod]
+    public void FakedDataverseBuilder_With_Custom_TimeProvider()
+    {
+        var serviceProvider = new FakedDataverseBuilder(new FakeTimeProvider(new DateTimeOffset(2000, 1, 1, 0, 0, 0, TimeSpan.Zero)))
+            .GetFakedDataverse(out var service)
+            .BuildServiceProvider();
+
+        service.Should().NotBeNull().And.BeOfType<FakedDataverse>();
+        service.TimeProvider.GetUtcNow().Year.Should().Be(2000);
+    }
+
+    [TestMethod]
+    public void FakedDataverseBuilder_With_Custom_FakeDataverse()
+    {
+        var fakeDataverse = new FakedDataverse(new FakeTimeProvider(new DateTimeOffset(2000, 1, 1, 0, 0, 0, TimeSpan.Zero)));
+        var serviceProvider = new FakedDataverseBuilder(fakeDataverse)
+            .GetFakedDataverse(out var service)
+            .BuildServiceProvider();
+
+        service.Should().NotBeNull().And.BeOfType<FakedDataverse>();
+        service.TimeProvider.GetUtcNow().Year.Should().Be(2000);
+    }
 }