Skip to content

wordtreefoundation/archivist-client

Repository files navigation

Archivist::Client - an archive.org Ruby client

Project Archivist::Client
gem name archivist-client
license License: MIT
version Gem Version
dependencies Depfu
code quality Code Climate
inline documenation Inline docs
continuous integration Build Status
test coverage Coverage Status
homepage GitHub stars
documentation http://rdoc.info/github/wordtreefoundation/archivist-client/frames
authors Duane Tweet Duane
Peter Tweet Peter

Getting Started

require 'archivist/client'

Create an Archivist client:

client = Archivist::Client::Base.new

Search for the books you're interested in:

books = client.search(:start_year => 1500, :end_year => 1510)

Download them:

books.each do |book|
  puts book.download
end

Contributors

See the Network View and the CHANGELOG

How you can help!

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
  6. Create new Pull Request

Versioning

This library aims to adhere to Semantic Versioning 2.0.0. Violations of this scheme should be reported as bugs. Specifically, if a minor or patch version is released that breaks backward compatibility, a new version should be immediately released that restores compatibility. Breaking changes to the public API will only be introduced with new major versions.

As a result of this policy, you can (and should) specify a dependency on this gem using the Pessimistic Version Constraint with two digits of precision.

For example:

spec.add_dependency 'archivist-client', '~> 0.1.0'

References

Legal

  • MIT License - See LICENSE file in this project
  • Copyright (c) 2013 Duane Johnson & Word Tree Foundation