openlibrary 0.0.4

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+.rvmrc

data/Gemfile

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

data/README.rdoc

@@ -0,0 +1,62 @@
+== Openlibrary 
+
+
+OPENLIBRARY is a simple wrapper for the Openlibrary REST-API.
+
+For more information on the REST calls, you can view the api docuemtation at [http://openlibrary.org/developers/api].
+
+
+== Installation
+
+The gem is tested against Ruby 1.9.2 and runs smoothly with Rails 3.
+
+  gem install openlibrary 
+
+or in your Gemfile:
+
+  gem 'openlibrary'
+
+
+== Usage
+
+You can retrieve a book's Openlibrary listing information.
+
+  # just require
+  require 'openlibrary'
+
+Initiate your search 
+
+  # create a class proxy 
+  view = Openlibrary::View
+  
+  # lookup an item with the ISBN-10 or ISBN-13 
+  book_view = view.find_by_isbn("0451526538")
+
+or you can use the other built-in finder methods:
+
+  find_by_lccn        # Library of congress catalog number
+  find_by_oclc        # Worldcat Control Number
+  find_by_olid        # Openlibrary ID
+
+Extract the book information:
+  
+  # have a look at the book's info URL on Openlibrary.org
+  book_view.info_url
+
+  # or grab the URL of the book's thumbnail as shown on Openlibrary.org
+  book_view.thumbnail_url
+
+You can also retrieve a book's full metadata details.
+  
+  # create a class proxy 
+  details = Openlibrary::Data
+  
+  # lookup an item with the ISBN-10 or ISBN-13 
+  book_details = details.find_by_isbn("0451526538")
+  
+  # have a look at the book's title
+  book_details.title
+
+  # or an array of authors 
+  book_view.authors
+

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/openlibrary.rb

@@ -0,0 +1,10 @@
+require "openlibrary/version"
+require 'json'
+require 'rest-client'
+
+module Openlibrary
+
+  autoload :Data, 'openlibrary/data'
+  autoload :View, 'openlibrary/view'
+
+end

data/lib/openlibrary/data.rb

@@ -0,0 +1,75 @@
+module Openlibrary
+
+  class Data 
+    attr_accessor :url
+    attr_accessor :title
+    attr_accessor :subtitle
+    attr_accessor :authors
+    attr_accessor :identifiers
+    attr_accessor :classifications
+    attr_accessor :subjects, :subject_places, :subject_people, :subject_times
+    attr_accessor :publishers, :publish_places
+    attr_accessor :date_published
+    attr_accessor :excerpts
+    attr_accessor :links
+    attr_accessor :cover
+    attr_accessor :ebooks
+    attr_accessor :pages
+    attr_accessor :weight
+
+    def self.find_by_isbn(key)
+      find("ISBN",key)
+    end
+
+    def self.find_by_lccn(key)
+      find("LCCN",key)
+    end
+
+    def self.find_by_oclc(key)
+      find("OCLC",key)
+    end
+
+    def self.find_by_olid(key)
+      find("OLID",key)
+    end
+
+    def self.find(type,key)
+      request_url = "http://openlibrary.org/api/books?bibkeys=#{type}:#{key}&format=json&jscmd=data"
+      response = RestClient.get request_url
+      response_data = JSON.parse(response)
+      book = response_data["#{type}:#{key}"]
+      if book 
+        book_meta = new  
+
+        book_meta.title = book["title"] 
+        book_meta.subtitle = book["subtitle"]
+        book_meta.authors = book["authors"]
+        book_meta.identifiers = book["identifiers"]
+        book_meta.classifications = book["classifications"]
+        book_meta.subjects = book["subjects"]
+        book_meta.subject_places = book["subject_places"]
+        book_meta.subject_people = book["subject_people"]
+        book_meta.publishers = book["publishers"]
+        book_meta.publish_places = book["publish_places"]
+        book_meta.date_published = book["date_published"]
+        book_meta.excerpts = book["excerpts"]
+        book_meta.links = book["links"]
+        book_meta.cover = book["cover"]
+        book_meta.ebooks = book["ebooks"]
+        book_meta.pages = book["pages"]
+        book_meta.weight = book["weight"]
+        
+        #for debugging purposes
+        #puts book_meta
+
+        book_meta
+      else
+        puts "OPENLIBRARY: Using #{type} with #{key}, not found on Openlibrary.org"
+        nil
+      end    
+    end
+  end
+
+
+end
+

data/lib/openlibrary/version.rb

@@ -0,0 +1,3 @@
+module Openlibrary
+  VERSION = "0.0.4"
+end

data/lib/openlibrary/view.rb

@@ -0,0 +1,53 @@
+module Openlibrary
+
+  class View 
+    attr_accessor :bib_key
+    attr_accessor :info_url
+    attr_accessor :preview
+    attr_accessor :preview_url
+    attr_accessor :thumbnail_url
+
+    def self.find_by_isbn(key)
+      find("ISBN",key)
+    end
+
+    def self.find_by_lccn(key)
+      find("LCCN",key)
+    end
+
+    def self.find_by_oclc(key)
+      find("OCLC",key)
+    end
+
+    def self.find_by_olid(key)
+      find("OLID",key)
+    end
+
+    def self.find(key)
+      response = RestClient.get "http://openlibrary.org/api/books?bibkeys=ISBN:#{key}&format=json&jscmd=viewapi"
+
+      response_data = JSON.parse(response)
+      view = response_data["#{type}:#{key}"]
+      if view 
+        view_meta = new  
+
+        view_meta.bib_key = view["bib_key"] 
+        view_meta.info_url = view["info_url"]
+        view_meta.preview = view["preview"]
+        view_meta.preview_url = view["preview_url"]
+        view_meta.thumbnail_url = view["thumbnail_url"]
+        
+        #for debugging purposes
+        #puts view_meta
+
+        view_meta
+      else
+        puts "OPENLIBRARY: #{key} was not found on Openlibrary.org"
+        nil
+      end    
+    end
+  end
+
+
+end
+

data/openlibrary.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "openlibrary/version"
+
+Gem::Specification.new do |s|
+  s.name        = "openlibrary"
+  s.version     = Openlibrary::VERSION
+  s.authors     = ["Jay Fajardo"]
+  s.email       = ["jmrfajardo@gmail.com"]
+  s.homepage    = "http://www.proudcloud.net"
+  s.summary     = %q{Ruby Interface for the OpenLibrary API}
+  s.description = %q{OpenLibrary API Interface}
+
+  s.rubyforge_project = "openlibrary"
+
+  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"]
+
+  # specify any dependencies here; for example:
+  s.add_development_dependency "rspec"
+  s.add_runtime_dependency "json"
+  s.add_runtime_dependency "rest-client"
+end

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification 
+name: openlibrary
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.4
+platform: ruby
+authors: 
+- Jay Fajardo
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-09-03 00:00:00 +08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: json
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rest-client
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id003
+description: OpenLibrary API Interface
+email: 
+- jmrfajardo@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README.rdoc
+- Rakefile
+- lib/openlibrary.rb
+- lib/openlibrary/data.rb
+- lib/openlibrary/details.rb
+- lib/openlibrary/version.rb
+- lib/openlibrary/view.rb
+- openlibrary.gemspec
+has_rdoc: true
+homepage: http://www.proudcloud.net
+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: openlibrary
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Ruby Interface for the OpenLibrary API
+test_files: []
+