Skip to content

Latest commit

 

History

History
75 lines (49 loc) · 2.24 KB

README.md

File metadata and controls

75 lines (49 loc) · 2.24 KB

ByteDecoder.Common

.NET Core Maintainability Test Coverage CodeQL License

Common utility classes, guard clauses, and more.

Targeted to .Net6 onwards

Installation

Install the ByteDecoder.Common NuGet Package.

Package Manager Console

Install-Package ByteDecoder.Common

.NET Core CLI

dotnet add package ByteDecoder.Common

Documentation

All the documentation can be found on the github page.

Examples and usage

Guard Clauses

They are a piece of code in charge of protecting params at the top of methods against undesirable values.

Supported Guard Clauses:

  • IfArgumentIsNull
  • IfArgumentIsNullOrEmpty
  • IfArgumentOutOfRange

Usage examples:

using ByteDecoder.Common.GuardClauses;

// Null Argument Guard check
public void MethodOne(IEnumerable<string> collection)
{
  Guard.Break.IfArgumentIsNull(collection, nameof(collection));

  // More logic code if the param is suitable after the guard evaluates the condition.
}

// String is NUll or Empty Guard check
public void MethodTwo(string word)
{
  Guard.Break.IfArgumentIsNull(word, nameof(word));

  // More logic code if the param is suitable after the guard evaluates the condition.
}

// Calling the method and passing a null value in the param
MethodOne((IEnumerable<string>) null);  // This will throw an ArgumentNullException
MethodTwo(string.Empty);  // This will throw an ArgumentNullException

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/ByteDecoder/ByteDecoder.Common.

Copyright (c) 2020 Rodrigo Reyes released under the MIT license