using GFramework.Core.extensions;
using GFramework.Core.functional.pipe;
using NUnit.Framework;
namespace GFramework.Core.Tests.functional.pipe;
///
/// PipeExtensions扩展方法测试类,用于验证函数式编程扩展方法的正确性
/// 包括管道操作、函数组合、柯里化、模式匹配等多种函数式编程功能的测试
///
[TestFixture]
public class PipeExtensionsTests
{
#region Pipe Tests
///
/// 测试Pipe方法 - 验证值能够正确传递给函数并返回结果
///
[Test]
public void Pipe_Should_Execute_Function_And_Return_Result()
{
// Arrange
var value = 5;
// Act
var result = value.Pipe(x => x * 2);
// Assert
Assert.That(result, Is.EqualTo(10));
}
#endregion
#region Then Tests
///
/// 测试Then方法 - 验证两个函数能够正确组合执行
///
[Test]
public void Then_Should_Compose_Two_Functions()
{
// Arrange
Func addTwo = x => x + 2;
// Act
var composed = addTwo.Then((Func)MultiplyByThree);
var result = composed(5);
// Assert
Assert.That(result, Is.EqualTo(21)); // (5+2)*3 = 21
return;
int MultiplyByThree(int x) => x * 3;
}
#endregion
#region After Tests
///
/// 测试After方法 - 验证反向函数组合的正确性
///
[Test]
public void After_Should_Compose_Functions_In_Reversed_Order()
{
// Arrange
Func multiplyByThree = x => x * 3;
// Act
var composed = multiplyByThree.After((Func)AddTwo);
var result = composed(5);
// Assert
Assert.That(result, Is.EqualTo(21)); // (5+2)*3 = 21
return;
int AddTwo(int x) => x + 2;
}
#endregion
#region Tap Tests
///
/// 测试Tap方法 - 验证副作用操作执行后返回原值
///
[Test]
public void Tap_Should_Execute_Action_And_Return_Original_Value()
{
// Arrange
var value = 42;
var capturedValue = 0;
// Act
var result = value.Tap(x => capturedValue = x);
// Assert
Assert.That(result, Is.EqualTo(42));
Assert.That(capturedValue, Is.EqualTo(42));
}
#endregion
#region Map Tests
///
/// 测试Map方法 - 验证集合中的每个元素都能被正确转换
///
[Test]
public void Map_Should_Transform_Each_Element_In_Collection()
{
// Arrange
var numbers = new[] {1, 2, 3, 4};
// Act
var result = numbers.Map(x => x * x).ToArray();
// Assert
Assert.That(result, Is.EquivalentTo([1, 4, 9, 16]));
}
#endregion
#region Filter Tests
///
/// 测试Filter方法 - 验证集合能够根据条件正确过滤
///
[Test]
public void Filter_Should_Filter_Elements_Based_On_Predicate()
{
// Arrange
var numbers = new[] {1, 2, 3, 4, 5, 6};
// Act
var result = numbers.Filter(x => x % 2 == 0).ToArray();
// Assert
Assert.That(result, Is.EquivalentTo([2, 4, 6]));
}
#endregion
#region Reduce Tests
///
/// 测试Reduce方法 - 验证集合能够正确归约为单个值
///
[Test]
public void Reduce_Should_Reduce_Collection_To_Single_Value()
{
// Arrange
var numbers = new[] {1, 2, 3, 4};
// Act
var result = numbers.Reduce(0, (acc, x) => acc + x);
// Assert
Assert.That(result, Is.EqualTo(10));
}
#endregion
#region Apply Tests
///
/// 测试Apply方法 - 验证函数能够正确应用到参数上
///
[Test]
public void Apply_Should_Apply_Function_To_Argument()
{
// Arrange
Func multiplyByTwo = x => x * 2;
// Act
var result = multiplyByTwo.Apply(5);
// Assert
Assert.That(result, Is.EqualTo(10));
}
#endregion
#region Curry Tests
///
/// 测试Curry方法 - 验证二参数函数能够正确柯里化
///
[Test]
public void Curry_Should_Convert_Binary_Function_To_Curried_Form()
{
// Arrange
Func add = (x, y) => x + y;
// Act
var curriedAdd = add.Curry();
var addFive = curriedAdd(5);
var result = addFive(3);
// Assert
Assert.That(result, Is.EqualTo(8));
}
#endregion
#region Uncurry Tests
///
/// 测试Uncurry方法 - 验证柯里化函数能够正确还原为二参数函数
///
[Test]
public void Uncurry_Should_Convert_Curried_Function_Back_To_Binary_Form()
{
// Arrange
Func originalAdd = (x, y) => x + y;
var curriedAdd = originalAdd.Curry();
// Act
var uncurriedAdd = curriedAdd.Uncurry();
var result = uncurriedAdd(5, 3);
// Assert
Assert.That(result, Is.EqualTo(8));
}
#endregion
#region Partial Tests
///
/// 测试Partial方法 - 验证部分应用函数功能
///
[Test]
public void Partial_Should_Fix_First_Argument_Of_Binary_Function()
{
// Arrange
Func multiply = (x, y) => x * y;
// Act
var doubleFunction = multiply.Partial(2);
var result = doubleFunction(5);
// Assert
Assert.That(result, Is.EqualTo(10));
}
#endregion
#region Match Tests
///
/// 测试Match方法 - 验证模式匹配功能
///
[Test]
public void Match_Should_Execute_Matching_Case()
{
// Arrange
var value = 5;
// Act
var result = value.Match(
(x => x < 0, _ => "negative"),
(x => x > 0, _ => "positive"),
(x => x == 0, _ => "zero")
);
// Assert
Assert.That(result, Is.EqualTo("positive"));
}
///
/// 测试Match方法 - 验证无匹配时抛出异常
///
[Test]
public void Match_Should_Throw_Exception_When_No_Case_Matches()
{
// Arrange
var value = 10;
// Act & Assert
Assert.Throws(() =>
value.Match(
(x => x < 0, _ => "negative"),
(x => x > 10, _ => "large positive")
)
);
}
#endregion
#region MatchOrDefault Tests
///
/// 测试MatchOrDefault方法 - 验证模式匹配带默认值功能
///
[Test]
public void MatchOrDefault_Should_Execute_Matching_Case_Or_Return_Default()
{
// Arrange
var value = 10;
// Act
var result = value.MatchOrDefault("unknown",
(x => x < 0, _ => "negative"),
(x => x > 10, _ => "large positive")
);
// Assert
Assert.That(result, Is.EqualTo("unknown"));
}
#endregion
#region If Tests
///
/// 测试If方法 - 验证条件执行功能
///
[Test]
public void If_Should_Execute_ThenFunc_When_Condition_Is_True()
{
// Arrange
var value = 5;
// Act
var result = value.If(x => x > 0, x => x * 2);
// Assert
Assert.That(result, Is.EqualTo(10));
}
///
/// 测试If方法 - 验证条件为假时不执行转换函数
///
[Test]
public void If_Should_Return_Original_Value_When_Condition_Is_False()
{
// Arrange
var value = -5;
// Act
var result = value.If(x => x > 0, x => x * 2);
// Assert
Assert.That(result, Is.EqualTo(-5));
}
#endregion
#region IfElse Tests
///
/// 测试IfElse方法 - 验证条件分支功能
///
[Test]
public void IfElse_Should_Execute_ThenFunc_When_Condition_Is_True()
{
// Arrange
var value = 5;
// Act
var result = value.IfElse(
x => x > 0,
x => x * 2,
x => x * -1
);
// Assert
Assert.That(result, Is.EqualTo(10));
}
///
/// 测试IfElse方法 - 验证条件为假时执行else分支
///
[Test]
public void IfElse_Should_Execute_ElseFunc_When_Condition_Is_False()
{
// Arrange
var value = -5;
// Act
var result = value.IfElse(
x => x > 0,
x => x * 2,
x => x * -1
);
// Assert
Assert.That(result, Is.EqualTo(5));
}
#endregion
#region As Tests
///
/// 测试As方法 - 验证安全类型转换功能
///
[Test]
public void As_Should_Perform_Safe_Type_Cast()
{
// Arrange
object obj = "Hello";
// Act
var result = obj.As();
// Assert
Assert.That(result, Is.EqualTo("Hello"));
}
///
/// 测试As方法 - 验证不兼容类型转换返回null
///
[Test]
public void As_Should_Return_Null_For_Incompatible_Types()
{
// Arrange
object obj = 42;
// Act
var result = obj.As();
// Assert
Assert.That(result, Is.Null);
}
#endregion
#region Cast Tests
///
/// 测试Cast方法 - 验证强制类型转换功能
///
[Test]
public void Cast_Should_Perform_Forced_Type_Cast()
{
// Arrange
object obj = "Hello";
// Act
var result = obj.Cast();
// Assert
Assert.That(result, Is.EqualTo("Hello"));
}
#endregion
#region Also Tests
///
/// 测试Also方法 - 验证执行操作后返回原值功能
///
[Test]
public void Also_Should_Execute_Action_And_Return_Original_Value()
{
// Arrange
var value = 42;
var capturedValue = 0;
// Act
var result = value.Also(x => capturedValue = x);
// Assert
Assert.That(result, Is.EqualTo(42));
Assert.That(capturedValue, Is.EqualTo(42));
}
#endregion
#region Let Tests
///
/// 测试Let方法 - 验证值转换功能
///
[Test]
public void Let_Should_Transform_Value()
{
// Arrange
var value = 5;
// Act
var result = value.Let(x => x * 2);
// Assert
Assert.That(result, Is.EqualTo(10));
}
#endregion
#region TakeIf Tests
///
/// 测试TakeIf方法 - 验证条件为真时返回原值
///
[Test]
public void TakeIf_Should_Return_Value_When_Condition_Is_True()
{
// Arrange
string str = "Hello";
// Act
var result = str.TakeIf(s => s.Length > 3);
// Assert
Assert.That(result, Is.EqualTo("Hello"));
}
///
/// 测试TakeIf方法 - 验证条件为假时返回null
///
[Test]
public void TakeIf_Should_Return_Null_When_Condition_Is_False()
{
// Arrange
string str = "Hi";
// Act
var result = str.TakeIf(s => s.Length > 3);
// Assert
Assert.That(result, Is.Null);
}
#endregion
#region TakeUnless Tests
///
/// 测试TakeUnless方法 - 验证条件为假时返回原值
///
[Test]
public void TakeUnless_Should_Return_Value_When_Condition_Is_False()
{
// Arrange
string str = "Hi";
// Act
var result = str.TakeUnless(s => s.Length > 3);
// Assert
Assert.That(result, Is.EqualTo("Hi"));
}
///
/// 测试TakeUnless方法 - 验证条件为真时返回null
///
[Test]
public void TakeUnless_Should_Return_Null_When_Condition_Is_True()
{
// Arrange
string str = "Hello";
// Act
var result = str.TakeUnless(s => s.Length > 3);
// Assert
Assert.That(result, Is.Null);
}
#endregion
#region Repeat Tests
///
/// 测试Repeat方法 - 验证重复执行函数功能
///
[Test]
public void Repeat_Should_Execute_Function_N_Times()
{
// Arrange
var initialValue = 2;
// Act
var result = initialValue.Repeat(3, x => x * 2);
// Assert
// 2 -> 4 -> 8 -> 16 (3次重复)
Assert.That(result, Is.EqualTo(16));
}
#endregion
#region Try Tests
///
/// 测试Try方法 - 验证安全执行成功情况
///
[Test]
public void Try_Should_Return_Success_When_Function_Does_Not_Throw()
{
// Arrange
var value = 10;
// Act
var (success, result, error) = value.Try(x => 100 / x);
// Assert
Assert.That(success, Is.True);
Assert.That(result, Is.EqualTo(10));
Assert.That(error, Is.Null);
}
///
/// 测试Try方法 - 验证安全执行异常情况
///
[Test]
public void Try_Should_Return_Failure_When_Function_Throws()
{
// Arrange
var value = 0;
// Act
var (success, result, error) = value.Try(x => 100 / x);
// Assert
Assert.That(success, Is.False);
Assert.That(result, Is.EqualTo(0)); // 对于int类型,默认值是0
Assert.That(error, Is.Not.Null);
Assert.That(error, Is.TypeOf());
}
#endregion
#region Memoize Tests
///
/// 测试Memoize方法 - 验证函数结果缓存功能
///
[Test]
public void Memoize_Should_Cache_Function_Results()
{
// Arrange
var callCount = 0;
Func expensiveFunction = x =>
{
callCount++;
return x * x;
};
var memoized = expensiveFunction.Memoize();
// Act
var result1 = memoized(5); // 第一次调用
var result2 = memoized(5); // 第二次调用,应该使用缓存
var result3 = memoized(3); // 新参数,应该调用函数
var result4 = memoized(3); // 再次使用相同参数,应该使用缓存
// Assert
Assert.That(result1, Is.EqualTo(25));
Assert.That(result2, Is.EqualTo(25));
Assert.That(result3, Is.EqualTo(9));
Assert.That(result4, Is.EqualTo(9));
Assert.That(callCount, Is.EqualTo(2)); // 只应调用两次,而不是四次
}
#endregion
}