Ninjanaut.Preconditions 1.1.0

Welcome to the Preconditions project website! Preconditions is simple and lightweight C# library to ease arguments checks.

Installation

from nuget package manager console

PM> Install-Package Ninjanaut.Preconditions

from command line

> dotnet add package Ninjanaut.Preconditions

Usage

using Ninjanaut.Preconditions;

// any parameter
Check.NotNull(parameter);
Check.NotNull(parameter, nameof(parameter));
Check.NotNull(parameter, nameof(parameter), "Parameter cannot be null.");

// string parameter or List<object> parameter
Check.NotNullOrEmpty(parameter);
Check.NotNullOrEmpty(parameter, nameof(parameter));
Check.NotNullOrEmpty(parameter, nameof(parameter), "Parameter cannot be null or empty.");

// any custom check
Check.Require(x > 0);
Check.Require(x > 0, "Parameter x has to be greater than zero!");
Check.Require(x > 0, "Parameter x has to be greater than zero!", nameof(x));

// It's also possible to assign the value directly from the checks.
var foo = Check.NotNull(parameter);
string bar = Check.NotNullOrEmpty(parameter);
List<object> foobars = Check.NotNullOrEmpty(parameter);

Adding your custom checks

C# does not allow to create an extension method to static class or to create partial class across assemblies. Therefore you can create your own static class as in the following example

public static class MyCheck
{
	public static void NotZero(int number, string message = null, string paramName = null)
    {
        if (number == 0)
        {
            throw new ArgumentException(message, paramName);
        }
    }
}

and use it together with other checks

MyCheck.NotZero(parameter);
Check.NotNull(parameter);

Release notes

Contribution

If you would like to contribute to the project, please send a pull request to the dev branch.