Validatious -- A collection of delicious Rails validators

No matter what app you are working on, Rails never seems to include all the validations you need, and you end having to repeat yourself over and over by writing regex validations and/or custom validators.

Validatious solves this problem by packaging up all these often used, but missing Rails validators, into one single RubyGem.

INSTALLATION

The best way to install Validatious is with RubyGems:

$ [sudo] gem install validatious

If you're installing from source, you can use Bundler to pick up all the gems:

$ bundle install # ([more info](http://gembundler.com/bundle_install.html))

USAGE

All the validators in Validatious are designed to work with Rails 3 and up, and take advantage of ActiveModel::Validator. This means that they are all used in the usual Rails way:

validates :url, :url => true

The old Rails 2 style validations are also supported:

validates_url_format_of :url

Validations

Validatious currently provides the following validators:

URL

This validates the format of a URL, ensuring that the attribute conforms to the correct format of a URL.

validates :url, :url => true  

or

validates_url_format_of :url

Email

This validates the format of an email address, ensuring that the attribute conforms to the correct format of an email address.

validates :email, :email => true  

or

validates_email_format_of :email

Postal Code

This validates the format of a postal code address, ensuring that the attribute conforms to the correct format as specified by the given country (default: US).

validates :zip, :postal_code => true

or specify a different country

validates :zip, :postal_code => { :country => 'UK' }

or validate for several countries

validates :zip, :postal_code => { :country => [ 'US', 'CA' ] }

or

validates_postal_code_format_of :zip

Text Content

Extracted from validates_text_content, this validates the content of a text attribute, to determine whether or not a block of English text meets certain quality standards.

validates :comment, :text_content => true  

or

validates_text_content_of :comment

Examples

• Rejects:

  • "this comment has absolutely no capitalization."
  • "This comment has no type of punctuation"
  • "Fdkjd dk dkkjhd kjdhkjd kjdhdhdl alkasla lka alk"
  • "THIS COMMENT IS ALL IN UPPERCASE. ME NO WANT!"
  • "Thiscommenthasabsolutelynospacesthereisnowaythisisgood."
  • "THIS COMMENT is MORE THAN 80% CAPITALS."
  • "THIS pERSON hAS tHEIR cAPS-lOCK oN."

• Accepts:

  • "This is a very simple test comment."
  • "Supercalifragilisticexpialadocious: a super long word!"
  • "How many words can I think of that don't contain an 'e'?"

CONTRIBUTE

If you'd like to hack on Validatious, start by forking my repo on GitHub:

http://github.com/joelmoss/validatious

To get all of the dependencies, install the gem first. The best way to get your changes merged back into core is as follows:

1. Clone down your fork
2. Create a thoughtfully named topic branch to contain your change
3. Hack away
4. Add tests and make sure everything still passes by running rake
5. If you are adding new functionality, document it in the README
6. Do not change the version number, I will do that on my end
7. If necessary, rebase your commits into logical chunks, without errors
8. Push the branch up to GitHub
9. Send a pull request to the joelmoss/validatious project.