// Copyright (c) 2025 GeWuYou // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. using GFramework.Core.functional; using NUnit.Framework; namespace GFramework.Core.Tests.functional; /// /// Result<A> 泛型类型测试类 /// [TestFixture] public class ResultTTests { /// /// 测试构造函数使用值创建成功结果 /// [Test] public void Constructor_WithValue_Should_Create_Success_Result() { var result = new Result(42); Assert.That(result.IsSuccess, Is.True); Assert.That(result.IsFaulted, Is.False); Assert.That(result.IsBottom, Is.False); } /// /// 测试构造函数使用异常创建失败结果 /// [Test] public void Constructor_WithException_Should_Create_Faulted_Result() { var exception = new InvalidOperationException("Test error"); var result = new Result(exception); Assert.That(result.IsFaulted, Is.True); Assert.That(result.IsSuccess, Is.False); Assert.That(result.Exception, Is.SameAs(exception)); } /// /// 测试构造函数使用null异常时抛出ArgumentNullException /// [Test] public void Constructor_WithNullException_Should_Throw_ArgumentNullException() { Assert.Throws(() => new Result(null!)); } /// /// 测试默认构造函数创建Bottom状态 /// [Test] public void DefaultConstructor_Should_Create_Bottom_State() { var result = new Result(); Assert.That(result.IsBottom, Is.True); Assert.That(result.IsSuccess, Is.False); Assert.That(result.IsFaulted, Is.False); } /// /// 测试隐式转换创建成功结果 /// [Test] public void ImplicitConversion_Should_Create_Success_Result() { Result result = 42; Assert.That(result.IsSuccess, Is.True); Assert.That(result.Match(succ: v => v, fail: _ => 0), Is.EqualTo(42)); } /// /// 测试IsSuccess属性在成功时返回true /// [Test] public void IsSuccess_Should_Return_True_When_Result_Is_Successful() { var result = Result.Succeed(42); Assert.That(result.IsSuccess, Is.True); } /// /// 测试IsFaulted属性在失败时返回true /// [Test] public void IsFaulted_Should_Return_True_When_Result_Is_Faulted() { var result = Result.Fail(new Exception("Error")); Assert.That(result.IsFaulted, Is.True); } /// /// 测试IsBottom属性在Bottom状态时返回true /// [Test] public void IsBottom_Should_Return_True_When_Result_Is_Bottom() { var result = Result.Bottom; Assert.That(result.IsBottom, Is.True); } /// /// 测试Exception属性在失败时返回异常 /// [Test] public void Exception_Should_Return_Exception_When_Faulted() { var exception = new InvalidOperationException("Test"); var result = Result.Fail(exception); Assert.That(result.Exception, Is.SameAs(exception)); } /// /// 测试Exception属性在Bottom状态时返回InvalidOperationException /// [Test] public void Exception_Should_Return_InvalidOperationException_When_Bottom() { var result = Result.Bottom; Assert.That(result.Exception, Is.TypeOf()); } /// /// 测试Exception属性在成功时返回InvalidOperationException /// [Test] public void Exception_Should_Return_InvalidOperationException_When_Success() { var result = Result.Succeed(42); Assert.That(result.Exception, Is.TypeOf()); } /// /// 测试Succeed方法创建成功结果 /// [Test] public void Succeed_Should_Create_Successful_Result() { var result = Result.Succeed(42); Assert.That(result.IsSuccess, Is.True); Assert.That(result.Match(succ: v => v, fail: _ => 0), Is.EqualTo(42)); } /// /// 测试Success方法创建成功结果 /// [Test] public void Success_Should_Create_Successful_Result() { var result = Result.Success(42); Assert.That(result.IsSuccess, Is.True); Assert.That(result.Match(succ: v => v, fail: _ => 0), Is.EqualTo(42)); } /// /// 测试Fail方法创建失败结果 /// [Test] public void Fail_Should_Create_Faulted_Result() { var exception = new Exception("Error"); var result = Result.Fail(exception); Assert.That(result.IsFaulted, Is.True); Assert.That(result.Exception, Is.SameAs(exception)); } /// /// 测试Failure方法使用异常创建失败结果 /// [Test] public void Failure_WithException_Should_Create_Faulted_Result() { var exception = new Exception("Error"); var result = Result.Failure(exception); Assert.That(result.IsFaulted, Is.True); Assert.That(result.Exception, Is.SameAs(exception)); } /// /// 测试Failure方法使用消息创建失败结果 /// [Test] public void Failure_WithMessage_Should_Create_Faulted_Result() { var message = "Test error"; var result = Result.Failure(message); Assert.That(result.IsFaulted, Is.True); Assert.That(result.Exception.Message, Is.EqualTo(message)); } /// /// 测试Try方法在函数成功时返回成功结果 /// [Test] public void Try_Should_Return_Success_When_Function_Succeeds() { var result = Result.Try(() => 42); Assert.That(result.IsSuccess, Is.True); Assert.That(result.Match(succ: v => v, fail: _ => 0), Is.EqualTo(42)); } /// /// 测试Try方法在函数抛出异常时返回失败结果 /// [Test] public void Try_Should_Return_Failure_When_Function_Throws() { var result = Result.Try(() => throw new InvalidOperationException("Error")); Assert.That(result.IsFaulted, Is.True); Assert.That(result.Exception, Is.TypeOf()); } /// /// 测试IfFail方法使用默认值在成功时返回值 /// [Test] public void IfFail_WithDefaultValue_Should_Return_Value_When_Success() { var result = Result.Succeed(42); var value = result.IfFail(0); Assert.That(value, Is.EqualTo(42)); } /// /// 测试IfFail方法使用默认值在失败时返回默认值 /// [Test] public void IfFail_WithDefaultValue_Should_Return_Default_When_Faulted() { var result = Result.Fail(new Exception("Error")); var value = result.IfFail(99); Assert.That(value, Is.EqualTo(99)); } /// /// 测试IfFail方法使用函数在成功时返回值 /// [Test] public void IfFail_WithFunction_Should_Return_Value_When_Success() { var result = Result.Succeed(42); var value = result.IfFail(_ => 0); Assert.That(value, Is.EqualTo(42)); } /// /// 测试IfFail方法使用函数在失败时执行函数 /// [Test] public void IfFail_WithFunction_Should_Execute_Function_When_Faulted() { var exception = new Exception("Error"); var result = Result.Fail(exception); var executed = false; var value = result.IfFail(ex => { executed = true; return 99; }); Assert.That(executed, Is.True); Assert.That(value, Is.EqualTo(99)); } /// /// 测试IfFail方法使用Action在失败时执行操作 /// [Test] public void IfFail_WithAction_Should_Execute_Action_When_Faulted() { var result = Result.Fail(new Exception("Error")); var executed = false; result.IfFail(_ => executed = true); Assert.That(executed, Is.True); } /// /// 测试IfSucc方法在成功时执行操作 /// [Test] public void IfSucc_Should_Execute_Action_When_Success() { var result = Result.Succeed(42); var executed = false; result.IfSucc(_ => executed = true); Assert.That(executed, Is.True); } /// /// 测试IfSucc方法在失败时不执行操作 /// [Test] public void IfSucc_Should_Not_Execute_Action_When_Faulted() { var result = Result.Fail(new Exception("Error")); var executed = false; result.IfSucc(_ => executed = true); Assert.That(executed, Is.False); } /// /// 测试Map方法在成功时转换值 /// [Test] public void Map_Should_Transform_Value_When_Success() { var result = Result.Succeed(42); var mapped = result.Map(x => x.ToString()); Assert.That(mapped.IsSuccess, Is.True); Assert.That(mapped.Match(succ: v => v, fail: _ => ""), Is.EqualTo("42")); } /// /// 测试Map方法在失败时传播异常 /// [Test] public void Map_Should_Propagate_Exception_When_Faulted() { var exception = new Exception("Error"); var result = Result.Fail(exception); var mapped = result.Map(x => x.ToString()); Assert.That(mapped.IsFaulted, Is.True); Assert.That(mapped.Exception, Is.SameAs(exception)); } /// /// 测试Map方法处理null结果 /// [Test] public void Map_Should_Handle_Null_Result_From_Mapper() { var result = Result.Succeed(42); var mapped = result.Map(_ => null!); Assert.That(mapped.IsSuccess, Is.True); } /// /// 测试Map方法在映射器返回null时不抛出异常 /// [Test] public void Map_Should_Not_Throw_When_Mapper_Returns_Null() { var result = Result.Succeed("test"); Assert.DoesNotThrow(() => result.Map(_ => null)); } /// /// 测试Bind方法链接成功结果 /// [Test] public void Bind_Should_Chain_Success_Results() { var result = Result.Succeed(42); var bound = result.Bind(x => Result.Succeed(x.ToString())); Assert.That(bound.IsSuccess, Is.True); Assert.That(bound.Match(succ: v => v, fail: _ => ""), Is.EqualTo("42")); } /// /// 测试Bind方法传播第一个失败 /// [Test] public void Bind_Should_Propagate_First_Failure() { var exception = new Exception("Error"); var result = Result.Fail(exception); var bound = result.Bind(x => Result.Succeed(x.ToString())); Assert.That(bound.IsFaulted, Is.True); Assert.That(bound.Exception, Is.SameAs(exception)); } /// /// 测试Bind方法传播第二个失败 /// [Test] public void Bind_Should_Propagate_Second_Failure() { var result = Result.Succeed(42); var exception = new Exception("Bind error"); var bound = result.Bind(x => Result.Fail(exception)); Assert.That(bound.IsFaulted, Is.True); Assert.That(bound.Exception, Is.SameAs(exception)); } /// /// 测试Bind方法处理复杂链接 /// [Test] public void Bind_Should_Handle_Complex_Chaining() { var result = Result.Succeed(10) .Bind(x => Result.Succeed(x * 2)) .Bind(x => Result.Succeed(x + 5)); Assert.That(result.IsSuccess, Is.True); Assert.That(result.Match(succ: v => v, fail: _ => 0), Is.EqualTo(25)); } /// /// 测试MapAsync方法在成功时异步转换值 /// [Test] public async Task MapAsync_Should_Transform_Value_When_Success() { var result = Result.Succeed(42); var mapped = await result.MapAsync(async x => { await Task.Delay(1); return x.ToString(); }); Assert.That(mapped.IsSuccess, Is.True); Assert.That(mapped.Match(succ: v => v, fail: _ => ""), Is.EqualTo("42")); } /// /// 测试MapAsync方法在失败时传播异常 /// [Test] public async Task MapAsync_Should_Propagate_Exception_When_Faulted() { var exception = new Exception("Error"); var result = Result.Fail(exception); var mapped = await result.MapAsync(async x => { await Task.Delay(1); return x.ToString(); }); Assert.That(mapped.IsFaulted, Is.True); Assert.That(mapped.Exception, Is.SameAs(exception)); } /// /// 测试MapAsync方法处理异步异常 /// [Test] public async Task MapAsync_Should_Handle_Async_Exceptions() { var result = Result.Succeed(42); var mapped = await result.MapAsync(async _ => { await Task.Delay(1); throw new InvalidOperationException("Async error"); }); Assert.That(mapped.IsFaulted, Is.True); Assert.That(mapped.Exception, Is.TypeOf()); } /// /// 测试Match方法使用函数在成功时执行succ函数 /// [Test] public void Match_WithFunctions_Should_Execute_Succ_When_Success() { var result = Result.Succeed(42); var value = result.Match(succ: x => x * 2, fail: _ => 0); Assert.That(value, Is.EqualTo(84)); } /// /// 测试Match方法使用函数在失败时执行fail函数 /// [Test] public void Match_WithFunctions_Should_Execute_Fail_When_Faulted() { var result = Result.Fail(new Exception("Error")); var value = result.Match(succ: x => x, fail: _ => 99); Assert.That(value, Is.EqualTo(99)); } /// /// 测试Match方法使用Action在成功时执行succ操作 /// [Test] public void Match_WithActions_Should_Execute_Succ_When_Success() { var result = Result.Succeed(42); var executed = false; result.Match(succ: _ => executed = true, fail: _ => { }); Assert.That(executed, Is.True); } /// /// 测试Match方法使用Action在失败时执行fail操作 /// [Test] public void Match_WithActions_Should_Execute_Fail_When_Faulted() { var result = Result.Fail(new Exception("Error")); var executed = false; result.Match(succ: _ => { }, fail: _ => executed = true); Assert.That(executed, Is.True); } /// /// 测试Match方法正确处理Bottom状态 /// [Test] public void Match_Should_Handle_Bottom_State_Correctly() { var result = Result.Bottom; var value = result.Match(succ: x => x, fail: _ => 99); Assert.That(value, Is.EqualTo(99)); } /// /// 测试Equals方法在两个成功值相同时返回true /// [Test] public void Equals_Should_Return_True_When_Both_Success_With_Same_Value() { var result1 = Result.Succeed(42); var result2 = Result.Succeed(42); Assert.That(result1.Equals(result2), Is.True); } /// /// 测试Equals方法在成功值不同时返回false /// [Test] public void Equals_Should_Return_False_When_Success_Values_Differ() { var result1 = Result.Succeed(42); var result2 = Result.Succeed(43); Assert.That(result1.Equals(result2), Is.False); } /// /// 测试Equals方法在两个失败且异常相同时返回true /// [Test] public void Equals_Should_Return_True_When_Both_Faulted_With_Same_Exception() { var result1 = Result.Fail(new InvalidOperationException("Error")); var result2 = Result.Fail(new InvalidOperationException("Error")); Assert.That(result1.Equals(result2), Is.True); } /// /// 测试Equals方法在异常类型不同时返回false /// [Test] public void Equals_Should_Return_False_When_Exception_Types_Differ() { var result1 = Result.Fail(new InvalidOperationException("Error")); var result2 = Result.Fail(new ArgumentException("Error")); Assert.That(result1.Equals(result2), Is.False); } /// /// 测试Equals方法在两个都是Bottom时返回true /// [Test] public void Equals_Should_Return_True_When_Both_Bottom() { var result1 = Result.Bottom; var result2 = new Result(); Assert.That(result1.Equals(result2), Is.True); } /// /// 测试Equals方法在状态不同时返回false /// [Test] public void Equals_Should_Return_False_When_States_Differ() { var result1 = Result.Succeed(42); var result2 = Result.Fail(new Exception("Error")); Assert.That(result1.Equals(result2), Is.False); } /// /// 测试GetHashCode方法在相等结果时返回一致的哈希码 /// [Test] public void GetHashCode_Should_Be_Consistent_For_Equal_Results() { var result1 = Result.Succeed(42); var result2 = Result.Succeed(42); Assert.That(result1.GetHashCode(), Is.EqualTo(result2.GetHashCode())); } /// /// 测试==操作符正确工作 /// [Test] public void OperatorEquals_Should_Work_Correctly() { var result1 = Result.Succeed(42); var result2 = Result.Succeed(42); var result3 = Result.Succeed(43); Assert.That(result1 == result2, Is.True); Assert.That(result1 == result3, Is.False); } /// /// 测试!=操作符正确工作 /// [Test] public void OperatorNotEquals_Should_Work_Correctly() { var result1 = Result.Succeed(42); var result2 = Result.Succeed(43); Assert.That(result1 != result2, Is.True); } /// /// 测试CompareTo方法排序Bottom在失败之前 /// [Test] public void CompareTo_Should_Order_Bottom_Before_Faulted() { var bottom = Result.Bottom; var faulted = Result.Fail(new Exception("Error")); Assert.That(bottom.CompareTo(faulted), Is.LessThan(0)); } /// /// 测试CompareTo方法排序失败在成功之前 /// [Test] public void CompareTo_Should_Order_Faulted_Before_Success() { var faulted = Result.Fail(new Exception("Error")); var success = Result.Succeed(42); Assert.That(faulted.CompareTo(success), Is.LessThan(0)); } /// /// 测试CompareTo方法在两个成功时比较值 /// [Test] public void CompareTo_Should_Compare_Success_Values_When_Both_Success() { var result1 = Result.Succeed(10); var result2 = Result.Succeed(20); Assert.That(result1.CompareTo(result2), Is.LessThan(0)); } /// /// 测试CompareTo方法在两个都失败时返回0 /// [Test] public void CompareTo_Should_Return_Zero_When_Both_Faulted() { var result1 = Result.Fail(new Exception("Error1")); var result2 = Result.Fail(new Exception("Error2")); Assert.That(result1.CompareTo(result2), Is.EqualTo(0)); } /// /// 测试CompareTo方法在两个都是Bottom时返回0 /// [Test] public void CompareTo_Should_Return_Zero_When_Both_Bottom() { var result1 = Result.Bottom; var result2 = new Result(); Assert.That(result1.CompareTo(result2), Is.EqualTo(0)); } /// /// 测试<操作符正确工作 /// [Test] public void OperatorLessThan_Should_Work_Correctly() { var result1 = Result.Succeed(10); var result2 = Result.Succeed(20); Assert.That(result1 < result2, Is.True); } /// /// 测试<=操作符正确工作 /// [Test] public void OperatorLessThanOrEqual_Should_Work_Correctly() { var result1 = Result.Succeed(10); var result2 = Result.Succeed(10); Assert.That(result1 <= result2, Is.True); } /// /// 测试>操作符正确工作 /// [Test] public void OperatorGreaterThan_Should_Work_Correctly() { var result1 = Result.Succeed(20); var result2 = Result.Succeed(10); Assert.That(result1 > result2, Is.True); } /// /// 测试>=操作符正确工作 /// [Test] public void OperatorGreaterThanOrEqual_Should_Work_Correctly() { var result1 = Result.Succeed(20); var result2 = Result.Succeed(20); Assert.That(result1 >= result2, Is.True); } /// /// 测试CompareTo方法优雅处理不可比较类型 /// [Test] public void CompareTo_Should_Handle_NonComparable_Types_Gracefully() { var result1 = Result.Succeed(new object()); var result2 = Result.Succeed(new object()); Assert.DoesNotThrow(() => result1.CompareTo(result2)); } /// /// 测试ToString方法在成功时返回值字符串 /// [Test] public void ToString_Should_Return_Value_String_When_Success() { var result = Result.Succeed(42); Assert.That(result.ToString(), Is.EqualTo("42")); } /// /// 测试ToString方法在失败时返回失败消息 /// [Test] public void ToString_Should_Return_Fail_Message_When_Faulted() { var result = Result.Fail(new Exception("Test error")); Assert.That(result.ToString(), Is.EqualTo("Fail(Test error)")); } /// /// 测试ToString方法在Bottom时返回Bottom /// [Test] public void ToString_Should_Return_Bottom_When_Bottom() { var result = Result.Bottom; Assert.That(result.ToString(), Is.EqualTo("(Bottom)")); } /// /// 测试Success方法使用null值创建有效结果 /// [Test] public void Success_WithNullValue_Should_Create_Valid_Result() { var result = Result.Succeed(null); Assert.That(result.IsSuccess, Is.True); } /// /// 测试Map方法正确处理null值 /// [Test] public void Map_WithNullValue_Should_Handle_Correctly() { var result = Result.Succeed(null); var mapped = result.Map(x => x?.Length ?? 0); Assert.That(mapped.IsSuccess, Is.True); Assert.That(mapped.Match(succ: v => v, fail: _ => -1), Is.EqualTo(0)); } /// /// 测试Equals方法null值正确工作 /// [Test] public void Equals_WithNullValues_Should_Work_Correctly() { var result1 = Result.Succeed(null); var result2 = Result.Succeed(null); Assert.That(result1.Equals(result2), Is.True); } /// /// 测试隐式转换null创建成功的null值 /// [Test] public void ImplicitConversion_WithNull_Should_Create_Success_With_Null() { Result result = null; Assert.That(result.IsSuccess, Is.True); } /// /// 测试Bottom是只读和不可变的 /// [Test] public void Bottom_Should_Be_Readonly_And_Immutable() { var bottom1 = Result.Bottom; var bottom2 = Result.Bottom; Assert.That(bottom1.Equals(bottom2), Is.True); } }