lookout-rack 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d174e7a91e29167fea81278368ad27380e8e81d6
+  data.tar.gz: 867a6cddfb2e05f3db2c615b84df1a870fee8342
+SHA512:
+  metadata.gz: 1030b3fdd660bcd4585f3e54ea8e1116392bcfa7addc79954e87fe98667cde69437acd8cf4048943b62b1e373add7ebb4c48fab6c285aa262ff964aa3d546a00
+  data.tar.gz: 46742114d3ecf302a35387cad7053d6359a2b4c773d5c876b421836bc2a6788720ee6d57c1d29c16e6bcd5813813049600e54207226735ae34766e6f32f1a51f

data/fixtures/app.rb

@@ -0,0 +1,102 @@
+# -*- coding: utf-8 -*-
+
+require 'sinatra/base'
+
+module Lookout module Rack end end
+
+class Lookout::Rack::TestApp < Sinatra::Base
+  get '/' do
+    'GET: %p' % params
+  end
+
+  post '/' do
+    'POST: %p' % params
+  end
+
+  get '/redirected' do
+    redirect '/target'
+  end
+
+  get '/target' do
+    'you have been successfully redirected to target'
+  end
+
+  get '/cookies/show' do
+    request.cookies.inspect
+  end
+
+  get '/cookies/set' do
+    response.set_cookie 'value',
+      :value => params['value'],
+      :path => '/cookies',
+      :expires => Time.now + 60
+
+    'cookie has been set'
+  end
+
+  get '/cookies/expired' do
+    response.set_cookie 'value',
+      :value => params['value'],
+      :path => '/cookies',
+      :expires => Time.now - 60
+
+    'expired cookie have been set'
+  end
+
+  get '/no-cookies/show' do
+    request.cookies.inspect
+  end
+
+  get '/cookies/delete' do
+    response.delete_cookie 'value'
+  end
+
+  get '/COOKIES/show' do
+    request.cookies.inspect
+  end
+
+  get '/cookies/set-uppercase' do
+    response.set_cookie 'VALUE',
+      :value => params['value'],
+      :path => '/cookies',
+      :expires => Time.now + 60
+
+    'cookie has been set'
+  end
+
+  get '/cookies/set-simple' do
+    response.set_cookie 'simple', params['value']
+
+    'cookie has been set'
+  end
+
+  get '/cookies/set-secure' do
+    response.set_cookie 'value',
+      :value => params['value'],
+      :secure => true
+
+    'cookie has been set'
+  end
+
+  get '/cookies/subdomain' do
+    response.set_cookie 'count',
+      :value => ((request.cookies['count'].to_i or 0) + 1).to_s,
+      :domain => '.example.com'
+
+    'cookie has been set'
+  end
+
+  get '/cookies/set-multiple' do
+    response.set_cookie 'value', :value => '1'
+    response.set_cookie 'other', :value => '2'
+
+    'cookies have been set'
+  end
+
+  get '/cookies/count' do
+    response.set_cookie 'count',
+      :value => ((request.cookies['count'].to_i or 0) + 1).to_s
+
+    'cookie has been set'
+  end
+end

data/fixtures/config.ru

@@ -0,0 +1,5 @@
+# -*- coding: utf-8 -*-
+
+require File.expand_path('../app', __FILE__)
+use Rack::Lint
+run Lookout::Rack::TestApp

data/lib/lookout-rack-1.0.rb

@@ -0,0 +1,35 @@
+# -*- coding: utf-8 -*-
+
+# Namespace for [Lookout](http://disu.se/software/lookout/).  The bulk of the
+# library is in {Lookout::Rack::Session}.
+module Lookout end
+
+# [Rack](http://rack.rubyforge.org/) interface for
+# [Lookout](http://disu.se/software/lookout/).
+module Lookout::Rack
+  # The default host/URI to use for {Session#dispatch requests} and cookies.
+  DefaultHost = 'example.org'
+
+  # Base class for errors raised from Lookout::Rack.
+  Error = Class.new(StandardError)
+
+  # Error raised when a redirect is tried when none has been specified.
+  RedirectError = Class.new(Error)
+
+  # Error raised when a request hasn’t been made yet.
+  RequestError = Class.new(Error)
+
+  # Error raised when a response hasn’t been received yet.
+  ResponseError = Class.new(Error)
+
+  load File.expand_path('../lookout-rack-1.0/version.rb', __FILE__)
+  Version.load
+end
+
+class Lookout::Expectations::Context
+  include Lookout::Rack::Methods
+end
+
+class Lookout::Expect::Object::Context
+  include Lookout::Rack::Methods
+end

data/lib/lookout-rack-1.0/cookie.rb

@@ -0,0 +1,79 @@
+# -*- coding: utf-8 -*-
+
+class Lookout::Rack::Cookie
+  include Comparable
+
+  def initialize(header, uri = nil, default_host = Lookout::Rack::DefaultHost)
+    @default_host = default_host
+    uri ||= default_uri
+
+    @cookie, options = header.split(/[;,] */n, 2)
+
+    @name, @value = Rack::Utils.parse_query(@cookie, ';').to_a.first
+
+    @options = Hash[Rack::Utils.parse_query(options, ';').map{ |k, v| [k.downcase, v] }]
+    @options['domain'] ||= uri.host || default_host
+    @options['path'] ||= uri.path.sub(%r{/[^/]*\z}, '')
+  end
+
+  def empty?
+    @value.nil? or @value.empty?
+  end
+
+  def valid?(uri)
+    uri ||= default_uri
+    uri.host ||= @default_host
+
+    real_domain = domain.start_with?('.') ? domain[1..-1] : domain
+    secure? uri and
+      uri.host.downcase.end_with? real_domain.downcase and
+      uri.path.start_with? path
+  end
+
+  def matches?(uri)
+    valid? uri and not expired?
+  end
+
+  def eql?(other)
+    self.class === other and self == other
+  end
+
+  def <=>(other)
+    [name.downcase, path, domain.reverse] <=>
+      [other.name.downcase, other.path, other.domain.reverse]
+  end
+
+  def hash
+    name.downcase.hash ^ path.hash ^ domain.hash
+  end
+
+  def to_s
+    @cookie
+  end
+
+  attr_reader :name
+
+protected
+
+  def domain
+    @options['domain']
+  end
+
+  def path
+    @options['path'].strip
+  end
+
+private
+
+  def default_uri
+    URI('//%s/' % @default_host)
+  end
+
+  def secure?(uri)
+    not @options.include? 'secure' or uri.scheme == 'https'
+  end
+
+  def expired?
+    @options['expires'] and Time.parse(@options['expires']) < Time.now
+  end
+end

data/lib/lookout-rack-1.0/cookies.rb

@@ -0,0 +1,21 @@
+# -*- coding: utf-8 -*-
+
+class Lookout::Rack::Cookies
+  def initialize(default_host = Lookout::Rack::DefaultHost)
+    @default_host = default_host
+    @cookies = {}
+  end
+
+  def merge!(headers, uri = nil)
+    headers.split("\n").reject{ |c| c.empty? }.each do |header|
+      cookie = Lookout::Rack::Cookie.new(header, uri, @default_host)
+      @cookies[cookie] = cookie if cookie.valid? uri
+    end
+    self
+  end
+
+  def for(uri)
+    @cookies.values.select{ |c| c.matches? uri }.sort.
+      reduce({}){ |h, c| h[c.name] = c; h }.values.join(';')
+  end
+end

data/lib/lookout-rack-1.0/methods.rb

@@ -0,0 +1,19 @@
+# -*- coding: utf-8 -*-
+
+# Methods added to [Lookout](http://disu.se/software/lookout)’s expectations
+# and expect block context’s.
+module Lookout::Rack::Methods
+  private
+
+  # @return [Session] A new session object that wraps the global Rack app found
+  #   in the file “fixtures/config.ru” or “config.ru” in the top-level project
+  #   directory.
+  def session
+    @app ||= begin
+               Rack::Builder.parse_file('fixtures/config.ru')
+             rescue Errno::ENOENT
+               Rack::Builder.parse_file('config.ru')
+             end[0]
+    Lookout::Rack::Session.new(@app)
+  end
+end

data/lib/lookout-rack-1.0/session.rb

@@ -0,0 +1,116 @@
+# -*- coding: utf-8 -*-
+
+# A [Rack](http://rack.rubyforge.org/) session for use with
+# [Lookout](http://disu.se/software/lookout/).  Given a Rack “app”, it’ll allow
+# you to make {#get}, {#post}, {#put}, and {#delete} requests (and actually
+# {#dispatch} arbitrary requests, if you desire), check the sent {#request},
+# check the received {#response}, follow {#redirect!}s, add {#cookie}s, and
+# {#clear} cookies.
+class Lookout::Rack::Session
+  # Sets up a new session for APP.  You’ll most likely not call this yourself,
+  # leaving it up to {Methods#session} to do so.
+  #
+  # @param [#call] app
+  def initialize(app)
+    @app = app
+    @request = nil
+    @response = nil
+    clear
+  end
+
+  # Dispatches a GET request.
+  # @param (see #dispatch)
+  # @return (see #dispatch)
+  def get(uri, params = {}, env = {})
+    dispatch('GET', uri, params, env)
+  end
+
+  # Dispatches a POST request.
+  # @param (see #dispatch)
+  # @return (see #dispatch)
+  def post(uri, params = {}, env = {})
+    dispatch('POST', uri, params, env)
+  end
+
+  # Dispatches a PUT request.
+  # @param (see #dispatch)
+  # @return (see #dispatch)
+  def put(uri, params = {}, env = {})
+    dispatch('PUT', uri, params, env)
+  end
+
+  # Dispatches a DELETE request.
+  # @param (see #dispatch)
+  # @return (see #dispatch)
+  def delete(uri, params = {}, env = {})
+    dispatch('DELETE', uri, params, env)
+  end
+
+  # Dispatches a METHOD {#request} to URI with PARAMS in ENV and gets its
+  # {#response}, storing any returned {#cookie}s.  For more information on ENV,
+  # see
+  # [Rack::MockRequest](http://rack.rubyforge.org/doc/classes/Rack/MockRequest.html).
+  #
+  # @param [String] method
+  # @param [String] uri
+  # @param [Hash] params
+  # @param [Hash] env
+  # @return [self]
+  def dispatch(method, uri = '', params = {}, env = {})
+    uri = URI(uri)
+    uri.host ||= Lookout::Rack::DefaultHost
+    env = Rack::MockRequest.env_for(uri.to_s, env.merge(:method => method, :params => params))
+    env['HTTP_COOKIE'] ||= @cookies.for(uri)
+    @request = Rack::Request.new(env)
+    errors = env['rack.errors']
+    status, headers, body = *(env[:lint] ? Rack::Lint.new(@app) : @app).call(env)
+    @response = Rack::MockResponse.new(status, headers, body, errors.flush)
+    body.close if body.respond_to?(:close)
+    @cookies.merge! @response.headers['Set-Cookie'], uri if @response.headers['Set-Cookie']
+    self
+  end
+
+  # @return [Rack::Request] The Rack request that was most recently sent during
+  #   this session
+  # @raise [RequestError] If no request has been sent yet
+  def request
+    @request or raise Lookout::Rack::RequestError, 'no request has been sent yet'
+  end
+
+  # @return [Rack::MockResponse] The Rack response that was most recently
+  #   received during this session
+  # @raise [RequestError] If no response has been received yet
+  def response
+    @response or raise Lookout::Rack::ResponseError, 'no response has been received yet'
+  end
+
+  # Redirects to the most recent response’s redirected location by performing a
+  # {#get} request to the “Location” header of the response.
+  #
+  # @raise [RequestError] If no response has been received yet
+  # @raise [RedirectError] If the last response wasn’t a redirect
+  # @return [self]
+  def redirect!
+    response.redirect? or
+      raise Lookout::Rack::RedirectError, 'most recent response was not a redirect'
+    get(response['Location'])
+  end
+
+  # Sets COOKIE, being a newline-, comma-, and semicolon-separated list of
+  # `KEY=VALUE` pairs, for URI, or the {Lookout::Rack::DefaultHost default
+  # URI}, in the session.
+  # @param [String] cookie
+  # @param [String, nil] uri
+  # @return [self]
+  def cookie(cookie, uri = nil)
+    @cookies.merge! cookie, uri
+    self
+  end
+
+  # Clears all cookies from the session.
+  # @return [self]
+  def clear
+    @cookies = Lookout::Rack::Cookies.new
+    self
+  end
+end

data/lib/lookout-rack-1.0/version.rb

@@ -0,0 +1,37 @@
+# -*- coding: utf-8 -*-
+
+require 'inventory-1.0'
+
+module Lookout::Rack
+  Version = Inventory.new(1, 0, 0){
+    def dependencies
+      super + Inventory::Dependencies.new{
+        development 'inventory-rake', 1, 4, 0
+        development 'inventory-rake-tasks-yard', 1, 3, 0
+        development 'lookout-rake', 3, 0, 0
+        development 'sinatra', 1, 0, 0
+        development 'yard', 0, 8, 0
+        development 'yard-heuristics', 1, 1, 0
+        runtime 'lookout', 3, 0, 0
+        runtime 'rack', 1, 0, 0, :feature => 'rack'
+      }
+    end
+
+    def requires
+      %w[time
+         uri]
+    end
+
+    def package_libs
+      %w[cookie.rb
+         cookies.rb
+         methods.rb
+         session.rb]
+    end
+
+    def additional_files
+      %w[fixtures/app.rb
+         fixtures/config.ru]
+    end
+  }
+end

data/test/unit/lookout-rack-1.0.rb

@@ -0,0 +1,4 @@
+# -*- coding: utf-8 -*-
+
+Expectations do
+end

data/test/unit/lookout-rack-1.0/cookie.rb

@@ -0,0 +1,4 @@
+# -*- coding: utf-8 -*-
+
+Expectations do
+end

data/test/unit/lookout-rack-1.0/cookies.rb

@@ -0,0 +1,4 @@
+# -*- coding: utf-8 -*-
+
+Expectations do
+end

data/test/unit/lookout-rack-1.0/methods.rb

@@ -0,0 +1,4 @@
+# -*- coding: utf-8 -*-
+
+Expectations do
+end

data/test/unit/lookout-rack-1.0/session.rb

@@ -0,0 +1,169 @@
+# -*- coding: utf-8 -*-
+
+Expectations do
+  expect 'GET' do
+    session.get('/').request.env['REQUEST_METHOD']
+  end
+
+  expect 200 do
+    session.get('/').response.status
+  end
+
+  expect result.redirect? do
+    session.get('/redirected').response
+  end
+
+  expect result.not.redirect? do
+    session.get('/redirected').redirect!.response
+  end
+
+  expect 'you have been successfully redirected to target' do
+    session.get('/redirected').redirect!.response.body
+  end
+
+  expect({}) do
+    session.get('/redirected').redirect!.request.GET
+  end
+
+  expect Lookout::Rack::ResponseError do
+    session.redirect!
+  end
+
+  expect Lookout::Rack::RedirectError do
+    session.get('/').redirect!
+  end
+
+  expect({}) do
+    session.get('/cookies/show').request.cookies
+  end
+
+  expect 'value' => '1' do
+    session.get('/cookies/set', 'value' => '1').get('/cookies/show').request.cookies
+  end
+
+  expect 'value' => '1' do
+    session.get('/cookies/set', 'value' => '1').get('/cookies/show').get('/cookies/show').request.cookies
+  end
+
+  expect({}) do
+    session.get('/cookies/expired', 'value' => '1').get('/cookies/show').request.cookies
+  end
+
+  expect 'value' => '1' do
+    session.get('http://example.org/cookies/set', 'value' => '1').get('http://example.org/cookies/show').request.cookies
+  end
+
+  expect({}) do
+    session.get('http://example.org/cookies/set', 'value' => '1').get('http://example.net/cookies/show').request.cookies
+  end
+
+  expect({}) do
+    session.get('/cookies/set', 'value' => '1').get('/no-cookies/show').request.cookies
+  end
+
+  expect({}) do
+    session.get('/cookies/set', 'value' => '1').get('/cookies/delete').get('/cookies/show').request.cookies
+  end
+
+  expect 'value' => '1' do
+    session.get('http://example.com/cookies/set', 'value' => '1').get('http://EXAMPLE.COM/cookies/show').request.cookies
+  end
+
+  expect({}) do
+    session.get('/cookies/set', 'value' => '1').get('/COOKIES/show').request.cookies
+  end
+
+  expect 'value' => 'sub' do
+    session.
+      get('http://example.com/cookies/set', 'value' => 'domain').
+      get('http://sub.example.com/cookies/set', 'value' => 'sub').
+      get('http://sub.example.com/cookies/show').request.cookies
+  end
+
+  expect 'value' => 'domain' do
+    session.
+      get('http://example.com/cookies/set', 'value' => 'domain').
+      get('http://sub.example.com/cookies/set', 'value' => 'sub').
+      get('http://example.com/cookies/show').request.cookies
+  end
+
+  expect 'VALUE' => 'UPPERCASE' do
+    session.
+      get('/cookies/set', 'value' => 'lowercase').
+      get('/cookies/set-uppercase', 'value' => 'UPPERCASE').
+      get('/cookies/show').request.cookies
+  end
+
+  expect 'simple' => 'cookie' do
+    session.
+      get('http://example.com/cookies/set-simple', 'value' => 'cookie').
+      get('http://example.com/cookies/show').request.cookies
+  end
+
+  expect({}) do
+    session.
+      get('http://example.com/cookies/set-simple', 'value' => 'cookie').
+      get('http://example.com/cookies/show').
+      get('http://example.net/cookies/show').request.cookies
+  end
+
+  expect({}) do
+    session.get('/cookies/set-simple', 'value' => '1').get('/not-cookies/show').request.cookies
+  end
+
+  expect({}) do
+    session.
+      get('https://example.com/cookies/set-secure', 'value' => '1').
+      get('http://example.com/cookies/show').request.cookies
+  end
+
+  expect 'value' => '1' do
+    session.
+      get('https://example.com/cookies/set-secure', 'value' => '1').
+      get('https://example.com/cookies/show').request.cookies
+  end
+
+  expect 'value' => 'com' do
+    session.
+      get('http://example.com/cookies/set', 'value' => 'com').
+      get('http://example.net/cookies/set', 'value' => 'net').
+      get('http://example.com/cookies/show').request.cookies
+  end
+
+  expect 'count' => '2' do
+    session.
+      get('http://example.com/cookies/subdomain').
+      get('http://example.com/cookies/subdomain').
+      get('http://foo.example.com/cookies/subdomain').request.cookies
+  end
+
+  expect({}) do
+    session.get('/cookies/set', 'value' => '1').clear.get('/cookies/show').request.cookies
+  end
+
+  expect 'value' => '1' do
+    session.cookie('value=1').get('/cookies/show').request.cookies
+  end
+
+  expect 'value' => '1', 'other' => '2' do
+    session.cookie("value=1\n\nother=2").get('/cookies/show').request.cookies
+  end
+
+  expect 'value' => '1', 'other' => '2' do
+    session.get('/cookies/set-multiple').get('/cookies/show').request.cookies
+  end
+
+  expect 'first' => {'value' => '1'}, 'second' => {} do
+    {
+      'first' => session.get('/cookies/set', 'value' => '1').get('/cookies/show').request.cookies,
+      'second' => session.get('/cookies/show').request.cookies
+    }
+  end
+
+  expect 'count' => '1' do
+    session.
+      get('http://example.org/cookies/count').
+      get('http://www.example.org/cookies/count').
+      get('http://example.org/cookies/show').request.cookies
+  end
+end

data/test/unit/lookout-rack-1.0/version.rb

@@ -0,0 +1,4 @@
+# -*- coding: utf-8 -*-
+
+Expectations do
+end

metadata

@@ -0,0 +1,316 @@
+--- !ruby/object:Gem::Specification
+name: lookout-rack
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Nikolai Weibull
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-05-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: inventory
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: inventory-rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: inventory-rake-tasks-yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: lookout-rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: sinatra
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+- !ruby/object:Gem::Dependency
+  name: yard-heuristics
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: lookout
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description: |2
+                                   Lookout-Rack
+
+    Lookout-Rack provides easy interaction with Rack¹ from Lookout².  It provides
+    you with a session connected to your Rack application through which you can
+    make requests, check responses, follow redirects and set, inspect, and clear
+    cookies.
+
+  ¹ See http://rack.rubyforge.org/
+  ² See http://disu.se/software/lookout/
+
+  § Installation
+
+      Install Lookout-Rack with
+
+      % gem install lookout-rack
+
+  § Usage
+
+      Include the following code in your ‹Rakefile› (provided that you’re using
+      Lookout-Rake¹):
+
+        require 'lookout-rack-3.0'
+
+        Lookout::Rake::Tasks::Test.new do |t|
+          t.requires << 'lookout-rack-3.0'
+        end
+
+    ¹ See http://disu.se/software/lookout-rake/
+
+      Then set up a ‹fixtures/config.ru› file that Lookout-Rack
+      will use for loading your Rack app.
+
+        load 'path/to/app.rb'
+        use Rack::Lint
+        run Path::To::App
+
+      This file, if it exists, will be loaded during the first call to #session.
+      If it doesn’t exist, ‹config.ru› will be used instead.
+
+      You can now test your app:
+
+        Expectations do
+          expect 200 do
+            session.get('/').response.status
+          end
+        end
+
+      The #session method returns an object that lets you #get, #post, #put, and
+      #delete resources from the Rack app.  You call these method with a URI¹
+      that you want to access/modify together with any parameters that you want
+      to pass and any Rack environment that you want to use (which isn’t very
+      common).  For example, let’s get ‹/pizzas/› with olives on them:
+
+        expect 200 do
+          session.get('/pizzas/', 'olives' => '1').response.status
+        end
+
+    ¹ Abbreviation for Uniform Resource Identifier
+
+      The #response method on #session returns a mock Rack response object that
+      can be queried for results.  Similarly, there’s a #request method that lets
+      you inspect the request that was made.
+
+      Lookout-Rack also deals with cookies.  Assuming that ‹/cookies/set/› will
+      set any cookies that we pass it and that ‹/cookies/show/› will simply do
+      nothing relevant, the following expectation will pass:
+
+        expect 'value' => '1' do
+          session.
+            get('/cookies/set/', 'value' => '1').
+            get('/cookies/show/').request.cookies
+        end
+
+      Sometimes you may want to set cookies yourself before making a request.
+      You then use the #cookie method, which takes a String of ‹KEY=VALUE› pairs
+      separated by newlines, commas, and/or semicolons and sets those cookies in
+      the session:
+
+        expect 'value' => '1', 'other' => '2' do
+          session.
+            cookie("value=1\n\nother=2").
+            get('/cookies/show/').request.cookies
+        end
+
+      You may also want to clear all cookies in your session using #clear:
+
+        expect({}) do
+          session.
+            get('/cookies/set', 'value' => '1').
+            clear.
+            get('/cookies/show').request.cookies
+        end
+
+      Finally, to test redirects, call the #redirect! method on the session
+      object, assuming that ‹/redirected/› redirects to another location:
+
+        expect result.redirect? do
+          session.get('/redirected/').response
+        end
+
+        expect result.not.redirect? do
+          session.get('/redirected/').redirect!.response
+        end
+
+      That’s basically all there’s to it.  You can check the {API documentation}¹
+      for more information.
+
+  ¹ See http://disu.se/software/lookout-rack/api/Lookout/Rack/
+
+  § Financing
+
+      Currently, most of my time is spent at my day job and in my rather busy
+      private life.  Please motivate me to spend time on this piece of software
+      by donating some of your money to this project.  Yeah, I realize that
+      requesting money to develop software is a bit, well, capitalistic of me.
+      But please realize that I live in a capitalistic society and I need money
+      to have other people give me the things that I need to continue living
+      under the rules of said society.  So, if you feel that this piece of
+      software has helped you out enough to warrant a reward, please PayPal a
+      donation to now@disu.se¹.  Thanks!  Your support won’t go unnoticed!
+
+  ¹ Send a donation:
+    https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=now@disu.se&item_name=Lookout-Rack
+
+  § Reporting Bugs
+
+      Please report any bugs that you encounter to the {issue tracker}¹.
+
+    ¹ See https://github.com/now/lookout-rack/issues
+
+  § Authors
+
+      Nikolai Weibull wrote the code, the tests, the documentation, and this
+      README.
+email: now@bitwi.se
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/lookout-rack-1.0/cookie.rb
+- lib/lookout-rack-1.0/cookies.rb
+- lib/lookout-rack-1.0/methods.rb
+- lib/lookout-rack-1.0/session.rb
+- lib/lookout-rack-1.0.rb
+- lib/lookout-rack-1.0/version.rb
+- test/unit/lookout-rack-1.0/cookie.rb
+- test/unit/lookout-rack-1.0/cookies.rb
+- test/unit/lookout-rack-1.0/methods.rb
+- test/unit/lookout-rack-1.0/session.rb
+- test/unit/lookout-rack-1.0.rb
+- test/unit/lookout-rack-1.0/version.rb
+- fixtures/app.rb
+- fixtures/config.ru
+homepage: https://github.com/now/lookout-rack
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Lookout-Rack provides easy interaction with Rack¹ from Lookout².
+test_files: []