Philiprehberger.OptionType 0.2.1

Philiprehberger.OptionType

Option/Maybe monad for explicit null handling with Map, Bind, Match, and LINQ support.

Installation

dotnet add package Philiprehberger.OptionType

Usage

Creating Options

using Philiprehberger.OptionType;

var some = Option.Some(42);
var none = Option.None<int>();
var fromNullable = Option.From<string>(null); // None
var fromValue = Option.From("hello");         // Some("hello")

Transforming Values

var doubled = Option.Some(21).Map(x => x * 2);  // Some(42)

var parsed = Option.Some("123")
    .Bind(s => int.TryParse(s, out var n) ? Option.Some(n) : Option.None<int>());

var positive = Option.Some(42).Filter(x => x > 0);  // Some(42)
var negative = Option.Some(-1).Filter(x => x > 0);  // None

Pattern Matching

string message = Option.Some(42).Match(
    some: v => $"Got {v}",
    none: () => "Nothing"
);

int value = none.ValueOr(0);           // 0
int must = some.ValueOrThrow();        // 42

LINQ Query Syntax

var result = from x in Option.Some(10)
             from y in Option.Some(20)
             select x + y;  // Some(30)

var filtered = from x in Option.Some(42)
               where x > 0
               select x;  // Some(42)

Nullable Conversion

int? nullable = 42;
var option = nullable.ToOption();  // Some(42)

int? nullValue = null;
var noneOption = nullValue.ToOption();  // None

Async Operations

var result = await Option.Some(42)
    .MapAsync(async x => await FetchMultiplierAsync(x));

var bound = await Option.Some("user-123")
    .BindAsync(async id => await FindUserAsync(id));

var message = await Option.Some(42)
    .MatchAsync(
        some: async v => await FormatAsync(v),
        none: () => Task.FromResult("not found")
    );

Fallback with OrElse

var primary = Option.None<int>();
var result = primary.OrElse(Option.Some(99));  // Some(99)

var lazy = primary.OrElse(() => Option.Some(ComputeDefault()));  // factory only called when None

Safe Execution with Try

var parsed = Option.Try(() => int.Parse("42"));         // Some(42)
var failed = Option.Try(() => int.Parse("not a number")); // None

var fetched = await Option.TryAsync(async () => await FetchDataAsync());

Side Effects with Tap

var result = Option.Some(42)
    .Tap(v => Console.WriteLine($"Processing: {v}"))
    .Map(x => x * 2)
    .TapNone(() => Console.WriteLine("No value found"));

API

Option (static)

Option<T> (struct)

Extension Methods

Development

dotnet build src/Philiprehberger.OptionType.csproj --configuration Release

Support

If you find this project useful:

⭐ Star the repo

🐛 Report issues

💡 Suggest features

❤️ Sponsor development

🌐 All Open Source Projects

💻 GitHub Profile

🔗 LinkedIn Profile

License

MIT