Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/stevegraham/hypermock

HTTP request stubbing and expectation Elixir library
https://github.com/stevegraham/hypermock

Last synced: about 2 months ago
JSON representation

HTTP request stubbing and expectation Elixir library

Lists

README

        

# HyperMock

HTTP request stubbing and expectation Elixir library. Intercepts HTTP calls and
either returns a stubbed response if that request was stubbed or raises an error
if a matching request was not found in the stubbed requests.

The idea is to provide tools to explicitly verify properties of the actual request
rather than loose stubbing to return canned responses in your tests.

Unused stubs in your tests will also raise errors.

```elixir
defmodule RequestTest do
use HyperMock

def fail do
HyperMock.intercept do
# No expectations have been set. This will raise an error.
HTTPotion.get "http://example.com:3000/users", [body: "hello=world", headers: ["User-Agent": "My App"]]
end
end

def yay do
HyperMock.intercept do
request = %Request{ method: :get, uri: "http://lol.biz.info", headers: ["User-Agent": "My App"] }
response = %Response{ body: "LOOOOOOOOOOOOL m8!" }

stub_request request, response

# This will return a HTTPotion.Response struct with a 200 status and body of "LOOOOOOOOOOOOL m8!"
HTTPotion.get("http://lol.biz.info", headers: ["User-Agent": "My App"]) |> inspect |> IO.puts
end
end
end
```

# Limitations

Only works with ibrowse synchronous requests right now. If you want to add support
for asynchronous requests or another client open an issue and let's talk about it :)

# Contributing

If you have an idea please open an issue to start discussion first. The feature may
have been discussed previously or in development.