bookle 0.0.1

data/lib/bookle/google_books_access_info.rb

@@ -0,0 +1,26 @@
+require 'bookle/google_books_epub'
+require 'bookle/google_books_pdf'
+
+module Google
+	module Books
+		class AccessInfo
+			attr_reader :access_country, :viewability, :embeddable, :public_domain, :text_to_speech_permission, :epub, :pdf, :web_reader_link,
+				:access_view_status
+
+			def initialize(access_info)
+				if access_info
+					@access_country 						= access_info["country"]
+					@viewability 								= access_info["viewability"]
+					@embeddable 								= access_info["embeddable"]
+					@public_domain 							= access_info["publicDomain"]
+					@text_to_speech_permission 	= access_info["textToSpeechPermission"]
+					@epub 											= Google::Books::Epub.new(access_info["epub"])
+					@pdf 												= Google::Books::Pdf.new(access_info["pdf"])
+					@web_reader_link 						= access_info["webReaderLink"]
+					@access_view_status 				= access_info["accessViewStatus"]
+				end
+			end
+
+		end
+	end
+end

data/lib/bookle/google_books_api.rb

@@ -0,0 +1,155 @@
+# OpenSSL::SSL::SSLError: SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed
+# Solution to SSL problem on Windows:
+# https://gist.github.com/867550
+# https://www.googleapis.com/books/v1/volumes?key=AIzaSyAUJ0psGl0udam2kFzT29L2YWAhCF748ik&q=inauthor:keyes&maxResults=40&startIndex=40
+
+require 'net/https'
+require 'bookle/google_books_items'
+
+module Google
+	module Books
+		class API
+
+			GOOGLE_OPTIONAL_PARAMETERS = {
+				'start_index_at'	=> 'startIndex',				# starts at 0 (default)
+				'maximum_results'	=> 'maxResults'					# [0..40], default=10
+			}
+
+			# Prefixed some of the keywords with 'in_' to convey the Google meaning that the value is found *in* the content.
+			# Google differentiates between *in* content and *is* content.
+			GOOGLE_QUERY_KEYWORDS	= {
+				'title'						=> 'intitle',
+				'author'					=> 'inauthor',
+				'publisher'				=> 'inpublisher',
+				'subject'					=> 'subject',						# *in* subject
+				'isbn'						=> 'isbn',							# ISBN
+				'lccn'						=> 'lccn',							# Library of Congress Control Number
+				'oclc'						=> 'oclc'								# Online Computer Library Center number
+			}
+
+			attr_reader :total_volumes, :volumes, :volume, :raw_response
+
+			attr_accessor *(GOOGLE_QUERY_KEYWORDS.keys + GOOGLE_OPTIONAL_PARAMETERS.keys).map{|method_name| method_name.to_sym} << :google_books_api_key
+
+			def initialize(google_books_api_key)
+				@google_books_api_key = google_books_api_key
+				@total_volumes				= 0
+				@volumes 							= []
+			end
+
+			def search_accessors
+				GOOGLE_QUERY_KEYWORDS.keys + GOOGLE_OPTIONAL_PARAMETERS.keys
+			end
+
+			def clear_search_options
+				search_accessors.each do |method_name|
+					__send__ "#{method_name}=".to_sym, nil
+				end
+
+				nil
+			end
+
+			# Build and also let the user query the string.
+			# schema 						= https
+			# host							= www.googleapis.com`
+			# path 							= books/v1/volumes
+			# key marker 				= key
+			# query marker 			= q
+			# keyword separator	= + (used in build_query_options())
+			def uri_string
+				"https://www.googleapis.com/books/v1/volumes?key=#{@google_books_api_key}#{build_optional_parameters}&q=#{build_query_options}"
+			end
+
+			# The Google Books API builds its query using 'OR', not 'AND'. That means that the more keywords used during the search
+			# the wider the range of results.
+			# When search options are passed to this method prior search options set with the set_search_option method will be disregarded.
+			# def search(isbn='9780140196092')
+			def search
+				google_response	= nil
+				uri 						= URI(uri_string)
+				http 						= Net::HTTP.new(uri.host, uri.port)
+				http.use_ssl 		= uri.scheme == 'https'
+				http.ca_file 		= cacert_path
+
+				http.start {http.request_get("#{uri.path}?#{uri.query}") {|response| @raw_response = response.body}}
+
+				items 					= Google::Books::Items.new(@raw_response)
+
+				@total_volumes 	= items.total_items || 0
+				@volumes 				= items.items 			|| []
+				@volume 				= volumes.first
+
+				items
+			end
+
+
+			# cacert = certification authority certificates
+			def update_cacert_file
+				file_path = cacert_path
+
+				Net::HTTP.start("curl.haxx.se") do |http|
+				  resp = http.get("/ca/cacert.pem")
+
+				  if resp.code == "200"
+				  	File.delete("#{file_path}_old") if File.exists?("#{file_path}_old")
+				  	File.rename(file_path, "#{file_path}_old")
+				  	File.open(file_path, "w") {|file| file.write(resp.body)}
+
+				    puts "\n\nAn updated version of the file with the certfication authority certificates has been installed to"
+				    puts "#{cacert_path}\n\n"
+				  else
+				    puts "\n\nUnable to download a new version of the certification authority certificates.\n"
+				  end
+				end
+			rescue => e
+				puts "\n\nErrors were encountered while updating the certification authority certificates file.\n"
+
+				unless File.exists?(file_path)
+					if File.exists?("#{file_path}_old")
+						File.rename("#{file_path}_old", file_path)
+					else
+						puts "\nThe certification authority certificates file could not be found nor restored.\n"
+					end
+				end
+
+				puts "\nError information:\n"
+				puts e.message
+			end
+
+
+			private
+
+				def build_optional_parameters
+					string = ''
+
+					GOOGLE_OPTIONAL_PARAMETERS.each do |method_name, query_parameter|
+						unless __send__(method_name.to_sym).nil?
+							# Need to escape values or search might fail due to spaces, etc.
+							string += "&#{query_parameter}=#{URI.escape(__send__(method_name.to_sym).to_s)}"
+						end
+					end
+
+					string
+				end
+
+				def build_query_options
+					string = ''
+
+					GOOGLE_QUERY_KEYWORDS.each do |method_name, query_keyword|
+						unless __send__(method_name.to_sym).nil?
+							# Need to escape values or search might fail due to spaces, etc.
+							string += "#{query_keyword}:#{URI.escape(__send__(method_name.to_sym).to_s)}+"
+						end
+					end
+
+					# Return string except for last keyword separator.
+					string.chop
+				end
+
+				def cacert_path
+					File.dirname(`gem which bookle`.chomp) + '/cacert/cacert.pem'
+				end
+
+		end
+	end
+end

data/lib/bookle/google_books_epub.rb

@@ -0,0 +1,18 @@
+module Google
+	module Books
+		class Epub
+			attr_reader :is_available
+
+			def initialize(epub)
+				if epub
+					@is_available = epub["isAvailable"]
+				end
+			end
+
+			def to_hash
+				{"is_epub_available" => self.is_available}
+			end
+
+		end
+	end
+end

data/lib/bookle/google_books_image_links.rb

@@ -0,0 +1,15 @@
+module Google
+	module Books
+		class ImageLinks
+			attr_reader :small_thumbnail, :thumbnail
+
+			def initialize(image_links)
+				if image_links
+					@small_thumbnail 	= image_links["smallThumbnail"]
+					@thumbnail 				= image_links["thumbnail"]
+				end
+			end
+
+		end
+	end
+end

data/lib/bookle/google_books_industry_identifier.rb

@@ -0,0 +1,17 @@
+module Google
+	module Books
+		class IndustryIdentifier
+			attr_reader :type, :identifier
+
+			def initialize(identifier)
+				@type 			= identifier["type"]
+				@identifier = identifier["identifier"]
+			end
+
+			def to_hash
+				{self.type.downcase => self.identifier}
+			end
+
+		end
+	end
+end

data/lib/bookle/google_books_item.rb

@@ -0,0 +1,29 @@
+require 'hasherizer'
+require 'bookle/google_books_volume_info'
+require 'bookle/google_books_sale_info'
+require 'bookle/google_books_access_info'
+require 'bookle/google_books_search_info'
+
+module Google
+	module Books
+		class Item
+			attr_reader :kind, :id, :etag, :self_link, :volume_info, :sale_info, :access_info, :search_info
+
+			def initialize(item)
+				@kind 				= item["kind"]
+				@id 					= item["id"]
+				@etag					= item["etag"]
+				@self_link 		= item["selfLink"]
+				@volume_info 	= Google::Books::VolumeInfo.new(item["volumeInfo"])
+				@sale_info 		= Google::Books::SaleInfo.new(item["saleInfo"])
+				@access_info 	= Google::Books::AccessInfo.new(item["accessInfo"])
+				@search_info 	= Google::Books::SearchInfo.new(item["searchInfo"])
+			end
+
+			def hash
+				Hasherizer.to_hash(self)
+			end
+
+		end
+	end
+end

data/lib/bookle/google_books_items.rb

@@ -0,0 +1,23 @@
+require 'json'
+require 'bookle/google_books_item'
+
+module Google
+	module Books
+		class Items
+			attr_reader :kind, :total_items, :items
+
+			def initialize(google_response)
+				books_info 	= JSON.parse(google_response)
+
+				@kind 				= books_info["kind"]
+				@total_items 	= books_info["totalItems"] || 0
+
+				if books_info["items"]
+					@items = books_info["items"].collect {|item| Google::Books::Item.new(item)}
+				else
+					@items = []
+				end
+			end
+		end
+	end
+end

data/lib/bookle/google_books_list_price.rb

@@ -0,0 +1,13 @@
+require 'bookle/google_books_price'
+
+module Google
+	module Books
+		class ListPrice < Google::Books::Price
+
+			def to_hash
+				{"list_price_amount" => self.amount, "list_price_currency_code" => self.currency_code}
+			end
+
+		end
+	end
+end

data/lib/bookle/google_books_pdf.rb

@@ -0,0 +1,18 @@
+module Google
+	module Books
+		class Pdf
+			attr_reader :is_available
+
+			def initialize(pdf)
+				if pdf
+					@is_available = pdf["isAvailable"]
+				end
+			end
+
+			def to_hash
+				{"is_pdf_available" => self.is_available}
+			end
+
+		end
+	end
+end

data/lib/bookle/google_books_price.rb

@@ -0,0 +1,15 @@
+module Google
+	module Books
+		class Price
+			attr_reader :amount, :currency_code
+
+			def initialize(price)
+				if price
+					@amount					= price["amount"]
+					@currency_code	= price["currencyCode"]
+				end
+			end
+
+		end
+	end
+end

data/lib/bookle/google_books_retail_price.rb

@@ -0,0 +1,13 @@
+require 'bookle/google_books_price'
+
+module Google
+	module Books
+		class RetailPrice < Google::Books::Price
+
+			def to_hash
+				{"retail_price_amount" => self.amount, "retail_price_currency_code" => self.currency_code}
+			end
+
+		end
+	end
+end

data/lib/bookle/google_books_sale_info.rb

@@ -0,0 +1,22 @@
+require 'bookle/google_books_list_price'
+require 'bookle/google_books_retail_price'
+
+module Google
+	module Books
+		class SaleInfo
+		  attr_reader :sale_country, :saleability, :is_ebook, :list_price, :retail_price, :buy_link
+
+		  def initialize(sale_info)
+		  	if sale_info
+			    @sale_country = sale_info["country"]
+			    @saleability  = sale_info["saleability"]
+			    @is_ebook 		= sale_info["isEbook"]
+			    @list_price		= Google::Books::ListPrice.new(sale_info["listPrice"])
+			    @retail_price = Google::Books::RetailPrice.new(sale_info["retailPrice"])
+			    @buy_link			= sale_info["buyLink"]
+			  end
+		  end
+
+		end
+	end
+end

data/lib/bookle/google_books_search_info.rb

@@ -0,0 +1,13 @@
+module Google
+	module Books
+		class SearchInfo
+			attr_reader :text_snippet
+
+			def initialize(search_info)
+				if search_info
+					@text_snippet = search_info["textSnippet"]
+				end
+			end
+		end
+	end
+end

data/lib/bookle/google_books_volume_info.rb

@@ -0,0 +1,38 @@
+require 'bookle/google_books_industry_identifier'
+require 'bookle/google_books_image_links'
+
+module Google
+	module Books
+		class VolumeInfo
+			attr_reader :title, :subtitle, :authors, :publisher, :published_date, :description, :industry_identifiers, :page_count,
+				:print_type, :categories, :average_rating, :ratings_count, :content_version, :image_links, :language, :preview_link,
+				:info_link, :canonical_volume_link
+
+			def initialize(volume_info)
+				if volume_info
+					@title 									= volume_info["title"]
+					@subtitle 							= volume_info["subtitle"]
+					@authors  							= volume_info["authors"]
+					@publisher 							= volume_info["publisher"]
+					@published_date 				= volume_info["published_date"]
+					@description 						= volume_info["description"]
+					@industry_identifiers 	= volume_info["industryIdentifiers"].collect do
+																			|i| Google::Books::IndustryIdentifier.new(i)
+																		end if volume_info["industryIdentifiers"]
+					@page_count 						= volume_info["pageCount"]
+					@print_type 						= volume_info["printType"]
+					@categories 						= volume_info["categories"]
+					@average_rating 				= volume_info["averageRating"]
+					@ratings_count 					= volume_info["ratingsCount"]
+					@content_version 				= volume_info["contentVersion"]
+					@image_links 						= Google::Books::ImageLinks.new(volume_info["imageLinks"])
+					@language 							= volume_info["language"]
+					@preview_link 					= volume_info["previewLink"]
+					@info_link 							= volume_info["infoLink"]
+					@canonical_volume_link 	= volume_info["canonicalVolumeLink"]
+				end
+			end
+
+		end
+	end
+end

data/lib/bookle.rb

@@ -0,0 +1,8 @@
+require 'bookle/google_books_api'
+
+class Bookle
+	# def self.api(google_books_api_key=nil)
+	def self.api(google_books_api_key='AIzaSyAUJ0psGl0udam2kFzT29L2YWAhCF748ik')
+		Google::Books::API.new(google_books_api_key)
+	end
+end