stubhub 0.0.1 → 0.0.2

data/README.md

@@ -1,6 +1,6 @@
 # Stubhub
 
-TODO: Write a gem description
+A gem for accessing the StubHub API
 
 ## Installation
 
@@ -18,7 +18,37 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+Examples
+
+```ruby
+
+# find a ticket by ticket id
+Stubhub::Ticket.find_by_ticket_id(487197960) # => returns a Ticket object
+
+# find an event by event id
+Stubhub::Event.find_by_event_id(4236091) # => returns an Event object
+
+# find tickets for an specific event
+  # first find the event
+  event = Stubhub::Event.find_by_event_id(4236091) # => returns an Event object
+  # then call tickets method on that event
+  event.tickets # => returns an array of ticket objects
+  #return the first 20 ticket listings
+  event.tickets("row" => 20) # => returns an array of ticket objects
+  #return the second 20 ticket listings
+  event.tickets("start" => 20, "row" => 20) # => returns an array of ticket objects
+
+
+# search for an event 
+  Stubhub::Event.search("swedish house mafia") # => returns an Event object
+
+# search for a venue
+  Stubhub::Venue.search("Oracle Arena") # => returns a Venue object
+
+# search for a genre  
+ Stubhub::Genre.search("ice show") # => returns a Genre object
+
+```
 
 ## Contributing
 

data/lib/stubhub.rb

@@ -1,6 +1,7 @@
 require 'json'
 require 'httparty'
 require 'ostruct'
+require 'uri'
 
 require_relative 'stubhub/document'
 require_relative 'stubhub/client'
@@ -14,11 +15,4 @@ require_relative 'stubhub/version'
 
 
 module Stubhub
- 
- # EXAMPLES -----------
- # doc types: event, venue, genre, geo (Geography), venue_zone_section (Venue Zone Section)
- # puts Stubhub::Ticket.find_by_ticket_id(487197960)
- # puts Stubhub::Event.find_by_event_id(4236091) => individual event
- # puts Stubhub::Event.search("swedish house mafia")
- # --------------------------
-end
+end

data/lib/stubhub/client.rb

@@ -5,20 +5,31 @@ module Stubhub
     base_uri "http://www.stubhub.com/listingCatalog/select/?q="
     format :json
 
-    def self.convert_query_to_url(options)
-      options.map do |k,v|
+    def self.convert_query_to_url(params, options)
+      params.map do |k,v|
         "%2B+#{k}%3A#{v}%0D%0A"
-      end.join << '&start=0&rows=10&wt=json'
+      end.join << self.defaults.merge(options).map do |k,v|
+        "&#{k}=#{v}"
+      end.join
     end
 
-    def self.make_request(klass, options)
-      query_url = convert_query_to_url(options)
+    def self.make_request(klass, params, options)
+      query_url = convert_query_to_url(params, options)
       result = get(query_url)
       parsed_result = JSON.parse(result.body)
-      parsed_result["response"]["docs"].map do |doc|
+      objects = parsed_result["response"]["docs"].map do |doc|
         klass.new(doc)
       end
+      objects.length == 1 ? objects.first : objects
     end
 
+    def self.defaults
+        @options ||= {
+          "start"   => 0,
+          "rows"    => 10,
+          "wt"      => "json"
+        }
+      end
+
   end
 end

data/lib/stubhub/event.rb

@@ -1,17 +1,23 @@
 module Stubhub
   class Event < Document
     
-    def self.find_by_event_id(event_id)
-      options = {"stubhubDocumentType" => "#{demodulize(self).downcase}",
+    def self.find_by_event_id(event_id, options = {})
+      params = {"stubhubDocumentType" => "#{demodulize(self).downcase}",
                  "event_id" => "#{event_id}"}
-      Client.make_request(Event, options)
+      Client.make_request(Event, params, options)
     end
 
-    def self.search(search_query)
-      search_query.gsub!(/\s+/, '+')
-      options = {"stubhubDocumentType" => "#{demodulize(self).downcase}",
+    def self.search(search_query, options = {})
+      search_query = URI.escape(search_query)
+      params = {"stubhubDocumentType" => "#{demodulize(self).downcase}",
                  "description" => "#{search_query}"}
-      Client.make_request(Event, options)
+      Client.make_request(Event, params, options)
+    end
+
+    def tickets(options = {})
+      params = {"stubhubDocumentType" => "ticket",
+                 "event_id" => "#{self.event_id}"}
+      Client.make_request(Ticket, params, options)
     end
 
   end

data/lib/stubhub/genre.rb

@@ -1,3 +1,11 @@
 module Stubhub
-  class Genre < Document;end
+  class Genre < Document
+    def self.search(search_query, options = {})
+      search_query = URI.escape(search_query)
+      params = {"stubhubDocumentType" => "#{demodulize(self).downcase}",
+                 "description" => "#{search_query}"}
+      Client.make_request(Event, params, options = {})
+    end
+
+  end
 end

data/lib/stubhub/ticket.rb

@@ -1,10 +1,10 @@
 module Stubhub
   class Ticket < Document
 
-    def self.find_by_ticket_id(ticket_id)
-      options = {"stubhubDocumentType" => "#{demodulize(self).downcase}",
+    def self.find_by_ticket_id(ticket_id, options = {})
+      params = {"stubhubDocumentType" => "#{demodulize(self).downcase}",
                  "id" => "#{ticket_id}"}
-      Client.make_request(Ticket, options)
+      Client.make_request(Ticket, params, options = {})
     end
 
 

data/lib/stubhub/venue.rb

@@ -1,3 +1,17 @@
 module Stubhub
-  class Venue < Document;end
+  class Venue < Document
+     def self.find_by_venue_id(venue_id, options = {})
+      params = {"stubhubDocumentType" => "#{demodulize(self).downcase}",
+                 "venue_id" => "#{venue_id}"}
+      Client.make_request(Venue, params, options = {})
+    end
+
+    def self.search(search_query, options = {})
+      search_query = URI.escape(search_query)
+      params = {"stubhubDocumentType" => "#{demodulize(self).downcase}",
+                 "description" => "#{search_query}"}
+      Client.make_request(Venue, params, options = {})
+    end
+
+  end
 end

data/lib/stubhub/version.rb

@@ -1,3 +1,3 @@
 module Stubhub
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stubhub
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-02-18 00:00:00.000000000 Z
+date: 2013-03-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: HTTParty