readmill 0.0.0 → 0.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 48bff31a9f54c336b4b7acb0d74505005c48c306
-  data.tar.gz: 6806f9b999353fc3303d9a250e22d69f0c95c584
+  metadata.gz: f35c2ae9772b9f8842eb4df1bcee5bd376c30638
+  data.tar.gz: aed7f792b72a72241fc10a8fd8c46c08bcb10512
 SHA512:
-  metadata.gz: 3616e009ac80142054347a28a5f7c77480e69347a2c676a617ce28e3bac767c7ef59941f8d87dfda843ed7cbb4e52b8b162b638ed58ee65acb1a7c0efcd1e627
-  data.tar.gz: 20b98b919e34608fb4580472773fb516d8dfcb8ede22e63f90f21b6f86fedc9bd6fad4130becd5d2213a2873c67aab5fd64303c415af6b4f4469fbda32b08f94
+  metadata.gz: d1f11152644b7e4632f7c8739d5c06b2dcbf6af1a156c7e83c012f353ab92ff914f4c6e9340454ace05c88bdfc7355e50b1144fc88512d552c819d4834aba59e
+  data.tar.gz: 7fa1db95bb331efceaff34b92c2688995ac17d9ac009789418b60724b393e61299c06aeebb3f7529e45b907699f337a13594cc2868ec5554ee01e85424af8aad

data/lib/faraday/response/raise_readmill_error.rb

@@ -0,0 +1,57 @@
+require 'faraday'
+require 'multi_json'
+
+# Internal: Faraday module that the response error middleware is added to.
+module Faraday
+
+  # Internal: Faraday Middleware that deals with errors coming back from the API.
+  #
+  # Examples
+  #
+  #   connection = Faraday.new({}) do |conn|
+  #     conn.use Faraday::Response::RaiseReadmillError
+  #   end
+  class Response::RaiseReadmillError < Response::Middleware
+
+    # Internal: Hook into the complete callback for the client. When the result
+    # comes back, if it is a status code that we want to raise an error for, we
+    # will do that.
+    #
+    # Returns nothing.
+    def on_complete(response)
+      return if response[:body].nil?
+
+      case response[:body][:status].to_i
+      when 400
+        raise Readmill::BadRequest, error_message(response)
+      when 401
+        raise Readmill::Unauthorized, error_message(response)
+      when 403
+        raise Readmill::Forbidden, error_message(response)
+      when 404
+        raise Readmill::NotFound, error_message(response)
+      when 500
+        raise Readmill::InternalServerError, error_message(response)
+      when 504
+        raise Readmill::GatewayTimeout, error_message(response)
+      end
+    end
+
+    # Internal: Parse the response and return a human friendly String
+    # representing the error that we received.
+    #
+    # Returns a String.
+    def error_message(response)
+      method = response[:method].to_s.upcase
+      url = response[:url].to_s
+      status = response[:body][:status]
+      error = response[:body][:error]
+      "#{method} #{url}: #{status} - #{error}"
+    end
+  end
+
+  # Internal: Register this middleware for faraday as response.
+  Faraday.register_middleware :response,
+    :readmill_errors => lambda { Faraday::Response::RaiseReadmillError }
+
+end

data/lib/readmill.rb

@@ -1,2 +1,34 @@
+require 'readmill/client'
+require 'readmill/configuration'
+require 'readmill/error'
+
 module Readmill
+
+  class << self
+
+    # Public: An alias for Readmill::Client.new.
+    #
+    # Returns an Readmill::Client.
+    def new(options={})
+      Readmill::Client.new(options)
+    end
+
+    # Public: Delegate methods to Readmill::Client.new. If a Readmill::Client
+    # does not respond_to? the :method, pass it up the chain.
+    #
+    # Returns nothing.
+    def method_missing(method, *args, &block)
+      return super unless new.respond_to?(method)
+      new.send(method, *args, &block)
+    end
+
+    # Public: Delegate to Readmill::Client.new respond_to?
+    #
+    # Returns nothing.
+    def respond_to?(method, include_private=false)
+      new.respond_to?(method, include_private) || super(method, include_private)
+    end
+
+  end
+
 end

data/lib/readmill/client.rb

@@ -0,0 +1,41 @@
+require 'readmill/request'
+require 'readmill/configuration'
+require 'readmill/client/books'
+
+module Readmill
+
+  # Public: The Client is what wraps all of the Readmill API. You will use this
+  # class to handle the majority of your interaction with Readmill.
+  class Client
+
+    # Public: Set instance level configuration values.
+    attr_accessor *Readmill::Configuration::VALID_CONFIGURATION_KEYS
+
+    # Public: Constructor for a Readmill::Client.
+    #
+    # opts - A Hash of options to modify the client (default: {}).
+    def initialize(opts={})
+
+      # TODO: Extract this, move it elsewhere. If this hasn't been configured,
+      # I'm wondering if we raise an exception and move on?
+      Readmill.configuration ||= Readmill::Configuration.new
+
+      config = Readmill.configuration.values.merge(opts)
+      Readmill::Configuration::VALID_CONFIGURATION_KEYS.each do |k|
+        send("#{k}=", config[k])
+      end
+    end
+
+    # Public: Get the base URL for accessing the Readmill API.
+    #
+    # Returns a String.
+    def api_url
+      "https://api.readmill.com/v2/"
+    end
+
+    include Readmill::Request
+    include Readmill::Client::Books
+
+  end
+
+end

data/lib/readmill/client/books.rb

@@ -0,0 +1,33 @@
+module Readmill
+  class Client
+
+    # Public: This module will bring all of the methods from the book section
+    # of the API.
+    module Books
+
+      # Public: Get all books from readmill.
+      #
+      # opts  - A Hash of options used to modify the results. All of the values
+      #         of this Hash will be forwarded to the API as parameters
+      #         (default: {}).
+      #
+      # Returns an Array.
+      def books(opts={})
+        get('books', opts).items
+      end
+
+      # Public: Get a specific book from readmill.
+      #
+      # id    - The id of a book to get from readmill.
+      # opts  - A Hash of options used to modify the results. All of the values
+      #         of this Hash will be forwarded to the API as parameters
+      #         (default: {}).
+      #
+      # Returns a Hashie::Mash.
+      def book(id, opts={})
+        get("books/#{id}", opts)
+      end
+
+    end
+  end
+end

data/lib/readmill/configuration.rb

@@ -0,0 +1,46 @@
+module Readmill
+
+  class << self
+    attr_accessor :configuration
+  end
+
+  # Public: Configure a Readmill client.
+  #
+  # Examples
+  #
+  #   Readmill.configure do |r|
+  #     r.client_id = 'abc123'
+  #   end
+  def self.configure
+    self.configuration ||= Configuration.new
+    yield(configuration)
+  end
+
+  # Internal: Store all of the configurable options inside of a Configuration
+  # class.
+  class Configuration
+
+    # Public: An Array of all keys that can be configured. This allows us to
+    # set instance keys, knowing what can and cannot be modified.
+    VALID_CONFIGURATION_KEYS = [:client_id, :timeout, :open_timeout, :adapter]
+
+    # Internal: Create a get/set method for each valid key.
+    attr_accessor *VALID_CONFIGURATION_KEYS
+
+    # Internal: Default all of the keys to valid defaults.
+    def initialize
+      self.client_id         = nil
+      self.timeout           = 10
+      self.open_timeout      = 10
+      self.adapter           = Faraday.default_adapter
+    end
+
+    # Public: Return all of the current values.
+    #
+    # Returns a Hash.
+    def values
+      VALID_CONFIGURATION_KEYS.inject({}){|o,k| o.merge!(k => send(k)) }
+    end
+  end
+
+end

data/lib/readmill/error.rb

@@ -0,0 +1,24 @@
+module Readmill
+
+  # Public: Custom error class for rescuing from all Readmill errors
+  class Error < StandardError; end
+
+  # Public: 400 HTTP Status Code
+  class BadRequest < Error; end
+
+  # Public: 401 HTTP Status Code
+  class Unauthorized < Error; end
+
+  # Public: 403 HTTP Status Code
+  class Forbidden < Error; end
+
+  # Public: 404 HTTP Status Code
+  class NotFound < Error; end
+
+  # Public: 500 HTTP Status Code
+  class InternalServerError < Error; end
+
+  # Public: 504 HTTP Status Code
+  class GatewayTimeout < Error; end
+
+end

data/lib/readmill/request.rb

@@ -0,0 +1,64 @@
+require 'multi_json'
+require 'faraday_middleware'
+require 'faraday/response/raise_readmill_error'
+
+module Readmill
+
+  module Request
+
+    # Public: Make an HTTP GET Request to the path, passing the opts as params
+    # in the query.
+    #
+    # path    - The path to request.
+    # opts    - A Hash to send as query parameters (default: {}).
+    #
+    # Returns a String.
+    def get(path, opts={})
+      request(:get, path, opts)
+    end
+
+    private
+
+    # Internal: Use the Faraday::Connection from lib/espn/connection.rb and
+    # make the HTTP Request to the path.
+    #
+    # method  - A Symbol specifying the HTTP method to use.
+    # path    - The URL to send the request to.
+    # opts    - The Hash options to send as query parameters.
+    #
+    # Returns a String.
+    def request(method, path, opts)
+      response = connection.send(method) do |request|
+        request.url(path, opts)
+        request.options[:timeout] = timeout
+        request.options[:open_timeout] = open_timeout
+
+        unless client_id.nil?
+          request.headers['Authorization'] = "Client #{client_id}"
+        end
+      end
+
+      response.body
+    end
+
+    # Internal: Build a new instance of Faraday with some default options and
+    # return it.
+    #
+    # Returns a Faraday::Connection.
+    def connection
+      options = { url: api_url, ssl: { verify: false } }
+
+      connection = Faraday.new(options) do |conn|
+        conn.response :readmill_errors
+        conn.response :mashify
+        conn.response :json
+
+        conn.adapter  adapter
+      end
+
+      connection
+    end
+
+  end
+
+end

data/lib/readmill/version.rb

@@ -1,6 +1,6 @@
 module Readmill
 
   # Public: The version of the Readmill gem.
-  VERSION = '0.0.0'.freeze
+  VERSION = '0.0.1'.freeze
 
 end

data/spec/cassettes/readmill/client/books_book/should_request_a_book_from_readmill.yml

@@ -0,0 +1,72 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.readmill.com/v2/books/1
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.8.8
+      Authorization:
+      - Client READMILL_CLIENT_ID
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - '*/*'
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Cache-Control:
+      - must-revalidate, private, max-age=0
+      Content-Type:
+      - application/json; charset=utf-8
+      Date:
+      - Mon, 16 Dec 2013 02:33:14 GMT
+      Etag:
+      - '"d6b8fcef7531c80136b0539e78042926"'
+      Server:
+      - nginx/1.0.12
+      Status:
+      - 200 OK
+      X-Rack-Cache:
+      - miss
+      X-Request-Id:
+      - 1c23d7b8a812a1e03f6da245ca4a35f3
+      X-Runtime:
+      - '0.104400'
+      X-Ua-Compatible:
+      - IE=Edge,chrome=1
+      Content-Length:
+      - '2428'
+      Connection:
+      - keep-alive
+    body:
+      encoding: UTF-8
+      string: '{"book":{"id":1,"title":"Do More Faster: TechStars Lessons to Accelerate
+        Your Startup","author":"Cohen, David, Feld, Brad","identifier":"0470929839","story":"Practical
+        advice from some of today''s top early stage investors and entrepreneurs  TechStars
+        is a mentorship-driven startup accelerator with operations in three U.S. cities.
+        Once a year in each city, it funds about ten Internet startups with a small
+        amount of capital and surrounds them with around fifty top Internet entrepreneurs
+        and investors. Historically, about seventy-five percent of the companies that
+        go through TechStars raise a meaningful amount of angel or venture capital.
+        Do More Faster: TechStars Lessons to Accelerate Your Startup is a collection
+        of advice that comes from individuals who have passed through, or are part
+        of, this proven program. Each vignette is an exploration of information often
+        heard during the TechStars program and provides practical insights into early
+        stage entrepreneurship.  Contains seven sections, each focusing on a major
+        theme within the TechStars program, including idea and vision, fundraising,
+        legal and structure, and work/life balance Created by two highly regarded
+        experts in the world of early stage investing Essays in each section come
+        from the experienced author team as well as TechStar mentors, entrepreneurs,
+        and founders of companies   While you''ll ultimately have to make your own
+        decisions about what''s right for your business, Do More Faster: TechStars
+        Lessons to Accelerate Your Startup can get your entrepreneurial endeavor headed
+        in the right direction.","published_at":"2010-10-19","language":"en","permalink":"do-more-faster-techstars-lessons-to-accelerate-your-startup","permalink_url":"https://readmill.com/books/do-more-faster-techstars-lessons-to-accelerate-your-startup","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Freadmill-assets.s3.amazonaws.com%252Fcovers%252F4c22fed8ffc2f4a651ab3dd994eb452403e12cf4-original.png&width=120","cover_metadata":{"original_width":300,"original_height":452},"assets":{"items":[{"asset":{"vendor":"","uri":"http://www.feedbooks.com/item/217887/do-more-faster-techstars-lessons-to-accelerate-your-startup","acquisition_type":"store"}}]},"readings_count":98,"recommended_readings_count":0,"active_and_finished_readings_count":24,"average_duration":214,"featured":false,"price_segment":null},"status":200}'
+    http_version: 
+  recorded_at: Mon, 16 Dec 2013 02:33:13 GMT
+recorded_with: VCR 2.8.0

data/spec/cassettes/readmill/client/books_book/should_return_a_book.yml

@@ -0,0 +1,72 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.readmill.com/v2/books/1
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.8.8
+      Authorization:
+      - Client READMILL_CLIENT_ID
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - '*/*'
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Cache-Control:
+      - must-revalidate, private, max-age=0
+      Content-Type:
+      - application/json; charset=utf-8
+      Date:
+      - Mon, 16 Dec 2013 03:37:29 GMT
+      Etag:
+      - '"d6b8fcef7531c80136b0539e78042926"'
+      Server:
+      - nginx/1.0.12
+      Status:
+      - 200 OK
+      X-Rack-Cache:
+      - miss
+      X-Request-Id:
+      - 78fe3796424215c04a878304b69a2453
+      X-Runtime:
+      - '0.096865'
+      X-Ua-Compatible:
+      - IE=Edge,chrome=1
+      Content-Length:
+      - '2428'
+      Connection:
+      - keep-alive
+    body:
+      encoding: UTF-8
+      string: '{"book":{"id":1,"title":"Do More Faster: TechStars Lessons to Accelerate
+        Your Startup","author":"Cohen, David, Feld, Brad","identifier":"0470929839","story":"Practical
+        advice from some of today''s top early stage investors and entrepreneurs  TechStars
+        is a mentorship-driven startup accelerator with operations in three U.S. cities.
+        Once a year in each city, it funds about ten Internet startups with a small
+        amount of capital and surrounds them with around fifty top Internet entrepreneurs
+        and investors. Historically, about seventy-five percent of the companies that
+        go through TechStars raise a meaningful amount of angel or venture capital.
+        Do More Faster: TechStars Lessons to Accelerate Your Startup is a collection
+        of advice that comes from individuals who have passed through, or are part
+        of, this proven program. Each vignette is an exploration of information often
+        heard during the TechStars program and provides practical insights into early
+        stage entrepreneurship.  Contains seven sections, each focusing on a major
+        theme within the TechStars program, including idea and vision, fundraising,
+        legal and structure, and work/life balance Created by two highly regarded
+        experts in the world of early stage investing Essays in each section come
+        from the experienced author team as well as TechStar mentors, entrepreneurs,
+        and founders of companies   While you''ll ultimately have to make your own
+        decisions about what''s right for your business, Do More Faster: TechStars
+        Lessons to Accelerate Your Startup can get your entrepreneurial endeavor headed
+        in the right direction.","published_at":"2010-10-19","language":"en","permalink":"do-more-faster-techstars-lessons-to-accelerate-your-startup","permalink_url":"https://readmill.com/books/do-more-faster-techstars-lessons-to-accelerate-your-startup","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Freadmill-assets.s3.amazonaws.com%252Fcovers%252F4c22fed8ffc2f4a651ab3dd994eb452403e12cf4-original.png&width=120","cover_metadata":{"original_width":300,"original_height":452},"assets":{"items":[{"asset":{"vendor":"","uri":"http://www.feedbooks.com/item/217887/do-more-faster-techstars-lessons-to-accelerate-your-startup","acquisition_type":"store"}}]},"readings_count":98,"recommended_readings_count":0,"active_and_finished_readings_count":24,"average_duration":214,"featured":false,"price_segment":null},"status":200}'
+    http_version: 
+  recorded_at: Mon, 16 Dec 2013 03:37:28 GMT
+recorded_with: VCR 2.8.0

data/spec/cassettes/readmill/client/books_books/should_request_all_books_from_readmill.yml

@@ -0,0 +1,61 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.readmill.com/v2/books
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.8.8
+      Authorization:
+      - Client READMILL_CLIENT_ID
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - '*/*'
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Cache-Control:
+      - must-revalidate, private, max-age=0
+      Content-Type:
+      - application/json; charset=utf-8
+      Date:
+      - Mon, 16 Dec 2013 02:33:13 GMT
+      Etag:
+      - '"ca284445bdd40d8b1fe6bee2486e61aa"'
+      Server:
+      - nginx/1.0.12
+      Status:
+      - 200 OK
+      X-Rack-Cache:
+      - miss
+      X-Request-Id:
+      - c24e1a4e70d02f099bbe94bebcd9cc1f
+      X-Runtime:
+      - '0.131691'
+      X-Ua-Compatible:
+      - IE=Edge,chrome=1
+      Content-Length:
+      - '15340'
+      Connection:
+      - keep-alive
+    body:
+      encoding: UTF-8
+      string: '{"pagination":{"next":"https://api.readmill.com/v2/books?offset=0&order=created_at&to=2013-12-16+02%3A30%3A19+UTC"},"items":[{"book":{"id":360624,"title":"\u51c9\u751f\uff0c\u6211\u4eec\u53ef\u4e0d\u53ef\u4ee5\u4e0d\u5fe7\u4f241","author":"\u4e50\u5c0f\u7c73","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"liang-sheng-wo-men-ke-bu-ke-yi-bu-you-shang-1","permalink_url":"https://readmill.com/books/liang-sheng-wo-men-ke-bu-ke-yi-bu-you-shang-1","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360623,"title":"Cavalier
+        Case","author":"Antonia Fraser","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"cavalier-case","permalink_url":"https://readmill.com/books/cavalier-case","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360622,"title":"\u8721\u7b14\u5c0f\u65b0[49\u5377]-\u7b2c01\u5377","author":"\u81fc\u4e95\u4eea\u4eba","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"zha-bi-xiao-xin-49juan-di-01juan","permalink_url":"https://readmill.com/books/zha-bi-xiao-xin-49juan-di-01juan","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360621,"title":"Quinnell
+        -  01 - Man on Fire","author":"Dads","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"quinnell-01-man-on-fire","permalink_url":"https://readmill.com/books/quinnell-01-man-on-fire","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360620,"title":"\u6bd2","author":"\u97e9\u5bd2","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"du-1","permalink_url":"https://readmill.com/books/du-1","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360619,"title":"02
+        - Drop Shot","author":"Harlan Coben","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"02-drop-shot","permalink_url":"https://readmill.com/books/02-drop-shot","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360618,"title":"\u6bd4\u5c14\u30fb\u76d6\u8328\u5168\u4f20","author":"\u4e8e\u6210\u9f99","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"bi-er-gai-ci-quan-chuan","permalink_url":"https://readmill.com/books/bi-er-gai-ci-quan-chuan","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360617,"title":"Creepers
+        (2006)","author":"David - Frank Balenger 01 Morrell","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"creepers-2006","permalink_url":"https://readmill.com/books/creepers-2006","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360616,"title":"Foundations
+        and Concepts - vCloud","author":"VMware, Inc.","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"foundations-and-concepts-vcloud","permalink_url":"https://readmill.com/books/foundations-and-concepts-vcloud","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360615,"title":"\u90ce\u54b8\u5e73\u6587\u5b57\u5168\u96c6","author":"\u90ce\u54b8\u5e73","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"lang-xian-ping-wen-zi-quan-ji","permalink_url":"https://readmill.com/books/lang-xian-ping-wen-zi-quan-ji","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360614,"title":"Foundations
+        and Concepts - vCloud\n  Automation Center 6.0","author":"VMware, Inc.","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"foundations-and-concepts-vcloud-automation-center-6-dot-0","permalink_url":"https://readmill.com/books/foundations-and-concepts-vcloud-automation-center-6-dot-0","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":1,"recommended_readings_count":0,"active_and_finished_readings_count":1,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360613,"title":"\u4e09\u6bdb\u5168\u96c612
+        \u968f\u60f3","author":"\u4e09\u6bdb\uff08\u53f0\uff09","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"san-mao-quan-ji-12-sui-xiang","permalink_url":"https://readmill.com/books/san-mao-quan-ji-12-sui-xiang","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360612,"title":"\u97e9\u5bd2\u6700\u65b0\u535a\u6587\u7cbe\u9009\uff1a\u53ef\u7231\u7684\u6d2a\u6c34\u731b\u517d","author":"\u97e9\u5bd2","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"han-han-zui-xin-bo-wen-jing-xuan-ke-ai-de-hong-shui-meng-shou","permalink_url":"https://readmill.com/books/han-han-zui-xin-bo-wen-jing-xuan-ke-ai-de-hong-shui-meng-shou","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360611,"title":"\u4e2d\u56fd\u7ecf\u5178\u8425\u9500\u6848\u4f8b\u5927\u5168\u548c\u4e16\u754c\u8425\u9500\u7edd\u5999\u70b9\u5b50","author":"\u4e0d\u8be6","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"zhong-guo-jing-dian-ying-xiao-an-li-da-quan-he-shi-jie-ying-xiao-jue-miao-dian-zi","permalink_url":"https://readmill.com/books/zhong-guo-jing-dian-ying-xiao-an-li-da-quan-he-shi-jie-ying-xiao-jue-miao-dian-zi","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360610,"title":"\u6b27\u6d32\u5927\u9646\u7684\u5de8\u4eba\uff1a\u5927\u56fd\u5d1b\u8d77\u00b7\u5fb7\u56fd","author":"COAY.COM","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"ou-zhou-da-lu-de-ju-ren-da-guo-jue-qi-star-de-guo","permalink_url":"https://readmill.com/books/ou-zhou-da-lu-de-ju-ren-da-guo-jue-qi-star-de-guo","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360609,"title":"\u704c\u7bee\u9ad8\u624b[\u5b8c]-\u7b2c01\u5377","author":"\u4e95\u4e0a\u96c4\u5f66","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"guan-lan-gao-shou-wan-di-01juan","permalink_url":"https://readmill.com/books/guan-lan-gao-shou-wan-di-01juan","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360608,"title":"JC01
+        - Birdman","author":"Mo Hayder","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"jc01-birdman","permalink_url":"https://readmill.com/books/jc01-birdman","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360607,"title":"\u505a\u6700\u597d\u7684\u81ea\u5df1\uff1a\u505a\u4eba\u4e0d\u8981\u592a\u8001\u5b9e","author":"\u6c34\u4e2d\u9c7c","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"zuo-zui-hao-de-zi-ji-zuo-ren-bu-yao-tai-lao-shi","permalink_url":"https://readmill.com/books/zuo-zui-hao-de-zi-ji-zuo-ren-bu-yao-tai-lao-shi","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360606,"title":"\u4e0e\u9886\u5bfc\u5403\u996d\u7684\u6280\u5de7","author":"\u5a01\u950bqweasdzxc6","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"yu-ling-dao-chi-fan-de-ji-qiao-1","permalink_url":"https://readmill.com/books/yu-ling-dao-chi-fan-de-ji-qiao-1","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360605,"title":"The
+        Eye in the Door","author":"Pat Barker","identifier":"9780141906447","story":null,"published_at":null,"language":null,"permalink":"the-eye-in-the-door","permalink_url":"https://readmill.com/books/the-eye-in-the-door","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}}],"status":200}'
+    http_version:
+  recorded_at: Mon, 16 Dec 2013 02:33:12 GMT
+recorded_with: VCR 2.8.0

data/spec/cassettes/readmill/client/books_books/should_return_an_array_of_books.yml

@@ -0,0 +1,92 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.readmill.com/v2/books
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.8.8
+      Authorization:
+      - Client READMILL_CLIENT_ID
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - '*/*'
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Cache-Control:
+      - must-revalidate, private, max-age=0
+      Content-Type:
+      - application/json; charset=utf-8
+      Date:
+      - Mon, 16 Dec 2013 03:35:14 GMT
+      Etag:
+      - '"63c3547bfbe2bac2bfdb26d0d5929376"'
+      Server:
+      - nginx/1.0.12
+      Status:
+      - 200 OK
+      X-Rack-Cache:
+      - miss
+      X-Request-Id:
+      - 382d5a631212d178be472aed493af446
+      X-Runtime:
+      - '0.162167'
+      X-Ua-Compatible:
+      - IE=Edge,chrome=1
+      Content-Length:
+      - '16069'
+      Connection:
+      - keep-alive
+    body:
+      encoding: UTF-8
+      string: '{"pagination":{"next":"https://api.readmill.com/v2/books?offset=0&order=created_at&to=2013-12-16+03%3A06%3A08+UTC"},"items":[{"book":{"id":360767,"title":"Wave
+        (2013)","author":"Deraniyagala, Sonali","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"wave-2013","permalink_url":"https://readmill.com/books/wave-2013","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Freadmill-assets.s3.amazonaws.com%252Fcovers%252Facf504a58ad1d1974e9eea3001cdb5119eb98e62-original.png&width=120","cover_metadata":{"original_width":525,"original_height":700},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360766,"title":"We
+        All Scream","author":"Nona Wesley","identifier":"9781606595480","story":null,"published_at":null,"language":null,"permalink":"we-all-scream","permalink_url":"https://readmill.com/books/we-all-scream","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360765,"title":"AVENGING
+        ANGEL","author":"Tara Janzen","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"avenging-angel-2","permalink_url":"https://readmill.com/books/avenging-angel-2","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360764,"title":"AC.BOW.06
+        BLACK FLAG","author":"Assassin''s Creed","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"ac-dot-bow-dot-06-black-flag","permalink_url":"https://readmill.com/books/ac-dot-bow-dot-06-black-flag","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360763,"title":"First
+        Thing I See","author":"Keeland, Vi","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"first-thing-i-see","permalink_url":"https://readmill.com/books/first-thing-i-see","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Freadmill-assets.s3.amazonaws.com%252Fcovers%252Ff2a7b3aea7430a65c85535a46959651db3d7f1c7-original.png&width=120","cover_metadata":{"original_width":500,"original_height":751},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360762,"title":"ASOIAF.MAR.99
+        THE A SONG OF ICE AND FIRE SERIES","author":"George R. R. Martin","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"asoiaf-dot-mar-dot-99-the-a-song-of-ice-and-fire-series","permalink_url":"https://readmill.com/books/asoiaf-dot-mar-dot-99-the-a-song-of-ice-and-fire-series","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360761,"title":"Richelle''s
+        Tale","author":"Kelli Wolfe","identifier":null,"story":"Princess Richelle
+        is given to the human priests of the Five Gods and enslaved. To preserve her
+        life she must submit to High Priest Lucan and his friends and serve them body
+        and soul. Will she bow to them and allow them to sate their lusts on her innocence,
+        or will she feed the hunger of their dark gods?","published_at":null,"language":null,"permalink":"richelles-tale","permalink_url":"https://readmill.com/books/richelles-tale","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Freadmill-assets.s3.amazonaws.com%252Fcovers%252F0a9d41d66a85b3e3d95bd171894c91a08565d52c-original.png&width=120","cover_metadata":{"original_width":546,"original_height":819},"assets":{"items":[]},"readings_count":1,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360760,"title":"Fall
+        From Love","author":"Heather London","identifier":null,"story":"Struggling
+        to put her life back together after a tragic mountaineering accident kills
+        her college sweetheart, twenty-one-year-old Holly Treadwell is trying to set
+        aside her grief, forge ahead in school, and find herself again.When Carter
+        Hansen, a guy who brings back horrible memories from the night of the accident,
+        finds his way back into her life, Holly\u2019s unsure if she should let him
+        in. He terrifies her in more ways than one and invokes feelings in her that
+        she thought were buried forever. Regardless of her fears, she knows she must
+        face him in order for her heart to heal. Everyone tells Carter that what happened
+        on the mountain that night was just a terrible accident, but even then, he
+        can\u2019t help but carry around the guilt and is unable to forgive himself.
+        He\u2019s drawn to Holly and being near her helps ease his conscience and
+        gives him the release he needs.As Holly and Carter\u2019s relationship grows,
+        they begin to realize that the more time they spend with one another, the
+        more their wounds begin to heal\u2014her grief and his guilt. But when Holly
+        learns the details about the night of the accident\u2014what everyone has
+        been keeping from her\u2014it will rip open old wounds and tear apart what
+        they\u2019ve both worked so hard to overcome\u2026","published_at":null,"language":null,"permalink":"fall-from-love","permalink_url":"https://readmill.com/books/fall-from-love","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Freadmill-assets.s3.amazonaws.com%252Fcovers%252F1788abbfe4951913a6f3824f7f299471e3ee7566-original.png&width=120","cover_metadata":{"original_width":491,"original_height":751},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360759,"title":"Getting
+        It Right","author":"Kaje Harper","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"getting-it-right-1","permalink_url":"https://readmill.com/books/getting-it-right-1","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":1,"recommended_readings_count":0,"active_and_finished_readings_count":1,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360758,"title":"The
+        Christian in Complete Armour","author":"William Gurnall","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"the-christian-in-complete-armour","permalink_url":"https://readmill.com/books/the-christian-in-complete-armour","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Freadmill-assets.s3.amazonaws.com%252Fcovers%252Fc886f9d040060e59c6d2b63e8e42e38b70b665ee-original.png&width=120","cover_metadata":{"original_width":200,"original_height":304},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360757,"title":"i
+        e38186562a84eac0","author":"Unknown","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"i-e38186562a84eac0","permalink_url":"https://readmill.com/books/i-e38186562a84eac0","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":1,"recommended_readings_count":0,"active_and_finished_readings_count":1,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360756,"title":"i
+        721547deeb95f2ba","author":"intern","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"i-721547deeb95f2ba","permalink_url":"https://readmill.com/books/i-721547deeb95f2ba","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360755,"title":"Echoes
+        from the Orient","author":"Chiqui Morrow","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"echoes-from-the-orient","permalink_url":"https://readmill.com/books/echoes-from-the-orient","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":1,"recommended_readings_count":0,"active_and_finished_readings_count":1,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360754,"title":"Microsoft
+        Word - book_4 - edit - 7 - two paragraphs inserted.doc","author":"Ian","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"microsoft-word-book-4-edit-7-two-paragraphs-inserted-dot-doc","permalink_url":"https://readmill.com/books/microsoft-word-book-4-edit-7-two-paragraphs-inserted-dot-doc","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360753,"title":"Microsoft
+        Word - book_5 - edit - 6.doc","author":"Ian","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"microsoft-word-book-5-edit-6-dot-doc","permalink_url":"https://readmill.com/books/microsoft-word-book-5-edit-6-dot-doc","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360752,"title":"AC.BOW.05
+        FORSAKEN","author":"Assassin''s Creed","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"ac-dot-bow-dot-05-forsaken","permalink_url":"https://readmill.com/books/ac-dot-bow-dot-05-forsaken","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360751,"title":"subway_web_map_Sep12.eps","author":"Chuck","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"subway-web-map-sep12-dot-eps","permalink_url":"https://readmill.com/books/subway-web-map-sep12-dot-eps","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360750,"title":"NFT
+        Guide April 2008.cwk","author":"Craig Elevitch1","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"nft-guide-april-2008-dot-cwk","permalink_url":"https://readmill.com/books/nft-guide-april-2008-dot-cwk","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":1,"recommended_readings_count":0,"active_and_finished_readings_count":1,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360749,"title":"Mowers","author":"Jordan
+        B","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"mowers","permalink_url":"https://readmill.com/books/mowers","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":1,"recommended_readings_count":0,"active_and_finished_readings_count":1,"average_duration":null,"featured":false,"price_segment":null}},{"book":{"id":360748,"title":"Anthropology:
+        Appreciating Human Diversity","author":"Conrad P Kottak","identifier":null,"story":null,"published_at":null,"language":null,"permalink":"anthropology-appreciating-human-diversity","permalink_url":"https://readmill.com/books/anthropology-appreciating-human-diversity","cover_url":"https://d26cmntuippvfl.cloudfront.net/?action=shrink-w&format=png&origin=https%253A%252F%252Fd15fum6h02z48v.cloudfront.net%252Fassets%252Fdefault-cover-original-a8cdd3ce01730b6af1039cff21184295.png&width=120","cover_metadata":{"original_width":1200,"original_height":1800},"assets":{"items":[]},"readings_count":0,"recommended_readings_count":0,"active_and_finished_readings_count":0,"average_duration":null,"featured":false,"price_segment":null}}],"status":200}'
+    http_version: 
+  recorded_at: Mon, 16 Dec 2013 03:35:14 GMT
+recorded_with: VCR 2.8.0

data/spec/faraday/response/raise_readmill_error_spec.rb

@@ -0,0 +1,80 @@
+require 'spec_helper'
+
+describe Faraday::Response::RaiseReadmillError do
+  before do
+    @class = described_class.new
+  end
+
+  context 'when used' do
+    before do
+      @response = Hashie::Mash.new(method: :get, url: 'http://test')
+      @response.body = Hashie::Mash.new(status: 'error', error: 'foobar')
+    end
+
+    it 'does not raise an error if the response has no body' do
+      @response.body = nil
+      lambda {
+        @class.on_complete(@response)
+      }.should_not raise_error
+    end
+
+    it 'does not raise an error for HTTP 200' do
+      @response.body.status = 200
+      lambda {
+        @class.on_complete(@response)
+      }.should_not raise_error
+    end
+
+    it 'raises an error for HTTP 400' do
+      @response.body.status = 400
+      lambda {
+        @class.on_complete(@response)
+      }.should raise_error(Readmill::BadRequest)
+    end
+
+    it 'raises an error for HTTP 401' do
+      @response.body.status = 401
+      lambda {
+        @class.on_complete(@response)
+      }.should raise_error(Readmill::Unauthorized)
+    end
+
+    it 'raises an error for HTTP 403' do
+      @response.body.status = 403
+      lambda {
+        @class.on_complete(@response)
+      }.should raise_error(Readmill::Forbidden)
+    end
+
+    it 'raises an error for HTTP 404' do
+      @response.body.status = 404
+      lambda {
+        @class.on_complete(@response)
+      }.should raise_error(Readmill::NotFound)
+    end
+
+    it 'raises an error for HTTP 500' do
+      @response.body.status = 500
+      lambda {
+        @class.on_complete(@response)
+      }.should raise_error(Readmill::InternalServerError)
+    end
+
+    it 'raises an error fro HTTP 504' do
+      @response.body.status = 504
+      lambda {
+        @class.on_complete(@response)
+      }.should raise_error(Readmill::GatewayTimeout)
+    end
+  end
+
+  describe '#error_message' do
+    it 'should be formatted correctly' do
+      response = Hashie::Mash.new(method: :get, url: 'http://test')
+      response.body = Hashie::Mash.new(status: '404', error: 'Not Found')
+      result = @class.error_message(response)
+      result.should eq('GET http://test: 404 - Not Found')
+    end
+  end
+
+end

data/spec/readmill/client/books_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+describe Readmill::Client::Books do
+  let (:client) { Readmill::Client.new }
+
+  describe '.books' do
+    let! (:result) { client.books }
+
+    it 'should request all books from readmill' do
+      assert_requested :get, readmill_url('books')
+    end
+
+    it 'should return an array of books' do
+      expect(result).to be_a(Array)
+      expect(result.first).to respond_to(:book)
+    end
+  end
+
+  describe '.book' do
+    let! (:result) { client.book(1) }
+
+    it 'should request a book from readmill' do
+      assert_requested :get, readmill_url('books/1')
+    end
+
+    it 'should return a book' do
+      expect(result).to respond_to(:book)
+    end
+  end
+
+end

data/spec/readmill/client_spec.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+
+describe Readmill::Client do
+  let (:client) { Readmill::Client.new }
+
+  describe '.initialize' do
+    it 'should pass valid keys to the client' do
+      client = Readmill::Client.new(client_id: 'abc123')
+      expect(client.client_id).to eq('abc123')
+    end
+
+    it 'should override global configurations' do
+      client = Readmill::Client.new(timeout: 15)
+      expect(client.timeout).to eq(15)
+    end
+
+    it 'should not delete unaltered global configurations' do
+      client = Readmill::Client.new(timeout: 15)
+      expect(client.open_timeout).to eq(10)
+    end
+  end
+
+  describe '#api_url' do
+    it 'should return the correct url' do
+      expect(client.api_url).to eq('https://api.readmill.com/v2/')
+    end
+  end
+
+end

data/spec/readmill/configuration_spec.rb

@@ -0,0 +1,49 @@
+require 'spec_helper'
+
+describe Readmill do
+
+  describe '.methods' do
+    describe '.configure' do
+      it 'should allow you to set global configuration options' do
+        Readmill.configure do |c|
+          c.client_id = 'somerandomkey'
+        end
+        expect(Readmill.configuration.client_id).to eq('somerandomkey')
+      end
+    end
+  end
+
+  describe Readmill::Configuration do
+    let (:config) { Readmill::Configuration.new }
+
+    describe '.defaults' do
+      { client_id: nil, timeout: 10, open_timeout: 10,
+        adapter: Faraday.default_adapter }.each do |k, v|
+        it "should default #{k} to #{v}" do
+          expect(config.send(k)).to eq(v)
+        end
+      end
+    end
+
+    describe '#methods' do
+      describe '#values' do
+        before do
+          config.client_id = 'abc123'
+        end
+
+        describe '#values' do
+          it 'should return a hash of configuration settings' do
+            expect(config.values).to eq({
+              client_id: 'abc123',
+              timeout: 10,
+              open_timeout: 10,
+              adapter: Faraday.default_adapter
+            })
+          end
+        end
+      end
+    end
+
+  end
+
+end

data/spec/readmill/request_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper'
+
+describe Readmill::Request do
+  let (:client) { Readmill::Client.new }
+
+  describe '#get' do
+    it 'should call request' do
+      opts = { foo: 'bar' }
+      pattern = '/foo/bar'
+      client.should_receive(:request).with(:get, pattern, opts)
+      client.get(pattern, opts)
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,46 @@
+require 'readmill'
+require 'rspec'
+require 'webmock/rspec'
+require 'hashie'
+require 'vcr'
+require 'dotenv'
+
+# Monkeypatch String to add the underscore method
+class String
+  def underscore
+    self.gsub(/::/, '/').gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2')
+      .gsub(/([a-z\d])([A-Z])/,'\1_\2').tr("-", "_").downcase
+  end
+end
+
+# Load all ENV variables from .env
+Dotenv.load
+
+Readmill.configure do |c|
+  c.client_id = ENV['READMILL_CLIENT_ID']
+end
+
+VCR.configure do |c|
+  c.cassette_library_dir = 'spec/cassettes'
+  c.filter_sensitive_data('READMILL_CLIENT_ID') { ENV['READMILL_CLIENT_ID'] }
+  c.hook_into :webmock
+end
+
+RSpec.configure do |config|
+
+  # Add VCR to all tests
+  config.around(:each) do |example|
+    options = example.metadata[:vcr] || {}
+    if options[:record] == :skip
+      VCR.turned_off(&example)
+    else
+      name = example.metadata[:full_description].split(/\s+/, 2).join("/")
+        .underscore.gsub(/[^\w\/]+/, "_")
+      VCR.use_cassette(name, options, &example)
+    end
+  end
+end
+
+def readmill_url(url)
+  "https://api.readmill.com/v2/#{url}"
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: readmill
 version: !ruby/object:Gem::Version
-  version: 0.0.0
+  version: 0.0.1
 platform: ruby
 authors:
 - Andrew Thorp
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-12-12 00:00:00.000000000 Z
+date: 2013-12-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -106,8 +106,24 @@ files:
 - LICENSE.md
 - README.md
 - readmill.gemspec
+- lib/faraday/response/raise_readmill_error.rb
+- lib/readmill/client/books.rb
+- lib/readmill/client.rb
+- lib/readmill/configuration.rb
+- lib/readmill/error.rb
+- lib/readmill/request.rb
 - lib/readmill/version.rb
 - lib/readmill.rb
+- spec/cassettes/readmill/client/books_book/should_request_a_book_from_readmill.yml
+- spec/cassettes/readmill/client/books_book/should_return_a_book.yml
+- spec/cassettes/readmill/client/books_books/should_request_all_books_from_readmill.yml
+- spec/cassettes/readmill/client/books_books/should_return_an_array_of_books.yml
+- spec/faraday/response/raise_readmill_error_spec.rb
+- spec/readmill/client/books_spec.rb
+- spec/readmill/client_spec.rb
+- spec/readmill/configuration_spec.rb
+- spec/readmill/request_spec.rb
+- spec/spec_helper.rb
 homepage: http://github.com/andrewpthorp/readmill
 licenses: []
 metadata: {}
@@ -131,5 +147,15 @@ rubygems_version: 2.0.3
 signing_key: 
 specification_version: 4
 summary: Simple wrapper for the Readmill API.
-test_files: []
+test_files:
+- spec/cassettes/readmill/client/books_book/should_request_a_book_from_readmill.yml
+- spec/cassettes/readmill/client/books_book/should_return_a_book.yml
+- spec/cassettes/readmill/client/books_books/should_request_all_books_from_readmill.yml
+- spec/cassettes/readmill/client/books_books/should_return_an_array_of_books.yml
+- spec/faraday/response/raise_readmill_error_spec.rb
+- spec/readmill/client/books_spec.rb
+- spec/readmill/client_spec.rb
+- spec/readmill/configuration_spec.rb
+- spec/readmill/request_spec.rb
+- spec/spec_helper.rb
 has_rdoc: