Add GetValueOrDefault extension method for Guid (#279)

marcominerva · web-flow · commit 93c0d9736969 · 2025-12-10T10:14:03.000+01:00
diff --git a/README.md b/README.md
@@ -1,7 +1,7 @@
 # Tiny .NET Helpers
 
 [![Lint Code Base](https://github.com/marcominerva/TinyHelpers/actions/workflows/linter.yml/badge.svg)](https://github.com/marcominerva/TinyHelpers/actions/workflows/linter.yml)
-[![CodeQL](https://github.com/marcominerva/TinyHelpers/actions/workflows/codeql.yml/badge.svg)](https://github.com/marcominerva/TinyHelpers/actions/workflows/codeql.yml)
+[![CodeQL](https://github.com/marcominerva/TinyHelpers/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/marcominerva/TinyHelpers/actions/workflows/github-code-scanning/codeql)
 [![NuGet](https://img.shields.io/nuget/v/TinyHelpers.svg?style=flat-square)](https://www.nuget.org/packages/TinyHelpers)
 [![Nuget](https://img.shields.io/nuget/dt/TinyHelpers)](https://www.nuget.org/packages/TinyHelpers)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/marcominerva/TinyHelpers/blob/master/LICENSE)
@@ -23,4 +23,4 @@ Check out the [documentation](https://github.com/marcominerva/TinyHelpers/tree/m
 The project is constantly evolving. Contributions are welcome. Feel free to file issues and pull requests on the repo and we'll address them as we can.
 
 > **Warning**
-Remember to work on the **develop** branch, don't use the **master** branch directly. Create Pull Requests targeting **develop**.
+Remember to work on the **develop** branch, don't use the **master** branch directly. Create Pull Requests targeting **develop**.
diff --git a/src/TinyHelpers.AspNetCore.Swashbuckle/README.md b/src/TinyHelpers.AspNetCore.Swashbuckle/README.md
@@ -1,7 +1,7 @@
 # Tiny Helpers for Swashbuckle ASP.NET Core
 
 [![Lint Code Base](https://github.com/marcominerva/TinyHelpers/actions/workflows/linter.yml/badge.svg)](https://github.com/marcominerva/TinyHelpers/actions/workflows/linter.yml)
-[![CodeQL](https://github.com/marcominerva/TinyHelpers/actions/workflows/codeql.yml/badge.svg)](https://github.com/marcominerva/TinyHelpers/actions/workflows/codeql.yml)
+[![CodeQL](https://github.com/marcominerva/TinyHelpers/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/marcominerva/TinyHelpers/actions/workflows/github-code-scanning/codeql)
 [![NuGet](https://img.shields.io/nuget/v/TinyHelpers.AspNetCore.Swashbuckle.svg?style=flat-square)](https://www.nuget.org/packages/TinyHelpers.AspNetCore.Swashbuckle)
 [![Nuget](https://img.shields.io/nuget/dt/TinyHelpers.AspNetCore.Swashbuckle)](https://www.nuget.org/packages/TinyHelpers.AspNetCore.Swashbuckle)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/marcominerva/TinyHelpers/blob/master/LICENSE)
diff --git a/src/TinyHelpers.AspNetCore/README.md b/src/TinyHelpers.AspNetCore/README.md
@@ -1,7 +1,7 @@
 # Tiny Helpers for ASP.NET Core
 
 [![Lint Code Base](https://github.com/marcominerva/TinyHelpers/actions/workflows/linter.yml/badge.svg)](https://github.com/marcominerva/TinyHelpers/actions/workflows/linter.yml)
-[![CodeQL](https://github.com/marcominerva/TinyHelpers/actions/workflows/codeql.yml/badge.svg)](https://github.com/marcominerva/TinyHelpers/actions/workflows/codeql.yml)
+[![CodeQL](https://github.com/marcominerva/TinyHelpers/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/marcominerva/TinyHelpers/actions/workflows/github-code-scanning/codeql)
 [![NuGet](https://img.shields.io/nuget/v/TinyHelpers.AspNetCore.svg?style=flat-square)](https://www.nuget.org/packages/TinyHelpers.AspNetCore)
 [![Nuget](https://img.shields.io/nuget/dt/TinyHelpers.AspNetCore)](https://www.nuget.org/packages/TinyHelpers.AspNetCore)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/marcominerva/TinyHelpers/blob/master/LICENSE)
@@ -78,4 +78,4 @@ builder.Services.AddOpenApi(options =>
 The project is constantly evolving. Contributions are welcome. Feel free to file issues and pull requests on the repo and we'll address them as we can. 
 
 > **Warning**
-Remember to work on the **develop** branch, don't use the **master** branch directly. Create Pull Requests targeting **develop**.
+Remember to work on the **develop** branch, don't use the **master** branch directly. Create Pull Requests targeting **develop**.
diff --git a/src/TinyHelpers.Dapper/README.md b/src/TinyHelpers.Dapper/README.md
@@ -1,7 +1,7 @@
 # Tiny Helpers for Dapper
 
 [![Lint Code Base](https://github.com/marcominerva/TinyHelpers/actions/workflows/linter.yml/badge.svg)](https://github.com/marcominerva/TinyHelpers/actions/workflows/linter.yml)
-[![CodeQL](https://github.com/marcominerva/TinyHelpers/actions/workflows/codeql.yml/badge.svg)](https://github.com/marcominerva/TinyHelpers/actions/workflows/codeql.yml)
+[![CodeQL](https://github.com/marcominerva/TinyHelpers/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/marcominerva/TinyHelpers/actions/workflows/github-code-scanning/codeql)
 [![NuGet](https://img.shields.io/nuget/v/TinyHelpers.Dapper.svg?style=flat-square)](https://www.nuget.org/packages/TinyHelpers.Dapper)
 [![Nuget](https://img.shields.io/nuget/dt/TinyHelpers.Dapper)](https://www.nuget.org/packages/TinyHelpers.Dapper)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/marcominerva/TinyHelpers/blob/master/LICENSE)
@@ -41,4 +41,4 @@ TimeOnlyTypeHandler.Configure();
 The project is constantly evolving. Contributions are welcome. Feel free to file issues and pull requests on the repo and we'll address them as we can. 
 
 > **Warning**
-Remember to work on the **develop** branch, don't use the **master** branch directly. Create Pull Requests targeting **develop**.
+Remember to work on the **develop** branch, don't use the **master** branch directly. Create Pull Requests targeting **develop**.
diff --git a/src/TinyHelpers.EntityFrameworkCore/README.md b/src/TinyHelpers.EntityFrameworkCore/README.md
@@ -1,7 +1,7 @@
 # Tiny Helpers for Entity Framework Core
 
 [![Lint Code Base](https://github.com/marcominerva/TinyHelpers/actions/workflows/linter.yml/badge.svg)](https://github.com/marcominerva/TinyHelpers/actions/workflows/linter.yml)
-[![CodeQL](https://github.com/marcominerva/TinyHelpers/actions/workflows/codeql.yml/badge.svg)](https://github.com/marcominerva/TinyHelpers/actions/workflows/codeql.yml)
+[![CodeQL](https://github.com/marcominerva/TinyHelpers/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/marcominerva/TinyHelpers/actions/workflows/github-code-scanning/codeql)
 [![NuGet](https://img.shields.io/nuget/v/TinyHelpers.EntityFrameworkCore.svg?style=flat-square)](https://www.nuget.org/packages/TinyHelpers.EntityFrameworkCore)
 [![Nuget](https://img.shields.io/nuget/dt/TinyHelpers.EntityFrameworkCore)](https://www.nuget.org/packages/TinyHelpers.EntityFrameworkCore)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/marcominerva/TinyHelpers/blob/master/LICENSE)
diff --git a/src/TinyHelpers/Extensions/GuidExtensions.cs b/src/TinyHelpers/Extensions/GuidExtensions.cs
@@ -70,6 +70,15 @@ public static bool HasValue([NotNullWhen(true)] this Guid? input)
     public static Guid GetValueOrCreateNew(this Guid input)
         => input.IsEmpty() ? Guid.NewGuid() : input;
 
+    /// <summary>
+    /// Gets the actual value of this <see cref="Guid"/> instance, if it is different from <c>Guid.Empty</c>; otherwise, returns the specified default value.
+    /// </summary>
+    /// <param name="input">The <see cref="Guid"/> to test.</param>
+    /// <param name="defaultValue">The default <see cref="Guid"/> to return if the input is <c>Guid.Empty</c>.</param>
+    /// <returns>The actual value of this <see cref="Guid"/> instance, if it is different from <c>Guid.Empty</c>; otherwise, the specified default value.</returns>
+    public static Guid GetValueOrDefault(this Guid input, Guid defaultValue)
+        => input.IsEmpty() ? defaultValue : input;
+
     /// <summary>
     /// Gets the actual value of this <see cref="Guid"/> instance, if it is different from <see langword="null"/> and <c>Guid.Empty</c>; otherwise, creates a new <see cref="Guid"/> using <see cref="Guid.NewGuid()"/>.
     /// </summary>
diff --git a/tests/TinyHelpers.Tests/Extensions/GuidExtensionsTests.cs b/tests/TinyHelpers.Tests/Extensions/GuidExtensionsTests.cs
@@ -212,4 +212,34 @@ public void NullableGuidIsNotEmpty_GetValueOrCreateNew_Should_Return_TheSameGuid
         // Assert
         Assert.Equal(input, value);
     }
+
+    [Fact]
+    public void GuidIsEmpty_GetValueOrDefault_Should_Return_DefaultValue()
+    {
+        // Arrange
+        var input = Guid.Empty;
+        var defaultValue = Guid.NewGuid();
+
+        // Act
+        var value = input.GetValueOrDefault(defaultValue);
+
+        // Assert
+        Assert.Equal(defaultValue, value);
+    }
+
+    [Fact]
+    public void GuidIsNotEmpty_GetValueOrDefault_Should_Return_TheSameGuid()
+    {
+        // Arrange
+        var input = Guid.NewGuid();
+        var defaultValue = Guid.NewGuid();
+
+        // Act
+        var value = input.GetValueOrDefault(defaultValue);
+
+        // Assert
+        Assert.Equal(input, value);
+    }
+
+
 }
