Show List
Tutorials > Hoverfly > Creating simple simulations with Hoverfly

Creating simple simulations with Hoverfly

Creating simple simulations with Hoverfly involves defining rules that specify how Hoverfly should respond to incoming requests. Here's an example of how to create a simple simulation with Hoverfly:

  • Start Hoverfly: First, you need to start Hoverfly in "capture" mode using the hoverfly -mode=capture command. This will cause Hoverfly to intercept incoming requests and record them to a simulation file.

  • Send requests to your application: Next, you need to send requests to your application as you normally would. Hoverfly will intercept these requests and record them to the simulation file.

  • Modify the simulation file: Once you've sent a few requests to your application, you can modify the simulation file to specify how Hoverfly should respond to those requests. The simulation file is a JSON file that contains an array of "transactions", where each transaction represents a request and response pair.

  • Define rules for each transaction: For each transaction in the simulation file, you need to define rules that specify how Hoverfly should respond to the corresponding request. For example, you might create a rule that says "if the incoming request has a path of /hello, respond with a 200 OK and a body of 'Hello, world!'". Here's an example of what a transaction with rules might look like:

json
Copy code
{
  "request": {
    "method": "GET",
    "path": "/hello"
  },
  "response": {
    "status": 200,
    "body": "Hello, world!"
  },
  "predicates": [
    {
      "equals": {
        "method": "GET",
        "path": "/hello"
      }
    }
  ]
}

In this example, the request field specifies the incoming request, the response field specifies the response that Hoverfly should send, and the predicates field specifies the conditions under which the response should be sent. In this case, the predicates field says that the response should be sent only if the incoming request has a method of GET and a path of /hello.

  • Replay the simulation: Once you've defined the rules for each transaction in the simulation file, you can replay the simulation by starting Hoverfly in "simulate" mode using the hoverfly -mode=simulate command. This will cause Hoverfly to respond to incoming requests based on the rules you've defined in the simulation file.

Overall, creating simple simulations with Hoverfly is a powerful way to test and develop your application, without having to rely on external dependencies. By defining rules for how your application should respond to different requests, you can create a controlled environment for testing and development.



Next: Advanced simulations with Hoverfly

    Leave a Comment

  • captcha text