0.0
No commit activity in last 3 years
No release in over 3 years
Access book data on ARBookFinder
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.3
>= 0

Runtime

 Project Readme

ARBookFinder

Retrieve book data from arbookfind.com

Gem Version Build Status Dependency Status Coverage Status Code Climate

Installation

Add this line to your application's Gemfile:

gem 'ar_book_finder'

And then execute:

$ bundle

Or install it yourself as:

$ gem install ar_book_finder

PhantomJS

This gem utilizes PhantomJS for interacting with arbookfind.com. Make sure to install PhantomJS in order to use this gem.

Configuration

Choose what type of user to peform searches as.

Available types include:

  • :student
  • :parent
  • :teacher
  • :librarian

These types match up to the available user types here.

ARBookFinder.configure do |config|
  config.user_type = :teacher
end

What data is returned?

The ARBookFinder gem is capable or returning any data located on a book's detail page.

This includes:

  • cover
  • title
  • author
  • summary
  • ar_quiz_number
  • language
  • ar_quiz_availability
  • atos_book_level
  • interest_level
  • ar_points
  • rating
  • word_count
  • type
  • topics
  • series
  • url

And publisher details:

  • name
  • lccn
  • isbn
  • year_published
  • page_count

Usage

Quick Search

Quick search will allow you to perform searches based on title, topics, author or ISBN.

Perform a quick search...

results = ARBookFinder.search('harry potter')
results.page_count # Retrieve the number of pages this search returns
results.books # Retrieve the books returned on this page

Load book data on demand using #fetch...

...
book = results.book[0]
book.fetch # Retrieve book data
book.title
book.author
...

Return publisher data...

...
publisher = book.publishers[0]
publisher.name
publisher.isbn
...

Collections

Collections will retrieve books lists. Examples include awards, state lists, etc.

Retrieve a collection...

results = ARBookFinder.collection({ 'Awards' => 'ALA Notable/Best Books' })

Retrieve a collection with a multi-level hash...

results = ARBookFinder.collection({ 'State Lists' => { 'Indiana' => 'IN Young Hoosier Middle Grades Book Award Nominees 2013-2014' } })

Pagination

It's also possible to paginate search results.

# Retrieve results for page 2
results = ARBookFinder.search('harry potter', 2)
results.current_page # should == 2

Contributing

  1. Fork it
  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 new Pull Request

Credits

Sticksnleaves

ARBookFinder is maintained and funded by Sticksnleaves

Thanks to all of our contributors