AInq.Optional

What is it?

Simple optional types with basic helpers and converters

• Maybe<T> value or nothing
• Try<T> value or error
• Either<TLeft, TRight> value either value

AInq.Optional - Types and basic helpers

AInq.Optional.Async - Async helpers and extensions

New in 4.1

Large refactoring and internal optimization with some breaking changes

• Remove build targets for STS .Net versions
• System.Linq is used for collection extensions, which may cause minor behavior changes
• System.Linq.AsyncEnumerable is used in .net10 with minor API changes
• Change some methods to remove ambiguity
  • Rename Maybe.AsTry to Maybe.TryValue
  • Rename Try.AsMaybe to Try.MaybeValue
  • Rename converter Maybe.Or to Maybe.EitherValue
  • Make bool cast operators explicit
• Remove all Try<T> extensions, which can implicitly hide exceptions
• Try.MaybeValue now throw exception if source is not success, introduced flag to suppress this
• Save exception stacktrace in Try<T>
• New APIs
  • | (or) operator for Maybe<T>
  • ! (not) operator for Maybe<T> and Try<T>
  • ! (invert) operator for Either<TLeft, TRight>
  • Maybe.Values collection extension with filtering
  • Try.Result with additional generator parameter

New in 3.0

For version 3.0 this lib was completely rewritten with some breaking changes

• All types are now class instead of struct
• Remove some logically obscure methods
  • IComparable implementation (problems with comparing null and empty item)
  • Type cast operators (unused)
  • Try.SelectOrDefault and Try.ValueOrDefault (implicitly hides error, can be replaced with Try.AsMaybe)
• Async extensions completely rewritten using ValueTask and moved to separate package

---

Contribution

If you find a bug, have a question or something else - you are friendly welcome to open an issue.

License

Copyright © 2021 Anton Andryushchenko. AInq.Optional is licensed under Apache License 2.0