uber-go/mock
Mock
This project is a framework for generating mock implementations of interfaces to isolate dependencies and verify method interactions during unit testing in Go. It provides tools to simulate external dependencies by creating controlled mock objects, allowing developers to test components in isolation without requiring real service connections.
The library distinguishes itself through its use of static interface reflection to generate type-safe mock structures during the build process. It features a fluent assertion API that enables developers to define expected method calls, validate arguments using matchers, and enforce specific call sequences. Furthermore, it supports dynamic behavior injection, allowing for the definition of custom logic via anonymous functions to simulate complex side effects.
The framework covers a broad range of testing capabilities, including automated assertion of function interactions and the configuration of stubbed behavior. It also provides mechanisms for customizing error reporting to clarify discrepancies between expected and actual method calls during test failures. The project is distributed as a command-line tool and library for integration into automated test suites.
Features
- Go Interface - Provides a framework for generating mock implementations of interfaces to isolate dependencies and verify method calls.
- Interface Mock Generators - Generates mock implementations from Go interfaces to simulate dependencies without requiring real service connections.
- Mock Call Count Verification - Asserts that specific methods receive expected arguments and return predefined values during test execution.
- Dependency-Mocked Unit Testers - Isolates code components by replacing external dependencies with controlled mock objects for reliable unit testing.
- Go Testing Frameworks - Offers a comprehensive toolset for simulating dependencies and asserting behavior within Go test suites.
- Compile-Time Mock Generation - Generates mock implementations during the build process to ensure type safety and avoid runtime reflection.
- Interface-to-Mock Generators - Analyzes interface definitions to automatically generate mock structures for dependency isolation.
- Automated Test Execution - Verifies that functions receive expected arguments and return correct values during automated test execution.
- Dynamic Behavior Injection - Allows overriding mock method logic at runtime using anonymous functions to simulate complex side effects.
- Argument Matchers - Validates method arguments against predefined criteria to ensure interactions meet test expectations.
- Mock Behavior Configuration - Defines custom logic for mock methods using anonymous functions to simulate complex side effects.
- Fluent Assertions - Provides a chainable, readable API for defining expected method calls and return values in tests.
- Interaction Sequence Orderers - Enforces strict ordering and frequency requirements for method calls on mock objects during test execution.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
