Packages
ecto
0.2.2
3.14.1
3.14.0
3.13.6
3.13.5
3.13.4
3.13.3
3.13.2
3.13.1
3.13.0
3.12.6
3.12.5
3.12.4
3.12.3
3.12.2
3.12.1
3.12.0
3.11.2
3.11.1
3.11.0
3.10.3
3.10.2
3.10.1
3.10.0
3.9.6
3.9.5
3.9.4
3.9.3
3.9.2
3.9.1
3.9.0
3.8.4
3.8.3
3.8.2
3.8.1
3.8.0
3.7.2
3.7.1
3.7.0
3.6.2
3.6.1
3.6.0
3.5.8
3.5.7
3.5.6
3.5.5
3.5.4
3.5.3
3.5.2
3.5.1
3.5.0
3.5.0-rc.1
3.5.0-rc.0
3.4.6
3.4.5
3.4.4
3.4.3
3.4.2
3.4.1
3.4.0
3.3.4
3.3.3
3.3.2
3.3.1
3.3.0
3.2.5
3.2.4
3.2.3
3.2.2
3.2.1
3.2.0
3.1.7
3.1.6
3.1.5
3.1.4
3.1.3
3.1.2
3.1.1
3.1.0
3.0.9
3.0.8
3.0.7
3.0.6
3.0.5
3.0.4
3.0.3
3.0.2
3.0.1
3.0.0
3.0.0-rc.1
3.0.0-rc.0
2.2.12
2.2.11
2.2.10
2.2.9
2.2.8
2.2.7
2.2.6
2.2.5
2.2.4
2.2.3
2.2.2
2.2.1
2.2.0
2.2.0-rc.1
2.2.0-rc.0
2.1.6
2.1.5
2.1.4
2.1.3
2.1.2
2.1.1
2.1.0
2.1.0-rc.5
2.1.0-rc.4
2.1.0-rc.3
2.1.0-rc.2
2.1.0-rc.1
2.1.0-rc.0
2.0.6
2.0.5
2.0.4
2.0.3
2.0.2
2.0.1
2.0.0
2.0.0-rc.6
2.0.0-rc.5
2.0.0-rc.4
2.0.0-rc.3
2.0.0-rc.2
2.0.0-rc.1
2.0.0-rc.0
2.0.0-beta.2
2.0.0-beta.1
2.0.0-beta.0
1.1.9
1.1.8
1.1.7
1.1.6
1.1.5
1.1.4
1.1.3
1.1.2
1.1.1
1.1.0
1.0.7
1.0.6
1.0.5
1.0.4
1.0.3
1.0.2
1.0.1
1.0.0
0.16.0
0.15.0
0.14.3
0.14.2
0.14.1
0.14.0
0.13.1
0.13.0
0.12.1
0.12.0
0.12.0-rc
0.11.3
0.11.2
0.11.1
0.11.0
0.10.3
0.10.2
0.10.1
0.10.0
0.9.0
0.8.1
0.8.0
0.7.2
0.7.1
0.7.0
0.6.0
0.5.1
0.5.0
0.4.0
0.3.0
0.2.8
0.2.7
0.2.6
0.2.5
0.2.4
0.2.3
0.2.2
0.2.1
0.2.0
0.1.0
A toolkit for data mapping and language integrated query for Elixir
Current section
Files
Jump to
Current section
Files
lib/ecto/validator/predicates.ex
defmodule Ecto.Validator.Predicates do
@moduledoc """
A handful of predicates to be used in validations.
The examples in this module use the syntax made
available via `Ecto.Model.Validations` in your
model.
"""
@type maybe_error :: [] | Keyword.t
@blank [nil, "", []]
@doc """
Validates the attribute is present (i.e. not nil,
nor an empty list nor an empty string).
## Options
* `:message` - defaults to "can't be blank"
## Examples
validate user,
name: present()
"""
@spec present(atom, term, Keyword.t) :: maybe_error
def present(attr, value, opts \\ [])
def present(attr, value, opts) when value in @blank and is_list(opts) do
[{attr, opts[:message] || "can't be blank"}]
end
def present(_attr, _value, opts) when is_list(opts) do
[]
end
@doc """
Validates the attribute is absent (i.e. nil,
an empty list or an empty string).
## Options
* `:message` - defaults to "must be blank"
## Examples
validate user,
honeypot: absent()
"""
@spec absent(atom, term, Keyword.t) :: maybe_error
def absent(attr, value, opts \\ [])
def absent(_attr, value, opts) when value in @blank and is_list(opts) do
[]
end
def absent(attr, _value, opts) when is_list(opts) do
[{attr, opts[:message] || "must be blank"}]
end
@doc """
Validates the attribute has a given format.
Nil values are not matched against (skipped).
## Options
* `:message` - defaults to "is invalid"
## Examples
validate user,
email: has_format(~r/@/)
"""
@spec has_format(atom, term, Regex.t | binary, Keyword.t) :: maybe_error
def has_format(attr, value, match_on, opts \\ []) when is_list(opts) do
if value == nil or value =~ match_on do
[]
else
[{attr, opts[:message] || "is invalid"}]
end
end
@doc """
Validates the attribute has a given length according to Unicode
(i.e. it uses `String.length` under the scenes). That said, this
function should not be used to validate binary fields.
The length can be given as a range (indicating min and max),
as an integer (indicating exact match) or as keyword options,
indicating, min and max values.
Raises if the given argument is not a binary.
## Options
* `:too_long` - message when the length is too long
(defaults to "is too long (maximum is X characters)")
* `:too_short` - message when the length is too short
(defaults to "is too short (minimum is X characters)")
* `:no_match` - message when the length does not match
(defaults to "must be X characters")
## Examples
validate user,
password: has_length(6..100)
validate user,
password: has_length(min: 6, too_short: "requires a minimum length")
validate user,
code: has_length(3, no_match: "needs to be 3 characters")
"""
@spec has_length(atom, term, Regex.t | binary, Keyword.t) :: maybe_error
def has_length(attr, value, match_on, opts \\ [])
def has_length(_attr, nil, _match_on, opts) when is_list(opts) do
[]
end
def has_length(attr, value, min..max, opts) when is_binary(value) when is_list(opts) do
length = String.length(value)
too_short(attr, length, min, opts) || too_long(attr, length, max, opts) || []
end
def has_length(attr, value, exact, opts) when is_integer(exact) do
if String.length(value) != exact do
[{attr, opts[:no_match] || "must be #{characters(exact)}"}]
else
[]
end
end
def has_length(attr, value, opts, other) when is_list(opts) and is_list(other) do
opts = Keyword.merge(opts, other)
length = String.length(value)
((min = opts[:min]) && too_short(attr, length, min, opts)) ||
((max = opts[:max]) && too_long(attr, length, max, opts)) ||
[]
end
defp too_short(attr, length, min, opts) when is_integer(min) do
if length < min do
[{attr, opts[:too_short] || "is too short (minimum is #{characters(min)})"}]
end
end
defp too_long(attr, length, max, opts) when is_integer(max) do
if length > max do
[{attr, opts[:too_long] || "is too long (maximum is #{characters(max)})"}]
end
end
defp characters(1), do: "1 character"
defp characters(x), do: "#{x} characters"
@doc """
Validates the given number is greater than the given value.
Expects numbers as value, raises otherwise.
## Options
* `:message` - defaults to "must be greater than X"
## Examples
validates user,
age: greater_than(18)
"""
def greater_than(attr, value, check, opts \\ [])
def greater_than(_attr, value, check, _opts) when
is_number(check) and (nil?(value) or value > check), do: []
def greater_than(attr, _value, check, opts) when is_number(check), do:
[{attr, opts[:message] || "must be greater than #{check}"}]
@doc """
Validates the given number is greater than or equal to the given value.
Expects numbers as value, raises otherwise.
## Options
* `:message` - defaults to "must be greater than or equal to X"
## Examples
validates user,
age: greater_than_or_equal_to(18)
"""
def greater_than_or_equal_to(attr, value, check, opts \\ [])
def greater_than_or_equal_to(_attr, value, check, _opts) when
is_number(check) and (nil?(value) or value >= check), do: []
def greater_than_or_equal_to(attr, _value, check, opts) when is_number(check), do:
[{attr, opts[:message] || "must be greater than or equal to #{check}"}]
@doc """
Validates the given number is less than the given value.
Expects numbers as value, raises otherwise.
## Options
* `:message` - defaults to "must be less than X"
## Examples
validates user,
age: less_than(18)
"""
def less_than(attr, value, check, opts \\ [])
def less_than(_attr, value, check, _opts) when
is_number(check) and (nil?(value) or value < check), do: []
def less_than(attr, _value, check, opts) when is_number(check), do:
[{attr, opts[:message] || "must be less than #{check}"}]
@doc """
Validates the given number is less than or equal to the given value.
Expects numbers as value, raises otherwise.
## Options
* `:message` - defaults to "must be less than or equal to X"
## Examples
validates user,
age: less_than_or_equal_to(18)
"""
def less_than_or_equal_to(attr, value, check, opts \\ [])
def less_than_or_equal_to(_attr, value, check, _opts) when
is_number(check) and (nil?(value) or value <= check), do: []
def less_than_or_equal_to(attr, _value, check, opts) when is_number(check), do:
[{attr, opts[:message] || "must be less than or equal to #{check}"}]
@doc """
Validates the given number is between the value.
Expects a range as value, raises otherwise.
## Options
* `:message` - defaults to "must be between X and Y"
## Examples
validates user,
age: between(18..21)
"""
def between(attr, value, range, opts \\ [])
def between(_attr, value, min..max, _opts) when
is_number(min) and is_number(max) and (nil?(value) or value in min..max), do: []
def between(attr, _value, min..max, opts) when is_number(min) and is_number(max), do:
[{attr, opts[:message] || "must be between #{min} and #{max}"}]
@doc """
Validates the attribute is member of the given enumerable.
This validator has the same semantics as calling `Enum.member?/2`
with the given enumerable and value.
Nil values are not matched against (skipped).
## Options
* `:message` - defaults to "is not included in the list"
## Examples
validate user,
gender: member_of(~w(male female other))
validate user,
age: member_of(0..99)
"""
@spec member_of(atom, term, Enumerable.t, Keyword.t) :: maybe_error
def member_of(attr, value, enum, opts \\ []) when is_list(opts) do
if value == nil or value in enum do
[]
else
[{attr, opts[:message] || "is not included in the list"}]
end
end
@doc """
Validates the attribute is not a member of the given enumerable.
This validator has the same semantics as calling
`not Enum.member?/2` with the given enumerable and value.
Nil values are not matched against (skipped).
## Options
* `:message` - defaults to "is reserved"
## Examples
validate user,
username: not_member_of(~w(admin superuser))
validate user,
password: not_member_of([user.username, user.name],
message: "cannot be the same as username or first name")
"""
@spec not_member_of(atom, term, Enumerable.t, Keyword.t) :: maybe_error
def not_member_of(attr, value, enum, opts \\ []) when is_list(opts) do
if value == nil or not(value in enum) do
[]
else
[{attr, opts[:message] || "is reserved"}]
end
end
end