notu 0.1.0

data/spec/notu/error_spec.rb

@@ -0,0 +1,40 @@
+require 'spec_helper'
+
+describe Notu::Error do
+
+  let(:error) { Notu::Error.new('BAM!') }
+  let(:original) { StandardError.new('BIM!') }
+
+  describe '#message' do
+
+    it 'is message set at initialization' do
+      expect(error.message).to eq('BAM!')
+    end
+
+    it 'message is squished' do
+      expect(Notu::Error.new(" hello  \n world").message).to eq('hello world')
+    end
+
+    it 'default one if blank' do
+      expect(Notu::Error.new(" ").message).to eq('Notu::Error')
+    end
+
+  end
+
+  describe '#original' do
+
+    it 'is nil by default' do
+      expect(error.original).to be_nil
+    end
+
+    it 'is exception given at initialization' do
+      expect(Notu::Error.new(original).original).to be(original)
+    end
+
+    it 'sets message from original' do
+      expect(Notu::Error.new(original).message).to eq('BIM!')
+    end
+
+  end
+
+end

data/spec/notu/html_document_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+describe Notu::HtmlDocument, :vcr do
+
+  describe '.get' do
+
+    it 'returns document parsed' do
+      document = Notu::HtmlDocument.get('http://alweb.org')
+      expect((document/'title').text).to eq('Alexis Toulotte')
+    end
+
+    it 'follows redirects' do
+      document = Notu::HtmlDocument.get('http://www.alweb.org')
+      expect((document/'title').text).to eq('Alexis Toulotte')
+    end
+
+    it 'raise a NetworkError on 404' do
+      expect {
+        Notu::HtmlDocument.get('http://alweb.org/foo')
+      }.to raise_error(Notu::NetworkError, '404 "Not Found"')
+    end
+
+    it 'raise a ParseError if not a valid document' do
+      expect {
+        Notu::HtmlDocument.get('http://alweb.org/avatar')
+      }.to raise_error(Notu::ParseError, 'Invalid HTML document')
+    end
+
+  end
+
+end

data/spec/notu/http_download_spec.rb

@@ -0,0 +1,39 @@
+require 'spec_helper'
+
+describe Notu::HttpDownload, :vcr do
+
+  describe '.get' do
+
+    it 'retrives document from given URL' do
+      expect(Notu::HttpDownload.get('http://alweb.org')).to include('<title>Alexis Toulotte</title>')
+    end
+
+    it 'accepts HTTPS URL' do
+      expect(Notu::HttpDownload.get('https://alweb.org')).to include('<title>Alexis Toulotte</title>')
+    end
+
+    it 'follow redirects' do
+      expect(Notu::HttpDownload.get('http://www.alweb.org')).to include('<title>Alexis Toulotte</title>')
+    end
+
+    it 'raise an error if an invalid URL is given' do
+      expect {
+        Notu::HttpDownload.get('ftp://www.alweb.org')
+      }.to raise_error(Notu::NetworkError, 'Invalid URL: "ftp://www.alweb.org"')
+    end
+
+    it 'raise a NetworkError on 404' do
+      expect {
+        Notu::HttpDownload.get('http://alweb.org/foo', max_retries: 0)
+      }.to raise_error(Notu::NetworkError, '404 "Not Found"')
+    end
+
+    it 'raise a NetworkError if too many redirects' do
+      expect {
+        Notu::HttpDownload.get('http://www.alweb.org', max_redirects: 0, max_retries: 0)
+      }.to raise_error(Notu::NetworkError, 'Max redirects has been reached')
+    end
+
+  end
+
+end

data/spec/notu/library_spec.rb

@@ -0,0 +1,130 @@
+require 'spec_helper'
+
+describe Notu::Library do
+
+  let(:library) { Notu::Library.new(username: 'alexistoulotte') }
+
+  describe '#host' do
+
+    it 'is "www.last.fm" by default' do
+      expect(library.host).to eq('www.last.fm')
+    end
+
+    it 'can be specified via option' do
+      expect(Notu::Library.new(host: 'www.lastfm.fr', username: 'alex').host).to eq('www.lastfm.fr')
+    end
+
+    it 'can be specified via option (as string)' do
+      expect(Notu::Library.new('host' => 'www.lastfm.fr', username: 'alex').host).to eq('www.lastfm.fr')
+    end
+
+    it 'is default host if blank' do
+      expect(Notu::Library.new(host: ' ', username: 'alex').host).to eq('www.last.fm')
+    end
+
+  end
+
+  describe '#loved_tracks' do
+
+    it 'returns a LovedTracks object' do
+      expect(library.loved_tracks).to be_a(Notu::LovedTracks)
+    end
+
+  end
+
+  describe '#most_played_tracks' do
+
+    it 'returns a LovedTracks object' do
+      most_played_tracks = library.most_played_tracks
+      expect(most_played_tracks).to be_a(Notu::MostPlayedTracks)
+      expect(most_played_tracks.period).to eq('last_week')
+    end
+
+    it 'accepts options' do
+      expect(library.most_played_tracks(period: 'last_month').period).to eq('last_month')
+    end
+
+  end
+
+  describe '#username' do
+
+    it 'is username set at initialization' do
+      expect(library.username).to eq('alexistoulotte')
+    end
+
+    it 'can be specified as string' do
+      expect(Notu::Library.new('username' => 'john42').username).to eq('john42')
+    end
+
+    it 'raise an error if nil' do
+      expect {
+        Notu::Library.new(username: nil)
+      }.to raise_error(Notu::Error, 'Invalid Last.fm username: nil')
+    end
+
+    it 'raise an error if blank' do
+      expect {
+        Notu::Library.new(username: ' ')
+      }.to raise_error(Notu::Error, 'Invalid Last.fm username: " "')
+    end
+
+    it 'raise an error if it contains spaces' do
+      expect {
+        Notu::Library.new(username: 'alexis toulotte')
+      }.to raise_error(Notu::Error, 'Invalid Last.fm username: "alexis toulotte"')
+    end
+
+    it 'raise an error if invalid' do
+      expect {
+        Notu::Library.new(username: 'alex$')
+      }.to raise_error(Notu::Error, 'Invalid Last.fm username: "alex$"')
+
+      expect {
+        Notu::Library.new(username: 'ALex^')
+      }.to raise_error(Notu::Error, 'Invalid Last.fm username: "ALex^"')
+    end
+
+    it 'is stripped' do
+      expect(Notu::Library.new(username: " alexis42 \n").username).to eq('alexis42')
+    end
+
+    it 'is downcased' do
+      expect(Notu::Library.new(username: 'AlexIsT').username).to eq('alexist')
+    end
+
+  end
+
+  describe '#url' do
+
+    it 'returns default url if path not given' do
+      expect(library.url).to eq('http://www.last.fm/user/alexistoulotte')
+    end
+
+    it 'returns default url if path is blank' do
+      expect(library.url(path: ' ')).to eq('http://www.last.fm/user/alexistoulotte')
+    end
+
+    it 'accepts path option as string' do
+      expect(library.url('path' => '/library/loved')).to eq('http://www.last.fm/user/alexistoulotte/library/loved')
+    end
+
+    it 'returns URL and path if given' do
+      expect(library.url(path: '/library/loved')).to eq('http://www.last.fm/user/alexistoulotte/library/loved')
+    end
+
+    it 'adds first / to given path' do
+      expect(library.url(path: 'library/loved')).to eq('http://www.last.fm/user/alexistoulotte/library/loved')
+    end
+
+    it 'use :host option set at initialization' do
+      library = Notu::Library.new(host: 'www.lastfm.fr', username: 'albundy02')
+      expect(library.url).to eq('http://www.lastfm.fr/user/albundy02')
+    end
+
+    it 'accepts query option' do
+      expect(library.url(query: { bar: 42, 'baz' => 'hello&world' })).to eq('http://www.last.fm/user/alexistoulotte?bar=42&baz=hello%26world')
+    end
+
+  end
+
+end

data/spec/notu/loved_tracks_spec.rb

@@ -0,0 +1,61 @@
+require 'spec_helper'
+
+describe Notu::LovedTracks, :vcr do
+
+  let(:library) { Notu::Library.new(username: 'alexistoulotte') }
+  let(:loved_tracks) { Notu::LovedTracks.new(library) }
+
+  describe '#each' do
+
+    it 'returns some tracks' do
+      tracks = loved_tracks.take(42)
+      expect(tracks.size).to eq(42)
+      tracks.each do |track|
+        expect(track).to be_a(Notu::Track)
+        expect(track.artist).to be_present
+        expect(track.plays_count).to be_nil
+        expect(track.title).to be_present
+      end
+    end
+
+    it 'returns nil' do
+      allow(loved_tracks).to receive(:pages_count).and_return(1)
+      expect(loved_tracks.each {}).to be_nil
+    end
+
+  end
+
+  describe '#library' do
+
+    it 'is library given at initialization' do
+      expect(loved_tracks.library).to be(library)
+    end
+
+    it 'raise an error if library is nil' do
+      expect {
+        Notu::LovedTracks.new(nil)
+      }.to raise_error(ArgumentError, 'Notu::LovedTracks#library must be a library, nil given')
+    end
+
+  end
+
+  describe '#page_urls' do
+
+    it 'is correct' do
+      urls = loved_tracks.send(:page_urls)
+      expect(urls.size).to eq(loved_tracks.send(:pages_count))
+      expect(urls).to include('http://www.last.fm/user/alexistoulotte/library/loved?sortBy=date&sortOrder=desc&page=12')
+      expect(urls).to include('http://www.last.fm/user/alexistoulotte/library/loved?sortBy=date&sortOrder=desc&page=3')
+    end
+
+  end
+
+  describe '#pages_count' do
+
+    it 'is correct' do
+      expect(loved_tracks.send(:pages_count)).to be_within(10).of(30)
+    end
+
+  end
+
+end

data/spec/notu/most_played_tracks_spec.rb

@@ -0,0 +1,64 @@
+require 'spec_helper'
+
+describe Notu::MostPlayedTracks, :vcr do
+
+  let(:library) { Notu::Library.new(username: 'alexistoulotte') }
+  let(:most_played_tracks) { Notu::MostPlayedTracks.new(library) }
+
+  describe '#library' do
+
+    it 'is library given at initialization' do
+      expect(most_played_tracks.library).to be(library)
+    end
+
+    it 'raise an error if library is nil' do
+      expect {
+        Notu::MostPlayedTracks.new(nil)
+      }.to raise_error(ArgumentError, 'Notu::MostPlayedTracks#library must be a library, nil given')
+    end
+
+  end
+
+  describe '#each' do
+
+    it 'returns some tracks' do
+      allow(most_played_tracks).to receive(:period).and_return('last_month')
+      tracks = most_played_tracks.take(28)
+      expect(tracks.size).to eq(28)
+      tracks.each do |track|
+        expect(track).to be_a(Notu::Track)
+        expect(track.artist).to be_present
+        expect(track.plays_count).to be > 0
+        expect(track.title).to be_present
+      end
+    end
+
+    it 'returns nil' do
+      expect(most_played_tracks.each {}).to be_nil
+    end
+
+  end
+
+  describe '#period' do
+
+    it 'is "last_week" by default' do
+      expect(most_played_tracks.period).to eq('last_week')
+    end
+
+    it 'can be specified via option' do
+      expect(Notu::MostPlayedTracks.new(library, period: 'last_6_months').period).to eq('last_6_months')
+    end
+
+    it 'can be specified via option (as string)' do
+      expect(Notu::MostPlayedTracks.new(library, 'period' => 'last_6_months').period).to eq('last_6_months')
+    end
+
+    it 'raise an error if invalid' do
+      expect {
+        Notu::MostPlayedTracks.new(library, period: 'foo')
+      }.to raise_error(ArgumentError, 'Notu::MostPlayedTracks#period is invalid: "foo"')
+    end
+
+  end
+
+end

data/spec/notu/network_error_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper'
+
+describe Notu::NetworkError do
+
+  let(:error) { Notu::NetworkError.new('BAM!') }
+
+  describe '#message' do
+
+    it 'is message set at initialization' do
+      expect(error.message).to eq('BAM!')
+    end
+
+  end
+
+end

data/spec/notu/parse_error_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper'
+
+describe Notu::ParseError do
+
+  let(:error) { Notu::ParseError.new('BAM!') }
+
+  describe '#message' do
+
+    it 'is message set at initialization' do
+      expect(error.message).to eq('BAM!')
+    end
+
+  end
+
+end

data/spec/notu/track_spec.rb

@@ -0,0 +1,67 @@
+require 'spec_helper'
+
+describe Notu::Track do
+
+  let(:track) { Notu::Track.new(artist: 'Serial Killaz', title: 'Good Enough') }
+
+  describe '#artist' do
+
+    it 'is value set at initialization' do
+      expect(track.artist).to eq('Serial Killaz')
+    end
+
+    it 'is squished' do
+      expect(Notu::Track.new(artist: 'Serial  Killaz  ', title: 'Good Enough').artist).to eq('Serial Killaz')
+    end
+
+    it 'raise an error if blank' do
+      expect {
+        Notu::Track.new(artist: ' ', title: 'Good Enough')
+      }.to raise_error(Notu::Error, 'Notu::Track#artist must be specified, " " given')
+    end
+
+  end
+
+  describe '#plays_count' do
+
+    it 'is nil by default' do
+      expect(track.plays_count).to be_nil
+    end
+
+    it 'can be specified' do
+      expect(Notu::Track.new(artist: 'Serial Killaz', plays_count: 42, title: 'Good Enough').plays_count).to eq(42)
+    end
+
+    it 'can be specified (as string)' do
+      expect(Notu::Track.new(artist: 'Serial Killaz', plays_count: '42', title: 'Good Enough').plays_count).to eq(42)
+    end
+
+    it 'is nil if invalid' do
+      expect(Notu::Track.new(artist: 'Serial Killaz', plays_count: 'foo', title: 'Good Enough').plays_count).to be_nil
+    end
+
+    it 'is 0 if negatve' do
+      expect(Notu::Track.new(artist: 'Serial Killaz', plays_count: -1, title: 'Good Enough').plays_count).to eq(0)
+    end
+
+  end
+
+  describe '#title' do
+
+    it 'is value set at initialization' do
+      expect(track.title).to eq('Good Enough')
+    end
+
+    it 'is squished' do
+      expect(Notu::Track.new(artist: 'Serial Killaz', title: '  Good  Enough').title).to eq('Good Enough')
+    end
+
+    it 'raise an error if blank' do
+      expect {
+        Notu::Track.new(artist: 'Serial Killaz', title: ' ')
+      }.to raise_error(Notu::Error, 'Notu::Track#title must be specified, " " given')
+    end
+
+  end
+
+end