module Sequel::Plugins::ConstraintValidations

  1. lib/sequel/plugins/constraint_validations.rb
Parent: Plugins

The constraint_validations plugin is designed to be used with databases that used the constraint_validations extension when creating their tables. The extension adds validation metadata for constraints created, and this plugin reads that metadata and automatically creates validations for all of the constraints. For example, if you used the extension and created your albums table like this:

DB.create_table(:albums) do
  primary_key :id
  String :name
  validate do
    min_length 5, :name
  end
end

Then when you went to save an album that uses this plugin:

Album.create(:name=>'abc')
# raises Sequel::ValidationFailed: name is shorter than 5 characters

Usage:

# Make all model subclasses use constraint validations (called before loading subclasses)
Sequel::Model.plugin :constraint_validations

# Make the Album class use constraint validations
Album.plugin :constraint_validations

Methods

Public Class

  1. apply
  2. configure

Constants

DEFAULT_CONSTRAINT_VALIDATIONS_TABLE = :sequel_constraint_validations  

The default constraint validation metadata table name.

Public Class methods

apply (model, opts=OPTS)

Automatically load the validation_helpers plugin to run the actual validations.

[show source] 
# File lib/sequel/plugins/constraint_validations.rb, line 35
def self.apply(model, opts=OPTS)
  model.instance_eval do
    plugin :validation_helpers
    @constraint_validations_table = DEFAULT_CONSTRAINT_VALIDATIONS_TABLE
    @constraint_validation_options = {}
  end
end
configure (model, opts=OPTS)

Parse the constraint validations metadata from the database. Options:

:constraint_validations_table

Override the name of the constraint validations metadata table. Should only be used if the table name was overridden when creating the constraint validations.

:validation_options

Override/augment the options stored in the database with the given options. Keys should be validation type symbols (e.g. :presence) and values should be hashes of options specific to that validation type.

[show source] 
# File lib/sequel/plugins/constraint_validations.rb, line 52
def self.configure(model, opts=OPTS)
  model.instance_eval do
    if table = opts[:constraint_validations_table]
      @constraint_validations_table = table
    end
    if vos = opts[:validation_options]
      vos.each do |k, v|
        if existing_options = @constraint_validation_options[k]       
          v = existing_options.merge(v)
        end
        @constraint_validation_options[k] = v
      end
    end
    parse_constraint_validations
  end
end