ValueGuardian - Simplify Property Validation in C# Overview: ConditionCheck is a lightweight C# library designed to simplify property validation in your applications. It provides easy-to-use methods to check for null or empty values in various scenarios, helping you ensure the integrity of your data. Key Features: Logical OR and AND checks for mixed types. Validate strings, collections, and model objects effortlessly. Identify empty or null properties in model objects. Easy integration into existing projects. Usage: Use IsEmptyOrNullUseOr for logical OR checks. Use IsEmptyOrNullUseAnd for logical AND checks. Utilize CheckModelProperties to identify empty or null properties in model objects. Example: // Logical OR check bool result = Checks.IsEmptyOrNullUseOr("Hello", null, "World"); Console.WriteLine($"Result: {result}"); Requirements: Compatible with .NET Standard 2.0 and above. Support: Contact Me On: anasnafees1802@gmil.com BY : Anas Nafees Version History: v1.0.0: Initial release v1.0.3: Added Nested/Complex Models Empty or Null Check
Get Started
$ dotnet add package ValueGuardianReadme
ValueGuardian NuGet Package
Overview
ValueGuardian is a .NET library designed to provide robust value guarding functionalities for ensuring the integrity of data and preventing unexpected behaviors due to invalid or unexpected values.
Features
- Logical OR Operation: Check if any of the specified values meet certain conditions.
- Logical AND Operation: Check if all of the specified values meet certain conditions.
- Model Object Property Guard: Identify and guard against invalid or unexpected values in a given model object.
Installation
You can install the ValueGuardian NuGet package using the following Package Manager Console command:
Install-Package ValueGuardian
How To Use
using ValueGuardian;
class Program
{
static void Main(string[] args)
{
// Test case 1: Logical OR with mixed types
bool result1 = Checks.IsEmptyOrNullUseOr("Hello", null, "World");
Console.WriteLine($"Test 1 Result (OR): {result1}");
// Test case 2: Logical OR with mixed types
bool result2 = Checks.IsEmptyOrNullUseOr("Hello", "Test", "World");
Console.WriteLine($"Test 2 Result (OR): {result2}");
// Test case 3: Logical OR with all null values
bool result3 = Checks.IsEmptyOrNullUseOr(null, null, null);
Console.WriteLine($"Test 3 Result (OR): {result3}");
// Test case 4: Logical OR with null values in a model object
var person1 = new Person { Name = null, Age = 0 };
bool result4 = Checks.IsEmptyOrNullUseOr(null, null, person1);
Console.WriteLine($"Test 4 Result (OR): {result4}");
// Test case 5: Logical OR with model objects and a collection
var person2 = new Person { Name = "John", Age = 25 };
var test1 = new Test { Name = "Alice", Age = 30, Gender = "", UserId = 123 };
bool result5 = Checks.IsEmptyOrNullUseOr(person2, person2, person2);
Console.WriteLine($"Test 5 Result (OR): {result5}");
// Test case 6: Logical OR with model objects
bool result6 = Checks.IsEmptyOrNullUseOr(person2, test1, person2);
Console.WriteLine($"Test 6 Result (OR): {result6}");
// Test case 7: Logical OR with a collection
var list = new List<Test> { test1 };
bool result7 = Checks.IsEmptyOrNullUseOr(list);
Console.WriteLine($"Test 7 Result (OR): {result7}");
// Test case 8: Logical OR with a single model object
var test2 = new Test { Name = "Bob", Age = 40, Gender = "Male", UserId = 456 };
bool result8 = Checks.IsEmptyOrNullUseOr(test2);
Console.WriteLine($"Test 8 Result (OR): {result8}");
// Test case 9: Logical AND with mixed types
bool result9 = Checks.IsEmptyOrNullUseAnd("Hello", null, "World");
Console.WriteLine($"Test 9 Result (AND): {result9}");
// Test case 10: Logical AND with mixed types
bool result10 = Checks.IsEmptyOrNullUseAnd("Hello", "Test", "World");
Console.WriteLine($"Test 10 Result (AND): {result10}");
// Test case 11: Logical AND with all null values
bool result11 = Checks.IsEmptyOrNullUseAnd(null, null, null);
Console.WriteLine($"Test 11 Result (AND): {result11}");
// Test case 12: Logical AND with null values in a model object
bool result12 = Checks.IsEmptyOrNullUseAnd(null, null, person1);
Console.WriteLine($"Test 12 Result (AND): {result12}");
// Test case 13: Logical AND with model objects and a collection
bool result13 = Checks.IsEmptyOrNullUseAnd(person2, person2, person2);
Console.WriteLine($"Test 13 Result (AND): {result13}");
// Test case 14: Logical AND with model objects
bool result14 = Checks.IsEmptyOrNullUseAnd(person2, test1, person2);
Console.WriteLine($"Test 14 Result (AND): {result14}");
// Test case 15: Logical AND with a collection
bool result15 = Checks.IsEmptyOrNullUseAnd(list);
Console.WriteLine($"Test 15 Result (AND): {result15}");
// Test case 16: Logical AND with a single model object
bool result16 = Checks.IsEmptyOrNullUseAnd(test2);
Console.WriteLine($"Test 16 Result (AND): {result16}");
// Test case 17: Model with all properties having values
var person3 = new Person { Name = "John", Age = 25 };
var result17 = Checks.CheckModelProperties(person3);
Console.WriteLine($"Test 17 Result (CheckModelProperties): {result17}");
// Test case 18: Model with a null value in a property
var person4 = new Person { Name = null, Age = 30 };
var result18 = Checks.CheckModelProperties(person4);
Console.WriteLine($"Test 18 Result (CheckModelProperties): {result18}");
// Test case 19: Model with an empty string value in a property
var test3 = new Test { Name = "Alice", Age = 30, Gender = "", UserId = 123 };
var result19 = Checks.CheckModelProperties(test3);
Console.WriteLine($"Test 19 Result (CheckModelProperties): {result19}");
// Test case 20: Model with all properties having values
var test4 = new Test { Name = "Bob", Age = 40, Gender = "Male", UserId = 456 };
var result20 = Checks.CheckModelProperties(test4);
Console.WriteLine($"Test 20 Result (CheckModelProperties): {result20}");
// Test case 21: Complex Model with Nested Objects
var complexTest = new ComplexTest
{
Title = "Complex Example",
Details = new ComplexDetails
{
Description = "This is a complex test.",
Tags = new List<string> { "testing", "complex", "model" }
},
Priority = Priority.High,
IsActive = true
};
var result21 = Checks.CheckModelProperties(complexTest);
Console.WriteLine($"Test 21 Result (CheckModelProperties): {result21}");
// Test case 22: Complex Model with Nested Objects
var complexTest2 = new ComplexTest
{
Title = "Complex Example",
Details = new ComplexDetails
{
Description = null,
Tags = new List<string> { "testing", "complex", "model" }
},
Priority = Priority.High,
IsActive = true
};
var result22 = Checks.CheckModelProperties(complexTest2);
Console.WriteLine($"Test 22 Result (CheckModelProperties): {result22}");
// Test case 23: Complex Model with Nested Objects
var complexTest3 = new ComplexTest
{
Title = null,
Details = new ComplexDetails
{
Description = "",
Tags = new List<string> { "testing", "complex", "model" }
},
Priority = Priority.High,
IsActive = true
};
var result23 = Checks.CheckModelProperties(complexTest3);
Console.WriteLine($"Test 22 Result (CheckModelProperties): {result23}");
Console.ReadKey();
}
}
class Person
{
public string Name { get; set; }
public int Age { get; set; }
}
class Test
{
public string Name { get; set; }
public int Age { get; set; }
public string Gender { get; set; }
public int UserId { get; set; }
}
// Complex model classes
class ComplexTest
{
public string Title { get; set; }
public ComplexDetails Details { get; set; }
public Priority Priority { get; set; }
public bool IsActive { get; set; }
}
class ComplexDetails
{
public string Description { get; set; }
public List<string> Tags { get; set; }
}
enum Priority
{
Low,
Medium,
High
}
Results
Test 1 Result (OR): True
Test 2 Result (OR): False
Test 3 Result (OR): True
Test 4 Result (OR): True
Test 5 Result (OR): False
Test 6 Result (OR): False
Test 7 Result (OR): False
Test 8 Result (OR): False
Test 9 Result (AND): False
Test 10 Result (AND): False
Test 11 Result (AND): True
Test 12 Result (AND): False
Test 13 Result (AND): False
Test 14 Result (AND): False
Test 15 Result (AND): False
Test 16 Result (AND): False
Test 17 Result (CheckModelProperties): All properties have values.
Test 18 Result (CheckModelProperties): Empty or null properties: Name
Test 19 Result (CheckModelProperties): Empty or null properties: Gender
Test 20 Result (CheckModelProperties): All properties have values.
Test 21 Result (CheckModelProperties): All properties have values.
Test 22 Result (CheckModelProperties): Empty or null properties: Description
Test 22 Result (CheckModelProperties): Empty or null properties: Title, Description