Skip to content
A simple package with guard clause extensions.
C#
Branch: master
Clone or download

Latest commit

imgbot and ImgBotApp [ImgBot] Optimize images (#68)
*Total -- 288.09kb -> 183.73kb (36.23%)

/media/72.png -- 9.07kb -> 3.38kb (62.67%)
/media/96.png -- 11.48kb -> 4.69kb (59.15%)
/media/144.png -- 17.09kb -> 8.55kb (49.97%)
/media/256.png -- 30.47kb -> 16.97kb (44.3%)
/media/512.png -- 61.72kb -> 37.74kb (38.85%)
/media/logotype 1024.png -- 68.48kb -> 42.81kb (37.47%)
/icon_1280.png -- 73.79kb -> 55.23kb (25.15%)
/media/48.svg -- 2.52kb -> 2.24kb (10.94%)
/media/72.svg -- 2.58kb -> 2.31kb (10.67%)
/media/96.svg -- 2.62kb -> 2.34kb (10.51%)
/media/144.svg -- 2.65kb -> 2.38kb (10.45%)
/media/256.svg -- 2.74kb -> 2.46kb (10.2%)
/media/512.svg -- 2.90kb -> 2.63kb (9.48%)

Signed-off-by: ImgBotApp <ImgBotHelp@gmail.com>

Co-authored-by: ImgBotApp <ImgBotHelp@gmail.com>
Latest commit 79efa20 May 26, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Create FUNDING.yml Apr 23, 2020
.vscode Adding vscode folder Jan 3, 2020
media [ImgBot] Optimize images (#68) May 26, 2020
src Update GuardClauses.csproj Apr 29, 2020
.gitignore Initial commit Sep 12, 2017
LICENSE Initial commit Sep 12, 2017
README.md Guard and return in single statement (#63) Apr 29, 2020
azure-pipelines.yml Updating copy files task Jul 17, 2019
icon_1280.png [ImgBot] Optimize images (#68) May 26, 2020
nuget.txt Update nuget.txt Jan 3, 2020

README.md

NuGetNuGet Build Status Azure DevOps coverage

Guard Clauses

A simple package with guard clause extensions.

Give a Star!

If you like or are using this project please give it a star. Thanks!

Usage

    public void ProcessOrder(Order order)
    {
    	Guard.Against.Null(order, nameof(order));

        // process order here
    }

    // OR

    public class Order
    {
        private string _name;
        private int _quantity;
        private long _max;
        private decimal _unitPrice;
        private DateTime _dateCreated;

        public Order(string name, int quantity, long max, decimal unitPrice, DateTime dateCreated)
        {
            _name = Guard.Against.NullOrWhiteSpace(name, nameof(name));
            _quantity = Guard.Against.NegativeOrZero(quantity, nameof(quantity));
            _max = Guard.Against.Zero(max, nameof(max));
            _unitPrice = Guard.Against.Negative(unitPrice, nameof(unitPrice));
            _dateCreated = Guard.Against.OutOfSQLDateRange(dateCreated, nameof(dateCreated));
        }
    }

Supported Guard Clauses

  • Guard.Against.Null (throws if input is null)
  • Guard.Against.NullOrEmpty (throws if string or array input is null or empty)
  • Guard.Against.NullOrWhiteSpace (throws if string input is null, empty or whitespace)
  • Guard.Against.OutOfRange (throws if integer/DateTime/enum input is outside a provided range)
  • Guard.Against.OutOfSQLDateRange (throws if DateTime input is outside the valid range of SQL Server DateTime values)
  • Guard.Against.Zero (throws if number input is zero)

Extending with your own Guard Clauses

To extend your own guards, you can do the following:

    // Using the same namespace will make sure your code picks up your 
    // extensions no matter where they are in your codebase.
    namespace Ardalis.GuardClauses
    {
        public static class FooGuard
        {
            public static void Foo(this IGuardClause guardClause, string input, string parameterName)
            {
                if (input?.ToLower() == "foo")
                    throw new ArgumentException("Should not have been foo!", parameterName);
            }
        }
    }

    // Usage
    public void SomeMethod(string something)
    {
        Guard.Against.Foo(something, nameof(something));
    }

References

Build Notes

  • Remember to update the PackageVersion in the csproj file and then a build on master should automatically publish the new package to nuget.org.
  • Add a release with form 1.3.2 to GitHub Releases in order for the package to actually be published to Nuget. Otherwise it will claim to have been successful but is lying to you.
You can’t perform that action at this time.