bblimke/webmock
Webmock
WebMock 是一个用于 HTTP 请求存根、响应模拟和网络拦截的 Ruby 库。它既是一个用于验证传出 HTTP 流量的测试断言框架，也是一个网络拦截层，可阻止外部连接以防止测试期间发生意外请求。
该项目提供了动态响应生成以及为同一端点的重复请求排序不同返回值的功能。它支持模拟网络故障（如超时或异常），并允许使用从本地文件加载的原始 HTTP 数据进行响应重放。
该库涵盖了广泛的 API 模拟和网络控制功能，包括基于 URI 和标头的请求匹配、请求签名记录以及出站流量过滤。它还包括通过自定义回调拦截和记录网络事件的监控实用程序。
Features
- HTTP Stubbing Frameworks - Implements a comprehensive framework for stubbing HTTP requests and returning predefined status codes and bodies.
- Ruby - Simulates HTTP server responses to isolate application logic from external network dependencies in Ruby projects.
- Request Body Matchers - Validates request payloads using regular expressions, partial data structures, or custom logic blocks.
- Application-Level Traffic Interception - Hooks into Ruby HTTP client libraries to divert outgoing traffic into a custom stub handler.
- Request History Logs - Captures and stores a history of all intercepted requests to enable post-execution assertions.
- Ruby HTTP Mocking Libraries - Provides utilities to intercept and simulate HTTP traffic within Ruby applications during testing.
- API Expectation Frameworks - Provides tools to verify that specific API calls were made with the expected parameters and headers.
- External API Call Assertions - Verifies that an application made expected outgoing HTTP requests to external services.
- Custom Mock Response Overrides - Enables the configuration of custom status codes, headers, and bodies to override default mock responses.
- Request Verification - Asserts that outgoing requests were made, skipped, or executed a specific number of times.
- Network Connection Blockers - Blocks all external network connections by default to prevent accidental requests during testing.
- Response Simulators - Generates custom status codes, artificial delays, and specific content types to test application resilience.
- Network Failure Simulations - Provides simulations of network-level errors such as connection timeouts and service outages to verify application resilience.
- Regex Request Matching - Allows matching API requests using regular expressions and flexible patterns in URIs and headers.
- Network Request Assertions - Provides assertions for verifying that specific network requests were executed with expected parameters.
- Network Request Filters - Uses regular expressions and custom logic to block or allow specific network requests based on URL patterns.
- HTTP Client Interception - Intercepts outgoing network traffic to block external connections and prevent accidental requests during tests.
- File-Based Response Serving - Serves the raw contents of local files as mock API response bodies.
- Dynamic Response Callbacks - Provides custom callback functions to generate mock responses dynamically based on incoming request data.
- Response Sequencing - Returns a sequence of different responses for repeated requests to the same endpoint.
- Local API Response Mocking - Loads raw HTTP responses from local files to serve as stubbed return values.
- Mock State Resetting - Includes utilities to reset request history and clear active stubs between individual test cases.
- Network Connectivity Controls - Restricts or permits network access to specific hosts during test execution to ensure isolation.
- Testing - HTTP request stubbing.
