// 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;
///
/// Option<T> 类型测试类
///
[TestFixture]
public class OptionTests
{
///
/// 测试Some方法使用值创建Some选项
///
[Test]
public void Some_WithValue_Should_Create_Some_Option()
{
var option = Option.Some(42);
Assert.That(option.IsSome, Is.True);
Assert.That(option.IsNone, Is.False);
}
///
/// 测试Some方法使用null值时抛出ArgumentNullException
///
[Test]
public void Some_WithNull_Should_Throw_ArgumentNullException()
{
Assert.Throws(() => Option.Some(null!));
}
///
/// 测试None方法创建None选项
///
[Test]
public void None_Should_Create_None_Option()
{
var option = Option.None;
Assert.That(option.IsSome, Is.False);
Assert.That(option.IsNone, Is.True);
}
///
/// 测试GetOrElse方法在Some时返回值
///
[Test]
public void GetOrElse_WithSome_Should_Return_Value()
{
var option = Option.Some(42);
var result = option.GetOrElse(0);
Assert.That(result, Is.EqualTo(42));
}
///
/// 测试GetOrElse方法在None时返回默认值
///
[Test]
public void GetOrElse_WithNone_Should_Return_Default_Value()
{
var option = Option.None;
var result = option.GetOrElse(99);
Assert.That(result, Is.EqualTo(99));
}
///
/// 测试带工厂的GetOrElse方法在Some时不调用工厂
///
[Test]
public void GetOrElse_WithFactory_WithSome_Should_Return_Value_Without_Calling_Factory()
{
var option = Option.Some(42);
var factoryCalled = false;
var result = option.GetOrElse(() =>
{
factoryCalled = true;
return 99;
});
Assert.That(result, Is.EqualTo(42));
Assert.That(factoryCalled, Is.False);
}
///
/// 测试带工厂的GetOrElse方法在None时调用工厂
///
[Test]
public void GetOrElse_WithFactory_WithNone_Should_Call_Factory()
{
var option = Option.None;
var result = option.GetOrElse(() => 99);
Assert.That(result, Is.EqualTo(99));
}
///
/// 测试GetOrElse方法在工厂为null时抛出ArgumentNullException
///
[Test]
public void GetOrElse_WithNullFactory_Should_Throw_ArgumentNullException()
{
var option = Option.None;
Assert.Throws(() => option.GetOrElse(null!));
}
///
/// 测试Map方法在Some时转换值
///
[Test]
public void Map_WithSome_Should_Map_Value()
{
var option = Option.Some(42);
var mapped = option.Map(x => x.ToString());
Assert.That(mapped.IsSome, Is.True);
Assert.That(mapped.GetOrElse(""), Is.EqualTo("42"));
}
///
/// 测试Map方法在None时返回None
///
[Test]
public void Map_WithNone_Should_Return_None()
{
var option = Option.None;
var mapped = option.Map(x => x.ToString());
Assert.That(mapped.IsNone, Is.True);
}
///
/// 测试Map方法在映射器为null时抛出ArgumentNullException
///
[Test]
public void Map_WithNullMapper_Should_Throw_ArgumentNullException()
{
var option = Option.Some(42);
Assert.Throws(() => option.Map(null!));
}
///
/// 测试Bind方法在Some时绑定值
///
[Test]
public void Bind_WithSome_Should_Bind_Value()
{
var option = Option.Some("42");
var bound = option.Bind(s => int.TryParse(s, out var i)
? Option.Some(i)
: Option.None);
Assert.That(bound.IsSome, Is.True);
Assert.That(bound.GetOrElse(0), Is.EqualTo(42));
}
///
/// 测试Bind方法在Some时可以返回None
///
[Test]
public void Bind_WithSome_Can_Return_None()
{
var option = Option.Some("invalid");
var bound = option.Bind(s => int.TryParse(s, out var i)
? Option.Some(i)
: Option.None);
Assert.That(bound.IsNone, Is.True);
}
///
/// 测试Bind方法在None时返回None
///
[Test]
public void Bind_WithNone_Should_Return_None()
{
var option = Option.None;
var bound = option.Bind(s => Option.Some(42));
Assert.That(bound.IsNone, Is.True);
}
///
/// 测试Bind方法在绑定器为null时抛出ArgumentNullException
///
[Test]
public void Bind_WithNullBinder_Should_Throw_ArgumentNullException()
{
var option = Option.Some(42);
Assert.Throws(() => option.Bind(null!));
}
///
/// 测试Filter方法在Some且谓词为true时返回Some
///
[Test]
public void Filter_WithSome_PredicateTrue_Should_Return_Some()
{
var option = Option.Some(42);
var filtered = option.Filter(x => x > 0);
Assert.That(filtered.IsSome, Is.True);
Assert.That(filtered.GetOrElse(0), Is.EqualTo(42));
}
///
/// 测试Filter方法在Some且谓词为false时返回None
///
[Test]
public void Filter_WithSome_PredicateFalse_Should_Return_None()
{
var option = Option.Some(42);
var filtered = option.Filter(x => x < 0);
Assert.That(filtered.IsNone, Is.True);
}
///
/// 测试Filter方法在None时返回None
///
[Test]
public void Filter_WithNone_Should_Return_None()
{
var option = Option.None;
var filtered = option.Filter(x => true);
Assert.That(filtered.IsNone, Is.True);
}
///
/// 测试Filter方法在谓词为null时抛出ArgumentNullException
///
[Test]
public void Filter_WithNullPredicate_Should_Throw_ArgumentNullException()
{
var option = Option.Some(42);
Assert.Throws(() => option.Filter(null!));
}
///
/// 测试Match方法在Some时调用some函数
///
[Test]
public void Match_WithSome_Should_Call_Some_Function()
{
var option = Option.Some(42);
var result = option.Match(
some: value => $"Value: {value}",
none: () => "No value"
);
Assert.That(result, Is.EqualTo("Value: 42"));
}
///
/// 测试Match方法在None时调用none函数
///
[Test]
public void Match_WithNone_Should_Call_None_Function()
{
var option = Option.None;
var result = option.Match(
some: value => $"Value: {value}",
none: () => "No value"
);
Assert.That(result, Is.EqualTo("No value"));
}
///
/// 测试Match方法在some函数为null时抛出ArgumentNullException
///
[Test]
public void Match_WithNullSomeFunction_Should_Throw_ArgumentNullException()
{
var option = Option.Some(42);
Assert.Throws(() =>
option.Match(null!, () => ""));
}
///
/// 测试Match方法在none函数为null时抛出ArgumentNullException
///
[Test]
public void Match_WithNullNoneFunction_Should_Throw_ArgumentNullException()
{
var option = Option.Some(42);
Assert.Throws(() =>
option.Match(value => "", null!));
}
///
/// 测试Match方法(Action形式)在Some时调用some操作
///
[Test]
public void Match_Action_WithSome_Should_Call_Some_Action()
{
var option = Option.Some(42);
var someCalled = false;
var noneCalled = false;
option.Match(
some: _ => someCalled = true,
none: () => noneCalled = true
);
Assert.That(someCalled, Is.True);
Assert.That(noneCalled, Is.False);
}
///
/// 测试Match方法(Action形式)在None时调用none操作
///
[Test]
public void Match_Action_WithNone_Should_Call_None_Action()
{
var option = Option.None;
var someCalled = false;
var noneCalled = false;
option.Match(
some: _ => someCalled = true,
none: () => noneCalled = true
);
Assert.That(someCalled, Is.False);
Assert.That(noneCalled, Is.True);
}
///
/// 测试ToResult方法在Some时返回成功结果
///
[Test]
public void ToResult_WithSome_Should_Return_Success_Result()
{
var option = Option.Some(42);
var result = option.ToResult("Error");
Assert.That(result.IsSuccess, Is.True);
Assert.That(result.Match(succ: v => v, fail: _ => 0), Is.EqualTo(42));
}
///
/// 测试ToResult方法在None时返回失败结果
///
[Test]
public void ToResult_WithNone_Should_Return_Failure_Result()
{
var option = Option.None;
var result = option.ToResult("Value not found");
Assert.That(result.IsFaulted, Is.True);
Assert.That(result.Exception, Is.TypeOf());
Assert.That(result.Exception.Message, Is.EqualTo("Value not found"));
}
///
/// 测试ToResult方法在消息为空或空白时抛出ArgumentException
///
[Test]
public void ToResult_WithNullOrWhiteSpaceMessage_Should_Throw_ArgumentException()
{
var option = Option.None;
Assert.Throws(() => option.ToResult(""));
Assert.Throws(() => option.ToResult(" "));
}
///
/// 测试ToEnumerable方法在Some时返回包含一个元素的序列
///
[Test]
public void ToEnumerable_WithSome_Should_Return_Sequence_With_One_Element()
{
var option = Option.Some(42);
var enumerable = option.ToEnumerable().ToList();
Assert.That(enumerable, Has.Count.EqualTo(1));
Assert.That(enumerable[0], Is.EqualTo(42));
}
///
/// 测试ToEnumerable方法在None时返回空序列
///
[Test]
public void ToEnumerable_WithNone_Should_Return_Empty_Sequence()
{
var option = Option.None;
var enumerable = option.ToEnumerable().ToList();
Assert.That(enumerable, Is.Empty);
}
///
/// 测试隐式转换从值创建Some选项
///
[Test]
public void ImplicitConversion_FromValue_Should_Create_Some_Option()
{
Option option = 42;
Assert.That(option.IsSome, Is.True);
Assert.That(option.GetOrElse(0), Is.EqualTo(42));
}
///
/// 测试隐式转换从null创建None选项
///
[Test]
public void ImplicitConversion_FromNull_Should_Create_None_Option()
{
Option option = null!;
Assert.That(option.IsNone, Is.True);
}
///
/// 测试Equals方法在两个Some值相同时返回true
///
[Test]
public void Equals_TwoSomeWithSameValue_Should_Return_True()
{
var option1 = Option.Some(42);
var option2 = Option.Some(42);
Assert.That(option1.Equals(option2), Is.True);
Assert.That(option1 == option2, Is.True);
Assert.That(option1 != option2, Is.False);
}
///
/// 测试Equals方法在两个Some值不同时返回false
///
[Test]
public void Equals_TwoSomeWithDifferentValue_Should_Return_False()
{
var option1 = Option.Some(42);
var option2 = Option.Some(99);
Assert.That(option1.Equals(option2), Is.False);
Assert.That(option1 == option2, Is.False);
Assert.That(option1 != option2, Is.True);
}
///
/// 测试Equals方法在两个None时返回true
///
[Test]
public void Equals_TwoNone_Should_Return_True()
{
var option1 = Option.None;
var option2 = Option.None;
Assert.That(option1.Equals(option2), Is.True);
Assert.That(option1 == option2, Is.True);
Assert.That(option1 != option2, Is.False);
}
///
/// 测试Equals方法在Some和None比较时返回false
///
[Test]
public void Equals_SomeAndNone_Should_Return_False()
{
var option1 = Option.Some(42);
var option2 = Option.None;
Assert.That(option1.Equals(option2), Is.False);
Assert.That(option1 == option2, Is.False);
Assert.That(option1 != option2, Is.True);
}
///
/// 测试GetHashCode方法在两个Some值相同时返回相同哈希码
///
[Test]
public void GetHashCode_TwoSomeWithSameValue_Should_Return_Same_HashCode()
{
var option1 = Option.Some(42);
var option2 = Option.Some(42);
Assert.That(option1.GetHashCode(), Is.EqualTo(option2.GetHashCode()));
}
///
/// 测试GetHashCode方法在两个None时返回相同哈希码
///
[Test]
public void GetHashCode_TwoNone_Should_Return_Same_HashCode()
{
var option1 = Option.None;
var option2 = Option.None;
Assert.That(option1.GetHashCode(), Is.EqualTo(option2.GetHashCode()));
}
///
/// 测试ToString方法在Some时返回格式化字符串
///
[Test]
public void ToString_WithSome_Should_Return_Formatted_String()
{
var option = Option.Some(42);
var result = option.ToString();
Assert.That(result, Is.EqualTo("Some(42)"));
}
///
/// 测试ToString方法在None时返回None
///
[Test]
public void ToString_WithNone_Should_Return_None()
{
var option = Option.None;
var result = option.ToString();
Assert.That(result, Is.EqualTo("None"));
}
}