Guard

Install

dotnet add package NuvyntraLabs.NET.Guard

Package ID: NuvyntraLabs.NET.Guard

NuvyntraLabs.NET.* is a class library, not a Plugin.Maui.* package. The install command applies after 0.1.1 is published. Until then, reference the project in the hub submodule.

Example

object request = Guard.NotNull(request);
string name = Guard.NotEmpty(name);
decimal amount = Guard.Positive(amount);
int age = Guard.InRange(age, 18, 100);

Overview

NuvyntraLabs.NET.Guard is for a public method that should reject null, empty, non-positive, or out-of-range input and then use the same value. CallerArgumentExpression names the argument. Prefer ArgumentNullException.ThrowIfNull, then Ardalis.GuardClauses, when those already match the host. There is no custom exception type and no GuardAgainst vocabulary.

Capabilities

• NotNull throws ArgumentNullException and returns the reference.
• NotEmpty throws ArgumentException for null, empty, or whitespace.
• Positive throws ArgumentOutOfRangeException when the number is not greater than zero.
• InRange throws ArgumentOutOfRangeException when the value is outside the inclusive bounds.
• No package dependencies. Nullable, trim, and Native AOT compatible. Plugins do not reference it.

Related in Shared libraries

• NuvyntraLabs.NET.DataMaskMask a phone, PAN, card, or connection string before it is logged
• NuvyntraLabs.NET.TimeKitBusiness days, month and quarter bounds, Unix time, and IANA zones
• NuvyntraLabs.NET.IdentifiersPAN format, GSTIN checksum, Aadhaar Verhoeff, and IBAN mod-97