next-big-sound 0.1.1 → 0.1.2

data/README.rdoc

@@ -2,6 +2,56 @@
 
 This is the start of a ruby api wrapper for nextbigsound.com.  This gem will provide a reasonable ruby wrapper for all methods in the public API.
 
+This code was written by jeff at musicxray.com if you think you can do better send us and email and we can chat about job opportunities.
+
+<b>installation:</b>
+	
+	gem install xml-simple
+	
+	gem install next-big-sound
+
+<b>usage:</b>
+		
+	require 'rubygems'
+	require 'next-big-sound'
+		
+	nbs = NBS::Base.new('YOUR_API_KEY')
+		
+	searchobj = nbs.search("The Killers")
+		
+	# retrieve list of artists that returned from the search
+	searchobj.artists
+		
+	# get the id of the artist
+	searchobj.artists.first.artist_id  # can be useful to store for later use.
+		
+	# get the first artist that you find and find
+	# all associated profiles.   myspace, ilike ....
+	
+	profiles = searchobj.artists.first.profiles 
+		
+	# get the url for a specific service
+		
+	profiles["MYSPACE"]
+		
+	# in addition.  There is are magic method for retrieving data
+	# if you want myspace plays for example you would get it like this
+	
+	artist = 	searchobj.artists.first
+
+  # this will fetch you a month worth of myspace plays data	
+	artist.myspace_plays("1/1/2010","2/1/2010")
+	
+	# this will find all fans for a particular artist across all
+	# services.
+	artist.all_fans("1/1/2010","2/1/2010")
+	
+	# The data points are returned as an array of datasets
+	# One dataset per profile Datasets can be sorted by date 
+	
+	#  TODO: this stuff is still be implemented.
+
+
 == Note on Patches/Pull Requests
  
 * Fork the project.

data/VERSION

@@ -1 +1 @@
-0.1.1
+0.1.2

data/lib/artist.rb

@@ -32,12 +32,9 @@ module NBS
     
     def method_missing(method_name,*args)
       if splits = method_name.to_s.split("_")
-        puts args.inspect
         sdate = Date.parse(args[0].to_s)
         edate = Date.parse(args[1].to_s)
         opts = options.merge({"service"=>splits[0],"metric"=>splits[1],"start"=>sdate.to_s,"end"=>edate.to_s})
-        puts opts.inspect
-        puts "http://api.nextbigsound.com/v1_1/getDataForArtist?#{opts.to_url_params}"
         return Net::HTTP.get(URI.parse("#{NBS::NBS_CONFIG["base_url"]}getDataForArtist?#{opts.to_url_params}")).to_s
       else
         raise "Sorry that method does not exist. The proper format for finding data is service_metric(start,end)"

data/lib/search.rb

@@ -13,22 +13,19 @@ module NBS
       self.api_key = api_key
       self.base_url = base_url
     end
-  
     def fetch
       self.xml=Net::HTTP.get(URI.parse("#{NBS::NBS_CONFIG["base_url"]}search?#{self.options.to_url_params}")).to_s
     end
-    
     def artists
-      hash = Hash.from_xml(self.xml)
+      hash = Hash.from_xml(self.to_xml)
       a = []
       hash["Results"][0]["Result"].each do |item|
        a << Artist.new(item["NBSArtistID"][0],item["NBSArtistName"][0])
       end
       return a
     end
-    
     def to_xml
-      self.xml
+      self.xml ||=fetch
     end
   end
 end

data/next-big-sound.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{next-big-sound}
-  s.version = "0.1.1"
+  s.version = "0.1.2"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["jeff durand"]
-  s.date = %q{2010-03-26}
+  s.date = %q{2010-03-27}
   s.description = %q{A simple wrapper class for the Next Big Sound api.  docs for the api can be found at api.nextbigsound.com}
   s.email = %q{jeff.durand@gmail.com}
   s.extra_rdoc_files = [

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 1
-  - 1
-  version: 0.1.1
+  - 2
+  version: 0.1.2
 platform: ruby
 authors: 
 - jeff durand
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-03-26 00:00:00 -04:00
+date: 2010-03-27 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency