README.md

Mocking library with the perfect balance of Performance and Intuitive API

🧘Balanced Performance and Developer Experience

Imposter delivers top-tier performance without sacrificing a natural, intuitive API. While being ~10× faster than NSubstitute and up to ~50× faster than Moq in common mocking scenarios, Imposter is not the fastest mocking library available. Instead, it focuses on achieving a balance between performance and API ease of use.

🚀 Quick Start

Add nuget package reference:

dotnet add package Imposter

Pick a target

namespace Application.Domain;

public interface ICalculator
{
    int Add(int a, int b);
}

Use [GenerateImposter] attribute in your tests project, this will generate an imposter

[assembly: GenerateImposter(typeof(Application.Domain.ICalculator))]

Use the generated imposter

using System.Threading.Tasks;
using Imposter.Abstractions;

// c# 14
var imposter = ICalculator.Imposter();

// c# 9 - 13
// var imposter = new ICalculatorImposter();

imposter.Add(Arg<int>.Any(), Arg<int>.Any())
    .Returns(1)
    .Then()
    .Returns(2);

var calculator = imposter.Instance();

calculator.Add(1, 2); // 1
calculator.Add(1, 2); // 2

🛡️ Strongly typed all the way

Loosely typed callbacks can easily cause runtime exceptions. Imposter enforces strong typing across the entire mocking pipeline, eliminating type mismatch errors for good. See more here

🎭 Interfaces and classes

Not limited to interfaces — Imposter can impersonate non-sealed classes and their protected members. See more here

🧬 Full generic support

Generics are fully supported. see more here

🧩 Mock any member

Imposter supports not only methods, but also properties, events and indexers.

🔀 Implicit and Explicit Modes

Choose how unmocked members behave. Implicit mode returns defaults silently — great for prototyping. Explicit mode throws on any call without a setup — ideal for unit tests that must be precise. See more here

🧵 Thread-safe by design

Imposter is built to work reliably in multi-threaded and parallel test environments.

⏱️ Benchmark

Square method is setup to return input * input and ran it for 1, 10, 100, and 1000 iterations. see benchmarks for more details

public interface ICalculator
{
    int Square(int input);
}

Benchmark Environment

BenchmarkDotNet v0.15.6, Windows 11 (10.0.26200.6899)
13th Gen Intel Core i9-13900HX 2.20GHz, 1 CPU, 32 logical and 24 physical cores
.NET SDK 10.0.100
[Host]     : .NET 8.0.21 (8.0.21, 8.0.2125.47513), X64 RyuJIT x86-64-v3
DefaultJob : .NET 8.0.21 (8.0.21, 8.0.2125.47513), X64 RyuJIT x86-64-v3

BenchmarkDotNet v0.15.6, macOS Sequoia 15.7.3 (24G419) [Darwin 24.6.0]
Apple M2 Pro, 1 CPU, 10 logical and 10 physical cores
.NET SDK 10.0.101
[Host]     : .NET 10.0.1 (10.0.1, 10.0.125.57005), Arm64 RyuJIT armv8.0-a
DefaultJob : .NET 10.0.1 (10.0.1, 10.0.125.57005), Arm64 RyuJIT armv8.0-a

✨ Feature-Rich

• Method Impersonation
• Property Impersonation
• Indexer Impersonation
• Event Impersonation
• Class Impersonation
• Generics
• Implicit & Explicit Modes
• Use Base implementation
• Async Support
• Protected members Impersonation

Docs

• See Docs

📜 MIT License

Free to use, modify, and distribute under the MIT License.