images_gallery 1.0.0.rc

data/spec/lib/images_gallery/cli_spec.rb

@@ -0,0 +1,64 @@
+require 'spec_helper'
+require 'images_gallery/cli'
+
+module ImagesGallery
+describe 'CLI' do
+
+  let(:cli_class) { CLI }
+  let(:command_line_interface) { CLI.new }
+
+  it 'should respond to .start' do
+    expect(cli_class).to respond_to :start
+  end
+
+  it { expect(command_line_interface).to respond_to :generate }
+
+  describe '#generate' do
+
+    it 'outputs what the generator returns' do
+      stderr = double()
+      stdout = double()
+      allow(command_line_interface).to receive_message_chain(:generator, :run).and_return('/path/to/gallery/index.html')
+
+      expect(stdout).to receive_message_chain(:puts).with('/path/to/gallery/index.html')
+      command_line_interface.generate('spec/fixtures/works.xml', 'spec/tmp', stderr, stdout)
+    end
+
+    describe 'provides quick feedback on common errors' do
+
+      context 'on SourceFileNotFoundError' do
+
+        it 'outputs an error message about the missing source file' do
+          stderr = double()
+          allow(command_line_interface).to receive_message_chain(:generator, :run) { raise ImagesGallery::SourceFileNotFoundError }
+
+          expect(stderr).to receive_message_chain(:puts).with('Please make sure the specified source file exists.')
+          command_line_interface.generate('source', 'target', stderr)
+        end
+      end
+
+      context 'on TargetDirectoryNotFoundError' do
+
+        it 'outputs an error message about the missing target directory' do
+          stderr = double()
+          allow(command_line_interface).to receive_message_chain(:generator, :run) { raise ImagesGallery::TargetDirectoryNotFoundError }
+
+          expect(stderr).to receive_message_chain(:puts).with('Please make sure the specified target directory exists.')
+          command_line_interface.generate('source', 'target', stderr)
+        end
+      end
+
+      context 'on SourceFileInvalidError' do
+
+        it 'outputs an error message about the XML source file not being well-formed' do
+          stderr = double()
+          allow(command_line_interface).to receive_message_chain(:generator, :run) { raise ImagesGallery::SourceFileInvalidError }
+
+          expect(stderr).to receive_message_chain(:puts).with('The source file is invalid. Please check it is well-formed XML.')
+          command_line_interface.generate('source', 'target', stderr)
+        end
+      end
+    end
+  end
+end
+end

data/spec/lib/images_gallery/collection_spec.rb

@@ -0,0 +1,14 @@
+require 'spec_helper'
+
+module ImagesGallery
+describe 'Collection' do
+
+  let(:collection) { Collection.new }
+
+  it_behaves_like 'a collection'
+
+  it { expect(collection).to respond_to :makes }
+  it { expect(collection).to respond_to :models }
+
+end
+end

data/spec/lib/images_gallery/generator_spec.rb

@@ -0,0 +1,11 @@
+require 'spec_helper'
+
+module ImagesGallery
+describe 'Generator' do
+
+  let(:generator) { Generator.new }
+
+  it_behaves_like 'a generator'
+
+end
+end

data/spec/lib/images_gallery/image_spec.rb

@@ -0,0 +1,11 @@
+require 'spec_helper'
+
+module ImagesGallery
+describe 'Image' do
+
+  let(:image) { Image.new }
+
+  it_behaves_like 'an image'
+
+end
+end

data/spec/lib/images_gallery/source_spec.rb

@@ -0,0 +1,43 @@
+require 'spec_helper'
+
+module ImagesGallery
+describe 'Source' do
+
+  let(:source) { Source.new('spec/fixtures/works.xml') }
+  let(:parser) { source }
+
+  it_behaves_like 'a parser'
+
+  it { expect(source).to respond_to :images }
+
+  describe '#images' do
+
+    context 'once the source has been parsed' do
+
+      describe 'is a collection of images' do
+
+        it 'is a kind of Array' do
+          source.parse
+          expect(source.images).to be_kind_of Array
+        end
+
+        it 'is composed of images' do
+          source.parse
+          source.images.each do |image|
+
+            # There is some duplication here that I couldn't remove.
+            # See spec/support/spec_for_image_interface.
+
+            #it_behaves_like 'an image'
+
+            expect(image).to respond_to :description
+            expect(image).to respond_to :make
+            expect(image).to respond_to :model
+            expect(image).to respond_to :src
+          end
+        end
+      end
+    end
+  end
+end
+end

data/spec/lib/images_gallery/view_spec.rb

@@ -0,0 +1,13 @@
+require 'spec_helper'
+
+module ImagesGallery
+describe 'View' do
+
+  let(:view) { View.new }
+
+  it 'does not define :template' do
+    expect { view.template }.to raise_error NotImplementedError
+  end
+
+end
+end

data/spec/lib/images_gallery/views/index_spec.rb

@@ -0,0 +1,16 @@
+require 'spec_helper'
+
+module ImagesGallery
+describe 'Views::Index' do
+
+  let(:data) do
+    data = Collection.new
+    data << Image.new
+  end
+
+  let(:view) { Views::Model.new(data) }
+
+  it_behaves_like 'a view'
+
+end
+end

data/spec/lib/images_gallery/views/make_spec.rb

@@ -0,0 +1,16 @@
+require 'spec_helper'
+
+module ImagesGallery
+describe 'Views::Make' do
+
+  let(:data) do
+    data = Collection.new
+    data << Image.new
+  end
+
+  let(:view) { Views::Model.new(data) }
+
+  it_behaves_like 'a view'
+
+end
+end

data/spec/lib/images_gallery/views/model_spec.rb

@@ -0,0 +1,16 @@
+require 'spec_helper'
+
+module ImagesGallery
+describe 'Views::Model' do
+
+  let(:data) do
+    data = Collection.new
+    data << Image.new
+  end
+
+  let(:view) { Views::Model.new(data) }
+
+  it_behaves_like 'a view'
+
+end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,32 @@
+require 'images_gallery'
+
+Dir["./spec/support/**/*.rb"].sort.each { |f| require f; puts f }
+
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  # make sure the deprecated RSpec 2 syntax is not used
+  config.raise_errors_for_deprecations!
+
+  # 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
+end

data/spec/support/capybara.rb

@@ -0,0 +1,12 @@
+require 'capybara/rspec'
+
+require 'images_gallery/test_application'
+
+test_target = ImagesGallery::TestApplication::DEFAULT_TARGET
+
+FileUtils.mkdir_p(test_target) unless File.exists?(test_target)
+
+Capybara.app = Rack::Builder.new do
+  use Rack::Static, urls: [""], root: test_target, index: 'index.html'
+  run ImagesGallery::TestApplication
+end

data/spec/support/helpers.rb

@@ -0,0 +1,18 @@
+module Selectors
+  def navigation_selector
+    'nav'
+  end
+
+  def header_selector
+    'header'
+  end
+
+  def title_selector
+    { 'head' => 'title', 'body' => 'h1' }
+  end
+end
+
+RSpec.configure do |config|
+  config.extend Selectors
+  config.include Selectors
+end

data/spec/support/spec_for_collection_interface.rb

@@ -0,0 +1,7 @@
+RSpec.shared_examples 'a collection' do
+
+  it 'is a kind of Array' do
+    expect(collection).to be_kind_of Array
+  end
+
+end

data/spec/support/spec_for_generator_interface.rb

@@ -0,0 +1,29 @@
+RSpec.shared_examples 'a generator' do
+
+  it 'responds to :run' do
+    expect(generator).to respond_to :run
+  end
+
+  describe '#run' do
+
+    context 'when called with a unexistent file' do
+      it { expect{ generator.run('missing.xml', 'spec/tmp/') }.to raise_error ImagesGallery::SourceFileNotFoundError }
+    end
+
+    context 'when called with an unexistent target directory' do
+      it { expect{ generator.run('spec/fixtures/works.xml', 'spec/tmp/missing') }.to raise_error ImagesGallery::TargetDirectoryNotFoundError }
+    end
+
+    context 'when called with a file path as second argument (instead of a driectory path)' do
+      it { expect{ generator.run('spec/fixtures/works.xml', 'spec/tmp/missing') }.to raise_error ImagesGallery::TargetDirectoryNotFoundError }
+    end
+
+    it 'accepts a file path and a directory path as arguments' do
+      expect{ generator.run('spec/fixtures/works.xml', 'spec/tmp/') }.not_to raise_error
+    end
+
+    it 'returns the path of the gallery index page' do
+      expect(generator.run('spec/fixtures/works.xml', 'spec/tmp/')).to eq 'spec/tmp/index.html'
+    end
+  end
+end

data/spec/support/spec_for_image_interface.rb

@@ -0,0 +1,18 @@
+RSpec.shared_examples 'an image' do
+
+  it 'responds to :description' do
+    expect(image).to respond_to :description
+  end
+
+  it 'responds to :make' do
+    expect(image).to respond_to :make
+  end
+
+  it 'responds to :model' do
+    expect(image).to respond_to :model
+  end
+
+  it 'responds to :src' do
+    expect(image).to respond_to :src
+  end
+end

data/spec/support/spec_for_images_gallery.rb

@@ -0,0 +1,28 @@
+RSpec.shared_examples 'an images gallery' do |thumbnails, header_selector, navigation_selector, title_selector|
+
+  it 'has a <title/>' do
+    expect(page).to have_selector title_selector['head'], visible: false
+  end
+
+  it "displays #{thumbnails} thumbnails" do
+    expect(page).to have_selector 'img', count: thumbnails
+  end
+
+  describe 'header' do
+
+    it 'is contains the navigation' do
+      expect(page).to have_selector "#{header_selector} #{navigation_selector}"
+    end
+
+    it 'is contains the page title' do
+      expect(page).to have_selector "#{header_selector} #{title_selector['body']}"
+    end
+  end
+
+  describe 'navigation' do
+
+    it 'is contained by a <nav/> element' do
+      expect(page).to have_selector navigation_selector
+    end
+  end
+end

data/spec/support/spec_for_make_page.rb

@@ -0,0 +1,9 @@
+RSpec.shared_examples 'a make page' do |navigation_selector|
+
+  describe 'navigation' do
+
+    it 'contains a link to the index page' do
+      expect(page).to have_selector "#{navigation_selector} a[href='index.html']"
+    end
+  end
+end

data/spec/support/spec_for_model_page.rb

@@ -0,0 +1,13 @@
+RSpec.shared_examples 'a model page' do |make, navigation_selector|
+
+  describe 'navigation' do
+
+    it 'contains a link to the index page' do
+      expect(page).to have_selector "#{navigation_selector} a[href='../index.html']"
+    end
+
+    it 'contains a link to the make page' do
+      expect(page).to have_selector "#{navigation_selector} a[href='../#{make}.html']"
+    end
+  end
+end

data/spec/support/spec_for_parser_interface.rb

@@ -0,0 +1,6 @@
+RSpec.shared_examples 'a parser' do
+
+  it 'responds to :parse' do
+    expect(parser).to respond_to :parse
+  end
+end

data/spec/support/spec_for_view_inerface.rb

@@ -0,0 +1,19 @@
+RSpec.shared_examples 'a view' do
+
+  it 'responds to :render' do
+    expect(view).to respond_to :render
+  end
+
+  it 'responds to :template' do
+    expect(view).to respond_to :template
+  end
+
+  it 'defines :template' do
+    expect { view.template }.not_to raise_error
+  end
+
+  context 'when built with no data' do
+
+    it 'exits gracefully (?)'
+  end
+end

data/spec/tmp/canon/canon_eos_20d.html

@@ -0,0 +1,76 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Images by (Canon) Canon EOS 20D</title>
+    <style type="text/css">
+      html, body {
+        font-family: "adelle", "Helvetica Neue", Helvetica, Arial, sans-serif;
+        font-size: 1rem;
+      }
+      nav {
+        border: 1px solid #ccc;
+        border-width: 1px 0;
+        margin: 2rem 0;
+      }
+      .nav-link {
+        display: inline-block;
+        line-height: 3rem;
+        padding: 0 1rem;
+        text-decoration: none;
+        text-transform: uppercase;
+      }
+      .grid {
+        max-width: 960px;
+      }
+      .grid-item {
+        border: 1px solid #ccc;
+        display: inline-block;
+        padding: 10px 10px 5px;
+        position: relative;
+        margin: 5px;
+      }
+      .grid-item-details {
+        background-color: rgba(255, 255, 255, 0.9);
+        color: #333;
+        font-size: .8rem;
+        font-variant: small-caps;
+        height: 3rem;
+        left: 0;
+        line-height: 1.2rem;
+        opacity: 0;
+        padding: .2rem 0 10px;
+        position: absolute;
+        width: 100%;
+        bottom: 0;
+        text-align: center;
+        text-decoration: none;
+      }
+      .grid-item:hover .grid-item-details {
+        opacity: 1;
+      }
+    </style>
+    </head>
+  <body>
+    <header>
+      <h1>Images by (Canon) Canon EOS 20D</h1>
+      <nav>
+  
+    <a class="nav-link" href="../index.html">Browse all the images</a>
+  
+    <a class="nav-link" href="../canon.html">Browse all the Canon images</a>
+  
+</nav>
+
+    </header>
+
+    <div class="grid">
+  
+    <div class="grid-item">
+      <img alt="Image 2041" src="http://ih1.redbubble.net/work.2041.1.flat,135x135,075,f.jpg"/>
+      
+    </div>
+  
+</div>
+
+  </body>
+</html>

data/spec/tmp/canon/canon_eos_400d_digital.html

@@ -0,0 +1,76 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Images by (Canon) Canon EOS 400D DIGITAL</title>
+    <style type="text/css">
+      html, body {
+        font-family: "adelle", "Helvetica Neue", Helvetica, Arial, sans-serif;
+        font-size: 1rem;
+      }
+      nav {
+        border: 1px solid #ccc;
+        border-width: 1px 0;
+        margin: 2rem 0;
+      }
+      .nav-link {
+        display: inline-block;
+        line-height: 3rem;
+        padding: 0 1rem;
+        text-decoration: none;
+        text-transform: uppercase;
+      }
+      .grid {
+        max-width: 960px;
+      }
+      .grid-item {
+        border: 1px solid #ccc;
+        display: inline-block;
+        padding: 10px 10px 5px;
+        position: relative;
+        margin: 5px;
+      }
+      .grid-item-details {
+        background-color: rgba(255, 255, 255, 0.9);
+        color: #333;
+        font-size: .8rem;
+        font-variant: small-caps;
+        height: 3rem;
+        left: 0;
+        line-height: 1.2rem;
+        opacity: 0;
+        padding: .2rem 0 10px;
+        position: absolute;
+        width: 100%;
+        bottom: 0;
+        text-align: center;
+        text-decoration: none;
+      }
+      .grid-item:hover .grid-item-details {
+        opacity: 1;
+      }
+    </style>
+    </head>
+  <body>
+    <header>
+      <h1>Images by (Canon) Canon EOS 400D DIGITAL</h1>
+      <nav>
+  
+    <a class="nav-link" href="../index.html">Browse all the images</a>
+  
+    <a class="nav-link" href="../canon.html">Browse all the Canon images</a>
+  
+</nav>
+
+    </header>
+
+    <div class="grid">
+  
+    <div class="grid-item">
+      <img alt="Image 777577" src="http://ih1.redbubble.net/work.777577.1.flat,135x135,075,f.jpg"/>
+      
+    </div>
+  
+</div>
+
+  </body>
+</html>

data/spec/tmp/canon.html

@@ -0,0 +1,93 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Images by Canon</title>
+    <style type="text/css">
+      html, body {
+        font-family: "adelle", "Helvetica Neue", Helvetica, Arial, sans-serif;
+        font-size: 1rem;
+      }
+      nav {
+        border: 1px solid #ccc;
+        border-width: 1px 0;
+        margin: 2rem 0;
+      }
+      .nav-link {
+        display: inline-block;
+        line-height: 3rem;
+        padding: 0 1rem;
+        text-decoration: none;
+        text-transform: uppercase;
+      }
+      .grid {
+        max-width: 960px;
+      }
+      .grid-item {
+        border: 1px solid #ccc;
+        display: inline-block;
+        padding: 10px 10px 5px;
+        position: relative;
+        margin: 5px;
+      }
+      .grid-item-details {
+        background-color: rgba(255, 255, 255, 0.9);
+        color: #333;
+        font-size: .8rem;
+        font-variant: small-caps;
+        height: 3rem;
+        left: 0;
+        line-height: 1.2rem;
+        opacity: 0;
+        padding: .2rem 0 10px;
+        position: absolute;
+        width: 100%;
+        bottom: 0;
+        text-align: center;
+        text-decoration: none;
+      }
+      .grid-item:hover .grid-item-details {
+        opacity: 1;
+      }
+    </style>
+    </head>
+  <body>
+    <header>
+      <h1>Images by Canon</h1>
+      <nav>
+  
+    <a class="nav-link" href="index.html">Browse all the images</a>
+  
+    <a class="nav-link" href="canon/canon_eos_20d.html">Canon EOS 20D</a>
+  
+    <a class="nav-link" href="canon/canon_eos_400d_digital.html">Canon EOS 400D DIGITAL</a>
+  
+</nav>
+
+    </header>
+
+    <div class="grid">
+  
+    <div class="grid-item">
+      <img alt="Image 2041" src="http://ih1.redbubble.net/work.2041.1.flat,135x135,075,f.jpg"/>
+      
+        <a class="grid-item-details" href="canon/canon_eos_20d.html" title="Browse all the Canon EOS 20D images.">
+          <div>Canon</div>
+          <div>Canon EOS 20D</div>
+        </a>
+      
+    </div>
+  
+    <div class="grid-item">
+      <img alt="Image 777577" src="http://ih1.redbubble.net/work.777577.1.flat,135x135,075,f.jpg"/>
+      
+        <a class="grid-item-details" href="canon/canon_eos_400d_digital.html" title="Browse all the Canon EOS 400D DIGITAL images.">
+          <div>Canon</div>
+          <div>Canon EOS 400D DIGITAL</div>
+        </a>
+      
+    </div>
+  
+</div>
+
+  </body>
+</html>