bblimke/webmock
Webmock
WebMock este o bibliotecă Ruby pentru stubbing-ul cererilor HTTP, simularea răspunsurilor și interceptarea rețelei. Servește drept framework de aserțiune de testare pentru verificarea traficului HTTP de ieșire și un strat de interceptare a rețelei care blochează conexiunile externe pentru a preveni cererile accidentale în timpul testării.
Proiectul oferă capabilități pentru generarea dinamică de răspunsuri și secvențierea diferitelor valori de returnare pentru cereri repetate către același endpoint. Suportă simularea eșecurilor de rețea, cum ar fi timeout-urile sau excepțiile, și permite reluarea răspunsurilor folosind date HTTP brute încărcate din fișiere locale.
Biblioteca acoperă o gamă largă de funcții de simulare API și control al rețelei, inclusiv potrivirea cererilor pe baza URI-urilor și a headerelor, înregistrarea semnăturilor cererilor și filtrarea traficului de ieșire. Include, de asemenea, utilitare de monitorizare pentru a intercepta și loga evenimentele de rețea prin callback-uri personalizate.
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.
