Menso.Tools.Exceptions 1.1.0

dotnet add package Menso.Tools.Exceptions --version 1.1.0                
NuGet\Install-Package Menso.Tools.Exceptions -Version 1.1.0                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Menso.Tools.Exceptions" Version="1.1.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Menso.Tools.Exceptions --version 1.1.0                
#r "nuget: Menso.Tools.Exceptions, 1.1.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Menso.Tools.Exceptions as a Cake Addin
#addin nuget:?package=Menso.Tools.Exceptions&version=1.1.0

// Install Menso.Tools.Exceptions as a Cake Tool
#tool nuget:?package=Menso.Tools.Exceptions&version=1.1.0                

Tools.Exceptions

Helps avoid code complexity and improves readability

Quick Installation Guide

Install Package


dotnet add package Menso.Tools.Exceptions

Configuration (Optional)

public void ConfigureExceptionLaucher(this IServiceCollection services)
{
    ExceptionSettings.CreateExceptionHandler = exceptionInformation =>
    {
        // Create your own exception and return it
        
        // sample
        var message = exceptionInformation.CustomMessage ?? exceptionInformation.DefaultMessage;
        var paramName = exceptionInformation.ParamName;
        return new ArgumentException(message, paramName, exceptionInformation.InnerException);
    };
}
public void ConfigureExceptionLaucher(this IServiceCollection services)
{
    ExceptionSettings.CreateHttpExceptionHandler = (statusCode, exceptionInformation) =>
    {
        // Create your own exception and return it
        
        // sample
        var message = exceptionInformation.CustomMessage ?? $"{errorStatusCode}: {exceptionInformation.DefaultMessage}";
        return new HttpRequestException(message, exceptionInformation.InnerException, errorStatusCode);
    };
}

Usage

Use cases:

public void Sample()
{
    object? argument = null;
    var message = "sample message";
    var innerException = new Exception("Inner exception");
    
    Throw.When.Null(argument);
    Throw.When.Null(argument, message);
    Throw.When.Null(argument, message, innerException);
              
    Throw<CustomException>.When.Null(argument);
    Throw<CustomException>.When.Null(argument, message);
    Throw<CustomException>.When.Null(argument, message, innerException);    
}
public void Sample_WithHttpException()
{
    object? argument = null;
    var message = "sample message";
    var innerException = new Exception("Inner exception");
    
    Throw.Http.BadRequest.When.Null(argument);
    Throw.Http.BadRequest.When.Null(argument, message);
    Throw.Http.BadRequest.When.Null(argument, message, innerException); 
}

We are open to suggestions and collaborations

Product Compatible and additional computed target framework versions.
.NET net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net7.0

    • No dependencies.
  • net8.0

    • No dependencies.

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
1.1.0 3,497 8/6/2024
1.0.0 6,993 11/30/2023
0.0.3.6 1,590 10/31/2023
0.0.3.5 6,927 8/3/2023
0.0.3.4 146 8/3/2023
0.0.3.3 269 7/31/2023
0.0.3.2 340 7/27/2023
0.0.3.1 155 7/18/2023
0.0.3 150 7/17/2023
0.0.2.1 156 7/11/2023
0.0.2 140 7/10/2023
0.0.1 165 7/7/2023