kuva 0.0.1

data/spec/generators/kuva/install_generator_spec.rb

@@ -0,0 +1,30 @@
+require "spec_helper"
+require "generators/kuva/install_generator"
+
+module Kuva
+  module Generators
+    describe InstallGenerator do
+      destination File.expand_path("../../../../tmp", __FILE__)
+
+      let(:initializer) { file("config/initializers/kuva.rb") }
+      let(:locale)      { file("config/locales/kuva.en.yml") }
+
+      before do
+        prepare_destination
+        run_generator
+      end
+
+      it "generates config/initializers/kuva.rb" do
+        expect(initializer).to exist
+      end
+
+      it "generates config/locales/kuva.en.yml" do
+        expect(locale).to exist
+      end
+
+      after do
+        FileUtils.rm_rf File.expand_path("../../../../tmp", __FILE__)
+      end
+    end
+  end
+end

data/spec/generators/kuva/views_generator_spec.rb

@@ -0,0 +1,37 @@
+require "spec_helper"
+require "generators/kuva/views_generator"
+
+module Kuva
+  module Generators
+    describe ViewsGenerator do
+      destination File.expand_path("../../../../tmp", __FILE__)
+
+      let(:views_directory) { "app/views/kuva" }
+
+      let(:sets_index)  { file("#{views_directory}/sets/index.html.haml") }
+      let(:sets_show)   { file("#{views_directory}/sets/show.html.haml") }
+      let(:photos_show) { file("#{views_directory}/photos/show.html.haml") }
+
+      before do
+        prepare_destination
+        run_generator
+      end
+
+      it "generates the app/views/kuva/photos/show.html.haml view" do
+        expect(photos_show).to exist
+      end
+
+      it "generates the app/views/kuva/sets/index.html.haml view" do
+        expect(sets_index).to exist
+      end
+
+      it "generates the app/views/kuva/sets/show.html.haml view" do
+        expect(sets_show).to exist
+      end
+
+      after do
+        FileUtils.rm_rf File.expand_path("../../../../tmp", __FILE__)
+      end
+    end
+  end
+end

data/spec/helpers/kuva/application_helper_spec.rb

@@ -0,0 +1,26 @@
+require "spec_helper"
+
+describe Kuva::ApplicationHelper, :vcr do
+
+  describe "#breadcrumbs_for" do
+    let(:photoset_id) { "72157632367381040" }
+    let(:photoset)    { Kuva::Elements::Photoset.find photoset_id }
+
+    subject { helper.breadcrumbs_for photoset }
+
+    context "when the current page is the set page" do
+      before { allow(helper).to receive(:photoset_page?).and_return true }
+
+      it "creates a breadcrumb without the set URL" do
+        expect(subject).to eq '<ul class="breadcrumbs"><li><a href="http://test.host/kuva/">Photosets</a></li></ul>'
+      end
+    end
+
+    context "when the current page is NOT the set page" do
+      it "creates a breadcrumb with the set URL" do
+        expect(subject).to eq '<ul class="breadcrumbs"><li><a href="http://test.host/kuva/">Photosets</a></li><li><a href="http://test.host/kuva/sets/72157632367381040">Paris</a></li></ul>'
+      end
+    end
+  end
+
+end

data/spec/kuva/authorizer_spec.rb

@@ -0,0 +1,83 @@
+require "spec_helper"
+
+module Kuva
+  describe Authorizer do
+
+    context ".new" do
+      before do
+        allow(Kuva).to receive(:api_key).and_return "<api_key>"
+        allow(Kuva).to receive(:shared_secret).and_return "<shared_secret>"
+      end
+
+      it "configures the FlickRaw API key" do
+        described_class.new
+        expect(FlickRaw.api_key).to eq "<api_key>"
+      end
+
+      it "configures the FlickRaw shared secret" do
+        described_class.new
+        expect(FlickRaw.shared_secret).to eq "<shared_secret>"
+      end
+    end
+
+    context ".authorize" do
+      it "authorizes" do
+        allow_any_instance_of(Authorizer).to receive :authorize
+        described_class.authorize
+      end
+    end
+
+    context "#authorize" do
+      before do
+        allow(STDIN).to receive(:gets).and_return "<authorization_code>"
+      end
+
+      let(:output) do
+        capture(:stdout) { subject.authorize }
+      end
+
+      context "with a valid authentication code" do
+        before do
+          allow(subject).to receive(:flickr).and_return double.as_null_object
+        end
+
+        it "outputs a notice about the authentication url" do
+          allow(subject).to receive(:authentication_url).and_return "<url>"
+          expect(output).to include "\nCopy the URL below and follow the steps on Flickr to authorize Kuva:\n<url>"
+        end
+
+        it "outputs a notice about the authentication code" do
+          expect(output).to include "\nOnce you've authorized Kuva, you'll receive a code (in the form of xxx-xxx-xxx) from Flickr. Copy and paste that code here and press <enter>:\n"
+        end
+
+        it "outputs a confirmation notice" do
+          allow(Kuva).to receive(:api_key).and_return "<api_key>"
+          allow(Kuva).to receive(:shared_secret).and_return "<shared_secret>"
+          subject.stub_chain(:flickr, :test, :login, :username).and_return "<username>"
+          subject.stub_chain(:flickr, :access_token).and_return "<access_token>"
+          subject.stub_chain(:flickr, :access_secret).and_return "<access_secret>"
+
+          expect(output).to include "\n<username>, you've successfully authorized Kuva with Flickr. As you can see we've received your username. Besides that we've got the following access token '<access_token>' and access secret '<access_secret>'. Both the API key, shared secret and the previously mentioned variables should be saved for later use. They're all listed below. Place them in `config/initializers/kuva.rb` and you're good to go.\n\n\tapi_key:       <api_key>\n\tshared_secret: <shared_secret>\n\taccess_token:  <access_token>\n\taccess_secret: <access_secret>\n\n"
+        end
+      end
+
+      context "with an invalid authentication code" do
+        it "outputs an authentication error" do
+          expect(output).to include "Authentication with Flickr failed: token_rejected"
+        end
+
+        context "with an incorrect API key and shared secret" do
+          before do
+            allow(FlickRaw).to receive(:api_key).and_return "<api_key>"
+            allow(FlickRaw).to receive(:shared_secret).and_return "<shared_secret>"
+          end
+
+          it "raises a failed response error" do
+            expect { flickr.get_access_token("<api_key>", "<shared_secret>", "<authentication_code>") }.to raise_error FlickRaw::OAuthClient::FailedResponse
+            capture(:stdout) { subject.authorize }
+          end
+        end
+      end
+    end
+  end
+end

data/spec/kuva/elements/photo_spec.rb

@@ -0,0 +1,76 @@
+# encoding: UTF-8
+require "spec_helper"
+
+module Kuva
+  module Elements
+    describe Photo, :vcr do
+
+      let(:photo_id) { "8317914535" }
+
+      context "#initialize" do
+        subject { described_class.find photo_id }
+
+        it "saves a reference to the id" do
+          expect(subject.id).to eq "8317914535"
+        end
+
+        it "saves a reference to the title" do
+          expect(subject.title).to eq "Musée du Louvre"
+        end
+
+        it "saves a reference to the description" do
+          expect(subject.description).to eq "These shots were taken in Paris, France in December 2012. Most of them are taken with my Nikon D80 and Nikkor 50mm f/1.8 or Tokina 12-24mm f/4."
+        end
+
+        it "saves a reference to the farm" do
+          expect(subject.farm).to eq 9
+        end
+
+        it "saves a reference to the server" do
+          expect(subject.server).to eq "8217"
+        end
+
+        it "saves a reference to the secret" do
+          expect(subject.secret).to eq "c7393787f3"
+        end
+
+        it "does NOT set the is_primary boolean" do
+          expect(subject.is_primary).to be_nil
+        end
+
+        it "returns itself" do
+          expect(subject).to be_a Kuva::Elements::Photo
+        end
+      end
+
+      context ".find" do
+        it "fetches the photo from Flickr specified by id" do
+          expect(flickr.photos).to receive(:getInfo).with(photo_id: photo_id).and_call_original
+          described_class.find photo_id
+        end
+
+        it "instantiates a new #{described_class} object" do
+          expect(described_class).to receive(:new).with(any_args).and_call_original
+          described_class.find photo_id
+        end
+      end
+
+      context "image URLs" do
+        subject { described_class.find photo_id }
+
+        it "instantiates a new URL info object to create image URLs" do
+          expect(Kuva::Elements::UrlInfo).to receive(:new).with(any_args).and_call_original
+          subject.url
+        end
+
+        it "generates an image URL for a default sized (medium) image" do
+          expect(subject.url).to eq "https://farm9.staticflickr.com/8217/8317914535_c7393787f3.jpg"
+        end
+
+        it "generates an image URL for a n-sized (small 320) image" do
+          expect(subject.url_n).to eq "https://farm9.staticflickr.com/8217/8317914535_c7393787f3_n.jpg"
+        end
+      end
+    end
+  end
+end

data/spec/kuva/elements/photoset_collection_spec.rb

@@ -0,0 +1,42 @@
+require "spec_helper"
+
+module Kuva
+  module Elements
+    describe PhotosetCollection, :vcr do
+
+      describe ".retrieve" do
+        subject { described_class.retrieve }
+
+        it "fetches all photosets from Flickr" do
+          expect(flickr.photosets).to receive(:getList).and_call_original
+          subject
+        end
+
+        it "instantiates a new #{described_class} object" do
+          expect(described_class).to receive(:new).and_call_original
+          subject
+        end
+      end
+
+      describe "#photosets" do
+        subject { described_class.new.photosets }
+
+        it "retrieves all photosets" do
+          expect(flickr.photosets).to receive(:getList).and_call_original
+          subject
+        end
+
+        it "returns an array" do
+          expect(subject).to be_an Array
+        end
+
+        it "wraps the photosets into a Kuva::Elements::Photoset element" do
+          subject.each do |photoset|
+            expect(photoset).to be_a Kuva::Elements::Photoset
+          end
+        end
+      end
+
+    end
+  end
+end

data/spec/kuva/elements/photoset_spec.rb

@@ -0,0 +1,106 @@
+require "spec_helper"
+
+module Kuva
+  module Elements
+    describe Photoset, :vcr do
+
+      let(:photoset_id) { "72157632367381040" }
+
+      context "#initialize" do
+        subject { described_class.find photoset_id }
+
+        it "saves a reference to the id" do
+          expect(subject.id).to eq "72157632367381040"
+        end
+
+        it "saves a reference to the title" do
+          expect(subject.title).to eq "Paris"
+        end
+
+        it "saves a reference to the description" do
+          expect(subject.description).to eq "These shots were taken in Paris, France in December 2012. Most of them are taken with my Nikon D80 and Nikkor 50mm f/1.8 or Tokina 12-24mm f/4."
+        end
+
+        it "saves a reference to the number of views" do
+          expect(subject.views).to eq "31"
+        end
+
+        it "saves a reference to the number of photos" do
+          expect(subject.number_of_photos).to eq 28
+        end
+
+        it "saves a reference to the farm" do
+          expect(subject.farm).to eq 9
+        end
+
+        it "saves a reference to the server" do
+          expect(subject.server).to eq "8499"
+        end
+
+        it "saves a reference to the secret" do
+          expect(subject.secret).to eq "eda82f692f"
+        end
+
+        it "saves a reference to the primary id" do
+          expect(subject.primary).to eq "8318972536"
+        end
+
+        it "saves a reference to the created at date" do
+          expect(subject.created_at).to eq "1356715289"
+        end
+
+        it "saves a reference to the updated at date" do
+          expect(subject.updated_at).to eq "1356717162"
+        end
+
+        it "returns itself" do
+          expect(subject).to be_a Kuva::Elements::Photoset
+        end
+      end
+
+      context ".find" do
+        it "fetches the photoset from Flickr specified by id" do
+          expect(flickr.photosets).to receive(:getInfo).with(photoset_id: photoset_id).and_call_original
+          described_class.find photoset_id
+        end
+
+        it "instantiates a new #{described_class} object" do
+          expect(described_class).to receive(:new).with(any_args).and_call_original
+          described_class.find photoset_id
+        end
+      end
+
+      context "#with_photos" do
+        subject { described_class.find photoset_id }
+
+        it "returns an array" do
+          expect(subject.with_photos).to be_an Array
+        end
+
+        it "returns an array with the size specified by number of photos" do
+          expect(subject.with_photos.size).to eq subject.number_of_photos
+        end
+
+        it "wraps the photos into a Kuva::Elements::Photo element" do
+          subject.with_photos.each do |photo|
+            expect(photo).to be_a Kuva::Elements::Photo
+          end
+        end
+      end
+
+      context "#image_url" do
+        subject { described_class.find photoset_id }
+
+        it "instantiates a new URL info object to create an image URL" do
+          expect(Kuva::Elements::UrlInfo).to receive(:new).with(any_args).and_call_original
+          subject.image_url
+        end
+
+        it "generates an image URL for a large square image" do
+          expect(subject.image_url).to eq "https://farm9.staticflickr.com/8499/8318972536_eda82f692f_q.jpg"
+        end
+      end
+
+    end
+  end
+end

data/spec/kuva/elements/url_info_spec.rb

@@ -0,0 +1,25 @@
+require "spec_helper"
+
+module Kuva
+  module Elements
+    describe UrlInfo do
+      subject { described_class.new "8317914535", "9", "8217", "c7393787f3" }
+
+      it "knows its id" do
+        expect(subject.id).to eq "8317914535"
+      end
+
+      it "knows its farm" do
+        expect(subject.farm).to eq "9"
+      end
+
+      it "knows its server" do
+        expect(subject.server).to eq "8217"
+      end
+
+      it "knows its secret" do
+        expect(subject.secret).to eq "c7393787f3"
+      end
+    end
+  end
+end

data/spec/kuva_spec.rb

@@ -0,0 +1,81 @@
+require "spec_helper"
+
+describe Kuva do
+
+  describe ".setup" do
+    it "yields itself" do
+      Kuva.setup do |config|
+        expect(config).to eq Kuva
+      end
+    end
+  end
+
+  context "setup block" do
+    before do
+      @old_api_key          = Kuva.api_key
+      @old_shared_secret    = Kuva.shared_secret
+      @old_access_token     = Kuva.access_token
+      @old_access_secret    = Kuva.access_secret
+      @old_cache_expiration = Kuva.cache_expiration
+    end
+
+    it "configures the API key" do
+      Kuva.setup do |config|
+        config.api_key = "kuva-api-key"
+      end
+
+      expect(Kuva.api_key).to eq "kuva-api-key"
+    end
+
+    it "configures the shared secret" do
+      Kuva.setup do |config|
+        config.shared_secret = "super-secret"
+      end
+
+      expect(Kuva.shared_secret).to eq "super-secret"
+    end
+
+    it "configures the access token" do
+      Kuva.setup do |config|
+        config.access_token = "access-token"
+      end
+
+      expect(Kuva.access_token).to eq "access-token"
+    end
+
+    it "configures the access secret" do
+      Kuva.setup do |config|
+        config.access_secret = "secret-access-token"
+      end
+
+      expect(Kuva.access_secret).to eq "secret-access-token"
+    end
+
+    it "configures the cache expiration" do
+      Kuva.setup do |config|
+        config.cache_expiration = "cache-expiration"
+      end
+
+      expect(Kuva.cache_expiration).to eq "cache-expiration"
+    end
+
+    after do
+      Kuva.setup do |config|
+        config.api_key          = @old_api_key
+        config.shared_secret    = @old_shared_secret
+        config.access_token     = @old_access_token
+        config.access_secret    = @old_access_secret
+        config.cache_expiration = @old_cache_expiration
+      end
+    end
+  end
+
+  context "default configuration" do
+    describe "cache expiration" do
+      it "knows its default cache expiration" do
+        expect(Kuva.cache_expiration).to eq 7.days
+      end
+    end
+  end
+
+end