Voorhees v0.1.1 → Overview → Voorhees

Voorhees

Summary
Functions

A library for validating JSON responses

Source

Summary↑

matches_payload?(payload, expected_payload)	Returns true if the payload matches the values from expected payload. Key/value pairs in the payload that are not in the expected payload are ignored. Key/value pairs in the expected payload that are not in the payload cause `matches_payload?` to return false
matches_schema?(payload, expected_keys)	Returns true if the payload matches the format of the expected keys matched in

Functions

matches_payload?(payload, expected_payload)

(function) # ↑

Specs:

matches_payload?(String.t, list | %{}) :: boolean

Returns true if the payload matches the values from expected payload. Key/value pairs in the payload that are not in the expected payload are ignored. Key/value pairs in the expected payload that are not in the payload cause matches_payload? to return false

Examples

Expected payload keys can be either strings or atoms

iex> payload = ~S[{ "foo": 1, "bar": "baz" }]
iex> Voorhees.matches_payload?(payload, %{ :foo => 1, "bar" => "baz" })
true

Extra key/value pairs in payload are ignored

iex> payload = ~S[{ "foo": 1, "bar": "baz", "boo": 3 }]
iex> Voorhees.matches_payload?(payload, %{ :foo => 1, "bar" => "baz" })
true

Extra key/value pairs in expected payload cause the validation to fail

iex> payload = ~S[{ "foo": 1, "bar": "baz"}]
iex> Voorhees.matches_payload?(payload, %{ :foo => 1, "bar" => "baz", :boo => 3 })
false

Validates scalar lists

iex> payload = ~S/{ "foo": 1, "bar": ["baz"]}/
iex> Voorhees.matches_payload?(payload, %{ :foo => 1, "bar" => ["baz"] })
true

# Order is respected
iex> payload = ~S/{ "foo": 1, "bar": [1, "baz"]}/
iex> Voorhees.matches_payload?(payload, %{ :foo => 1, "bar" => ["baz", 1] })
false

Validates lists of objects

iex> payload = ~S/[{ "foo": 1, "bar": { "baz": 2 }}]/
iex> Voorhees.matches_payload?(payload, [%{ :foo => 1, "bar" => %{ "baz" => 2 } }])
true

Validates nested objects

iex> payload = ~S/{ "foo": 1, "bar": { "baz": 2 }}/
iex> Voorhees.matches_payload?(payload, %{ :foo => 1, "bar" => %{ "baz" => 2 } })
true

Validates nested lists of objects

iex> payload = ~S/{ "foo": 1, "bar": [{ "baz": 2 }]}/
iex> Voorhees.matches_payload?(payload, %{ :foo => 1, "bar" => [%{ "baz" => 2 }] })
true

Source

matches_schema?(payload, expected_keys)

(function) # ↑

Specs:

matches_schema?(String.t, list) :: boolean

Returns true if the payload matches the format of the expected keys matched in.

Examples

Validating simple objects

iex> payload = ~S[{ "foo": 1, "bar": "baz" }]
iex> Voorhees.matches_schema?(payload, [:foo, "bar"]) # Property names can be strings or atoms
true

# Extra keys
iex> payload = ~S[{ "foo": 1, "bar": "baz", "boo": 3 }]
iex> Voorhees.matches_schema?(payload, [:foo, "bar"])
false

# Missing keys
iex> payload = ~S[{ "foo": 1 }]
iex> Voorhees.matches_schema?(payload, [:foo, "bar"])
false

Validating lists of objects

iex> payload = ~S/[{ "foo": 1, "bar": "baz" },{ "foo": 2, "bar": "baz" }]/
iex> Voorhees.matches_schema?(payload, [:foo, "bar"])
true

Validating nested lists of objects

iex> payload = ~S/{ "foo": 1, "bar": [{ "baz": 2 }]}/
iex> Voorhees.matches_schema?(payload, [:foo, bar: [:baz]])
true

Validating that a property is a list of scalar values

iex> payload = ~S/{ "foo": 1, "bar": ["baz", 2]}/
iex> Voorhees.matches_schema?(payload, [:foo, bar: []])
true

Source