ActiveValidators

Description

ActiveValidators is a collection of off-the-shelf and tested ActiveModel/ActiveRecord validations.

Installation

gem install activevalidators

This projects follows Semantic Versioning a.k.a SemVer. If you use Bundler, you can use the stabby specifier ~> safely.

Usage

In your models, the gem provides new validators like email, or url:

    class User
      validates :email_address, :email => true # == :email => { :strict => false }
      validates :link_url,      :url   => true
      validates :user_phone,    :phone => true
      validates :company_siren, :siren => true
      validates :password,      :password => { :strength => :medium }
      validates :twitter_at,    :twitter => { :format => :username_with_at }
      validates :twitter_url,   :twitter => { :format => :url }
      validates :twitter,       :twitter => true
      validates :postal_code,   :postal_code => { :country => :us }
      validates :ssn,           :ssn => true
      validated :sin,           :sin => true
    end

    class Article
      validates :slug,          :slug => true
      validates :expiration_date,
                      :date => {
                                 :after => lambda { Time.now },
                                 :before => lambda { Time.now + 1.year }
                               }
    end

    class Device
      validates :ipv6,          :ip => { :format => :v6 }
      validates :ipv4,          :ip => { :format => :v4 }
    end

    class Account
      validates :any_card,      :credit_card => true
      validates :visa_card,     :credit_card => { :type => :visa }
      validates :credit_card,   :credit_card => { :type => :any  }
    end

    class Order
      validates :tracking_num,  :tracking_number => { :carrier => :ups }
    end

Exhaustive list of supported validators and their implementation:

• credit_card : based on the Luhn algorithm
• date : based on the DateValidator gem
• email : based on the mail gem
• ip : based on Resolv::IPv[4|6]::Regex
• password : based on a set of regular expressions
• phone : based on a set of predefined masks
• postal_code: based on a set of predefined masks
• respond_to
• siren
• slug : based on ActiveSupport::String#parameterize
• sin : Social Insurance Number (only for Canada). You also can allow permanent residents cards (such cards start with '9'): :sin => {:country => :canada, :country_options => {allow_permanent_residents: true}}
• ssn : Social Security Number (only for USA). You also may pass type, instead of boolean: :ssn => {:type => :usa_ssn} as the alternative.
• tracking_number: based on a set of predefined masks
• twitter : based on a regular expression
• url : based on a regular expression

Todo

Lots of improvements can be made:

• Implement new validators
• ...

Note on Patches/Pull Requests

• Fork the project.
• Make your feature addition or bug fix.
• Add tests for it. This is important so I don't break it in a future version unintentionally.
• Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
• Send me a pull request. Bonus points for topic branches.

Contributors

• Franck Verrot
• Oriol Gual
• Paco Guzmán
• Garrett Bjerkhoel
• Renato Riccieri Santos Zannon
• Brian Moseley
• Travis Vachon
• Rob Zuber
• Manuel Menezes de Sequeira
• Serj L aka Loremaster

Copyright

Copyright (c) 2010-2014 Franck Verrot. MIT LICENSE. See LICENSE for details.