Add func extensions sync/async IsTrue, IsFalse.

Author: I-RzR-I

src/DomainCommonExtensions/CommonExtensions/FuncExtensions.cs

@@ -0,0 +1,96 @@
+// ***********************************************************************
+//  Assembly         : RzR.Shared.Extensions.DomainCommonExtensions
+//  Author           : RzR
+//  Created On       : 2025-07-11 12:38
+// 
+//  Last Modified By : RzR
+//  Last Modified On : 2025-07-11 13:01
+// ***********************************************************************
+//  <copyright file="FuncExtensions.cs" company="RzR SOFT & TECH">
+//   Copyright © RzR. All rights reserved.
+//  </copyright>
+// 
+//  <summary>
+//  </summary>
+// ***********************************************************************
+
+#region U S A G E S
+
+using System;
+using System.Threading.Tasks;
+using DomainCommonExtensions.DataTypeExtensions;
+
+#endregion
+
+namespace DomainCommonExtensions.CommonExtensions
+{
+    /// <summary>
+    ///     A function extensions.
+    /// </summary>
+    public static class FuncExtensions
+    {
+        /// <summary>
+        ///     A Func&lt;bool&gt; extension method that query if 'func' result is true.
+        /// </summary>
+        /// <exception cref="ArgumentNullException">
+        ///     Thrown when one or more required arguments are null.
+        /// </exception>
+        /// <param name="func">The func to act on.</param>
+        /// <returns>
+        ///     True if true, false if not.
+        /// </returns>
+        public static bool IsTrue(this Func<bool> func)
+        {
+            if (func.IsNull())
+                throw new ArgumentNullException(nameof(func));
+
+            return func.Invoke().IsTrue();
+        }
+
+        /// <summary>
+        ///     A Func&lt;bool&gt; extension method that query if 'func' result is false.
+        /// </summary>
+        /// <param name="func">The func to act on.</param>
+        /// <returns>
+        ///     True if false, false if not.
+        /// </returns>
+        public static bool IsFalse(this Func<bool> func)
+        {
+            return func.IsTrue().IsFalse();
+        }
+
+        /// -------------------------------------------------------------------------------------------------
+        /// <summary>
+        ///     A Func&lt;bool&gt; extension method that query if 'func' result is true.
+        /// </summary>
+        /// <exception cref="ArgumentNullException">
+        ///     Thrown when one or more required arguments are null.
+        /// </exception>
+        /// <param name="func">The func to act on.</param>
+        /// <returns>
+        ///     True if true, false if not.
+        /// </returns>
+        /// =================================================================================================
+        public static bool IsTrue(this Func<Task<bool>> func)
+        {
+            if (func.IsNull())
+                throw new ArgumentNullException(nameof(func));
+
+            return func.Invoke().Result.IsTrue();
+        }
+
+        /// -------------------------------------------------------------------------------------------------
+        /// <summary>
+        ///     A Func&lt;bool&gt; extension method that query if 'func' result is false.
+        /// </summary>
+        /// <param name="func">The func to act on.</param>
+        /// <returns>
+        ///     True if false, false if not.
+        /// </returns>
+        /// =================================================================================================
+        public static bool IsFalse(this Func<Task<bool>> func)
+        {
+            return func.IsTrue().IsFalse();
+        }
+    }
+}

src/tests/DataTypeTests/UtilsTests/FuncExtensionsTests.cs

@@ -0,0 +1,75 @@
+// ***********************************************************************
+//  Assembly         : RzR.Shared.Extensions.DataTypeTests
+//  Author           : RzR
+//  Created On       : 2025-07-11 12:43
+// 
+//  Last Modified By : RzR
+//  Last Modified On : 2025-07-11 12:58
+// ***********************************************************************
+//  <copyright file="FuncExtensionsTests.cs" company="RzR SOFT & TECH">
+//   Copyright © RzR. All rights reserved.
+//  </copyright>
+// 
+//  <summary>
+//  </summary>
+// ***********************************************************************
+
+#region U S A G E S
+
+using System;
+using System.Threading.Tasks;
+using DomainCommonExtensions.CommonExtensions;
+using Microsoft.VisualStudio.TestTools.UnitTesting;
+
+#endregion
+
+namespace DataTypeTests.UtilsTests
+{
+    [TestClass]
+    public class FuncExtensionsTests
+    {
+        [TestMethod]
+        public void IsTrue_Func_ShouldBe_True_Test()
+        {
+            Func<bool> func = () => { return 1 == 1; };
+
+            var funcResult = func.IsTrue();
+
+            Assert.IsNotNull(funcResult);
+            Assert.IsTrue(funcResult);
+        }
+
+        [TestMethod]
+        public void IsFalse_Func_ShouldBe_True_Test()
+        {
+            Func<bool> func = () => { return 1 == 0; };
+
+            var funcResult = func.IsFalse();
+
+            Assert.IsNotNull(funcResult);
+            Assert.IsTrue(funcResult);
+        }
+
+        [TestMethod]
+        public void IsTrue_AsyncFunc_ShouldBe_True_Test()
+        {
+            Func<Task<bool>> func = async () => { return await Task.FromResult(1 == 1); };
+
+            var funcResult = func.IsTrue();
+
+            Assert.IsNotNull(funcResult);
+            Assert.IsTrue(funcResult);
+        }
+
+        [TestMethod]
+        public void IsFalse_AsyncFunc_ShouldBe_True_Test()
+        {
+            Func<Task<bool>> func = async () => { return await Task.FromResult(1 == 0); };
+
+            var funcResult = func.IsFalse();
+
+            Assert.IsNotNull(funcResult);
+            Assert.IsTrue(funcResult);
+        }
+    }
+}