restfully 0.8.8 → 1.0.0.rc1

data/README.md

@@ -16,6 +16,9 @@ Therefore, Restfully can work with any reasonably RESTful API provided that:
 
 If one of the API `Content-Type` is not already supported by one of the `Restfully::MediaType` objects (see `lib/restfully/media_type`), then you just have to build it and register it with Restfully.
 
+Documentation can be found at <http://rubydoc.info/gems/restfully>.
+
+
 ## Installation
 
     $ gem install restfully
@@ -24,16 +27,17 @@ If you require media-types that need an XML parser, you must also install the `l
 
     $ gem install libxml-ruby
 
+
 ## Usage
 
 ### Command line
 
     $ export RUBYOPT="-rubygems"
-    $ restfully URI [-u username] [-p password]
+    $ restfully --uri URI [-u username] [-p password]
   
 e.g., for the [Grid'5000 API](https://www.grid5000.fr/mediawiki/index.php/API):
 
-    $ restfully https://api.grid5000.fr/sid/grid5000 -u username -p password
+    $ restfully --uri https://api.grid5000.fr/sid/grid5000 -u username -p password
 
 If the connection was successful, you should get a prompt. You may enter:
 
@@ -81,9 +85,39 @@ And then:
 
     $ restfully -c ~/.restfully/api.grid5000.fr.yml
 
+If you want to record the commands you enter in your interactive session, just
+add the `--record` flag, and at the end of your session the commands you
+entered will have been written into `SESSION_FILE` (by default:
+`restfully-tape`).
+
+### Replay
+
+Restfully can replay a sequence of ruby expressions. Just pass the FILE (local
+or HTTP URI) as argument to the `restfully` tool:
+
+    $ restfully -c ~/.restfully/my-config.yml path/to/file.rb
+    $ restfully -c ~/.restfully/my-config.yml http://server.ltd/script.rb
+
+Or via STDIN:
+
+    $ echo "pp root" | restfully -c ~/.restfully/config.yml
+
+Don't hesitate to play with the `--replay` option, which outputs the content of the FILE line by line, and the result of each expression.
+
+By default, the program exits when the content of the FILE has been executed.
+Pass the `--shell` flag to keep a shell open in the same Restfully session
+after FILE has been executed. This is useful if you want to manipulate the
+variables defined by the FILE.
+
+Also, note that any `Restfully::Session.new(...)` declaration in the code you
+execute will have its configuration overridden with anything given on the
+command line (either in a configuration file or as arguments). Therefore you
+can easily execute scripts written by others, in your own context.
+
 ### As a library
 See the `examples` directory for examples.
 
+
 ## Development
 
 ### Testing
@@ -99,6 +133,7 @@ See the `examples` directory for examples.
 * Commit, do not mess with Rakefile, version, or history (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull).
 * Send me a pull request. 
 
+
 ## Copyright
 
 Copyright (c) 2009-2011 [Cyril Rohr](http://crohr.me), INRIA Rennes - Bretagne Atlantique. 

data/bin/restfully

@@ -5,120 +5,170 @@ require 'restfully'
 require 'optparse'
 require 'logger'
 require 'pp'
+require 'ripl'
+require 'ripl/multi_line'
 
 # Behaviour of pp in IRB is different on ruby1.9:
 # * pp(object) returns object#inspect.
 # * we prefer the behaviour of ruby1.8 where pp returns nil.
-alias :old_pp :pp 
+alias :old_pp :pp
 def pp(*args)
   old_pp(*args); nil
 end
 
 logger = Logger.new(STDERR)
 logger.level = Logger::WARN
-@options = {"logger" => logger}
+
+OPTIONS = {"logger" => logger, "shell" => false}
+
+Ripl.config[:play_quiet] = true
+Ripl.config[:play_input] = false
 
 option_parser = OptionParser.new do |opts|
   opts.banner = <<BANNER
 * Description
   Restfully #{Restfully::VERSION} - Access REST APIs effortlessly
 * Usage
-  restfully [uri] [options]
-* Options
+  restfully [options] [FILE]
+
+  If FILE is given and is an HTTP URI or a local file, the content of that file will be executed in the context of the Restfully session. It can also be read from STDIN.
+  If no FILE is given, then an interactive shell will be launched in the context of the Restfully session.
 BANNER
 
-  opts.on("-u=", "--username=", "Sets the username") do |u|
-    @options["username"] = u
+  opts.separator ""
+  opts.separator "* Common options"
+  opts.on("--uri=", "Sets the base URI") do |v|
+    OPTIONS["uri"] = v
+  end
+  opts.on("-u=", "--username=", "Sets the username (Basic Authentication)") do |u|
+    OPTIONS["username"] = u
   end
-  opts.on("-p=", "--password=", "Sets the user password") do |p|
-    @options["password"] = p
+  opts.on("-p=", "--password=", "Sets the password (Basic Authentication)") do |p|
+    OPTIONS["password"] = p
   end
-  opts.on("-c=", "--config=", "Sets the various options based on a custom YAML configuration file") do |v|
-    @options["configuration_file"] = v
+  opts.on("-c=", "--config=", "Load options from a custom YAML configuration file") do |v|
+    OPTIONS["configuration_file"] = v
   end
   opts.on("-r=", "--require=", "Require an additional media-type") do |v|
-    @options["require"] ||= []
-    @options["require"].push(v)
+    OPTIONS["require"] ||= []
+    OPTIONS["require"].push(v)
   end
-  opts.on("--log=", "Outputs log messages to the given file. Defaults to stdout") do |v|
+  opts.on("--log=", "Outputs log messages to the given file. Defaults to STDERR") do |v|
     original_logger_level = logger.level
-    logger = Logger.new(File.expand_path(v))
+    @log_file = File.open(File.expand_path(v), "w+")
+    STDERR.sync = true
+    STDERR.reopen(@log_file)
+    logger = Logger.new(@log_file)
     logger.level = original_logger_level
-    @options["logger"] = logger
+    OPTIONS["logger"] = logger
   end
   opts.on("--no-cache", "Disable client-side caching") do |v|
-    @options["cache"] = false
+    OPTIONS["cache"] = false
+  end
+  opts.on("--color", "Color output") do |v|
+    require 'ripl/color_streams'
+    require 'ripl/color_result'
+  end
+  opts.on("--record [SESSION_FILE]", "Record interactive session into SESSION_FILE (default=#{Restfully::DEFAULT_TAPE}), to be replayed later. This option is ignored if FILE is given.") do |v|
+    OPTIONS["record"] = v || Restfully::DEFAULT_TAPE
   end
   opts.on("-v", "--verbose", "Run verbosely") do |v|
-    @options["logger"].level = Logger::INFO
+    OPTIONS["logger"].level = Logger::INFO
   end
   opts.on("--debug", "Run in debug mode") do |v|
-    @options["logger"].level = Logger::DEBUG
+    OPTIONS["logger"].level = Logger::DEBUG
+  end
+
+  opts.separator ""
+  opts.separator "* Options specific to FILE"
+  opts.on("--replay", "Display the FILE input line by line, and the result of each command") do |v|
+    Ripl.config[:play_input] = true
+    Ripl.config[:play_quiet] = false
   end
+  opts.on("--shell", "Start an interactive session even after FILE content has been executed") do |v|
+    OPTIONS["shell"] = true
+  end
+  opts.on("-i", "--install", "Ask to install any gem that might be required in FILE") do |v|
+    Ripl.config[:play_install] = true
+  end
+
+  opts.separator ""
+  opts.separator "* Other"
   opts.on_tail("-h", "--help", "Show this message") do
     puts opts
     exit
   end
+  opts.on_tail("--version", "Show version") do
+    puts Restfully::VERSION
+    exit
+  end
+end.parse!
+
+# Declare original Restfully::Session
+@session = Restfully::Session.new(OPTIONS)
+
+if $stdin.tty? && !ARGV[0]
+  # Interactive session
+  puts "Restfully/#{Restfully::VERSION} - The root resource is available in the 'root' variable."
+  if OPTIONS["record"]
+    # Recording requested
+    require 'ripl/record'
+    Ripl.config[:play] = OPTIONS["record"]
+  end
+else
+  # Replayed session
+  @session.logger.warn "--record option valid only with interactive session. Ignoring." if OPTIONS["record"]
+  require 'ripl/play'
+
+  module Ripl::Play
+    # Overwrite #get_input so that it does not display the input if not
+    # required.
+    def get_input
+      puts(prompt + @play_input) if Ripl.config[:play_input]
+      @play_input
+    end
+  end
   
-end
-
-option_parser.parse!
-
-if given_uri = ARGV.shift
-  @options["uri"] = given_uri
-end
-
-@session = Restfully::Session.new(@options)
-
-def session; @session; end
-
-def root 
-  @root ||= session.root
-end
-
-puts "Restfully/#{Restfully::VERSION} - The root resource is available in the 'root' variable."
-
-require 'irb'
-require 'irb/completion'
-require 'irb/ext/save-history'
-
-HOME = ENV['HOME'] || ENV['HOMEPATH']
-# Keep history of your last commands.
-# Taken from <http://blog.nicksieger.com/articles/2006/04/23/tweaking-irb>
-IRB.conf[:SAVE_HISTORY] = 100
-IRB.conf[:HISTORY_FILE] = "#{HOME}/.irb-save-history"
-
-# Raises an error on Windows, so disabling it.
-if RUBY_PLATFORM !~ /(win|w)32$/
-  module Readline
-    module History
-      LOG = "#{HOME}/.irb-history"
-
-      def self.write_log(line)
-        File.open(LOG, 'ab') {|f| 
-          f << "#{line}\n"
-        }
-      end
-    
-      def self.start_session_log
-        write_log("\n")
-      end
+  module Ripl::PlayWithoutWhitespace
+    # Remove empty lines when replaying
+    def play_back_string(str)
+      str.gsub!(/^\s*\n+/, '')
+      super(str)
+    end
+  end
+  Ripl::Shell.include Ripl::PlayWithoutWhitespace
+  
+  unless OPTIONS["shell"]
+    # Use readline-rb to avoid error message 'Bond has detected EditLine and
+    # may not work with it. See the README's Limitations section.' when no
+    # shell is requested after execution of FILE.
+    Ripl.config[:readline] = 'readline-rb'
+    Ripl.config[:completion] = {:readline => :ruby }
+    module Ripl::Exit
+      def before_loop; super; exit; end
     end
+    Ripl::Shell.include Ripl::Exit
+  end
+  
+  Ripl.config[:play] = ARGV[0].dup if ARGV[0]
+end
 
-    alias :old_readline :readline
-    def readline(*args)
-      ln = old_readline(*args)
-      begin
-        History.write_log(ln)
-      rescue
-      end
-      ln
+module Restfully
+  class Session
+    alias :old_initialize :initialize
+    # Overwrite Restfully::Session.new calls that might occur in replayed
+    # scripts, so that they preferably take the configuration given with the
+    # restfully command-line tool.
+    def initialize(options = {}, &block)
+      old_opts = Configuration.new(options).expand
+      new_opts = Configuration.new(OPTIONS).expand
+      old_initialize(old_opts.merge(new_opts).to_hash, &block)
     end
   end
-  Readline::History.start_session_log
 end
 
+# Ensure to close the log file, if any, when exiting.
+at_exit{ @log_file && @log_file.close }
+
 ARGV.clear
-ARGV.concat [ "--readline", "--prompt-mode", "simple" ]
-IRB.start
-exit!
+Ripl.start :binding => @session.instance_eval{ binding }

data/lib/restfully.rb

@@ -2,6 +2,7 @@ require 'backports'
 require 'yaml'
 
 require 'restfully/version'
+require 'restfully/configuration'
 require 'restfully/error'
 require 'restfully/http'
 require 'restfully/link'
@@ -12,6 +13,7 @@ require 'restfully/session'
 require 'restfully/media_type'
 
 module Restfully
+  DEFAULT_TAPE = "restfully-tape"
   # Include the default media-types
   MediaType.reset
 end

data/lib/restfully/configuration.rb

@@ -0,0 +1,64 @@
+require 'yaml'
+
+module Restfully
+  class Configuration
+    attr_reader :options
+    
+    def initialize(opts = {})
+      @options = opts.symbolize_keys
+    end
+
+    def merge(config = {})
+      if config.respond_to?(:to_hash)
+        @options.merge!(config.to_hash.symbolize_keys) do |key, oldval, newval|
+          case oldval
+          when Array then oldval.push(newval).flatten.uniq
+          when Hash then oldval.merge(newval)
+          else newval
+          end
+        end
+        self
+      else
+        raise ArgumentError, "Don't know how to merge #{config.class}."
+      end
+    end
+
+    def to_hash
+      @options
+    end
+
+    # Attempt to expand the configuration if a :configuration_file options is
+    # present. Existing options take precedence over those defined in the
+    # configuration file.
+    def expand
+      file = ENV['RESTFULLY_CONFIG'] || @options[:configuration_file]
+      if file
+        file = File.expand_path(file)
+        if File.file?(file) && File.readable?(file)
+          @options = self.class.load(file).merge(self).options
+        end
+      end
+      self
+    end
+
+    def [](key)
+      @options[key.to_sym]
+    end
+
+    def []=(key, value)
+      @options[key.to_sym] = value
+    end
+    
+    def delete(key)
+      @options.delete(key.to_sym)
+    end
+
+    def self.load(file)
+      if file.nil?
+        raise ArgumentError, "file can't be nil"
+      else
+        new(YAML.load_file(File.expand_path(file)))
+      end
+    end
+  end
+end

data/lib/restfully/session.rb

@@ -11,9 +11,18 @@ module Restfully
   class Session
 
 
-    attr_accessor :logger, :uri
+    attr_writer :logger
+    attr_accessor :uri
     attr_reader :config
     attr_writer :default_headers
+    
+    def logger
+      @logger ||= begin
+        l = Logger.new(STDERR)
+        l.level = Logger::INFO
+        l
+      end
+    end
 
     # Builds a new client session.
     # Takes a number of <tt>options</tt> as input.
@@ -27,7 +36,7 @@ module Restfully
     # <tt>:wait_before_retry</tt>:: the number of seconds to wait before making another attempt when a server or connection error occurs.
     # <tt>:default_headers</tt>:: a Hash of default HTTP headers to send with each request.
     # <tt>:cache</tt>:: a Hash of parameters to configure the caching component. See <http://rtomayko.github.com/rack-cache/configuration> for more information.
-    # 
+    #
     # e.g.
     #   Restfully::Session.new(
     #     :uri => "https://api.bonfire-project.eu:444/",
@@ -37,26 +46,8 @@ module Restfully
     #   ) {|root, session| p root}
     #
     def initialize(options = {})
-      @config = options.symbolize_keys
+      @config = Configuration.new(options).expand
       @logger = @config.delete(:logger)
-      if @logger.nil?
-        @logger = Logger.new(STDERR)
-        @logger.level = Logger::INFO
-      end
-
-      # Read configuration from file:
-      config_file = ENV['RESTFULLY_CONFIG'] || @config.delete(:configuration_file)
-      config_file = File.expand_path(config_file) if config_file
-      if config_file && File.file?(config_file) && File.readable?(config_file)
-        @logger.info "Using configuration file located at #{config_file}."
-        @config = YAML.load_file(config_file).symbolize_keys.merge(@config) do |key, oldval, newval|
-          case oldval
-          when Array then oldval.push(newval).flatten
-          when Hash then oldval.merge(newval)
-          else newval
-          end
-        end
-      end
 
       @config[:retry_on_error] ||= 5
       @config[:wait_before_retry] ||= 5
@@ -77,7 +68,7 @@ module Restfully
 
       # Require additional types (e.g.: media-types):
       (@config[:require] || []).each do |r|
-        @logger.info "Requiring #{r}..."
+        logger.info "Requiring #{r}..."
         if ::File.exist?(file=File.expand_path(r))
           require file
         elsif r =~ /^https?:\/\//i
@@ -146,6 +137,11 @@ module Restfully
       get(uri.path).load
     end
 
+    # Returns self.
+    def session
+      self
+    end
+
     # Returns an HTTP::Response object or raise a Restfully::HTTP::Error
     def head(path, options = {})
       transmit :head, path, options
@@ -173,14 +169,6 @@ module Restfully
       transmit :delete, path, options
     end
 
-    # Build and execute the corresponding HTTP request,
-    # then process the response.
-    def transmit(method, path, options)
-      request = HTTP::Request.new(self, method, path, options)
-      response = request.execute!
-      process(response, request)
-    end
-
     # Process a Restfully::HTTP::Response.
     def process(response, request)
       case code=response.code
@@ -208,6 +196,14 @@ module Restfully
     end
 
     protected
+    # Build and execute the corresponding HTTP request,
+    # then process the response.
+    def transmit(method, path, options)
+      request = HTTP::Request.new(self, method, path, options)
+      response = request.execute!
+      process(response, request)
+    end
+
     def setup_cache(options = {})
       return if options == false
       opts = {:verbose => (logger.level <= Logger::INFO)}.merge(

data/lib/restfully/version.rb

@@ -1,3 +1,3 @@
 module Restfully
-  VERSION = "0.8.8"
+  VERSION = "1.0.0.rc1"
 end

data/spec/fixtures/config.yml

@@ -0,0 +1,5 @@
+uri: https://api.bonfire-project.eu/
+username: someone
+password: p4ssw0rd
+require: ['ApplicationVndBonfireXml']
+gateway: ssh.bonfire.grid5000.fr

data/spec/restfully/configuration_spec.rb

@@ -0,0 +1,45 @@
+require 'spec_helper'
+
+describe Restfully::Configuration do
+
+  before do
+    @config_file = File.expand_path("../../fixtures/config.yml", __FILE__)
+    @expected_merge = {
+      :require=>["ApplicationVndBonfireXml", "something"], 
+      :username=>"crohr", 
+      :gateway=>"ssh.bonfire.grid5000.fr", 
+      :uri=>"https://api.bonfire-project.eu/", 
+      :password=>"p4ssw0rd"
+    }
+  end
+
+  it "should take a hash and store it with symbolized keys" do
+    config = Restfully::Configuration.new("a" => 1, :b => "hello", "c" => [1,2,3])
+    config.options.should == {:a=>1, :b=>"hello", :c=>[1, 2, 3]}
+  end
+
+  it "should correctly load a configuration file" do
+    config = Restfully::Configuration.load(@config_file)
+    config.options.should == {
+      :require=>["ApplicationVndBonfireXml"], 
+      :username=>"someone", 
+      :uri=>"https://api.bonfire-project.eu/", 
+      :password=>"p4ssw0rd", 
+      :gateway=>"ssh.bonfire.grid5000.fr"
+    }
+  end
+  
+  it "should correctly overwrite the options defined in the configuration file with other options given on initialization" do
+    config = Restfully::Configuration.new(:username => "crohr", :require => ['something'], :configuration_file => @config_file)
+    config.expand
+    config.options.should == @expected_merge.merge(
+      :configuration_file=>@config_file
+    )
+  end
+  
+  it "should correctly merge two configs" do
+    config1 = Restfully::Configuration.new(:username => "crohr", :require => ['something'])
+    config2 = Restfully::Configuration.load(@config_file)
+    config2.merge(config1).options.should == @expected_merge
+  end
+end

data/spec/restfully/session_spec.rb

@@ -16,7 +16,7 @@ describe Restfully::Session do
       session = Restfully::Session.new(@config.merge("key" => "value"))
       session.logger.should == @logger
       session.uri.should == Addressable::URI.parse(@uri)
-      session.config.should == {:wait_before_retry=>5, :key=>"value", :retry_on_error=>5}
+      session.config.to_hash.should == {:wait_before_retry=>5, :key=>"value", :retry_on_error=>5}
     end
 
     it "should raise an error if no URI given" do
@@ -53,7 +53,7 @@ describe Restfully::Session do
       }]]]
     end
     
-    it "should disable the clietn-side cache if given :no_cache" do
+    it "should disable the client-side cache if given :no_cache" do
       session = Restfully::Session.new(@config.merge({
         :cache => false
       }))
@@ -68,6 +68,11 @@ describe Restfully::Session do
     res.should_receive(:load).and_return(res)
     session.root.should == res
   end
+  
+  it "should return itself when calling #session" do
+    session = Restfully::Session.new(@config)
+    session.session.should == session
+  end
 
   it "should fetch the root path [URI path present]" do
     session = Restfully::Session.new(
@@ -130,10 +135,10 @@ describe Restfully::Session do
         instance_of(Restfully::HTTP::Request)
       )
 
-      @session.transmit :get, @path, {
+      @session.send(:transmit, :get, @path, {
         :query => {:k1 => "v1", :k2 => "v2"},
         :headers => {'X-Header' => 'value'}
-      }
+      })
     end
 
     it "should make an authenticated get request" do
@@ -145,10 +150,10 @@ describe Restfully::Session do
       )
       @session.should_receive(:process)
       @session.authenticate :username => 'crohr', :password => 'p4ssw0rd'
-      @session.transmit :get, @path, {
+      @session.send(:transmit, :get, @path, {
         :query => {:k1 => "v1", :k2 => "v2"},
         :headers => {'X-Header' => 'value'}
-      }
+      })
     end
 
     it "should retry for at most :max_attempts_on_connection_error if connection to the server failed" do

metadata

@@ -1,20 +1,19 @@
 --- !ruby/object:Gem::Specification
 name: restfully
 version: !ruby/object:Gem::Version
-  version: 0.8.8
-  prerelease: 
+  version: 1.0.0.rc1
+  prerelease: 6
 platform: ruby
 authors:
 - Cyril Rohr
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-09-21 00:00:00.000000000 +02:00
-default_executable: 
+date: 2011-11-04 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
-  requirement: &2153881280 !ruby/object:Gem::Requirement
+  requirement: &2152514160 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -22,10 +21,10 @@ dependencies:
         version: '1.5'
   type: :runtime
   prerelease: false
-  version_requirements: *2153881280
+  version_requirements: *2152514160
 - !ruby/object:Gem::Dependency
   name: rest-client
-  requirement: &2153880820 !ruby/object:Gem::Requirement
+  requirement: &2152511640 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -33,10 +32,10 @@ dependencies:
         version: '1.6'
   type: :runtime
   prerelease: false
-  version_requirements: *2153880820
+  version_requirements: *2152511640
 - !ruby/object:Gem::Dependency
   name: rest-client-components
-  requirement: &2153912940 !ruby/object:Gem::Requirement
+  requirement: &2152510880 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -44,10 +43,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *2153912940
+  version_requirements: *2152510880
 - !ruby/object:Gem::Dependency
   name: rack-cache
-  requirement: &2153912480 !ruby/object:Gem::Requirement
+  requirement: &2152509540 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -55,10 +54,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *2153912480
+  version_requirements: *2152509540
 - !ruby/object:Gem::Dependency
   name: backports
-  requirement: &2153912060 !ruby/object:Gem::Requirement
+  requirement: &2152508000 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -66,10 +65,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *2153912060
+  version_requirements: *2152508000
 - !ruby/object:Gem::Dependency
   name: addressable
-  requirement: &2153911640 !ruby/object:Gem::Requirement
+  requirement: &2152506760 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -77,10 +76,65 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *2153911640
+  version_requirements: *2152506760
+- !ruby/object:Gem::Dependency
+  name: ripl
+  requirement: &2152505220 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2152505220
+- !ruby/object:Gem::Dependency
+  name: ripl-multi_line
+  requirement: &2152504360 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2152504360
+- !ruby/object:Gem::Dependency
+  name: ripl-color_streams
+  requirement: &2152503480 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2152503480
+- !ruby/object:Gem::Dependency
+  name: ripl-play
+  requirement: &2152502240 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.2.1
+  type: :runtime
+  prerelease: false
+  version_requirements: *2152502240
+- !ruby/object:Gem::Dependency
+  name: rb-readline
+  requirement: &2152501420 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2152501420
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &2153911140 !ruby/object:Gem::Requirement
+  requirement: &2152500480 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -88,10 +142,10 @@ dependencies:
         version: '0.8'
   type: :development
   prerelease: false
-  version_requirements: *2153911140
+  version_requirements: *2152500480
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &2153910640 !ruby/object:Gem::Requirement
+  requirement: &2152499460 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -99,10 +153,10 @@ dependencies:
         version: '2'
   type: :development
   prerelease: false
-  version_requirements: *2153910640
+  version_requirements: *2152499460
 - !ruby/object:Gem::Dependency
   name: webmock
-  requirement: &2153910260 !ruby/object:Gem::Requirement
+  requirement: &2152498720 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -110,10 +164,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2153910260
+  version_requirements: *2152498720
 - !ruby/object:Gem::Dependency
   name: autotest
-  requirement: &2153909800 !ruby/object:Gem::Requirement
+  requirement: &2152497620 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -121,10 +175,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2153909800
+  version_requirements: *2152497620
 - !ruby/object:Gem::Dependency
   name: autotest-growl
-  requirement: &2153909380 !ruby/object:Gem::Requirement
+  requirement: &2152495520 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -132,7 +186,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2153909380
+  version_requirements: *2152495520
 description: Consume RESTful APIs effortlessly
 email:
 - cyril.rohr@gmail.com
@@ -145,6 +199,7 @@ extra_rdoc_files:
 files:
 - bin/restfully
 - lib/restfully/collection.rb
+- lib/restfully/configuration.rb
 - lib/restfully/error.rb
 - lib/restfully/http/error.rb
 - lib/restfully/http/helper.rb
@@ -174,10 +229,12 @@ files:
 - spec/fixtures/bonfire-network-collection.xml
 - spec/fixtures/bonfire-network-existing.xml
 - spec/fixtures/bonfire-root.xml
+- spec/fixtures/config.yml
 - spec/fixtures/grid5000-rennes-job.json
 - spec/fixtures/grid5000-rennes-jobs.json
 - spec/fixtures/grid5000-rennes.json
 - spec/restfully/collection_spec.rb
+- spec/restfully/configuration_spec.rb
 - spec/restfully/http/helper_spec.rb
 - spec/restfully/http/request_spec.rb
 - spec/restfully/http/response_spec.rb
@@ -190,7 +247,6 @@ files:
 - Rakefile
 - LICENSE
 - README.md
-has_rdoc: true
 homepage: http://github.com/crohr/restfully
 licenses: []
 post_install_message: 
@@ -212,7 +268,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '1.3'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.6.2
+rubygems_version: 1.8.11
 signing_key: 
 specification_version: 3
 summary: Consume RESTful APIs effortlessly
@@ -226,10 +282,12 @@ test_files:
 - spec/fixtures/bonfire-network-collection.xml
 - spec/fixtures/bonfire-network-existing.xml
 - spec/fixtures/bonfire-root.xml
+- spec/fixtures/config.yml
 - spec/fixtures/grid5000-rennes-job.json
 - spec/fixtures/grid5000-rennes-jobs.json
 - spec/fixtures/grid5000-rennes.json
 - spec/restfully/collection_spec.rb
+- spec/restfully/configuration_spec.rb
 - spec/restfully/http/helper_spec.rb
 - spec/restfully/http/request_spec.rb
 - spec/restfully/http/response_spec.rb