From cfc537d8c6a087567b0083d7117fc69a1267f12e Mon Sep 17 00:00:00 2001
From: David Berry <dberry83702@yahoo.com>
Date: Fri, 31 Oct 2025 23:18:40 -0500
Subject: [PATCH] Added extension method As<T> to allow easy soft casting of
 objects

---
 .../Util/ObjectExtensionsTests.cs             | 54 +++++++++++++++++++
 .../Util/ObjectExtensions.cs                  | 26 +++++++++
 2 files changed, 80 insertions(+)
 create mode 100644 DavidBerry.Framework/DavidBerry.Framework.Tests/Util/ObjectExtensionsTests.cs
 create mode 100644 DavidBerry.Framework/DavidBerry.Framework/Util/ObjectExtensions.cs

diff --git a/DavidBerry.Framework/DavidBerry.Framework.Tests/Util/ObjectExtensionsTests.cs b/DavidBerry.Framework/DavidBerry.Framework.Tests/Util/ObjectExtensionsTests.cs
new file mode 100644
index 0000000..7aa424a
--- /dev/null
+++ b/DavidBerry.Framework/DavidBerry.Framework.Tests/Util/ObjectExtensionsTests.cs
@@ -0,0 +1,54 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using DavidBerry.Framework.Util;
+using Shouldly;
+using Xunit;
+
+namespace DavidBerry.Framework.Tests.Util;
+
+
+
+public class ObjectExtensionsTests
+{
+
+    public class Person
+    {
+        public string Name { get; set; }
+        public int Age { get; set; }
+    }
+
+
+    [Fact]
+    public void As_CorrectlyCastsAnObjectToCorrectType()
+    {
+        // Arrange
+        object obj = new Person() { Name = "John", Age = 30 };
+
+        // Act
+        var person = obj.As<Person>();
+
+        // Assert
+        person.ShouldBeOfType<Person>();
+        person.Name.ShouldBe("John");
+        person.Age.ShouldBe(30);
+    }
+
+
+    [Fact]
+    public void As_ReturnsNullWhenIncorrectTypeGiven()
+    {
+        // Arrange
+        object obj = new string("hello World");
+
+        // Act
+        var person = obj.As<Person>();
+
+        // Assert
+        person.ShouldBeNull();
+    }
+
+}
+
diff --git a/DavidBerry.Framework/DavidBerry.Framework/Util/ObjectExtensions.cs b/DavidBerry.Framework/DavidBerry.Framework/Util/ObjectExtensions.cs
new file mode 100644
index 0000000..e3995fe
--- /dev/null
+++ b/DavidBerry.Framework/DavidBerry.Framework/Util/ObjectExtensions.cs
@@ -0,0 +1,26 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace DavidBerry.Framework.Util;
+
+public static class ObjectExtensions
+{
+
+
+    /// <summary>
+    /// Convenience method to perform an "as" cast on an object to the specified type
+    /// </summary>
+    /// <typeparam name="T">The Type to as cast the object to</typeparam>
+    /// <param name="obj">The object to be casted</param>
+    /// <returns>The obejct as type T or null if the object cannot be casted to the specified type</returns>
+    public static T? As<T>(this object obj) where T : class
+    {
+        return obj as T;
+    }
+
+
+}
+