improve result structure and handling

This commit is contained in:
Oli Sturm
2026-05-04 19:39:49 +01:00
parent 0d02927ba6
commit 73ed4c7b9c
14 changed files with 413 additions and 371 deletions
+21 -13
View File
@@ -1,4 +1,5 @@
using CsharpFp3.Domain;
using CsharpFp3.Library;
namespace CsharpFp3.Tests;
@@ -11,46 +12,52 @@ public class AccountTests
{
var result = AccountDomain.Open(Guid.NewGuid(), new Money(-1m));
Assert.IsType<AccountError.OpeningBalanceMustBeNonNegative>(result.Error);
Assert.True(result.Match(_ => false, e => e is AccountError.OpeningBalanceMustBeNonNegative));
}
[Fact]
public void Withdrawing_a_zero_amount_returns_AmountMustBePositive()
{
var account = AccountDomain.Open(Guid.NewGuid(), new Money(100m)).Value;
var accountResult = AccountDomain.Open(Guid.NewGuid(), new Money(100m));
var account = accountResult.Match(v => v, _ => throw new InvalidOperationException("Expected success"));
var result = AccountDomain.Withdraw(account, new Money(0m));
Assert.IsType<AccountError.AmountMustBePositive>(result.Error);
Assert.True(result.Match(_ => false, e => e is AccountError.AmountMustBePositive));
}
[Fact]
public void Withdrawing_a_negative_amount_returns_AmountMustBePositive()
{
var account = AccountDomain.Open(Guid.NewGuid(), new Money(100m)).Value;
var accountResult = AccountDomain.Open(Guid.NewGuid(), new Money(100m));
var account = accountResult.Match(v => v, _ => throw new InvalidOperationException("Expected success"));
var result = AccountDomain.Withdraw(account, new Money(-10m));
Assert.IsType<AccountError.AmountMustBePositive>(result.Error);
Assert.True(result.Match(_ => false, e => e is AccountError.AmountMustBePositive));
}
[Fact]
public void Withdrawing_more_than_the_balance_returns_InsufficientBalance()
{
var account = AccountDomain.Open(Guid.NewGuid(), new Money(100m)).Value;
var accountResult = AccountDomain.Open(Guid.NewGuid(), new Money(100m));
var account = accountResult.Match(v => v, _ => throw new InvalidOperationException("Expected success"));
var result = AccountDomain.Withdraw(account, new Money(101m));
Assert.IsType<AccountError.InsufficientBalance>(result.Error);
Assert.True(result.Match(_ => false, e => e is AccountError.InsufficientBalance));
}
[Fact]
public void InsufficientBalance_error_reports_the_current_balance_and_attempted_amount()
{
var account = AccountDomain.Open(Guid.NewGuid(), new Money(100m)).Value;
var accountResult = AccountDomain.Open(Guid.NewGuid(), new Money(100m));
var account = accountResult.Match(v => v, _ => throw new InvalidOperationException("Expected success"));
var error = Assert.IsType<AccountError.InsufficientBalance>(
AccountDomain.Withdraw(account, new Money(150m)).Error
var result = AccountDomain.Withdraw(account, new Money(150m));
var error = result.Match(
_ => throw new InvalidOperationException("Expected failure"),
e => e is AccountError.InsufficientBalance ins ? ins : throw new InvalidOperationException("Expected InsufficientBalance")
);
Assert.Equal(100m, error.Balance.Amount);
@@ -60,13 +67,14 @@ public class AccountTests
[Fact]
public void Successive_withdrawals_are_each_applied_to_the_running_balance()
{
var account = AccountDomain.Open(Guid.NewGuid(), new Money(300m)).Value;
var accountResult = AccountDomain.Open(Guid.NewGuid(), new Money(300m));
var account = accountResult.Match(v => v, _ => throw new InvalidOperationException("Expected success"));
var result1 = AccountDomain.Withdraw(account, new Money(100m));
var updatedAccount1 = result1.Value;
var updatedAccount1 = result1.Match(v => v, _ => throw new InvalidOperationException("Expected success"));
var result2 = AccountDomain.Withdraw(updatedAccount1, new Money(100m));
var updatedAccount2 = result2.Value;
var updatedAccount2 = result2.Match(v => v, _ => throw new InvalidOperationException("Expected success"));
Assert.Equal(100m, updatedAccount2.Balance.Amount);
}
+68 -67
View File
@@ -1,4 +1,5 @@
using CsharpFp3.Library;
using static CsharpFp3.Library.ResultModule;
namespace CsharpFp3.Tests;
@@ -10,7 +11,7 @@ public class ResultTests
[Fact]
public void Ok_is_success()
{
var result = Result<int, string>.Ok(42);
Result<int, string> result = new ResultOk<int, string>(42);
Assert.True(result.IsSuccess);
Assert.False(result.IsFailure);
@@ -19,42 +20,26 @@ public class ResultTests
[Fact]
public void Fail_is_failure()
{
var result = Result<int, string>.Fail("oops");
Result<int, string> result = new ResultFail<int, string>("oops");
Assert.True(result.IsFailure);
Assert.False(result.IsSuccess);
}
[Fact]
public void Ok_exposes_value()
public void Ok_exposes_value_via_Match()
{
var result = Result<int, string>.Ok(42);
Result<int, string> result = new ResultOk<int, string>(42);
Assert.Equal(42, result.Value);
Assert.Equal(42, result.Match(v => v, _ => 0));
}
[Fact]
public void Fail_exposes_error()
public void Fail_exposes_error_via_Match()
{
var result = Result<int, string>.Fail("oops");
Result<int, string> result = new ResultFail<int, string>("oops");
Assert.Equal("oops", result.Error);
}
[Fact]
public void Accessing_Value_on_a_failed_result_throws()
{
var result = Result<int, string>.Fail("oops");
Assert.Throws<InvalidOperationException>(() => result.Value);
}
[Fact]
public void Accessing_Error_on_a_successful_result_throws()
{
var result = Result<int, string>.Ok(42);
Assert.Throws<InvalidOperationException>(() => result.Error);
Assert.Equal("oops", result.Match(_ => "", e => e));
}
// --- Match ---
@@ -62,7 +47,7 @@ public class ResultTests
[Fact]
public void Match_calls_onSuccess_for_Ok()
{
var result = Result<int, string>.Ok(10);
Result<int, string> result = new ResultOk<int, string>(10);
var output = result.Match(v => $"value:{v}", e => $"error:{e}");
@@ -72,7 +57,7 @@ public class ResultTests
[Fact]
public void Match_calls_onFailure_for_Fail()
{
var result = Result<int, string>.Fail("bad");
Result<int, string> result = new ResultFail<int, string>("bad");
var output = result.Match(v => $"value:{v}", e => $"error:{e}");
@@ -84,7 +69,7 @@ public class ResultTests
[Fact]
public void Switch_calls_onSuccess_for_Ok()
{
var result = Result<int, string>.Ok(7);
Result<int, string> result = new ResultOk<int, string>(7);
var called = false;
result.Switch(_ => called = true, _ => { });
@@ -95,7 +80,7 @@ public class ResultTests
[Fact]
public void Switch_calls_onFailure_for_Fail()
{
var result = Result<int, string>.Fail("err");
Result<int, string> result = new ResultFail<int, string>("err");
var called = false;
result.Switch(_ => { }, _ => called = true);
@@ -111,7 +96,7 @@ public class ResultTests
var result = Result<int, string>.Catch(() => 99, ex => ex.Message);
Assert.True(result.IsSuccess);
Assert.Equal(99, result.Value);
Assert.Equal(99, result.Match(v => v, _ => 0));
}
[Fact]
@@ -123,7 +108,7 @@ public class ResultTests
);
Assert.True(result.IsFailure);
Assert.Equal("boom", result.Error);
Assert.Equal("boom", result.Match(_ => "", e => e));
}
// --- Bind ---
@@ -131,33 +116,34 @@ public class ResultTests
[Fact]
public void Bind_chains_to_the_next_result_on_success()
{
var result = Result<int, string>.Ok(5).Bind(v => Result<string, string>.Ok($"got {v}"));
Result<int, string> result = new ResultOk<int, string>(5);
var chained = result.Bind(v => new ResultOk<string, string>($"got {v}"));
Assert.Equal("got 5", result.Value);
Assert.Equal("got 5", chained.Match(v => v, _ => ""));
}
[Fact]
public void Bind_short_circuits_on_failure_without_calling_the_binder()
{
var binderCalled = false;
var result = Result<int, string>
.Fail("nope")
.Bind(v =>
{
binderCalled = true;
return Result<string, string>.Ok($"got {v}");
});
Result<int, string> result = new ResultFail<int, string>("nope");
var chained = result.Bind(v =>
{
binderCalled = true;
return new ResultOk<string, string>($"got {v}");
});
Assert.False(binderCalled);
Assert.Equal("nope", result.Error);
Assert.Equal("nope", chained.Match(_ => "", e => e));
}
[Fact]
public void Bind_propagates_the_inner_failure_when_the_binder_returns_Fail()
{
var result = Result<int, string>.Ok(5).Bind(_ => Result<string, string>.Fail("inner fail"));
Result<int, string> result = new ResultOk<int, string>(5);
var chained = result.Bind(_ => new ResultFail<string, string>("inner fail"));
Assert.Equal("inner fail", result.Error);
Assert.Equal("inner fail", chained.Match(_ => "", e => e));
}
// --- Map ---
@@ -165,23 +151,25 @@ public class ResultTests
[Fact]
public void Map_transforms_the_value_on_success()
{
var result = Result<int, string>.Ok(3).Map(v => v * 2);
Result<int, string> result = new ResultOk<int, string>(3);
var mapped = result.Map(v => v * 2);
Assert.Equal(6, result.Value);
Assert.Equal(6, mapped.Match(v => v, _ => 0));
}
[Fact]
public void Map_does_not_call_the_mapper_on_failure()
{
var mapperCalled = false;
var result = Result<int, string>.Fail("err").Map(v =>
Result<int, string> result = new ResultFail<int, string>("err");
var mapped = result.Map(v =>
{
mapperCalled = true;
return v * 2;
});
Assert.False(mapperCalled);
Assert.Equal("err", result.Error);
Assert.Equal("err", mapped.Match(_ => "", e => e));
}
// --- Tap ---
@@ -190,17 +178,19 @@ public class ResultTests
public void Tap_calls_the_action_and_returns_the_original_result_on_success()
{
var seen = -1;
var result = Result<int, string>.Ok(8).Tap(v => seen = v);
Result<int, string> result = new ResultOk<int, string>(8);
var tapped = result.Tap(v => seen = v);
Assert.Equal(8, seen);
Assert.Equal(8, result.Value);
Assert.Equal(8, tapped.Match(v => v, _ => 0));
}
[Fact]
public void Tap_does_not_call_the_action_on_failure()
{
var called = false;
Result<int, string>.Fail("err").Tap(_ => called = true);
Result<int, string> result = new ResultFail<int, string>("err");
result.Tap(_ => called = true);
Assert.False(called);
}
@@ -211,17 +201,19 @@ public class ResultTests
public void TapError_calls_the_action_and_returns_the_original_result_on_failure()
{
var seen = "";
var result = Result<int, string>.Fail("bad").TapError(e => seen = e);
Result<int, string> result = new ResultFail<int, string>("bad");
var tapped = result.TapError(e => seen = e);
Assert.Equal("bad", seen);
Assert.Equal("bad", result.Error);
Assert.Equal("bad", tapped.Match(_ => "", e => e));
}
[Fact]
public void TapError_does_not_call_the_action_on_success()
{
var called = false;
Result<int, string>.Ok(1).TapError(_ => called = true);
Result<int, string> result = new ResultOk<int, string>(1);
result.TapError(_ => called = true);
Assert.False(called);
}
@@ -231,23 +223,25 @@ public class ResultTests
[Fact]
public void MapError_transforms_the_error_on_failure()
{
var result = Result<int, string>.Fail("oops").MapError(e => e.Length);
Result<int, string> result = new ResultFail<int, string>("oops");
var mapped = result.MapError(e => e.Length);
Assert.Equal(4, result.Error);
Assert.Equal(4, mapped.Match(_ => 0, e => e));
}
[Fact]
public void MapError_does_not_call_the_mapper_on_success()
{
var mapperCalled = false;
var result = Result<int, string>.Ok(1).MapError(e =>
Result<int, string> result = new ResultOk<int, string>(1);
var mapped = result.MapError(e =>
{
mapperCalled = true;
return e.Length;
});
Assert.False(mapperCalled);
Assert.Equal(1, result.Value);
Assert.Equal(1, mapped.Match(v => v, _ => 0));
}
// --- Select / SelectMany (LINQ support) ---
@@ -255,41 +249,48 @@ public class ResultTests
[Fact]
public void Select_is_equivalent_to_Map()
{
var result = Result<int, string>.Ok(4).Select(v => v + 1);
Result<int, string> result = new ResultOk<int, string>(4);
var selected = result.Select(v => v + 1);
Assert.Equal(5, result.Value);
Assert.Equal(5, selected.Match(v => v, _ => 0));
}
[Fact]
public void SelectMany_sequences_two_successful_results()
{
Result<int, string> aResult = new ResultOk<int, string>(3);
Result<int, string> bResult = new ResultOk<int, string>(4);
var result =
from a in Result<int, string>.Ok(3)
from b in Result<int, string>.Ok(4)
from a in aResult
from b in bResult
select a + b;
Assert.Equal(7, result.Value);
Assert.Equal(7, result.Match(v => v, _ => 0));
}
[Fact]
public void SelectMany_short_circuits_when_the_first_result_fails()
{
Result<int, string> aResult = new ResultFail<int, string>("first fail");
Result<int, string> bResult = new ResultOk<int, string>(4);
var result =
from a in Result<int, string>.Fail("first fail")
from b in Result<int, string>.Ok(4)
from a in aResult
from b in bResult
select a + b;
Assert.Equal("first fail", result.Error);
Assert.Equal("first fail", result.Match(_ => "", e => e));
}
[Fact]
public void SelectMany_short_circuits_when_the_second_result_fails()
{
Result<int, string> aResult = new ResultOk<int, string>(3);
Result<int, string> bResult = new ResultFail<int, string>("second fail");
var result =
from a in Result<int, string>.Ok(3)
from b in Result<int, string>.Fail("second fail")
from a in aResult
from b in bResult
select a + b;
Assert.Equal("second fail", result.Error);
Assert.Equal("second fail", result.Match(_ => "", e => e));
}
}
+24 -15
View File
@@ -2,6 +2,7 @@ using CsharpFp3.Application;
using CsharpFp3.Domain;
using CsharpFp3.Infrastructure;
using CsharpFp3.Library;
using static CsharpFp3.Library.ResultModule;
namespace CsharpFp3.Tests;
@@ -15,7 +16,8 @@ public class WithdrawMoneyTests
) BuildHandler()
{
var repo = InMemoryAccountRepository.Create();
var withdraw = AccountApplication.CreateWithdrawMoney(repo).Value;
var result = AccountApplication.CreateWithdrawMoney(repo);
var withdraw = result.Match(v => v, _ => throw new InvalidOperationException("Expected success"));
return (withdraw, repo);
}
@@ -24,11 +26,12 @@ public class WithdrawMoneyTests
{
var (withdraw, repo) = BuildHandler();
var accountId = Guid.NewGuid();
repo.SaveAccount(AccountDomain.Open(accountId, new Money(200m)).Value);
var accountResult = AccountDomain.Open(accountId, new Money(200m));
repo.SaveAccount(accountResult.Match(v => v, _ => throw new InvalidOperationException("Expected success")));
withdraw(accountId, 75m);
var account = repo.LoadAccount(accountId).Value;
var account = repo.LoadAccount(accountId).Match(v => v, _ => throw new InvalidOperationException("Expected success"));
Assert.Equal(125m, account.Balance.Amount);
}
@@ -37,11 +40,12 @@ public class WithdrawMoneyTests
{
var (withdraw, repo) = BuildHandler();
var accountId = Guid.NewGuid();
repo.SaveAccount(AccountDomain.Open(accountId, new Money(100m)).Value);
var accountResult = AccountDomain.Open(accountId, new Money(100m));
repo.SaveAccount(accountResult.Match(v => v, _ => throw new InvalidOperationException("Expected success")));
withdraw(accountId, 100m);
var account = repo.LoadAccount(accountId).Value;
var account = repo.LoadAccount(accountId).Match(v => v, _ => throw new InvalidOperationException("Expected success"));
Assert.Equal(0m, account.Balance.Amount);
}
@@ -52,7 +56,7 @@ public class WithdrawMoneyTests
var result = withdraw(Guid.NewGuid(), 50m);
Assert.IsType<AccountError.AccountNotFound>(result.Error);
Assert.True(result.Match(_ => false, e => e is AccountError.AccountNotFound));
}
[Fact]
@@ -60,11 +64,12 @@ public class WithdrawMoneyTests
{
var (withdraw, repo) = BuildHandler();
var accountId = Guid.NewGuid();
repo.SaveAccount(AccountDomain.Open(accountId, new Money(50m)).Value);
var accountResult = AccountDomain.Open(accountId, new Money(50m));
repo.SaveAccount(accountResult.Match(v => v, _ => throw new InvalidOperationException("Expected success")));
var result = withdraw(accountId, 100m);
Assert.IsType<AccountError.InsufficientBalance>(result.Error);
Assert.True(result.Match(_ => false, e => e is AccountError.InsufficientBalance));
}
[Fact]
@@ -73,8 +78,9 @@ public class WithdrawMoneyTests
var (withdraw, _) = BuildHandler();
var accountId = Guid.NewGuid();
var error = Assert.IsType<AccountError.AccountNotFound>(
withdraw(accountId, 50m).Error
var error = withdraw(accountId, 50m).Match(
_ => throw new InvalidOperationException("Expected failure"),
e => e is AccountError.AccountNotFound notFound ? notFound : throw new InvalidOperationException("Expected AccountNotFound")
);
Assert.Equal(accountId, error.AccountId);
@@ -85,10 +91,12 @@ public class WithdrawMoneyTests
{
var (withdraw, repo) = BuildHandler();
var accountId = Guid.NewGuid();
repo.SaveAccount(AccountDomain.Open(accountId, new Money(50m)).Value);
var accountResult = AccountDomain.Open(accountId, new Money(50m));
repo.SaveAccount(accountResult.Match(v => v, _ => throw new InvalidOperationException("Expected success")));
var error = Assert.IsType<AccountError.InsufficientBalance>(
withdraw(accountId, 120m).Error
var error = withdraw(accountId, 120m).Match(
_ => throw new InvalidOperationException("Expected failure"),
e => e is AccountError.InsufficientBalance ins ? ins : throw new InvalidOperationException("Expected InsufficientBalance")
);
Assert.Equal(50m, error.Balance.Amount);
@@ -100,11 +108,12 @@ public class WithdrawMoneyTests
{
var (withdraw, repo) = BuildHandler();
var accountId = Guid.NewGuid();
repo.SaveAccount(AccountDomain.Open(accountId, new Money(50m)).Value);
var accountResult = AccountDomain.Open(accountId, new Money(50m));
repo.SaveAccount(accountResult.Match(v => v, _ => throw new InvalidOperationException("Expected success")));
withdraw(accountId, 999m);
var account = repo.LoadAccount(accountId).Value;
var account = repo.LoadAccount(accountId).Match(v => v, _ => throw new InvalidOperationException("Expected success"));
Assert.Equal(50m, account.Balance.Amount);
}
}