FluentSharp 1.0.0

FluentSharp for .Net Standard 2.0

FluentSharp is a simple set of extension methods that will helps you creating code in a fluent style way. Minimizing the amount of code lines written for common behaviors.

FluentSharp has the intention of remain small, not trying to solve every possible need or re invent already existing functionality and extensions. It will keep it simple!

Conditionals

It is common in coding to use conditions to derive the code execution. Most of these implementations are usually to validate input function parameters or executing one line after the condition is evaluated.

if (myVariable == 10) {
    DoSomething();
}

The previous is a common scenario in which, after a validation, a function (Or another line of code) is executed. Even though is easy to read, a fluent writing (And reading) could help describing our code better.

(myVariable == 10)
    .IfTrue()
    .Then(() => DoSomething());

IfTrue function

Validates if the result of the boolean expression is true and returns a concrete Operations object.

The following operations will have effect only if IfTrue evaluates as true.

true.IfTrue()...;

From an expression

object obj = null;

(obj == null).IfTrue()...;

For any other boolean expression

(10 < 20).IfTrue()...;

IfFalse function

Validates if the result of the boolean expression is false and returns a concrete Operations object.

The following operations will have effect only if IfFalse evaluates as false.

false.IfFalse()...;

From an expression

object obj = null;

(obj != null).IfFalse()...;

For any other boolean expression

(10 > 20).IfFalse()...;

IfNull function

Validates if the object is null and returns a concrete Operations object.

The following operations will have effect only if IfNull evaluates as true.

null.IfNull()...;

From an expression

object obj = null;

obj.IfNull()...;

Exceptions

Propagating malformed data across our code usually requires validations to be propagated too. In particular, input function parameters that are required by the subsequent code, can be reason enough to stop the code execution and fails with a controlled exception.

Throw function

Throw will throw the defined instance exception if IfNull(), IfFalse() or IfTrue() validates as expected.

[true|false|null].[IfFalse|IfTrue|IfNull].Throw(new Exception());

From an expression

public void ValidateUser(User user) 
{
    user.IfNull().Throw(new ArgumentNullException("User cannot be null"));
}

For any other boolean expression

(10 > 20).IfFalse().Throw(new Exception());

Iterators

Operations