Atya.Foundation.Guards 1.0.2

Atya.Foundation.Guards

Lightweight guard clauses for validating arguments and protecting invariants in modern .NET code.

📖 Overview

Atya.Foundation.Guards provides a compact set of guard clauses for validating method arguments, constructor parameters, and low-level invariants. It helps fail fast with standard .NET exceptions while preserving the original argument name through caller argument expressions. The package is intended for foundation libraries and application code that need clear validation without a large dependency surface.

✨ Features

• Null validation — validate reference types and nullable value types with ArgumentNullException.
• String guards — reject null, empty, and whitespace-only strings.
• Collection guards — validate read-only collections and enumerables without unnecessary enumeration when counts are available.
• Numeric guards — enforce inclusive ranges, non-negative values, and values greater than zero.
• Invariant-friendly API — return the validated value so guards can be used directly in assignments.

📦 Installation

.NET CLI

dotnet add package Atya.Foundation.Guards

Package Manager

Install-Package Atya.Foundation.Guards

PackageReference

<PackageReference Include="Atya.Foundation.Guards" Version="1.0.0" />

🚀 Quick Start

using Atya.Foundation.Guards;
using System;

string customerName = Guard.AgainstNullOrWhiteSpace("Ada Lovelace");
int quantity = Guard.AgainstZeroOrNegative(25);
Guid customerId = Guard.AgainstEmpty(Guid.NewGuid());

Console.WriteLine($"{customerName}: {customerId} ({quantity})");

📚 Usage

Validate Constructor Input

using Atya.Foundation.Guards;
using System;

public sealed class OrderRequest(Guid customerId, string customerName, int quantity)
{
    public Guid CustomerId { get; } = Guard.AgainstEmpty(customerId);

    public string CustomerName { get; } = Guard.AgainstNullOrWhiteSpace(customerName);

    public int Quantity { get; } = Guard.AgainstZeroOrNegative(quantity);
}

Validate Ranges

using Atya.Foundation.Guards;

int retryCount = Guard.AgainstOutOfRange(3, minimum: 1, maximum: 10);
decimal discount = Guard.AgainstNegative(0.15m);

Validate Collections

using Atya.Foundation.Guards;
using System;
using System.Collections.Generic;
using System.Linq;

IReadOnlyCollection<Guid> candidateItemIds = new List<Guid> { Guid.NewGuid(), Guid.NewGuid() };
IReadOnlyCollection<Guid> itemIds = Guard.AgainstNullOrEmpty(candidateItemIds);

IEnumerable<int> candidatePageNumbers = Enumerable.Range(1, 3);
IEnumerable<int> pageNumbers = Guard.AgainstNullOrEmpty(candidatePageNumbers);

🧩 API Overview

🗂️ Project Structure

📦 Guards
├── 📂 src
│   └── 📄 Guards.csproj                  # the published package
├── 🧪 tests
│   └── 📄 Guards.UnitTests.csproj
├── 🎯 samples
│   └── 📄 Guards.Samples.Console.csproj
├── ⚡ benchmarks
│   └── 📄 Guards.Benchmarks.csproj
├── ⚙️ .github/workflows
│   └── 📄 ci.yml
├── 📄 Guards.sln
├── 📄 README.md
└── 📄 LICENSE

🎯 Compatibility

Targets net10.0. The package is platform-neutral and uses standard .NET exception types.

🧪 Testing

dotnet test

⚡ Benchmarks

Benchmarks are available under benchmarks/Guards.Benchmarks and can be run in Release configuration.

dotnet run --project benchmarks/Guards.Benchmarks/Guards.Benchmarks.csproj --configuration Release

🤝 Contributing

Contributions are welcome! Please open an issue or pull request on GitHub.

📄 License

Released under the MIT license. See LICENSE for details.

🏛️ About Atya Libraries

Atya.Foundation.Guards is part of Atya Libraries — a family of focused, modern .NET libraries published under the reserved Atya.* prefix on NuGet. Every package shares the same principles: a small, clear public API, full test coverage, and consistent documentation.

🔎 Browse the full collection on GitHub and NuGet.

Made with 💜 .NET · © 2026 Atya Libraries