# Wayback Gem

![Build Status](https://secure.travis-ci.org/XOlator/wayback_gem.png?branch=master)
![Coverage Status](https://coveralls.io/repos/XOlator/wayback_gem/badge.png?branch=master)

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](http://rdoc.info/gems/wayback)


## 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:

```ruby
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**

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

**Fetch a specific archived page**

```ruby
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](https://www.github.com/sferik/twitter). (Xie xie!)

More information on Archive's Wayback Machine memento API can be found [here](http://mementoweb.org/depot/native/ia/).



## Copyright
Copyright (c) 2013 XOlator.
See [LICENSE][] for details.

[license]: LICENSE.md