Validation on URL attributes for ActiveRecord models.
Ruby
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
test
.gitignore
Gemfile
LICENSE
README.rdoc
Rakefile
has_url.gemspec

README.rdoc

HasUrl

Adds validations on URL attributes for ActiveRecord models. URL scheme will be checked and added before updating the database if necessary. A raw_#{attribute} method will also be added to display the url without HTTP(S) scheme or trailing slash.

Usage

In your AR model:

has_url :attribute, options

Options :

  • valid_schemes : Array of schemes or single scheme accepted for the attribute. Default ['http', 'https']

  • default_scheme : Scheme appended to the attribute if none found (supply the scheme string without '://'). Default 'http'

  • message : Provide a error string or symbol (which will be translated, see ActiveRecord::Errors#generate_message). Default :invalid

Example

class Person < ActiveRecord::Base
  has_url :blog_link
end

person.blog_link = 'example.com'
person.save
person.blog_link #=> 'http://example.com/'
person.raw_blog_link #=> 'example.com'

class Person < ActiveRecord::Base
  has_url [:blog_link, :website_url], :default_scheme => 'https', :valid_schemes => ['http', 'https', 'ftp']
end

Requirements

  • Addressable for URI parsing

TODO

  • Refactor using ActiveModel::Validator

  • More tests

  • Improve the raw_ method stripping, and have it accept an option to specify which schemes to strip (schemes array or boolean to strip all valid schemes)

  • Add a shoulda macro (should_have_url)

  • Check existence of the given attributes ?

  • Optionally test the url validity with an HTTP request ?

Notes and Copyright

This plugin was inspired by the url_validation and validates_url_of plugins.

Copyright © 2012 Pickabee. Released under the MIT licence, see LICENSE for details.