book_worm 0.0.2

data/.gitignore

@@ -0,0 +1,4 @@
+tmp
+pkg
+.bundle
+

data/.rspec

@@ -0,0 +1,2 @@
+--colour
+--format=documentation

data/.rvmrc

@@ -0,0 +1,2 @@
+rvm use --create ruby-1.9.2@book_worm
+

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+#use this, specify dependencies in gmespec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,28 @@
+PATH
+  remote: .
+  specs:
+    book_worm (0.0.1)
+      httparty
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    crack (0.1.8)
+    diff-lcs (1.1.2)
+    httparty (0.6.1)
+      crack (= 0.1.8)
+    rspec (2.0.0.beta.20)
+      rspec-core (= 2.0.0.beta.20)
+      rspec-expectations (= 2.0.0.beta.20)
+      rspec-mocks (= 2.0.0.beta.20)
+    rspec-core (2.0.0.beta.20)
+    rspec-expectations (2.0.0.beta.20)
+      diff-lcs (>= 1.1.2)
+    rspec-mocks (2.0.0.beta.20)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  book_worm!
+  rspec

data/Rakefile

@@ -0,0 +1,4 @@
+require 'bundler'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+Bundler::GemHelper.install_tasks

data/book_worm.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "book_worm/version"
+
+Gem::Specification.new do |s|
+  s.name        = "book_worm"
+  s.version     = BookWorm::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Tony Schneider"]
+  s.email       = ["tonywok@gmail.com"]
+  s.homepage    = ""
+  s.summary     = %q{A simple gem for interacting with ISBNDB.com}
+  s.description = %q{A simple gem for interacting with ISBNDB.com}
+
+  s.rubyforge_project = "book_worm"
+
+  s.add_runtime_dependency "httparty"
+  s.add_development_dependency "rspec"
+
+  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/book_worm/book.rb

@@ -0,0 +1,18 @@
+module BookWorm
+  class Book
+
+    attr_accessor :publisher, :authors, :isbn,
+                  :isbn13, :title, :long_title,
+                  :book_id
+
+    def initialize(book_data)
+      self.long_title = book_data["TitleLong"]
+      self.publisher  = book_data["PublisherText"]
+      self.authors    = book_data["AuthorsText"]
+      self.isbn       = book_data["isbn"]
+      self.isbn13     = book_data["isbn13"]
+      self.title      = book_data["Title"]
+      self.book_id    = book_data["book_id"]
+    end
+  end
+end

data/lib/book_worm/configuration.rb

@@ -0,0 +1,6 @@
+module BookWorm
+  class Configuration
+    # supply your ISBNDB.com API key here
+    API_KEY = ''
+  end
+end

data/lib/book_worm/searchable.rb

@@ -0,0 +1,70 @@
+module BookWorm
+  require 'book_worm/configuration'
+  require 'book_worm/book'
+  require 'httparty'
+
+  include HTTParty
+  format :xml
+  base_uri 'http://isbndb.com'
+
+  module Searchable
+
+    INDICES = [:isbn, :title, :combined, :full]
+
+    INDICES.each do |index|
+      index_name = (index.to_s =~ /full|combined/ ? "#{index}_index" : index)
+
+      define_method "find_by_#{index_name}" do |arg|
+        find(index, arg)
+      end
+
+      define_method "find_all_by_#{index_name}" do |arg|
+        find_all(index, arg)
+      end
+    end
+
+    def find(*args)
+      if args.size == 1
+        index = :isbn
+        value = args[0]
+      else
+        index = INDICES.include?(args[0]) ? args[0] : :isbn
+        value = args[1]
+      end
+      normalize(query_isbndb(index, value))[0]
+    end
+
+    def find_all(*args)
+      if args.size == 1
+        index = :full
+        value = args[0]
+      else
+        index = INDICES.include?(args[0]) ? args[0] : :full
+        value = args[1]
+      end
+      normalize(query_isbndb(index, value))
+    end
+
+    private
+
+    def query_base
+      "/api/books.xml"
+    end
+
+    def query_isbndb(index, value)
+      get(query_base, :query => { :index1 => index,
+                                  :value1 => value,
+                                  :access_key => Configuration::API_KEY, })
+    end
+
+    def normalize(results)
+      begin
+        [results['ISBNdb']['BookList']['BookData']].flatten.collect do |book|
+          Book.new(book)
+        end
+      rescue
+        []
+      end
+    end
+  end
+end

data/lib/book_worm/version.rb

@@ -0,0 +1,3 @@
+module BookWorm
+  VERSION = "0.0.2"
+end

data/lib/book_worm.rb

@@ -0,0 +1,4 @@
+module BookWorm
+  require 'book_worm/searchable'
+  extend Searchable
+end

data/spec/book_spec.rb

@@ -0,0 +1,229 @@
+require 'spec_helper'
+require 'book_worm'
+
+describe BookWorm do
+  describe '#find' do
+    context 'when a search results in no matches' do
+      it 'returns nil' do
+        BookWorm.find(:isbn, 'Jiveturkey').should be_nil
+      end
+    end
+
+    context 'when finding without a specified index' do
+      it 'defaults to an isbn index' do
+        BookWorm.find('1934356085').isbn.should == '1934356085'
+      end
+    end
+
+    context 'when finding with a non-supported index' do
+      it 'defaults to an isbn index' do
+        BookWorm.should_receive(:query_isbndb).with(:isbn, '1934356085')
+        BookWorm.find(:jiveturkey, '1934356085')
+      end
+    end
+
+    before :each do
+     @book_data = { :isbn       => "1934356085",
+                    :isbn13     => "9781934356081",
+                    :book_id    => "programming_ruby_1_9",
+                    :publisher  => "Pragmatic Bookshelf",
+                    :title      => 'Programming Ruby 1.9',
+                    :long_title => "Programming Ruby 1.9: The Pragmatic Programmers' Guide",
+                    :authors    => "Dave Thomas, Chad Fowler, Andy Hunt, " }
+    end
+
+    context 'when querying for a book by isbn' do
+      it 'indexes by isbn.' do
+        result = BookWorm.find(:isbn, @book_data[:isbn])
+        @book_data.each do |key,val|
+          result.send(key).should == val
+        end
+      end
+
+      it 'indexes by isbn13.' do
+        result = BookWorm.find(:isbn, @book_data[:isbn13])
+        @book_data.each do |key,val|
+          result.send(key).should == val
+        end
+      end
+
+      context 'when using #find_book hepers' do
+        it 'indexes by isbn more easily.' do
+          result = BookWorm.find_by_isbn(@book_data[:isbn])
+          @book_data.each do |key,val|
+            result.send(key).should == val
+          end
+        end
+
+        it 'indexes by isbn13 more conveniently.' do
+          result = BookWorm.find_by_isbn(@book_data[:isbn13])
+          @book_data.each do |key,val|
+            result.send(key).should == val
+          end
+        end
+      end
+
+      context 'when querying for a book by title' do
+        it 'indexes books by title' do
+          result = BookWorm.find(:title, @book_data[:title])
+          @book_data.each do |key,val|
+            result.send(key).should == val
+          end
+        end
+
+        context 'when using #find_book helpers' do
+          it 'indexes by title more conveniently.' do
+            result = BookWorm.find_by_title(@book_data[:title])
+            @book_data.each do |key,val|
+              result.send(key).should == val
+            end
+          end
+        end
+      end
+
+      context 'when querying for a book by combined index' do
+        before :each do
+          @combined_index = "#{@book_data[:title]} #{@book_data[:publisher]} #{@book_data[:authors]}"
+        end
+
+        it 'indexes using several combined fields' do
+          @combined_index = "#{@book_data[:title]} #{@book_data[:publisher]} #{@book_data[:authors]}"
+          result = BookWorm.find(:combined, @combined_index)
+          @book_data.each do |key,val|
+            result.send(key).should == val
+          end
+        end
+
+        context 'when querying for a book by combined index' do
+          it 'uses combined index more conveniently.' do
+            result = BookWorm.find_by_combined_index(@combined_index)
+            @book_data.each do |key,val|
+              result.send(key).should == val
+            end
+          end
+        end
+      end
+
+      context 'when querying for a book by full index' do
+        before :each do
+          @summary = "making Ruby a favorite tool of intelligent, forward-thinking programmers"
+        end
+
+        it 'indexes using several full fields' do
+          result = BookWorm.find(:full, @summary)
+          @book_data.each do |key,val|
+            result.send(key).should == val
+          end
+        end
+
+        context 'when querying for a book by full index' do
+          it 'uses full index more conveniently.' do
+            result = BookWorm.find_by_full_index(@summary)
+            @book_data.each do |key,val|
+              result.send(key).should == val
+            end
+          end
+        end
+      end
+    end
+  end # end find
+
+  describe '#find_all' do
+    context 'when querying for a collection of books' do
+      it 'returns an empty array when no results are found' do
+        BookWorm.find_all(:isbn, 'Jiveturkey').should be_empty
+      end
+    end
+
+    context 'when finding without a specified index' do
+      it 'defaults to full index' do
+        BookWorm.should_receive(:query_isbndb).with(:full, "foobarbaz")
+        BookWorm.find_all('foobarbaz')
+      end
+    end
+
+    context 'when finding with a non-supported index' do
+      it 'defaults to a full index' do
+        BookWorm.should_receive(:query_isbndb).with(:full, '1934356085')
+        BookWorm.find_all(:jiveturkey, '1934356085')
+      end
+    end
+
+    context 'when querying for a collection of books by isbn' do
+      it 'indexes by isbn' do
+        BookWorm.find_all(:isbn, '1934356085').each do |book|
+          book.isbn.should == '1934356085'
+        end
+      end
+
+      it 'indexes by isbn13' do
+        BookWorm.find_all(:isbn, '9781934356081').each do |book|
+          book.isbn13.should == '9781934356081'
+        end
+      end
+
+      context 'when using #find_all convenience helpers' do
+        it 'conveniently indexes by isbn' do
+          BookWorm.find_all_by_isbn('1934356085').each do |book|
+            book.isbn.should == '1934356085'
+          end
+        end
+
+        it 'conveniently indexes by isbn13' do
+          BookWorm.find_all_by_isbn('9781934356081').each do |book|
+            book.isbn13.should == '9781934356081'
+          end
+        end
+      end
+    end
+
+    context 'when querying for a collection of books by title' do
+      it 'has results that contain the title argument' do
+        BookWorm.find_all(:title, 'Ruby Rails').each do |book|
+          book.title.should =~ /ruby|rails/i
+        end
+      end
+
+      context 'when using #find_books helpers' do
+        it 'has results that contain the title argument' do
+          BookWorm.find_all_by_title('Ruby Rails').each do |book|
+            book.title.should =~ /ruby|rails/i
+          end
+        end
+      end
+    end
+
+    context 'when querying for a collection of books by a combined index' do
+      it 'has results that contain the arguments' do
+        BookWorm.find_all(:combined, 'Ruby Rails').each do |book|
+          book.title.should =~ /ruby|rails/i
+        end
+      end
+
+      context 'when using #find_books helpers' do
+        it 'has results that contain the arguments' do
+          BookWorm.find_all_by_combined_index('Ruby Hansson Pragmatic Rails').each do |book|
+            title     = book.title     =~ /ruby|rails/i
+            author    = book.authors   =~ /hansson/i
+            publisher = book.publisher =~ /pragmatic/i
+            (title || author || publisher).should be_true
+          end
+        end
+      end
+    end
+
+    context 'when querying for a collection of books by a full index' do
+      it 'has results that match the full index' do
+        books = BookWorm.find_all(:full, 'Ruby Rails Pragmatic Programming')
+        books.collect{ |book| book.title }.join('_').should =~ /ruby|rails/i
+      end
+
+      context 'when using #find_books helpers' do
+        it 'has results that contain the arguments for full index search' do
+          books = BookWorm.find_all_by_full_index('Ruby Rails Pragmatic Programming')
+          books.collect{ |book| book.title }.join('_').should =~ /ruby|rails/i
+        end
+      end
+    end
+  end #end find_all
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require 'rspec'

metadata

@@ -0,0 +1,104 @@
+--- !ruby/object:Gem::Specification 
+name: book_worm
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 2
+  version: 0.0.2
+platform: ruby
+authors: 
+- Tony Schneider
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-02-12 00:00:00 -05: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
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+description: A simple gem for interacting with ISBNDB.com
+email: 
+- tonywok@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rspec
+- .rvmrc
+- Gemfile
+- Gemfile.lock
+- Rakefile
+- book_worm.gemspec
+- lib/book_worm.rb
+- lib/book_worm/book.rb
+- lib/book_worm/configuration.rb
+- lib/book_worm/searchable.rb
+- lib/book_worm/version.rb
+- spec/book_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: ""
+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: book_worm
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: A simple gem for interacting with ISBNDB.com
+test_files: 
+- spec/book_spec.rb
+- spec/spec_helper.rb