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.3

Some Maybe LINQ extensions renamed to avoid ambiguity with other libs with similar functions. Current method names saved as aliases and marked as deprecated and will be removed in next major release.

Renamed method groups:

• IEnumerable.FirstOrNone -> IEnumerable.MaybeFirst
• IEnumerable.LastOrNone -> IEnumerable.MaybeLast
• IEnumerable.SingleOrNone -> IEnumerable.MaybeSingle
• IEnumerable.FirstOrNoneNotNull -> IEnumerable.MaybeFirstNotNull
• IEnumerable.LastOrNoneNotNull -> IEnumerable.MaybeLastNotNull
• IEnumerable.SingleOrNoneNotNull -> IEnumerable.MaybeSingleNotNull

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