jonaustin-rockstar 0.7.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d592c200873023f91fc16692fe0340f027e11d55
+  data.tar.gz: 90af841dae93e46038fc61378a0562ebd7af5907
+SHA512:
+  metadata.gz: 1dfc64aa10a817d68fafe8f58666e2c6b8819fb0705199be93f2829a1b54109885de4aeeff2bc018074b3016d604fb4de63b581ee8d3ec1518443a30784107f9
+  data.tar.gz: 8e79c9dba95451a1a0217dae1171d1b7483091234aebcb98cc5d92d87431c7647a774ee1a8677018ee75e653a770e2b1d2fa009801d2773e7797ed33961da8e6

data/.travis.yml

@@ -0,0 +1,8 @@
+notifications:
+  recipients:
+    - jon.i.austin@gmail.com
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - 2.0.0

data/Gemfile

@@ -0,0 +1,10 @@
+source "https://rubygems.org"
+
+gem "rake"
+gem "hpricot", ">=0.4.86"
+gem "i18n"
+gem "activesupport", ">=1.4.2"
+
+group :development do
+    gem "jeweler"
+end

data/Gemfile.lock

@@ -0,0 +1,62 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (3.0.8)
+    addressable (2.3.5)
+    builder (3.2.2)
+    descendants_tracker (0.0.3)
+    faraday (0.8.9)
+      multipart-post (~> 1.2.0)
+    git (1.2.6)
+    github_api (0.11.1)
+      addressable (~> 2.3)
+      descendants_tracker (~> 0.0.1)
+      faraday (~> 0.8, < 0.10)
+      hashie (>= 1.2)
+      multi_json (>= 1.7.5, < 2.0)
+      nokogiri (~> 1.6.0)
+      oauth2
+    hashie (2.0.5)
+    highline (1.6.20)
+    hpricot (0.8.4)
+    httpauth (0.2.0)
+    i18n (0.5.0)
+    jeweler (2.0.0)
+      builder
+      bundler (>= 1.0)
+      git (>= 1.2.5)
+      github_api
+      highline (>= 1.6.15)
+      nokogiri (>= 1.5.10)
+      rake
+      rdoc
+    json (1.8.1)
+    jwt (0.1.10)
+      multi_json (>= 1.5)
+    mini_portile (0.5.2)
+    multi_json (1.8.4)
+    multi_xml (0.5.5)
+    multipart-post (1.2.0)
+    nokogiri (1.6.1)
+      mini_portile (~> 0.5.0)
+    oauth2 (0.9.2)
+      faraday (~> 0.8)
+      httpauth (~> 0.2)
+      jwt (~> 0.1.4)
+      multi_json (~> 1.0)
+      multi_xml (~> 0.5)
+      rack (~> 1.2)
+    rack (1.5.2)
+    rake (0.8.7)
+    rdoc (4.1.1)
+      json (~> 1.4)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activesupport (>= 1.4.2)
+  hpricot (>= 0.4.86)
+  i18n
+  jeweler
+  rake

data/History.txt

@@ -0,0 +1,6 @@
+* v 0.4.0: Add geo class and support for events and locations
+* v 0.3.0: update api to use v2.0 of the last.fm api and renamed gem to "Rockstar Gem"
+* v 0.2.3: changed the way things get escaped in hopes that it would fix some problems some were having
+* v 0.2.2: a bunch of changes from titanous, mostly refactoring
+* v 0.2.0: added support for scrobbling tracks and now playing submission (Titanous)
+* v 0.1.0: initial release

data/MIT-LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2007-2011 John Nunemaker, Bodo Tasche
+
+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/Manifest

@@ -0,0 +1,72 @@
+History.txt
+MIT-LICENSE
+Manifest
+README.rdoc
+Rakefile
+examples/album.rb
+examples/artist.rb
+examples/lastfm.yml_example
+examples/scrobble.rb
+examples/tag.rb
+examples/track.rb
+examples/user.rb
+lib/rockstar.rb
+lib/rockstar/album.rb
+lib/rockstar/artist.rb
+lib/rockstar/auth.rb
+lib/rockstar/base.rb
+lib/rockstar/chart.rb
+lib/rockstar/playing.rb
+lib/rockstar/rest.rb
+lib/rockstar/scrobble.rb
+lib/rockstar/session.rb
+lib/rockstar/simpleauth.rb
+lib/rockstar/tag.rb
+lib/rockstar/tokenauth.rb
+lib/rockstar/track.rb
+lib/rockstar/user.rb
+lib/rockstar/version.rb
+test/fixtures/xml/album/getinfo_album_Some_Hearts_artist_Carrie_Underwood.xml
+test/fixtures/xml/artist/getsimilar_artist_Metallica.xml
+test/fixtures/xml/artist/gettopalbums_artist_Metallica.xml
+test/fixtures/xml/artist/gettopfans_artist_Metallica.xml
+test/fixtures/xml/artist/gettoptags_artist_Metallica.xml
+test/fixtures/xml/artist/gettoptracks_artist_Metallica.xml
+test/fixtures/xml/tag/gettopalbums_tag_rock.xml
+test/fixtures/xml/tag/gettopartists_tag_rock.xml
+test/fixtures/xml/tag/gettoptags.xml
+test/fixtures/xml/tag/gettoptracks_tag_rock.xml
+test/fixtures/xml/track/gettopfans_artist_Carrie_Underwood_track_Before_He_Cheats.xml
+test/fixtures/xml/track/gettoptags_artist_Carrie_Underwood_track_Before_He_Cheats.xml
+test/fixtures/xml/track/love_artist_Carrie_Underwood_sk_tag_track_Before_He_Cheats.xml
+test/fixtures/xml/user/getfriends_user_jnunemaker.xml
+test/fixtures/xml/user/getinfo_user_jnunemaker.xml
+test/fixtures/xml/user/getinfo_user_oaknd1.xml
+test/fixtures/xml/user/getinfo_user_wharle.xml
+test/fixtures/xml/user/getlovedtracks_user_jnunemaker.xml
+test/fixtures/xml/user/getneighbours_user_jnunemaker.xml
+test/fixtures/xml/user/getrecenttracks_user_jnunemaker.xml
+test/fixtures/xml/user/getrecommendedartists_sk_token_user_jnunemaker.xml
+test/fixtures/xml/user/gettopalbums_user_jnunemaker.xml
+test/fixtures/xml/user/gettopartists_user_jnunemaker.xml
+test/fixtures/xml/user/gettoptags_user_jnunemaker.xml
+test/fixtures/xml/user/gettoptracks_user_jnunemaker.xml
+test/fixtures/xml/user/getweeklyalbumchart_from_1138536002_to_1139140802_user_jnunemaker.xml
+test/fixtures/xml/user/getweeklyalbumchart_from__to__user_jnunemaker.xml
+test/fixtures/xml/user/getweeklyartistchart_from_1138536002_to_1139140802_user_jnunemaker.xml
+test/fixtures/xml/user/getweeklyartistchart_from__to__user_jnunemaker.xml
+test/fixtures/xml/user/getweeklychartlist_user_jnunemaker.xml
+test/fixtures/xml/user/getweeklytrackchart_from_1138536002_to_1139140802_user_jnunemaker.xml
+test/fixtures/xml/user/getweeklytrackchart_from__to__user_jnunemaker.xml
+test/mocks/rest.rb
+test/test_helper.rb
+test/unit/test_album.rb
+test/unit/test_artist.rb
+test/unit/test_chart.rb
+test/unit/test_playing.rb
+test/unit/test_scrobble.rb
+test/unit/test_simpleauth.rb
+test/unit/test_tag.rb
+test/unit/test_tokenauth.rb
+test/unit/test_track.rb
+test/unit/test_user.rb

data/README.md

@@ -0,0 +1,173 @@
+# Rockstar [![Build Status](https://secure.travis-ci.org/putpat/rockstar.png?branch=master)](https://next.travis-ci.org/putpat/rockstar)
+
+Rockstar is a wrapper for the last.fm audioscrobbler web services (http://www.last.fm/api/). This gem is based on the scrobbler
+gem by John Nunemaker and was updated to use the 2.0 version of the last.fm api
+
+Below is just a sampling of how easy this lib is to use.
+
+Please initialize your api key and secret before using the api:
+
+    Rockstar.lastfm = YAML.load_file('lastfm.yml')
+
+Here is an example lastfm.yml:
+
+    api_key: "API"
+    api_secret: "SECRET"
+
+If you want to use the api in an rails app, you could add an initializer in config/initializers/lastm.rb and load a config/lastfm.yml file.
+
+    rails_root = ENV['RAILS_ROOT'] || File.dirname(__FILE__) + '/../..'
+    Rockstar.lastfm =  YAML.load_file(rails_root + '/config/lastfm.yml')
+    
+Alternatively you can provide a hash with the api key and secret:
+
+    Rockstar.lastfm = {:api_key => "API", :api_secret => "SECRET"}
+
+## Users
+
+    user = Rockstar::User.new('jnunemaker')
+
+    puts "#{user.username}'s Recent Tracks"
+    puts "=" * (user.username.length + 16)
+    user.recent_tracks.each { |t| puts t.name }
+
+    puts
+    puts
+
+    puts "#{user.username}'s Top Tracks"
+    puts "=" * (user.username.length + 13)
+    user.top_tracks.each { |t| puts "(#{t.playcount}) #{t.name}" }
+
+## Albums
+
+    album = Rockstar::Album.new('Carrie Underwood', 'Some Hearts', :include_info => true)
+
+    puts "Album: #{album.name}"
+    puts "Artist: #{album.artist}"
+    puts "URL: #{album.url}"
+    puts "Release Date: #{album.release_date.strftime('%m/%d/%Y')}"
+
+## Artists
+
+If you want to load all informations about an artist or any other
+object, you have to add `:include_info => true` .
+
+    artist = Rockstar::Artist.new('Carrie Underwood', :include_info => true)
+
+    puts artist.url
+
+    puts 'Top Tracks'
+    puts "=" * 10
+    artist.top_tracks.each { |t| puts "(#{t.name}" }
+
+    puts
+
+    puts 'Similar Artists'
+    puts "=" * 15
+    artist.similar.each { |a| puts "(#{a.match}%) #{a.name}" }
+
+## Tags
+
+    tag = Rockstar::Tag.new('country')
+
+    puts 'Top Albums'
+    tag.top_albums.each { |a| puts "(#{a.count}) #{a.name} by #{a.artist}" }
+
+    puts
+
+    puts 'Top Tracks'
+    tag.top_tracks.each { |t| puts "(#{t.count}) #{t.name} by #{t.artist}" }
+
+## Geo
+
+    geo = Rockstar::Geo.new
+
+    # Get events for a lat/long
+    geo.events(:lat => 50.0, :long => 12.3).each{|e| p "#{e.title} at #{e.venue.name}"}
+
+    # Get events for a location
+    geo.events(:location => 'london').each{|e| p "#{e.title} at #{e.venue.name}"}
+
+    # To get a list of possible locations use
+    geo.metros("germany").each{|m| p m.name}
+
+    # Retrieve list of top tracks by country
+    geo.toptracks('united kingdom', 10).each{|t| p "#{t.name} by #{t.artist}"}
+
+    # Retrieve list of top artists by country
+    geo.topartists('united kingdom', 10).each{|a| p "artist #{a.name} with #{a.listenercount} listeners"}
+
+
+## Library
+
+	# Get artists and albums for user
+    library = Rockstar::Library.new
+
+    puts 'Artists'
+    library.artists(false, :user => 'jnunemaker').each { |a| puts a.name }
+    
+    puts 'Albums'
+    library.albums(false, :user => 'jnunemaker').each { |a| puts a.name }
+
+	# Get it with Rockstar::User
+    user = Rockstar::User.new('jnunemaker')
+    
+    puts 'Artists'
+    user.artists.each { |a| puts a.name }
+    
+    puts 'Albums'
+    user.albums.each { |a| puts a.name }
+
+##  Get rights to access the user data for scrobbing, now playing, events etc...
+
+    a = Rockstar::Auth.new
+    token = a.token
+
+    puts
+    puts "Please open http://www.last.fm/api/auth/?api_key=#{Rockstar.lastfm_api_key}&token=#{token}"
+    puts
+    puts "Press enter when done."
+
+    gets
+
+    session = a.session(token)
+
+You can store the session.key somewhere and use it from now on to identify the user. More
+details can be found in Rockstar::Auth or examples/scrobble.rb
+
+## Tracks
+
+    track = Rockstar::Track.new('Carrie Underwood', 'Before He Cheats')
+    puts 'Fans'
+    puts "=" * 4
+    track.fans.each { |u| puts "(#{u.weight}) #{u.username}" }
+
+    track.love(session.key)
+
+## Scrobbling
+
+    track = Rockstar::Track.new('Carrie Underwood', 'Before He Cheats')
+    track.scrobble(Time.now, session.key)
+
+## Now Playing Submission
+
+    track = Rockstar::Track.new('Carrie Underwood', 'Before He Cheats')
+    track.updateNowPlaying(Time.now, session.key)
+
+## Note on Patches/Pull Requests
+
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+## Copyright
+
+Copyright (c) 2007-2011 John Nunemaker, Bodo "Bitboxer" Tasche, Nick "zapnap" Plante. See LICENSE for details.
+
+## Acknowledgements
+
+Thanks to [putpat.tv](http://www.putpat.tv) for sponsering the work on the rockstar gem.

data/Rakefile

@@ -0,0 +1,32 @@
+# Rakefile
+require 'rubygems'
+require 'rake'
+require File.expand_path('../lib/rockstar/version', __FILE__)
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "jonaustin-rockstar"
+    gem.summary = %Q{wrapper for audioscrobbler (last.fm) web services}
+    gem.description = %Q{This gem is an updated version of jnunemakers scrobbler gem. Rockstar uses v2.0 of the last.fm api.}
+    gem.email = "jon.i.austin@gmail.com"
+    gem.homepage = "http://github.com/jonaustin/rockstar"
+    gem.authors = ["Jon Austin", "Bodo Tasche"]
+    gem.add_dependency("hpricot", ">=0.4.86")
+    gem.add_dependency("activesupport", ">=1.4.2")
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+#task :test => :check_dependencies
+
+task :default => :test

data/VERSION

@@ -0,0 +1 @@
+0.7.1

data/examples/.gitignore

@@ -0,0 +1 @@
+lastfm.yml

data/examples/album.rb

@@ -0,0 +1,16 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib', 'rockstar'))
+
+# Please enter your API-Keys into lastfm.yml first. 
+# You can find them here : http://www.lastfm.de/api/account
+Rockstar.lastfm = YAML.load_file(File.join(File.dirname(__FILE__), 'lastfm.yml'))
+
+album = Rockstar::Album.new('Carrie Underwood', 'Some Hearts', :include_info => true)
+
+puts "Album: #{album.name}"
+puts "Artist: #{album.artist}"
+puts "URL: #{album.url}"
+puts "Release Date: #{album.release_date.strftime('%m/%d/%Y')}"
+puts "Large cover: #{album.image_large}"
+puts
+puts
+puts "Summary: #{album.summary}"

data/examples/artist.rb

@@ -0,0 +1,25 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib', 'rockstar'))
+
+# Please enter your API-Keys into lastfm.yml first. 
+# You can find them here : http://www.lastfm.de/api/account
+Rockstar.lastfm = YAML.load_file(File.join(File.dirname(__FILE__), 'lastfm.yml'))
+
+artist = Rockstar::Artist.new('Metallica', :include_info => true)
+
+puts artist.url
+
+puts 'Top Tracks'
+puts "=" * 10
+artist.top_tracks.each { |t| puts "#{t.name}" }
+
+puts
+
+puts 'Events'
+puts '=' * 10
+artist.events.each { |e| puts "#{e.venue.city} at #{e.venue.name} on #{e.start_date.strftime("%D")}" }
+
+puts
+
+puts 'Similar Artists'
+puts "=" * 15
+artist.similar.each { |a| puts "(#{a.match}%) #{a.name}" }