devlooped/moq
Moq
Moq is a .NET mocking framework and C# library used to create simulated objects and interfaces. Its primary purpose is to isolate code from external dependencies during unit testing by providing a system for interface simulation and behavioral testing.
The framework distinguishes itself through the use of functional specification queries and LINQ-based querying to create declarative mocks. It supports the simulation of complex scenarios, including the automatic generation of recursive mock hierarchies, the implementation of multiple interfaces within a single mock instance, and the ability to mock protected virtual members.
The library covers broad capability areas including behavioral verification to confirm method invocation frequency and call sequences, and method behavior configuration for defining return values, exceptions, and parameter modifiers. It also provides tools for event simulation and the control of mock strictness to determine how unconfigured members respond.
Features
- .NET Testing Ecosystem - Provides a comprehensive mocking framework for isolating dependencies within the .NET runtime environment.
- Dynamic Mock Objects - Generates runtime proxy objects to simulate interfaces and classes, isolating the system from external dependencies.
- Return Value Configurations - Provides capabilities to define return values and exceptions for simulated methods, including support for asynchronous tasks.
- Expression-Based Mock Setup - Uses functional expressions and LINQ to declaratively find or create simulated objects with specific behaviors.
- Behavior Verification - Validates that specific methods were called with the correct arguments and in the expected order.
- Behavioral Verification Tools - Verifies that specific method invocations and event triggers occur in a precise, predefined order.
- C# Mocking Libraries - Provides a comprehensive toolset for defining method behaviors and call expectations within C# test suites.
- Method Invocation Verifications - Confirms that specific methods were called a certain number of times or not at all.
- Dependency Mocking - Simulates external system behavior by substituting real components with controlled mock implementations.
- Mock Proxy Generation - Creates simulated object implementations at runtime by generating a proxy class that intercepts calls to virtual members.
- Accessor Stubbing - Provides control over property getter return values and verification of setter invocations.
- Multiple Interface Implementations - Enables a single mock instance to implement and provide behavior for several different interfaces simultaneously.
- Setup Expression Trees - Uses expression trees to extract method signatures and argument constraints for behavioral setup.
- Multi-Interface Mock Generators - Generates mock implementations of multiple interfaces with customizable return values and exceptions.
- Argument Constraint Matchers - Evaluates method arguments against constants or custom predicates to trigger specific simulated behaviors.
- Mock Argument Matchers - Filters method calls using constants, regular expressions, or custom predicates to trigger specific setups.
- Mock Default Behavior Configurations - Allows configuring fallback responses or exceptions for unexpected method calls to enforce strict behavior.
- Mock Event Triggering - Allows manually or automatically firing events on a mock object to simulate notifications.
- Method Argument & Return Manipulation - Executes custom logic before or after a mocked method returns to capture arguments or modify state.
- Mock Call Order Verifications - Verifies that mock method invocations occur in a predefined sequence across one or more mock objects.
- Event-Driven Testing Frameworks - Simulates asynchronous event triggers and custom data payloads to verify event-based logic.
- Call-Stack Interceptors - Captures method invocations and arguments to verify call counts and sequence order against predefined expectations.
- Declarative Mock Specifications - Supports building stubbed objects and hierarchies using functional specification queries instead of manual setup.
- Recursive Mock Generation - Automatically instantiates new mock objects when a member return value is another mockable type.
- Protected Method Mocks - Enables defining behaviors and expectations for protected virtual members using identifiers or proxies.
- Test-Frameworks - Popular library for mocking interfaces and classes in tests.
