validates_uri_format_of
Rails plugin that provides a validates_uri_format_of
method to ActiveRecord
models.
You can require or disallow certain components of a URI.
Installation
Just add the following line to your environment.rb:
config.gem 'validates_uri_format_of'
Usage
After installing the plugin, it's used like
class User < ActiveRecord::Base
validates_uri_format_of :url,
:allow_nil => true,
:require_fqdn => true
end
Features
-
:schemes
– allowed URI schemes. Default:['http','https']
-
:require_scheme
– Default:true
-
:require_host
– Default:true
-
:require_path
– Default:true
-
:require_fqdn
– enforce a fully qualified domain name? Default:nil
-
:with_port
– Default:nil
-
:with_query
–true
requires a query string (e.g. '?query'),false
does not allow a query string. Default:nil
(no check) -
:with_fragment
–true
requires a fragment string (e.g. '#fragment'),false
does not allow a fragment string. Default:nil
(no check) -
:with_auth
–true
requires authentication info (e.g. 'http://user:pass@example.com/'),false
does not allow a fragment string. Default:nil
(no check) -
:on
– Specifies when this validation is active (default is:save
, other options:create
,:update
). -
:if
– Specifies a method, proc or string to call to determine if the validation should occur (e.g.:if => :allow_validation
, or:if => Proc.new { |user| user.signup_step > 2 }
). The method, proc or string should return or evaluate to a true or false value. -
:unless
– Specifies a method, proc or string to call to determine if the validation should not occur (e.g.:unless => :skip_validation
, or:unless => Proc.new { |user| user.signup_step <= 2 }
). The method, proc or string should return or evaluate to a true or false value.
Do also a look at the lib/ and test/ directories.
Credits and license
By Digineo GmbH under the MIT license.