auspost 0.8.5

data/.bnsignore

@@ -0,0 +1,18 @@
+# The list of files that should be ignored by Mr Bones.
+# Lines that start with '#' are comments.
+#
+# A .gitignore file can be used instead by setting it as the ignore
+# file in your Rakefile:
+#
+#   Bones {
+#     ignore_file  '.gitignore'
+#   }
+#
+# For a project with a C extension, the following would be a good set of
+# exclude patterns (uncomment them if you want to use them):
+# *.[oa]
+# *~
+announcement.txt
+coverage
+doc
+pkg

data/History.txt

@@ -0,0 +1,4 @@
+== 1.0.0 / 2009-12-26
+
+* 1 major enhancement
+  * Birthday!

data/README.txt

@@ -0,0 +1,73 @@
+auspost
+    by Cameron Barrie
+    http://wiki.github.com/whalec/auspost
+
+== DESCRIPTION:
+
+Give you the ability to search the Australia Post Web site with either Suburb or Postcode, and return an array of Locations.
+Also add's validation methods to ActiveRecord Objects to allow you to validate that A Postcode + State + Suburb is correct
+
+== FEATURES/PROBLEMS:
+
+ActiveRecord Validations - validates_location
+
+
+== SYNOPSIS:
+
+  class Foo < ActiveRecord::Base
+    include Auspost::Postie
+    
+    before_save :check_address
+    
+    def check_address
+      location?(:postcode => 2038, :suburb => "Annandale", :state => "NSW")
+    end
+  end
+  
+  or 
+  
+  require 'auspost/active_record'
+  class Foo < ActiveRecord::Base
+  
+    validate_location
+  
+  end
+
+== REQUIREMENTS:
+
+Nokogiri - For teh XML parsing.
+
+== INSTALL:
+
+sudo gem install auspost
+
+== TODO:
+
+Validations for Active Record should take more options, including mapping the suburb, postcode and state to other columns
+
+validate_location :suburb => :home, :state => "state.name", :on => [:create, :change], :if => lambda { !home.blank? && !postcode.blank? }
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2009
+
+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/Rakefile

@@ -0,0 +1,22 @@
+begin
+  require 'bones'
+rescue LoadError
+  abort '### Please install the "bones" gem ###'
+end
+
+ensure_in_path 'lib'
+require 'auspost'
+
+task :default => 'test:run'
+task 'gem:release' => 'test:run'
+
+Bones {
+  name     'auspost'
+  authors  'Cameron Barrie'
+  email    'camwritescode@gmail.com'
+  dependencies ['nokogiri', "memcache-client"]
+  url      'http://www.camwritescode.com/auspost'
+  version  Auspost::VERSION
+}
+
+# EOF

data/bin/auspost

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+require File.expand_path(
+    File.join(File.dirname(__FILE__), %w[.. lib auspost]))
+
+# Put your code here
+

data/lib/auspost.rb

@@ -0,0 +1,48 @@
+module Auspost
+
+  # :stopdoc:
+  VERSION = '0.8.5'
+  LIBPATH = ::File.expand_path(::File.dirname(__FILE__)) + ::File::SEPARATOR
+  PATH = ::File.dirname(LIBPATH) + ::File::SEPARATOR
+  # :startdoc:
+
+  # Returns the version string for the library.
+  #
+  def self.version
+    VERSION
+  end
+
+  # Returns the library path for the module. If any arguments are given,
+  # they will be joined to the end of the libray path using
+  # <tt>File.join</tt>.
+  #
+  def self.libpath( *args )
+    args.empty? ? LIBPATH : ::File.join(LIBPATH, args.flatten)
+  end
+
+  # Returns the lpath for the module. If any arguments are given,
+  # they will be joined to the end of the path using
+  # <tt>File.join</tt>.
+  #
+  def self.path( *args )
+    args.empty? ? PATH : ::File.join(PATH, args.flatten)
+  end
+
+  # Utility method used to require all files ending in .rb that lie in the
+  # directory below this file that has the same name as the filename passed
+  # in. Optionally, a specific _directory_ name can be passed in such that
+  # the _filename_ does not have to be equivalent to the directory.
+  #
+  def self.require_all_libs_relative_to( fname, dir = nil )
+    dir ||= ::File.basename(fname, '.*')
+    search_me = ::File.expand_path(
+        ::File.join(::File.dirname(fname), dir, '**', '*.rb'))
+
+    Dir.glob(search_me).sort.each {|rb| require rb}
+  end
+
+end  # module Auspost
+require 'open-uri'
+require 'nokogiri'
+require 'memcache'
+require 'auspost/postie'

data/lib/auspost/active_record.rb

@@ -0,0 +1,5 @@
+require File.join(File.dirname(__FILE__), 'active_record/validations')
+ActiveRecord::Base.class_eval do 
+  include Auspost::Postie::ActiveRecord::Validations
+  include Auspost::Postie  
+end

data/lib/auspost/active_record/validations.rb

@@ -0,0 +1,82 @@
+module Auspost
+  module Postie
+
+    module ActiveRecord
+      module Validations
+        
+        @@valid_attributes = {
+          :state    => {:accessor => :state, :message => ["%s is not found in the %s postcode", :state, :postcode] },
+          :postcode => {:accessor => :postcode, :message => ["%s cannot be found", :postcode] },
+          :suburb   => {:accessor => :suburb, :message => ["%s is not found in the %s postcode", :suburb, :postcode] },
+        }
+        
+        def self.included(base)
+          base.extend ClassMethods
+        end
+        
+        
+        def validate_location
+          result = location?(map_attributes)
+          if result && !result.status
+            result.errors.each do |error|
+              message = @@valid_attributes[error.accessor][:message]
+              if message.is_a?(String)
+                errors.add(error.accessor, message)
+              else
+                mappings = message[1..-1].map do |x|
+                  if x.to_s.include?(".")
+                    methods = x.split(".")
+                    send(methods.first).send(methods.last).to_s.upcase
+                  else
+                    send(x).to_s.upcase
+                  end
+                end
+                errors.add(error.accessor, message.first % mappings)
+              end
+            end
+          end
+        end
+        
+        def valid_attributes
+          @@valid_attributes
+        end
+
+        protected
+
+        def map_attributes
+          { 
+            :state    => get_column(:state),
+            :postcode => get_column(:postcode),
+            :suburb   => get_column(:suburb)
+          }
+        end
+        
+        def get_column(column)
+          if @@valid_attributes[column][:accessor].nil?
+            column
+          elsif @@valid_attributes[column][:accessor].is_a?(String) && @@valid_attributes[column][:accessor].include?(".")
+            association = @@valid_attributes[column][:accessor].split(".")
+            self.send(association.first.to_sym).send(association.last.to_sym)
+          else
+            self.send(@@valid_attributes[column][:accessor]) || column
+          end
+        end
+
+
+        module ClassMethods
+
+          include Validations
+
+          # I'll add some validations here...
+          def validate_location(*args)
+            valid_attributes.update(args.extract_options!)
+            validate :validate_location, valid_attributes
+          end
+
+
+        end
+      end
+    end #ActiveRecord
+
+  end
+end

data/lib/auspost/postie.rb

@@ -0,0 +1,172 @@
+require 'cgi'
+module Auspost
+
+  module Postie
+    
+    class Cache
+      
+      # Over ride these two class variables to change your memcache settings
+      @@memcache_host = "localhost"
+      @@memcache_port = "11211"
+      
+      def initialize
+        if Object.const_defined? :Rails
+          Rails.cache
+        else
+          @cache = MemCache.new "#{@@memcache_host}:#{@@memcache_port}", :namespace => 'auspost'
+        end
+      end
+      
+      def write(key, object)
+        if @cache
+          @cache.add(key, object) if @cache.servers.map{|s| s.alive?}.include?(true)
+        else
+          Rails.cache.write(key, object)
+        end
+      end
+      
+      def read(key)
+        if @cache
+          @cache.get(key) if @cache.servers.map{|s| s.alive?}.include?(true)
+        else
+          Rails.cache.read(key)
+        end
+      end
+    end
+    
+    class Suburb
+      def initialize(attrs)
+        @suburb   = attrs[:suburb].downcase
+        @postcode = attrs[:postcode].to_i
+        @state    = attrs[:state].downcase
+      end
+      
+      def suburb?(attrs)
+        attrs[:suburb].downcase == @suburb
+      end
+      
+      def state?(attrs)
+        attrs[:state].downcase == @state.downcase
+      end
+      
+      def postcode?(attrs)
+        attrs[:postcode].to_i == @postcode
+      end
+      
+      def eql?(attrs)
+        suburb?(attrs) && postcode?(attrs) && state?(attrs)
+      end
+      
+      def to_i(attrs)
+        (suburb?(attrs) ? 1 : 0) + 
+          (state?(attrs) ? 1 : 0) +
+            (postcode?(attrs) ? 1 : 0)
+      end
+    end
+    
+    class Result
+      
+      attr_reader :status, :errors
+      
+      def initialize(status)
+        @status = status
+        @errors = [] if !@status
+      end
+      
+    end
+    
+    class Error
+      
+      attr_reader :accessor
+      
+      def initialize(accessor)
+        @accessor = accessor
+      end
+      
+    end
+
+
+    # This is the method that returns whether a location is correct or not.
+    # It requires three attributes
+    # :postcode, :suburb & :state such as
+    # location?(:postcode => 2038, :suburb => "Annandale", :state => "NSW") #=> Result#status => true
+    # location?(:postcode => 2010, :suburb => "Annandale", :state => "NSW") #=> Result#status => false 
+    # Result#errors => Error#accessor => :suburb && Error#message => "Annandale does not match 2010 postcode"
+    # The results of a request to a given postcode is cached in memcached if available or in
+    # your Rails.cache store if you're in a Rails project.
+    def location?(attrs = {})
+      map_attributes!(attrs)
+      url       = "http://www1.auspost.com.au/postcodes/index.asp?Locality=&sub=1&State=&Postcode=#{CGI::escape(@postcode)}&submit1=Search"
+      @content  = get(url)
+      check_results(attrs)
+    end
+    
+
+    protected
+
+    def cache
+      @cache ||= set_cache 
+    end
+    
+    def set_cache
+      @cache = Cache.new
+    end
+    
+    def get(url)
+      @results = check_cache || get_and_cache(url)
+    end
+    
+    def check_cache
+      cache.read(@postcode)
+    end
+    
+    def get_and_cache(url)
+      object    = open(url)
+      @table    = Nokogiri::HTML(object).xpath('//table[3]/tr/td[2]/table/tr/td/font/table/tr[2]/td/table/tr')
+      content   = map_results
+      content.delete_if{|x| x.nil?}
+      cache.write(@postcode, content)
+      content
+    end
+    
+    def map_attributes!(attrs)
+      raise ArgumentError, "You must supply a suburb" if attrs[:suburb].nil?
+      raise ArgumentError, "You must supply a state" if attrs[:state].nil?
+      raise ArgumentError, "You must supply a postcode" if attrs[:postcode].nil?
+      attrs.values.map!{|value| value.to_s.downcase! }
+      @postcode = attrs[:postcode].to_s
+    end
+    
+    def map_results
+      @table.map do |row|
+        content = row.content.strip if row.content.include?("LOCATION:")
+        if content
+          s = content.index("LOCATION: ")
+          e = content.index(",")
+          suburb = content[s..e-1].split(" ").last
+          state  = content[e+2..e+4]
+          final = Suburb.new(:suburb => suburb, :state => state, :postcode => @postcode)
+        end
+      end
+    end
+    
+    def check_results(attrs)
+      if @results.map{|suburb| suburb.eql?(attrs)}.include?(true)
+        Result.new(true)
+      else
+        generate_result_with_errors(attrs)
+      end
+    end
+    
+    def generate_result_with_errors(attrs)
+      result = Result.new(false)
+      error_count = @results.map{|r| r.to_i(attrs) }
+      main_error = @results[error_count.index(error_count.sort.last)]
+      result.errors << Error.new(:suburb) if !main_error.suburb?(attrs)
+      result.errors << Error.new(:state) if !main_error.state?(attrs)
+      result
+    end
+
+  end
+
+end

data/spec/auspost/active_record/validations_spec.rb

@@ -0,0 +1,72 @@
+require File.join(File.dirname(__FILE__), "../../spec_helper")
+require File.join(File.dirname(__FILE__), "../../fixtures/postal_worker")
+
+describe PostalWorker, "without auspost/active_record required" do
+  
+  it "should not respond to a method validate_location" do
+    PostalWorker.should_not respond_to(:validate_location)
+  end
+  
+end
+
+
+describe PostalWorker, "with auspost/active_record required" do
+
+  # require needs to be in the before block, otherwise it's called when the file is required or the describe blocks are called.
+  # causing failure to the above spec
+  before(:all) do
+    require 'auspost/active_record'
+    PostalWorker.validate_location
+  end
+
+  before do
+    @valid_attributes = {:address => "William St", :suburb => "Annandale", :postcode => "2038", :state => "NSW"}
+    @invalid_attributes = {:address => "William St", :suburb => "Annandale", :postcode => "2000", :state => "VIC"}
+  end
+  
+  it "should have a method validate_location" do
+    PostalWorker.should respond_to(:validate_location)
+  end
+  
+  it "should not be valid" do
+    @worker = PostalWorker.new(@invalid_attributes)
+    @worker.should_not be_valid
+  end
+  
+  it "should validate an address" do
+    @worker = PostalWorker.new({:suburb => "Rozelle", :postcode => "2039", :state => "NSW"})
+    @worker.should be_valid
+  end
+  
+  it "should return a useful error message on the state" do
+    @worker = PostalWorker.new(@invalid_attributes)
+    @worker.should_not be_valid
+    @worker.errors.on(:state).should eql("VIC is not found in the 2000 postcode")
+    @worker.errors.on(:suburb).should eql("ANNANDALE is not found in the 2000 postcode")
+  end
+  
+  it "should return a useful error message on the suburb" do
+    @worker = PostalWorker.new(@valid_attributes.merge(:suburb => "Rozelle"))
+    @worker.should_not be_valid
+    @worker.errors.on(:suburb).should eql("ROZELLE is not found in the 2038 postcode")
+    @worker.errors.on(:state).should be_nil
+  end
+end
+
+
+describe MashedPostalWorker, "with options set on the validation" do
+  before(:all) do
+    require 'auspost/active_record'
+    MashedPostalWorker.validate_location  :suburb => {:accessor => :city, :message => "That doesn't match up!"},
+                                          :postcode => {:accessor => :zipcode, :message => ["Postcode %s cannot be found", :zipcode]},
+                                          :state => {:accessor => "state.name", :message => ["%s is such a better state anyway *ducks*", "state.name"]}
+  end
+  
+  it "should have a custom message on the suburb" do
+    @worker = MashedPostalWorker.new({:city => "Annandale", :zipcode => 3001, :state => State.new(:name => "NSW")})
+    @worker.should_not be_valid
+    @worker.errors.on(:suburb).should eql("That doesn't match up!")
+    @worker.errors.on(:state).should eql("NSW is such a better state anyway *ducks*")
+  end
+  
+end

data/spec/auspost/postie_spec.rb

@@ -0,0 +1,55 @@
+require File.join(File.dirname(__FILE__), "../spec_helper")
+include Auspost
+
+describe Postie do
+  include Postie
+  
+  it "should find Annandale and return true" do
+    location?({:postcode => "2038", :suburb => "Annandale", :state => "NSW"}).status.should eql(true)
+  end
+  
+  it "shouldn't find that Surry Hills is in the 2000 postcode" do
+    location?({:postcode => "2000", :suburb => "Surry Hills", :state => "QLD"}).status.should_not eql(true)
+  end
+  
+  # Testing this to ensure sub-strings don't pass as true
+  it "shoudn't find dale in 2038" do
+    location?({:postcode => "2038", :suburb => "dale", :state => "NSW"}).status.should_not eql(true)
+  end
+  
+  it "shouldn't substring search" do
+    location?(:postcode => "2038", :suburb => "Annandale", :state => "N").status.should_not eql(true)
+  end
+  
+  it "should raise if there's not a postcode" do
+    lambda { location?(:suburb => "Surry Hills", :state => "FOO") }.should raise_error(ArgumentError)
+  end
+  
+  it "should raise if there's not a suburb" do
+    lambda { location?(:postcode => 2038, :state => "FOO") }.should raise_error(ArgumentError)
+  end
+  
+  it "should raise if there's not a state" do
+    lambda { location?(:suburb => "Surry Hills", :postcode => 2038) }.should raise_error(ArgumentError)
+  end
+  
+  it "should accept an Integer for the postcode" do
+    location?({:postcode => 2038, :suburb => "Annandale", :state => "NSW"}).status.should eql(true)
+  end
+  
+end
+
+describe Postie, " with cached" do
+  include Postie
+  
+  it "should cache a result" do
+    @io = mock(IO)
+    @string = mock(String)
+    @array  = mock(Array)
+    Postie::Cache.should_receive(:new).and_return(@io)
+    @io.should_receive(:read).with("2038").and_return(@string)
+    @string.should_receive(:map).at_least(:once).and_return(@array)
+    @array.should_receive(:include?).with(true).and_return(true)
+    location?({:postcode => "2038", :suburb => "Annandale", :state => "NSW"}).status.should eql(true)
+  end  
+end

data/spec/fixtures/auspost.html

@@ -0,0 +1,187 @@
+
+<html>
+<head>
+<link rel="stylesheet" href="/include/stylesheet/miniapps.css" type="text/css">
+<link rel="stylesheet" href="/include/stylesheet/mainstyle.css" type="text/css">
+<title>Australia Post - Postcode Search</title>
+
+<META NAME='ROBOTS' CONTENT='ALL'>
+<META NAME='description' CONTENT='Search for Australian Postcode locations online'>
+<META NAME='keywords' CONTENT='Australia Post Postcode Search Find locations'>
+
+</head> 
+<script type="text/JavaScript">
+<!--
+function MM_preloadImages() { //v3.0
+  var d=document; if(d.images){ if(!d.MM_p) d.MM_p=new Array();
+    var i,j=d.MM_p.length,a=MM_preloadImages.arguments; for(i=0; i<a.length; i++)
+    if (a[i].indexOf("#")!=0){ d.MM_p[j]=new Image; d.MM_p[j++].src=a[i];}}
+} 
+ 
+function MM_swapImgRestore() { //v3.0 
+  var i,x,a=document.MM_sr; for(i=0;a&&i<a.length&&(x=a[i])&&x.oSrc;i++) x.src=x.oSrc;
+}
+
+function MM_findObj(n, d) { //v4.01
+  var p,i,x;  if(!d) d=document; if((p=n.indexOf("?"))>0&&parent.frames.length) {
+    d=parent.frames[n.substring(p+1)].document; n=n.substring(0,p);}
+  if(!(x=d[n])&&d.all) x=d.all[n]; for (i=0;!x&&i<d.forms.length;i++) x=d.forms[i][n];
+  for(i=0;!x&&d.layers&&i<d.layers.length;i++) x=MM_findObj(n,d.layers[i].document);
+  if(!x && d.getElementById) x=d.getElementById(n); return x;
+}
+
+function MM_swapImage() { //v3.0
+  var i,j=0,x,a=MM_swapImage.arguments; document.MM_sr=new Array; for(i=0;i<(a.length-2);i+=3)
+   if ((x=MM_findObj(a[i]))!=null){document.MM_sr[j++]=x; if(!x.oSrc) x.oSrc=x.src; x.src=a[i+2];}
+}
+function cmdGo_Click() {    
+window.document.queryForm.submit(); }
+//-->
+</script> 
+<table width="780" border="0" cellspacing="0" cellpadding="0">
+  <tr class="top-header">
+    <td width="210"><a href="http://www.auspost.com.au"><img src="/auspost/images/display/logo.jpg" alt="Australia Post Home" width="182" height="45" border="0" /></a></td>
+    <td><img src="/auspost/images/display/b_arrow.gif" alt="Arrow" id="contact-arrow" width="13" height="14" />&nbsp;&nbsp;<a class="white-title" href="http://www.auspost.com.au/BCP/0,1080,CH3988%257EMO19,00.html">Jobs @ Post</a>&nbsp;&nbsp;&nbsp;<img src="/auspost/images/display/b_arrow.gif" alt="Arrow" id="contact-arrow" width="13" height="14" />&nbsp;&nbsp;&nbsp;<a class="white-title" href="http://www.auspost.com.au/CUP/0,,CHNONE%257EMO19,00.html">Contact Us</a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="search-title">Search Site :</span>&nbsp;<form id="queryForm" name="queryForm" action="http://search.auspost.com.au/cse/auspost/default.asp" method="get"><input id="queryBox" name="q" value="" size="20" />&nbsp;&nbsp;<a href="javascript:onClick=cmdGo_Click();" onmouseout="MM_swapImgRestore()" onmouseover="MM_swapImage('btngosearch','','/auspost/images/display/br_submit.gif',1)"><img name="btngosearch" id="btngosearch" src="/auspost/images/display/b_submit.gif" alt="submit" width="62" height="22" border="0" /></form></td>
+  </tr>
+</table>
+<table width="780" border="0" cellspacing="0" cellpadding="0"> 
+  <tr class="tabs-row">
+    <td width="19">&nbsp;</td>
+    <td width="101"><a href="http://www.auspost.com.au"><img src="/auspost/images/display/b_Home.gif" alt="Home" name="Image2" width="82" height="29" border="0" id="Image2" onmouseover="MM_swapImage('Image2','','/auspost/images/display/br_Home.gif',1)" onmouseout="MM_swapImgRestore()" /></a></td>
+    <td width="139"><a href="http://www.auspost.com.au/CAP/0,,CH2002%257EMO19,00.html"><img src="/auspost/images/display/b_GenServices.gif" alt="General Services" width="122" height="29" border="0" id="Image3" onmouseover="MM_swapImage('Image3','','/auspost/images/display/br_GenServices.gif',1)" onmouseout="MM_swapImgRestore()" /></a></td>
+    <td width="199"><a href="http://www.auspost.com.au/CAP/0,,CH2006%257EMO19,00.html"><img src="/auspost/images/display/b_Billing.gif" alt="Billing &amp; Financial" width="180" height="29" border="0" id="Image4" onmouseover="MM_swapImage('Image4','','/auspost/images/display/br_Billing.gif',1)" onmouseout="MM_swapImgRestore()" /></a></td>
+    <td width="154"><a href="http://www.auspost.com.au/CAP/0,,CH2005%257EMO19,00.html"><img src="/auspost/images/display/b_BusSolutions.gif" alt="Business Solutions" width="138" height="29" border="0" id="Image5" onmouseover="MM_swapImage('Image5','','/auspost/images/display/br_BusSolutions.gif',1)" onmouseout="MM_swapImgRestore()" /></a></td>
+    <td><a href="http://www.auspost.com.au/CAP/0,,CH2007%257EMO19,00.html"><img src="/auspost/images/display/b_AboutUs.gif" alt="About Us" width="85" height="29" border="0" id="Image6" onmouseover="MM_swapImage('Image6','','/auspost/images/display/br_AboutUs.gif',1)" onmouseout="MM_swapImgRestore()" /></a></td>
+    <td width="50"><div align="right"><img src="/auspost/images/display/cnr_btm_r.gif" alt="corner" width="39" height="29" /></div></td>
+  </tr>
+  <tr>
+    <td colspan="7"><img src="/auspost/images/display/transparent 3x3.gif" alt="Blank" width="8" height="8" /></td>
+  </tr> 
+</table>
+<table border="0" cellpadding="0" cellspacing="0" width="780">
+  <tr>
+    <td valign="top" id="td-site-app">
+    
+<ul id="site-apps" style="padding-right: 5px;">
+  <li><img src="/auspost/images/display/h_Useful_Tools.gif" alt="Useful Tools" width="113" height="29" /></li>
+  <li><img src="/auspost/images/display/i_FindPostcode.gif" alt="Find a postcode" width="22" height="22" />&nbsp;&nbsp;<a class="min-apps" href="http://www1.auspost.com.au/postcodes/">Find a postcode</a></li>
+    <li><img src="/auspost/images/display/i_CalcPostageRates.gif" alt="Calculate postage rates" width="22" height="22" />&nbsp;&nbsp;<a class="min-apps" href="http://www1.auspost.com.au/pac/">Calculate postage rates</a></li>
+    <li><img src="/auspost/images/display/i_ExpressPostPlatTrackg.gif" alt="Australia post delivery tracking" width="22" height="22" />&nbsp;&nbsp;<a class="min-apps" href="http://www.auspost.com.au/track">Track my item</a></li>
+    <li><img src="/auspost/images/display/i_FindPostalOutlet.gif" alt="Find a postal outlet" width="22" height="22" />&nbsp;&nbsp;<a class="min-apps" href="http://www.auspost.com.au/pol/">Find a postal outlet</a></li>
+  <li><img src="/auspost/images/display/i_FindPostalBox.gif" alt="Find a street posting box" width="22" height="22" />&nbsp;&nbsp;<a class="min-apps" href="http://www.auspost.com.au/pol/">Find a street posting box</a></li>
+    <li><img src="/auspost/images/display/i_PayBillsOnline.gif" alt="Pay bills online" width="22" height="22" />&nbsp;&nbsp;<a class="min-apps" href="http://www.postbillpay.com.au/">Pay bills online</a></li>
+    <li><img src="/auspost/images/display/i_IntnlPostageDetails.gif" alt="International Postage Details" width="22" height="22" />&nbsp;&nbsp;<a class="min-apps" href="http://www1.auspost.com.au/international/">International postage details</a></li>
+    <li><img src="/auspost/images/display/i_PostGuides.gif" alt="Post guides" width="22" height="22" />&nbsp;&nbsp;<a class="min-apps" href="http://www.auspost.com.au/BCP/0,,CH3851%257EMO19,00.html">Post guides</a></li>
+</ul> 
+
+    </td>
+<td valign="top">
+<table width="600" border="0" cellpadding="0" cellspacing="10">
+        <tr valign="top">
+          <td width="493" align="center" valign="top"><font face="verdana,Helv,Arial" size="2">
+            
+
+<table border="0" cellpadding="0" cellspacing="0" width="490">
+  <tr>
+    <!-- banner header -->
+    <td colspan="2" bgcolor="#B9E3DE"><img src="../images_new/postcode_search/funct_postcodesearch.gif" alt="Postcode Search" width="327" height="32"></td>
+  </tr>
+  <tr>
+    <!-- Results row -->
+    <td width="330" valign="top"><table width="330" border="0" cellpadding="5" cellspacing="0">
+        
+<tr>
+  <td valign="top" width="7" bgcolor="#ff0000"><font face="verdana, arial, helv" size="2" color="#ffffff"><strong>1.</strong></td>
+  <td><font face="arial, helv" size="2"> <strong>LOCATION:</strong> ANNANDALE, NSW<br />
+    
+    <strong>POSTCODE:</strong> 2038<br />
+    
+    <strong>CATEGORY:</strong> Delivery Area<br />
+    
+  </td>
+</tr>
+<tr>
+  <td colspan="2"><hr noshade size="1">
+  </td>
+</tr>
+
+      </table></td>
+    <td width="150" valign="top" bgcolor="#B9E3DE"><table width="150" border="0" cellpadding="5" cellspacing="0">
+        <!-- Results summary table -->
+        <tr>
+          <!-- Show results for each state -->
+          <td width="150" style="background-color: #B9E3DE; font-size:100%"><a href="index.asp">Search Again</a>
+            <hr noshade size="1">
+            <strong>Returned Matches:</strong> 1
+            <hr noshade size="1">
+            
+            <strong>Breakdown</strong>
+            <br />New South Wales: 1
+          </td>
+        </tr>
+        
+      </table></td>
+  </tr>
+</table>
+
+          </td>
+        </tr>
+      </table>
+    </td>  
+  </tr>
+</table>
+
+<table width="780" border="0" cellspacing="0" cellpadding="0">
+<!---------- SPACER ------------------------------------------------------------------->
+  <tr> 
+    <td valign="top" height="20"> 
+    </td>
+  </tr>
+<!---------- end SPACER --------------------------------------------------------------->  
+
+<!---------- FIRST LEVEL NAVIGATION ------------------------------------------------------>
+  <tr>
+    <td id="td-foot"> 
+        <br /> 
+    <ul id="footer-list">
+    <li><img src="/auspost/images/display/a_right.gif" alt="Arrow" width="4" height="7" /> <a class="footer" href="http://www.auspost.com.au/APC/CDA/Sitemap/APC_CDA_Sitemap/0,1084,CHNONE%257EMO19,00.html">Site map</a>&nbsp;&nbsp;&nbsp;&nbsp;</li>
+    <li><img src="/auspost/images/display/a_right.gif" alt="Arrow" width="4" height="7" /> <a class="footer" href="http://www.auspost.com.au/CUP/0,1050,CHNONE%257EMO19,00.html">Contact Us</a>&nbsp;&nbsp;&nbsp;&nbsp;</li>
+    <li><img src="/auspost/images/display/a_right.gif" alt="Arrow" width="4" height="7" /> <a class="footer" href="http://www.auspost.com.au/APC/CDA/Site_Governance/APC_CDA_Privacy_Policy/">Privacy</a>&nbsp;&nbsp;&nbsp;&nbsp;</li>
+    <li><img src="/auspost/images/display/a_right.gif" alt="Arrow" width="4" height="7" /> <a class="footer" href="http://www.auspost.com.au/APC/CDA/Site_Governance/APC_CDA_Terms_Conditions/">Terms &amp; Conditions </a></li>
+  </ul>
+
+
+<!-- Track File Downloads with Google --> 
+<script language="javascript" type="text/javascript" src="/APC/CDA/CSS/gatag.js" ></script>
+
+<!--Google tracking --> 
+<script type="text/javascript">
+  var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+  document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+</script>
+
+<script type="text/javascript">
+<!-- Auspost roll up account --> 
+  try {
+    var APTracker = _gat._getTracker("UA-2225711-5");
+    APTracker._setDomainName(".auspost.com.au");
+    APTracker._trackPageview("WWW1" + document.location.pathname);
+  } catch(err) {}
+
+  <!-- Auspost account --> 
+  try {
+    var pageTracker = _gat._getTracker("UA-2225711-1");
+    pageTracker._setDomainName(".auspost.com.au");
+    pageTracker._trackPageview();
+  } catch(err) {}
+
+  <!-- WWW1 account --> 
+  try {
+    var pageTracker = _gat._getTracker("UA-2225711-3");
+    pageTracker._setDomainName(".auspost.com.au");
+    pageTracker._trackPageview();
+  } catch(err) {}
+</script>
+
+</body>
+</html>

data/spec/fixtures/postal_worker.rb

@@ -0,0 +1,39 @@
+gem 'sqlite3-ruby'
+require 'sqlite3'
+require 'active_record'
+
+ActiveRecord::Base.establish_connection(
+   :adapter => "sqlite3",
+   :database  => ":memory:"
+ )
+ ActiveRecord::Base.connection.create_table(:postal_workers) do |t|
+   t.string :address
+   t.string :postcode
+   t.string :suburb
+   t.string :state
+end
+
+
+ActiveRecord::Base.connection.create_table(:mashed_postal_workers) do |t|
+  t.string :addr
+  t.string :zipcode
+  t.string :city
+  t.integer :state_id
+end
+
+ActiveRecord::Base.connection.create_table(:states) do |t|
+  t.string :name
+end
+
+
+class PostalWorker < ActiveRecord::Base;end
+
+class MashedPostalWorker < ActiveRecord::Base
+  
+  belongs_to :state
+  
+end
+
+class State < ActiveRecord::Base
+  has_many :mashed_postal_workers
+end

data/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+require 'rubygems'
+require 'spec'
+require File.expand_path(File.join(File.dirname(__FILE__), %w[.. lib auspost]))
+
+Spec::Runner.configure do |config|
+  # == Mock Framework
+  #
+  # RSpec uses it's own mocking framework by default. If you prefer to
+  # use mocha, flexmock or RR, uncomment the appropriate line:
+  #
+  # config.mock_with :mocha
+  # config.mock_with :flexmock
+  # config.mock_with :rr
+end
+

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification 
+name: auspost
+version: !ruby/object:Gem::Version 
+  version: 0.8.5
+platform: ruby
+authors: 
+- Cameron Barrie
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-01-02 00:00:00 +11:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: bones
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 3.2.0
+    version: 
+description: |-
+  Give you the ability to search the Australia Post Web site with either Suburb or Postcode, and return an array of Locations.
+  Also add's validation methods to ActiveRecord Objects to allow you to validate that A Postcode + State + Suburb is correct
+email: camwritescode@gmail.com
+executables: 
+- auspost
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- README.txt
+- bin/auspost
+files: 
+- .bnsignore
+- History.txt
+- README.txt
+- Rakefile
+- bin/auspost
+- lib/auspost.rb
+- lib/auspost/active_record.rb
+- lib/auspost/active_record/validations.rb
+- lib/auspost/postie.rb
+- spec/auspost/active_record/validations_spec.rb
+- spec/auspost/postie_spec.rb
+- spec/fixtures/auspost.html
+- spec/fixtures/postal_worker.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://www.camwritescode.com/auspost
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+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: auspost
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Give you the ability to search the Australia Post Web site with either Suburb or Postcode, and return an array of Locations
+test_files: 
+- spec/auspost/active_record/validations_spec.rb
+- spec/auspost/postie_spec.rb