feat: initial project commit

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
+}