ronnie 0.7.6 → 0.8.0

data/README.md

@@ -1,10 +1,18 @@
-# ronnie [![Build Status](https://secure.travis-ci.org/2a6U37Nn/ronnie.png)](http://travis-ci.org/2a6U37Nn/ronnie) [![Code Climate](https://codeclimate.com/badge.png)](https://codeclimate.com/github/2a6U37Nn/ronnie)
+# ronnie [![Build Status](https://secure.travis-ci.org/2a6U37Nn/ronnie.png?branch=master)][travis] [![Dependency Status](https://gemnasium.com/2a6U37Nn/ronnie.png?travis)][gemnasium] [![Code Climate](https://codeclimate.com/badge.png)][codeclimate]
 
-Library for accessing the Rdio API from Ruby. Chirp, chirp!
+[travis]: http://travis-ci.org/2a6U37Nn/ronnie
+[gemnasium]: https://gemnasium.com/2a6U37Nn/ronnie
+[codeclimate]: https://codeclimate.com/github/2a6U37Nn/ronnie
+
+Library for accessing the Rdio API from Ruby.
 
 ## Installation
 
-    gem 'ronnie', '~> 7.6.0'
+    gem 'ronnie', '~> 8.0.0'
+
+## API Documentation
+
+* [http://rdoc.info/gems/ronnie](http://rdoc.info/gems/ronnie)
 
 ## Usage
 
@@ -12,152 +20,38 @@ Library for accessing the Rdio API from Ruby. Chirp, chirp!
 
 ### OAuth
 
-**Note**—the following constants are examples. You’ll need to [register your application](http://developer.rdio.com) with Rdio to retrieve a unique `CONSUMER_KEY` and `CONSUMER_SECRET`. If you’d like to request authorized resources, you’ll need to create a `OAUTH_TOKEN` and `OAUTH_TOKEN_SECRET`.
-
 #### Authentication
 
+The following constants are **examples**.
+
+You’ll need to [register your application](http://developer.rdio.com) with Rdio to retrieve a unique `CONSUMER_KEY` and `CONSUMER_SECRET`.
+
     CONSUMER_KEY    = 'q32tvp74n5hazpbr93tbjkem'
     CONSUMER_SECRET = 'nXcryfbVDP'
     
-    client = Ronnie::Client.new consumer_key:    CONSUMER_KEY,
-                             consumer_secret: CONSUMER_SECRET
+    @client = Ronnie::Client.new consumer_key:    ENV['CONSUMER_KEY'],
+                                 consumer_secret: ENV['CONSUMER_SECRET']
 
 #### Authorization
 
+If you’d like to request authorized resources, you’ll need to create a `OAUTH_TOKEN` and `OAUTH_TOKEN_SECRET`.
+
     OAUTH_TOKEN        = 'zd565qbzvwadxtd4fr3bpcda3ym42shwcxsbyu4t49gv6xxjhp7tjvre4xwr8gue'
     OAUTH_TOKEN_SECRET = 'baA2KgCSAW3D'
 
-    client.token        = OAUTH_TOKEN
-    client.token_secret = OAUTH_TOKEN_SECRET
-
-## API
-
-### Albums
-
-#### Retrieve Album
-
-    client.album('a610550')
-
-#### Find Albums by Artist
-
-    client.find_albums_by_artist('r235282')
-
-#### Find Albums by Label
-
-    client.find_albums_by_label('')
-
-#### Find Albums by UPC
-
-    client.find_albums_by_upc('652637001228')
-
-#### Search Albums
-
-    client.search_albums('Clear Moon')
-
-### Artists
-
-#### Find Artists by Label
-
-    client.find_artists_by_label('l2270')
-
-#### Search Artists
-
-    client.search_artists('Mount Eerie')
-
-### Playlists
-
-#### Retrieve Playlists by User
-
-    client.playlists('s112675')
-
-#### Retrieve Playlists by Authorized User
-
-    client.playlists
-
-#### Search Playlists
-
-    client.search_playlists('AirR&B&B')
-
-#### Retrieve Playlist
-
-    client.playlist('p87188')
+    @client.token        = OAUTH_TOKEN
+    @client.token_secret = OAUTH_TOKEN_SECRET
 
-#### Create a Playlist
+### Requests
 
-    client.create_playlist(
-      'Your Ecclesiastical Adolescence',
-      'Music performed by Winona Ryder as Lelaina Pierce.',
-      ['t20680151', 't20680150']
-    )
+    @client.search_artists('Mount Eerie')
 
-##### Required Arguments 
+## Contributions
 
-* **Name** (String): playlist name.
-* **Description** (String): playlist description.
-* **Tracks** (Array): playlist contents.
-
-#### Delete a Playlist
-
-    client.delete_playlist('p87188')
-
-### Tracks
-
-#### Find Tracks by Artist
-
-    client.find_tracks_by_artist('r235282')
-
-#### Find Tracks by ISRC
-
-    client.find_tracks_by_isrc('GBAYE0200771')
-
-#### Search Tracks
-
-    client.search_tracks('Through The Trees pt. 2')
-
-### Users
-
-#### Retrieve User
-
-    client.user('s112675')
-
-#### Retrieve Authorized User
-
-    client.user
-
-#### Find User by E-mail Address
-
-    client.find_user('allen.goodman@me.com')
-
-#### Search Users
-
-    client.search_users('Allen Goodman')
-
-#### Retrieve Followers of a User
-
-    client.followers('s112675')
-
-#### Retrieve Followers of Authorized User
-
-    client.followers
-
-#### Retrieve Users Following Another User
-
-    client.following('s112675')
-
-#### Retrieve Users Following Authorized User
-
-    client.following
-
-#### Follow a User
-
-    client.follow('s112675')
-
-#### Unfollow a User
-
-    client.unfollow('s112675')
-
-## Tests
+### Installation
 
     $ bundle install
 
-    $ bundle exec foreman run rspec
+### RSpec
+
+    $ bundle exec rspec

data/banner.txt

@@ -0,0 +1,79 @@
+
+MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMNNMNMMMMMM8MMMMMNNNNMMMMMMMMMMMMNMMMMMMMMMDMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
+MMMMMMMMMMMMMMMMMMMMMMMMMMNMMNMMMMMMMMNMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMNMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
+MMMMMMMMMMMMMMMMMMMMMMMMMMMNMMMMNMMMNNMMMMNMMMMMMMMMMMMMMMMMMMMDMMMMMMMMMMMMMMMMMMMMNMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
+MMMMMMMMMMMMMMMMMMMMMMMMNNMMMMMMMMMMNNMMMMMNNDNMMMMMMMMMMMMMMMMMDMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
+MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMNMMMMMMMMMMMNMMMMMMMMMMMMMMMMMMNMMMNMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
+MMMMMMMMMMMMMMNMMMMMMMM8NNM8NMMNNNMM8MMMMMMMMMMMMMMMNNMMMNMNMMMMMMNMMMMMMMMMMMNNMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
+MMMMMMMMMMMMMMMMMMMMMMMMNNMMMNNMNMMMMMMMMNMMMMMMMMMN8DDDNNNNDMNMMMMNNMNMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
+MMMMMMMMMMMMNMNMMMMMMMMMMMMDNDNMMMMMMMMMMNMMMMMNMNONDDD8DD88DDNDD8MNNMNMMMMMMMMMNNMMMMMNMNMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
+MMMMMMMMMMMMNN8NMMMMNMMMDMNNMMMMMMMMMMMN8DMMMM$MNN8ODO$$Z8D8O8O88DDMNNNMMMMMMMNMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
+MMMMMMMMMMMMNNNMMMMNNNMMMNNNMMMMMMNMMMMMN8NMMNNN8ODOO$$Z?NO$OZZZ$O8ZDNNMMMMMMMMMNNMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
+MMMMMMMMMMNMMNNMMMNNMMMMNMMMMMMMMMMNMMNNNMNMMND88O877I?=I?OZ?$?+7I$Z$O8NMNMMMNMMNDMMMMMMMM8NMMMMMMMMMMMMMMMMMMMMMMMMMMMM
+MMMMMMMMMMMMMMMNMMMNNMMNNNMMMMMMMMMMNMMMN8ODNO8$IO8+?~~+==I++?$Z$77ZZ$O8NMMNNDMM8MOMMMMMMNNDDMMMMMMMMMMMMMMMMMMMMMMMMMMM
+MMMMMMMMMMNNMMMMNMMMMMMM8MMMMMMMMNNMMNDOO$ODD87$Z$Z+?=+~~~:=+?=7+?$$$7$NODNMMNNMMMMMMDMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
+MMMMMMMMMMMNMMMNMNNNMNMNNMMMMMMMMMMNND8D87OZDZIZD=7++:~~+~==+~==I?I7ZZOZNZ8NMNMMMNMMNNMNMMMMMMMNMD8MMMMMMMMMMMMMMMMMMMMM
+MMMMMMMMMMNMMNNNNNMNNMMMMNMMMNNNNMNNNDDOODODDION?I?~=+~::~:=+=~+~+?$ZD7ZZDO88NMMMMMMMMMMMMMNNMMNMNNMMMMMMMMMMMMMMMMMMMMM
+MMMMMMMMMNMMNNNMMNNMMNMMNMNMNMMNMMDMDNDIO8ND88Z?+~=?:~,,::~:~=+??++IIZ$$$DD8D8NMMMMMMMMMMMMMMNNNNMMMMMMMMMMMMMMMMMMMMMMM
+MMMMNNNNNMNNNNNDNNMNNMMNNMDMDMNMNMMDMMD88ZDD$7?+++=::,,::~=~:==+=?+==?7$ZZD8NDMMMMMMMNNMMMMNMMMMDMNMMMMMMMMMMMMMMMMMMMMM
+MMMMMMMNMNMNNMMNNNMMMM8NNNNDNMOMDNDODMN888D+?=~~+=,,:..,:,:~::~=+?~~~=?77O88DMMMMMMMMMMMMMMNMMMMMMDMMMMMMMMMMMMMMMMMMMMM
+MMNMMMMMMMNMMNNMMMMMMNMNN8NNNNDNNDOZZ8Z?I++++==~,,,,..:,,,,,,:~=+=~~~~=$$ZNNNNMMMMMMMMMMNMMMNNMMMDNNNMMMMMMMMMMMMMMMMMMM
+MMMMMMMMMNMMMMMMMMMMMMDMNONNMMNMM888Z7$I7$??~=:=:,,,,.,,..,:,,:~=+:~~=+I8$ZO8NMMMMMMMMMMMMNMNMNMMDMMMMMMMMMMMMMMMMMMMMMM
+MMMMMNMMMNMNMNMMMNNNN8MNMMMMMMNND8Z$III???+?=~:~:.:,...,,:,:::~==+::~=+I7$O88NMMMMMMMMMMMMMMNDMNMMMMMMMMMMMMMMMMMMMMMMMM
+MNMMNNMMMMMMMNMMNMNNMNNMNNMMMM8M8ZO7III???=+~~:::,.,,,,,~::,,~~~=+~~~=+I7$$ZOMMMMMMMMMMMMNMMNMMMMMMMMMMMMMMMMMNND7=+I8MN
+MMMNMMMMMNMMMMNMMMMMMNMNNNNMMMOMZZO7I?+?++=~~~~::,.,.,:,,,,,:~~=+?=~~=?7$$ZO8NMMMMMMMMMMMMNMMNNMMMMMMMMMMMMMMNNO?~~~~IDN
+MDMMNMMMNMNNMMNNNNNMNNMMNMMMMO8D$D8Z7I+++==~~~::=:,:::,,,:,:=~===?=~~==?$ZOZ8NMMMMMMMMMNDNNMNNMMMNNNMMMMMMMNND$=~~:~~?8M
+MNNMMNMNNNMNDDMMMMNMDNMMNNNNMZ7DNOOOZZI7I?=~~~~:,,::::,,,:,:~=~~=?=::~=+Z8ZZONMNMMMMMMNNMMMMNMMNMMMMMMMMMMNND$=~::~~+$NN
+NNNNMNNNDNMMNNMMMNMMNMNMNNNNDZZN8Z$77OZ8OZ+===~=~,.,.,,,,,::~~:=+?~::~=+ZDO7DNMMMMMMMMMMMMNNNMMNNNMMMMNMMMNN$+~::~==7DMN
+NMMMMNMNMMMMMMMMNMNMMMMMMNMMNOO$$$Z$88877OD8OI+==~=::,=~=:=:~+$OOI=~~==+$D8$M8MMMMMMMMMMMMMMNMMMNMNNNM8MNN8$=::::~=78NNN
+NMMMMMMMMMMNMMMNNNMMNNMMMMMMDOZ$$$Z78$$O$N$8DZ$=+?+~:==~+~??Z888O7======7OO$MOMNMMMMMNNNMNMNNNDNNNNNNMNNNZ+~:,,:~=IONNNN
+NMMMMMMMMN8OMNMMNNMMMNMNNNMND87$$$OZ77I+O?7OOOD7??==:+++?IZ888888Z=~~~~=IOOZNDNNMMMMMNNNNNNMMNMMNNNNNNN87~:::,,~=+ONNNNN
+NMNNMMMMMMMMMNNNNNNMNMNMNMMD8877IZ$77++??=III?77?+==~++I8OI?,?7DZ7=~~~~~+IO$7ONNMNNMNDM8DNMNMMNNNNNNND?~~:::::~~?8NNNNNN
+MNMMNNNNMMMMMNMMNMMMNMNNNMONOO$I?I7?III7III$I$77$++~=+$IO7$77I7I$?~::~~~+$Z7$8NNNNNNNNNNNNNNMNNNNNNN8?~~::,:::~?8NNNNNNN
+MNMMMMNDNNDNDMNMMMMMMMMMDMN88O$7?I?++=~=+I?I?77I?+~:=II$7$7ZI?~=?+~:~::::~I7$OZ7+=+IZDNNNNNNNNNNDN87~::::,,:~=7DNNNNNNNN
+NMMMNNDMMNMM8NMMMMMMMMMMDMND88$7I?7?+~~~==++?II7?=:+=?7II$?7?+77I=~::,,:,,,?7I?~~~~=+$8NNNNNNNNNN8+:,:::,:~=?$NDNNNNNMMM
+MMMMNM8MNNMMNMNMMMMMMMMNMNMD8O$$77I?+=:::~~++II7==:+=?I77III$II7?=:,,,:,,,.,~+=~~~~~=?$Z77$ODNNN8=,,:::,:~+?ZDNNNNNMNMMM
+NMMMMNNNMMMMMNMMMMMMMNMNNOMNNO7777I??==~===??I?7+~=????I??+==+====:,,,::,,,,:++~:~~==++:::~=?Z8O:,,,:::~~=I8NNNNNNMMMMMM
+MMMMMMNMMNMNMNMMMMMNMNDMDMMNDDI$$7?I?+++==++I77I+:=?II?I?++:~~=+=~,,,::::,,,:++::::==+~:,,:~+7O?,::::~~~+7DNNNNNNNMMMMMM
+MMMMNMMMMMMNMMMMMNMMMNN8MNNMND7777II?++=+?++$77?=~+?77I7?+===~==~~,:::::,,:::~=::::~~+~,,:~~=7O+~:~::~=?ZDNNNNNNNNMMMMMM
+DMMMMMMMMMMMNMNMMMMMMMNNMMNNMO777$I?++?++?+II7?+::=?I$77?+==+=~:,,,::::~:~::~+=~::~~?=:,::~=+7Z=:::~~=$DNNNNNNNNMMMMMMMM
+MDMMMMMMMMMDMMMMMMMMMMMNNMNMN87$777I???I?++$$I=:,:=+?$77I+=+=~:,,..,,:::~~=~=+~,,,,~?~,,::~=?Z7~:~~=?$NNNNNNNNNNMMMMMMMM
+MMMMMMMMNMMMNMMMMMMMMMMMMMNNND$$$$7II7?IIII+ZI+++=++I$7$?:=+:,,,..,,,::,,,::~=:,,,:~+~,,::~~78+:=~~78NNNNNMMMMMMMMMNMMMM
+MMMMMMMMMNMMNNNNNDMMMMMMMDDNMMD7$$II$I7I7II$?77?=++7O$$$=++=,,....,,,:::::::~~:,:~=?=:,,,:~+$O=~~:?8NNNNNNMMMMMMMMMMMMMM
+MMMMMMNNMNMMMMMNNNDMMMMMMNMN8MDD$$I?Z77I7I77+III$ZZ??7I+++~:,......,,::,,::~~:::~=?7~:,,,:=IZO+~:+8DDNNNNMNMMMMMMMMMMMMM
+MMMMMMN$D8MMNMMMMMMNMMMMMMDMMNN8ZZI?$ZZ$$I777??+I?==?+?I?~:,,.....,,:::::::~:,..,,:~=~:::~?ZOI~=7DDNNNNNMMNMMMMMMMMMMMMM
+MMMMMMD8$DNMMMMMMNNMMMMNMNMMMMDDZZI?I7$OZ$I??777I?=+IIII+~:,......,,::::,,,,:...,,,:~=~~==$OI=?7NNNNNNMNMMMMMMMMMMMMMMMM
+DMMMMMMNNMNMNMMMMNNMNMMNNNMMNNMONO7II$$$ZZI+?+=?7IIII7I?=::,,....,,,::::,,,:,...,,,,:~=++?O$??$8NNNNNNMNMMMMMMMMMMMMMMMM
+MMMMMNMNMMNMMMMMMMMMNNNNNMMMMMMNON$IIII77ODOOZO8ZOZOZZ7+==::,....,,,,::,,,,,,,,....:~~=I$Z$?IONDNNNNNNMMMMMMMMMMMMMMMMMM
+MNNNNDNNNNNNMNMNNNMMNNNNNNMMMMMMD88IIII7=DZOOZOZDD8Z$O7++~:,...,,,,::,,:,,,::~,,.,,:::~+$8$7ZNDNNNNMMMMMMMMMMMMMMMMMMMMM
+=IINNNDNNDDDNNMMNNNMMNNNNNMMMMMDMNOZIII$Z8DIODDDD8I+8O??=~:,...,,,,:,,,,:~==~==::,,.,,::+ODNNNNNNNNMMMMMMMMMMMMMMMMMMMMM
+=~==NNNDNNNZONNMNNNMMNMMMMMMMMMMMNM8$?I8ODNMDO$D8ZIOD7+=~:,,....,.,,,,,:~~~::::=,,..,,,:?8NNNNNNNNNMMMMMMMMMMMMMMMMMMMMM
+==+=+8ODMNNNND:88Z8MMMMMMMMMMMNMNMDNDNNNNMM8Z78DOZZD8?+~:,,,.,,...,,,,:~::,,,.,~=:,.,,:+$DNNNNNNNNMMMMMMMMMMMMMMMMMMMMMM
+=~==+?DM8NNNNNDMNNNNNNND887INMMMMMMMMMMMMNOI78DZO$ODO?=~::,,,,.,..:,,,,:,......:++====?$ODNNNNNNMNMMMMMMMMMMMMMMMMMMMMMM
+=====+?ZMZ8NM8DNNNND$OO8NMMMNNMMMMMMMMMMMD??88Z$$?ZDOI=~~::,,,...,:,,,,,,,...,.:~====+I$O8NNNNNNMMMMMMMMMMMMMMMMMMMMMMMM
++++++=?7$NMDDNNDDN8$7ODDNNNNNNNMMMMMMMMMD7?ODOO8O7$DO7+=~~:::,,,,:,,.,,,,,,,,.,,:~~~=?I$ZONNNNNNMMMMMMMMMMMMMMMMMMMMMMMM
+OOZZZOOO88OOO88D$$ZNNNNNNNNMMMMMMMMMMMMN$=78OON88Z=I8O==+==~~::::~,,,,,:,,,,,,,,,::~=+I7ZDNNMMMMMMMMMMMMMMMMMMMMMMMMMMMM
+88888OOOZZZZZODOI7NNMMMMMMMMMMMMMMMMMMMNI=OD8DMND8ODD8$==+++=~~~==:,,,,:,,,,:::,,::~=?IODNNNMMMMMMMMMMMMMMMMMMMMMMMMMMMM
+ZZOOZZ$77777ONO?IMMMMMMMMMMMMMMMMMMMMMND$IDD8NMMDDDDD88O?:~~=+?+==++=:::,,,,,:~~=?7$O8NNNMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
+ZZZZ$$I7III$D877MMMMMMMMMMMMMMMMMMMNMMMN8ZDNNNNNNNNNNNDD8I:::~~:~=?I7?+~:,,,,:~+IZ8NNMNMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
+ZZ777I????7OND~$MMMMMMMMMMNNMMMMMMMMNMMMN8DMMMMMDOODDDDNDNI:~::~::~=+III=::~~=7ODNNNMMMMMMMMMMMNMMMMMMMMMMMMMMMMMMMMMMMM
+7II?????II?8OO=MNMMMMMMMMN8DMMMMMMMMMMMMMMMMNMMMMMNMND8NNNND7++++++II7$ZZ$$Z8DMNMNMMMMNMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
+?I?++?+??+IDZ7+DNMMMMMMMMN8DMMMMMMMMMMMMMMMMMMMMDNMMMM8DND8DNNN8OZZO8NNNNNNNNNNMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
++?+?+?++=+7D$87NMMMMMMMMMD8DMMMMMMMMMMMMMMMMMMMMMMMMMMDNZID8Z88D8DDDDNMMMMMMMMMMMMMMMNMMMMMMMMMMDMMMMMMMMMMMMMMMMMMMMMMM
+=?+?+++=+=IDZI$MNNMMMMMMMMNNNMMMMMMMNMMMMMMMMMMMMMMMMMMMMMNN8NDD888ODMMMMMMMNMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
++?++======+NDI+NNMMMMMMMNMNNMMMMMMMMMMMMMMMMMMMMMMMMMMMNNNNNND8O$I7OMMMMMMMMMMMMMMMMMMMMMNMMMMMMN8MMMMMMMMMMMMMMMMMMMMMM
+++=+=======8D?=7MNMMNNNMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMNDD887?=+=:++NMMMMNNMNMMMMMMMMMMMMMMMMMNMMNMMMMMMMMMMMMMMMMMMMMMM
+=+=+=======ZNZ?7DNNNMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMNDZI+~~~~::=?MMMMMNMMMMMNMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
+++=+===+===ID8D8DNMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMND8Z7+~~==??+ZNNMNNMMMMMMMMMMMMMMMMMMMMMMMMMMMNMMMMMMMMMMMMMMMMMMM
+++==++==+++I888NNMMMMMMMMMMMMMMMMMMMMMMMMMMMMMNNNNDDO$??=~=~~=~~~+DNMMN+NMNMMMMMMMMMMMMMMMMMMMMMMMM$~NMMMMMMMMMMMMMMMMMM
+?++==+==+==?$=?Z7NMMMMMMMMMMMMMMMMMMMMMMMMMMNNDD8Z77I=+======~:~~+DMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
++?=++?==++$O7OO878ODMMMMMMMMMMMMMMMMMMMMMMMMN8ZI??+==~::~~~~~=~~+?NMMMNMMMMMMMMMMMMMMMMMMNMMMMMMNMMNNMMMMMMMMMMMMMMMMMMM
++??++++=??7ODNNN8D8=$ZZZMMMMMMMMMMMMMMMMMMMDO7??I?7I?==~~=?+==?+?7MMNMD8MMMMMMMMMMMMMMMNNNMMMMMZ??$NNMMMMMMMMMMMMMMMMMMM
+??II?????++++IZONMNOO8OZ8$~+DNNMNNDDMMMMMM8OODDNZ=,.~Z8++~~=+=+78DMNMNDNNMONMDMMMMMMMMMMMNMNNN????I7NNNMNMMMMMMMMMMMMMMM
+?+?II??I+???II7777Z8MMMMMMDD$OMNNMMMMMMMMMMNNN8N8I,.,,$8+~~=++IODN8MMZMNMMNMMMMNMMMMNMMMNNMN$???I77$$ONNMMMMMMMMMMMMMMMM
+??I77?II7777$Z$777II777ZDNMM$MMMMMMMMMMNMNMNDDDN87,.,,$$?====?Z8DN$DMMMMMMMMMMMMMMMMMMMMMNN$=???II77$$MNNNMMMMMMMMMMMMMM
+777$7I77$$ZZ$7777$$ZZ$ODMMMMMMMMMMMMMNN888NNNNOM8$:.,,O$$=~~+?Z8NN$NMMMNMMMNNMMMMMMMDNNNNNN=++??I77I7ZMDNNMMMMMMMMMMMMMM
+ZZZZZ7ZZ$$77$$Z8DNMMMMMMMMMMMNNNNNMMMZZ8DN8ODMMN8O:.,:O87=~=I78DMMONMMMNMMNNMNMMMMMMMNNNNN====++?I777$D8NNNMMMMMMMMMMMMM
+$ZZZZ$ZZZ8NNMMMMMMMMMMMMMMMMNMNNNMMMMM=NDDD88DMMD8+..:ODO==?7Z8MNM8DNOMMNNMMNMMMMMMMNNNDNN:~~==+?II77$8INMNNMMMMMMMMMMMM
+ODNMMMMMMNNMMMMMMMMMMMMMMMNNNNNNNMMMMDNDD8D8O8NDN8?=7ZDNN$$7N8MNMZNZIMMMMMMMMMMMMMMMMMOMZNZZZZOO88DDDDMMMMMMMMMMMMMMMMMM
+                                                                                                        Ronnie James Dio

data/lib/ronnie/client.rb

@@ -2,12 +2,14 @@ require 'ronnie/authentication'
 require 'ronnie/connection'
 require 'ronnie/request'
 
+require 'ronnie/client/activities'
 require 'ronnie/client/albums'
 require 'ronnie/client/artists'
 require 'ronnie/client/collections'
 require 'ronnie/client/collections/albums'
 require 'ronnie/client/collections/artists'
 require 'ronnie/client/playlists'
+require 'ronnie/client/tokens'
 require 'ronnie/client/tracks'
 require 'ronnie/client/users'
 
@@ -27,12 +29,14 @@ module Ronnie
     include Ronnie::Connection
     include Ronnie::Request
 
+    include Ronnie::Client::Activities
     include Ronnie::Client::Albums
     include Ronnie::Client::Artists
     include Ronnie::Client::Collections
     include Ronnie::Client::Collections::Albums
     include Ronnie::Client::Collections::Artists
     include Ronnie::Client::Playlists
+    include Ronnie::Client::Tokens
     include Ronnie::Client::Tracks
     include Ronnie::Client::Users
   end

data/lib/ronnie/client/activities.rb

@@ -0,0 +1,17 @@
+module Ronnie
+  class Client
+    module Activities
+      # Retrieve activity stream.
+      #
+      # @param user_id [String]
+      # @param scope [String]
+      # @example
+      #   @client.activities('a610550')
+      def activities(user_id, scope, options={})
+        required_options = { user: user_id, scope: scope }
+
+        post('getActivityStream', required_options.merge!(options))
+      end
+    end
+  end
+end

data/lib/ronnie/client/albums.rb

@@ -44,7 +44,41 @@ module Ronnie
       #   Ronnie.search_albums('Clear Moon')
       def search_albums(query, options={})
         post('search', { query: query, types: 'Album' })
-      end 
+      end
+
+      # Retrieve new releases.
+      #
+      # @example
+      #   Ronnie.new_releases
+      def new_releases(options={})
+        post('getNewReleases')
+      end
+
+      # retrieve heavily rotated albums.
+      #
+      # @example
+      #   Ronnie.heavily_rotated_albums
+      def heavily_rotated_albums(user_id=nil, friends=nil, options={})
+        if user_id 
+          required_options = { user: user_id, type: 'albums' }
+
+          if friends
+            required_options = required_options.merge!({ friends: friends })
+          end
+        else
+          required_options = { type: 'albums' }
+        end
+
+        post('getHeavyRotation', required_options.merge!(options))
+      end
+
+      # retrieve the site-wide most popular albums.
+      #
+      # @example
+      #   Ronnie.top_albums
+      def top_albums(options={})
+        post('getTopCharts', { type: "Album" })
+      end     
     end
   end
 end

data/lib/ronnie/client/artists.rb

@@ -17,7 +17,33 @@ module Ronnie
       #   Ronnie.search_artists('Mount Eerie')
       def search_artists(query, options={})
         post('search', { query: query, types: 'Artist' })
-      end     
+      end
+
+      # retrieve heavily rotated artists.
+      #
+      # @example
+      #   Ronnie.heavily_rotated_artists
+      def heavily_rotated_artists(user_id=nil, friends=nil, options={})
+        if user_id 
+          required_options = { user: user_id, type: 'artists' }
+
+          if friends
+            required_options = required_options.merge!({ friends: friends })
+          end
+        else
+          required_options = { type: 'artists' }
+        end
+
+        post('getHeavyRotation', required_options.merge!(options))
+      end
+
+      # retrieve the site-wide most popular artists.
+      #
+      # @example
+      #   Ronnie.top_artists
+      def top_artists(options={})
+        post('getTopCharts', { type: "Artist" })
+      end
     end
   end
 end

data/lib/ronnie/client/playlists.rb

@@ -154,6 +154,14 @@ module Ronnie
       def delete_playlist(playlist_id, options={})
         post('deletePlaylist', { playlist: playlist_id })
       end
+
+      # retrieve the site-wide most popular playlists.
+      #
+      # @example
+      #   Ronnie.top_playlists
+      def top_playlists(options={})
+        post('getTopCharts', { type: "Playlist" })
+      end
     end
   end
 end

data/lib/ronnie/client/tokens.rb

@@ -0,0 +1,13 @@
+module Ronnie
+  class Client
+    module Tokens
+      # create playback token.
+      #
+      # @example
+      #   Ronnie.create_token
+      def create_token(options={})
+        post('getPlaybackToken')
+      end 
+    end
+  end
+end

data/lib/ronnie/client/tracks.rb

@@ -27,6 +27,14 @@ module Ronnie
       def search_tracks(query, options={})
         post('search', { query: query, types: 'Track' })
       end
+
+      # retrieve the site-wide most popular tracks.
+      #
+      # @example
+      #   Ronnie.top_tracks
+      def top_tracks(options={})
+        post('getTopCharts', { type: "Track" })
+      end
     end
   end
 end

data/lib/ronnie/version.rb

@@ -1,3 +1,3 @@
 module Ronnie
-  VERSION = '0.7.6' unless defined?(Ronnie::VERSION)
+  VERSION = '0.8.0' unless defined?(Ronnie::VERSION)
 end