zoopla 0.1.0

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,31 @@
+PATH
+  remote: .
+  specs:
+    zoopla (0.1.0)
+      curb
+      hashie (>= 1.0.0)
+      hashie (>= 1.0.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    curb (0.7.12)
+    git (1.2.5)
+    hashie (1.0.0)
+    jeweler (1.5.2)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    mocha (0.9.12)
+    rake (0.8.7)
+    rcov (0.9.9)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.0)
+  jeweler (~> 1.5.2)
+  mocha (>= 0.9.12)
+  rcov
+  zoopla!

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Evgeny Shadchnev
+
+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.markdown

@@ -0,0 +1,53 @@
+# Zoopla API Wrapper
+
+Use this gem to access real estate data using zoopla.co.uk API from ruby code:
+
+  * property listings with addresses, prices, agent details etc
+  * more to come
+
+## Documentation
+The gem documentation can be found on [Rdoc.info](http://rdoc.info/github/shadchnev/zoopla/master/frames)
+
+The API documentation can be found on the [Zoopla Website](http://developer.zoopla.com/docs)
+
+## Usage examples
+
+### Property listings
+
+First, initialise the object with the API key [you got from Zoopla](http://developer.zoopla.com/member/register/)
+
+	$ sales = Zoopla::Listings::Sales.new('my_api_key')
+	
+Then chain the parameter calls and provide a block to process the listings
+
+    $ sales.houses.in({:postcode => 'NW1 0DU'}).within(0.5).each{|l| puts "#{l.num_bedrooms}-bedrooms house for #{l.price} at #{l.displayable_address}"}
+
+This will produce
+
+		4-bedrooms house for 1525000 at Arlington Road, London
+		2-bedrooms house for 1250000 at Rochester Mews, London
+		4-bedrooms house for 999000 at Bonny Street, Camden Town, London
+		...
+		
+To search for rentals, do a similar query:
+
+    $ rentals = Zoopla::Listings::Rentals.new('my_api_key')
+    $ rentals.flats.in({:postcode => 'NW1 0DU'}).within(0.5).price(300..350).each{|l| puts "#{l.num_bedrooms}-bedrooms flat for #{l.price}/week at #{l.displayable_address}"}
+
+The input and output parameters for property listings are described in the [Zoopla documentation](http://developer.zoopla.com/docs/read/Property_listings)
+
+
+## Contributing to zoopla
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+## Copyright
+
+Copyright (c) 2011 Evgeny Shadchnev. See LICENSE.txt for further details.
+

data/Rakefile

@@ -0,0 +1,53 @@
+require 'rubygems'
+require 'bundler'
+require './lib/zoopla'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "zoopla"
+  gem.homepage = "http://github.com/shadchnev/zoopla"
+  gem.license = "MIT"
+  gem.summary = %Q{Access zoopla.co.uk API from ruby scripts}
+  gem.description = %Q{Access zoopla.co.uk API from ruby scripts. Fetch sales and rental properties for the UK}
+  gem.email = "evgeny.shadchnev@gmail.com"
+  gem.authors = ["Evgeny Shadchnev"]
+  gem.version = Zoopla::Version::STRING
+  gem.add_runtime_dependency 'hashie', '>= 1.0.0'
+  gem.add_development_dependency 'mocha', '>= 0.9.12'
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+require 'rcov/rcovtask'
+Rcov::RcovTask.new do |test|
+  test.libs << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = Zoopla::Version::STRING
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "zoopla #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/zoopla.rb

@@ -0,0 +1,12 @@
+require 'curl'
+require 'json'
+require 'cgi'
+require 'hashie'
+
+require File.expand_path('../zoopla/version', __FILE__)
+require File.expand_path('../zoopla/api', __FILE__)
+require File.expand_path('../zoopla/listings', __FILE__)
+
+module Zoopla
+  
+end

data/lib/zoopla/api.rb

@@ -0,0 +1,52 @@
+module Zoopla
+  
+  class API # abstract
+    
+    def initialize(api_key)
+      @key = api_key
+    end
+    
+    private
+    
+    def fetch_data(params)
+      preprocess call(url(params))       
+    end
+    
+    def call(url)
+      curl = Curl::Easy.new(url)
+      curl.perform
+      JSON.parse curl.body_str
+    end
+        
+    def url(params)
+      params.inject("http://api.zoopla.co.uk/api/v1/#{api_call}.js?api_key=#{@key}") do |memo, item|
+        memo += "&#{item.first}=#{CGI::escape item.last.to_s}"
+      end
+    end
+    
+    def tryParsingInteger(field, value)
+      (value.to_i rescue 0) if %w(price listing_id num_bathrooms num_bedrooms num_floors num_recepts).include? field
+    end
+    
+    def tryParsingDate(field, value)
+      (Date.parse(value) rescue value) if field == 'date'
+    end
+    
+    def tryParsingHash(field, value)
+      parse_values_if_possible(value) if value.is_a? Hash
+    end
+    
+    def tryParsingArray(field, value)
+       value.inject([]) {|memo, item| memo << parse_values_if_possible(item) } if value.is_a? Array
+    end
+    
+    def parse_values_if_possible(reply)
+      return reply if reply.is_a? String
+      reply.each_pair do |field, value|                
+        reply[field] = tryParsingHash(field, value) || tryParsingArray(field, value) || tryParsingInteger(field, value) || tryParsingDate(field, value) || value
+      end
+    end
+        
+  end
+  
+end

data/lib/zoopla/listings.rb

@@ -0,0 +1,3 @@
+require File.expand_path('listings/listing', File.dirname(__FILE__))
+require File.expand_path('listings/rentals', File.dirname(__FILE__))
+require File.expand_path('listings/sales', File.dirname(__FILE__))

data/lib/zoopla/listings/listing.rb

@@ -0,0 +1,194 @@
+module Zoopla
+  
+  module Listings
+    
+    # Common methods for Sales and Rentals classes
+    module Listing
+                  
+      # Defines the search area. All possible params are described at http://developer.zoopla.com/docs/
+      # @param [Hash] Location hash
+      # @return [Sales, Rentals]
+      def in(location)
+        @request.merge! location
+        self
+      end
+      
+      # Sets the price range
+      # @param [Range] price range (weekly in case of rentals), e.g. 200..300
+      # @return [Sales, Rentals]
+      def price(price_range)
+        set_range_parameter(:price, price_range)
+      end
+      
+      alias_method :for, :price
+      
+      # Sets the number of bedrooms range
+      # @param [Range] bedrooms range, e.g. 2..3
+      # @return [Sales, Rentals]
+      def beds(beds_range)
+        set_range_parameter(:beds, beds_range)
+      end
+      
+      # Defines the size of the search area in miles. E.g. 2 miles around a location
+      # @param [Fixum] radius in miles
+      # @return [Sales, Rentals]
+      def within(miles)
+        ensure_valid_parameter('radius', miles, lambda {|p| (p.is_a? Float or p.is_a? Fixnum) and p >= 0})
+        @request[:radius] = miles
+        self
+      end
+      
+      alias_method :radius, :within
+      
+      # The field by which the results should be ordered, either :price or :age of listing.
+      # @param [Symbol, String] sorting field
+      # @return [Sales, Rentals]
+      def order_by(field)
+        ensure_valid_parameter('sorting order', field, %w(price age))
+        @request[:order_by] = field.to_s        
+        self
+      end
+      
+      # Sort order for the listings returned. Either :descending or :ascending
+      # @param [Symbol, String] sorting order
+      # @return [Sales, Rentals]
+      def ordering(order)
+        ensure_valid_parameter('ordering', order, %w(ascending descending))
+        @request[:ordering] = order.to_s
+        self
+      end
+      
+      # Property type. Either :houses or :flats
+      # @param [Symbol, String] property type
+      # @return [Sales, Rentals]
+      def property_type(type)
+        ensure_valid_parameter('property type', type, %w(houses flats))
+        @request[:property_type] = type.to_s
+        self
+      end
+      
+      # Search only for houses
+      # @return [Sales, Rentals]
+      def houses
+        @request[:property_type] = 'houses'
+        self
+      end
+      
+      # Search only for flats
+      # @return [Sales, Rentals]
+      def flats
+        @request[:property_type] = 'flats'
+        self
+      end
+      
+      # Keywords to search for within the listing description.
+      # @param [Array, String] keywords
+      # @return [Sales, Rentals]
+      def keywords(keywords)
+        ensure_valid_parameter('keywords', keywords, lambda {|k| k.is_a? Array or k.is_a? String})
+        keywords = keywords.join(' ') if keywords.is_a? Array
+        @request[:keywords] = keywords
+        self
+      end
+      
+      # Sets the minimum price. Weekly prices in case of rentals
+      # @param [Fixnum] price
+      # @return [Sales, Rentals]
+      def minimum_price(price)
+        set_limiting_value(:minimum, :price, price)
+      end
+      
+      # Sets the maximum price. Weekly prices in case of rentals
+      # @param [Fixnum] price
+      # @return [Sales, Rentals]
+      def maximum_price(price)
+        set_limiting_value(:maximum, :price, price)
+      end
+      
+      # Sets the minimum number of bedrooms
+      # @param [Fixnum] number of bedrooms
+      # @return [Sales, Rentals]
+      def minimum_beds(beds)
+        set_limiting_value(:minimum, :beds, beds)
+      end
+      
+      # Sets the maximum number of bedrooms
+      # @param [Fixnum] number of bedrooms
+      # @return [Sales, Rentals]
+      def maximum_beds(beds)
+        set_limiting_value(:maximum, :beds, beds)
+      end
+      
+      # Adds another listing id to the query. Calling this function multiple times will add multiple ids.
+      # Please note that other provided arguments will still be taken into account when filtering listings
+      # @param [Fixnum] listing id
+      # @return [Sales, Rentals]
+      def listing_id(listing_id)
+        ensure_valid_parameter('listing id', listing_id, lambda {|k| k.is_a? Fixnum and k >= 0})
+        @request[:listing_id] ||= []
+        @request[:listing_id] << listing_id
+        self        
+      end
+      
+      # Iterates over the results. Possible fields are described at http://developer.zoopla.com/docs/read/Property_listings
+      # @yield [Hashie::Mash] a listing with data, e.g. sales.each{|listing| puts listing.price }
+      def each
+        fetched_so_far, number_of_results = 0, 0
+        @request[:page_number] = 1
+        begin
+          number_of_results, listings = fetch_data(@request)
+          fetched_so_far += listings.size
+          @request[:page_number] += 1
+          listings.each do |listing|
+            yield listing
+          end
+        end while fetched_so_far < number_of_results 
+      end
+      
+      # Resets all parameters except the API key
+      # @return [Rentals, Sales]
+      def reset!
+        @request = default_parameters
+        self
+      end      
+      
+      private
+      
+      def set_limiting_value(limit, attribute, value)
+        ensure_valid_parameter("#{limit} #{attribute}", value, lambda {|p| p.is_a? Fixnum and p >= 0})
+        @request["#{limit}_#{attribute}".to_sym] = value
+        self        
+      end
+      
+      def set_range_parameter(attribute, value)
+        ensure_valid_parameter(attribute.to_s, value, lambda {|pr| pr.is_a? Fixnum or (pr.is_a?(Range) and pr.first <= pr.last)})
+        value = value..value if value.is_a? Fixnum
+        self.send("minimum_#{attribute}", value.first)
+        self.send("maximum_#{attribute}", value.last)
+        self        
+      end
+      
+      def ensure_valid_parameter(parameter, value, valid_options)
+        raise "#{parameter} not specified" unless value
+        raise "Unknown #{parameter}: #{value}" if valid_options.is_a? Array and !valid_options.include?(value.to_s)
+        raise "Invalid #{parameter}: #{value}" if valid_options.is_a? Proc  and !valid_options.call(value)
+      end
+      
+      def preprocess(reply)
+        number_of_results = reply["result_count"]
+        listings = reply["listing"].inject([]) do |memo, listing|
+          parse_values_if_possible(listing)
+          memo << Hashie::Mash.new.update(listing)
+        end
+        [number_of_results, listings]        
+      end
+      
+      def api_call
+        'property_listings'
+      end      
+      
+    end
+    
+  end
+  
+end

data/lib/zoopla/listings/rentals.rb

@@ -0,0 +1,40 @@
+module Zoopla
+  
+  module Listings
+    
+    # Searches for rental listings
+    class Rentals < API
+      
+      include Zoopla::Listings::Listing
+      
+      def initialize(*args)
+        super(*args)
+        reset!
+      end                         
+      
+      # Include property listings that are already rented in the results
+      # @return [Rentals]
+      def include_rented
+        @request[:include_rented] = '1'
+        self
+      end
+      
+      # Specify whether or not the apartment is "furnished", "unfurnished" or "part-furnished".
+      # @return [Rentals]
+      def furnished(value)
+        ensure_valid_parameter('furnished', value, %w(furnished unfurnished part-furnished))
+        @request[:furnished] = value.to_s
+        self
+      end
+      
+      private
+      
+      def default_parameters
+        {:listing_status => 'rent'}
+      end
+                  
+    end
+    
+  end
+  
+end

data/lib/zoopla/listings/sales.rb

@@ -0,0 +1,32 @@
+module Zoopla
+  
+  module Listings
+    
+    # Searches for sales listings
+    class Sales < API
+      
+      include Zoopla::Listings::Listing
+      
+      def initialize(*args)
+        super(*args)
+        reset!
+      end      
+      
+      # Whether to include property listings that are already sold in the results
+      # @return [Sales]
+      def include_sold
+        @request[:include_sold] = '1'
+        self
+      end                   
+      
+      private
+      
+      def default_parameters
+        {:listing_status => 'sale'}
+      end
+      
+    end
+    
+  end
+  
+end

data/lib/zoopla/version.rb

@@ -0,0 +1,11 @@
+module Zoopla
+
+  module Version
+    MAJOR = 0
+    MINOR = 1
+    PATCH = 0
+
+    STRING = [MAJOR, MINOR, PATCH].compact.join('.')
+  end
+
+end

data/test/api_replies/big_request_page1.js

@@ -0,0 +1 @@
+{"result_count":12,"country":"England","area_name":null,"longitude":-0.054738,"listing":[{"image_caption":"","num_floors":"0","listing_status":"rent","num_bedrooms":"2","agent_name":"DAA Residential","latitude":51.50675,"num_recepts":"0","agent_address":"61 Garnet Street Wapping","property_type":"Flat","country":null,"longitude":-0.0547228,"displayable_address":"Riverside Mansions, Milk Yard, Wapping E1W ","floor_plan":[],"street_name":"","num_bathrooms":"0","thumbnail_url":"http://images.zoopla.co.uk/c92297fba9dd2d7c2c7e1b326054ad4c1da3e176_80_60.jpg","description":"Stunning two bedrooms apartment situated in the heart of Wapping. The property benefits from wooden flooring, modern fitted kitchen, modern fitted bathroom and a balcony. This spacious apartment is furnished to a good standard and has an allocated parking space. Located just minutes walk from Wapping overground station and all local amenities. Viewing is highly advised.","post_town":"London","price_change":[{"date":"2011-02-18 18:12:20","price":"385"}],"details_url":"http://www.zoopla.co.uk/to-rent/details/14103688","agent_logo":"http://static.zoopla.co.uk/zoopla_static_agent_logo_(39922).jpeg","outcode":"E1W","agent_phone":"020 3318 6038","image_url":"http://images.zoopla.co.uk/c92297fba9dd2d7c2c7e1b326054ad4c1da3e176_354_255.jpg","price":"385","county":"London","listing_id":"14103688"},{"image_caption":"","num_floors":"0","listing_status":"rent","num_bedrooms":"2","agent_name":"DAA Residential","latitude":51.50675,"num_recepts":"0","agent_address":"61 Garnet Street Wapping","property_type":"Flat","country":null,"longitude":-0.0547228,"displayable_address":"Riverside Mansions, Milk Yard E1W ","floor_plan":[],"street_name":"","thumbnail_url":"http://images.zoopla.co.uk/739ed95a0c622ebf405dd2d60156f2d83989f301_80_60.jpg","num_bathrooms":"0","description":"Fabulous 2 bedroom split level apartment located in the heart of Wapping. The property benefits of wooden floor, modern fitted kitchen, modern fitted bathroom and a balcony. This spacious apartment is furnished to a very high standard. The property is located 5 minutes walking from Wapping station and all amenities. Viewing is highly advised.","post_town":"London","price_change":[{"date":"2010-06-03 07:46:51","price":"380"},{"date":"2010-07-03 15:55:21","price":"370"},{"date":"2011-01-29 10:26:47","price":"365"}],"details_url":"http://www.zoopla.co.uk/to-rent/details/11143019","agent_logo":"http://static.zoopla.co.uk/zoopla_static_agent_logo_(39922).jpeg","outcode":"E1W","agent_phone":"020 3318 6038","image_url":"http://images.zoopla.co.uk/739ed95a0c622ebf405dd2d60156f2d83989f301_354_255.jpg","price":"365","county":"London","listing_id":"11143019"},{"image_caption":"","num_floors":"0","listing_status":"rent","num_bedrooms":"2","agent_name":"Ludlowthompson.com - City / Docklands","latitude":51.50675,"num_recepts":"0","agent_address":"3 - 5 Dock Street","property_type":"Flat","country":null,"longitude":-0.0547228,"displayable_address":"Milk Yard, London E1W","floor_plan":[],"street_name":"Milk Yard","thumbnail_url":"http://images.zoopla.co.uk/25b8e2939d105d9c52e3bcf4bb29d729d0d9da94_80_60.jpg","num_bathrooms":"0","description":"Are delighted to present this stunning 2 bedroom in the sought after Riverside Mansions in Wapping. This flat is very tasteful and is of a high standard. Close to all transport and amenities and within a minutes walk to the river, this property is sure to go soon. This property is also offered with an allocated parkign space and the development has a residents gym. Call the team on to arrange viewingsbedroom 2nd aspect","post_town":"London","price_change":[{"date":"2011-02-23 22:07:34","price":"360"}],"details_url":"http://www.zoopla.co.uk/to-rent/details/14131677","agent_logo":"http://static.zoopla.co.uk/zoopla_static_agent_logo_(48990).gif","outcode":"E1W","agent_phone":"020 3318 8254","image_url":"http://images.zoopla.co.uk/25b8e2939d105d9c52e3bcf4bb29d729d0d9da94_354_255.jpg","price":"360","county":"London","listing_id":"14131677"},{"image_caption":"","num_floors":"0","listing_status":"rent","num_bedrooms":"2","agent_name":"Ea2","latitude":51.50675,"num_recepts":"0","agent_address":"Heritage Court 8-10 Sampson Street","property_type":"Flat","country":null,"longitude":-0.0547228,"displayable_address":"Riverside Mansions Milk Yard, Wapping, Wapping","floor_plan":[],"street_name":"","thumbnail_url":"http://images.zoopla.co.uk/5eec9be8a3a2fc8e12759f1c9bbe0123d31e6521_80_60.jpg","num_bathrooms":"0","description":"Re-furbished 2 double bedroom duplex apartment within this secure day porterage development.Benefiting from a reception, fitted kitchen/ diner, first floor bathroom and timber flooring.Use of communal gymnasium. Within easy access to the City or Docklands.\n\n \n\n","post_town":"London","price_change":[{"date":"2010-11-29 20:03:20","price":"350"}],"details_url":"http://www.zoopla.co.uk/to-rent/details/13660947","agent_logo":"http://static.zoopla.co.uk/zoopla_static_agent_logo_(27804).gif","outcode":"E1W","agent_phone":"020 3318 7006","image_url":"http://images.zoopla.co.uk/5eec9be8a3a2fc8e12759f1c9bbe0123d31e6521_354_255.jpg","price":"350","county":"London","listing_id":"13660947"},{"image_caption":"Picture No.01","num_floors":"0","listing_status":"rent","num_bedrooms":"2","agent_name":"Atkinson Mcleod","latitude":51.50675,"num_recepts":"0","agent_address":"135 Leman Street, Aldgate","property_type":"Flat","country":null,"longitude":-0.0547228,"displayable_address":"Riverside Mansions, Milk Yard, London E1W","floor_plan":["http://content.zoopla.co.uk/a4818c686f0ee9922cab90019ca2be5d7c6e1595.jpg"],"street_name":"Milk Yard London","thumbnail_url":"http://images.zoopla.co.uk/3ba654b063c87144e75036c5d75bf289a2a3f072_80_60.jpg","num_bathrooms":"0","description":"Bright and spacious two bedroom split level apartment located in an attractive Wapping development with a gym. This property will suit a couple or sharers!\n\nOur Ref: rpl/iupload/CTY110751","post_town":"London","price_change":[{"date":"2011-02-01 19:01:08","price":"350"}],"details_url":"http://www.zoopla.co.uk/to-rent/details/13982466","agent_logo":"http://static.zoopla.co.uk/zoopla_static_agent_logo_(26302).gif","outcode":"E1W","agent_phone":"020 3318 9246","image_url":"http://images.zoopla.co.uk/3ba654b063c87144e75036c5d75bf289a2a3f072_354_255.jpg","price":"350","county":"London","listing_id":"13982466"},{"image_caption":"living room","num_floors":"0","listing_status":"rent","num_bedrooms":"2","agent_name":"Oliver Franklin","latitude":51.50675,"num_recepts":"0","agent_address":"452 Roman Road","property_type":"Flat","country":null,"longitude":-0.0547228,"displayable_address":"Milk Yard, London","floor_plan":[],"street_name":"Riverside Mansions","thumbnail_url":"http://images.zoopla.co.uk/c3ffd074745bef6bd0d878affd5bb37f7d5945e4_80_60.jpg","num_bathrooms":"1","description":"Oliver Franklin are pleased to offer you this 2 double bedroom apartment in Wapping. Located on the second floor (with lift) in a private development with a well looked after communal garden.\n\n* Two Double Bedrooms With Double Beds And Double Wardrobes\n\n* Spacious Living Room With Real Wood Flooring\n\n* Separate Kitchen And Dining Room With All Appliances\n\n* Ceramic Tiled Luxury Bathroom With Shower\n\n* Only A Few Minutes Walk To The Station\n\n* Close To Shops\n\n","post_town":"London","price_change":[{"date":"2010-09-01 10:10:02","price":"350"}],"details_url":"http://www.zoopla.co.uk/to-rent/details/11999097","agent_logo":"http://static.zoopla.co.uk/zoopla_static_agent_logo_(42235).jpeg","outcode":"E1W","agent_phone":"020 3463 0153","image_url":"http://images.zoopla.co.uk/c3ffd074745bef6bd0d878affd5bb37f7d5945e4_354_255.jpg","price":"350","county":"London","listing_id":"11999097"},{"image_caption":"","num_floors":"0","listing_status":"rent","num_bedrooms":"2","agent_name":"Future Pad London","latitude":51.50675,"num_recepts":"0","agent_address":"70 Commercial Street","property_type":"Flat","country":null,"longitude":-0.0547228,"displayable_address":"Milk Yard, London","floor_plan":[],"street_name":"","thumbnail_url":"http://images.zoopla.co.uk/f1171c10b389ca6825abc249cad52ee92694bf54_80_60.jpg","num_bathrooms":"0","description":"Light and airy, newly painted, spacious two double bedroomed, split level apartment with stripped wooden flooring, new beds and bedding, situated in private residential development in the heart of Wapping, said residential development having gym and porter on site.","post_town":"London","price_change":[{"date":"2010-04-07 18:12:06","price":"350"}],"details_url":"http://www.zoopla.co.uk/to-rent/details/4311103","agent_logo":"http://static.zoopla.co.uk/zoopla_static_agent_logo_(45169).jpeg","outcode":"E1W","agent_phone":"020 3318 6552","image_url":"http://images.zoopla.co.uk/f1171c10b389ca6825abc249cad52ee92694bf54_354_255.jpg","price":"350","county":"London","listing_id":"4311103"},{"image_caption":"Picture No.02","num_floors":"0","listing_status":"rent","num_bedrooms":"2","agent_name":"Atkinson Mcleod","latitude":51.50675,"num_recepts":"0","agent_address":"135 Leman Street, Aldgate","property_type":"Flat","country":null,"longitude":-0.0547228,"displayable_address":"Riverside Mansions, Milk Yard, Wapping, London E1W","floor_plan":["http://content.zoopla.co.uk/e285e706908f968037fe9d038fdf7850da01fb9d.jpg"],"street_name":"Milk Yard Wapping London","thumbnail_url":"http://images.zoopla.co.uk/727bd23897b078a29af28b96790f22c879cb6b17_80_60.jpg","num_bathrooms":"0","description":"A bright and spacious two bed duplex apartment, set within a popular development. 5 minutes walk to the tube & excellent bus links to the city and Liverpool street. Available now call today to be the first to view this fantastic two bed. Our Ref: rpl/iupload/CTY110750","post_town":"London","price_change":[{"date":"2011-02-01 19:01:08","price":"345"}],"details_url":"http://www.zoopla.co.uk/to-rent/details/13982465","agent_logo":"http://static.zoopla.co.uk/zoopla_static_agent_logo_(26302).gif","outcode":"E1W","agent_phone":"020 3318 9246","image_url":"http://images.zoopla.co.uk/727bd23897b078a29af28b96790f22c879cb6b17_354_255.jpg","price":"345","county":"London","listing_id":"13982465"},{"image_caption":"","num_floors":"0","listing_status":"rent","num_bedrooms":"2","agent_name":"Sector One Properties","latitude":51.50675,"num_recepts":"0","agent_address":"Berkeley Business Centre Crown House","property_type":"Flat","country":null,"longitude":-0.0547228,"displayable_address":"Milk Yard, London","floor_plan":[],"street_name":"Milk Yard","thumbnail_url":"http://images.zoopla.co.uk/6f4c5176c85cf210222a5ed2f013f4b799280364_80_60.jpg","num_bathrooms":"0","description":"We are pleased to offer for rent this 2 bedroom duplex apartment in the popular Riverside Mansions, Wapping. The property comprises of 2 double bedrooms, bathroom, reception, balcony and a separate kitchen. Secure parking and gym facility. Minutes from Wapping & Shadwell Station with excellent transport links. Call now to arrange a viewing and avoid disappointment.\n\n","post_town":"London","price_change":[{"date":"2011-02-24 12:00:02","price":"340"}],"details_url":"http://www.zoopla.co.uk/to-rent/details/14137087","agent_logo":null,"outcode":"E1W","agent_phone":"020 3318 8407","image_url":"http://images.zoopla.co.uk/6f4c5176c85cf210222a5ed2f013f4b799280364_354_255.jpg","price":"340","county":"London","listing_id":"14137087"},{"image_caption":"","num_floors":"0","listing_status":"rent","num_bedrooms":"1","agent_name":"Cluttons","latitude":51.50549,"num_recepts":"1","agent_address":"3 Wapping High Street Wapping","property_type":"Flat","country":null,"longitude":-0.054776,"displayable_address":"New Crane Place, London","floor_plan":[],"street_name":"New Crane Wharf, New Crane Place","thumbnail_url":"http://images.zoopla.co.uk/f70ddb4b505d2b723734c36e742de11d43f18846_80_60.jpg","num_bathrooms":"1","description":"A delightful one bedroom apartment situated on the 3rd floor of this popular riverside warehouse conversion. The accommodation comprises reception room, open-plan fitted kitchen, double bedroom, bathroom. New Crane Wharf further benefits from secure parking and 24 hour concierge and is ideally located for access to the City and Canary Wharf via the local bus routes D3 and 100 and is just moments from Wapping Overground station.\n","post_town":"London","price_change":[{"date":"2011-01-21 18:45:33","price":"325"}],"details_url":"http://www.zoopla.co.uk/to-rent/details/13911134","agent_logo":"http://static.zoopla.co.uk/zoopla_static_agent_logo_(37477).data","outcode":"E1W","agent_phone":"020 3318 6830","image_url":"http://images.zoopla.co.uk/f70ddb4b505d2b723734c36e742de11d43f18846_354_255.jpg","price":"325","county":"London","listing_id":"13911134"}],"street":null,"radius":"0.1","town":"","latitude":51.50639,"county":"London","postcode":"E1W 3TJ","bounding_box":{"latitude_min":51.5049442933003,"longitude_min":-0.0561837066996885,"longitude_max":-0.0532922933003115,"latitude_max":51.5078357066997}}

data/test/api_replies/big_request_page2.js

@@ -0,0 +1 @@
+{"result_count":12,"country":"England","area_name":null,"longitude":-0.054738,"listing":[{"image_caption":"","num_floors":"0","listing_status":"rent","num_bedrooms":"2","agent_name":"City Hive","latitude":51.50675,"agent_address":"149A Cannon Street Road","num_recepts":"1","property_type":"Flat","country":null,"longitude":-0.0547228,"displayable_address":"Milk Yard, London","floor_plan":[],"street_name":"","num_bathrooms":"1","thumbnail_url":"http://images.zoopla.co.uk/7232217d10ec6af5e4223626cb2aa6109901d5a9_80_60.jpg","description":"City Hive are pleased to introduce this fantastic 2 bedroom Flat within 5 minutes of Wapping and Tower Hill station. Offered fully furnished, the property comprises of a bright spacious living area, Fitted Kitchen that benefits from fridge/freezer. There is 2 good sized double room, wooded flooring, and wardrobes and bathroom. Easy walking distance to the world famous Tower Bridge and the London riverside. The location has a great bars and restaurants to offer. Excellent transport link to move around London quickly with numerous tube and bus routes and very close to local amenities. Easy travel to Canary Wharf and London Bridge. Tube lines:\n\nLondon Overground\n\nFrom Tower Hill (Dlr, District line, Hammersmith & City line)\n\nNational Rail\n\nLondon Fenchurch Street\n\nBus routes:\n\nBus 100, Bus D3 and from Tower Hill Bus 15, Bus 25, Bus 42, Bus 78, Bus RV1\n\nUniversities nearby:\n\nThe London Metropolitan University\n\nCity Of London College\n\nBusiness School Of London\n\nKings College\n\nImperial College\n\nLondon South Bank University\n\nQueen Mary College\n\nUniversity College London (Ucl)\n\nUniversity Of Greenwich\n\nWapping E1W\n\nShadwell E1\n\nTower Hill E1","post_town":"London","price_change":[{"date":"2011-01-10 19:05:03","price":"320"}],"details_url":"http://www.zoopla.co.uk/to-rent/details/13835518","agent_logo":"http://static.zoopla.co.uk/zoopla_static_agent_logo_(49600).jpeg","outcode":"E1W","agent_phone":"020 8166 1405","image_url":"http://images.zoopla.co.uk/7232217d10ec6af5e4223626cb2aa6109901d5a9_354_255.jpg","price":"320","county":"London","listing_id":"13835518"},{"image_caption":"","num_floors":"1","listing_status":"rent","num_bedrooms":"2","agent_name":"Sector One Properties","latitude":51.50675,"num_recepts":"1","agent_address":"Berkeley Business Centre Crown House","property_type":"Flat","country":null,"longitude":-0.0547228,"displayable_address":"Milk Yard, London E1W","floor_plan":[],"street_name":"","thumbnail_url":"http://images.zoopla.co.uk/12908108b6041d2399a6dfaa0af928961ab78670_80_60.jpg","num_bathrooms":"1","description":"We are delighted to offer for rent this lovely 2 bedroom flat in Wapping. The property boasts 2 bedrooms, fitted kitchen, large bathroom with easy access to Docklands and The City. Call now to avoid disappointment!","post_town":"London","price_change":[{"date":"2011-01-10 11:25:02","price":"319"}],"details_url":"http://www.zoopla.co.uk/to-rent/details/13833828","agent_logo":null,"outcode":"E1W","agent_phone":"020 3318 8407","image_url":"http://images.zoopla.co.uk/12908108b6041d2399a6dfaa0af928961ab78670_354_255.jpg","price":"319","county":"London","listing_id":"13833828"}],"street":null,"radius":"0.1","town":"","latitude":51.50639,"county":"London","postcode":"E1W 3TJ","bounding_box":{"latitude_min":51.5049442933003,"longitude_min":-0.0561837066996885,"longitude_max":-0.0532922933003115,"latitude_max":51.5078357066997}}

data/test/api_replies/postcode.js

@@ -0,0 +1 @@
+{"result_count":1,"country":"England","area_name":null,"longitude":-0.054738,"listing":[{"image_caption":"Picture No.05","num_floors":"0","listing_status":"rent","num_bedrooms":"1","agent_name":"Atkinson Mcleod","latitude":51.50639,"num_recepts":"0","agent_address":"135 Leman Street, Aldgate","property_type":"Flat","country":null,"longitude":-0.054738,"displayable_address":"Prospect Place, Wapping Wall, Wapping, London E1W","floor_plan":["http://content.zoopla.co.uk/18d7d607146d3f0ea8cd46c48b5984084613a8ce.jpg"],"street_name":"Wapping Wall Wapping London","thumbnail_url":"http://images.zoopla.co.uk/f03d30a35c97bf20825af1db8f9e52e1c936dd42_80_60.jpg","num_bathrooms":"0","description":"Charming one double bedroom apartment in popular modern development in the heart of Wapping. Recently refurbished, the apartment is bright and spacious and also benefits from secure parking and views of landscaped gardens. Call now!!\n\nOur Ref: rpl/iupload/CTL070029","post_town":"London","price_change":[{"date":"2010-07-23 19:12:46","price":"265"},{"date":"2011-01-06 19:00:45","price":"275"}],"details_url":"http://www.zoopla.co.uk/to-rent/details/11695072","agent_logo":"http://static.zoopla.co.uk/zoopla_static_agent_logo_(26302).gif","outcode":"E1W","agent_phone":"020 3318 9246","image_url":"http://images.zoopla.co.uk/f03d30a35c97bf20825af1db8f9e52e1c936dd42_354_255.jpg","price":"275","county":"London","listing_id":"11695072"}],"street":null,"town":"","latitude":51.50639,"county":"London","postcode":"E1W 3TJ","bounding_box":{"latitude_min":"51.506390","longitude_min":"-0.054738","longitude_max":"-0.054738","latitude_max":"51.506390"}}

data/test/helper.rb

@@ -0,0 +1,24 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'test/unit'
+require 'mocha'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib', '..'))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'zoopla'
+
+class Test::Unit::TestCase
+  
+  def api_reply(name)
+    File.read("api_replies/#{name}.js")
+  end
+  
+end

data/test/test_zoopla_listings.rb

@@ -0,0 +1,274 @@
+require 'helper'
+
+class TestZooplaListings < Test::Unit::TestCase
+  
+  def setup
+    @rentals = Zoopla::Listings::Rentals.new('abcdef123')
+    @sales   = Zoopla::Listings::Sales.new('abcdef123')
+  end
+  
+  def test_reset_for_sales
+    @sales.include_sold
+    assert_equal({:listing_status=>"sale", :include_sold => '1'}, @sales.instance_variable_get('@request'))
+    @sales.reset!
+    assert_equal({:listing_status=>"sale"}, @sales.instance_variable_get('@request'))
+  end
+  
+  def test_reset_for_rentals
+    @rentals.include_rented
+    assert_equal({:listing_status=>"rent", :include_rented => '1'}, @rentals.instance_variable_get('@request'))
+    @rentals.reset!
+    assert_equal({:listing_status=>"rent"}, @rentals.instance_variable_get('@request'))
+  end
+  
+  def test_in
+    listing_parameter_test(:in, {:postcode => 'E1W 3TJ'}, {:postcode => 'E1W 3TJ'})
+  end
+  
+  def test_within
+    listing_parameter_test(:within, 2, {:radius => 2})    
+  end
+  
+  def test_radius
+    listing_parameter_test(:radius, 2, {:radius => 2})
+  end
+  
+  def test_order_by
+    listing_parameter_test(:order_by, :age, {:order_by => 'age'})
+    listing_parameter_test(:order_by, :price, {:order_by => 'price'})
+    assert_raise RuntimeError do
+      listing_parameter_test(:order_by, :blah, {}) 
+    end
+    assert_raise RuntimeError do
+      listing_parameter_test(:order_by, nil, {}) 
+    end
+  end
+  
+  def test_ordering
+    listing_parameter_test(:ordering, :ascending, {:ordering => 'ascending'})
+    listing_parameter_test(:ordering, :descending, {:ordering => 'descending'})
+    assert_raise RuntimeError do
+      listing_parameter_test(:ordering, :blah, {}) 
+    end    
+    assert_raise RuntimeError do
+      listing_parameter_test(:ordering, nil, {}) 
+    end    
+  end
+  
+  def test_include_sold
+    @sales.include_sold
+    expected = {:listing_status=>"sale", :include_sold => '1'}
+    assert_equal expected, @sales.instance_variable_get('@request')    
+  end
+  
+  def test_include_rented
+    @rentals.include_rented
+    expected = {:listing_status=>"rent", :include_rented => '1'}
+    assert_equal expected, @rentals.instance_variable_get('@request')        
+  end
+  
+  def test_minimum_price
+    listing_parameter_test(:minimum_price, 300, {:minimum_price => 300})
+    assert_raise RuntimeError do
+      listing_parameter_test(:minimum_price, nil, {}) 
+    end    
+    assert_raise RuntimeError do
+      listing_parameter_test(:minimum_price, -200, {}) 
+    end        
+  end
+  
+  def test_maximum_price
+    listing_parameter_test(:maximum_price, 500, {:maximum_price => 500})
+    assert_raise RuntimeError do
+      listing_parameter_test(:maximum_price, nil, {}) 
+    end    
+    assert_raise RuntimeError do
+      listing_parameter_test(:maximum_price, -200, {}) 
+    end        
+  end
+  
+  def test_price
+    listing_parameter_test(:for, 200..500, {:minimum_price => 200, :maximum_price => 500})
+    listing_parameter_test(:price, 200..500, {:minimum_price => 200, :maximum_price => 500})
+    listing_parameter_test(:price, 200..200, {:minimum_price => 200, :maximum_price => 200})
+    listing_parameter_test(:price, 200, {:minimum_price => 200, :maximum_price => 200})
+    assert_raise RuntimeError do
+      listing_parameter_test(:price, -200, {}) 
+    end            
+    assert_raise RuntimeError do
+      listing_parameter_test(:price, 500..200, {}) 
+    end            
+    assert_raise RuntimeError do
+      listing_parameter_test(:price, nil, {}) 
+    end            
+  end  
+  
+  def test_minimum_beds
+    listing_parameter_test(:minimum_beds, 3, {:minimum_beds => 3})
+    assert_raise RuntimeError do
+      listing_parameter_test(:minimum_beds, nil, {}) 
+    end    
+    assert_raise RuntimeError do
+      listing_parameter_test(:minimum_beds, -2, {}) 
+    end        
+  end
+  
+  def test_maximum_beds
+    listing_parameter_test(:maximum_beds, 5, {:maximum_beds => 5})
+    assert_raise RuntimeError do
+      listing_parameter_test(:maximum_beds, nil, {}) 
+    end    
+    assert_raise RuntimeError do
+      listing_parameter_test(:maximum_beds, -2, {}) 
+    end        
+  end
+  
+  def test_beds
+    listing_parameter_test(:beds, 2..5, {:minimum_beds => 2, :maximum_beds => 5})
+    listing_parameter_test(:beds, 2..2, {:minimum_beds => 2, :maximum_beds => 2})
+    listing_parameter_test(:beds, 2, {:minimum_beds => 2, :maximum_beds => 2})
+    assert_raise RuntimeError do
+      listing_parameter_test(:beds, -2, {}) 
+    end            
+    assert_raise RuntimeError do
+      listing_parameter_test(:beds, 5..2, {}) 
+    end            
+    assert_raise RuntimeError do
+      listing_parameter_test(:beds, nil, {}) 
+    end            
+  end  
+  
+  def test_furnished
+    listing_parameter_test(:furnished, 'furnished', {:furnished => 'furnished'})
+    listing_parameter_test(:furnished, 'unfurnished', {:furnished => 'unfurnished'})
+    listing_parameter_test(:furnished, 'part-furnished', {:furnished => 'part-furnished'})
+    assert_raise RuntimeError do
+      listing_parameter_test(:furnished, 'semi-furnished', {})
+    end
+    assert_raise RuntimeError do
+      listing_parameter_test(:furnished, nil, {})
+    end
+  end
+  
+  def test_property_type
+    listing_parameter_test(:property_type, 'houses', {:property_type => 'houses'})
+    listing_parameter_test(:property_type, 'flats', {:property_type => 'flats'})
+    assert_raise RuntimeError do
+      listing_parameter_test(:property_type, nil, {})
+    end    
+    assert_raise RuntimeError do
+      listing_parameter_test(:property_type, 'igloos', {})
+    end    
+  end
+  
+  def test_houses
+    @sales.houses
+    expected = {:listing_status=>"sale", :property_type => 'houses'}
+    assert_equal expected, @sales.instance_variable_get('@request')    
+  end
+  
+  def test_flats
+    @sales.flats
+    expected = {:listing_status=>"sale", :property_type => 'flats'}
+    assert_equal expected, @sales.instance_variable_get('@request')    
+  end
+  
+  def test_keywords
+    listing_parameter_test(:keywords, 'very cheap centrally located spacious modern duplex', {:keywords => 'very cheap centrally located spacious modern duplex'})
+  end
+  
+  def test_listing_id
+    listing_parameter_test(:listing_id, 7, {:listing_id => [7]})
+    listing_parameter_test(:listing_id, 11, {:listing_id => [7, 11]})
+    listing_parameter_test(:listing_id, 13, {:listing_id => [7, 11, 13]})
+  end
+  
+  def test_forming_the_request_by_chaining
+    @rentals.flats
+            .in({:postcode => 'E1W 3TJ'})
+            .within(2)
+            .price(200..400)
+            .beds(1..2)
+            .furnished('furnished')
+            .include_rented
+            .order_by(:price)
+            .ordering(:descending)
+    expected = { :listing_status=>"rent",
+                 :property_type=>"flats",
+                 :postcode=>"E1W 3TJ",
+                 :radius=>2,
+                 :minimum_price=>200,
+                 :maximum_price=>400,
+                 :minimum_beds=>1,
+                 :maximum_beds=>2,
+                 :furnished=>"furnished",
+                 :include_rented=>"1",
+                 :order_by=>"price",
+                 :ordering=>"descending"}
+    assert_equal expected, @rentals.instance_variable_get('@request')
+  end
+  
+  def test_only_correct_listing_types_requested_for_sales
+    @sales.in({:postcode => 'E1W 3TJ'})
+    expected = {:listing_status=>"sale", :postcode => 'E1W 3TJ'}
+    assert_equal expected, @sales.instance_variable_get('@request')    
+  end
+  
+  def test_only_correct_listing_types_requested_for_rentals
+    @rentals.in({:postcode => 'E1W 3TJ'})
+    expected = {:listing_status=>"rent", :postcode => 'E1W 3TJ'}
+    assert_equal expected, @rentals.instance_variable_get('@request')    
+  end
+  
+  def test_requesting_multiple_results_pages_transparently
+    mock = mock();
+    mock.expects(:process_listing).times(12);
+    page1 = @rentals.send :preprocess, JSON.parse(api_reply('big_request_page1'))
+    page2 = @rentals.send :preprocess, JSON.parse(api_reply('big_request_page2'))
+    @rentals.stubs(:fetch_data).returns(page1, page2)
+    @rentals.in({:postcode => 'E1W 3TJ'}).within(0.1).price(300..400).each {|listing|
+      mock.process_listing
+    }    
+  end
+  
+  def test_deep_parsing_the_reply
+    _, reply = @rentals.send(:preprocess, JSON.parse(api_reply('postcode')))
+    listing = reply.first
+    assert_equal 11695072, listing.listing_id
+    assert_equal 'rent', listing.listing_status    
+    assert_equal 275, listing.price
+    assert_equal 'Atkinson Mcleod', listing.agent_name
+    assert_equal '135 Leman Street, Aldgate', listing.agent_address
+    assert_equal 'http://static.zoopla.co.uk/zoopla_static_agent_logo_(26302).gif', listing.agent_logo
+    assert_match(/^Charming one double bedroom apartment .+Our Ref: rpl\/iupload\/CTL070029$/m, listing.description)
+    assert_equal 'http://www.zoopla.co.uk/to-rent/details/11695072', listing.details_url
+    assert_equal 'Prospect Place, Wapping Wall, Wapping, London E1W', listing.displayable_address
+    assert_equal 'http://content.zoopla.co.uk/18d7d607146d3f0ea8cd46c48b5984084613a8ce.jpg', listing.floor_plan.first
+    assert_equal 'Picture No.05', listing.image_caption
+    assert_equal 'http://images.zoopla.co.uk/f03d30a35c97bf20825af1db8f9e52e1c936dd42_354_255.jpg', listing.image_url
+    assert_equal 51.50639, listing.latitude
+    assert_equal(-0.054738, listing.longitude)
+    assert_equal 0, listing.num_bathrooms
+    assert_equal 1, listing.num_bedrooms
+    assert_equal 0, listing.num_floors
+    assert_equal 0, listing.num_recepts
+    assert_equal 'E1W', listing.outcode
+    assert_equal 'London', listing.post_town
+    assert_equal 265, listing.price_change.first.price
+    assert_equal Date.parse('2010-07-23 19:12:46'), listing.price_change.first.date
+    assert_equal 275, listing.price_change.last.price
+    assert_equal Date.parse('2011-01-06 19:00:45'), listing.price_change.last.date
+    assert_equal 'Flat', listing.property_type
+    assert_equal 'Wapping Wall Wapping London', listing.street_name
+    assert_equal 'http://images.zoopla.co.uk/f03d30a35c97bf20825af1db8f9e52e1c936dd42_80_60.jpg', listing.thumbnail_url
+  end
+  
+  private
+  
+  def listing_parameter_test(param, value, result)
+    @rentals.send(param, value)
+    expected = {:listing_status=>"rent"}.merge! result
+    assert_equal expected, @rentals.instance_variable_get('@request')        
+  end
+  
+end

data/zoopla.gemspec

@@ -0,0 +1,83 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{zoopla}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Evgeny Shadchnev"]
+  s.date = %q{2011-03-03}
+  s.description = %q{Access zoopla.co.uk API from ruby scripts. Fetch sales and rental properties for the UK}
+  s.email = %q{evgeny.shadchnev@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.markdown"
+  ]
+  s.files = [
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.markdown",
+    "Rakefile",
+    "VERSION",
+    "lib/zoopla.rb",
+    "lib/zoopla/api.rb",
+    "lib/zoopla/listings.rb",
+    "lib/zoopla/listings/listing.rb",
+    "lib/zoopla/listings/rentals.rb",
+    "lib/zoopla/listings/sales.rb",
+    "lib/zoopla/version.rb",
+    "test/api_replies/big_request_page1.js",
+    "test/api_replies/big_request_page2.js",
+    "test/api_replies/postcode.js",
+    "test/helper.rb",
+    "test/test_zoopla_listings.rb",
+    "zoopla.gemspec"
+  ]
+  s.homepage = %q{http://github.com/shadchnev/zoopla}
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.5.2}
+  s.summary = %q{Access zoopla.co.uk API from ruby scripts}
+  s.test_files = [
+    "test/helper.rb",
+    "test/test_zoopla_listings.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<zoopla>, [">= 0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.5.2"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+      s.add_development_dependency(%q<mocha>, [">= 0.9.12"])
+      s.add_development_dependency(%q<mocha>, [">= 0.9.12"])
+      s.add_runtime_dependency(%q<hashie>, [">= 1.0.0"])
+      s.add_development_dependency(%q<mocha>, [">= 0.9.12"])
+    else
+      s.add_dependency(%q<zoopla>, [">= 0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+      s.add_dependency(%q<mocha>, [">= 0.9.12"])
+      s.add_dependency(%q<mocha>, [">= 0.9.12"])
+      s.add_dependency(%q<hashie>, [">= 1.0.0"])
+      s.add_dependency(%q<mocha>, [">= 0.9.12"])
+    end
+  else
+    s.add_dependency(%q<zoopla>, [">= 0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+    s.add_dependency(%q<mocha>, [">= 0.9.12"])
+    s.add_dependency(%q<mocha>, [">= 0.9.12"])
+    s.add_dependency(%q<hashie>, [">= 1.0.0"])
+    s.add_dependency(%q<mocha>, [">= 0.9.12"])
+  end
+end
+

metadata

@@ -0,0 +1,166 @@
+--- !ruby/object:Gem::Specification 
+name: zoopla
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Evgeny Shadchnev
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-03-03 00:00:00 +00:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: zoopla
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  prerelease: false
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: jeweler
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.5.2
+  type: :development
+  prerelease: false
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rcov
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  prerelease: false
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: mocha
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.9.12
+  type: :development
+  prerelease: false
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: mocha
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.9.12
+  type: :development
+  prerelease: false
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
+  name: hashie
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *id007
+- !ruby/object:Gem::Dependency 
+  name: mocha
+  requirement: &id008 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.9.12
+  type: :development
+  prerelease: false
+  version_requirements: *id008
+description: Access zoopla.co.uk API from ruby scripts. Fetch sales and rental properties for the UK
+email: evgeny.shadchnev@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+- README.markdown
+files: 
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.markdown
+- Rakefile
+- VERSION
+- lib/zoopla.rb
+- lib/zoopla/api.rb
+- lib/zoopla/listings.rb
+- lib/zoopla/listings/listing.rb
+- lib/zoopla/listings/rentals.rb
+- lib/zoopla/listings/sales.rb
+- lib/zoopla/version.rb
+- test/api_replies/big_request_page1.js
+- test/api_replies/big_request_page2.js
+- test/api_replies/postcode.js
+- test/helper.rb
+- test/test_zoopla_listings.rb
+- zoopla.gemspec
+has_rdoc: true
+homepage: http://github.com/shadchnev/zoopla
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: -2640295004611012173
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.5.2
+signing_key: 
+specification_version: 3
+summary: Access zoopla.co.uk API from ruby scripts
+test_files: 
+- test/helper.rb
+- test/test_zoopla_listings.rb