feat: add Register to property setup

Source/Mockolate/Setup/Interfaces.PropertySetup.cs

@@ -118,6 +118,14 @@ public interface IPropertySetup<T>
 	/// </remarks>
 	IPropertySetup<T> CallingBaseClass(bool callBaseClass = true);
 
+	/// <summary>
+	///     Register the property to have a setup without a specific value.
+	/// </summary>
+	/// <remarks>
+	///     This is necessary when the mock uses <see cref="MockBehavior.ThrowWhenNotSetup" />.
+	/// </remarks>
+	IPropertySetup<T> Register();
+
 	/// <summary>
 	///     Initializes the property with the given <paramref name="value" />.
 	/// </summary>

Source/Mockolate/Setup/PropertySetup.cs

@@ -298,6 +298,10 @@ public IPropertySetup<T> CallingBaseClass(bool callBaseClass = true)
 		return this;
 	}
 
+	/// <inheritdoc cref="IPropertySetup{T}.Register" />
+	public IPropertySetup<T> Register()
+		=> this;
+
 	/// <inheritdoc cref="IPropertySetup{T}.InitializeWith(T)" />
 	public IPropertySetup<T> InitializeWith(T value)
 	{

Tests/Mockolate.Api.Tests/Expected/Mockolate_net10.0.txt

@@ -888,6 +888,7 @@ namespace Mockolate.Setup
         Mockolate.Setup.IPropertySetterSetup<T> OnSet { get; }
         Mockolate.Setup.IPropertySetup<T> CallingBaseClass(bool callBaseClass = true);
         Mockolate.Setup.IPropertySetup<T> InitializeWith(T value);
+        Mockolate.Setup.IPropertySetup<T> Register();
         Mockolate.Setup.IPropertySetupReturnBuilder<T> Returns(System.Func<T> callback);
         Mockolate.Setup.IPropertySetupReturnBuilder<T> Returns(System.Func<T, T> callback);
         Mockolate.Setup.IPropertySetupReturnBuilder<T> Returns(T returnValue);
@@ -1405,6 +1406,7 @@ namespace Mockolate.Setup
         protected override TResult InvokeGetter<TResult>(Mockolate.MockBehavior behavior, System.Func<TResult> defaultValueGenerator) { }
         protected override void InvokeSetter(object? value, Mockolate.MockBehavior behavior) { }
         protected override bool Matches(Mockolate.Interactions.PropertyAccess propertyAccess) { }
+        public Mockolate.Setup.IPropertySetup<T> Register() { }
         public Mockolate.Setup.IPropertySetupReturnBuilder<T> Returns(System.Func<T> callback) { }
         public Mockolate.Setup.IPropertySetupReturnBuilder<T> Returns(System.Func<T, T> callback) { }
         public Mockolate.Setup.IPropertySetupReturnBuilder<T> Returns(T returnValue) { }

Tests/Mockolate.Api.Tests/Expected/Mockolate_net8.0.txt

@@ -887,6 +887,7 @@ namespace Mockolate.Setup
         Mockolate.Setup.IPropertySetterSetup<T> OnSet { get; }
         Mockolate.Setup.IPropertySetup<T> CallingBaseClass(bool callBaseClass = true);
         Mockolate.Setup.IPropertySetup<T> InitializeWith(T value);
+        Mockolate.Setup.IPropertySetup<T> Register();
         Mockolate.Setup.IPropertySetupReturnBuilder<T> Returns(System.Func<T> callback);
         Mockolate.Setup.IPropertySetupReturnBuilder<T> Returns(System.Func<T, T> callback);
         Mockolate.Setup.IPropertySetupReturnBuilder<T> Returns(T returnValue);
@@ -1404,6 +1405,7 @@ namespace Mockolate.Setup
         protected override TResult InvokeGetter<TResult>(Mockolate.MockBehavior behavior, System.Func<TResult> defaultValueGenerator) { }
         protected override void InvokeSetter(object? value, Mockolate.MockBehavior behavior) { }
         protected override bool Matches(Mockolate.Interactions.PropertyAccess propertyAccess) { }
+        public Mockolate.Setup.IPropertySetup<T> Register() { }
         public Mockolate.Setup.IPropertySetupReturnBuilder<T> Returns(System.Func<T> callback) { }
         public Mockolate.Setup.IPropertySetupReturnBuilder<T> Returns(System.Func<T, T> callback) { }
         public Mockolate.Setup.IPropertySetupReturnBuilder<T> Returns(T returnValue) { }

Tests/Mockolate.Api.Tests/Expected/Mockolate_netstandard2.0.txt

@@ -864,6 +864,7 @@ namespace Mockolate.Setup
         Mockolate.Setup.IPropertySetterSetup<T> OnSet { get; }
         Mockolate.Setup.IPropertySetup<T> CallingBaseClass(bool callBaseClass = true);
         Mockolate.Setup.IPropertySetup<T> InitializeWith(T value);
+        Mockolate.Setup.IPropertySetup<T> Register();
         Mockolate.Setup.IPropertySetupReturnBuilder<T> Returns(System.Func<T> callback);
         Mockolate.Setup.IPropertySetupReturnBuilder<T> Returns(System.Func<T, T> callback);
         Mockolate.Setup.IPropertySetupReturnBuilder<T> Returns(T returnValue);
@@ -1381,6 +1382,7 @@ namespace Mockolate.Setup
         protected override TResult InvokeGetter<TResult>(Mockolate.MockBehavior behavior, System.Func<TResult> defaultValueGenerator) { }
         protected override void InvokeSetter(object? value, Mockolate.MockBehavior behavior) { }
         protected override bool Matches(Mockolate.Interactions.PropertyAccess propertyAccess) { }
+        public Mockolate.Setup.IPropertySetup<T> Register() { }
         public Mockolate.Setup.IPropertySetupReturnBuilder<T> Returns(System.Func<T> callback) { }
         public Mockolate.Setup.IPropertySetupReturnBuilder<T> Returns(System.Func<T, T> callback) { }
         public Mockolate.Setup.IPropertySetupReturnBuilder<T> Returns(T returnValue) { }

Tests/Mockolate.Tests/MockProperties/SetupPropertyTests.RegisterTests.cs

@@ -0,0 +1,39 @@
+using Mockolate.Exceptions;
+
+namespace Mockolate.Tests.MockProperties;
+
+public sealed partial class SetupPropertyTests
+{
+	public sealed class RegisterTests
+	{
+		[Fact]
+		public async Task AccessWithoutSetup_ShouldThrowMockNotSetupException()
+		{
+			IPropertyService mock = Mock.Create<IPropertyService>(MockBehavior.Default.ThrowingWhenNotSetup());
+
+			void Act()
+			{
+				mock.MyStringProperty = "1";
+			}
+
+			await That(Act).Throws<MockNotSetupException>()
+				.WithMessage(
+					"The property 'Mockolate.Tests.MockProperties.SetupPropertyTests.IPropertyService.MyStringProperty' was accessed without prior setup.");
+		}
+
+		[Fact]
+		public async Task RegisterBeforeAccess_ShouldNotThrowAndReturnDefaultValue()
+		{
+			IPropertyService mock = Mock.Create<IPropertyService>(MockBehavior.Default.ThrowingWhenNotSetup());
+
+			mock.SetupMock.Property.MyStringProperty.Register();
+
+			string? initialResult = mock.MyStringProperty;
+			mock.MyStringProperty = "foo";
+			string? otherResult = mock.MyStringProperty;
+
+			await That(initialResult).IsEmpty();
+			await That(otherResult).IsEqualTo("foo");
+		}
+	}
+}