JSV

JSV is a JSON Schema Validation library for Elixir with full support for the latest JSON Schema specification.

Documentation

API documentation is available on hexdocs.pm.

Installation

def deps do
  [
    {:jsv, "~> 0.7"},
  ]
end

Additional dependencies can be added to support more features:

def deps do
  [
    # Optional libraries for enhanced format validation like URI, IRI, email
    # address, JSON-pointer, etc.
    {:abnf_parsec, "~> 1.0"},

    # JSV Supports Decimal and will validate Decimal structs as numbers.
    {:decimal, "~> 2.0"},

    # Optional libraries for decoding schemas resolved via HTTP
    # (required for Elixir versions prior to 1.18)
    {:jason, "~> 1.0"},
    # OR
    {:poison, "~> 6.0 or ~> 5.0"},
  ]
end

Basic Usage

Here is an example of how to use the library:

schema = %{
  type: :object,
  properties: %{
    name: %{type: :string}
  },
  required: [:name]
}

root = JSV.build!(schema)

case JSV.validate(%{"name" => "Alice"}, root) do
  {:ok, data} ->
    {:ok, data}

  # Errors can be converted into JSON-compatible structures for API responses
  # or logging.
  {:error, validation_error} ->
    {:error, JSON.encode!(JSV.normalize_error(validation_error))}
end

JSV offers many additional features! Check the documentation for more details.

Contributing

Pull requests are welcome, provided they include appropriate tests and documentation.