Existential.Net
3.0.0
dotnet add package Existential.Net --version 3.0.0
NuGet\Install-Package Existential.Net -Version 3.0.0
<PackageReference Include="Existential.Net" Version="3.0.0" />
paket add Existential.Net --version 3.0.0
#r "nuget: Existential.Net, 3.0.0"
// Install Existential.Net as a Cake Addin
#addin nuget:?package=Existential.Net&version=3.0.0
// Install Existential.Net as a Cake Tool
#tool nuget:?package=Existential.Net&version=3.0.0
About Existential.NET
Existential is a utility library that contains parameter validation methods, a Maybe monad, and more. Full documentation can be found at existential.ggreig.com.
It can be used to:
- work effectively with nulls (Validate, Maybe<T>)
- log exceptions from an exception filter before they're handled or rethrown
- efficiently resolve Code Analysis issues CA1062 and CA2000
- help generate a hash code, and
- convert the names of generic types into a familiar string representation.
It reduces the code you need to write for basic null checks by providing validation techniques or - even better - using the Maybe<T> monad can just help you not to care!
Other classes in Existential help you to avoid constantly reinventing the wheel for common problems such as converting an IEnumerable to an IEnumerable<T>, getting the name of the current method or negating a Predicate.
These solutions aren't innovative in themselves - plenty code examples exist out there - but Existential brings them together into one tested library so you don't have to.
To get started:
| Product | Versions |
|---|---|
| .NET | net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows net7.0 net7.0-android net7.0-ios net7.0-maccatalyst net7.0-macos net7.0-tvos net7.0-windows |
| .NET Core | netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1 |
| .NET Standard | netstandard2.0 netstandard2.1 |
| .NET Framework | net461 net462 net463 net47 net471 net472 net48 net481 |
| MonoAndroid | monoandroid |
| MonoMac | monomac |
| MonoTouch | monotouch |
| Tizen | tizen40 tizen60 |
| Xamarin.iOS | xamarinios |
| Xamarin.Mac | xamarinmac |
| Xamarin.TVOS | xamarintvos |
| Xamarin.WatchOS | xamarinwatchos |
-
.NETStandard 2.0
- Microsoft.Extensions.Logging.Abstractions (>= 7.0.0)
- System.Memory (>= 4.5.5)
-
net6.0
- Microsoft.Extensions.Logging.Abstractions (>= 7.0.0)
- System.Memory (>= 4.5.5)
- System.Security.Cryptography.Algorithms (>= 4.3.1)
-
net7.0
- Microsoft.Extensions.Logging.Abstractions (>= 7.0.0)
- System.Memory (>= 4.5.5)
- System.Security.Cryptography.Algorithms (>= 4.3.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last updated |
|---|---|---|
| 3.0.0 | 0 | 3/24/2023 |
| 2.0.0 | 907 | 4/21/2022 |
| 1.4.0 | 309 | 4/5/2022 |
| 1.3.1 | 246 | 11/12/2021 |
| 1.3.0 | 338 | 10/8/2021 |
| 1.2.1 | 1,231 | 3/15/2021 |
| 1.2.0 | 264 | 3/14/2021 |
| 1.1.0 | 442 | 11/29/2020 |
| 1.0.0 | 2,028 | 10/26/2020 |
| 0.0.0-alpha.0.230 | 244 | 10/23/2020 |
| 0.0.0-alpha.0.229 | 161 | 10/22/2020 |
| 0.0.0-alpha.0.219 | 228 | 10/14/2020 |
| 0.0.0-alpha.0.184 | 174 | 10/12/2020 |
In this version (3.0.0):
========================
Breaking changes:
* Removed support for .Net Framework 4.6.1. Consider upgrading to 4.6.2 or later.
* Removed support for .Net Core 3.1. Consider upgrading to .Net 6.0 or later.
* Removed support for .Net 5.0. Consider upgrading to .Net 6.0 or later.
New features:
* Added support for .Net 7.0
* Added extension method for Maybe<T>:
* ToNullable<T>(this Maybe<T>)
* Added extension method for IEnumerable<T>:
* ToCollectionOfMaybe<T>(this IEnumerable<T>T)
* Added extension method for IEnumerable<Maybe<T>>:
* ToCollectionOfNullable<T>(this IEnumerable>Maybe<T>>)
* Added extension methods for Exception to support logging in exception filters:
* ShouldBeUnhandledLog(this Exception, Action<ILogger, Exception>, ILogger, TextWriter? inFallbackWriter = null)
* ShouldBeHandledLog(this Exception, Action<ILogger, Exception>, ILogger, TextWriter? inFallbackWriter = null)
* ShouldBeUnhandledLog(this Exception, Action<ILogger, T1, Exception>, ILogger, T1, TextWriter? inFallbackWriter = null)
* ShouldBeHandledLog(this Exception, Action<ILogger, T1, Exception>, ILogger, T1, TextWriter? inFallbackWriter = null)
* ShouldBeUnhandledLog(this Exception, Action<ILogger, T1, T2, Exception>, ILogger, T1, T2, TextWriter? inFallbackWriter = null)
* ShouldBeHandledLog(this Exception, Action<ILogger, T1, T2, Exception>, ILogger, T1, T2, TextWriter? inFallbackWriter = null)
* ShouldBeUnhandledLog(this Exception, Action<ILogger, T1, T2, T3, Exception>, ILogger, T1, T2, T3, TextWriter? inFallbackWriter = null)
* ShouldBeHandledLog(this Exception, Action<ILogger, T1, T2, T3, Exception>, ILogger, T1, T2, T3, TextWriter? inFallbackWriter = null)
* ShouldBeUnhandledLog(this Exception, Action<ILogger, T1, T2, T3, T4, Exception>, ILogger, T1, T2, T3, T4, TextWriter? inFallbackWriter = null)
* ShouldBeHandledLog(this Exception, Action<ILogger, T1, T2, T3, T4, Exception>, ILogger, T1, T2, T3, T4, TextWriter? inFallbackWriter = null)
* ShouldBeUnhandledLog(this Exception, Action<ILogger, T1, T2, T3, T4, T5, Exception>, ILogger, T1, T2, T3, T4, T5, TextWriter? inFallbackWriter = null)
* ShouldBeHandledLog(this Exception, Action<ILogger, T1, T2, T3, T4, T5, Exception>, ILogger, T1, T2, T3, T4, T5, TextWriter? inFallbackWriter = null)
* ShouldBeUnhandledLog(this Exception, Action<ILogger, T1, T2, T3, T4, T5, T6, Exception>, ILogger, T1, T2, T3, T4, T5, T6, TextWriter? inFallbackWriter = null)
* ShouldBeHandledLog(this Exception, Action<ILogger, T1, T2, T3, T4, T5, T6, Exception>, ILogger, T1, T2, T3, T4, T5, T6, TextWriter? inFallbackWriter = null)
* Added extension methods for ILogger to support logging in exception filters:
* LogsThenRethrow(this ILogger, Exception, Action<ILogger, Exception>, TextWriter? inFallbackWriter = null)
* LogsThenHandle(this ILogger, Exception, Action<ILogger, Exception>, TextWriter? inFallbackWriter = null)
* LogsThenRethrow(this ILogger, Exception, Action<ILogger, T1, Exception>, T1, TextWriter? inFallbackWriter = null)
* LogsThenHandle(this ILogger, Exception, Action<ILogger, T1, Exception>, T1, TextWriter? inFallbackWriter = null)
* LogsThenRethrow(this ILogger, Exception, Action<ILogger, T1, T2, Exception>, T1, T2, TextWriter? inFallbackWriter = null)
* LogsThenHandle(this ILogger, Exception, Action<ILogger, T1, T2, Exception>, T1, T2, TextWriter? inFallbackWriter = null)
* LogsThenRethrow(this ILogger, Exception, Action<ILogger, T1, T2, T3, Exception>, T1, T2, T3, TextWriter? inFallbackWriter = null)
* LogsThenHandle(this ILogger, Exception, Action<ILogger, T1, T2, T3, Exception>, T1, T2, T3, TextWriter? inFallbackWriter = null)
* LogsThenRethrow(this ILogger, Exception, Action<ILogger, T1, T2, T3, T4, Exception>, T1, T2, T3, T4, TextWriter? inFallbackWriter = null)
* LogsThenHandle(this ILogger, Exception, Action<ILogger, T1, T2, T3, T4, Exception>, T1, T2, T3, T4, TextWriter? inFallbackWriter = null)
* LogsThenRethrow(this ILogger, Exception, Action<ILogger, T1, T2, T3, T4, T5, Exception>, T1, T2, T3, T4, T5, TextWriter? inFallbackWriter = null)
* LogsThenHandle(this ILogger, Exception, Action<ILogger, T1, T2, T3, T4, T5, Exception>, T1, T2, T3, T4, T5, TextWriter? inFallbackWriter = null)
* LogsThenRethrow(this ILogger, Exception, Action<ILogger, T1, T2, T3, T4, T5, T6, Exception>, T1, T2, T3, T4, T5, T6, TextWriter? inFallbackWriter = null)
* LogsThenHandle(this ILogger, Exception, Action<ILogger, T1, T2, T3, T4, T5, T6, Exception>, T1, T2, T3, T4, T5, T6, TextWriter? inFallbackWriter = null)
Bug fixes:
* For an empty Maybe<T>, where T was a value type, the method TryGetValue(out T)
would incorrectly return true and populate the out value with default(T).
Fuller history of changes at https://existential.ggreig.com/articles/version_history.html