This is a tiny client to the Open Library's Books API. If this client doesn't meet your needs, try the other Openlibrary client.
Add this line to your application's Gemfile:
gem 'openlib'
And then execute:
$ bundle install
Or install it yourself as:
$ gem install openlib
This library will use Openlibrary's view or data endpoint as appropriate to the requested attribute. You can access the raw responses with Book#view or Book#data.
> book = Openlib::Book.new(id: '9780316030571')
> book.title
=> "Cryptonomicon"
> book.authors
=> ["Neal Stephenson"]
> book.subjects
=> ["Fiction", "World War, 1939-1945", "World War, 1939-1945 in fiction", "Data encryption (Computer science)", "Cryptography", "Literature", "Science Fiction", "Long Now Manual for Civilization", "Code and cipher stories"]
You can query via ISBN, OCLC, LCCN or Openlibrary's OLID.
> b = Openlib::Book.new(id: 'OL7360862M', id_kind: :olid)
> b.title
=> "Ranger's Apprentice"
> b.authors
=> ["John Flanagan"]
> b.identifiers
=> {"isbn_13"=>["9780142406632"], "openlibrary"=>["OL7360862M"], "isbn_10"=>["0142406635"], "goodreads"=>["60400"], "librarything"=>["173672"]}
For more information on Openlibrary, check their Developer center and the Books API documentation.
Openlibrary has a GitHub repository.
After checking out the repo, run bin/setup
to install dependencies. Then, run rake test
to run the tests. You can also run bin/console
for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install
. To release a new version, update the version number in version.rb
, and then run bundle exec rake release
, which will create a git tag for the version, push git commits and tags, and push the .gem
file to rubygems.org.
Bug reports and pull requests are welcome on GitHub at https://github.com/dkam/openlib.
The gem is available as open source under the terms of the MIT License.