validatious 0.1.0

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format=progress

data/Gemfile

@@ -0,0 +1,4 @@
+source 'http://rubygems.org'
+
+# Specify your gem's dependencies in validatious.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2011 Joel Moss
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,75 @@
+Validatious -- A collection of delicious Rails validators
+=========================================================
+
+## DESCRIPTION
+
+No matter what app you are working on, Rails never seems to include all the
+validations you need, and you end having to repeat yourself over and over by
+writing regex validations and/or custom validators.
+
+Validatious solves this problem by packaging up all these often used, but
+missing Rails validators, into one single RubyGem.
+
+
+## INSTALLATION
+
+The best way to install Validatious is with RubyGems:
+
+    $ [sudo] gem install validatious
+
+If you're installing from source, you can use [Bundler][bundler] to pick up all the
+gems:
+
+    $ bundle install # ([more info](http://gembundler.com/bundle_install.html))
+
+[bundler]: http://gembundler.com/
+
+
+## USAGE
+
+All the validators in Validatious are designed to work with Rails 3 and up, and
+take advantage of ActiveModel::Validator. This means that they are all used in the
+usual Rails way:
+
+    validates :url, :url => true
+    
+The old Rails 2 style validations are also supported:
+
+    validates_url_format_of :url
+    
+    
+## Validations
+
+Validatious currently provides the following validators:
+
+
+### URL
+
+This validates the format of a URL, ensuring that the attribute conforms to the
+correct format of a URL.
+
+    validates :url, :url => true  
+
+or
+
+    validates_url_format_of :url
+
+
+## CONTRIBUTE
+
+If you'd like to hack on Validatious, start by forking my repo on GitHub:
+
+http://github.com/joelmoss/validatious
+
+To get all of the dependencies, install the gem first. The best way to get
+your changes merged back into core is as follows:
+
+1. Clone down your fork
+1. Create a thoughtfully named topic branch to contain your change
+1. Hack away
+1. Add tests and make sure everything still passes by running `rake`
+1. If you are adding new functionality, document it in the README
+1. Do not change the version number, I will do that on my end
+1. If necessary, rebase your commits into logical chunks, without errors
+1. Push the branch up to GitHub
+1. Send a pull request to the joelmoss/validatious project.

data/Rakefile

@@ -0,0 +1,8 @@
+#!/usr/bin/env rake
+require 'bundler/gem_tasks'
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/lib/validatious/helper_methods.rb

@@ -0,0 +1,11 @@
+module ActiveModel
+  module Validations
+    module HelperMethods
+
+      def validates_url_format_of(*attr_names)
+        validates_with UrlValidator, _merge_attributes(attr_names)
+      end
+      
+    end
+  end
+end

data/lib/validatious/locale/en.yml

@@ -0,0 +1,4 @@
+en:
+  errors:
+    messages:
+      invalid_url: "is not a valid URL"

data/lib/validatious/validators/url_validator.rb

@@ -0,0 +1,26 @@
+module Validatious
+  module Validators
+    
+    # == Active Model Url Validator
+    class UrlValidator < ActiveModel::EachValidator
+      IPv4_PART = /\d|[1-9]\d|1\d\d|2[0-4]\d|25[0-5]/  # 0-255
+      REGEX = %r{
+        \A
+        https?://                                        # http:// or https://
+        ([^\s:@]+:[^\s:@]*@)?                            # optional username:pw@
+        ( (xn--)?[a-z0-9]+([-.][a-z0-9]+)*\.[a-z]{2,6}\.? |  # domain (including Punycode/IDN)...
+            #{IPv4_PART}(\.#{IPv4_PART}){3} )            # or IPv4
+        (:\d{1,5})?                                      # optional port
+        ([/?]\S*)?                                       # optional /whatever or ?whatever
+        \Z
+      }iux
+      
+      def validate_each(record, attribute, value)
+        record.errors.add(attribute, :invalid_url, options) if value.to_s !~ REGEX
+      end
+    end
+  end
+end
+
+# Compatibility with ActiveModel validates method which matches option keys to their validator class
+ActiveModel::Validations::UrlValidator = Validatious::Validators::UrlValidator

data/lib/validatious/version.rb

@@ -0,0 +1,3 @@
+module Validatious
+  VERSION = "0.1.0"
+end

data/lib/validatious.rb

@@ -0,0 +1,13 @@
+require "validatious/version"
+
+module Validatious
+  module Validators
+    # nothing to see here, move along...
+  end
+end
+
+require "validatious/validators/url_validator"
+require "validatious/helper_methods"
+
+require 'active_support/i18n'
+I18n.load_path << File.dirname(__FILE__) + '/validatious/locale/en.yml'

data/spec/spec_helper.rb

@@ -0,0 +1,18 @@
+require 'active_model'
+require "validatious"
+
+# Requires supporting ruby files with custom matchers and macros, etc,
+# in spec/support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each { |f| require f }
+
+RSpec.configure do |config|
+  config.mock_with :rspec
+  
+  config.before(:all) do
+    DeferredGarbageCollection.start
+  end
+
+  config.after(:all) do
+    DeferredGarbageCollection.reconsider
+  end
+end

data/spec/support/deferred_garbage_collection.rb

@@ -0,0 +1,21 @@
+# Taken from http://makandra.com/notes/950-speed-up-rspec-by-deferring-garbage-collection
+class DeferredGarbageCollection
+
+  DEFERRED_GC_THRESHOLD = (ENV['DEFER_GC'] || 10.0).to_f
+
+  @@last_gc_run = Time.now
+
+  def self.start
+    GC.disable if DEFERRED_GC_THRESHOLD > 0
+  end
+
+  def self.reconsider
+    if DEFERRED_GC_THRESHOLD > 0 && Time.now - @@last_gc_run >= DEFERRED_GC_THRESHOLD
+      GC.enable
+      GC.start
+      GC.disable
+      @@last_gc_run = Time.now
+    end
+  end
+
+end

data/spec/support/models/post.rb

@@ -0,0 +1,13 @@
+class Post
+  include ActiveModel::Validations
+  include ActiveModel::Validations::Callbacks
+
+  attr_accessor :title, :url
+
+  def initialize(attributes = {})
+    attributes.each do |key, value|
+      send "#{key}=", value
+    end
+  end
+
+end

data/spec/validatious/helper_methods_spec.rb

@@ -0,0 +1,9 @@
+require "spec_helper"
+
+describe Validatious, 'HelperMethods' do
+  
+  it 'should define class validation methods' do
+    Post.should respond_to(:validates_url_format_of)
+  end
+  
+end

data/spec/validatious/validators/url_spec.rb

@@ -0,0 +1,68 @@
+# encoding: utf-8
+
+require "spec_helper"
+
+describe Validatious::Validators::UrlValidator do
+  
+  before(:each) do
+    Post.validates_url_format_of(:url)
+  end
+  
+  let(:post) { post = Post.new(:title => "The title", :url => "invalid URL") }
+  
+  [
+    'http://example.com',
+    'http://example.com/',
+    'http://www.example.com/',
+    'http://sub.domain.example.com/',
+    'http://bbc.co.uk',
+    'http://example.com?foo',
+    'http://example.com?url=http://example.com',
+    'http://example.com:8000',
+    'http://www.sub.example.com/page.html?foo=bar&baz=%23#anchor',
+    'http://user:pass@example.com',
+    'http://user:@example.com',
+    'http://example.com/~user',
+    'http://example.xy',  # Not a real TLD, but we're fine with anything of 2-6 chars
+    'http://example.museum',
+    'http://1.0.255.249',
+    'http://1.2.3.4:80',
+    'HttP://example.com',
+    'https://example.com',
+    # 'http://räksmörgås.nu',  # IDN
+    'http://xn--rksmrgs-5wao1o.nu',  # Punycode
+    'http://example.com.',  # Explicit TLD root period
+    'http://example.com./foo'
+  ].each do |url|  
+    describe url.inspect do
+      it "should be valid" do
+        post.url = url
+        post.should be_valid
+      end
+    end
+  end
+  
+  [
+    nil, 1, "", " ", "url",
+    "www.example.com",
+    "http://ex ample.com",
+    "http://example.com/foo bar",
+    'http://256.0.0.1',
+    'http://u:u:u@example.com',
+    'http://r?ksmorgas.com',
+    
+    # These can all be valid local URLs, but should not be considered valid
+    # for public consumption.
+    "http://example",
+    "http://example.c",
+    'http://example.toolongtld'
+  ].each do |url|  
+    describe url.inspect do
+      it "should not be valid" do
+        post.url = url
+        post.should_not be_valid
+      end
+    end
+  end
+  
+end

data/validatious.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/validatious/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Joel Moss"]
+  gem.email         = ["joel@developwithstyle.com"]
+  gem.description   = %q{A collection of delicious Rails validators}
+  gem.summary       = %q{A collection of delicious Rails validators}
+  gem.homepage      = 'https://github.com/joelmoss/validatious'
+
+  gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  gem.files         = `git ls-files`.split("\n")
+  gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  gem.name          = "validatious"
+  gem.require_paths = ['lib']
+  gem.version       = Validatious::VERSION
+  
+  gem.add_dependency 'activemodel'
+  
+  gem.add_development_dependency "rspec"
+end

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification 
+name: validatious
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Joel Moss
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-06-28 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activemodel
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id002
+description: A collection of delicious Rails validators
+email: 
+- joel@developwithstyle.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/validatious.rb
+- lib/validatious/helper_methods.rb
+- lib/validatious/locale/en.yml
+- lib/validatious/validators/url_validator.rb
+- lib/validatious/version.rb
+- spec/spec_helper.rb
+- spec/support/deferred_garbage_collection.rb
+- spec/support/models/post.rb
+- spec/validatious/helper_methods_spec.rb
+- spec/validatious/validators/url_spec.rb
+- validatious.gemspec
+has_rdoc: true
+homepage: https://github.com/joelmoss/validatious
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.9.1
+signing_key: 
+specification_version: 3
+summary: A collection of delicious Rails validators
+test_files: 
+- spec/spec_helper.rb
+- spec/support/deferred_garbage_collection.rb
+- spec/support/models/post.rb
+- spec/validatious/helper_methods_spec.rb
+- spec/validatious/validators/url_spec.rb