googlebook 0.0.1

data/.gitignore

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

data/.rspec

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

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,48 @@
+PATH
+  remote: .
+  specs:
+    googlebook (0.0.1)
+      httparty (~> 0.6.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.2.2)
+    crack (0.1.8)
+    diff-lcs (1.1.2)
+    httparty (0.6.1)
+      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)
+      addressable (>= 2.2.2)
+      crack (>= 0.1.7)
+
+PLATFORMS
+  ruby
+
+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)

data/LICENSE

@@ -0,0 +1,22 @@
+(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.

data/README.md

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

data/Rakefile

@@ -0,0 +1,12 @@
+require "bundler"
+require "rspec/core/rake_task"
+require "sdoc_helpers"
+
+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/googlebook.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "googlebook/version"
+
+Gem::Specification.new do |s|
+  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.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.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/googlebook.rb

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

data/lib/googlebook/finder.rb

@@ -0,0 +1,63 @@
+require 'cgi'
+require 'httparty'
+
+# A classy finder
+class GoogleBook
+  include HTTParty
+  format :xml
+
+  class << self
+    # Query parameters passed on to Google
+    attr_accessor :parameters
+
+    # Total results for last query
+    attr_accessor :total_results
+
+    # Queries the Google Book Search Data API
+    #
+    # Optionally, specify a page and count to (sort-of) paginate through
+    # the result set.
+    #
+    #   GoogleBook.find('deleuze', :page => 2, :count => 20)
+    #
+    def find(query, opts={})
+      self.parameters           = { 'q' => query }
+
+      if opts[:page] && opts[:page].to_i > 0
+        parameters['start-index'] = opts[:page]
+      end
+
+      if opts[:count] && (10..20).include?(opts[:count].to_i)
+        parameters['max-results'] = opts[:count]
+      end
+
+      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']
+      end
+    end
+
+    private
+
+    def query
+      parameters.map { |k, v| "#{k}=#{CGI.escape(v.to_s)}" }.join('&')
+    end
+
+    def uri
+      URI::HTTP.build :host   => 'books.google.com',
+                      :path   => '/books/feeds/volumes',
+                      :query  => query
+    end
+  end
+end

data/lib/googlebook/version.rb

@@ -0,0 +1,3 @@
+class GoogleBook
+  VERSION = "0.0.1"
+end

data/spec/googlebook/finder_spec.rb

@@ -0,0 +1,45 @@
+require 'spec_helper'
+
+describe GoogleBook do
+  use_vcr_cassette 'googlebook', :record => :new_episodes
+
+  context "Finder" do
+    it "should escape parameters" do
+      GoogleBook.find('foo bar')
+      GoogleBook.send(:query).should include 'foo+bar'
+    end
+
+    it "should set page" do
+      GoogleBook.find('foo bar', :page => 2)
+      GoogleBook.send(:query).should include 'start-index=2'
+    end
+
+    it "should set number of results per page" do
+      GoogleBook.find('foo bar', :count => 20)
+      GoogleBook.send(:query).should include 'max-results=20'
+    end
+
+    it "should validate page" 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
+      %w{9 21 foo}.each do |count|
+        GoogleBook.find('foo bar', :count => count)
+        GoogleBook.send(:query).should_not include 'max-results'
+      end
+    end
+
+    it "should set total results" do
+      GoogleBook.find('deleuze')
+      GoogleBook.total_results.should > 0
+    end
+
+    it "should return books" do
+      GoogleBook.find('deleuze').first.should be_an_instance_of GoogleBook
+    end
+  end
+end

data/spec/googlebook_spec.rb

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

data/spec/spec_helper.rb

@@ -0,0 +1,7 @@
+require "rubygems"
+require "bundler/setup"
+require "rspec"
+
+require File.expand_path("../../lib/googlebook", __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.http_stubbing_library    = :webmock
+  c.default_cassette_options = { :record => :new_episodes }
+end
+
+RSpec.configure do |config|
+  config.extend VCR::RSpec::Macros
+end

metadata

@@ -0,0 +1,172 @@
+--- !ruby/object:Gem::Specification 
+name: googlebook
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Hakan Ensari
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-10-26 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 6
+        - 1
+        version: 0.6.1
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rdiscount
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 6
+        - 5
+        version: 1.6.5
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 0
+        - 1
+        version: 2.0.1
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: sdoc-helpers
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 1
+        - 4
+        version: 0.1.4
+  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.
+email: 
+- hakan.ensari@papercavalier.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rspec
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- googlebook.gemspec
+- lib/googlebook.rb
+- lib/googlebook/finder.rb
+- lib/googlebook/version.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
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  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
+signing_key: 
+specification_version: 3
+summary: A Ruby class in tight embrace with the Google Book Search Data API
+test_files: 
+- spec/googlebook/finder_spec.rb
+- spec/googlebook_spec.rb
+- spec/spec_helper.rb
+- spec/support/vcr.rb