• Stars
    star
    11
  • Rank 1,694,661 (Top 34 %)
  • Language
    Elixir
  • License
    MIT License
  • Created over 9 years ago
  • Updated about 9 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Simplify your Ecto validation tests

Ecto.ValidationCase

Hex Version Build Status Inline docs

Simplify your Ecto model validation tests. Loosely inspired by shoulda matchers, but simpler.

IMPORTANT

Jose Valim, creator of Elixir, has outlined a better approach to this problem here: https://groups.google.com/forum/#!topic/elixir-lang-talk/kwLLyCiarls

Go check it out.

Sample

defmodule MyApp.UserTest do
  use ExUnit.Case
  use Ecto.ValidationCase, model: MyApp.User

  test "requires password to be 10 chars long" do
    rejects "password",    for: :password, message: "too short"
    accepts "password123", for: :password
  end
end

Rationale

Rather than create a matching test helper function for each of the valiations that Ecto supports, this library intentionally keeps things simple, providing only accepts/2 and rejects/2. Why?

  • The api very easy to remember, which makes validation tests more likely to be written.
  • The tests are more explicit, with a minimum of magic. It is very clear exactly what values are being tested, for which fields, and which error messages should be returned.

Installation

You can install Ecto.ValidationCase from hex. First, change your deps in mix.exs specifying that this is applicable only for the test environment:

def deps do
  [{:ecto_validation_case, ">= 0.1.0", env: :test}]
end

Then run mix deps.get to install.

Documentation

Documentation is available on Ecto.ValidationCase's hex page.

License

MIT. See LICENSE and NOTICE for more details.

More Repositories