validates_formatting_of 0.2.0 → 0.2.1

data/README.markdown

@@ -1,10 +1,10 @@
-# validates_formatting_of
+# validates_formatting_of [![Build Status](https://secure.travis-ci.org/mattdbridges/validates_formatting_of.png)](http://travis-ci.org/mattdbridges/validates_formatting_of)
 
-The *validates_formatting_of" gem addess several convenient methods to validating things such as emails, urls, and phones in a Rails application.
+The `validates_formatting_of` gem addess several convenient methods to validating things such as emails, urls, and phones in a Rails application.
 
 # Installation
 
-To install *validates_formatting_of*, add the following to your `Gemfile`:
+To install `validates_formatting_of`, add the following to your `Gemfile`:
 
     gem 'validates_formatting_of'
 
@@ -26,11 +26,64 @@ This call will ensure that the user-provided email is a valid email. This way, y
 
 `validates_formatting_of` has support for the following validations:
 
-* Email
-* URL
-* Alpha-only
-* Alphanumeric
-* Credit Card (Visa, Mastercard, Discver, and American Express)
-* US Zipcodes
-* US Phone numbers
-* IP Address
+### Email
+
+    class User < ActiveRecord::Base
+      validates_formatting_of :email, :using => :email
+    end
+
+### URL
+
+    class Sites < ActiveRecord::Base
+      validates_formatting_of :website, :using => :url
+    end
+
+### Alpha
+
+    class Name < ActiveRecord::Base
+      validates_formatting_of :first_name, :using => :alpha
+    end
+
+### Alphanumeric
+
+    class Sites < ActiveRecord::Base
+      validates_formatting_of :text, :using => :alphanum
+    end
+
+### Credit Card (Visa, Mastercard, Discver, and American Express)
+
+    class Purchases < ActiveRecord::Base
+      validates_formatting_of :cc, :using => :credit_card
+    end
+    
+### US Zipcodes
+
+    class Location < ActiveRecord::Base
+      validates_formatting_of :zipcode, :using => :us_zip
+    end
+    
+### US Phone numbers
+
+    class Phones < ActiveRecord::Base
+      validates_formatting_of :phone, :using => :us_phone
+    end
+    
+### IP Address
+
+    class Location < ActiveRecord::Base
+      validates_formatting_of :website, :using => :url
+    end
+    
+# Customizable
+
+If, for any reason, you want to use your own regex instead of Rail's built-in methods, you can specify what you want to use with the `:regex` option. For example,
+
+
+    class Person < ActiveRecord::Base
+      validates_formatting_of :first_name, :regex => /[A-Z]/i
+    end
+
+# Development and Contribution
+
+It is very easy to contribute to this gem. Full documentation to do so will be added in the near future.
+    

data/lib/validates_formatting_of/model_additions.rb

@@ -16,13 +16,13 @@ module ValidatesFormattingOf
       validates_format_of attribute, :with => regex_for_validation, :message => opts[:message]
     end
 
-    # Actually retrieve the regex to check against
     def validate_with(method)
+      # Actually retrieve the regex to check against
       formatting.send(method)
     end
 
-    # Grab the validating methods
     def formatting
+      # Grab the validating methods
       @formatting ||= ValidatingMethods.new
     end
   end

data/lib/validates_formatting_of/version.rb

@@ -1,3 +1,3 @@
 module ValidatesFormattingOf
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

data/spec/validates_formatting_of/model_additions_spec.rb

@@ -81,4 +81,49 @@ describe ValidatesFormattingOf::ModelAdditions do
     end
 
   end
+  describe "us_phone" do
+    
+    class IPAddress < SuperModel::Base
+      validates_formatting_of :ip, :using => :ip_address
+    end
+    it "validates that the email provided is valid" do
+      IPAddress.new(:ip => '10.10.10').should_not be_valid
+      IPAddress.new(:ip => '999.10.10.20').should_not be_valid
+      IPAddress.new(:ip => '2222.22.22.22').should_not be_valid
+      IPAddress.new(:ip => '22.2222.22.2').should_not be_valid
+      IPAddress.new(:ip => '127.0.0.1').should be_valid
+      IPAddress.new(:ip => '132.254.111.10').should be_valid
+    end
+
+  end
+  describe "us_phone" do
+    
+    class IPAddress < SuperModel::Base
+      validates_formatting_of :ip, :using => :ip_address
+    end
+    it "validates that the email provided is valid" do
+      IPAddress.new(:ip => '10.10.10').should_not be_valid
+      IPAddress.new(:ip => '999.10.10.20').should_not be_valid
+      IPAddress.new(:ip => '2222.22.22.22').should_not be_valid
+      IPAddress.new(:ip => '22.2222.22.2').should_not be_valid
+      IPAddress.new(:ip => '127.0.0.1').should be_valid
+      IPAddress.new(:ip => '132.254.111.10').should be_valid
+    end
+
+  end  
+  # For clarification, NONE of the following numbers are real credit card numbers.
+  # They only match the pattern. These were randomly made for testing.
+  describe "credit_card" do
+    
+    class Client < SuperModel::Base
+      validates_formatting_of :cc, :using => :credit_card
+    end
+    it "validates that the email provided is valid" do
+      Client.new(:cc => '4264-2879-1230-0000').should be_valid # Visa style
+      Client.new(:cc => '6011-1111-0000-2391').should be_valid # Discover style
+      Client.new(:cc => '5422434400828888').should be_valid # Mastercard style
+      Client.new(:cc => '1233444444444444').should_not be_valid # fake
+    end
+
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: validates_formatting_of
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-11-29 00:00:00.000000000 Z
+date: 2011-11-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70227849493380 !ruby/object:Gem::Requirement
+  requirement: &70104641807780 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70227849493380
+  version_requirements: *70104641807780
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70227849492920 !ruby/object:Gem::Requirement
+  requirement: &70104641807320 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70227849492920
+  version_requirements: *70104641807320
 - !ruby/object:Gem::Dependency
   name: supermodel
-  requirement: &70227849492420 !ruby/object:Gem::Requirement
+  requirement: &70104641806840 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,7 +43,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70227849492420
+  version_requirements: *70104641806840
 description: Common Rails validations for different types of data
 email:
 - mbridges.91@gmail.com