spotify-charts 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0ebcb11a5d72b86567c8e0bd5bfdfe286e9ab44f
-  data.tar.gz: fa021838225282fe931e0e8937e522db344b30bc
+  metadata.gz: 8970a1d4ad3b28688d0815522c3f2c639fc1f74f
+  data.tar.gz: 4614e7fdd13a9279469fa26d99a359572198cbd8
 SHA512:
-  metadata.gz: e1ae5490d5de419000109b25530598232a9e081abf2f122c658bb9fea56f92cd1b98b901cb957971ed2160858fb1d5bb40beab25be71954b30a4a661561296fc
-  data.tar.gz: cc2a0840720b6df50762b62a86f9916ec2623c2d7272f0e8648d5c11f8304ce1dd6036f6a7603ca029509c5f875f14ed1bc934713f7bec9ca0e88bf5e2b0193a
+  metadata.gz: eb5f4f0c461948e75bd98d8b8e0218d8b5319e21588818f85b2de5f745593923de32ab21ac58ed89c9dd5b899129e1b398fac6527629c8ab26b17b50b644b6aa
+  data.tar.gz: 460058353f66e6d1fca5e82181f18f74178fee2f64fda50fc3700b8f63a3b9a7ceb4fd33d8a3eea51117d26a759a2d03f6150131c407f4e611231cf575a2a296

data/CHANGELOG.md

@@ -0,0 +1,18 @@
+# v0.0.2
+  * Updated README.
+  * Added CHANGELOG.
+  * Updated LICENSE years.
+  * Changed all hashes to Ruby 1.9 hash syntax.
+  * Upgraded Ruby version to 2.2.3.
+  * Updated all gems.
+  * Stated all dependencies in the code files.
+  * Fixed changed Spotify API. Thanks to `Scott Hiller`.
+  * Renamed `most_shared` to `most_viral` to stay in sync with Spotify API.
+  * Migrates to container based Travis CI infrastructure.
+
+# v0.0.1
+  * support for `available_countries`, `available_dates(country)`, `most_streamed(country, date)`
+    and `most_shared(country, date)`
+  * added Travis CI, Gemnasium and CodeClimate integration
+  * tested with `rspec` and coverage measured with `simplecov`
+  * initial version

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2014 Falk Koeppe
+Copyright (c) 2014-2015 Falk Koeppe
 
 MIT License
 

data/README.md

@@ -6,7 +6,8 @@
 [![Build Status](https://travis-ci.org/murphyslaw/spotify-charts.png)](https://travis-ci.org/murphyslaw/spotify-charts)
 
 A Ruby wrapper for the public [Spotify Charts API](http://charts.spotify.com/) to retrieve the
-top 50 shared or streamed tracks on Spotify.
+top 50 viral or streamed tracks on Spotify.
+
 
 ## Installation
 
@@ -22,6 +23,11 @@ Or install it yourself as:
 
     $ gem install spotify-charts
 
+And then require:
+
+    require 'spotify/charts'
+
+
 ## Usage
 
 Retrieve **Available Countries**
@@ -30,27 +36,35 @@ Retrieve **Available Countries**
 Spotify::Charts.available_countries
 ```
 
-Retrieve **Available Dates** for a given country. The country needs to be in the format returned
+Retrieve **Available Time Window Types** for a given country. The country needs to be in the format returned
 by `available_countries` method.
 
 ```
-Spotify::Charts.available_dates(country)
+Spotify::Charts.available_time_window_types(country)
+```
+
+Retrieve **Available Dates** for a given country and time window type. The country and time window type need to be in the format returned
+by `.available_countries` and `.available_time_window_types` methods.
+
+```
+Spotify::Charts.available_dates(country, time_window_type)
 ```
 
-Retrieve **Most Shared** tracks for a given country and date. The country and date need to be in the
-format returned by `available_countries` and `availabe_dates` methods.
+Retrieve **Most Viral** tracks for a given country, time window type and date. The country, time window type and date need to be in the
+format returned by `.available_countries`, `.available_time_window_types` and `.availabe_dates` methods.
 
 ```
-Spotify::Charts.most_shared(country, date)
+Spotify::Charts.most_viral(country, time_window_type, date)
 ```
 
-Retrieve **Most Streamed** tracks for a given country and date. The country and date need to be in
-the format returned by `available_countries` and `availabe_dates` methods.
+Retrieve **Most Streamed** tracks for a given country, time window type and date. The country, time window type and date need to be in
+the format returned by `.available_countries`, `.available_time_window_types` and `.availabe_dates` methods.
 
 ```
-Spotify::Charts.most_streamed(country, date)
+Spotify::Charts.most_streamed(country, time_window_type date)
 ```
 
+
 ## Testing
 
 The default `rake` task is configured to run all tests.
@@ -62,6 +76,7 @@ rake
 `ZenTest` is used for continous testing. Run `autotest` to start.
 `simplecov` is used for test coverage. Run `open coverage/index.html` to open the results.
 
+
 ## Contributing
 
 1. Fork it (https://github.com/murphyslaw/spotify-charts/fork)

data/lib/spotify/charts.rb

@@ -6,20 +6,28 @@ require 'spotify/charts/track_parser'
 module Spotify
   module Charts
     class << self
+      def available_metrics
+        client.request('/')
+      end
+
       def available_countries
-        client.request('/most_shared/')
+        client.request('/most_viral/')
+      end
+
+      def available_time_window_types(country)
+        client.request("/most_viral/#{country}/")
       end
 
-      def available_dates(country)
-        client.request("/most_shared/#{country}/")
+      def available_dates(country, time_window_type)
+        client.request("/most_viral/#{country}/#{time_window_type}/")
       end
 
-      def most_shared(country, date)
-        extract_tracks("/most_shared/#{country}/#{date}")
+      def most_viral(country, time_window_type, date)
+        extract_tracks("/most_viral/#{country}/#{time_window_type}/#{date}")
       end
 
-      def most_streamed(country, date)
-        extract_tracks("/most_streamed/#{country}/#{date}")
+      def most_streamed(country, time_window_type, date)
+        extract_tracks("/most_streamed/#{country}/#{time_window_type}/#{date}")
       end
 
       private

data/lib/spotify/charts/client.rb

@@ -6,7 +6,7 @@ module Spotify
   module Charts
     class Client
       def self.base_uri
-        'http://charts.spotify.com/api/charts'
+        'http://charts.spotify.com/api/tracks'
       end
 
       def request(endpoint)

data/lib/spotify/charts/track.rb

@@ -1,8 +1,16 @@
 module Spotify
   module Charts
     class Track
-      attr_accessor :date, :country, :track_url, :track_name, :artist_name, :artist_url,
-        :album_name, :album_url, :artwork_url, :num_streams
+      attr_accessor :date
+      attr_accessor :country
+      attr_accessor :track_url
+      attr_accessor :track_name
+      attr_accessor :artist_name
+      attr_accessor :artist_url
+      attr_accessor :album_name
+      attr_accessor :album_url
+      attr_accessor :artwork_url
+      attr_accessor :num_streams
 
       def ==(other)
         other.class == self.class && other.state == state
@@ -12,7 +20,16 @@ module Spotify
       protected
 
       def state
-        [date, country, track_url, track_name, artist_name, album_name, artwork_url, num_streams]
+        [
+          date,
+          country,
+          track_url,
+          track_name,
+          artist_name,
+          album_name,
+          artwork_url,
+          num_streams
+        ]
       end
     end
   end

data/lib/spotify/charts/version.rb

@@ -1,5 +1,5 @@
 module Spotify
   module Charts
-    VERSION = '0.0.1'
+    VERSION = '0.0.2'
   end
 end

data/spec/examples.txt

@@ -0,0 +1,41 @@
+example_id                                             | status | run_time        |
+------------------------------------------------------ | ------ | --------------- |
+./spec/lib/spotify/charts/client_spec.rb[1:1:1]        | passed | 0.0001 seconds  |
+./spec/lib/spotify/charts/client_spec.rb[1:2:1]        | passed | 0.00054 seconds |
+./spec/lib/spotify/charts/track_parser_spec.rb[1:1]    | passed | 0.00007 seconds |
+./spec/lib/spotify/charts/track_parser_spec.rb[1:2:1]  | passed | 0.00022 seconds |
+./spec/lib/spotify/charts/track_parser_spec.rb[1:2:2]  | passed | 0.00023 seconds |
+./spec/lib/spotify/charts/track_parser_spec.rb[1:2:3]  | passed | 0.00023 seconds |
+./spec/lib/spotify/charts/track_parser_spec.rb[1:2:4]  | passed | 0.00025 seconds |
+./spec/lib/spotify/charts/track_parser_spec.rb[1:2:5]  | passed | 0.00023 seconds |
+./spec/lib/spotify/charts/track_parser_spec.rb[1:2:6]  | passed | 0.00022 seconds |
+./spec/lib/spotify/charts/track_parser_spec.rb[1:2:7]  | passed | 0.0002 seconds  |
+./spec/lib/spotify/charts/track_parser_spec.rb[1:2:8]  | passed | 0.00036 seconds |
+./spec/lib/spotify/charts/track_parser_spec.rb[1:2:9]  | passed | 0.00024 seconds |
+./spec/lib/spotify/charts/track_parser_spec.rb[1:2:10] | passed | 0.00025 seconds |
+./spec/lib/spotify/charts/track_parser_spec.rb[1:2:11] | passed | 0.00026 seconds |
+./spec/lib/spotify/charts/track_spec.rb[1:1]           | passed | 0.00022 seconds |
+./spec/lib/spotify/charts/track_spec.rb[1:2]           | passed | 0.00018 seconds |
+./spec/lib/spotify/charts/track_spec.rb[1:3]           | passed | 0.00018 seconds |
+./spec/lib/spotify/charts/track_spec.rb[1:4]           | passed | 0.00019 seconds |
+./spec/lib/spotify/charts/track_spec.rb[1:5]           | passed | 0.00019 seconds |
+./spec/lib/spotify/charts/track_spec.rb[1:6]           | passed | 0.00025 seconds |
+./spec/lib/spotify/charts/track_spec.rb[1:7]           | passed | 0.00023 seconds |
+./spec/lib/spotify/charts/track_spec.rb[1:8]           | passed | 0.00024 seconds |
+./spec/lib/spotify/charts/track_spec.rb[1:9]           | passed | 0.00024 seconds |
+./spec/lib/spotify/charts/track_spec.rb[1:10]          | passed | 0.00019 seconds |
+./spec/lib/spotify/charts/track_spec.rb[1:11]          | passed | 0.00019 seconds |
+./spec/lib/spotify/charts_spec.rb[1:1:1]               | passed | 0.00046 seconds |
+./spec/lib/spotify/charts_spec.rb[1:1:2]               | passed | 0.00037 seconds |
+./spec/lib/spotify/charts_spec.rb[1:1:3]               | passed | 0.00117 seconds |
+./spec/lib/spotify/charts_spec.rb[1:2:1]               | passed | 0.00042 seconds |
+./spec/lib/spotify/charts_spec.rb[1:2:2]               | passed | 0.00041 seconds |
+./spec/lib/spotify/charts_spec.rb[1:2:3]               | passed | 0.00035 seconds |
+./spec/lib/spotify/charts_spec.rb[1:3:1]               | passed | 0.00042 seconds |
+./spec/lib/spotify/charts_spec.rb[1:3:2]               | passed | 0.00039 seconds |
+./spec/lib/spotify/charts_spec.rb[1:4:1]               | passed | 0.0005 seconds  |
+./spec/lib/spotify/charts_spec.rb[1:4:2]               | passed | 0.00038 seconds |
+./spec/lib/spotify/charts_spec.rb[1:5:1]               | passed | 0.00645 seconds |
+./spec/lib/spotify/charts_spec.rb[1:5:2]               | passed | 0.0013 seconds  |
+./spec/lib/spotify/charts_spec.rb[1:6:1]               | passed | 0.00053 seconds |
+./spec/lib/spotify/charts_spec.rb[1:6:2]               | passed | 0.00064 seconds |

data/spec/lib/spotify/charts/client_spec.rb

@@ -1,29 +1,24 @@
 require 'uri'
 require 'net/http'
+require 'spotify/charts/client'
 
-require 'spec_helper.rb'
-
-module Spotify
-  module Charts
-    describe Client do
-      describe '.base_uri' do
-        it 'returns the Spotify Charts API base uri' do
-          expect(subject.class.base_uri).to eq('http://charts.spotify.com/api/charts')
-        end
-      end
+RSpec.describe Spotify::Charts::Client do
+  describe '.base_uri' do
+    it 'returns the Spotify Charts API base uri' do
+      expect(subject.class.base_uri).to eq('http://charts.spotify.com/api/tracks')
+    end
+  end
 
-      describe '#request' do
-        let(:endpoint) { '/most_shared/global/latest' }
+  describe '#request' do
+    let(:endpoint) { '/most_viral/global/latest' }
 
-        before do
-          uri = URI(subject.class.base_uri + endpoint)
-          allow(Net::HTTP).to receive(:get).with(uri).once { '{"example":"json"}' }
-        end
+    before do
+      uri = URI(subject.class.base_uri + endpoint)
+      allow(Net::HTTP).to receive(:get).with(uri).once { '{"example":"json"}' }
+    end
 
-        it 'parses JSON response' do
-          expect(subject.request(endpoint)).to eq({'example' => 'json'})
-        end
-      end
+    it 'parses JSON response' do
+      expect(subject.request(endpoint)).to eq({'example' => 'json'})
     end
   end
 end

data/spec/lib/spotify/charts/track_parser_spec.rb

@@ -1,86 +1,85 @@
-require 'spec_helper.rb'
+require 'date'
+require 'uri'
+require 'spotify/charts/track'
+require 'spotify/charts/track_parser'
 
-module Spotify
-  module Charts
-    describe TrackParser do
-      subject { TrackParser.new('example') }
+RSpec.describe Spotify::Charts::TrackParser do
+  subject { described_class.new('example') }
 
-      it 'stores the attributes' do
-        expect(subject.attributes).to eq('example')
-      end
+  it 'stores the attributes' do
+    expect(subject.attributes).to eq('example')
+  end
 
-      describe '#track' do
-        subject { TrackParser.new(attributes).track }
+  describe '#track' do
+    subject { described_class.new(attributes).track }
 
-        let(:attributes) {
-          {
-            'date' => '2013-12-15',
-            'country' => 'global',
-            'track_url' => 'https://play.spotify.com/track/7DyuZtvlGT0z5Xz8peiLN7',
-            'track_name' => 'I See Fire',
-            'artist_name' => 'Howard Shore',
-            'artist_url' => 'https://play.spotify.com/artist/6eUKZXaKkcviH0Ku9w2n3V',
-            'album_name' => 'The Hobbit: The Desolation of Smaug (Original Motion Picture Soundtrack)',
-            'album_url' => 'https://play.spotify.com/album/5kqgALc3cz9P3VclmSmHfr',
-            'artwork_url' => 'http://o.scdn.co/300/be7d523ea35aeb10f561712420d3429f0ec68eec',
-            'num_streams' => 515608,
-          }
-        }
+    let(:attributes) do
+      {
+        'date' => '2013-12-15',
+        'country' => 'global',
+        'track_url' => 'https://play.spotify.com/track/7DyuZtvlGT0z5Xz8peiLN7',
+        'track_name' => 'I See Fire',
+        'artist_name' => 'Howard Shore',
+        'artist_url' => 'https://play.spotify.com/artist/6eUKZXaKkcviH0Ku9w2n3V',
+        'album_name' => 'The Hobbit: The Desolation of Smaug (Original Motion Picture Soundtrack)',
+        'album_url' => 'https://play.spotify.com/album/5kqgALc3cz9P3VclmSmHfr',
+        'artwork_url' => 'http://o.scdn.co/300/be7d523ea35aeb10f561712420d3429f0ec68eec',
+        'num_streams' => 515608,
+      }
+    end
 
-        it 'creates a track from JSON data' do
-          expect(subject).to be_a(Track)
-        end
+    it 'creates a track from JSON data' do
+      expect(subject).to be_a(Spotify::Charts::Track)
+    end
 
-        it 'transforms the date' do
-          expect(subject.date).to be_a(Date)
-          expect(subject.date).to eq(Date.parse('2013-12-15'))
-        end
+    it 'transforms the date' do
+      expect(subject.date).to be_a(Date)
+      expect(subject.date).to eq(Date.parse('2013-12-15'))
+    end
 
-        it 'transforms the country' do
-          expect(subject.country).to be_a(String)
-          expect(subject.country).to eq('global')
-        end
+    it 'transforms the country' do
+      expect(subject.country).to be_a(String)
+      expect(subject.country).to eq('global')
+    end
 
-        it 'transforms the track url' do
-          expect(subject.track_url).to be_a(URI)
-          expect(subject.track_url).to eq(URI('https://play.spotify.com/track/7DyuZtvlGT0z5Xz8peiLN7'))
-        end
+    it 'transforms the track url' do
+      expect(subject.track_url).to be_a(URI)
+      expect(subject.track_url).to eq(URI('https://play.spotify.com/track/7DyuZtvlGT0z5Xz8peiLN7'))
+    end
 
-        it 'transforms the track name' do
-          expect(subject.track_name).to be_a(String)
-          expect(subject.track_name).to eq('I See Fire')
-        end
+    it 'transforms the track name' do
+      expect(subject.track_name).to be_a(String)
+      expect(subject.track_name).to eq('I See Fire')
+    end
 
-        it 'transforms the artist name' do
-          expect(subject.artist_name).to be_a(String)
-          expect(subject.artist_name).to eq('Howard Shore')
-        end
+    it 'transforms the artist name' do
+      expect(subject.artist_name).to be_a(String)
+      expect(subject.artist_name).to eq('Howard Shore')
+    end
 
-        it 'transforms the artist url' do
-          expect(subject.artist_url).to be_a(URI)
-          expect(subject.artist_url).to eq(URI('https://play.spotify.com/artist/6eUKZXaKkcviH0Ku9w2n3V'))
-        end
+    it 'transforms the artist url' do
+      expect(subject.artist_url).to be_a(URI)
+      expect(subject.artist_url).to eq(URI('https://play.spotify.com/artist/6eUKZXaKkcviH0Ku9w2n3V'))
+    end
 
-        it 'transforms the album name' do
-          expect(subject.album_name).to be_a(String)
-          expect(subject.album_name).to eq('The Hobbit: The Desolation of Smaug (Original Motion Picture Soundtrack)')
-        end
+    it 'transforms the album name' do
+      expect(subject.album_name).to be_a(String)
+      expect(subject.album_name).to eq('The Hobbit: The Desolation of Smaug (Original Motion Picture Soundtrack)')
+    end
 
-        it 'transforms the album url' do
-          expect(subject.album_url).to be_a(URI)
-          expect(subject.album_url).to eq(URI('https://play.spotify.com/album/5kqgALc3cz9P3VclmSmHfr'))
-        end
+    it 'transforms the album url' do
+      expect(subject.album_url).to be_a(URI)
+      expect(subject.album_url).to eq(URI('https://play.spotify.com/album/5kqgALc3cz9P3VclmSmHfr'))
+    end
 
-        it 'transforms the artwork url' do
-          expect(subject.artwork_url).to be_a(URI)
-          expect(subject.artwork_url).to eq(URI('http://o.scdn.co/300/be7d523ea35aeb10f561712420d3429f0ec68eec'))
-        end
+    it 'transforms the artwork url' do
+      expect(subject.artwork_url).to be_a(URI)
+      expect(subject.artwork_url).to eq(URI('http://o.scdn.co/300/be7d523ea35aeb10f561712420d3429f0ec68eec'))
+    end
 
-        it 'transforms the num_streams' do
-          expect(subject.num_streams).to be_a(Integer)
-          expect(subject.num_streams).to eq(515608)
-        end
-      end
+    it 'transforms the num_streams' do
+      expect(subject.num_streams).to be_a(Integer)
+      expect(subject.num_streams).to eq(515608)
     end
   end
 end

data/spec/lib/spotify/charts/track_spec.rb

@@ -1,64 +1,64 @@
+require 'date'
 require 'uri'
+require 'spotify/charts/track'
 
-require 'spec_helper.rb'
+RSpec.describe Spotify::Charts::Track do
+  subject do
+    described_class.new.tap do |t|
+      t.date = Date.parse('2013-12-15')
+      t.country = 'global'
+      t.track_url = URI('https://play.spotify.com/track/7DyuZtvlGT0z5Xz8peiLN7')
+      t.track_name = 'I See Fire'
+      t.artist_name = 'Howard Shore'
+      t.artist_url = URI('https://play.spotify.com/artist/6eUKZXaKkcviH0Ku9w2n3V')
+      t.album_name = 'The Hobbit: The Desolation of Smaug (Original Motion Picture Soundtrack)'
+      t.album_url = URI('https://play.spotify.com/album/5kqgALc3cz9P3VclmSmHfr')
+      t.artwork_url = URI('http://o.scdn.co/300/be7d523ea35aeb10f561712420d3429f0ec68eec')
+      t.num_streams = 515608
+    end
+  end
 
-module Spotify
-  module Charts
-    describe Track do
-      subject {
-        Track.new.tap do |t|
-          t.date = Date.parse('2013-12-15')
-          t.country = 'global'
-          t.track_url = URI('https://play.spotify.com/track/7DyuZtvlGT0z5Xz8peiLN7')
-          t.track_name = 'I See Fire'
-          t.artist_name = 'Howard Shore'
-          t.artist_url = URI('https://play.spotify.com/artist/6eUKZXaKkcviH0Ku9w2n3V')
-          t.album_name = 'The Hobbit: The Desolation of Smaug (Original Motion Picture Soundtrack)'
-          t.album_url = URI('https://play.spotify.com/album/5kqgALc3cz9P3VclmSmHfr')
-          t.artwork_url = URI('http://o.scdn.co/300/be7d523ea35aeb10f561712420d3429f0ec68eec')
-          t.num_streams = 515608
-        end
-      }
+  it 'initializes the date' do
+    expect(subject.date).to eq(Date.parse('2013-12-15'))
+  end
 
-      it 'initializes the date' do
-        expect(subject.date).to eq(Date.parse('2013-12-15'))
-      end
+  it 'initializes the country' do
+    expect(subject.country).to eq('global')
+  end
 
-      it 'initializes the country' do
-        expect(subject.country).to eq('global')
-      end
+  it 'initializes the track url' do
+    expect(subject.track_url).to eq(URI('https://play.spotify.com/track/7DyuZtvlGT0z5Xz8peiLN7'))
+  end
 
-      it 'initializes the track url' do
-        expect(subject.track_url).to eq(URI('https://play.spotify.com/track/7DyuZtvlGT0z5Xz8peiLN7'))
-      end
+  it 'initializes the track name' do
+    expect(subject.track_name).to eq('I See Fire')
+  end
 
-      it 'initializes the track name' do
-        expect(subject.track_name).to eq('I See Fire')
-      end
+  it 'initializes the artist name' do
+    expect(subject.artist_name).to eq('Howard Shore')
+  end
 
-      it 'initializes the artist name' do
-        expect(subject.artist_name).to eq('Howard Shore')
-      end
+  it 'initializes the artist url' do
+    expect(subject.artist_url).to eq(URI('https://play.spotify.com/artist/6eUKZXaKkcviH0Ku9w2n3V'))
+  end
 
-      it 'initializes the artist url' do
-        expect(subject.artist_url).to eq(URI('https://play.spotify.com/artist/6eUKZXaKkcviH0Ku9w2n3V'))
-      end
+  it 'initializes the album name' do
+    expect(subject.album_name).to eq('The Hobbit: The Desolation of Smaug (Original Motion Picture Soundtrack)')
+  end
 
-      it 'initializes the album name' do
-        expect(subject.album_name).to eq('The Hobbit: The Desolation of Smaug (Original Motion Picture Soundtrack)')
-      end
+  it 'initializes the album url' do
+    expect(subject.album_url).to eq(URI('https://play.spotify.com/album/5kqgALc3cz9P3VclmSmHfr'))
+  end
 
-      it 'initializes the album url' do
-        expect(subject.album_url).to eq(URI('https://play.spotify.com/album/5kqgALc3cz9P3VclmSmHfr'))
-      end
+  it 'initializes the artwork url' do
+    expect(subject.artwork_url).to eq(URI('http://o.scdn.co/300/be7d523ea35aeb10f561712420d3429f0ec68eec'))
+  end
 
-      it 'initializes the artwork url' do
-        expect(subject.artwork_url).to eq(URI('http://o.scdn.co/300/be7d523ea35aeb10f561712420d3429f0ec68eec'))
-      end
+  it 'initializes the number of streams' do
+    expect(subject.num_streams).to eq(515608)
+  end
 
-      it 'initializes the number of streams' do
-        expect(subject.num_streams).to eq(515608)
-      end
-    end
+  it 'equals the same object' do
+    expect(subject).to eq(subject)
   end
 end

data/spec/lib/spotify/charts_spec.rb

@@ -1,167 +1,209 @@
 require 'net/http'
+require 'spotify/charts'
+require 'spotify/charts/client'
+require 'spotify/charts/track'
+require 'spotify/charts/track_parser'
 
-require 'spec_helper.rb'
+RSpec.describe Spotify::Charts do
+  subject { described_class }
 
-module Spotify
-  describe Charts do
-    subject { Charts }
+  describe '.available_metrics' do
+    let(:response) { %w(most_viral most_streamed) }
 
-    describe '.available_countries' do
-      let(:response) {
-        %w(ar at au be bg ch cl co cr cz de dk ec ee es fi fr gb gr gt hk hu ie is it li lt lu lv mx
-          my nl no nz pe pl pt se sg sk sv tr tw us uy global)
-      }
+    before do
+      allow_any_instance_of(Spotify::Charts::Client).to receive(:request)
+        .with('/') { response }
+    end
 
-      before do
-        allow_any_instance_of(Charts::Client).to receive(:request)
-          .with('/most_shared/') { response }
-      end
+    it 'lists available metrcis' do
+      expect(subject.available_metrics).to be_a(Enumerable)
+    end
 
-      it 'lists available countries' do
-        expect(subject.available_countries).to be_a(Enumerable)
-      end
+    it 'includes the "most_viral" metric' do
+      expect(subject.available_metrics).to include('most_viral')
+    end
 
-      it 'includes the "global" country' do
-        expect(subject.available_countries).to include('global')
-      end
+    it 'includes the "most_streamed" metric' do
+      expect(subject.available_metrics).to include('most_streamed')
     end
+  end
 
-    describe '.available_dates' do
-      let(:response) {
-        %w(latest 2013-12-08 2013-12-01 2013-11-24 2013-11-17 2013-11-10 2013-11-03 2013-10-27
-          2013-10-20 2013-10-13 2013-10-06 2013-09-29 2013-09-22 2013-09-15 2013-09-08 2013-09-01
-          2013-08-25 2013-08-18 2013-08-11 2013-08-04 2013-07-28 2013-07-21 2013-07-14 2013-07-07
-          2013-06-30 2013-06-23 2013-06-16 2013-06-09 2013-06-02 2013-05-26 2013-05-19 2013-05-12
-          2013-05-05 2013-04-28)
-      }
+  describe '.available_time_window_types' do
+    let(:response) { %w(daily weekly) }
 
-      before do
-        allow_any_instance_of(Charts::Client).to receive(:request)
-          .with('/most_shared/global/') { response }
-      end
+    before do
+      allow_any_instance_of(Spotify::Charts::Client).to receive(:request)
+        .with('/most_viral/global/') { response }
+    end
 
-      it 'lists available dates' do
-        expect(subject.available_dates('global')).to be_a(Enumerable)
-      end
+    it 'lists available time window types' do
+      expect(subject.available_time_window_types('global')).to be_a(Enumerable)
+    end
 
-      it 'includes the "latest" date' do
-        expect(subject.available_dates('global')).to include('latest')
-      end
+    it 'includes the "daily" metric' do
+      expect(subject.available_time_window_types('global')).to include('daily')
     end
 
-    describe '.most shared' do
-      subject { Charts.most_shared('global', 'latest') }
-
-      let(:response) {
-        {
-          'tracks' => [
-            {
-               'date' => '2013-12-15',
-               'country' => 'global',
-               'track_url' => 'https://play.spotify.com/track/7DyuZtvlGT0z5Xz8peiLN7',
-               'track_name' => 'I See Fire',
-               'artist_name' => 'Howard Shore',
-               'artist_url' => 'https://play.spotify.com/artist/6eUKZXaKkcviH0Ku9w2n3V',
-               'album_name' => 'The Hobbit: The Desolation of Smaug (Original Motion Picture Soundtrack)',
-               'album_url' => 'https://play.spotify.com/album/5kqgALc3cz9P3VclmSmHfr',
-               'artwork_url' => 'http://o.scdn.co/300/be7d523ea35aeb10f561712420d3429f0ec68eec',
-               'num_streams' => 515608
-            },
-            {
-               'date' => '2013-12-15',
-               'country' => 'global',
-               'track_url' => 'https://play.spotify.com/track/44GgIVlmRsD1qMWONOWOS3',
-               'track_name' => 'Waiting Game',
-               'artist_name' => 'BANKS',
-               'artist_url' => 'https://play.spotify.com/artist/2xe8IXgCTpwHE3eA9hTs4n',
-               'album_name' => 'LONDON',
-               'album_url' => 'https://play.spotify.com/album/4xG1FKMIQPGYRujVBtMAqm',
-               'artwork_url' => 'http://o.scdn.co/300/4027ebaa3c0ff4161020cb37a546f25929249166',
-               'num_streams' => 182325
-            }
-          ]
-        }
-      }
+    it 'includes the "weekly" metric' do
+      expect(subject.available_time_window_types('global')).to include('weekly')
+    end
+  end
+
+  describe '.available_countries' do
+    let(:response) do
+      %w(ar at au be bg ch cl co cr cz de dk ec ee es fi fr gb gr gt hk hu ie is it li lt lu lv mx
+        my nl no nz pe pl pt se sg sk sv tr tw us uy global)
+    end
+
+    before do
+      allow_any_instance_of(Spotify::Charts::Client).to receive(:request)
+        .with('/most_viral/') { response }
+    end
+
+    it 'lists available countries' do
+      expect(subject.available_countries).to be_a(Enumerable)
+    end
+
+    it 'includes the "global" country' do
+      expect(subject.available_countries).to include('global')
+    end
+  end
+
+  describe '.available_dates' do
+    let(:response) do
+      %w(latest 2013-12-08 2013-12-01 2013-11-24 2013-11-17 2013-11-10 2013-11-03 2013-10-27
+        2013-10-20 2013-10-13 2013-10-06 2013-09-29 2013-09-22 2013-09-15 2013-09-08 2013-09-01
+        2013-08-25 2013-08-18 2013-08-11 2013-08-04 2013-07-28 2013-07-21 2013-07-14 2013-07-07
+        2013-06-30 2013-06-23 2013-06-16 2013-06-09 2013-06-02 2013-05-26 2013-05-19 2013-05-12
+        2013-05-05 2013-04-28)
+    end
+
+    before do
+      allow_any_instance_of(Spotify::Charts::Client).to receive(:request)
+        .with('/most_viral/global/weekly/') { response }
+    end
 
-      let(:tracks) {
-        response['tracks'].inject([]) do |tracks, item|
-          tracks << Charts::TrackParser.new(item).track
-        end
+    it 'lists available dates' do
+      expect(subject.available_dates('global', 'weekly')).to be_a(Enumerable)
+    end
+
+    it 'includes the "latest" date' do
+      expect(subject.available_dates('global', 'weekly')).to include('latest')
+    end
+  end
+
+  describe '.most_viral' do
+    subject { described_class.most_viral('global', 'weekly', 'latest') }
+
+    let(:response) do
+      {
+        'tracks' => [
+          {
+             'date' => '2013-12-15',
+             'country' => 'global',
+             'track_url' => 'https://play.spotify.com/track/7DyuZtvlGT0z5Xz8peiLN7',
+             'track_name' => 'I See Fire',
+             'artist_name' => 'Howard Shore',
+             'artist_url' => 'https://play.spotify.com/artist/6eUKZXaKkcviH0Ku9w2n3V',
+             'album_name' => 'The Hobbit: The Desolation of Smaug (Original Motion Picture Soundtrack)',
+             'album_url' => 'https://play.spotify.com/album/5kqgALc3cz9P3VclmSmHfr',
+             'artwork_url' => 'http://o.scdn.co/300/be7d523ea35aeb10f561712420d3429f0ec68eec',
+             'num_streams' => 515608
+          },
+          {
+             'date' => '2013-12-15',
+             'country' => 'global',
+             'track_url' => 'https://play.spotify.com/track/44GgIVlmRsD1qMWONOWOS3',
+             'track_name' => 'Waiting Game',
+             'artist_name' => 'BANKS',
+             'artist_url' => 'https://play.spotify.com/artist/2xe8IXgCTpwHE3eA9hTs4n',
+             'album_name' => 'LONDON',
+             'album_url' => 'https://play.spotify.com/album/4xG1FKMIQPGYRujVBtMAqm',
+             'artwork_url' => 'http://o.scdn.co/300/4027ebaa3c0ff4161020cb37a546f25929249166',
+             'num_streams' => 182325
+          }
+        ]
       }
+    end
 
-      before do
-        allow_any_instance_of(Charts::Client).to receive(:request)
-          .with('/most_shared/global/latest') { response }
+    let(:tracks) do
+      response['tracks'].inject([]) do |tracks, item|
+        tracks << Spotify::Charts::TrackParser.new(item).track
       end
+    end
 
-      it 'returns a list of tracks' do
-        subject.each do |track|
-          expect(track).to be_a(Charts::Track)
-        end
-      end
+    before do
+      allow_any_instance_of(Spotify::Charts::Client).to receive(:request)
+        .with('/most_viral/global/weekly/latest') { response }
+    end
 
-      it 'tracks correspond to webservice response' do
-        subject.each_with_index do |track, index|
-          expect(track).to eq(tracks[index])
-        end
+    it 'returns a list of tracks' do
+      subject.each do |track|
+        expect(track).to be_a(Spotify::Charts::Track)
       end
     end
 
-    describe '.most streamed' do
-      subject { Charts.most_streamed('global', 'latest') }
-
-      let(:response) {
-        {
-          'tracks' => [
-            {
-               'date' => '2013-12-15',
-               'country' => 'global',
-               'track_url' => 'https://play.spotify.com/track/7DyuZtvlGT0z5Xz8peiLN7',
-               'track_name' => 'I See Fire',
-               'artist_name' => 'Howard Shore',
-               'artist_url' => 'https://play.spotify.com/artist/6eUKZXaKkcviH0Ku9w2n3V',
-               'album_name' => 'The Hobbit: The Desolation of Smaug (Original Motion Picture Soundtrack)',
-               'album_url' => 'https://play.spotify.com/album/5kqgALc3cz9P3VclmSmHfr',
-               'artwork_url' => 'http://o.scdn.co/300/be7d523ea35aeb10f561712420d3429f0ec68eec',
-               'num_streams' => 515608
-            },
-            {
-               'date' => '2013-12-15',
-               'country' => 'global',
-               'track_url' => 'https://play.spotify.com/track/44GgIVlmRsD1qMWONOWOS3',
-               'track_name' => 'Waiting Game',
-               'artist_name' => 'BANKS',
-               'artist_url' => 'https://play.spotify.com/artist/2xe8IXgCTpwHE3eA9hTs4n',
-               'album_name' => 'LONDON',
-               'album_url' => 'https://play.spotify.com/album/4xG1FKMIQPGYRujVBtMAqm',
-               'artwork_url' => 'http://o.scdn.co/300/4027ebaa3c0ff4161020cb37a546f25929249166',
-               'num_streams' => 182325
-            }
-          ]
-        }
-      }
+    it 'tracks correspond to webservice response' do
+      subject.each_with_index do |track, index|
+        expect(track).to eq(tracks[index])
+      end
+    end
+  end
 
-      let(:tracks) {
-        response['tracks'].inject([]) do |tracks, item|
-          tracks << Charts::TrackParser.new(item).track
-        end
+  describe '.most_streamed' do
+    subject { described_class.most_streamed('global', 'weekly', 'latest') }
+
+    let(:response) do
+      {
+        'tracks' => [
+          {
+             'date' => '2013-12-15',
+             'country' => 'global',
+             'track_url' => 'https://play.spotify.com/track/7DyuZtvlGT0z5Xz8peiLN7',
+             'track_name' => 'I See Fire',
+             'artist_name' => 'Howard Shore',
+             'artist_url' => 'https://play.spotify.com/artist/6eUKZXaKkcviH0Ku9w2n3V',
+             'album_name' => 'The Hobbit: The Desolation of Smaug (Original Motion Picture Soundtrack)',
+             'album_url' => 'https://play.spotify.com/album/5kqgALc3cz9P3VclmSmHfr',
+             'artwork_url' => 'http://o.scdn.co/300/be7d523ea35aeb10f561712420d3429f0ec68eec',
+             'num_streams' => 515608
+          },
+          {
+             'date' => '2013-12-15',
+             'country' => 'global',
+             'track_url' => 'https://play.spotify.com/track/44GgIVlmRsD1qMWONOWOS3',
+             'track_name' => 'Waiting Game',
+             'artist_name' => 'BANKS',
+             'artist_url' => 'https://play.spotify.com/artist/2xe8IXgCTpwHE3eA9hTs4n',
+             'album_name' => 'LONDON',
+             'album_url' => 'https://play.spotify.com/album/4xG1FKMIQPGYRujVBtMAqm',
+             'artwork_url' => 'http://o.scdn.co/300/4027ebaa3c0ff4161020cb37a546f25929249166',
+             'num_streams' => 182325
+          }
+        ]
       }
+    end
 
-      before do
-        allow_any_instance_of(Charts::Client).to receive(:request)
-          .with('/most_streamed/global/latest') { response }
+    let(:tracks) do
+      response['tracks'].inject([]) do |tracks, item|
+        tracks << Spotify::Charts::TrackParser.new(item).track
       end
+    end
 
-      it 'returns a list of tracks' do
-        subject.each do |track|
-          expect(track).to be_a(Charts::Track)
-        end
+    before do
+      allow_any_instance_of(Spotify::Charts::Client).to receive(:request)
+        .with('/most_streamed/global/weekly/latest') { response }
+    end
+
+    it 'returns a list of tracks' do
+      subject.each do |track|
+        expect(track).to be_a(Spotify::Charts::Track)
       end
+    end
 
-      it 'tracks correspond to webservice response' do
-        subject.each_with_index do |track, index|
-          expect(track).to eq(tracks[index])
-        end
+    it 'tracks correspond to webservice response' do
+      subject.each_with_index do |track, index|
+        expect(track).to eq(tracks[index])
       end
     end
   end

data/spec/spec_helper.rb

@@ -1,11 +1,96 @@
 require 'simplecov'
 SimpleCov.start
 
-require 'spotify/charts'
-
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# The generated `.rspec` file contains `--require spec_helper` which will cause
+# this file to always be loaded, without a need to explicitly require it in any
+# files.
+#
+# Given that it is always loaded, you are encouraged to keep this file as
+# light-weight as possible. Requiring heavyweight dependencies from this file
+# will add to the boot time of your test suite on EVERY test run, even for an
+# individual file that may not need all of that loaded. Instead, consider making
+# a separate helper file that requires the additional dependencies and performs
+# the additional setup, and require it from the spec files that actually need
+# it.
+#
+# The `.rspec` file also contains a few flags that are not defaults but that
+# users commonly want.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
 RSpec.configure do |config|
-  config.treat_symbols_as_metadata_keys_with_true_values = true
-  config.run_all_when_everything_filtered = true
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text for helper methods
+    # defined using `chain`, e.g.:
+    #     be_bigger_than(2).and_smaller_than(4).description
+    #     # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #     # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+  # These two settings work together to allow you to limit a spec run
+  # to individual examples or groups you care about by tagging them with
+  # `:focus` metadata. When nothing is tagged with `:focus`, all examples
+  # get run.
   config.filter_run :focus
-  config.order = 'random'
+  config.run_all_when_everything_filtered = true
+
+  # Allows RSpec to persist some state between runs in order to support
+  # the `--only-failures` and `--next-failure` CLI options. We recommend
+  # you configure your source control system to ignore this file.
+  config.example_status_persistence_file_path = "spec/examples.txt"
+
+  # Limits the available syntax to the non-monkey patched syntax that is
+  # recommended. For more details, see:
+  #   - http://myronmars.to/n/dev-blog/2012/06/rspecs-new-expectation-syntax
+  #   - http://www.teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+  #   - http://myronmars.to/n/dev-blog/2014/05/notable-changes-in-rspec-3#new__config_option_to_disable_rspeccore_monkey_patching
+  config.disable_monkey_patching!
+
+  # This setting enables warnings. It's recommended, but in some cases may
+  # be too noisy due to issues in dependencies.
+  config.warnings = true
+
+  # Many RSpec users commonly either run the entire suite or an individual
+  # file, and it's useful to allow more verbose output when running an
+  # individual spec file.
+  if config.files_to_run.one?
+    # Use the documentation formatter for detailed output,
+    # unless a formatter has already been configured
+    # (e.g. via a command-line flag).
+    config.default_formatter = 'doc'
+  end
+
+  # Print the 10 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  config.profile_examples = 10
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce
+  # test failures related to randomization by passing the same `--seed` value
+  # as the one that triggered the failure.
+  Kernel.srand config.seed
 end
+

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: spotify-charts
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Falk Koeppe
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-04-28 00:00:00.000000000 Z
+date: 2015-10-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
@@ -101,6 +101,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - LICENSE
 - README.md
 - lib/spotify/charts.rb
@@ -108,6 +109,7 @@ files:
 - lib/spotify/charts/track.rb
 - lib/spotify/charts/track_parser.rb
 - lib/spotify/charts/version.rb
+- spec/examples.txt
 - spec/lib/spotify/charts/client_spec.rb
 - spec/lib/spotify/charts/track_parser_spec.rb
 - spec/lib/spotify/charts/track_spec.rb
@@ -133,11 +135,12 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.4.5.1
 signing_key: 
 specification_version: 4
 summary: Ruby wrapper for the Spotify Charts API
 test_files:
+- spec/examples.txt
 - spec/lib/spotify/charts/client_spec.rb
 - spec/lib/spotify/charts/track_parser_spec.rb
 - spec/lib/spotify/charts/track_spec.rb