Module: Sequel::Plugins::ValidationHelpers::InstanceMethods
- Defined in:
- lib/sequel/plugins/validation_helpers.rb
Instance Method Summary collapse
-
#validates_exact_length(exact, atts, opts = OPTS) ⇒ Object
Check that the attribute values are the given exact length.
-
#validates_format(with, atts, opts = OPTS) ⇒ Object
Check the string representation of the attribute value(s) against the regular expression with.
-
#validates_includes(set, atts, opts = OPTS) ⇒ Object
Check attribute value(s) is included in the given set.
-
#validates_integer(atts, opts = OPTS) ⇒ Object
Check attribute value(s) string representation is a valid integer.
-
#validates_length_range(range, atts, opts = OPTS) ⇒ Object
Check that the attribute values length is in the specified range.
-
#validates_max_length(max, atts, opts = OPTS) ⇒ Object
Check that the attribute values are not longer than the given max length.
-
#validates_min_length(min, atts, opts = OPTS) ⇒ Object
Check that the attribute values are not shorter than the given min length.
-
#validates_not_null(atts, opts = OPTS) ⇒ Object
Check attribute value(s) are not NULL/nil.
-
#validates_numeric(atts, opts = OPTS) ⇒ Object
Check attribute value(s) string representation is a valid float.
-
#validates_presence(atts, opts = OPTS) ⇒ Object
Check attribute value(s) is not considered blank by the database, but allow false values.
-
#validates_schema_types(atts = keys, opts = OPTS) ⇒ Object
Validates for all of the model columns (or just the given columns) that the column value is an instance of the expected class based on the column’s schema type.
-
#validates_type(klass, atts, opts = OPTS) ⇒ Object
Check if value is an instance of a class.
-
#validates_unique(*atts) ⇒ Object
Checks that there are no duplicate values in the database for the given attributes.
Instance Method Details
#validates_exact_length(exact, atts, opts = OPTS) ⇒ Object
Check that the attribute values are the given exact length.
93 94 95 |
# File 'lib/sequel/plugins/validation_helpers.rb', line 93 def validates_exact_length(exact, atts, opts=OPTS) validatable_attributes_for_type(:exact_length, atts, opts){|a,v,m| (m, exact) if v.nil? || v.length != exact} end |
#validates_format(with, atts, opts = OPTS) ⇒ Object
Check the string representation of the attribute value(s) against the regular expression with.
98 99 100 |
# File 'lib/sequel/plugins/validation_helpers.rb', line 98 def validates_format(with, atts, opts=OPTS) validatable_attributes_for_type(:format, atts, opts){|a,v,m| (m, with) unless v.to_s =~ with} end |
#validates_includes(set, atts, opts = OPTS) ⇒ Object
Check attribute value(s) is included in the given set.
103 104 105 |
# File 'lib/sequel/plugins/validation_helpers.rb', line 103 def validates_includes(set, atts, opts=OPTS) validatable_attributes_for_type(:includes, atts, opts){|a,v,m| (m, set) unless set.send(set.respond_to?(:cover?) ? :cover? : :include?, v)} end |
#validates_integer(atts, opts = OPTS) ⇒ Object
Check attribute value(s) string representation is a valid integer.
108 109 110 111 112 113 114 115 116 117 |
# File 'lib/sequel/plugins/validation_helpers.rb', line 108 def validates_integer(atts, opts=OPTS) validatable_attributes_for_type(:integer, atts, opts) do |a,v,m| begin Kernel.Integer(v.to_s) nil rescue (m) end end end |
#validates_length_range(range, atts, opts = OPTS) ⇒ Object
Check that the attribute values length is in the specified range.
120 121 122 |
# File 'lib/sequel/plugins/validation_helpers.rb', line 120 def validates_length_range(range, atts, opts=OPTS) validatable_attributes_for_type(:length_range, atts, opts){|a,v,m| (m, range) if v.nil? || !range.send(range.respond_to?(:cover?) ? :cover? : :include?, v.length)} end |
#validates_max_length(max, atts, opts = OPTS) ⇒ Object
Check that the attribute values are not longer than the given max length.
Accepts a :nil_message option that is the error message to use when the value is nil instead of being too long.
128 129 130 |
# File 'lib/sequel/plugins/validation_helpers.rb', line 128 def validates_max_length(max, atts, opts=OPTS) validatable_attributes_for_type(:max_length, atts, opts){|a,v,m| v ? (m, max) : (opts[:nil_message] || DEFAULT_OPTIONS[:max_length][:nil_message]) if v.nil? || v.length > max} end |
#validates_min_length(min, atts, opts = OPTS) ⇒ Object
Check that the attribute values are not shorter than the given min length.
133 134 135 |
# File 'lib/sequel/plugins/validation_helpers.rb', line 133 def validates_min_length(min, atts, opts=OPTS) validatable_attributes_for_type(:min_length, atts, opts){|a,v,m| (m, min) if v.nil? || v.length < min} end |
#validates_not_null(atts, opts = OPTS) ⇒ Object
Check attribute value(s) are not NULL/nil.
138 139 140 |
# File 'lib/sequel/plugins/validation_helpers.rb', line 138 def validates_not_null(atts, opts=OPTS) validatable_attributes_for_type(:not_null, atts, opts){|a,v,m| (m) if v.nil?} end |
#validates_numeric(atts, opts = OPTS) ⇒ Object
Check attribute value(s) string representation is a valid float.
143 144 145 146 147 148 149 150 151 152 |
# File 'lib/sequel/plugins/validation_helpers.rb', line 143 def validates_numeric(atts, opts=OPTS) validatable_attributes_for_type(:numeric, atts, opts) do |a,v,m| begin Kernel.Float(v.to_s) nil rescue (m) end end end |
#validates_presence(atts, opts = OPTS) ⇒ Object
Check attribute value(s) is not considered blank by the database, but allow false values.
177 178 179 |
# File 'lib/sequel/plugins/validation_helpers.rb', line 177 def validates_presence(atts, opts=OPTS) validatable_attributes_for_type(:presence, atts, opts){|a,v,m| (m) if model.db.send(:blank_object?, v) && v != false} end |
#validates_schema_types(atts = keys, opts = OPTS) ⇒ Object
Validates for all of the model columns (or just the given columns) that the column value is an instance of the expected class based on the column’s schema type.
157 158 159 160 161 162 163 |
# File 'lib/sequel/plugins/validation_helpers.rb', line 157 def validates_schema_types(atts=keys, opts=OPTS) Array(atts).each do |k| if type = schema_type_class(k) validates_type(type, k, {:allow_nil=>true}.merge(opts)) end end end |
#validates_type(klass, atts, opts = OPTS) ⇒ Object
Check if value is an instance of a class. If klass
is an array, the value must be an instance of one of the classes in the array.
167 168 169 170 171 172 173 174 |
# File 'lib/sequel/plugins/validation_helpers.rb', line 167 def validates_type(klass, atts, opts=OPTS) klass = klass.to_s.constantize if klass.is_a?(String) || klass.is_a?(Symbol) validatable_attributes_for_type(:type, atts, opts) do |a,v,m| if klass.is_a?(Array) ? !klass.any?{|kls| v.is_a?(kls)} : !v.is_a?(klass) (m, klass) end end end |
#validates_unique(*atts) ⇒ Object
Checks that there are no duplicate values in the database for the given attributes. Pass an array of fields instead of multiple fields to specify that the combination of fields must be unique, instead of that each field should have a unique value.
This means that the code:
validates_unique([:column1, :column2])
validates the grouping of column1 and column2 while
validates_unique(:column1, :column2)
validates them separately.
You can pass a block, which is yielded the dataset in which the columns must be unique. So if you are doing a soft delete of records, in which the name must be unique, but only for active records:
validates_unique(:name){|ds| ds.filter(:active)}
You should also add a unique index in the database, as this suffers from a fairly obvious race condition.
This validation does not respect the :allow_* options that the other validations accept, since it can deal with a grouping of multiple attributes.
Possible Options:
- :message
-
The message to use (default: ‘is already taken’)
- :only_if_modified
-
Only check the uniqueness if the object is new or one of the columns has been modified.
- :where
-
A callable object where call takes three arguments, a dataset, the current object, and an array of columns, and should return a modified dataset that is filtered to include only rows with the same values as the current object for each column in the array.
If you want to to a case insensitive uniqueness validation on a database that is case sensitive by default, you can use:
:where=>(proc do |ds, obj, cols|
ds.where(cols.map do |c|
v = obj.send(c)
v = v.downcase if v
[Sequel.function(:lower, c), v]
end)
end)
223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 |
# File 'lib/sequel/plugins/validation_helpers.rb', line 223 def validates_unique(*atts) opts = (:unique) if atts.last.is_a?(Hash) opts = opts.merge(atts.pop) end = (opts[:message]) where = opts[:where] atts.each do |a| arr = Array(a) next if arr.any?{|x| errors.on(x)} next if opts[:only_if_modified] && !new? && !arr.any?{|x| changed_columns.include?(x)} ds = if where where.call(model.dataset, self, arr) else vals = arr.map{|x| send(x)} next if vals.any?{|v| v.nil?} model.where(arr.zip(vals)) end ds = yield(ds) if block_given? ds = ds.exclude(pk_hash) unless new? errors.add(a, ) unless ds.count == 0 end end |