google-book 0.2.0

data/.gitignore

@@ -0,0 +1,5 @@
+pkg/*
+*.gem
+.bundle
+spec/fixtures/cassette_library/*.yml
+Gemfile.lock

data/.rspec

@@ -0,0 +1 @@
+-cfd

data/Gemfile

@@ -0,0 +1,2 @@
+source 'http://rubygems.org'
+gemspec

data/LICENSE

@@ -0,0 +1,13 @@
+            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

@@ -0,0 +1,4 @@
+Google Book
+===========
+
+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

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

data/google.gemspec

@@ -0,0 +1,27 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path('../lib', __FILE__)
+require 'google/book/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'google-book'
+  s.version     = Google::Book::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ['Paper Cavalier']
+  s.email       = ['code@papercavalier.com']
+  s.homepage    = 'http://rubygems.org/gems/google-book'
+  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 = 'google-book'
+
+  s.add_dependency('bookland', ['~> 1.0.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']
+end

data/lib/google.rb

@@ -0,0 +1,7 @@
+require 'bookland'
+require 'httparty'
+
+require 'google/book/cover'
+require 'google/book/request'
+require 'google/book/response'
+require 'google/book/struct'

data/lib/google/book/cover.rb

@@ -0,0 +1,37 @@
+module Google
+  module Book
+    class Cover
+      def initialize(url)
+        @url = url
+      end
+
+      def thumbnail
+        cover_url(5)
+      end
+
+      def small
+        cover_url(1)
+      end
+
+      def medium
+        cover_url(2)
+      end
+
+      def large
+        cover_url(3)
+      end
+
+      def extra_large
+        cover_url(6)
+      end
+
+      private
+
+      def cover_url(zoom)
+        @url.
+          gsub('zoom=5', "zoom=#{zoom}").
+          gsub('&edge=curl', '')
+      end
+    end
+  end
+end

data/lib/google/book/request.rb

@@ -0,0 +1,42 @@
+require 'cgi'
+require 'httparty'
+
+module Google
+  module Book
+    module Request
+      include HTTParty
+      format :xml
+
+      class << self
+        attr_accessor :parameters
+
+        # Queries the Google Book Search Data API.
+        #
+        # 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 }
+          parameters['start-index'] = opts[:page] if opts[:page]
+          parameters['max-results'] = opts[:count] if opts[:count]
+
+          Response.new(get(url.to_s))
+        end
+
+        private
+
+        def query
+          parameters.map { |k, v| "#{k}=#{CGI.escape(v.to_s)}" }.join('&')
+        end
+
+        def url
+          URI::HTTP.build(:host  => 'books.google.com',
+                          :path  => '/books/feeds/volumes',
+                          :query => query)
+        end
+      end
+    end
+  end
+end

data/lib/google/book/response.rb

@@ -0,0 +1,30 @@
+module Google
+  module Book
+    class Response
+      def initialize(hash)
+        @feed = hash['feed']
+      end
+
+      def to_books
+        @feed['entry'].map do |hash|
+          book = Struct.new(
+            Cover.new(hash['link'][0]['href']),
+            hash['link'][1]['href'],
+            hash['link'][2]['href'],
+            [hash['dc:creator']].flatten,
+            hash['dc:date'],
+            hash['dc:description'],
+            [hash['dc:format']].flatten,
+            hash['dc:identifier'],
+            hash['dc:publisher'],
+            hash['dc:subject'],
+            [hash['dc:title']].flatten)
+        end
+      end
+
+      def total_results
+        @feed['openSearch:totalResults'].to_i
+      end
+    end
+  end
+end

data/lib/google/book/struct.rb

@@ -0,0 +1,50 @@
+module Google
+  module Book
+    class Struct< Struct.new :cover,
+                             :info,
+                             :preview,
+                             :creators,
+                             :date,
+                             :description,
+                             :formats,
+                             :identifiers,
+                             :publisher,
+                             :subjects,
+                             :titles
+
+      include Bookland
+
+      def formatted_creators
+        creators.join(', ')
+      end
+
+      def formatted_formats
+        formats.reject do |format|
+          format == 'book'
+        end.join(', ')
+      end
+
+      def formatted_publisher
+        publisher.
+          gsub(/[ ,]+Inc.?$/, '').
+          gsub(/Intl( |$)/) { "International#{$1}" }.
+          gsub(/Pr( |$)/) { "Press#{$1}" }.
+          gsub(/ Pub$/, ' Publishers').
+          gsub('Pub Group', 'Publishing Group').
+          gsub(/Univ( |$)/) { "University#{$1}" }
+      end
+
+      def formatted_title
+        titles.join(': ')
+      end
+
+      def isbn
+        identifiers.detect do |identifier|
+          identifier.match(/ISBN:([0-9X]{10,13})/)
+        end
+
+        ISBN.to_13($1) rescue nil
+      end
+    end
+  end
+end

data/lib/google/book/version.rb

@@ -0,0 +1,5 @@
+module Google
+  module Book
+    VERSION = '0.2.0'
+  end
+end

data/spec/google/book/cover_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper'
+
+module Google
+  module Book
+    describe Cover do
+      use_vcr_cassette 'google'
+
+      subject { Request.find('deleuze').to_books.first.cover }
+
+      %w{thumbnail small medium large extra_large}.each do |attribute|
+        its(attribute) { should_not be_nil }
+      end
+    end
+  end
+end

data/spec/google/book/request_spec.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+module Google
+  module Book
+    describe Request do
+      use_vcr_cassette 'google'
+
+      it "should escape parameters" do
+        Request.find('foo bar')
+        Request.send(:query).should include 'foo+bar'
+      end
+
+      it "should set page" do
+        Request.find('foo bar', :page => 2)
+        Request.send(:query).should include 'start-index=2'
+      end
+
+      it "should set number of results per page" do
+        Request.find('foo bar', :count => 20)
+        Request.send(:query).should include 'max-results=20'
+      end
+    end
+  end
+end

data/spec/google/book/response_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+module Google
+  module Book
+    describe Response do
+      use_vcr_cassette 'google'
+
+      let(:response) do
+        Request.find('deleuze')
+      end
+
+      it "should set total results" do
+        response.total_results.should > 0
+      end
+
+      it "should return books" do
+        books = response.to_books
+        books.first.should be_an_instance_of Struct
+      end
+    end
+  end
+end

data/spec/google/book/struct_spec.rb

@@ -0,0 +1,98 @@
+require 'spec_helper'
+
+module Google
+  module Book
+    describe Struct do
+      use_vcr_cassette 'google'
+
+      let(:book) do
+        Struct.new
+      end
+
+      subject { Request.find('deleuze').to_books.first }
+
+      %w{cover info preview creators date description formats
+        identifiers isbn publisher subjects titles}.each do |attribute|
+        its(attribute) { should_not be_nil }
+      end
+
+      describe "#formatted_creators" do
+        it "should concatenate creators" do
+          book.creators = ['Deleuze', 'Guattari']
+          book.formatted_creators.should eql 'Deleuze, Guattari'
+        end
+      end
+
+      describe "#formatted_formats" do
+        it "should concatenate formats" do
+          book.formats = ['foo', 'bar']
+          book.formatted_formats.should eql 'foo, bar'
+        end
+
+        it "should drop the word book" do
+          book.formats = ['foo', 'book']
+          book.formatted_formats.should eql 'foo'
+        end
+      end
+
+      describe "#formatted_publisher" do
+        it "should drop Inc at the end of the word" do
+          book.publisher = 'Publisher Inc'
+          book.formatted_publisher.should eql 'Publisher'
+
+          book.publisher = 'Random House, Inc.'
+          book.formatted_publisher.should eql 'Random House'
+        end
+
+        it "should format Intl" do
+          book.publisher = 'Continuum Intl'
+          book.formatted_publisher.should eql 'Continuum International'
+        end
+
+        it "should format Pr" do
+          book.publisher = 'Polity Pr'
+          book.formatted_publisher.should eql 'Polity Press'
+        end
+
+        it "should format Pub" do
+          book.publisher = 'Rowman & Littlefield Pub'
+          book.formatted_publisher.should eql 'Rowman & Littlefield Publishers'
+        end
+
+        it "should format Pub Group" do
+          book.publisher = 'Continuum International Pub Group'
+          book.formatted_publisher.should eql 'Continuum International Publishing Group'
+        end
+
+        it "should format Univ in the middle of the word" do
+          book.publisher = 'Columbia Univ Press'
+          book.formatted_publisher.should eql 'Columbia University Press'
+        end
+
+        it "should format Univ at the end of the word" do
+          book.publisher = 'Columbia Univ'
+          book.formatted_publisher.should eql 'Columbia University'
+        end
+      end
+
+      describe "#formatted_title" do
+        it "should concatenate titles" do
+          book.titles = ['Thousand Plateaus', 'Capitalism and Schizophrenia']
+          book.formatted_title.should eql 'Thousand Plateaus: Capitalism and Schizophrenia'
+        end
+      end
+
+      describe "#isbn" do
+        it "should return the ISBN" do
+          book.identifiers = ['8cp-Z_G42g4C','ISBN:0192802380']
+          book.isbn.should eql '9780192802385'
+        end
+
+        it "should return nil if no ISBN is available" do
+          book.identifiers = []
+          book.isbn.should eql nil
+        end
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,7 @@
+require 'rubygems'
+require 'bundler/setup'
+require 'rspec'
+
+require File.expand_path('../../lib/google', __FILE__)
+
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each { |f| require f }

data/spec/support/vcr.rb

@@ -0,0 +1,11 @@
+require 'vcr'
+
+VCR.config do |c|
+  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|
+  config.extend VCR::RSpec::Macros
+end

metadata

@@ -0,0 +1,134 @@
+--- !ruby/object:Gem::Specification 
+name: google-book
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.2.0
+platform: ruby
+authors: 
+- Paper Cavalier
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-03-05 00:00:00 +00:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: bookland
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.0.0
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.7.4
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 2.5.0
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: vcr
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.7.0
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: webmock
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.6.2
+  type: :development
+  version_requirements: *id005
+description: Google Book is a Ruby wrapper to the Google Book Search Data API.
+email: 
+- code@papercavalier.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- google.gemspec
+- lib/google.rb
+- lib/google/book/cover.rb
+- lib/google/book/request.rb
+- lib/google/book/response.rb
+- lib/google/book/struct.rb
+- lib/google/book/version.rb
+- spec/google/book/cover_spec.rb
+- spec/google/book/request_spec.rb
+- spec/google/book/response_spec.rb
+- spec/google/book/struct_spec.rb
+- spec/spec_helper.rb
+- spec/support/vcr.rb
+has_rdoc: true
+homepage: http://rubygems.org/gems/google-book
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: google-book
+rubygems_version: 1.5.2
+signing_key: 
+specification_version: 3
+summary: A Ruby wrapper to the Google Book Search Data API
+test_files: 
+- spec/google/book/cover_spec.rb
+- spec/google/book/request_spec.rb
+- spec/google/book/response_spec.rb
+- spec/google/book/struct_spec.rb
+- spec/spec_helper.rb
+- spec/support/vcr.rb