Skip to content

sarcx/activevalidators

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ActiveValidators Travis

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.

About

Collection of ActiveModel/ActiveRecord validators

Resources

License

Stars

Watchers

Forks

Packages

No packages published