oodle 1.1.3 → 1.1.4

data/README.markdown

@@ -25,9 +25,9 @@ key](http://developer.oodle.com/request-api-key) to get started.
     oodle.num = '15'
     oodle.sort = 'ctime_reverse'
     results = oodle.fetch_listings
-    num = results['current']['num']
+    num = results['meta']['returned']
     listings = results['listings']
-    (0..num-1).each { |i| p listings[i]['title'] }
+    0.upto(num - 1) { |i| p listings[i]['title'] }
 
 ## Dependencies
 

data/lib/oodle.rb

@@ -16,11 +16,7 @@ module Oodle
   VERSION_URLS = {:v2=>"http://api.oodle.com/api/v2/listings"}
   RESPONSE_FORMATS = {
     :xml=>'xml', # - output is formatted in plain old XML
-    :json=>'json', # - output is fromatted in JSON (JavaScript Object Notation)
-    :php_serial=>'php_serial', # - output structure formatted in serialized PHP
-    :php_export=>'php_export', # - output structure formatted as valid PHP
-    :dump=>'dump', # - output is dumped with no formatting
-    :rss2=>'rss2' # - listing information returned in RSS 2.0 format
+    :json=>'json' # - output is formatted in JSON (JavaScript Object Notation)
   }
   
   SORT_VALUES = {
@@ -62,6 +58,22 @@ module Oodle
     # Requires version be set
     # Build the url from the state of the current self
     def build_url
+      unless key && key.length > 0
+        raise ArgumentError, 'Missing API key parameter. Visit http://developer.oodle.com/request-api-key/ to get one.'
+      end
+
+      unless region && region.length > 0
+          raise ArgumentError, 'Missing region paramter. Visit http://developer.oodle.com/regions-list/ for possible regions.'
+      end
+
+      unless (category && category.length > 0) || (q && q.length > 0)
+          raise ArgumentError, 'You must supply a category or query parameter. Visit http://developer.oodle.com/categories-list/ for possible categories.'
+      end
+
+      unless num.to_i >= 1 && num.to_i <= 50
+        warn "num parameter is #{num.to_i} but should be between 1 and 50"
+      end
+
       url = VERSION_URLS[self.version]
       url += "?" unless url && url[-1] == '?'
       # must CGI escape each param value
@@ -71,9 +83,9 @@ module Oodle
       url = "#{url}&q=#{CGI::escape(self.q)}" if self.q
       url = "#{url}&attributes=#{CGI::escape(self.attributes_as_string)}" if self.attributes.size > 0
       url = "#{url}&location=#{CGI::escape(self.location)}" if self.location
-      url = "#{url}&radius=#{CGI::escape(self.radius)}" if self.radius
-      url = "#{url}&start=#{CGI::escape(self.start)}" if self.start
-      url = "#{url}&num=#{CGI::escape(self.num)}" if self.num
+      url = "#{url}&radius=#{CGI::escape(self.radius.to_s)}" if self.radius
+      url = "#{url}&start=#{CGI::escape(self.start.to_s)}" if self.start
+      url = "#{url}&num=#{CGI::escape(self.num.to_s)}" if self.num
       url = "#{url}&sort=#{CGI::escape(self.sort)}" if self.sort
       url = "#{url}&refinements=#{CGI::escape(self.refinements_as_string)}" if self.refinements.size > 0
       url = "#{url}&ctime_low=#{CGI::escape(self.ctime_low)}" if self.ctime_low
@@ -107,10 +119,6 @@ module Oodle
 =begin
   xml - output is formatted in plain old XML
   json - output is fromatted in JSON (JavaScript Object Notation)
-  php_serial - output structure formatted in serialized PHP
-  php_export - output structure formatted as valid PHP
-  dump - output is dumped with no formatting
-  rss2 - listing information returned in RSS 2.0 format
 =end    
     def fetch_raw(format=nil)
       @format = RESPONSE_FORMATS[format] if format
@@ -128,14 +136,6 @@ module Oodle
         result = XmlSimple.xml_in raw, { 'ForceArray' => false, 'AttrPrefix' => true }
       when 'json'
         result = JSON.parse(raw)
-      when 'php_serial'
-        # return raw
-      when 'php_export'
-        # return raw
-      when 'dump'
-        # return raw
-      when 'rss2'
-        # TODO parse rss2 raw
       end
       result = raw unless result
       result

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 1
   - 1
-  - 3
-  version: 1.1.3
+  - 4
+  version: 1.1.4
 platform: ruby
 authors: 
 - Kristan 'Krispy' Uccello
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-04-05 00:00:00 -04:00
+date: 2010-04-10 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency