ZeroAlloc.Specification 1.1.0

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. 
dotnet add package ZeroAlloc.Specification --version 1.1.0
                    


                    

                
NuGet\Install-Package ZeroAlloc.Specification -Version 1.1.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="ZeroAlloc.Specification" Version="1.1.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="ZeroAlloc.Specification" Version="1.1.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="ZeroAlloc.Specification" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add ZeroAlloc.Specification --version 1.1.0
                    


                    

                
#r "nuget: ZeroAlloc.Specification, 1.1.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package ZeroAlloc.Specification@1.1.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=ZeroAlloc.Specification&version=1.1.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=ZeroAlloc.Specification&version=1.1.0
                    


                            Install as a Cake Tool

ZeroAlloc.Specification

NuGet Build License: MIT AOT GitHub Sponsors

Source-generated, zero-allocation specification pattern for .NET 8+.

Multiple packages in this family — see Documentation or NuGet for the full list.

Install

The source generator is bundled into the main package — a single PackageReference is all you need:

dotnet add package ZeroAlloc.Specification

The standalone ZeroAlloc.Specification.Generator package is still published for backwards compatibility with existing direct PackageReferences, but new consumers should reference only ZeroAlloc.Specification.

Example

[Specification]
public readonly partial struct ActiveUserSpec : ISpecification<User>
{
    public bool IsSatisfiedBy(User user) => user.IsActive;
    public Expression<Func<User, bool>> ToExpression() => u => u.IsActive;
}

[Specification]
public readonly partial struct PremiumUserSpec : ISpecification<User>
{
    private readonly decimal _minSpend;
    public PremiumUserSpec(decimal minSpend) => _minSpend = minSpend;

    public bool IsSatisfiedBy(User user) => user.TotalSpend >= _minSpend;
    public Expression<Func<User, bool>> ToExpression()
    {
        var min = _minSpend;
        return u => u.TotalSpend >= min;
    }
}

// Fluent composition — zero allocation
var spec = new ActiveUserSpec().And(new PremiumUserSpec(1000m));

// In-memory
bool result = spec.IsSatisfiedBy(user);

// EF Core — translates to SQL
var users = await dbContext.Users.Where(spec.ToExpression()).ToListAsync();

Features

  • Zero allocations — composed specs are readonly struct values, not heap objects
  • EF Core compatible — every spec exposes ToExpression() returning Expression<Func<T, bool>>
  • Source-generated fluent API — And<TOther>(), Or<TOther>(), Not() added by Roslyn generator
  • Static builder — Spec.And(), Spec.Or(), Spec.Not() for explicit type arguments
  • Compile-time safety — ZA001–ZA004 diagnostics enforce correct partial struct usage
  • .NET 8+, C# 12

Documentation

Page Description
Introduction What it is and why it exists
Getting Started Install and first specification in 5 minutes
Core Concepts ISpecification<T>, structs, stateful vs stateless
Fluent API Generated And/Or/Not methods
Static Builder Spec.And/Or/Not
Expression Composition ToExpression() and EF Core translation
Diagnostics ZA001–ZA004 compile-time errors and fixes
Generator Internals How the Roslyn generator works
Performance Allocation comparison and benchmarks
Cookbook: EF Core Repository Repository pattern integration
Cookbook: Combining Specs Complex compositions
Cookbook: Stateless Caching Cache expression trees for stateless specs

License

MIT — see LICENSE.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

  • net8.0

    • No dependencies.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on ZeroAlloc.Specification:

Package Downloads
Rag.NET.Abstractions

Interfaces and models for the Rag.NET library
Rag.NET

Modular RAG pipeline library for .NET — ingestion and retrieval pipeline builders, self-query, corrective RAG and conversation memory

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.1.0 581 5/4/2026
0.1.0 129 3/18/2026