feat: add IsNullOrEmpty expectation for nullable Guid

Docs/pages/docs/expectations/13-guid.md

@@ -17,9 +17,14 @@ await Expect.That(subject).IsNotEqualTo(Guid.Parse("cdd7a485-40a1-4bba-bb8b-d0e9
 
 ## Empty
 
-You can verify that the `Guid` is empty or not:
+You can verify that the `Guid` is (null or) empty or not:
 
 ```csharp
 await Expect.That(Guid.Empty).IsEmpty();
 await Expect.That(Guid.NewGuid()).IsNotEmpty();
+
+Guid? guid1 = Guid.Empty;
+await Expect.That(guid1).IsNullOrEmpty();
+Guid? guid2 = Guid.NewGuid();
+await Expect.That(guid2).IsNotNullOrEmpty();
 ```

Source/aweXpect.SourceGenerators/Helpers/ExpectationToGenerate.cs

@@ -40,6 +40,9 @@ public ExpectationToGenerate(string @namespace,
 				case "Remarks":
 					Remarks = namedArgument.Value.Value?.ToString();
 					break;
+				case "FailOnNull":
+					FailOnNull = namedArgument.Value.Value as bool? ?? true;
+					break;
 				case "Using":
 					Usings =
 						namedArgument.Value.Values.Select(x => x.Value?.ToString()).Where(x => x != null).ToArray()!;
@@ -59,6 +62,7 @@ public ExpectationToGenerate(string @namespace,
 		FileName = $"{ClassName}.{Name}.g.cs";
 	}
 
+	public bool FailOnNull { get; } = true;
 	public string[] Usings { get; } = [];
 	public string FileName { get; }
 	public bool IncludeNegated { get; }

Source/aweXpect.SourceGenerators/Helpers/SourceGenerationHelper.cs

@@ -81,6 +81,7 @@ public CreateExpectationOnNullableAttribute(string positiveName, string negative
 				OutcomeMethod = outcomeMethod;
 			}
 
+			public bool FailOnNull { get; set; } = true;
 			public Type TargetType { get; }
 			public string PositiveName { get; }
 			public string? NegativeName { get; }
@@ -133,7 +134,7 @@ public static partial class {{expectationToGenerate.ClassName}}
 			            """;
 		}
 
-		if (expectationToGenerate.IsNullable)
+		if (expectationToGenerate.IsNullable && expectationToGenerate.FailOnNull)
 		{
 			result += $$"""
 			            	private sealed class {{expectationToGenerate.Name}}Constraint(string it, ExpectationGrammars grammars)

Source/aweXpect/That/Guids/ThatNullableGuid.IsNullOrEmpty.cs

@@ -0,0 +1,11 @@
+using System;
+using aweXpect.SourceGenerators;
+
+namespace aweXpect;
+
+[CreateExpectationOnNullable<Guid>("Is{Not}NullOrEmpty", "{value} is null || {value} == Guid.Empty",
+	ExpectationText = "is {not} null or empty",
+	Using = ["System",],
+	FailOnNull = false
+)]
+public static partial class ThatNullableGuid;

Tests/aweXpect.Api.Tests/Expected/aweXpect_net8.0.txt

@@ -891,6 +891,8 @@ namespace aweXpect
         public static aweXpect.Results.AndOrResult<System.Guid?, aweXpect.Core.IThat<System.Guid?>> IsEqualTo(this aweXpect.Core.IThat<System.Guid?> source, System.Guid? expected) { }
         public static aweXpect.Results.AndOrResult<System.Guid?, aweXpect.Core.IThat<System.Guid?>> IsNotEmpty(this aweXpect.Core.IThat<System.Guid?> source) { }
         public static aweXpect.Results.AndOrResult<System.Guid?, aweXpect.Core.IThat<System.Guid?>> IsNotEqualTo(this aweXpect.Core.IThat<System.Guid?> source, System.Guid? unexpected) { }
+        public static aweXpect.Results.AndOrResult<System.Guid?, aweXpect.Core.IThat<System.Guid?>> IsNotNullOrEmpty(this aweXpect.Core.IThat<System.Guid?> source) { }
+        public static aweXpect.Results.AndOrResult<System.Guid?, aweXpect.Core.IThat<System.Guid?>> IsNullOrEmpty(this aweXpect.Core.IThat<System.Guid?> source) { }
     }
     public static class ThatNullableTimeOnly
     {

Tests/aweXpect.Api.Tests/Expected/aweXpect_netstandard2.0.txt

@@ -630,6 +630,8 @@ namespace aweXpect
         public static aweXpect.Results.AndOrResult<System.Guid?, aweXpect.Core.IThat<System.Guid?>> IsEqualTo(this aweXpect.Core.IThat<System.Guid?> source, System.Guid? expected) { }
         public static aweXpect.Results.AndOrResult<System.Guid?, aweXpect.Core.IThat<System.Guid?>> IsNotEmpty(this aweXpect.Core.IThat<System.Guid?> source) { }
         public static aweXpect.Results.AndOrResult<System.Guid?, aweXpect.Core.IThat<System.Guid?>> IsNotEqualTo(this aweXpect.Core.IThat<System.Guid?> source, System.Guid? unexpected) { }
+        public static aweXpect.Results.AndOrResult<System.Guid?, aweXpect.Core.IThat<System.Guid?>> IsNotNullOrEmpty(this aweXpect.Core.IThat<System.Guid?> source) { }
+        public static aweXpect.Results.AndOrResult<System.Guid?, aweXpect.Core.IThat<System.Guid?>> IsNullOrEmpty(this aweXpect.Core.IThat<System.Guid?> source) { }
     }
     public static class ThatNullableTimeSpan
     {

Tests/aweXpect.Tests/Guids/ThatGuid.Nullable.IsEmpty.Tests.cs

@@ -11,7 +11,7 @@ public sealed class Tests
 				[Fact]
 				public async Task WhenSubjectIsEmpty_ShouldSucceed()
 				{
-					Guid subject = Guid.Empty;
+					Guid? subject = Guid.Empty;
 
 					async Task Act()
 						=> await That(subject).IsEmpty();

Tests/aweXpect.Tests/Guids/ThatGuid.Nullable.IsNotEmpty.Tests.cs

@@ -11,7 +11,7 @@ public sealed class Tests
 				[Fact]
 				public async Task WhenSubjectIsEmpty_ShouldFail()
 				{
-					Guid subject = Guid.Empty;
+					Guid? subject = Guid.Empty;
 
 					async Task Act()
 						=> await That(subject).IsNotEmpty();

Tests/aweXpect.Tests/Guids/ThatGuid.Nullable.IsNotNullOrEmpty.Tests.cs

@@ -0,0 +1,56 @@
+namespace aweXpect.Tests;
+
+public sealed partial class ThatGuid
+{
+	public sealed partial class Nullable
+	{
+		public sealed class IsNotNullOrEmpty
+		{
+			public sealed class Tests
+			{
+				[Fact]
+				public async Task WhenSubjectIsEmpty_ShouldFail()
+				{
+					Guid? subject = Guid.Empty;
+
+					async Task Act()
+						=> await That(subject).IsNotNullOrEmpty();
+
+					await That(Act).Throws<XunitException>()
+						.WithMessage($"""
+						              Expected that subject
+						              is not null or empty,
+						              but it was {Formatter.Format(subject)}
+						              """);
+				}
+
+				[Fact]
+				public async Task WhenSubjectIsNotEmpty_ShouldSucceed()
+				{
+					Guid? subject = OtherGuid();
+
+					async Task Act()
+						=> await That(subject).IsNotNullOrEmpty();
+
+					await That(Act).DoesNotThrow();
+				}
+
+				[Fact]
+				public async Task WhenSubjectIsNull_ShouldFail()
+				{
+					Guid? subject = null;
+
+					async Task Act()
+						=> await That(subject).IsNotNullOrEmpty();
+
+					await That(Act).Throws<XunitException>()
+						.WithMessage("""
+						             Expected that subject
+						             is not null or empty,
+						             but it was <null>
+						             """);
+				}
+			}
+		}
+	}
+}

Tests/aweXpect.Tests/Guids/ThatGuid.Nullable.IsNullOrEmpty.Tests.cs

@@ -0,0 +1,51 @@
+namespace aweXpect.Tests;
+
+public sealed partial class ThatGuid
+{
+	public sealed partial class Nullable
+	{
+		public sealed class IsNullOrEmpty
+		{
+			public sealed class Tests
+			{
+				[Fact]
+				public async Task WhenSubjectIsEmpty_ShouldSucceed()
+				{
+					Guid? subject = Guid.Empty;
+
+					async Task Act()
+						=> await That(subject).IsNullOrEmpty();
+
+					await That(Act).DoesNotThrow();
+				}
+
+				[Fact]
+				public async Task WhenSubjectIsNotEmpty_ShouldFail()
+				{
+					Guid? subject = OtherGuid();
+
+					async Task Act()
+						=> await That(subject).IsNullOrEmpty();
+
+					await That(Act).Throws<XunitException>()
+						.WithMessage($"""
+						              Expected that subject
+						              is null or empty,
+						              but it was {Formatter.Format(subject)}
+						              """);
+				}
+
+				[Fact]
+				public async Task WhenSubjectIsNull_ShouldSucceed()
+				{
+					Guid? subject = null;
+
+					async Task Act()
+						=> await That(subject).IsNullOrEmpty();
+
+					await That(Act).DoesNotThrow();
+				}
+			}
+		}
+	}
+}