googlebook 0.0.1 → 0.1.0

data/Gemfile

@@ -1,4 +1,2 @@
-source "http://rubygems.org"
-
-# Specify your gem's dependencies in googlebooks.gemspec
+source 'http://rubygems.org'
 gemspec

data/Gemfile.lock

@@ -1,37 +1,27 @@
 PATH
   remote: .
   specs:
-    googlebook (0.0.1)
-      httparty (~> 0.6.1)
+    googlebook (0.1.0)
+      httparty (~> 0.7.4)
 
 GEM
   remote: http://rubygems.org/
   specs:
-    addressable (2.2.2)
+    addressable (2.2.4)
     crack (0.1.8)
     diff-lcs (1.1.2)
-    httparty (0.6.1)
+    httparty (0.7.4)
       crack (= 0.1.8)
-    json (1.4.6)
-    rdiscount (1.6.5)
-    rdoc (2.4.3)
-    rspec (2.0.1)
-      rspec-core (~> 2.0.1)
-      rspec-expectations (~> 2.0.1)
-      rspec-mocks (~> 2.0.1)
-    rspec-core (2.0.1)
-    rspec-expectations (2.0.1)
-      diff-lcs (>= 1.1.2)
-    rspec-mocks (2.0.1)
-      rspec-core (~> 2.0.1)
-      rspec-expectations (~> 2.0.1)
-    sdoc (0.2.20)
-      json (>= 1.1.3)
-      rdoc (= 2.4.3)
-    sdoc-helpers (0.1.4)
-      sdoc (~> 0.2)
-    vcr (1.2.0)
-    webmock (1.4.0)
+    rspec (2.5.0)
+      rspec-core (~> 2.5.0)
+      rspec-expectations (~> 2.5.0)
+      rspec-mocks (~> 2.5.0)
+    rspec-core (2.5.1)
+    rspec-expectations (2.5.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.5.0)
+    vcr (1.7.0)
+    webmock (1.6.2)
       addressable (>= 2.2.2)
       crack (>= 0.1.7)
 
@@ -40,9 +30,6 @@ PLATFORMS
 
 DEPENDENCIES
   googlebook!
-  httparty (~> 0.6.1)
-  rdiscount (~> 1.6.5)
-  rspec (~> 2.0.1)
-  sdoc-helpers (~> 0.1.4)
-  vcr (~> 1.2.0)
-  webmock (~> 1.4.0)
+  rspec (~> 2.5.0)
+  vcr (~> 1.7.0)
+  webmock (~> 1.6.2)

data/LICENSE

@@ -1,22 +1,13 @@
-(The MIT License)
- 
-Copyright (c) 2010 Paper Cavalier
- 
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-'Software'), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
- 
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
- 
-THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
-CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
-TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
-SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+                    Version 2, December 2004
+
+ Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>
+
+ Everyone is permitted to copy and distribute verbatim or modified
+ copies of this license document, and changing it is allowed as long
+ as the name is changed.
+
+            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. You just DO WHAT THE FUCK YOU WANT TO.

data/README.md

@@ -1,16 +1,4 @@
 Google Book
 ===========
 
-Google Book is a work-in-progress Ruby class in tight embrace with the [Google Book Search Data API](http://code.google.com/apis/books/docs/gdata/developers_guide_protocol.html).
-
-    books = GoogleBook.find('deleuze')
-    
-    book = books.first
-    book.title
-    => "Foucault"
-    book.isbn
-    => "9780826490780"
-
-Paginate through the result set, sort of.
-
-    GoogleBook.find('deleuze', :page => 2, :count => 20)
+Google Book is a Ruby wrapper to the [Google Book Search Data API](http://code.google.com/apis/books/docs/gdata/developers_guide_protocol.html).

data/Rakefile

@@ -1,12 +1,11 @@
-require "bundler"
-require "rspec/core/rake_task"
-require "sdoc_helpers"
+require 'bundler'
+require 'rspec/core/rake_task'
 
 Bundler::GemHelper.install_tasks
 
-desc "Run all specs in spec directory"
+desc 'Run all specs in spec directory'
 RSpec::Core::RakeTask.new(:spec) do |spec|
-  spec.pattern = "spec/**/*_spec.rb"
+  spec.pattern = 'spec/**/*_spec.rb'
 end
 
 task :default => :spec

data/googlebook.gemspec

@@ -1,28 +1,26 @@
 # -*- encoding: utf-8 -*-
-$:.push File.expand_path("../lib", __FILE__)
-require "googlebook/version"
+$:.push File.expand_path('../lib', __FILE__)
+require 'googlebook/version'
 
 Gem::Specification.new do |s|
-  s.name        = "googlebook"
+  s.name        = 'googlebook'
   s.version     = GoogleBook::VERSION
   s.platform    = Gem::Platform::RUBY
-  s.authors     = ["Hakan Ensari"]
-  s.email       = ["hakan.ensari@papercavalier.com"]
-  s.homepage    = "http://gloss.papercavalier.com/googlebook"
-  s.summary     = %q{A Ruby class in tight embrace with the Google Book Search Data API}
-  s.description = %q{Google Book is a Ruby class in tight embrace with the Google Book Search Data API.}
+  s.authors     = ['Paper Cavalier']
+  s.email       = ['code@papercavalier.com']
+  s.homepage    = 'http://rubygems.com/gems/googlebook'
+  s.summary     = %q{A Ruby wrapper to the Google Book Search Data API}
+  s.description = %q{Google Book is a Ruby wrapper to the Google Book Search Data API.}
 
-  s.rubyforge_project = "googlebook"
+  s.rubyforge_project = 'googlebook'
 
-  s.add_dependency("httparty", ["~> 0.6.1"])
-  s.add_development_dependency("rdiscount", "~> 1.6.5")
-  s.add_development_dependency("rspec", ["~> 2.0.1"])
-  s.add_development_dependency("sdoc-helpers", "~> 0.1.4")
-  s.add_development_dependency("vcr", "~> 1.2.0")
-  s.add_development_dependency("webmock", "~> 1.4.0")
+  s.add_dependency('httparty', ['~> 0.7.4'])
+  s.add_development_dependency('rspec', ['~> 2.5.0'])
+  s.add_development_dependency('vcr', '~> 1.7.0')
+  s.add_development_dependency('webmock', '~> 1.6.2')
 
   s.files         = `git ls-files`.split("\n")
   s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
   s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
-  s.require_paths = ["lib"]
+  s.require_paths = ['lib']
 end

data/lib/googlebook.rb

@@ -1,24 +1,3 @@
-require File.dirname(__FILE__) + '/googlebook/finder'
-
-# A Ruby class in tight embrace with the Google Book Search Data API
-class GoogleBook
-  attr_accessor :thumbnail,
-                :info,
-                :preview,
-                :creator,
-                :date,
-                :description,
-                :format,
-                :identifier,
-                :publisher,
-                :subject,
-                :title
-
-  def initialize(args={})
-    args.each { |k, v| self.send "#{k}=", v }
-  end
-
-  def isbn
-    identifier.detect { |i| i.match(/ISBN:([0-9]{13})/) }; $1
-  end
-end
+require 'googlebook/book'
+require 'googlebook/finder'
+require 'googlebook/images'

data/lib/googlebook/book.rb

@@ -0,0 +1,29 @@
+module GoogleBook
+  class Book < Struct.new :images,
+                          :info,
+                          :preview,
+                          :creator,
+                          :date,
+                          :description,
+                          :format,
+                          :identifier,
+                          :publisher,
+                          :subject,
+                          :title
+
+    def initialize(args={})
+      args.each { |k, v| self.send "#{k}=", v }
+    end
+
+    def isbn
+      @isbn ||= find_isbn
+    end
+
+    private
+
+    def find_isbn
+      identifier.detect { |i| i.match(/ISBN:([0-9]{13})/) }
+      $1
+    end
+  end
+end

data/lib/googlebook/finder.rb

@@ -2,26 +2,30 @@ require 'cgi'
 require 'httparty'
 
 # A classy finder
-class GoogleBook
+module GoogleBook
   include HTTParty
   format :xml
 
   class << self
+
     # Query parameters passed on to Google
     attr_accessor :parameters
 
-    # Total results for last query
+    # Total results for query
     attr_accessor :total_results
 
-    # Queries the Google Book Search Data API
+    # The query response
+    attr_accessor :response
+
+    # Queries the Google Book Search Data API.
     #
-    # Optionally, specify a page and count to (sort-of) paginate through
+    # Optionally, specify a page and count to paginate through
     # the result set.
     #
     #   GoogleBook.find('deleuze', :page => 2, :count => 20)
     #
     def find(query, opts={})
-      self.parameters           = { 'q' => query }
+      self.parameters = { 'q' => query }
 
       if opts[:page] && opts[:page].to_i > 0
         parameters['start-index'] = opts[:page]
@@ -31,20 +35,23 @@ class GoogleBook
         parameters['max-results'] = opts[:count]
       end
 
-      response = self.get(uri.to_s)
+      self.response = self.get(uri.to_s)
+
       self.total_results = response['feed']['openSearch:totalResults'].to_i
+
       response['feed']['entry'].map do |book|
-        new :thumbnail    => book['link'][0]['href'],
-            :info         => book['link'][1]['href'],
-            :preview      => book['link'][2]['href'],
-            :creator      => book['dc:creator'],
-            :date         => book['dc:date'],
-            :description  => book['dc:description'],
-            :format       => book['dc:format'],
-            :identifier   => book['dc:identifier'],
-            :publisher    => book['dc:publisher'],
-            :subject      => book['dc:subject'],
-            :title        => book['dc:title']
+        Book.new(
+          :images       => Images.new(book['link'][0]['href']),
+          :info         => book['link'][1]['href'],
+          :preview      => book['link'][2]['href'],
+          :creator      => book['dc:creator'],
+          :date         => book['dc:date'],
+          :description  => book['dc:description'],
+          :format       => book['dc:format'],
+          :identifier   => book['dc:identifier'],
+          :publisher    => book['dc:publisher'],
+          :subject      => book['dc:subject'],
+          :title        => book['dc:title'])
       end
     end
 

data/lib/googlebook/images.rb

@@ -0,0 +1,30 @@
+module GoogleBook
+  class Images
+    attr_accessor :url
+    def initialize(url)
+      self.url = url
+    end
+
+    def thumbnail
+      url
+    end
+
+    def small
+      zoom(1)
+    end
+
+    def medium
+      zoom(2)
+    end
+
+    def large
+      zoom(3)
+    end
+
+    private
+
+    def zoom(level)
+      url.gsub('zoom=5', "zoom=#{level}")
+    end
+  end
+end

data/lib/googlebook/version.rb

@@ -1,3 +1,3 @@
-class GoogleBook
-  VERSION = "0.0.1"
+module GoogleBook
+  VERSION = '0.1.0'
 end

data/spec/googlebook/book_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+module GoogleBook
+  describe Book do
+    use_vcr_cassette 'googlebook'
+
+    subject { GoogleBook.find('deleuze').first }
+
+    %w{images info preview creator date description format
+      identifier isbn publisher subject title}.each do |attribute|
+      its(attribute) { should_not be_nil }
+    end
+
+    context "images" do
+      subject { GoogleBook.find('deleuze').first.images }
+
+      %w{thumbnail small medium large}.each do |attribute|
+        its(attribute) { should_not be_nil }
+      end
+    end
+  end
+end

data/spec/googlebook/finder_spec.rb

@@ -1,9 +1,9 @@
 require 'spec_helper'
 
-describe GoogleBook do
-  use_vcr_cassette 'googlebook', :record => :new_episodes
+module GoogleBook
+  describe "Finder module" do
+    use_vcr_cassette 'googlebook'
 
-  context "Finder" do
     it "should escape parameters" do
       GoogleBook.find('foo bar')
       GoogleBook.send(:query).should include 'foo+bar'
@@ -19,14 +19,14 @@ describe GoogleBook do
       GoogleBook.send(:query).should include 'max-results=20'
     end
 
-    it "should validate page" do
+    it "should filter out invalid pages" do
       %w{-1 0 foo}.each do |page|
         GoogleBook.find('foo bar', :page => page)
         GoogleBook.send(:query).should_not include 'start-index'
       end
     end
 
-    it "should validate results per page" do
+    it "should filter out invalid counts" do
       %w{9 21 foo}.each do |count|
         GoogleBook.find('foo bar', :count => count)
         GoogleBook.send(:query).should_not include 'max-results'
@@ -39,7 +39,7 @@ describe GoogleBook do
     end
 
     it "should return books" do
-      GoogleBook.find('deleuze').first.should be_an_instance_of GoogleBook
+      GoogleBook.find('deleuze').first.should be_an_instance_of Book
     end
   end
 end

data/spec/support/vcr.rb

@@ -1,9 +1,9 @@
 require 'vcr'
 
 VCR.config do |c|
-  c.cassette_library_dir     = File.dirname(__FILE__) + '/../fixtures/cassette_library'
-  c.http_stubbing_library    = :webmock
+  c.cassette_library_dir = File.dirname(__FILE__) + '/../fixtures/cassette_library'
   c.default_cassette_options = { :record => :new_episodes }
+  c.stub_with :webmock
 end
 
 RSpec.configure do |config|

metadata

@@ -1,20 +1,16 @@
 --- !ruby/object:Gem::Specification 
 name: googlebook
 version: !ruby/object:Gem::Version 
-  prerelease: false
-  segments: 
-  - 0
-  - 0
-  - 1
-  version: 0.0.1
+  prerelease: 
+  version: 0.1.0
 platform: ruby
 authors: 
-- Hakan Ensari
+- Paper Cavalier
 autorequire: 
 bindir: bin
 cert_chain: []
 
-date: 2010-10-26 00:00:00 +01:00
+date: 2011-03-04 00:00:00 +00:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -25,91 +21,45 @@ dependencies:
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        - 6
-        - 1
-        version: 0.6.1
+        version: 0.7.4
   type: :runtime
   version_requirements: *id001
 - !ruby/object:Gem::Dependency 
-  name: rdiscount
+  name: rspec
   prerelease: false
   requirement: &id002 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        segments: 
-        - 1
-        - 6
-        - 5
-        version: 1.6.5
+        version: 2.5.0
   type: :development
   version_requirements: *id002
 - !ruby/object:Gem::Dependency 
-  name: rspec
+  name: vcr
   prerelease: false
   requirement: &id003 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        segments: 
-        - 2
-        - 0
-        - 1
-        version: 2.0.1
+        version: 1.7.0
   type: :development
   version_requirements: *id003
 - !ruby/object:Gem::Dependency 
-  name: sdoc-helpers
+  name: webmock
   prerelease: false
   requirement: &id004 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        - 1
-        - 4
-        version: 0.1.4
+        version: 1.6.2
   type: :development
   version_requirements: *id004
-- !ruby/object:Gem::Dependency 
-  name: vcr
-  prerelease: false
-  requirement: &id005 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 1
-        - 2
-        - 0
-        version: 1.2.0
-  type: :development
-  version_requirements: *id005
-- !ruby/object:Gem::Dependency 
-  name: webmock
-  prerelease: false
-  requirement: &id006 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 1
-        - 4
-        - 0
-        version: 1.4.0
-  type: :development
-  version_requirements: *id006
-description: Google Book is a Ruby class in tight embrace with the Google Book Search Data API.
+description: Google Book is a Ruby wrapper to the Google Book Search Data API.
 email: 
-- hakan.ensari@papercavalier.com
+- code@papercavalier.com
 executables: []
 
 extensions: []
@@ -119,7 +69,6 @@ extra_rdoc_files: []
 files: 
 - .gitignore
 - .rspec
-- CHANGELOG.md
 - Gemfile
 - Gemfile.lock
 - LICENSE
@@ -127,14 +76,16 @@ files:
 - Rakefile
 - googlebook.gemspec
 - lib/googlebook.rb
+- lib/googlebook/book.rb
 - lib/googlebook/finder.rb
+- lib/googlebook/images.rb
 - lib/googlebook/version.rb
+- spec/googlebook/book_spec.rb
 - spec/googlebook/finder_spec.rb
-- spec/googlebook_spec.rb
 - spec/spec_helper.rb
 - spec/support/vcr.rb
 has_rdoc: true
-homepage: http://gloss.papercavalier.com/googlebook
+homepage: http://rubygems.com/gems/googlebook
 licenses: []
 
 post_install_message: 
@@ -147,26 +98,22 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      segments: 
-      - 0
       version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      segments: 
-      - 0
       version: "0"
 requirements: []
 
 rubyforge_project: googlebook
-rubygems_version: 1.3.7
+rubygems_version: 1.5.2
 signing_key: 
 specification_version: 3
-summary: A Ruby class in tight embrace with the Google Book Search Data API
+summary: A Ruby wrapper to the Google Book Search Data API
 test_files: 
+- spec/googlebook/book_spec.rb
 - spec/googlebook/finder_spec.rb
-- spec/googlebook_spec.rb
 - spec/spec_helper.rb
 - spec/support/vcr.rb

data/spec/googlebook_spec.rb

@@ -1,12 +0,0 @@
-require 'spec_helper'
-
-describe GoogleBook do
-  use_vcr_cassette 'googlebook', :record => :new_episodes
-
-  subject { GoogleBook.find('deleuze').first }
-
-  %w{thumbnail info preview creator date description format
-    identifier isbn publisher subject title}.each do |attribute|
-    its(attribute) { should_not be_nil }
-  end
-end