gisbn 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 513f21bca505a34739c299586d3d6f387f7c5b42
+  data.tar.gz: 6213468089ada8589e382e00ad962eb3e73aa6f7
+SHA512:
+  metadata.gz: c9672931fc8b09dc9eb391838a27be30f02e4095766d7fcf184389ecf84f6d3f77c8f37bde47537972fc9e94c071b1abb16b040b2621b5ab1f99da865ac9d54d
+  data.tar.gz: 70884f43bde477cb0dd8f4c784310cae57020fc87f1e3fcaf61ffa370bcd1f5481647d64a40b3a00bd856bb8e41e3c2a74df2151cd28b633349d69ce3d499423

data/.gitignore

@@ -0,0 +1,24 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+.idea
+.rvmrc

data/.travis.yml

@@ -0,0 +1,15 @@
+language: ruby
+cache: bundler
+
+rvm:
+  - jruby
+  - 2.0.0
+
+script: 'bundle exec rake'
+
+notifications:
+  email:
+    recipients:
+      - eftakhairul@gmail.com
+    on_failure: change
+    on_success: never

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Eftakhairul Islam
+
+MIT License
+
+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,106 @@
+# gisbn
+
+It fetches book's information by ISBN number based on Google Book API.
+
+  - Easy to get all information by ISBN
+  - Structure data
+
+You don't have to call manually Google API with ISBN number. This gem will do everything for you.
+
+
+
+### Version
+0.0.1
+
+
+### Installation
+
+You need Gulp installed globally:
+
+```sh
+gem install gisbn
+```
+Or, if you're using this in a project with Bundler:
+
+```sh
+gem 'gisbn'
+```
+
+## Examples
+    book = Gisbn::Book.new "0262033844"
+
+    book.title
+    #=> "Introduction to Algorithms"
+
+    book.description
+    #=> "A new edition of the essential text and professional reference, with substantial newmaterial on such topics as vEB trees, multithreaded algorithms, dynamic programming, and edge-baseflow."
+
+    book.publisher
+    #=> "MIT Press"
+
+    book.published_date
+    #=> <Date: 2001-02-03 ...>
+
+    book.isbn_10
+    #=> 0262033844
+
+    book.isbn_13
+    #=> 9780262033848
+
+    book.thumbnail
+    #=> http://books.google.com/books/content?id=i-bUBQAAQBAJ&printsec=frontcover&img=1&zoom=1&edge=curl&source=gbs_api
+
+    book.preview
+    #=> http://books.google.ca/books?id=i-bUBQAAQBAJ&printsec=frontcover&dq=isbn:0262033844&hl=&cd=1&source=gbs_api
+
+
+    book.gisbn.isbn = 9780321573513
+    book.fetch.title  => "Algorithms"
+
+
+
+## Methods
+    title                >> Returns Book's title as string
+    description          >> Returns the description of book as string
+    isbn(isbn_number)    >> Set new isbn
+    fetch                >> Call to Google Book API and process book information on provided ISBN
+    authors              >> Return authors' name as comma separated as string
+    authors_as_array     >> Return authors' name as ruby array. If no book is associated with ISBN number,
+                            then it return empty array
+    publisher            >> Return publisher name as string
+    isbn_10              >> Return 10 digit ISBN numbers as string
+    isbn_13              >> Return 13 digit ISBN numbers as string
+    categories           >> Return category names as comma separated as string
+    categories_as_array  >> Return category names as ruby array. If no book is associated with ISBN number,
+                            then it return empty array
+    thumbnail_small      >> Return the link of small thumnail
+    thumbnail            >> Return the link of standard thumnail
+    preview_link         >> Return the link for previewing the book
+    page_count           >> Return page count as integer
+    published_date       >> Return the published date as Ruby object
+
+
+### Development
+
+Want to contribute? Great!
+
+1. Fork it ( https://github.com/eftakhairul/gisbn/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request
+
+
+Author
+-----------
+[Eftakhairul Islam] - eftakhairul [at] gmail [dot] com
+[Eftakhairul Islam]:http://eftakhairul.com/
+
+
+License
+----
+MIT
+
+
+
+

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+Dir.glob('tasks/**/*.rake').each(&method(:import))

data/gisbn.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'gisbn/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "gisbn"
+  spec.version       = Gisbn::VERSION
+  spec.authors       = ["Eftakhairul Islam"]
+  spec.email         = ["eftakhairul@gmail.com"]
+  spec.summary       = %q{Book information from ISBN by Google Book API.}
+  spec.description   = %q{It fetches book's information by ISBN number based on Google Book API.}
+  spec.homepage      = "https://github.com/eftakhairul/gisbn"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake"
+
+  ##dependency for testing automation
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "rspec-nc"
+end

data/lib/gisbn.rb

@@ -0,0 +1,284 @@
+#require all files
+require "gisbn/version"
+require 'rubygems'
+require 'net/http'
+require 'json'
+
+
+module Gisbn
+
+  class Book
+
+    attr_reader :result, :isbn
+
+    private
+    attr_accessor :key, :country
+
+    BASE_URL = 'https://www.googleapis.com/books/v1/volumes?q=isbn:'
+
+    public
+    # Initialize a new Book object by ISBN (either ten or thirteen digits ISBN number)
+    #
+    # At Interactive Ruby Shell...
+    # require 'gisbn'
+    # book = Gisbn::Book.new "0262033844"
+    #
+    # book.title #=> "Introduction to Algorithms"
+    #
+    def initialize(isbn     = nil,
+                   key      = 'AIzaSyDKepjfaVBRcgsnPALw5s2UNyfOk-1FHUU',
+                   country  = 'ca')
+
+
+      @isbn     = isbn.strip! || isbn
+      @key      = key
+      @country  = country
+
+      fetch
+    end
+
+
+    # Fetch book info from Google API
+    #
+    # Example:
+    #   >> gisbn.fetch
+    #   => #<Gisbn::Book:0x007fc08525e688 @isbn="0262033844", @result={"kind"=>"books#volumes", "totalItems"=>1, "items"=>[{"kind"=>"books#volume",
+    #   "id"=>"i-bUBQAAQBAJ", "etag"=>"a0y8TyrBWu0", "selfLink"=>"https://www.googleapis.com/books/v1/volumes/i-bUBQAAQBAJ",
+    #   "volumeInfo"=>{"title"=>"Introduction to Algorithms", "authors"=>["Thomas H. Cormen"], "publisher"=>"MIT Press", "publishedDate"=>"2009-07-31",
+    #   "description"=>"A new edition of the essential text and professional reference, with substantial newmaterial on such topics as vEB trees,
+    #   multithreaded algorithms, dynamic programming, and edge-baseflow.", "industryIdentifiers"=>[{"type"=>"ISBN_13", "identifier"=>"9780262033848"},
+    #   {"type"=>"ISBN_10", "identifier"=>"0262033844"}], "readingModes"=>{"text"=>false, "image"=>true}, "pageCount"=>1292, "printType"=>"BOOK",
+    #   "categories"=>["Computers"], "averageRating"=>4.0, "ratingsCount"=>16, "contentVersion"=>"preview-1.0.0",
+    #   "imageLinks"=>{"smallThumbnail"=>"http://books.google.com/books/content?id=i-bUBQAAQBAJ&printsec=frontcover&img=1&zoom=5&edge=curl&source=gbs_api",
+    #   "thumbnail"=>"http://books.google.com/books/content?id=i-bUBQAAQBAJ&printsec=frontcover&img=1&zoom=1&edge=curl&source=gbs_api"}, "language"=>"en",
+    #   "previewLink"=>"http://books.google.ca/books?id=i-bUBQAAQBAJ&printsec=frontcover&dq=isbn:0262033844&hl=&cd=1&source=gbs_api",
+    #   "infoLink"=>"http://books.google.ca/books?id=i-bUBQAAQBAJ&dq=isbn:0262033844&hl=&source=gbs_api", "canonicalVolumeLink"=>"http://books.google.ca/books/about/Introduction_to_Algorithms.html?hl=&id=i-bUBQAAQBAJ"},
+    #   "saleInfo"=>{"country"=>"CA", "saleability"=>"NOT_FOR_SALE", "isEbook"=>false}, "accessInfo"=>{"country"=>"CA", "viewability"=>"PARTIAL",
+    #   "embeddable"=>true, "publicDomain"=>false, "textToSpeechPermission"=>"ALLOWED", "epub"=>{"isAvailable"=>false}, "pdf"=>{"isAvailable"=>false},
+    #   "webReaderLink"=>"http://books.google.ca/books/reader?id=i-bUBQAAQBAJ&hl=&printsec=frontcover&output=reader&source=gbs_api",
+    #   "accessViewStatus"=>"SAMPLE", "quoteSharingAllowed"=>false}, "searchInfo"=>{"textSnippet"=>"A new edition of the essential text
+    #   and professional reference, with substantial newmaterial on such topics as vEB trees, multithreaded algorithms, dynamic programming, and
+    #   edge-baseflow."}}]}
+    #
+    # Return
+    #     JSON
+    def fetch
+      response  = Net::HTTP.get_response(URI.parse(BASE_URL + "#{@isbn}&key=#{@key}&country=#{@country}")).body
+      @result   = JSON.parse(response)
+      @result   = nil if @result["totalItems"] == 0
+    end
+
+    # Set ISBN for new request
+    #
+    # Example:
+    #   >> gisbn.isbn = 0262033844
+    #
+    # Return
+    #     Gisbn
+    def isbn(isbn)
+      isbn.strip! || isbn
+    end
+
+    # Description of the book
+    #
+    # Example:
+    #   >> gisbn.description
+    #   => "A new edition of the essential text and professional reference, with substantial newmaterial on such topics as vEB trees,
+    #       multithreaded algorithms, dynamic programming, and edge-baseflow."
+    #
+    # Return:
+    #     String
+    def description
+      return nil if @result.nil?
+      @result["items"][0]["description"]
+    end
+
+    # Title of the book
+    # Example:
+    #   >> gisbn.title
+    #   => "Introduction to Algorithms"
+    #
+    # Return:
+    #     String
+    def title
+      return nil if @result.nil?
+      @result["items"][0]["volumeInfo"]["title"]
+    end
+
+    # It returns all authors' name as comma separated string
+    #
+    # Example:
+    #   >> gisbn.authors
+    #   => "harles E. Leiserson, Clifford Stein, Ronald Rivest,Thomas H. Cormen"
+    #
+    # Return:
+    #     String
+    def authors
+      return nil if @result.nil?
+      @result["items"][0]["volumeInfo"]["authors"].join(", ")
+    end
+
+    # It returns all authors' name as array
+    #
+    # Example:
+    #   >> gisbn.authors_as_array
+    #   => ["harles E. Leiserson", "Clifford Stein", "Ronald Rivest", "Thomas H. Cormen"]
+    #
+    # Return:
+    #     array
+    def authors_as_array
+      return Array.new if @result.nil?
+      @result["items"][0]["volumeInfo"]["authors"]
+    end
+
+    # It returns publisher name
+    #
+    # Example:
+    #   >> gisbn.publisher
+    #   => "MIT Press"
+    #
+    # Return:
+    #     String
+    def publisher
+      return nil if @result.nil?
+      @result["items"][0]["volumeInfo"]["publisher"]
+    end
+
+
+    # It returns the ten digit ISBN number of book
+    #
+    # Example:
+    #   >> gisbn.isbn_10
+    #   => "0262033844"
+    #
+    # Return:
+    #     the ten digit numbers
+    def isbn_10
+      return nil if @result.nil?
+
+      isbn_array = @result["items"][0]["volumeInfo"]["industryIdentifiers"]
+
+      isbn_array.each do |isbn|
+        if isbn["type"] == "ISBN_13"
+          return isbn["identifier"]
+        end
+      end
+    end
+
+
+    # It returns the thirteen digit ISBN number of book
+    #
+    # Example:
+    #   >> gisbn.isbn_13
+    #   => "9780262033848"
+    #
+    # Return:
+    #     the thirteen digit number
+    def isbn_13
+      return nil if @result.nil?
+
+      isbn_array = @result["items"][0]["volumeInfo"]["industryIdentifiers"]
+
+      isbn_array.each do |isbn|
+        if isbn["type"] == "ISBN_13"
+          return isbn["identifier"]
+        end
+      end
+    end
+
+    # It returns categories of book
+    #
+    # Example:
+    #   >> gisbn.categories
+    #   => "Computers"
+    #
+    # Return:
+    #     String
+    def categories
+      return nil if @result.nil?
+      @result["items"][0]["volumeInfo"]["categories"].join(", ")
+    end
+
+
+    # It returns categories of book as array
+    #
+    # Example:
+    #   >> gisbn.categories
+    #   => ["Computers"]
+    #
+    # Return:
+    #     array
+    def categories_as_array
+      return Array.new if @result.nil?
+      @result["items"][0]["volumeInfo"]["categories"]
+    end
+
+
+    # It returns the link of small size thumbnail of book
+    #
+    # Example:
+    #   >> gisbn.small_thumbnail
+    #   => "http://books.google.com/books/content?id=i-bUBQAAQBAJ&printsec=frontcover&img=1&zoom=5&edge=curl&source=gbs_api"
+    #
+    # Return:
+    #     String
+    def thumbnail_small
+      return nil if @result.nil?
+      @result["items"][0]["volumeInfo"]["imageLinks"]["smallThumbnail"]
+    end
+
+
+    # It returns the link of thumbnail of book
+    #
+    # Example:
+    #   >> gisbn.thumbnail
+    #   => "http://books.google.com/books/content?id=i-bUBQAAQBAJ&printsec=frontcover&img=1&zoom=1&edge=curl&source=gbs_api"
+    #
+    # Return:
+    #     String
+    def thumbnail
+      return nil if @result.nil?
+      @result["items"][0]["volumeInfo"]["imageLinks"]["thumbnail"]
+    end
+
+    # It returns the preview link of book
+    #
+    # Example:
+    #   >> gisbn.preview_link
+    #   => "http://books.google.ca/books?id=i-bUBQAAQBAJ&printsec=frontcover&dq=isbn:0262033844&hl=&cd=1&source=gbs_api"
+    #
+    # Return:
+    #     String
+    def preview_link
+      return nil if @result.nil?
+      @result["items"][0]["volumeInfo"]["previewLink"]
+    end
+
+    # It returns the count of page
+    #
+    # Example:
+    #   >> gisbn.page_count
+    #   => 1292
+    #
+    # Return:
+    #     int
+    def page_count
+      return 0 if @result.nil?
+      @result["items"][0]["volumeInfo"]["pageCount"]
+    end
+
+
+    # It returns the published date
+    #
+    # Example:
+    #   >> gisbn.published_date
+    #   => #<Date: 2009-07-31 ((2455044j,0s,0n),+0s,2299161j)>
+    #
+    # Return:
+    #     Date
+    def published_date
+      return nil if @result.nil?
+      Date.parse(@result["items"][0]["volumeInfo"]["publishedDate"])
+    end
+  end
+end

data/lib/gisbn/version.rb

@@ -0,0 +1,3 @@
+module Gisbn
+  VERSION = "0.0.1"
+end

data/spec/gisbn_spec.rb

@@ -0,0 +1,17 @@
+require 'spec_helper'
+
+describe "gisbn" do
+  subject { Gisbn::Book.new "0262033844" }
+
+  describe '#process' do
+    let(:output) { "Introduction to Algorithms" }
+
+    it 'book title' do
+      expect(output.downcase).to eq subject.title.downcase
+    end
+
+    it 'book page count' do
+      expect(output).to eq subject.page_count
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,5 @@
+##All
+require 'gisbn'
+require 'rspec'
+require 'net/http'
+require 'json'

metadata

@@ -0,0 +1,113 @@
+--- !ruby/object:Gem::Specification
+name: gisbn
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Eftakhairul Islam
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-04-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-nc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: It fetches book's information by ISBN number based on Google Book API.
+email:
+- eftakhairul@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- gisbn.gemspec
+- lib/gisbn.rb
+- lib/gisbn/version.rb
+- spec/gisbn_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/eftakhairul/gisbn
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.3
+signing_key: 
+specification_version: 4
+summary: Book information from ISBN by Google Book API.
+test_files:
+- spec/gisbn_spec.rb
+- spec/spec_helper.rb