validates_as_postal_code 0.5.1

data/CHANGELOG

@@ -0,0 +1,3 @@
+0.5.1 -  August 15, 2008
+ - move to github
+ - gem'ified

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,36 @@
+ValidatesAsPostalCode
+=====================
+
+This Ruby on Rails plugin/gem implements an ActiveRecord validation helper called
+validates_as_postal_code which validates U.S. postal codes. The helper acts as if
+validates_format_of was used with a regular expression that defines:
+
+00000
+00000-0000
+
+
+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_postal_code', :version => '>=0.5.0', :lib => 'validates_as_postal_code', :source => 'http://gems.github.com'
+
+Usage:
+======
+In your model file do something like:
+
+class MyClass < ActiveRecord::Base
+  validates_as_postal_code :postal_code, :message => 'Invalid Postal Code', :allow_nil => true
+end
+
+Tests:
+======
+Some tests have been added.
+
+License:
+========
+See the LICENSE file.

data/Rakefile

@@ -0,0 +1,22 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the validates_as_postal_code 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_postal_code plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'ValidatesAsPostalCode'
+  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_postal_code'

data/lib/validates_as_postal_code.rb

@@ -0,0 +1,26 @@
+# 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 postal code
+# in the form 00000 or 00000-0000
+
+module ActiveRecord
+  module Validations
+    module ClassMethods
+      def validates_as_postal_code(*attr_names)
+        regExpStr = '\d{5}(-\d{4})?'
+        configuration = {
+          :message   => 'is an invalid postal code',
+          :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_postal_code_test.rb

@@ -0,0 +1,61 @@
+require 'test/unit'
+
+begin
+  require File.dirname(__FILE__) + '/../../../../config/boot'
+  require 'active_record'
+  require 'validates_as_postal_code'
+rescue LoadError
+  require 'rubygems'
+  require 'activerecord'
+  require File.dirname(__FILE__) + '/../lib/validates_as_postal_code'
+end
+
+class TestRecord < ActiveRecord::Base
+  def self.columns; []; end
+  attr_accessor :postal_code
+  validates_as_postal_code :postal_code, :allow_nil => false # false is default
+end
+
+class TestRecord2 < ActiveRecord::Base
+  def self.columns; []; end
+  attr_accessor :postal_code
+  validates_as_postal_code :postal_code, :allow_nil => true
+end
+
+class ValidatesAsPostalCodeTest < Test::Unit::TestCase
+
+  def test_valid_postal_codes
+    postal_codes = [
+      '89511',
+      '89511-1000'
+      ]
+    postal_codes.each do |code|
+      assert TestRecord.new(:postal_code => code).valid?, "#{code} should be legal."
+    end
+  end
+  
+  def test_invalid_postal_codes
+    postal_codes = [
+      '895112',
+      '8951',
+      '895110044',
+      '89511-00001',
+      '8951X'
+      ]
+    postal_codes.each do |code|
+      assert !TestRecord.new(:postal_code => code).valid?, "#{code} should be illegal."
+    end
+  end  
+  
+  def test_blank_postal_code_not_allowed
+    assert !TestRecord.new(:postal_code => nil).valid?, "Blank postal code should be illegal."
+    assert !TestRecord.new(:postal_code => '').valid?, "Blank postal code should be illegal."
+  end  
+  
+  def test_blank_postal_code_allowed
+    assert TestRecord2.new(:postal_code => nil).valid?, "Blank postal code should be legal."
+    assert TestRecord2.new(:postal_code => '').valid?, "Blank postal code should be legal."
+  end  
+  
+end
+

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification 
+name: validates_as_postal_code
+version: !ruby/object:Gem::Version 
+  version: 0.5.1
+platform: ruby
+authors: 
+- Wes Hays
+- John Dell
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-08-15 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Rails gem that implements an ActiveRecord validation helper called validates_as_postal_code which validates U.S. postal codes
+email: gems@gbdev.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- CHANGELOG
+- LICENSE
+- README
+- Rakefile
+- init.rb
+- lib/validates_as_postal_code.rb
+- test/validates_as_postal_code_test.rb
+has_rdoc: true
+homepage: http://github.com/gbdev/validates_as_postal_code
+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. postal codes
+test_files: 
+- test/validates_as_postal_code_test.rb