Project

validates

0.09
No commit activity in last 3 years
No release in over 3 years
validates provides a set of commonly required validators (such as Email, Url, etc.) for Rails applications
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
 Dependencies

Runtime

>= 3.0.0
 Project Readme

Validates Gem Version Build Status Code Climate

Collection of useful custom validators for Rails applications, including:

  • AbsolutePathValidator
  • AssociationLengthValidator
  • ColorValidator
  • EanValidator (EAN-8 & EAN-13)
  • EmailValidator
  • IpValidator
  • MoneyValidator
  • SlugValidator
  • UriComponentValidator
  • UrlValidator

Note InnValidator and other Russian specific validators could be found at validates_russian gem

Installation

Add this line to your application's Gemfile:

gem 'validates'

Or install it yourself as:

$ gem install 'validates'

Usage

For most of the validators you just want to add this line to your model:

validates :attribute, <validator_underscore>: true

where <validator_underscore> is an underscored, lowercase form from the validator's name (see the examples section below).

AssociationLengthValidator

Because this is the successor of ActiveModel::Validations::LengthValidator validator, it inherits all the options of the latter, such as :is, :minimum, :maximum, etc. Another option, which you may be interested in is :select option, which allows you to filter the collection of the associated objects.

Examples

class User < ActiveRecord::Base
  validates :email, :email => true
  validates :site, :url => true, :allow_blank => true
end

class Company < ActiveRecord::Base
  # note AssociationLengthValidator is inherited from ActiveModel::Validations::LengthValidator
  # http://api.rubyonrails.org/classes/ActiveModel/Validations/LengthValidator.html
  # so you can easily use standard options like :is, :minimum, :maximum, etc.

  validates :employees,
  :association_length => {
    :minimum => 1,
    :select => ->(employee) { employee.name.in? ["Mike", "John"] }
  }

  validates :employees, :association_length => { :minimum => 1, :select => :employees_filter }

  def employees_filter(employees)
    employees.select { |employee| employee.name.in? ["Mike", "John"] }
  end
end

class Page < ActiveRecord::Base
  validates :slug, :slug => true
end

class Content < ActiveRecord::Base
  # Validates URI component.
  # URI component must be of the following type:
  # :ABS_URI, :REL_URI, :URI_REF, :ABS_URI_REF, :REL_URI_REF, :ESCAPED, :UNSAFE, :SCHEME,
  # :USERINFO, :HOST, :PORT, :OPAQUE, :REGISTRY, :ABS_PATH, :REL_PATH, :QUERY or :FRAGMENT.
  # These types are provided URI library. For more info see URI::DEFAULT_PARSER.regexp.

  validates :path, :uri_component => { :component => :ABS_PATH }
end

Contributing

Please see CONTRIBUTING.md for details.

Credits

Originally written by Mikhail Stolbov. Maintained by kaize.

Thank you to all our amazing contributors!

License

validates is Copyright © 2012-2014 Mikhail Stolbov and kaize. It is free software, and may be redistributed under the terms specified in the LICENSE file.