Validates URL

This gem adds the capability of validating URLs to ActiveRecord and ActiveModel (Rails 3).

Installation

# add this to your Gemfile
gem 'validate_url',
  :git => 'git@github.com:zapo/validates_url.git'

# and  run
sudo gem install validate_url

Usage

With ActiveRecord

class Pony < ActiveRecord::Base
  # standard validation
  validates :homepage, :url => true

  # with allow_nil
  validates :homepage, :url => {:allow_nil => true}

  # with allow_blank
  validates :homepage, :url => {:allow_blank => true}

  # without local hostnames
  validates :homepage, :url => {:no_local => true}

  # host against public suffix database https://publicsuffix.org/
  validates :homepage, :url => {:public_suffix => true}

  # without pre query
  validates :homepage, :url => {:no_pre_query => true}
end

With ActiveModel

class Unicorn
  include ActiveModel::Validations

  attr_accessor :homepage

  # with legacy syntax (the syntax above works also)
  validates_url :homepage, :allow_blank => true
end

I18n

The default error messages can be found in lib/locale/en.yml. From the master branch, only English messages are provided. For default messages in other languages, use the latest commit before specific error messages were provided:

# Gemfile, below what you added in the installation section above
commit: 7076b190cf74fcc490daecc44d7f4e3fcba50a9f

You can pass the :message => "my custom error" option to your validation to define your own, custom message.

Contributing

Big thanks to Tanel Suurhans, Tarmo Lehtpuu, Steve Smith and all the contributors! We appreciate all your work on new features and bugfixes.

Testing

Run tests:

rspec spec/validate_url_spec.rb

Run one test by specifying the line number it starts at:

rspec spec/validate_url_spec.rb:79

Credits

Validates URL is created and maintained by PerfectLine, LLC.

License

Validates URL is Copyright © 2010-2014 PerfectLine, LLC. It is free software, and may be redistributed under the terms specified in the LICENSE file.