Skip to content

Latest commit

 

History

History
96 lines (69 loc) · 3.36 KB

README.md

File metadata and controls

96 lines (69 loc) · 3.36 KB

Validates By Schema (validates_by_schema)

Gem Version Build Status Coverage Status Code Climate

Automatic validation based on your database schema column types and limits. Keep your code DRY by inferring column validations from table properties!

Example

Say you had a table setup like this:

create_table "widgets", force: true do |t|
  t.integer "quantity", limit: 2, null: false
  t.decimal "thickness", precision: 4, scale: 4
  t.string  "color", null: false
  t.boolean "flagged", null: false, default: false
  t.integer "other_id", null: false
  t.index ["other_id", "color"], unique: true
end

Then these validations are inferred when you add validates_by_schema to your model:

validates :quantity, presence: true,
                     numericality: { allow_nil: true,
                                     only_integer: true,
                                     greater_than: -32768,
                                     less_than: 32768}
validates :thickness, numericality: { allow_nil: true,
                                      less_than_or_equal_to: 0.999,
                                      greater_than_or_equal_to: -0.999 }
validates :color, presence: true, length: { allow_nil: true, maximum: 255 }
validates :flagged, inclusion: { in: [true, false], allow_nil: false }
validates :other, presence: true
validates :other_id,
          uniqueness: {
            scope: :color,
            if: -> { |model| model.other_id_changed? || model.color_changed? }
          }

Installation

  1. Add it to your Gemfile:
gem "validates_by_schema"
  1. Then bundle

  2. Call it from your ActiveRecord model:

class Widget < ActiveRecord::Base
  validates_by_schema
end

Usage

You can also whitelist or blacklist columns with :only or :except options, respectively:

validates_by_schema only: [:body, :description]
validates_by_schema except: [:name, :title]

The primary key and timestamp columns are not validated.

If you want to opt out of automatic uniqueness validations globally, add the following line to an initializer:

ValidatesBySchema.validate_uniqueness = false

Notes

Column properties are inferred by your database adapter (like pg, mysql2, sqlite3), and does not depend on migration files or schema.rb. As such, you could use this on projects where the database where Rails is not in control of the database configuration.

This has been tested with mysql, postgresql, and sqlite3. It should work with any other database that has reliable adapter.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/joshwlewis/validates_by_schema.

License

The gem is available as open source under the terms of the MIT License.