Predicates

Predicates can be chained together using operations such as & and | (see the operations section). Take a look at the builder section on how to run the below examples using Dry Logic's builder.

URI (uri?)

Returns true when the string input is a URI

is_https_url = build { uri?(:https) }
is_https_url = build { uri?(/https?/) }
is_http_url = build { uri?(:http) }
is_url = build { uri?(['http', 'https']) }

https_url = "https://example.com"
http_url = "http://example.com"
local_url = "example.local"

is_https_url.call(https_url).success? # => true
is_https_url.call(local_url).success? # => false
is_http_url.call(http_url).success? # => true
is_url.call(https_url).success? # => true

UUID (uuid_v1?, uuid_v2?, uuid_v3?, uuid_v4?, uuid_v5?)

Returns true when the string input is a UUID

is_uuid_v1 = build { uuid_v1? }
is_uuid_v2 = build { uuid_v2? }
is_uuid_v3 = build { uuid_v3? }
is_uuid_v4 = build { uuid_v4? }
is_uuid_v5 = build { uuid_v5? }

uuid1 = "554ef240-5433-11eb-ae93-0242ac130002"
not_uuid = "<not uuid>"

is_uuid_v1.call(uuid1).success? # => true
is_uuid_v2.call(uuid1).success? # => false
is_uuid_v3.call(not_uuid).success? # => false
is_uuid_v4.call(uuid1).success? # => false
is_uuid_v5.call(uuid1).success? # => false

Case expression (case?)

Similar to Ruby's === operator

is_natural = build { case?(1...) }

is_natural.call(1).success? # => true
is_natural.call(-1).success? # => false
is_natural.call("<string>").success? # => false

is_integer = build { case?(Integer) }

is_integer.call(1).success? # => true
is_integer.call("<string>").success? # => false

Identity equality (is?)

Compare two values using Object#object_id. Similar to Ruby's Object#equal?

is_nil = build { is?(nil) }

is_nil.call(nil).success? # => true
is_nil.call(:some).success? # => false

is_very_specific = build { is?(Class.new) }

is_very_specific.call(nil).success? # => false
is_very_specific.call(:some).success? # => false

Equality (eql?)

Returns true when the input is equal to the provided value. Similar to Object#eql?

is_zero = build { eql?(0) }

is_zero.call(0).success? # => true
is_zero.call(10).success? # => false

Inequality (not_eql?)

Returns true when the input does not equal the provided value. Similar to Ruby's != operator

is_present = build { not_eql?(nil) }

is_present.call("hello").success? # => true
is_present.call(nil).success? # => false

Included values (includes?)

Returns true when the input contains the provided value. Can be applied to values responding to #include?

has_zeros = build { includes?(0) }

has_zeros.call([0, 1, 2]).success? # => true
has_zeros.call([-1, -2, -3]).success? # => false

Excluded values (excludes?)

The inverse of includes?

no_zeroes = build { excludes?(0) }

no_zeroes.call([1,2,3]).success? # => true
no_zeroes.call([0, -1, -2]).success? # => false

Included in (included_in?)

Returns true when the input is included in the provided value. Can be applied to values responding to #include?

is_natrual = build { included_in?(1...) }

is_natrual.call(1).success? # => true
is_natrual.call(0).success? # => false
is_natrual.call(-1).success? # => false

Excluded from (excluded_from?)

Inverse of included_in?

is_negative = build { excluded_from?(0...) }

is_negative.call(-1).success? # => true
is_negative.call(0).success? # => false
is_negative.call(1).success? # => false

Size (size?)

Can be applied values responding to #size, such as Hash, Array, and String

is_empty = build { size?(0) }

is_empty.call({}).success? # => true
is_empty.call([]).success? # => true
is_empty.call("").success? # => true

is_empty.call({"1" => 2}).success? # => false
is_empty.call([1]).success? # => false
is_empty.call("1").success? # => false

Minimum size (min_size?)

Checks for a miminum size using #size >= value. See #size?

is_present = build { min_size?(1) }

is_present.call({"1" => 2}).success? # => true
is_present.call([1]).success? # => true
is_present.call("1").success? # => true

is_present.call({}).success? # => false
is_present.call([]).success? # => false
is_present.call("").success? # => false

Maximum size (max_size?)

Checks for a maximum size using #size <= value. See #size?

one_or_none = build { max_size?(1) }

one_or_none.call({}).success? # => true
one_or_none.call([1]).success? # => true
one_or_none.call("A").success? # => true

one_or_none.call({"A" => :a, "B" => :b}).success? # => false
one_or_none.call([1,2]).success? # => false
one_or_none.call("AB").success? # => false

Bytesize (bytesize?)

Can be applied values responding to #bytesize, such as String

is_one = build { bytesize?(1) }

is_one.call("A").success? # => true
is_one.call("AB").success? # => false

is_two_or_tree = build { bytesize?(2..3) }

is_two_or_tree.call("ABC").success? # => true
is_two_or_tree.call("ABCD").success? # => false

is_four = build { bytesize?([4]) }

is_four.call("ABCD").success? # => true
is_four.call("ABC").success? # => false

Minimum byte size (min_bytesize?)

Checks for a minimum size using #bytesize >= value. See #bytesize?

is_min_one = build { min_bytesize?(1) }

is_min_one.call("A").success? # => true
is_min_one.call("").success? # => false

Maximum byte size (max_bytesize?)

Checks for a maximum size using #bytesize >= value. See #bytesize?

is_max_one = build { max_bytesize?(1) }

is_max_one.call("A").success? # => true
is_max_one.call("AB").success? # => false

Greater than (gt?)

Similar to Ruby's > operator

can_vote = build { gt?(17) }

can_vote.call(17).success? # => false
can_vote.call(18).success? # => true
can_vote.call(19).success? # => true

Greater or equal to (gteq?)

Returns true when input is greater than the provided value. Similar to Ruby's >= operator

can_vote = build { gteq?(18) }

can_vote.call(17).success? # => false
can_vote.call(18).success? # => true
can_vote.call(19).success? # => true

Less than (lt?)

Similar to Ruby's < operator

can_work = build { lt?(65) }

can_work.call(65).success? # => false
can_work.call(64).success? # => true

Less or equal to (lteq?)

Returns true when input is less or equal to the provided value. Similar Ruby's <= operator

can_work = build { lteq?(64) }

can_work.call(65).success? # => false
can_work.call(64).success? # => true

Odd (odd?)

Similar to Integer#odd?

is_odd = build { odd? }

is_odd.call(1).success? # => true
is_odd.call(2).success? # => false

Even (even?)

Returns true if the input is even. Similar to Ruby's Integer#even? method

is_even = build { even? }

is_even.call(2).success? # => true
is_even.call(1).success? # => false

Hash (hash?)

Returns true if the input is of type Hash

is_hash = build { hash? }

is_hash.call(Hash.new).success? # => true
is_hash.call(Array.new).success? # => false

Array (array?)

Returns true if the input is of type Array

is_array = build { array? }

is_array.call(Array.new).success? # => true
is_array.call(Hash.new).success? # => false

String (str?)

Returns true if the input is of type String

is_string = build { str? }

is_string.call(String.new).success? # => true
is_string.call(Hash.new).success? # => false

Number (number?)

Returns true if the input is a number

is_number = build { number? }

is_number.call(4).success? # => true
is_number.call(-4).success? # => true
is_number.call("  4").success? # => true
is_number.call("-4").success? # => true
is_number.call(4.0).success? # => true
is_number.call('4').success? # => true
is_number.call('4.0').success? # => true

is_number.call("A4").success? # => false
is_number.call("A-4").success? # => false
is_number.call(nil).success? # => false
is_number.call(:four).success? # => false
is_number.call("four").success? # => false

Decimal (decimal?)

Returns true if the input is of type BigDecimal

is_decimal = build { decimal? }

is_decimal.call(BigDecimal(1)).success? # => true
is_decimal.call(1).success? # => false

Float (float?)

Returns true if the input is of type Float

is_float = build { float? }

is_float.call(1.0).success? # => true
is_float.call(1).success? # => false

Integer (int?)

Returns true if the input is of type Integer

is_int = build { int? }

is_int.call(1).success? # => true
is_int.call(1.0).success? # => false

Time (time?)

Returns true if the input is of Time

is_time = build { time? }

is_time.call(Time.new).success? # => true
is_time.call("2 o'clock").success? # => false

DateTime (date_time?)

Returns true if the input is of type DateTime.

is_date_time = build { date_time? }

is_date_time.call(DateTime.new).success? # => true
is_date_time.call("2 o'clock").success? # => false

Date (date?)

Returns true if the input is of type Date

is_date = build { date? }

is_date.call(Date.new).success? # => true
is_date.call("1 year ago").success? # => false

Bool (bool?)

Checks if the input is equal to true or false

is_bool = build { bool? }

is_bool.call(true).success? # => true
is_bool.call(false).success? # => true

is_bool.call(:false).success? # => false
is_bool.call("true").success? # => false

True / False (true?, false?)

Returns true if the input is true or false

is_true = build { true? }
is_false = build { false? }

is_true.call(true).success? # => true
is_true.call(false).success? # => false
is_false.call(false).success? # => true
is_false.call(true).success? # => false

Empty (empty?)

Returns true if the input is empty. Can be applied to all inputs responding to #empty?

is_empty = build { empty? }

is_empty.call(nil).success? # => true
is_empty.call([]).success? # => true
is_empty.call("").success? # => true
is_empty.call({}).success? # => true

is_empty.call({key: :value}).success? # => false
is_empty.call([:array]).success? # => false
is_empty.call("string").success? # => false
is_empty.call(:symbol).success? # => false

Filled (filled?)

Returns true if the input is not empty. Can be applied to all inputs responding to #empty?

is_filled = build { filled? }

is_filled.call({key: :value}).success? # => true
is_filled.call([:array]).success? # => true
is_filled.call("string").success? # => true
is_filled.call(:symbol).success? # => true

is_filled.call(nil).success? # => false
is_filled.call([]).success? # => false
is_filled.call("").success? # => false
is_filled.call({}).success? # => false

Attribute (attr?, respond_to?)

Returns true when the struct input responds to the given method. Similar to Ruby's Object#respond_to? method

is_named = build { attr?(:name) }

class Person < Struct.new(:age, :name)
  # Logic ...
end

class Car < Struct.new(:age, :brand)
  # Logic ...
end

is_named.call(Person.new(30, "John")).success? # => true
is_named.call(Car.new(3, "Volvo")).success? # => false

Nil (nil?, none?)

Returns true when the input is equal to nil. Similar to Ruby's nil? method

is_nil = build { nil? }

is_nil.call(nil).success? # => true
is_nil.call(:some).success? # => false

Key (key?)

Returns true if the hash input has contains the provided key. Similar to Ruby's Hash#key? method

is_named = build { key?(:name) }

is_named.call({ name: "John" }).success? # => true
is_named.call({ age: 30 }).success? # => false

Format (format?)

Returns true when the input matches the provides regular expression. Similar to Ruby's String#match method

is_email_ish = build { format?(/^\S+@\S+$/) }

is_email_ish.call("hello@example.com").success? # => true
is_email_ish.call("nope|failed.com").success? # => false

octocatEdit on GitHub