validates_as_phone_number 0.7.5

data/CHANGELOG

@@ -0,0 +1,10 @@
+0.7.3 - Aug 15th, 2008
+ *  Gem'ified plugin
+ *  Move to github
+
+0.2.0 - Jan 30th, 2008
+ *  RegEx was updated to accomodate different delimiters and extensions
+ *  length of extension increased to allow 7 digits
+
+0.1.0 - Aug 25th, 2006
+ *  First release

data/LICENSE

@@ -0,0 +1,5 @@
+Licensing terms follow:
+ 
+This software is placed under the Creative Commons Attribution-Share ALike 3.0 Unported License
+
+http://creativecommons.org/licenses/by-sa/3.0/

data/README

@@ -0,0 +1,43 @@
+ValidatesAsPhoneNumber
+======================
+
+This Ruby on Rails plugin/gem implements an ActiveRecord validation helper called
+validates_as_phone_number which validates U.S. phone numbers. The helper acts as
+if validates_format_of was used with a regular expression that defines:
+
+(000) 000 0000
+(000) 000-0000
+000.000.0000
+000-000-0000
+000-0000
+000-000-0000x000 (extension can be up to 7 digits)
+000-000-0000 x1234567 (extension can be up to 7 digits with or without leading space before 'x')
+000-0000x000 (extension can be up to 7 digits)
+
+
+Installation:
+=============
+gem sources -a http://gems.github.com
+
+Install the gem(s):
+sudo gem install gbdev-validates_as_phone_number
+
+Add to environment.rb initializer block:
+config.gem 'gbdev-validates_as_phone_number', :version => '>=0.7.5', :lib => 'validates_as_phone_number', :source => 'http://gems.github.com'
+
+
+Usage:
+======
+In your model file do something like:
+
+class MyClass < ActiveRecord::Base
+  validates_as_phone_number :work_phone, :message => 'Invalid work phone number format', :allow_nil => true
+end
+
+Tests:
+======
+Some tests have been added.
+
+License:
+========
+See the LICENSE file.

data/Rakefile

@@ -0,0 +1,23 @@
+require 'rubygems'
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the validates_as_phone_number plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the validates_as_phone_number plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'ValidatesAsPhoneNumber'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/init.rb

@@ -0,0 +1 @@
+require 'validates_as_phone_number'

data/lib/validates_as_phone_number.rb

@@ -0,0 +1,34 @@
+#
+# Made this a plugin because there was not one out there yet. (yes I did an exhaustive search)
+#
+# Licensed under a Creative Commons Attribution-ShareAlike 2.5 License
+# http://creativecommons.org/licenses/by-sa/2.5/
+# 
+
+# Validation helper for ActiveRecord derived objects that cleanly and simply
+# allows the model to check if the given string is a valid US phone number
+# in the form 000-000-0000, 000-0000 (delimiter may be space, hyphen or period and area code can have parentheses).
+# For extensions: 000-000-0000 x12345 or 000-0000 x1234567 
+# Extensions can be up to 7 digits (valid with or without leading space before 'x')
+#
+
+module ActiveRecord
+  module Validations
+    module ClassMethods
+      def validates_as_phone_number(*attr_names)
+        regExpStr = '(([0-9]{3})|((\()([0-9]{3})(\))))?([\s\.-])?([0-9]{3})([\s\.-])?([0-9]{4})([\s\.-])?([x] ?[0-9]{1,7})?'
+        configuration = {
+          :message   => 'is an invalid phone number',
+          :with      => /^#{regExpStr}$/,
+          :allow_nil => false }
+          
+        configuration.update(attr_names.pop) if attr_names.last.is_a?(Hash)
+        
+        configuration[:with] = /^(#{regExpStr})?$/ if configuration[:allow_nil]
+
+        validates_format_of attr_names, configuration
+      end
+    end
+  end
+end
+

data/test/validates_as_phone_number_test.rb

@@ -0,0 +1,78 @@
+require 'test/unit'
+
+begin
+  require File.dirname(__FILE__) + '/../../../../config/boot'
+  require 'active_record'
+  require 'validates_as_phone_number'
+rescue LoadError
+  require 'rubygems'
+  require 'activerecord'
+  require File.dirname(__FILE__) + '/../lib/validates_as_phone_number'
+end
+
+class TestRecord < ActiveRecord::Base
+  def self.columns; []; end
+  attr_accessor :phone_number
+  validates_as_phone_number :phone_number, :allow_nil => false # false is default
+end
+
+class TestRecord2 < ActiveRecord::Base
+  def self.columns; []; end
+  attr_accessor :phone_number
+  validates_as_phone_number :phone_number, :allow_nil => true
+end
+
+class ValidatesAsPhoneNumberTest < Test::Unit::TestCase
+
+  def test_valid_phone_numbers
+    phone_numbers = [
+      '3219876',
+      '800.321.9876',
+      '8003219876',
+      '321-9876',
+      '800-321-9876',
+      '321-9876x12345',
+      '800-321-9876x1',
+      '800-321-9876x 1',
+      '800-321-9876x1234567',
+      '800-321-9876 x1',
+      '800-321-9876 x 1',
+      '800-321-9876 x1234567',
+      '(800)-321-9876',
+      '(800) 321-9876'
+      ]
+    phone_numbers.each do |number|
+      assert TestRecord.new(:phone_number => number).valid?, "#{number} should be valid."
+    end
+  end
+  
+  def test_invalid_phone_numbers
+    phone_numbers = [
+      '(800 321-9876',
+      '800) 321-9876',
+      '321-9876x1234567890234',
+      '800-321-9876x',
+      '800-321-98761',
+      '800-321-9876 x',
+      '800-321-9876 xa',
+      '800a321-9876',
+      '800-321-9876x12345678',
+      '800-321-9876 x12345678'
+      ]
+    phone_numbers.each do |number|
+      assert !TestRecord.new(:phone_number => number).valid?, "#{number} should be invalid."
+    end
+  end  
+  
+  def test_blank_phone_number_not_allowed
+    assert !TestRecord.new(:phone_number => nil).valid?, "Blank phone number should be invalid."
+    assert !TestRecord.new(:phone_number => '').valid?, "Blank phone number should be invalid."
+  end  
+  
+  def test_blank_phone_number_allowed
+    assert TestRecord2.new(:phone_number => nil).valid?, "Blank phone number should be valid."
+    assert TestRecord2.new(:phone_number => '').valid?, "Blank phone number should be valid."
+  end  
+  
+end
+

metadata

@@ -0,0 +1,66 @@
+--- !ruby/object:Gem::Specification 
+name: validates_as_phone_number
+version: !ruby/object:Gem::Version 
+  version: 0.7.5
+platform: ruby
+authors: 
+- Wes Hays
+- John Dell
+- Josh Susser
+- Brandon Keene
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-01-27 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: Rails gem that implements an ActiveRecord validation helper called validates_as_phone_number which validates U.S. phone numbers
+email: 
+- gems@gbdev.com
+- opensource@pivotallabs.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- CHANGELOG
+- LICENSE
+- README
+- Rakefile
+- init.rb
+- lib/validates_as_phone_number.rb
+- test/validates_as_phone_number_test.rb
+has_rdoc: true
+homepage: http://github.com/gbdev/validates_as_phone_number
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Rails gem to validate format of U.S. phone numbers
+test_files: 
+- test/validates_as_phone_number_test.rb