bblimke/webmock
Webmock
WebMock ist eine Ruby-Bibliothek für HTTP-Request-Stubbing, Antwort-Simulation und Netzwerk-Interzeption. Sie dient als Test-Assertion-Framework zur Verifizierung ausgehenden HTTP-Verkehrs und als Netzwerk-Interzeptionsschicht, die externe Verbindungen blockiert, um versehentliche Anfragen während des Testens zu verhindern.
Das Projekt bietet Funktionen für die dynamische Antwortgenerierung und die Sequenzierung verschiedener Rückgabewerte für wiederholte Anfragen an denselben Endpunkt. Es unterstützt die Simulation von Netzwerkfehlern, wie Timeouts oder Exceptions, und ermöglicht das Replay von Antworten mithilfe von rohen HTTP-Daten, die aus lokalen Dateien geladen werden.
Die Bibliothek deckt ein breites Spektrum an API-Simulations- und Netzwerkkontrollfunktionen ab, einschließlich Request-Matching basierend auf URIs und Headern, Aufzeichnung von Request-Signaturen und Filterung ausgehenden Datenverkehrs. Sie enthält zudem Monitoring-Utilities, um Netzwerkereignisse über benutzerdefinierte Callbacks abzufangen und zu protokollieren.
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.
