module Remarkable
module MongoMapper
class Base < Remarkable::Base
I18N_COLLECTION = [ :attributes, :associations ]
# Provides a way to send options to all MongoMapper matchers.
#
# validates_presence_of(:name).with_options(:allow_nil => false)
#
# Is equivalent to:
#
# validates_presence_of(:name, :allow_nil => false)
#
def with_options(opts={})
@options.merge!(opts)
self
end
protected
# Checks for the given key in @options, if it exists and it's true,
# tests that the value is bad, otherwise tests that the value is good.
#
# It accepts the key to check for, the value that is used for testing
# and an @options key where the message to search for is.
#
def assert_bad_or_good_if_key(key, value, message_key=:message) #:nodoc:
return positive? unless @options.key?(key)
if @options[key]
return bad?(value, message_key), :not => not_word
else
return good?(value, message_key), :not => ''
end
end
# Checks for the given key in @options, if it exists and it's true,
# tests that the value is good, otherwise tests that the value is bad.
#
# It accepts the key to check for, the value that is used for testing
# and an @options key where the message to search for is.
#
def assert_good_or_bad_if_key(key, value, message_key=:message) #:nodoc:
return positive? unless @options.key?(key)
if @options[key]
return good?(value, message_key), :not => ''
else
return bad?(value, message_key), :not => not_word
end
end
# Default allow_nil? validation. It accepts the message_key which is
# the key which contain the message in @options.
#
# It also gets an allow_nil message on remarkable.mongo_mapper.allow_nil
# to be used as default.
#
def allow_nil?(message_key=:message) #:nodoc:
assert_good_or_bad_if_key(:allow_nil, nil, message_key)
end
# Default allow_blank? validation. It accepts the message_key which is
# the key which contain the message in @options.
#
# It also gets an allow_blank message on remarkable.mongo_mapper.allow_blank
# to be used as default.
#
def allow_blank?(message_key=:message) #:nodoc:
assert_good_or_bad_if_key(:allow_blank, '', message_key)
end
# Shortcut for assert_good_value.
#
def good?(value, message_sym=:message) #:nodoc:
assert_good_value(@subject, @attribute, value, @options[message_sym])
end
# Shortcut for assert_bad_value.
#
def bad?(value, message_sym=:message) #:nodoc:
assert_bad_value(@subject, @attribute, value, @options[message_sym])
end
# Asserts that an MongoMapper model validates with the passed
# value by making sure the error_message_to_avoid is not
# contained within the list of errors for that attribute.
#
# assert_good_value(User.new, :email, "user@example.com")
# assert_good_value(User.new, :ssn, "123456789", /length/)
#
# If a class is passed as the first argument, a new object will be
# instantiated before the assertion. If an instance variable exists with
# the same name as the class (underscored), that object will be used
# instead.
#
# assert_good_value(User, :email, "user@example.com")
#
# @product = Product.new(:tangible => false)
# assert_good_value(Product, :price, "0")
#
def assert_good_value(model, attribute, value, error_message_to_avoid=//) # :nodoc:
model.send("#{attribute}=", value)
return true if model.valid?
error_message_to_avoid = error_message_from_model(model, attribute, error_message_to_avoid)
assert_does_not_contain(model.errors.on(attribute), error_message_to_avoid)
end
# Asserts that an MongoMapper model invalidates the passed
# value by making sure the error_message_to_expect is
# contained within the list of errors for that attribute.
#
# assert_bad_value(User.new, :email, "invalid")
# assert_bad_value(User.new, :ssn, "123", /length/)
#
# If a class is passed as the first argument, a new object will be
# instantiated before the assertion. If an instance variable exists with
# the same name as the class (underscored), that object will be used
# instead.
#
# assert_bad_value(User, :email, "invalid")
#
# @product = Product.new(:tangible => true)
# assert_bad_value(Product, :price, "0")
#
def assert_bad_value(model, attribute, value, error_message_to_expect=:invalid) #:nodoc:
model.send("#{attribute}=", value)
return false if model.valid? || model.errors.on(attribute).blank?
error_message_to_expect = error_message_from_model(model, attribute, error_message_to_expect)
assert_contains(model.errors.on(attribute), error_message_to_expect)
end
# Return the error message to be checked. If the message is not a Symbol
# neither a Hash, it returns the own message.
#
# But the nice thing is that when the message is a Symbol we get the error
# messsage from within the model, using already existent structure inside
# MongoMapper.
#
# This allows a couple things from the user side:
#
# 1. Specify symbols in their tests:
#
# should_allow_values_for(:shirt_size, 'S', 'M', 'L', :message => :inclusion)
#
# As we know, allow_values_for searches for a :invalid message. So if we
# were testing a validates_inclusion_of with allow_values_for, previously
# we had to do something like this:
#
# should_allow_values_for(:shirt_size, 'S', 'M', 'L', :message => 'not included in list')
#
# Now everything gets resumed to a Symbol.
#
# 2. Do not worry with specs if their are using I18n API properly.
#
# As we know, I18n API provides several interpolation options besides
# fallback when creating error messages. If the user changed the message,
# macros would start to pass when they shouldn't.
#
# Using the underlying mechanism inside ActiveRecord makes us free from
# all thos errors.
#
# We replace {{count}} interpolation for 12345 which later is replaced
# by a regexp which contains \d+.
#
def error_message_from_model(model, attribute, message) #:nodoc:
# FIXME
message
end
# Asserts that the given collection does not contain item x. If x is a
# regular expression, ensure that none of the elements from the collection
# match x.
#
def assert_does_not_contain(collection, x) #:nodoc:
!assert_contains(collection, x)
end
# Changes how collection are interpolated to provide localized names
# whenever is possible.
#
def collection_interpolation #:nodoc:
described_class = if @subject
subject_class
elsif @spec
@spec.send(:described_class)
end
if i18n_collection? && described_class.respond_to?(:human_attribute_name)
options = {}
collection_name = self.class.matcher_arguments[:collection].to_sym
if collection = instance_variable_get("@#{collection_name}")
collection = collection.map do |attr|
described_class.human_attribute_name(attr.to_s, :locale => Remarkable.locale).downcase
end
options[collection_name] = array_to_sentence(collection)
end
object_name = self.class.matcher_arguments[:as]
if object = instance_variable_get("@#{object_name}")
object = described_class.human_attribute_name(object.to_s, :locale => Remarkable.locale).downcase
options[object_name] = object
end
options
else
super
end
end
# Returns true if the given collection should be translated.
#
def i18n_collection? #:nodoc:
RAILS_I18N && I18N_COLLECTION.include?(self.class.matcher_arguments[:collection])
end
end
end
end