// 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