Lightweight C# library for Go-like error handling
Get Started
$ dotnet add package rslcsReadme
rslcs
A lightweight C# library that brings Go-like error handling to .NET applications
Installation
dotnet add package rslcs
Features
- Explicit Error Handling: No more hidden exceptions or try/catch blocks for expected errors
- Type Safety: Compiler-enforced error checking prevents forgetting to handle error cases
- Deconstruction Support: C# tuple deconstruction for clean, concise code
- Operation Chaining: API for composing operations that might fail
- Zero Dependencies: Pure C# implementation with no external dependencies
Basic Usage
using rslcs;
Result<double> Divide(double a, double b)
{
if (b == 0)
{
return new(new DivideByZeroException("Cannot divide by zero"));
}
return new(a / b);
}
var result = Divide(10, 2);
if (result.Error != null)
{
Console.WriteLine($"Error: {result.Error.Message}");
return;
}
Console.WriteLine($"Result: {result.Value}");
Tuple Deconstruction
var (value, error) = Divide(10, 0);
if (error != null)
{
Console.WriteLine($"Error: {error.Message}");
return;
}
Console.WriteLine($"Result: {value}");
Operation Chaining
var result = Divide(10, 2)
.Then(r => Divide(r, 5))
.Then(r => Divide(r, 2));
// Equivalent to:
var result = Divide(10, 2);
if (result.Error == null) return new(result.Error);
result = Divide(result.Value, 5);
if (result.Error == null) return new(result.Error);
return Divide(result.Value, 2);
Async Support
async Task<Result<string>> FetchDataAsync(string url)
{
try
{
using HttpClient client = new HttpClient();
HttpResponseMessage response = await client.GetAsync(url);
if (!response.IsSuccessStatusCode)
{
return new(new HttpRequestException(
$"HTTP error! Status: {response.StatusCode}"));
}
string data = await response.Content.ReadAsStringAsync();
return new(data);
}
catch (Exception ex)
{
return new(ex);
}
}
// Usage
async Task ProcessDataAsync()
{
var (value, error) = await FetchDataAsync("https://api.example.com/data");
if (error != null)
{
Console.WriteLine($"Error: {error.Message}");
return;
}
Console.WriteLine($"Data: {value}");
}
License
MIT License