Wayback Gem

Build Status

A Ruby interface to Archive.org's Wayback Machine Memento API.

Installation

gem install wayback

Quick Start Guide

So you want to get up and tweeting as fast as possible?

Documentation

COMING SOON! -- documentation

Configuration

There is no real configuration necessary for accessing Archive.org's Wayback Machine Memento API, however you can change endpoint and other basic connection options.

The current defaults for this gem are:

Wayback.configure do |c|
  c.endpoint = 'http://api.wayback.archive.org'
  c.connection_options = {
    :headers  => {:user_agent => "Wayback Ruby Gem #{Wayback::Version}"},
    :request  => {:open_timeout => 5, :timeout => 10},
    :ssl      => {:verify => false},
  }
  c.identiy_map = false
  c.middleware = Faraday::Builder.new do |builder|
    # Convert request params to "www-form-urlencoded"
    builder.use Faraday::Request::UrlEncoded
    # Follow redirects
    builder.use FaradayMiddleware::FollowRedirects
    # Handle 4xx server responses
    builder.use Wayback::Response::RaiseError, Wayback::Error::ClientError
    # Handle 5xx server responses
    builder.use Wayback::Response::RaiseError, Wayback::Error::ServerError
    # Parse memento page
    builder.use Wayback::Response::ParseMementoPage
    # Parse link-format with custom memento parser
    builder.use Wayback::Response::ParseMemento
    # Set Faraday's HTTP adapter
    builder.adapter Faraday.default_adapter
  end

Usage Examples

Fetch the timeline of archived pages

Wayback.list('http://www.xolator.com')

Fetch a specific archived page

Wayback.page('http://www.xolator.com', 1363488758)
Wayback.page('http://www.xolator.com', :first)
Wayback.page('http://www.xolator.com', :last)

Additional Notes

Based heavily on the Twitter gem. (Xie xie!)

More information on Archive's Wayback Machine memento API can be found here.