Module: Assertion

Extended by:

DSL::Builder

Defined in:

lib/assertion.rb,
lib/assertion/base.rb,
lib/assertion/guard.rb,
lib/assertion/state.rb,
lib/assertion/inverter.rb,
lib/assertion/inversion.rb,
lib/assertion/dsl/caller.rb,
lib/assertion/translator.rb,
lib/assertion/dsl/builder.rb,
lib/assertion/dsl/attribute.rb,
lib/assertion/dsl/inversion.rb,
lib/assertion/invalid_error.rb,
lib/assertion/dsl/attributes.rb

Overview

The module declares:

• assertions about objects

• guards (validations) for objects

Examples:

Assertion

# config/locales/en.yml
# ---
# en:
#   assertion:
#     is_adult:
#       truthy: "%{name} is an adult (age %{age})"
#       falsey: "%{name} is a child (age %{age})"

IsAdult = Assertion.about :name, :age do
  age >= 18
end

joe = OpenStruct.new(name: 'Joe', age: 13)
IsAdult[joe.to_h].validate!
# => #<Assertion::InvalidError @messages=["Joe is a child (age 13)"]>

jane = OpenStruct.new(name: 'Jane', age: 22)
IsAdult.not[jane.to_h].validate!
# => #<Assertion::InvalidError @messages=["Jane is an adult (age 22)"]

Guard

AdultOnly = Assertion.guards :user do
  IsAdult[user.to_h]
end

AdultOnly[joe]
# => #<Assertion::InvalidError @messages=["Joe is a child (age 13)"]>
AdultOnly[jane]
# => #<OpenStruct @name="Jane", @age=22>

Defined Under Namespace

Modules: DSL Classes: Base, Guard, InvalidError, Inversion, Inverter, State, Translator

Method Summary

Methods included from DSL::Builder

about, guards