A library for defining and validating data structures.
Compares the properties of the given object with the specified property.
If all of the property values equal the expected value, the constraint will match the object; otherwise, if there are any non-matching values, the constraint will not match.
Using an Properties::Match constraint
ConfirmPassword = Struct.new(:password, :confirmation)
constraint = Stannum::Constraints::Properties::MatchProperty.new(
:password,
:confirmation
)
params = ConfirmPassword.new('tronlives', 'ifightfortheusers')
constraint.matches?(params)
#=> false
constraint.errors_for(params)
#=> [
{
path: [:confirmation],
type: 'stannum.constraints.is_not_equal_to',
data: { expected: '[FILTERED]', actual: '[FILTERED]' }
}
]
params = ConfirmPassword.new('tronlives', 'tronlives')
constraint.matches?(params)
#=> trueFILTERED_PARAMETERS
= %i[
passw
secret
token
_key
crypt
salt
certificate
otp
ssn
].freeze
Default parameter names to filter out of errors.
NEGATED_TYPE
= Stannum::Constraints::Equality::NEGATED_TYPE
The :type of the error generated for a matching object.
TYPE
= Stannum::Constraints::Equality::TYPE
The :type of the error generated for a non-matching object.
#initialize(reference_name, *property_names, **options) => Matching
#options => Hash<Symbol, Object>
#property_names => Array<String, Symbol> (readonly)
#reference_name => String, Symbol (readonly)
#==(other) => true, false
Performs an equality comparison.
#allow_empty? => true, false
#allow_nil? => true, false
#clone(freeze: nil) => Stannum::Constraints::Base
Produces a shallow copy of the constraint.
#does_not_match?(actual) => true, false
#dup => Stannum::Constraints::Base
Produces a shallow copy of the constraint.
#errors_for(actual, errors: nil) => Stannum::Errors
Note: This method should only be called for an object that does not match the constraint. Generating errors for a matching object can result in undefined behavior.
Generates an errors object for the given object.
The errors object represents the difference between the given object and the expected properties or behavior. It may be the same for all objects, or different based on the details of the object or the constraint.
Generating errors for a non-matching object.
constraint = CustomConstraint.new
object = NonMatchingObject.new
errors = constraint.errors_for(object)
errors.class #=> Stannum::Errors
errors.to_a #=> [{ type: 'some_error', message: 'some error message' }]#match(actual) => Object
Checks the given object against the constraint and returns errors, if any.
This method checks the given object against the expected properties or behavior. If the object matches the constraint, #match will return true. If the object does not match the constraint, #match will return false and the generated errors for that object.
Checking a matching object.
constraint = CustomConstraint.new
object = MatchingObject.new
success, errors = constraint.match(object)
success #=> true
errors #=> nilChecking a non-matching object.
constraint = CustomConstraint.new
object = NonMatchingObject.new
success, errors = constraint.match(object)
success #=> false
errors.class #=> Stannum::Errors
errors.to_a #=> [{ type: 'some_error', message: 'some error message' }]#matches?(actual) => true, false
Also known as:
match?
#message => String, nil
#negated_errors_for(actual, errors: nil) => Stannum::Errors
Note: This method should only be called for an object that matches the constraint. Generating errors for a matching object can result in undefined behavior.
Generates an errors object for the given object when negated.
The errors object represents the difference between the given object and the expected properties or behavior when the constraint is negated. It may be the same for all objects, or different based on the details of the object or the constraint.
Generating errors for a matching object.
constraint = CustomConstraint.new
object = MatchingObject.new
errors = constraint.negated_errors_for(object)
errors.class #=> Stannum::Errors
errors.to_a #=> [{ type: 'some_error', message: 'some error message' }]#negated_match(actual) => Object
Checks the given object against the constraint and returns errors, if any.
This method checks the given object against the expected properties or behavior. If the object matches the constraint, #negated_match will return false and the generated errors for that object. If the object does not match the constraint, #negated_match will return true.
Checking a matching object.
constraint = CustomConstraint.new
object = MatchingObject.new
success, errors = constraint.negated_match(object)
success #=> false
errors.class #=> Stannum::Errors
errors.to_a #=> [{ type: 'some_error', message: 'some error message' }]Checking a non-matching object.
constraint = CustomConstraint.new
object = NonMatchingObject.new
success, errors = constraint.negated_match(object)
success #=> true
errors #=> nil#negated_message => String, nil
#negated_type => String
#type => String
#with_options(**options) => Stannum::Constraints::Base
Creates a copy of the constraint and updates the copy’s options.
Back to Documentation | Versions | 0.4 | Reference | Stannum | Stannum::Constraints | Stannum::Constraints::Properties