feat: initial project commit

src/Result.Tests/ErrorTests.cs

@@ -0,0 +1,30 @@
+namespace Geekeey.Extensions.Result.Tests;
+
+[TestFixture]
+internal sealed class ErrorTests
+{
+	[Test]
+	public void ImplicitConversion_FromString_ReturnsStringError()
+	{
+		Error error = "error";
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(error, Is.InstanceOf<StringError>());
+			Assert.That(error.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public void ImplicitConversion_FromException_ReturnsExceptionError()
+	{
+		Error error = new CustomTestException();
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(error, Is.InstanceOf<ExceptionError>());
+			var instance = error as ExceptionError;
+			Assert.That(instance?.Exception, Is.InstanceOf<CustomTestException>());
+		});
+	}
+}

src/Result.Tests/ExtensionsEnumerableTests.cs

@@ -0,0 +1,54 @@
+namespace Geekeey.Extensions.Result.Tests;
+
+[TestFixture]
+internal sealed class ExtensionsEnumerableTests
+{
+	[Test]
+	public void Join_ReturnsAllSuccess_ForSequenceContainingAllSuccess()
+	{
+		IEnumerable<Result<int>> xs = [1, 2, 3, 4, 5];
+
+		var result = xs.Join();
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.True);
+			Assert.That(result.Value, Is.EquivalentTo(new[] { 1, 2, 3, 4, 5 }));
+		});
+	}
+
+	[Test]
+	public void Join_ReturnsFirstFailure_ForSequenceContainingFailure()
+	{
+		IEnumerable<Result<int>> xs =
+		[
+			Success(1),
+			Success(2),
+			Failure<int>("error 1"),
+			Success(4),
+			Failure<int>("error 2")
+		];
+
+		var result = xs.Join();
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error?.Message, Is.EqualTo("error 1"));
+		});
+	}
+
+	[Test]
+	public void Join_ReturnsSuccess_ForEmptySequence()
+	{
+		IEnumerable<Result<int>> xs = [];
+
+		var result = xs.Join();
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.True);
+			Assert.That(result.Value, Is.Empty);
+		});
+	}
+}

src/Result.Tests/Fixtures/CustomTestError.cs

@@ -0,0 +1,7 @@
+namespace Geekeey.Extensions.Result.Tests;
+
+internal sealed class CustomTestError : Error
+{
+	internal const string DefaultMessage = "This is a custom error for test";
+	public override string Message => DefaultMessage;
+}

src/Result.Tests/Fixtures/CustomTestException.cs

@@ -0,0 +1,5 @@
+namespace Geekeey.Extensions.Result.Tests;
+
+internal sealed class CustomTestException : Exception
+{
+}

src/Result.Tests/PreludeTests.cs

@@ -0,0 +1,119 @@
+namespace Geekeey.Extensions.Result.Tests;
+
+[TestFixture]
+internal sealed class PreludeTests
+{
+	[Test]
+	public void Try_ReturnsSuccess_WithoutThrowing()
+	{
+		var result = Try(() => 2);
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.True);
+			Assert.That(result.Value, Is.EqualTo(2));
+		});
+	}
+
+	[Test]
+	public void Try_ReturnsFailure_WithThrowing()
+	{
+		var result = Try<int>(() => throw new CustomTestException());
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<ExceptionError>());
+			var instance = result.Error as ExceptionError;
+			Assert.That(instance?.Exception, Is.InstanceOf<CustomTestException>());
+		});
+	}
+
+	[Test]
+	public async Task TryAsync_ReturnsSuccess_WithoutThrowing_Task()
+	{
+		var result = await TryAsync(() => Task.FromResult(2));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.True);
+			Assert.That(result.Value, Is.EqualTo(2));
+		});
+	}
+
+	[Test]
+	public async Task TryAsync_ReturnsFailure_WithThrowing_Task()
+	{
+		var result = await TryAsync(Task<int> () => throw new CustomTestException());
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<ExceptionError>());
+			var instance = result.Error as ExceptionError;
+			Assert.That(instance?.Exception, Is.InstanceOf<CustomTestException>());
+		});
+	}
+
+	[Test]
+	public async Task TryAsync_ReturnsFailure_WithAwaitThrowing_Task()
+	{
+		var result = await TryAsync(async Task<int> () =>
+		{
+			await Task.CompletedTask;
+			throw new CustomTestException();
+		});
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<ExceptionError>());
+			var instance = result.Error as ExceptionError;
+			Assert.That(instance?.Exception, Is.InstanceOf<CustomTestException>());
+		});
+	}
+
+	[Test]
+	public async Task TryAsync_ReturnsSuccess_WithoutThrowing_ValueTask()
+	{
+		var result = await TryAsync(() => ValueTask.FromResult(2));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.True);
+			Assert.That(result.Value, Is.EqualTo(2));
+		});
+	}
+
+	[Test]
+	public async Task TryAsync_ReturnsFailure_WithThrowing_ValueTask()
+	{
+		var result = await TryAsync(ValueTask<int> () => throw new CustomTestException());
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<ExceptionError>());
+			var instance = result.Error as ExceptionError;
+			Assert.That(instance?.Exception, Is.InstanceOf<CustomTestException>());
+		});
+	}
+
+	[Test]
+	public async Task TryAsync_ReturnsFailure_WithAwaitThrowing_ValueTask()
+	{
+		var result = await TryAsync(async ValueTask<int> () =>
+		{
+			await Task.CompletedTask;
+			throw new CustomTestException();
+		});
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<ExceptionError>());
+			var instance = result.Error as ExceptionError;
+			Assert.That(instance?.Exception, Is.InstanceOf<CustomTestException>());
+		});
+	}
+}

src/Result.Tests/Result.Tests.csproj

@@ -0,0 +1,25 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <IsPackable>false</IsPackable>
+    <IsTestProject>true</IsTestProject>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <Using Include="NUnit.Framework" />
+    <Using Include="Geekeey.Extensions.Result.Prelude" Static="true" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.NET.Test.Sdk" />
+    <PackageReference Include="NUnit" />
+    <PackageReference Include="NUnit3TestAdapter" />
+    <PackageReference Include="NUnit.Analyzers" />
+    <PackageReference Include="coverlet.collector" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\Result\Result.csproj" />
+  </ItemGroup>
+
+</Project>

src/Result.Tests/ResultConversionTests.cs

@@ -0,0 +1,66 @@
+namespace Geekeey.Extensions.Result.Tests;
+
+[TestFixture]
+internal sealed class ResultConversionTests
+{
+	[Test]
+	public void ImplicitConversion_FromValue_IsSuccess()
+	{
+		var result = Success(2);
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.True);
+			Assert.That(result.IsFailure, Is.False);
+			Assert.That(result.Value, Is.EqualTo(2));
+		});
+	}
+
+	[Test]
+	public void ImplicitConversion_FromError_IsFailure()
+	{
+		var error = new CustomTestError();
+		var result = Failure<int>(error);
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.IsFailure, Is.True);
+			Assert.That(result.Error, Is.InstanceOf<CustomTestError>());
+		});
+	}
+
+	[Test]
+	public void Unwrap_ReturnsValue_ForSuccess()
+	{
+		var result = Success(2);
+		var value = result.Unwrap();
+
+		Assert.That(value, Is.EqualTo(2));
+	}
+
+	[Test]
+	public void Unwrap_Throws_ForFailure()
+	{
+		var result = Failure<int>("error");
+
+		Assert.That(() => result.Unwrap(), Throws.InstanceOf<UnwrapException>());
+	}
+
+	[Test]
+	public void ExplicitConversion_ReturnsValue_ForSuccess()
+	{
+		var result = Success(2);
+		var value = (int)result;
+
+		Assert.That(value, Is.EqualTo(2));
+	}
+
+	[Test]
+	public void ExplicitConversion_Throws_ForFailure()
+	{
+		var result = Failure<int>("error");
+
+		Assert.That(() => (int)result, Throws.InstanceOf<UnwrapException>());
+	}
+}

src/Result.Tests/ResultEqualityTests.cs

@@ -0,0 +1,173 @@
+namespace Geekeey.Extensions.Result.Tests;
+
+[TestFixture]
+internal sealed class ResultEqualityTests
+{
+	[Test]
+	public void Equals_T_ReturnsTrue_ForSuccessAndEqualValue()
+	{
+		var a = Success(2);
+		var b = 2;
+
+		Assert.That(a.Equals(b), Is.True);
+	}
+
+	[Test]
+	public void Equals_T_ReturnsFalse_ForSuccessAndUnequalValue()
+	{
+		var a = Success(2);
+		var b = 3;
+
+		Assert.That(a.Equals(b), Is.False);
+	}
+
+	[Test]
+	public void Equals_T_ReturnsFalse_ForFailure()
+	{
+		var a = Failure<int>("error");
+		var b = 2;
+
+		Assert.That(a.Equals(b), Is.False);
+	}
+
+	[Test]
+	public void Equals_Result_ReturnsTrue_ForSuccessAndSuccessAndEqualValue()
+	{
+		var a = Success(2);
+		var b = Success(2);
+
+		Assert.That(a.Equals(b), Is.True);
+	}
+
+	[Test]
+	public void Equals_Result_ReturnsFalse_ForSuccessAndSuccessAndUnequalValue()
+	{
+		var a = Success(2);
+		var b = Success(3);
+
+		Assert.That(a.Equals(b), Is.False);
+	}
+
+	[Test]
+	public void Equals_Result_ReturnsFalse_ForSuccessAndFailure()
+	{
+		var a = Success(2);
+		var b = Failure<int>("error 1");
+
+		Assert.That(a.Equals(b), Is.False);
+	}
+
+	[Test]
+	public void Equals_Result_ReturnsFalse_ForFailureAndSuccess()
+	{
+		var a = Failure<int>("error");
+		var b = Success(2);
+
+		Assert.That(a.Equals(b), Is.False);
+	}
+
+	[Test]
+	public void Equals_Result_ReturnsTrue_ForFailureAndFailure()
+	{
+		var a = Failure<int>("error 1");
+		var b = Failure<int>("error 2");
+
+		Assert.That(a.Equals(b), Is.True);
+	}
+
+	[Test]
+	public void Equals_T_ReturnsTrue_ForSuccessAndEqualValue_WithComparer()
+	{
+		var a = Success(2);
+		var b = 2;
+
+		Assert.That(a.Equals(b, EqualityComparer<int>.Default), Is.True);
+	}
+
+	[Test]
+	public void Equals_T_ReturnsFalse_ForSuccessAndUnequalValue_WithComparer()
+	{
+		var a = Success(2);
+		var b = 3;
+
+		Assert.That(a.Equals(b, EqualityComparer<int>.Default), Is.False);
+	}
+
+	[Test]
+	public void Equals_T_ReturnsFalse_ForFailure_WithComparer()
+	{
+		var a = Failure<int>("error");
+		var b = 2;
+
+		Assert.That(a.Equals(b, EqualityComparer<int>.Default), Is.False);
+	}
+
+	[Test]
+	public void Equals_Result_ReturnsTrue_ForSuccessAndSuccessAndEqualValue_WithComparer()
+	{
+		var a = Success(2);
+		var b = Success(2);
+
+		Assert.That(a.Equals(b, EqualityComparer<int>.Default), Is.True);
+	}
+
+	[Test]
+	public void Equals_Result_ReturnsFalse_ForSuccessAndSuccessAndUnequalValue_WithComparer()
+	{
+		var a = Success(2);
+		var b = Success(3);
+
+		Assert.That(a.Equals(b, EqualityComparer<int>.Default), Is.False);
+	}
+
+	[Test]
+	public void Equals_Result_ReturnsFalse_ForSuccessAndFailure_WithComparer()
+	{
+		var a = Success(2);
+		var b = Failure<int>("error 1");
+
+		Assert.That(a.Equals(b, EqualityComparer<int>.Default), Is.False);
+	}
+
+	[Test]
+	public void Equals_Result_ReturnsFalse_ForFailureAndSuccess_WithComparer()
+	{
+		var a = Failure<int>("error");
+		var b = Success(2);
+
+		Assert.That(a.Equals(b, EqualityComparer<int>.Default), Is.False);
+	}
+
+	[Test]
+	public void Equals_Result_ReturnsTrue_ForFailureAndFailure_WithComparer()
+	{
+		var a = Failure<int>("error 1");
+		var b = Failure<int>("error 2");
+
+		Assert.That(a.Equals(b, EqualityComparer<int>.Default), Is.True);
+	}
+
+	[Test]
+	public void GetHashCode_ReturnsHashCode_ForSuccess()
+	{
+		var result = Success(2);
+
+		Assert.That(result.GetHashCode(), Is.EqualTo(2.GetHashCode()));
+	}
+
+	[Test]
+	public void GetHashCode_Returns_Zero_ForNull()
+	{
+		var result = Success<string?>(null);
+
+		Assert.That(result.GetHashCode(), Is.Zero);
+	}
+
+	[Test]
+	public void GetHashCode_Returns_Zero_ForFailure()
+	{
+		var result = Failure<int>("error");
+
+		Assert.That(result.GetHashCode(), Is.Zero);
+	}
+}

src/Result.Tests/ResultMatchingTests.cs

@@ -0,0 +1,183 @@
+namespace Geekeey.Extensions.Result.Tests;
+
+[TestFixture]
+internal sealed class ResultMatchingTests
+{
+	[Test]
+	public void Match_CallsSuccessFunc_ForSuccess()
+	{
+		var result = Success(2);
+		var match = result.Match(
+			v => v,
+			_ => throw new InvalidOperationException());
+
+		Assert.That(match, Is.EqualTo(2));
+	}
+
+	[Test]
+	public void Match_CallsFailureFunc_ForFailure()
+	{
+		var result = Failure<int>("error");
+		var match = result.Match(
+			_ => throw new InvalidOperationException(),
+			e => e);
+
+		Assert.That(match.Message, Is.EqualTo("error"));
+	}
+
+	[Test]
+	public void Switch_CallsSuccessAction_ForSuccess()
+	{
+		var called = false;
+
+		var result = Success(2);
+		result.Switch(
+			v =>
+			{
+				Assert.That(v, Is.EqualTo(2));
+				called = true;
+			},
+			_ => throw new InvalidOperationException()
+		);
+
+		Assert.That(called, Is.True);
+	}
+
+	[Test]
+	public void Switch_CallsFailureAction_ForFailure()
+	{
+		var called = false;
+
+		var result = Failure<int>("error");
+		result.Switch(
+			_ => throw new InvalidOperationException(),
+			e =>
+			{
+				called = true;
+				Assert.That(e.Message, Is.EqualTo("error"));
+			}
+		);
+
+		Assert.That(called, Is.True);
+	}
+
+	[Test]
+	public async Task MatchAsync_CallsSuccessFunc_ForSuccess_Task()
+	{
+		var result = Success(2);
+		var match = await result.MatchAsync(
+			Task.FromResult,
+			_ => throw new InvalidOperationException());
+
+		Assert.That(match, Is.EqualTo(2));
+	}
+
+	[Test]
+	public async Task MatchAsync_CallsFailureFunc_ForFailure_Task()
+	{
+		var result = Failure<int>("error");
+		var match = await result.MatchAsync(
+			_ => throw new InvalidOperationException(),
+			Task.FromResult);
+
+		Assert.That(match.Message, Is.EqualTo("error"));
+	}
+
+	[Test]
+	public async Task SwitchAsync_CallsSuccessAction_ForSuccess_Task()
+	{
+		var called = false;
+
+		var result = Success(2);
+		await result.SwitchAsync(
+			v =>
+			{
+				Assert.That(v, Is.EqualTo(2));
+				called = true;
+				return Task.CompletedTask;
+			},
+			_ => throw new InvalidOperationException()
+		);
+
+		Assert.That(called, Is.True);
+	}
+
+	[Test]
+	public async Task SwitchAsync_CallsFailureAction_ForFailure_Task()
+	{
+		var called = false;
+
+		var result = Failure<int>("error");
+		await result.SwitchAsync(
+			_ => throw new InvalidOperationException(),
+			e =>
+			{
+				called = true;
+				Assert.That(e.Message, Is.EqualTo("error"));
+				return Task.CompletedTask;
+			}
+		);
+
+		Assert.That(called, Is.True);
+	}
+
+	[Test]
+	public async Task MatchAsync_CallsSuccessFunc_ForSuccess_ValueTask()
+	{
+		var result = Success(2);
+		var match = await result.MatchAsync(
+			ValueTask.FromResult,
+			_ => throw new InvalidOperationException());
+
+		Assert.That(match, Is.EqualTo(2));
+	}
+
+	[Test]
+	public async Task MatchAsync_CallsFailureFunc_ForFailure_ValueTask()
+	{
+		var result = Failure<int>("error");
+		var match = await result.MatchAsync(
+			_ => throw new InvalidOperationException(),
+			ValueTask.FromResult);
+
+		Assert.That(match.Message, Is.EqualTo("error"));
+	}
+
+	[Test]
+	public async Task SwitchAsync_CallsSuccessAction_ForSuccess_ValueTask()
+	{
+		var called = false;
+
+		var result = Success(2);
+		await result.SwitchAsync(
+			v =>
+			{
+				Assert.That(v, Is.EqualTo(2));
+				called = true;
+				return ValueTask.CompletedTask;
+			},
+			_ => throw new InvalidOperationException()
+		);
+
+		Assert.That(called, Is.True);
+	}
+
+	[Test]
+	public async Task SwitchAsync_CallsFailureAction_ForFailure_ValueTask()
+	{
+		var called = false;
+
+		var result = Failure<int>("error");
+		await result.SwitchAsync(
+			_ => throw new InvalidOperationException(),
+			e =>
+			{
+				called = true;
+				Assert.That(e.Message, Is.EqualTo("error"));
+				return ValueTask.CompletedTask;
+			}
+		);
+
+		Assert.That(called, Is.True);
+	}
+}

src/Result.Tests/ResultTests.cs

@@ -0,0 +1,63 @@
+namespace Geekeey.Extensions.Result.Tests;
+
+[TestFixture]
+internal sealed class ResultTests
+{
+	[Test]
+	public void New_T_HasValue()
+	{
+		var result = new Result<int>(1);
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.True);
+			Assert.That(result.IsFailure, Is.False);
+			Assert.That(result.Value, Is.Not.EqualTo(default(int)));
+			Assert.That(result.Error, Is.Null);
+		});
+	}
+
+	[Test]
+	public void New_Error_HasError()
+	{
+		var result = new Result<int>(new CustomTestError());
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.IsFailure, Is.True);
+			Assert.That(result.Value, Is.EqualTo(default(int)));
+			Assert.That(result.Error, Is.InstanceOf<CustomTestError>());
+		});
+	}
+
+	[Test]
+	public void Default_IsDefault()
+	{
+		var result = default(Result<int>);
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.IsFailure, Is.True);
+			Assert.That(result.Value, Is.EqualTo(default(int)));
+			Assert.That(result.Error, Is.EqualTo(Error.DefaultValueError));
+		});
+	}
+
+	[Test]
+	public void ToString_ReturnsSuccessString()
+	{
+		Result<int> result = 2;
+
+		Assert.That(result.ToString(), Is.EqualTo("Success { 2 }"));
+	}
+
+	[Test]
+	public void ToString_ReturnsFailureString()
+	{
+		Result<int> result = new StringError("error");
+
+		Assert.That(result.ToString(), Is.EqualTo("Failure { error }"));
+	}
+}

src/Result.Tests/ResultTransformTests.cs

@@ -0,0 +1,756 @@
+namespace Geekeey.Extensions.Result.Tests;
+
+[TestFixture]
+internal sealed class ResultTransformTests
+{
+	[Test]
+	public void Map_ReturnsSuccess_ForSuccess()
+	{
+		var start = Success(2);
+		var result = start.Map(value => value.ToString());
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.True);
+			Assert.That(result.Value, Is.EqualTo("2"));
+		});
+	}
+
+	[Test]
+	public void Map_ReturnsFailure_ForFailure()
+	{
+		var start = Failure<int>("error");
+		var result = start.Map(value => value.ToString());
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public void Then_ReturnsSuccess_ForSuccessAndMappingReturningSuccess()
+	{
+		var start = Success(2);
+		var result = start.Then(value => Success(value.ToString()));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.True);
+			Assert.That(result.Value, Is.EqualTo("2"));
+		});
+	}
+
+	[Test]
+	public void Then_ReturnsFailure_ForSuccessAndMappingReturningFailure()
+	{
+		var start = Success(2);
+		var result = start.Then(_ => Failure<string>("error"));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public void Then_ReturnsFailure_ForFailureAndMappingReturningSuccess()
+	{
+		var start = Failure<int>("error");
+		var result = start.Then(value => Success(value.ToString()));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public void Then_ReturnsFailure_ForFailureAndMappingReturningFailure()
+	{
+		var start = Failure<int>("error");
+		var result = start.Then(_ => Failure<int>("error 2"));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public void TryMap_ReturnsSuccess_ForSuccessWithoutThrowing()
+	{
+		var start = Success(2);
+		var result = start.TryMap(value => value.ToString());
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.True);
+			Assert.That(result.Value, Is.EqualTo("2"));
+		});
+	}
+
+	[Test]
+	public void TryMap_ReturnsFailure_ForFailureWithoutThrowing()
+	{
+		var start = Failure<int>("error");
+		var result = start.TryMap(value => value.ToString());
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public void TryMap_ReturnsFailure_ForSuccessWithThrowing()
+	{
+		var start = Success(2);
+		var result = start.TryMap<string>(_ => throw new CustomTestException());
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<ExceptionError>());
+			var instance = result.Error as ExceptionError;
+			Assert.That(instance?.Exception, Is.InstanceOf<CustomTestException>());
+		});
+	}
+
+	[Test]
+	public void TryMap_ReturnsFailure_ForFailureWithThrowing()
+	{
+		var start = Failure<int>("error");
+		var result = start.TryMap<string>(_ => throw new CustomTestException());
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<StringError>());
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public void ThenTry_ReturnsSuccess_ForSuccessAndMappingReturningSuccess()
+	{
+		var start = Success(2);
+		var result = start.ThenTry(value => Success(value.ToString()));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.True);
+			Assert.That(result.Value, Is.EqualTo("2"));
+		});
+	}
+
+	[Test]
+	public void ThenTry_ReturnsFailure_ForSuccessAndMappingReturningFailure()
+	{
+		var start = Success(2);
+		var result = start.ThenTry(_ => Failure<string>("error"));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public void ThenTry_ReturnsFailure_ForFailureAndMappingReturningFailure()
+	{
+		var start = Failure<int>("error");
+		var result = start.ThenTry(x => Success(x.ToString()));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public void ThenTry_ReturnsFailure_ForSuccessAndMappingThrowing()
+	{
+		var start = Success(2);
+		var result = start.ThenTry<string>(_ => throw new CustomTestException());
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<ExceptionError>());
+			var instance = result.Error as ExceptionError;
+			Assert.That(instance?.Exception, Is.InstanceOf<CustomTestException>());
+		});
+	}
+
+	[Test]
+	public void ThenTry_ReturnsFailure_ForFailureAndMappingThrowing()
+	{
+		var start = Failure<int>("error");
+		var result = start.ThenTry<string>(_ => throw new CustomTestException());
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<StringError>());
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public async Task MapAsync_ReturnsSuccess_ForSuccess_Task()
+	{
+		var start = Success(2);
+		var result = await start.MapAsync(value => Task.FromResult(value.ToString()));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.True);
+			Assert.That(result.Value, Is.EqualTo("2"));
+		});
+	}
+
+	[Test]
+	public async Task MapAsync_ReturnsFailure_ForFailure_Task()
+	{
+		var start = Failure<int>("error");
+		var result = await start.MapAsync(value => Task.FromResult(value.ToString()));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public async Task ThenAsync_ReturnsSuccess_ForSuccessAndMappingReturningSuccess_Task()
+	{
+		var start = Success(2);
+		var result = await start.ThenAsync(value => Task.FromResult(Success(value.ToString())));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.True);
+			Assert.That(result.Value, Is.EqualTo("2"));
+		});
+	}
+
+	[Test]
+	public async Task ThenAsync_ReturnsFailure_ForSuccessAndMappingReturningFailure_Task()
+	{
+		var start = Success(2);
+		var result = await start.ThenAsync(_ => Task.FromResult(Failure<string>("error")));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public async Task ThenAsync_ReturnsFailure_ForFailureAndMappingReturningSuccess_Task()
+	{
+		var start = Failure<int>("error");
+		var result = await start.ThenAsync(value => Task.FromResult(Success(value.ToString())));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public async Task ThenAsync_ReturnsFailure_ForFailureAndMappingReturningFailure_Task()
+	{
+		var start = Failure<int>("error");
+		var result = await start.ThenAsync(_ => Task.FromResult(Failure<int>("error 2")));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public async Task TryMapAsync_ReturnsSuccess_ForSuccessWithoutThrowing_Task()
+	{
+		var start = Success(2);
+		var result = await start.TryMapAsync(value => Task.FromResult(value.ToString()));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.True);
+			Assert.That(result.Value, Is.EqualTo("2"));
+		});
+	}
+
+	[Test]
+	public async Task TryMapAsync_ReturnsFailure_ForFailureWithoutThrowing_Task()
+	{
+		var start = Failure<int>("error");
+		var result = await start.TryMapAsync(value => Task.FromResult(value.ToString()));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public async Task TryMapAsync_ReturnsFailure_ForSuccessWithThrowing_Task()
+	{
+		var start = Success(2);
+		var result = await start.TryMapAsync(Task<string> (_) => throw new CustomTestException());
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<ExceptionError>());
+			var instance = result.Error as ExceptionError;
+			Assert.That(instance?.Exception, Is.InstanceOf<CustomTestException>());
+		});
+	}
+
+	[Test]
+	public async Task TryMapAsync_ReturnsFailure_ForSuccessWithAwaitThrowing_Task()
+	{
+		var start = Success(2);
+		var result = await start.TryMapAsync(async Task<string> (_) =>
+		{
+			await Task.CompletedTask;
+			throw new CustomTestException();
+		});
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<ExceptionError>());
+			var instance = result.Error as ExceptionError;
+			Assert.That(instance?.Exception, Is.InstanceOf<CustomTestException>());
+		});
+	}
+
+	[Test]
+	public async Task TryMapAsync_ReturnsFailure_ForFailureWithThrowing_Task()
+	{
+		var start = Failure<int>("error");
+		var result = await start.TryMapAsync(Task<string> (_) => throw new CustomTestException());
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<StringError>());
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public async Task TryMapAsync_ReturnsFailure_ForFailureWithAwaitThrowing_Task()
+	{
+		var start = Failure<int>("error");
+		var result = await start.TryMapAsync(async Task<string> (_) =>
+		{
+			await Task.CompletedTask;
+			throw new CustomTestException();
+		});
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<StringError>());
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public async Task ThenTryAsync_ReturnsSuccess_ForSuccessAndMappingReturningSuccess_Task()
+	{
+		var start = Success(2);
+		var result = await start.ThenTryAsync(value => Task.FromResult(Success(value.ToString())));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.True);
+			Assert.That(result.Value, Is.EqualTo("2"));
+		});
+	}
+
+	[Test]
+	public async Task ThenTryAsync_ReturnsFailure_ForSuccessAndMappingReturningFailure_Task()
+	{
+		var start = Success(2);
+		var result = await start.ThenTryAsync(_ => Task.FromResult(Failure<string>("error")));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public async Task ThenTryAsync_ReturnsFailure_ForFailureAndMappingReturningFailure_Task()
+	{
+		var start = Failure<int>("error");
+		var result = await start.ThenTryAsync(x => Task.FromResult(Success(x.ToString())));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public async Task ThenTryAsync_ReturnsFailure_ForSuccessAndMappingThrowing_Task()
+	{
+		var start = Success(2);
+		var result = await start.ThenTryAsync(Task<Result<string>> (_) => throw new CustomTestException());
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<ExceptionError>());
+			var instance = result.Error as ExceptionError;
+			Assert.That(instance?.Exception, Is.InstanceOf<CustomTestException>());
+		});
+	}
+
+	[Test]
+	public async Task ThenTryAsync_ReturnsFailure_ForSuccessAndMappingAwaitThrowing_Task()
+	{
+		var start = Success(2);
+		var result = await start.ThenTryAsync(async Task<Result<string>> (_) =>
+		{
+			await Task.CompletedTask;
+			throw new CustomTestException();
+		});
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<ExceptionError>());
+			var instance = result.Error as ExceptionError;
+			Assert.That(instance?.Exception, Is.InstanceOf<CustomTestException>());
+		});
+	}
+
+	[Test]
+	public async Task ThenTryAsync_ReturnsFailure_ForFailureAndMappingThrowing_Task()
+	{
+		var start = Failure<int>("error");
+		var result = await start.ThenTryAsync(Task<Result<string>> (_) => throw new CustomTestException());
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<StringError>());
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public async Task ThenTryAsync_ReturnsFailure_ForFailureAndMappingAwaitThrowing_Task()
+	{
+		var start = Failure<int>("error");
+		var result = await start.ThenTryAsync(async Task<Result<string>> (_) =>
+		{
+			await Task.CompletedTask;
+			throw new CustomTestException();
+		});
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<StringError>());
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public async Task MapAsync_ReturnsSuccess_ForSuccess_ValueTask()
+	{
+		var start = Success(2);
+		var result = await start.MapAsync(value => ValueTask.FromResult(value.ToString()));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.True);
+			Assert.That(result.Value, Is.EqualTo("2"));
+		});
+	}
+
+	[Test]
+	public async Task MapAsync_ReturnsFailure_ForFailure_ValueTask()
+	{
+		var start = Failure<int>("error");
+		var result = await start.MapAsync(value => ValueTask.FromResult(value.ToString()));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public async Task ThenAsync_ReturnsSuccess_ForSuccessAndMappingReturningSuccess_ValueTask()
+	{
+		var start = Success(2);
+		var result = await start.ThenAsync(value => ValueTask.FromResult(Success(value.ToString())));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.True);
+			Assert.That(result.Value, Is.EqualTo("2"));
+		});
+	}
+
+	[Test]
+	public async Task ThenAsync_ReturnsFailure_ForSuccessAndMappingReturningFailure_ValueTask()
+	{
+		var start = Success(2);
+		var result = await start.ThenAsync(_ => ValueTask.FromResult(Failure<string>("error")));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public async Task ThenAsync_ReturnsFailure_ForFailureAndMappingReturningSuccess_ValueTask()
+	{
+		var start = Failure<int>("error");
+		var result = await start.ThenAsync(value => ValueTask.FromResult(Success(value.ToString())));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public async Task ThenAsync_ReturnsFailure_ForFailureAndMappingReturningFailure_ValueTask()
+	{
+		var start = Failure<int>("error");
+		var result = await start.ThenAsync(_ => ValueTask.FromResult(Failure<int>("error 2")));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public async Task TryMapAsync_ReturnsSuccess_ForSuccessWithoutThrowing_ValueTask()
+	{
+		var start = Success(2);
+		var result = await start.TryMapAsync(value => ValueTask.FromResult(value.ToString()));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.True);
+			Assert.That(result.Value, Is.EqualTo("2"));
+		});
+	}
+
+	[Test]
+	public async Task TryMapAsync_ReturnsFailure_ForFailureWithoutThrowing_ValueTask()
+	{
+		var start = Failure<int>("error");
+		var result = await start.TryMapAsync(value => ValueTask.FromResult(value.ToString()));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public async Task TryMapAsync_ReturnsFailure_ForSuccessWithThrowing_ValueTask()
+	{
+		var start = Success(2);
+		var result = await start.TryMapAsync(ValueTask<string> (_) => throw new CustomTestException());
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<ExceptionError>());
+			var instance = result.Error as ExceptionError;
+			Assert.That(instance?.Exception, Is.InstanceOf<CustomTestException>());
+		});
+	}
+
+	[Test]
+	public async Task TryMapAsync_ReturnsFailure_ForSuccessWithAwaitThrowing_ValueTask()
+	{
+		var start = Success(2);
+		var result = await start.TryMapAsync(async ValueTask<string> (_) =>
+		{
+			await ValueTask.CompletedTask;
+			throw new CustomTestException();
+		});
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<ExceptionError>());
+			var instance = result.Error as ExceptionError;
+			Assert.That(instance?.Exception, Is.InstanceOf<CustomTestException>());
+		});
+	}
+
+	[Test]
+	public async Task TryMapAsync_ReturnsFailure_ForFailureWithThrowing_ValueTask()
+	{
+		var start = Failure<int>("error");
+		var result = await start.TryMapAsync(ValueTask<string> (_) => throw new CustomTestException());
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<StringError>());
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public async Task TryMapAsync_ReturnsFailure_ForFailureWithAwaitThrowing_ValueTask()
+	{
+		var start = Failure<int>("error");
+		var result = await start.TryMapAsync(async ValueTask<string> (_) =>
+		{
+			await ValueTask.CompletedTask;
+			throw new CustomTestException();
+		});
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<StringError>());
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public async Task ThenTryAsync_ReturnsSuccess_ForSuccessAndMappingReturningSuccess_ValueTask()
+	{
+		var start = Success(2);
+		var result = await start.ThenTryAsync(value => ValueTask.FromResult(Success(value.ToString())));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.True);
+			Assert.That(result.Value, Is.EqualTo("2"));
+		});
+	}
+
+	[Test]
+	public async Task ThenTryAsync_ReturnsFailure_ForSuccessAndMappingReturningFailure_ValueTask()
+	{
+		var start = Success(2);
+		var result = await start.ThenTryAsync(_ => ValueTask.FromResult(Failure<string>("error")));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public async Task ThenTryAsync_ReturnsFailure_ForFailureAndMappingReturningFailure_ValueTask()
+	{
+		var start = Failure<int>("error");
+		var result = await start.ThenTryAsync(x => ValueTask.FromResult(Success(x.ToString())));
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public async Task ThenTryAsync_ReturnsFailure_ForSuccessAndMappingThrowing_ValueTask()
+	{
+		var start = Success(2);
+		var result = await start.ThenTryAsync(ValueTask<Result<string>> (_) => throw new CustomTestException());
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<ExceptionError>());
+			var instance = result.Error as ExceptionError;
+			Assert.That(instance?.Exception, Is.InstanceOf<CustomTestException>());
+		});
+	}
+
+	[Test]
+	public async Task ThenTryAsync_ReturnsFailure_ForSuccessAndMappingAwaitThrowing_ValueTask()
+	{
+		var start = Success(2);
+		var result = await start.ThenTryAsync(async ValueTask<Result<string>> (_) =>
+		{
+			await ValueTask.CompletedTask;
+			throw new CustomTestException();
+		});
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<ExceptionError>());
+			var instance = result.Error as ExceptionError;
+			Assert.That(instance?.Exception, Is.InstanceOf<CustomTestException>());
+		});
+	}
+
+	[Test]
+	public async Task ThenTryAsync_ReturnsFailure_ForFailureAndMappingThrowing_ValueTask()
+	{
+		var start = Failure<int>("error");
+		var result = await start.ThenTryAsync(ValueTask<Result<string>> (_) => throw new CustomTestException());
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<StringError>());
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public async Task ThenTryAsync_ReturnsFailure_ForFailureAndMappingAwaitThrowing_ValueTask()
+	{
+		var start = Failure<int>("error");
+		var result = await start.ThenTryAsync(async ValueTask<Result<string>> (_) =>
+		{
+			await ValueTask.CompletedTask;
+			throw new CustomTestException();
+		});
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(result.IsSuccess, Is.False);
+			Assert.That(result.Error, Is.InstanceOf<StringError>());
+			Assert.That(result.Error?.Message, Is.EqualTo("error"));
+		});
+	}
+}

src/Result.Tests/ResultUnboxTests.cs

@@ -0,0 +1,113 @@
+namespace Geekeey.Extensions.Result.Tests;
+
+[TestFixture]
+internal sealed class ResultUnboxTests
+{
+	[Test]
+	public void TryGetValue_1_ReturnsTrueAndSetsValue_ForSuccess()
+	{
+		var result = Success(2);
+		var ok = result.TryGetValue(out var value);
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(ok, Is.True);
+			Assert.That(value, Is.EqualTo(2));
+		});
+	}
+
+	[Test]
+	public void TryGetValue_1_ReturnsFalse_ForFailure()
+	{
+		var result = Failure<int>("error");
+		var ok = result.TryGetValue(out var value);
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(ok, Is.False);
+			Assert.That(value, Is.EqualTo(default(int)));
+		});
+	}
+
+	[Test]
+	public void TryGetValue_2_ReturnsTrueAndSetsValue_ForSuccess()
+	{
+		var result = Success(2);
+		var ok = result.TryGetValue(out var value, out var error);
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(ok, Is.True);
+			Assert.That(value, Is.EqualTo(2));
+			Assert.That(error, Is.EqualTo(default(Error)));
+		});
+	}
+
+	[Test]
+	public void TryGetValue_2_ReturnsFalseAndSetsError_ForFailure()
+	{
+		var result = Failure<int>("error");
+		var ok = result.TryGetValue(out var value, out var error);
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(ok, Is.False);
+			Assert.That(value, Is.EqualTo(default(int)));
+			Assert.That(error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public void TryGetError_1_ReturnsTrueAndSetsError_ForFailure()
+	{
+		var result = Failure<int>("error");
+		var ok = result.TryGetError(out var error);
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(ok, Is.True);
+			Assert.That(error?.Message, Is.EqualTo("error"));
+		});
+	}
+
+	[Test]
+	public void TryGetError_1_ReturnsFalse_ForSuccess()
+	{
+		var result = Success(2);
+		var ok = result.TryGetError(out var error);
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(ok, Is.False);
+			Assert.That(error, Is.EqualTo(default(Error)));
+		});
+	}
+
+	[Test]
+	public void TryGetError_2_ReturnsTrueAndSetsError_ForFailure()
+	{
+		var r = Failure<int>("error");
+		var ok = r.TryGetError(out var error, out var value);
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(ok, Is.True);
+			Assert.That(error?.Message, Is.EqualTo("error"));
+			Assert.That(value, Is.EqualTo(default(int)));
+		});
+	}
+
+	[Test]
+	public void TryGetError_2_ReturnsFalseAndSetsValue_ForSuccess()
+	{
+		var r = Success(2);
+		var ok = r.TryGetError(out var error, out var value);
+
+		Assert.Multiple(() =>
+		{
+			Assert.That(ok, Is.False);
+			Assert.That(error, Is.EqualTo(default(Error)));
+			Assert.That(value, Is.EqualTo(2));
+		});
+	}
+}

src/Result/Errors/AggregateError.cs

@@ -0,0 +1,16 @@
+namespace Geekeey.Extensions.Result;
+
+/// <summary>
+/// An error which is a combination of other errors.
+/// </summary>
+/// <param name="errors">The errors the error consists of.</param>
+public sealed class AggregateError(IEnumerable<Error> errors) : Error
+{
+	/// <summary>
+	/// The errors the error consists of.
+	/// </summary>
+	public IReadOnlyCollection<Error> Errors { get; } = errors.ToList();
+
+	/// <inheritdoc/>
+	public override string Message => string.Join(Environment.NewLine, Errors.Select(error => error.Message));
+}

src/Result/Errors/Error.cs

@@ -0,0 +1,44 @@
+namespace Geekeey.Extensions.Result;
+
+/// <summary>
+/// An error containing a simple message. Makes up the other half of a <see cref="Result{T}"/> which might be an error.
+/// </summary>
+/// <remarks>
+/// An error is conceptually very similar to an exception but without the ability to be thrown, meant to be a more
+/// lightweight type meant to be wrapped in a <see cref="Result{T}"/>.
+/// An error fundamentally only contains a single string message, however other more concrete types such as
+/// <see cref="ExceptionError"/> or <see cref="AggregateError"/> may define other properties.
+/// Errors are meant to be small, specific, and descriptive, such that they are easy to match over and provide specific
+/// handling for specific kinds of errors.
+/// </remarks>
+public abstract class Error
+{
+	/// <summary>
+	/// A statically accessible default "Result has no value." error.
+	/// </summary>
+	internal static Error DefaultValueError { get; } = new StringError("The result has no value.");
+
+	/// <summary>
+	/// The message used to display the error.
+	/// </summary>
+	public abstract string Message { get; }
+
+	/// <summary>
+	/// Gets a string representation of the error. Returns <see cref="Message"/> by default.
+	/// </summary>
+	public override string ToString() => Message;
+
+	/// <summary>
+	/// Implicitly converts a string into a <see cref="StringError"/>.
+	/// </summary>
+	/// <param name="message">The message of the error.</param>
+	public static implicit operator Error(string message)
+		=> new StringError(message);
+
+	/// <summary>
+	/// Implicitly converts an exception into an <see cref="ExceptionError"/>.
+	/// </summary>
+	/// <param name="exception">The exception to convert.</param>
+	public static implicit operator Error(Exception exception)
+		=> new ExceptionError(exception);
+}

src/Result/Errors/ExceptionError.cs

@@ -0,0 +1,18 @@
+namespace Geekeey.Extensions.Result;
+
+/// <summary>
+/// An error which is constructed from an exception.
+/// </summary>
+/// <param name="exception">The exception in the error.</param>
+public sealed class ExceptionError(Exception exception) : Error
+{
+	/// <summary>
+	/// The exception in the error.
+	/// </summary>
+	public Exception Exception { get; } = exception;
+
+	/// <summary>
+	/// The exception in the error.
+	/// </summary>
+	public override string Message => Exception.Message;
+}

src/Result/Errors/StringError.cs

@@ -0,0 +1,11 @@
+namespace Geekeey.Extensions.Result;
+
+/// <summary>
+/// An error which displays a simple string.
+/// </summary>
+/// <param name="message">The message to display.</param>
+public sealed class StringError(string message) : Error
+{
+	/// <inheritdoc/>
+	public override string Message => message;
+}

src/Result/Exceptions/UnwrapException.cs

@@ -0,0 +1,18 @@
+namespace Geekeey.Extensions.Result;
+
+/// <summary>
+/// The exception is thrown when an <see cref="Result{T}"/> is attempted to be unwrapped contains only a failure value.
+/// </summary>
+public sealed class UnwrapException : Exception
+{
+	/// <summary>
+	/// Creates a new <see cref="UnwrapException"/>.
+	/// </summary>
+	public UnwrapException() : base("Cannot unwrap result because it does not have a value.") { }
+
+	/// <summary>
+	/// Creates a new <see cref="UnwrapException"/>.
+	/// </summary>
+	/// <param name="error">An error message.</param>
+	public UnwrapException(string error) : base(error) { }
+}

src/Result/Extensions/Extensions.Enumerable.cs

@@ -0,0 +1,37 @@
+namespace Geekeey.Extensions.Result;
+
+/// <summary>
+/// Extensions for or relating to <see cref="Result{T}"/>.
+/// </summary>
+public static partial class Extensions
+{
+	/// <summary>
+	/// Turns a sequence of results into a single result containing the success values in the results only if all the
+	/// results have success values.
+	/// </summary>
+	/// <param name="results">The results to turn into a single sequence.</param>
+	/// <typeparam name="T">The type of the success values in the results.</typeparam>
+	/// <returns>A single result containing a sequence of all the success values from the original sequence of results,
+	/// or the first failure value encountered within the sequence.</returns>
+	/// <remarks>
+	/// This method completely enumerates the input sequence before returning and is not lazy. As a consequence of this,
+	/// the sequence within the returned result is an <see cref="IReadOnlyList{T}"/>.
+	/// </remarks>
+	public static Result<IReadOnlyList<T>> Join<T>(this IEnumerable<Result<T>> results)
+	{
+		_ = results.TryGetNonEnumeratedCount(out var count);
+		var list = new List<T>(count);
+
+		foreach (var result in results)
+		{
+			if (!result.TryGetValue(out var value, out var error))
+			{
+				return new Result<IReadOnlyList<T>>(error);
+			}
+
+			list.Add(value);
+		}
+
+		return list;
+	}
+}

src/Result/Extensions/Extensions.Task.cs

@@ -0,0 +1,85 @@
+using System.Diagnostics.CodeAnalysis;
+using System.Runtime.CompilerServices;
+
+namespace Geekeey.Extensions.Result;
+
+/// <summary>
+/// Extensions for or relating to <see cref="Result{T}"/>.
+/// </summary>
+[ExcludeFromCodeCoverage]
+public static partial class Extensions
+{
+	#region Task<Result<T>>
+
+	/// <summary>
+	/// Maps the success value of the result object of the completed task using a mapping function, or does nothing if
+	/// the result object of the completed task is a failure.
+	/// </summary>
+	/// <param name="result">A task object retunring a result object when completing.</param>
+	/// <param name="func">The function used to map the success value.</param>
+	/// <typeparam name="T">The type of the object inside the result returned by the task.</typeparam>
+	/// <typeparam name="TNew">The type of the new value.</typeparam>
+	/// <returns>A new result containing either the mapped success value or the failure value of the original
+	/// result.</returns>
+	[MethodImpl(MethodImplOptions.AggressiveInlining)]
+	public static async ValueTask<Result<TNew>> Map<T, TNew>(this Task<Result<T>> result,
+		Func<T, TNew> func)
+		=> (await result).Map(func);
+
+	/// <inheritdoc cref="Map{T,TNew}(System.Threading.Tasks.Task{Geekeey.Extensions.Result.Result{T}},System.Func{T,TNew})"/>
+	[MethodImpl(MethodImplOptions.AggressiveInlining)]
+	public static async Task<Result<TNew>> Map<T, TNew>(this Task<Result<T>> result,
+		Func<T, ValueTask<TNew>> func)
+		=> await (await result).MapAsync(func);
+
+	/// <summary>
+	/// Maps the success value of the result object of the completed task to a new result using a mapping function, or
+	/// does nothing if the result object of the completed task is a failure.
+	/// </summary>
+	/// <param name="result">A task object retunring a result object when completing.</param>
+	/// <param name="func">The function used to map the success value.</param>
+	/// <typeparam name="T">The type of the object inside the result returned by the task.</typeparam>
+	/// <typeparam name="TNew">The type of the new value.</typeparam>
+	/// <returns>A new result containing either the mapped success value or the failure value of the original
+	/// result.</returns>
+	[MethodImpl(MethodImplOptions.AggressiveInlining)]
+	public static async Task<Result<TNew>> Then<T, TNew>(this Task<Result<T>> result,
+		Func<T, Result<TNew>> func)
+		=> (await result).Then(func);
+
+	/// <inheritdoc cref="Then{T,TNew}(System.Threading.Tasks.Task{Geekeey.Extensions.Result.Result{T}},System.Func{T,Geekeey.Extensions.Result.Result{TNew}})"/>
+	[MethodImpl(MethodImplOptions.AggressiveInlining)]
+	public static async Task<Result<TNew>> Then<T, TNew>(this Task<Result<T>> result,
+		Func<T, ValueTask<Result<TNew>>> func)
+		=> await (await result).ThenAsync(func);
+
+	#endregion
+
+	#region ValueTask<Result<T>>
+
+	/// <inheritdoc cref="Map{T,TNew}(System.Threading.Tasks.Task{Geekeey.Extensions.Result.Result{T}},System.Func{T,TNew})"/>
+	[MethodImpl(MethodImplOptions.AggressiveInlining)]
+	public static async Task<Result<TNew>> Map<T, TNew>(this ValueTask<Result<T>> result,
+		Func<T, TNew> func)
+		=> (await result).Map(func);
+
+	/// <inheritdoc cref="Map{T,TNew}(System.Threading.Tasks.Task{Geekeey.Extensions.Result.Result{T}},System.Func{T,TNew})"/>
+	[MethodImpl(MethodImplOptions.AggressiveInlining)]
+	public static async ValueTask<Result<TNew>> Map<T, TNew>(this ValueTask<Result<T>> result,
+		Func<T, ValueTask<TNew>> func)
+		=> await (await result).MapAsync(func);
+
+	/// <inheritdoc cref="Then{T,TNew}(System.Threading.Tasks.Task{Geekeey.Extensions.Result.Result{T}},System.Func{T,Geekeey.Extensions.Result.Result{TNew}})"/>
+	[MethodImpl(MethodImplOptions.AggressiveInlining)]
+	public static async ValueTask<Result<TNew>> Then<T, TNew>(this ValueTask<Result<T>> result,
+		Func<T, Result<TNew>> func)
+		=> (await result).Then(func);
+
+	/// <inheritdoc cref="Then{T,TNew}(System.Threading.Tasks.Task{Geekeey.Extensions.Result.Result{T}},System.Func{T,Geekeey.Extensions.Result.Result{TNew}})"/>
+	[MethodImpl(MethodImplOptions.AggressiveInlining)]
+	public static async ValueTask<Result<TNew>> Then<T, TNew>(this ValueTask<Result<T>> result,
+		Func<T, ValueTask<Result<TNew>>> func)
+		=> await (await result).ThenAsync(func);
+
+	#endregion
+}

src/Result/Prelude.cs

@@ -0,0 +1,92 @@
+using System.Diagnostics.Contracts;
+
+namespace Geekeey.Extensions.Result;
+
+/// <summary>
+/// A class containing various utility methods, a 'prelude' to the rest of the library.
+/// </summary>
+/// <remarks>
+/// This class is meant to be imported statically, e.g. <c>using static Geekeey.Common.Result.Prelude;</c>.
+/// Recommended to be imported globally via a global using statement.
+/// </remarks>
+public static class Prelude
+{
+	/// <summary>
+	/// Creates a result containing an success value.
+	/// </summary>
+	/// <typeparam name="T">The type of the success value.</typeparam>
+	/// <param name="value">The success value to create the result from.</param>
+	[Pure]
+	public static Result<T> Success<T>(T value) => new(value);
+
+	/// <summary>
+	/// Creates a result containing a failure value.
+	/// </summary>
+	/// <typeparam name="T">The type of an success value in the result.</typeparam>
+	/// <param name="error">The failure value to create the result from.</param>
+	[Pure]
+	public static Result<T> Failure<T>(Error error) => new(error);
+
+	/// <summary>
+	/// Tries to execute a function and return the result. If the function throws an exception, the exception will be
+	/// returned wrapped in an <see cref="ExceptionError"/>.
+	/// </summary>
+	/// <typeparam name="T">The type the function returns.</typeparam>
+	/// <param name="function">The function to try execute.</param>
+	/// <returns>A result containing the return value of the function or an <see cref="ExceptionError"/> containing the
+	/// exception thrown by the function.</returns>
+	[Pure]
+	public static Result<T> Try<T>(Func<T> function)
+	{
+		try
+		{
+			return new Result<T>(function());
+		}
+		catch (Exception exception)
+		{
+			return new Result<T>(new ExceptionError(exception));
+		}
+	}
+
+	/// <summary>
+	/// Tries to execute an asynchronous function and return the result. If the function throws an exception, the
+	/// exception will be returned wrapped in an <see cref="ExceptionError"/>.
+	/// </summary>
+	/// <typeparam name="T">The type the function returns.</typeparam>
+	/// <param name="function">The function to try execute.</param>
+	/// <returns>A result containing the return value of the function or an <see cref="ExceptionError"/> containing the
+	/// exception thrown by the function.</returns>
+	[Pure]
+	public static async ValueTask<Result<T>> TryAsync<T>(Func<ValueTask<T>> function)
+	{
+		try
+		{
+			return new Result<T>(await function());
+		}
+		catch (Exception exception)
+		{
+			return new Result<T>(new ExceptionError(exception));
+		}
+	}
+
+	/// <summary>
+	/// Tries to execute an asynchronous function and return the result. If the function throws an exception, the
+	/// exception will be returned wrapped in an <see cref="ExceptionError"/>.
+	/// </summary>
+	/// <typeparam name="T">The type the function returns.</typeparam>
+	/// <param name="function">The function to try execute.</param>
+	/// <returns>A result containing the return value of the function or an <see cref="ExceptionError"/> containing the
+	/// exception thrown by the function.</returns>
+	[Pure]
+	public static async Task<Result<T>> TryAsync<T>(Func<Task<T>> function)
+	{
+		try
+		{
+			return new Result<T>(await function());
+		}
+		catch (Exception exception)
+		{
+			return new Result<T>(new ExceptionError(exception));
+		}
+	}
+}

src/Result/Project.props

@@ -0,0 +1,5 @@
+<Project>
+  <ItemGroup Condition="'$(ImplicitUsings)' == 'enable'">
+    <Using Include="Geekeey.Common.Result.Prelude" Static="true" />
+  </ItemGroup>
+</Project>

src/Result/Result.Conversion.cs

@@ -0,0 +1,36 @@
+using System.Diagnostics.Contracts;
+
+namespace Geekeey.Extensions.Result;
+
+public readonly partial struct Result<T>
+{
+	/// <summary>
+	/// Implicitly constructs a result from a success value.
+	/// </summary>
+	/// <param name="value">The value to construct the result from.</param>
+	[Pure]
+	public static implicit operator Result<T>(T value) => new(value);
+
+	/// <summary>
+	/// Implicitly constructs a result from a failure value.
+	/// </summary>
+	/// <param name="error">The error to construct the result from.</param>
+	[Pure]
+	public static implicit operator Result<T>(Error error) => new(error);
+
+	/// <summary>
+	/// Unwraps the success value of the result. Throws an <see cref="UnwrapException"/> if the result is a failure.
+	/// </summary>
+	/// <remarks>
+	/// This call is <b>unsafe</b> in the sense that it might intentionally throw an exception. Please only use this
+	/// call if the caller knows that this operation is safe, or that an exception is acceptable to be thrown.
+	/// </remarks>
+	/// <returns>The success value of the result.</returns>
+	/// <exception cref="UnwrapException">The result is not a success.</exception>
+	[Pure]
+	public T Unwrap() => IsSuccess ? Value! : throw new UnwrapException();
+
+	/// <inheritdoc cref="Unwrap"/>
+	[Pure]
+	public static explicit operator T(Result<T> result) => result.Unwrap();
+}

src/Result/Result.Equality.cs

@@ -0,0 +1,115 @@
+using System.Diagnostics.CodeAnalysis;
+using System.Diagnostics.Contracts;
+using System.Numerics;
+
+namespace Geekeey.Extensions.Result;
+
+public readonly partial struct Result<T> : IEquatable<Result<T>>, IEquatable<T>,
+	IEqualityOperators<Result<T>, Result<T>, bool>, IEqualityOperators<Result<T>, T, bool>
+{
+	/// <summary>
+	/// Checks whether the result is equal to another result. Results are equal if both results are success values and
+	/// the success values are equal, or if both results are failures.
+	/// </summary>
+	/// <param name="other">The result to check for equality with the current result.</param>
+	[Pure]
+	public bool Equals(Result<T> other)
+		=> Equals(this, other, EqualityComparer<T>.Default);
+
+	/// <summary>
+	/// Checks whether the result is equal to another result. Results are equal if both results are success values and
+	/// the success values are equal, or if both results are failures.
+	/// </summary>
+	/// <param name="other">The result to check for equality with the current result.</param>
+	/// <param name="comparer">The equality comparer to use for comparing values.</param>
+	[Pure]
+	public bool Equals(Result<T> other, IEqualityComparer<T> comparer)
+		=> Equals(this, other, comparer);
+
+	/// <summary>
+	/// Checks whether the result is a success value and the success value is equal to another value.
+	/// </summary>
+	/// <param name="other">The value to check for equality with the success value of the result.</param>
+	[Pure]
+	public bool Equals(T? other)
+		=> Equals(this, other, EqualityComparer<T>.Default);
+
+	/// <summary>
+	/// Checks whether the result is a success value and the success value is equal to another value using a specified
+	/// equality comparer.
+	/// </summary>
+	/// <param name="other">The value to check for equality with the success value of the result.</param>
+	/// <param name="comparer">The equality comparer to use for comparing values.</param>
+	[Pure]
+	public bool Equals(T? other, IEqualityComparer<T> comparer)
+		=> Equals(this, other, comparer);
+
+	/// <inheritdoc/>
+	[Pure]
+	public override bool Equals(object? other)
+		=> other is T x && Equals(x) || other is Result<T> r && Equals(r);
+
+	/// <inheritdoc/>
+	[Pure]
+	public override int GetHashCode()
+		=> GetHashCode(this, EqualityComparer<T>.Default);
+
+	internal static bool Equals(Result<T> a, Result<T> b, IEqualityComparer<T> comparer)
+	{
+		if (!a._success || !b._success) return !a._success && !b._success;
+		if (a.Value is null || b.Value is null) return a.Value is null && b.Value is null;
+		return comparer.Equals(a.Value, b.Value);
+	}
+
+	internal static bool Equals(Result<T> a, T? b, IEqualityComparer<T> comparer)
+	{
+		if (!a._success) return false;
+		if (a.Value is null || b is null) return a.Value is null && b is null;
+		return comparer.Equals(a.Value, b);
+	}
+
+	internal static int GetHashCode(Result<T> result, IEqualityComparer<T> comparer)
+	{
+		if (result is { _success: true, Value: not null })
+			return comparer.GetHashCode(result.Value);
+		return 0;
+	}
+
+	/// <summary>
+	/// Checks whether two results are equal. Results are equal if both results are success values and the success
+	/// values are equal, or if both results are failures.
+	/// </summary>
+	/// <param name="a">The first result to compare.</param>
+	/// <param name="b">The second result to compare.</param>
+	[Pure]
+	[ExcludeFromCodeCoverage]
+	public static bool operator ==(Result<T> a, Result<T> b) => a.Equals(b);
+
+	/// <summary>
+	/// Checks whether two results are not equal. Results are equal if both results are success values and the success
+	/// values are equal, or if both results are failures.
+	/// </summary>
+	/// <param name="a">The first result to compare.</param>
+	/// <param name="b">The second result to compare.</param>
+	[Pure]
+	[ExcludeFromCodeCoverage]
+	public static bool operator !=(Result<T> a, Result<T> b) => !a.Equals(b);
+
+	/// <summary>
+	/// Checks whether a result is a success value and the success value is equal to another value.
+	/// </summary>
+	/// <param name="a">The result to compare.</param>
+	/// <param name="b">The value to check for equality with the success value in the result.</param>
+	[Pure]
+	[ExcludeFromCodeCoverage]
+	public static bool operator ==(Result<T> a, T? b) => a.Equals(b);
+
+	/// <summary>
+	/// Checks whether a result either does not have a value, or the value is not equal to another value.
+	/// </summary>
+	/// <param name="a">The result to compare.</param>
+	/// <param name="b">The value to check for inequality with the success value in the result.</param>
+	[Pure]
+	[ExcludeFromCodeCoverage]
+	public static bool operator !=(Result<T> a, T? b) => !a.Equals(b);
+}

src/Result/Result.Matching.cs

@@ -0,0 +1,91 @@
+using System.Diagnostics.Contracts;
+
+namespace Geekeey.Extensions.Result;
+
+public readonly partial struct Result<T>
+{
+	/// <summary>
+	/// Matches over the success value or failure value of the result and returns another value. Can be conceptualized
+	/// as an exhaustive <c>switch</c> expression matching all possible values of the type.
+	/// </summary>
+	/// <typeparam name="TResult">The type to return from the match.</typeparam>
+	/// <param name="success">The function to apply to the success value of the result if the result is a success.</param>
+	/// <param name="failure">The function to apply to the failure value of the result if the result is a failure.</param>
+	/// <returns>The result of applying either <paramref name="success"/> or <paramref name="failure"/> on the success
+	/// value or failure value of the result.</returns>
+	[Pure]
+	public TResult Match<TResult>(Func<T, TResult> success, Func<Error, TResult> failure)
+		=> _success ? success(Value!) : failure(Error!);
+
+	/// <summary>
+	/// Matches over the success value or failure value of the result and invokes an effectful action onto the success
+	/// value or failure value. Can be conceptualized as an exhaustive <c>switch</c> statement matching all possible
+	/// values of the type.
+	/// </summary>
+	/// <param name="success">The function to call with the success value of the result if the result is a success.</param>
+	/// <param name="failure">The function to call with the failure value of the result if the result is a failure.</param>
+	public void Switch(Action<T> success, Action<Error> failure)
+	{
+		if (_success) success(Value!);
+		else failure(Error!);
+	}
+}
+
+public readonly partial struct Result<T>
+{
+	/// <summary>
+	/// Asynchronously matches over the success value or failure value of the result and returns another value. Can be
+	/// conceptualized as an exhaustive <c>switch</c> expression matching all possible values of the type.
+	/// </summary>
+	/// <typeparam name="TResult">The type to return from the match.</typeparam>
+	/// <param name="success">The function to apply to the success value of the result if the result is a success.</param>
+	/// <param name="failure">The function to apply to the failure value of the result if the result is a failure.</param>
+	/// <returns>A task completing with the result of applying either <paramref name="success"/> or
+	/// <paramref name="failure"/> on the success value or failure value of the result.</returns>
+	[Pure]
+	public async ValueTask<TResult> MatchAsync<TResult>(Func<T, ValueTask<TResult>> success, Func<Error, ValueTask<TResult>> failure)
+		=> _success ? await success(Value!) : await failure(Error!);
+
+	/// <summary>
+	/// Asynchronously matches over the success value or failure value of the result and invokes an effectful action
+	/// onto the success value or the failure value. Can be conceptualized as an exhaustive <c>switch</c> statement
+	/// matching all possible values of the type.
+	/// </summary>
+	/// <param name="success">The function to call with the success value of the result if the result is a success.</param>
+	/// <param name="failure">The function to call with the failure value of the result if the result is a failure.</param>
+	public async ValueTask SwitchAsync(Func<T, ValueTask> success, Func<Error, ValueTask> failure)
+	{
+		if (_success) await success(Value!);
+		else await failure(Error!);
+	}
+}
+
+public readonly partial struct Result<T>
+{
+	/// <summary>
+	/// Asynchronously matches over the success value or failure value of the result and returns another value. Can be
+	/// conceptualized as an exhaustive <c>switch</c> expression matching all possible values of the type.
+	/// </summary>
+	/// <typeparam name="TResult">The type to return from the match.</typeparam>
+	/// <param name="success">The function to apply to the success value of the result if the result is a success.</param>
+	/// <param name="failure">The function to apply to the failure value of the result if the result is a failure.</param>
+	/// <returns>A task completing with the result of applying either <paramref name="success"/> or
+	/// <paramref name="failure"/> on the success value or failure value of the result.</returns>
+	[Pure]
+	public async Task<TResult> MatchAsync<TResult>(Func<T, Task<TResult>> success, Func<Error, Task<TResult>> failure)
+		=> _success ? await success(Value!) : await failure(Error!);
+
+	/// <summary>
+	/// Asynchronously matches over the success value or failure value of the result and invokes an effectful action
+	/// onto the success value or failure value. Can be conceptualized as an exhaustive <c>switch</c> statement matching
+	/// all possible values of
+	/// the type.
+	/// </summary>
+	/// <param name="success">The function to call with the success value of the result if the result is a success.</param>
+	/// <param name="failure">The function to call with the failure value of the result if the result is a failure.</param>
+	public async Task SwitchAsync(Func<T, Task> success, Func<Error, Task> failure)
+	{
+		if (_success) await success(Value!);
+		else await failure(Error!);
+	}
+}

src/Result/Result.Transform.cs

@@ -0,0 +1,335 @@
+using System.Diagnostics.Contracts;
+
+namespace Geekeey.Extensions.Result;
+
+public readonly partial struct Result<T>
+{
+	/// <summary>
+	/// Maps the success value of the result using a mapping function, or does nothing if the result is a failure.
+	/// </summary>
+	/// <param name="func">The function used to map the success value.</param>
+	/// <typeparam name="TNew">The type of the new value.</typeparam>
+	/// <returns>A new result containing either the mapped success value or the failure value of the original
+	/// result.</returns>
+	[Pure]
+	public Result<TNew> Map<TNew>(Func<T, TNew> func)
+		=> _success ? new Result<TNew>(func(Value!)) : new Result<TNew>(Error!);
+
+	/// <summary>
+	/// Tries to map the success value of the result using a mapping function, or does nothing if the result is a
+	/// failure. If the mapping function throws an exception, the exception will be returned wrapped in an
+	/// <see cref="ExceptionError"/>.
+	/// </summary>
+	/// <param name="func">The function used to map the success value.</param>
+	/// <typeparam name="TNew">The type of the new value.</typeparam>
+	/// <returns>A new result containing either the mapped value, the exception thrown by <paramref name="func"/>
+	/// wrapped in an <see cref="ExceptionError"/>, or the failure value of the original result.</returns>
+	[Pure]
+	public Result<TNew> TryMap<TNew>(Func<T, TNew> func)
+	{
+		try
+		{
+			return Map(func);
+		}
+		catch (Exception exception)
+		{
+			return new Result<TNew>(new ExceptionError(exception));
+		}
+	}
+
+	/// <summary>
+	/// Maps the success value of the result to a new result using a mapping function, or does nothing if the result is
+	/// a failure.
+	/// </summary>
+	/// <param name="func">The function used to map the success value to a new result.</param>
+	/// <typeparam name="TNew">The type of the new value.</typeparam>
+	/// <returns>A result which is either the mapped result or a new result containing the failure value of the original
+	/// result.</returns>
+	[Pure]
+	public Result<TNew> Then<TNew>(Func<T, Result<TNew>> func)
+		=> _success ? func(Value!) : new Result<TNew>(Error!);
+
+	/// <summary>
+	/// Tries to map the success value of the result to a new result using a mapping function, or does nothing if the result
+	/// is a failure. If the mapping function throws an exception, the exception will be returned wrapped in an
+	/// <see cref="ExceptionError"/>.
+	/// </summary>
+	/// <param name="func">The function used to map the success value to a new result.</param>
+	/// <typeparam name="TNew">The type of the new value.</typeparam>
+	/// <returns>A result which is either the mapped result, the exception thrown by <paramref name="func"/> wrapped in
+	/// an <see cref="ExceptionError"/>, or a new result containing the failure value of the original result.</returns>
+	[Pure]
+	public Result<TNew> ThenTry<TNew>(Func<T, Result<TNew>> func)
+	{
+		try
+		{
+			return Then(func);
+		}
+		catch (Exception exception)
+		{
+			return new Result<TNew>(new ExceptionError(exception));
+		}
+	}
+}
+
+public readonly partial struct Result<T>
+{
+	/// <summary>
+	/// Maps the success value of the result using an asynchronous mapping function, or does nothing if the result is
+	/// a failure.
+	/// </summary>
+	/// <param name="func">The function used to map the success value.</param>
+	/// <typeparam name="TNew">The type of the new value.</typeparam>
+	/// <returns>A <see cref="ValueTask{T}"/> which either completes asynchronously by invoking the mapping function on
+	/// the success value of the result and constructing a new result containing the mapped value, or completes
+	/// synchronously by returning a new result containing the failure value of the original result.</returns>
+	[Pure]
+	public ValueTask<Result<TNew>> MapAsync<TNew>(Func<T, ValueTask<TNew>> func)
+	{
+		if (!_success) return ValueTask.FromResult(new Result<TNew>(Error!));
+
+		var task = func(Value!);
+		return CreateResult(task);
+
+		static async ValueTask<Result<TNew>> CreateResult(ValueTask<TNew> task)
+		{
+			var value = await task;
+			return new Result<TNew>(value);
+		}
+	}
+
+	/// <summary>
+	/// Maps the success value of the result using an asynchronous mapping function, or does nothing if the result is a
+	/// failure. If the mapping function throws an exception, the exception will be returned wrapped in an
+	/// <see cref="ExceptionError"/>.
+	/// </summary>
+	/// <param name="func">The function used to map the success value.</param>
+	/// <typeparam name="TNew">The type of the new value.</typeparam>
+	/// <returns>A <see cref="ValueTask{T}"/> which either completes asynchronously by invoking the mapping function on
+	/// the success value of the result and constructing a new result containing the mapped value, returning any exception
+	/// thrown by <paramref name="func"/> wrapped in an <see cref="ExceptionError"/> or completes synchronously by
+	/// returning a new result containing the failure value of the original result.</returns>
+	[Pure]
+	public ValueTask<Result<TNew>> TryMapAsync<TNew>(Func<T, ValueTask<TNew>> func)
+	{
+		if (!_success) return ValueTask.FromResult(new Result<TNew>(Error!));
+
+		try
+		{
+			var task = func(Value!);
+			return CreateResult(task);
+		}
+		catch (Exception exception)
+		{
+			return ValueTask.FromResult(new Result<TNew>(new ExceptionError(exception)));
+		}
+
+		static async ValueTask<Result<TNew>> CreateResult(ValueTask<TNew> task)
+		{
+			try
+			{
+				var value = await task;
+				return new Result<TNew>(value);
+			}
+			catch (Exception exception)
+			{
+				return new Result<TNew>(new ExceptionError(exception));
+			}
+		}
+	}
+
+	/// <summary>
+	/// Maps the success value of the result to a new result using an asynchronous mapping function, or does nothing if
+	/// the result is a failure.
+	/// </summary>
+	/// <param name="func">The function used to map the success value to a new result.</param>
+	/// <typeparam name="TNew">The type of the new value.</typeparam>
+	/// <returns>A <see cref="ValueTask{T}"/> which either completes asynchronously by invoking the mapping function on
+	/// the success value of the result, or completes synchronously by returning a new result containing the failure
+	/// value of the original result.</returns>
+	[Pure]
+	public ValueTask<Result<TNew>> ThenAsync<TNew>(Func<T, ValueTask<Result<TNew>>> func)
+	{
+		if (!_success) return ValueTask.FromResult(new Result<TNew>(Error!));
+
+		var task = func(Value!);
+		return CreateResult(task);
+
+		static async ValueTask<Result<TNew>> CreateResult(ValueTask<Result<TNew>> task)
+		{
+			var result = await task;
+			return result;
+		}
+	}
+
+	/// <summary>
+	/// Maps the success value of the result to a new result using an asynchronous mapping function, or does nothing if
+	/// the result is a failure. If the mapping function throws an exception, the exception will be returned wrapped in
+	/// an <see cref="ExceptionError"/>.
+	/// </summary>
+	/// <param name="func">The function used to map the success value to a new result.</param>
+	/// <typeparam name="TNew">The type of the new value.</typeparam>
+	/// <returns>A <see cref="ValueTask{T}"/> which either completes asynchronously by invoking the mapping function on
+	/// the success value of the result, returning any exception thrown by <paramref name="func"/> wrapped in an
+	/// <see cref="ExceptionError"/>, or completes synchronously by returning a new result containing the failure value
+	/// of the original result.</returns>
+	[Pure]
+	public ValueTask<Result<TNew>> ThenTryAsync<TNew>(Func<T, ValueTask<Result<TNew>>> func)
+	{
+		if (!_success) return ValueTask.FromResult(new Result<TNew>(Error!));
+
+		try
+		{
+			var task = func(Value!);
+			return CreateResult(task);
+		}
+		catch (Exception exception)
+		{
+			return ValueTask.FromResult(new Result<TNew>(new ExceptionError(exception)));
+		}
+
+		static async ValueTask<Result<TNew>> CreateResult(ValueTask<Result<TNew>> task)
+		{
+			try
+			{
+				var value = await task;
+				return value;
+			}
+			catch (Exception exception)
+			{
+				return new Result<TNew>(new ExceptionError(exception));
+			}
+		}
+	}
+}
+
+public readonly partial struct Result<T>
+{
+	/// <summary>
+	/// Maps the success value of the result using an asynchronous mapping function, or does nothing if the result is
+	/// a failure.
+	/// </summary>
+	/// <param name="func">The function used to map the success value.</param>
+	/// <typeparam name="TNew">The type of the new value.</typeparam>
+	/// <returns>A <see cref="Task{T}"/> which either completes asynchronously by invoking the mapping function on
+	/// the success value of the result and constructing a new result containing the mapped value, or completes
+	/// synchronously by returning a new result containing the failure value of the original result.</returns>
+	[Pure]
+	public Task<Result<TNew>> MapAsync<TNew>(Func<T, Task<TNew>> func)
+	{
+		if (!_success) return Task.FromResult(new Result<TNew>(Error!));
+
+		var task = func(Value!);
+		return CreateResult(task);
+
+		static async Task<Result<TNew>> CreateResult(Task<TNew> task)
+		{
+			var value = await task;
+			return new Result<TNew>(value);
+		}
+	}
+
+	/// <summary>
+	/// Maps the success value of the result using an asynchronous mapping function, or does nothing if the result is a
+	/// failure. If the mapping function throws an exception, the exception will be returned wrapped in an
+	/// <see cref="ExceptionError"/>.
+	/// </summary>
+	/// <param name="func">The function used to map the success value.</param>
+	/// <typeparam name="TNew">The type of the new value.</typeparam>
+	/// <returns>A <see cref="Task{T}"/> which either completes asynchronously by invoking the mapping function on
+	/// the success value of the result and constructing a new result containing the mapped value, returning any exception
+	/// thrown by <paramref name="func"/> wrapped in an <see cref="ExceptionError"/> or completes synchronously by
+	/// returning a new result containing the failure value of the original result.</returns>
+	[Pure]
+	public Task<Result<TNew>> TryMapAsync<TNew>(Func<T, Task<TNew>> func)
+	{
+		if (!_success) return Task.FromResult(new Result<TNew>(Error!));
+
+		try
+		{
+			var task = func(Value!);
+			return CreateResult(task);
+		}
+		catch (Exception exception)
+		{
+			return Task.FromResult(new Result<TNew>(new ExceptionError(exception)));
+		}
+
+		static async Task<Result<TNew>> CreateResult(Task<TNew> task)
+		{
+			try
+			{
+				var value = await task;
+				return new Result<TNew>(value);
+			}
+			catch (Exception exception)
+			{
+				return new Result<TNew>(new ExceptionError(exception));
+			}
+		}
+	}
+
+	/// <summary>
+	/// Maps the success value of the result to a new result using an asynchronous mapping function, or does nothing if
+	/// the result is a failure.
+	/// </summary>
+	/// <param name="func">The function used to map the success value to a new result.</param>
+	/// <typeparam name="TNew">The type of the new value.</typeparam>
+	/// <returns>A <see cref="Task{T}"/> which either completes asynchronously by invoking the mapping function on
+	/// the success value of the result, or completes synchronously by returning a new result containing the failure
+	/// value of the original result.</returns>
+	[Pure]
+	public Task<Result<TNew>> ThenAsync<TNew>(Func<T, Task<Result<TNew>>> func)
+	{
+		if (!_success) return Task.FromResult(new Result<TNew>(Error!));
+
+		var task = func(Value!);
+		return CreateResult(task);
+
+		static async Task<Result<TNew>> CreateResult(Task<Result<TNew>> task)
+		{
+			var result = await task;
+			return result;
+		}
+	}
+
+	/// <summary>
+	/// Maps the success value of the result to a new result using an asynchronous mapping function, or does nothing if
+	/// the result is a failure. If the mapping function throws an exception, the exception will be returned wrapped in
+	/// an <see cref="ExceptionError"/>.
+	/// </summary>
+	/// <param name="func">The function used to map the success value to a new result.</param>
+	/// <typeparam name="TNew">The type of the new value.</typeparam>
+	/// <returns>A <see cref="Task{T}"/> which either completes asynchronously by invoking the mapping function on
+	/// the success value of the result, returning any exception thrown by <paramref name="func"/> wrapped in an
+	/// <see cref="ExceptionError"/>, or completes synchronously by returning a new result containing the failure value
+	/// of the original result.</returns>
+	[Pure]
+	public Task<Result<TNew>> ThenTryAsync<TNew>(Func<T, Task<Result<TNew>>> func)
+	{
+		if (!_success) return Task.FromResult(new Result<TNew>(Error!));
+
+		try
+		{
+			var task = func(Value!);
+			return CreateResult(task);
+		}
+		catch (Exception exception)
+		{
+			return Task.FromResult(new Result<TNew>(new ExceptionError(exception)));
+		}
+
+		static async Task<Result<TNew>> CreateResult(Task<Result<TNew>> task)
+		{
+			try
+			{
+				var value = await task;
+				return value;
+			}
+			catch (Exception exception)
+			{
+				return new Result<TNew>(new ExceptionError(exception));
+			}
+		}
+	}
+}

src/Result/Result.Unbox.cs

@@ -0,0 +1,63 @@
+using System.Diagnostics.CodeAnalysis;
+using System.Diagnostics.Contracts;
+
+namespace Geekeey.Extensions.Result;
+
+public readonly partial struct Result<T>
+{
+	/// <summary>
+	/// Tries to get the success value from the result.
+	/// </summary>
+	/// <param name="value">The success value of the result.</param>
+	/// <returns>Whether the result has success value.</returns>
+	[Pure]
+	public bool TryGetValue([MaybeNullWhen(false)] out T value)
+	{
+		value = Value!;
+
+		return _success;
+	}
+
+	/// <summary>
+	/// Tries to get the success value from the result.
+	/// </summary>
+	/// <param name="value">The success value of the result.</param>
+	/// <param name="error">The failure value of the result.</param>
+	/// <returns>Whether the result has a success value.</returns>
+	[Pure]
+	public bool TryGetValue([MaybeNullWhen(false)] out T value, [MaybeNullWhen(true)] out Error error)
+	{
+		value = Value!;
+		error = !_success ? Error : null!;
+
+		return _success;
+	}
+
+	/// <summary>
+	/// Tries to get the failure value from the result.
+	/// </summary>
+	/// <param name="error">The failure value of the result.</param>
+	/// <returns>Whether the result has a failure value.</returns>
+	[Pure]
+	public bool TryGetError([MaybeNullWhen(false)] out Error error)
+	{
+		error = !_success ? Error : null!;
+
+		return !_success;
+	}
+
+	/// <summary>
+	/// Tries to get the failure value from the result.
+	/// </summary>
+	/// <param name="error">The failure value of the result.</param>
+	/// <param name="value">The success value of the result.</param>
+	/// <returns>Whether the result a failure value.</returns>
+	[Pure]
+	public bool TryGetError([MaybeNullWhen(false)] out Error error, [MaybeNullWhen(true)] out T value)
+	{
+		error = !_success ? Error : null!;
+		value = Value!;
+
+		return !_success;
+	}
+}

src/Result/Result.cs

@@ -0,0 +1,76 @@
+using System.Diagnostics;
+using System.Diagnostics.CodeAnalysis;
+using System.Diagnostics.Contracts;
+
+namespace Geekeey.Extensions.Result;
+
+/// <summary>
+/// A type which contains either a success value or a failure value, which is represented by an <see cref="Error"/>.
+/// </summary>
+/// <typeparam name="T">The type of the success value.</typeparam>
+[DebuggerTypeProxy(typeof(Result<>.ResultDebugProxy))]
+public readonly partial struct Result<T>
+{
+	private readonly bool _success;
+
+	private readonly T? _value;
+	private readonly Error? _error;
+
+	/// <summary>
+	/// Creates a new result with a success value.
+	/// </summary>
+	/// <param name="value">The success value.</param>
+	public Result(T value)
+	{
+		_success = true;
+		_value = value;
+		_error = default;
+	}
+
+	/// <summary>
+	/// Creates a new result with a failure value.
+	/// </summary>
+	/// <param name="error">The error of the result.</param>
+	public Result(Error error)
+	{
+		_success = false;
+		_value = default;
+		_error = error;
+	}
+
+	internal T? Value => _value;
+
+	internal Error? Error => _success ? null : (_error ?? Error.DefaultValueError);
+
+	/// <summary>
+	/// Whether the result is a success.
+	/// </summary>
+	/// <remarks>
+	/// This is always the inverse of <see cref="IsFailure"/> but is more specific about intent.
+	/// </remarks>
+	[MemberNotNullWhen(true, nameof(Value))]
+	public bool IsSuccess => _success;
+
+	/// <summary>
+	/// Whether the result is a failure.
+	/// </summary>
+	/// <remarks>
+	/// This is always the inverse of <see cref="IsSuccess"/> but is more specific about intent.
+	/// </remarks>
+	[MemberNotNullWhen(true, nameof(Error))]
+	public bool IsFailure => !_success;
+
+	/// <summary>
+	/// Gets a string representation of the result.
+	/// </summary>
+	[Pure]
+	public override string ToString()
+		=> _success ? $"Success {{ {Value} }}" : $"Failure {{ {Error} }}";
+
+	private sealed class ResultDebugProxy(Result<T> result)
+	{
+		public bool IsSuccess => result.IsSuccess;
+
+		public object? Value => result.IsSuccess ? result.Value : result.Error;
+	}
+}

src/Result/Result.csproj

@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <InternalsVisibleTo Include="$(AssemblyName).Tests" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <None Include=".\package-readme.md" Pack="true" PackagePath="\" />
+    <None Include="Project.props" Pack="true" PackagePath="build\$(AssemblyName).props" />
+  </ItemGroup>
+</Project>

src/Result/package-readme.md

@@ -0,0 +1,2 @@
+Result is a simple yet powerful [result type](https://doc.rust-lang.org/std/result/) implementation for C#, containing a
+variety of utilities and standard functions for working with result types and integrating them into the rest of C#.