resourceful 0.6.4 → 1.0.0

data/History.txt

@@ -1,3 +1,8 @@
+Version 1.0.0
+============
+ * Added .request() convenience method to Resourceful module.
+ * Added .get(), .post(), .put(), .delete() and .head() convenience method to Resourceful module
+
 Version 0.7.0
 =============
  * Multiple values in a single header field are treated the same as repeated header fields. (Peter Williams)

data/Manifest

@@ -1,4 +1,9 @@
 History.txt
+MIT-LICENSE
+Manifest
+README.markdown
+Rakefile
+lib/resourceful.rb
 lib/resourceful/abstract_form_data.rb
 lib/resourceful/authentication_manager.rb
 lib/resourceful/cache_manager.rb
@@ -11,14 +16,10 @@ lib/resourceful/net_http_adapter.rb
 lib/resourceful/request.rb
 lib/resourceful/resource.rb
 lib/resourceful/response.rb
+lib/resourceful/simple.rb
 lib/resourceful/stubbed_resource_proxy.rb
 lib/resourceful/urlencoded_form_data.rb
 lib/resourceful/util.rb
-lib/resourceful.rb
-Manifest
-MIT-LICENSE
-Rakefile
-README.markdown
 resourceful.gemspec
 spec/acceptance/authorization_spec.rb
 spec/acceptance/caching_spec.rb
@@ -34,6 +35,7 @@ spec/resourceful/multipart_form_data_spec.rb
 spec/resourceful/resource_spec.rb
 spec/resourceful/response_spec.rb
 spec/resourceful/urlencoded_form_data_spec.rb
+spec/resourceful_spec.rb
 spec/simple_sinatra_server.rb
 spec/simple_sinatra_server_spec.rb
 spec/spec.opts

data/README.markdown

@@ -12,7 +12,7 @@ Features:
 
 More Info
 =========
- 
+
  * Source: [Github](http://github.com/paul/resourceful/tree/master)
  * Bug Tracking: [Lighthouse](http://resourceful.lighthouseapp.com)
  * Project Page: [Rubyforge](http://rubyforge.org/projects/resourceful/)
@@ -30,8 +30,7 @@ Simplest example
 ---------------
 
     require 'resourceful'
-    http = Resourceful::HttpAccessor.new
-    resp = http.resource('http://rubyforge.org').get
+    resp = Resourceful.get('http://rubyforge.org')
     puts resp.body
 
 Get a page requiring HTTP Authentication
@@ -45,7 +44,7 @@ Get a page requiring HTTP Authentication
 Redirection based on callback results
 -------------------------------------
 
-Resourceful will by default follow redirects on read requests (GET and HEAD), but not for 
+Resourceful will by default follow redirects on read requests (GET and HEAD), but not for
 POST, etc. If you want to follow a redirect after a post, you will need to set the resource#on_redirect
 callback. If the callback evaluates to true, it will follow the redirect.
 
@@ -58,7 +57,7 @@ Post a URL encoded form
 
      require 'resourceful'
      http = Resourceful::HttpAccessor.new
-     resp = http.resource('http://mysite.example/service'). 
+     resp = http.resource('http://mysite.example/service').
               post(Resourceful::UrlencodedFormData.new(:hostname => 'test', :level => 'super'))
 
 Post a Mulitpart form with a file
@@ -77,7 +76,7 @@ Put an XML document
      http = Resourceful::HttpAccessor.new
      resp = http.resource('http://mysite.example/service').
               put('<?xml version="1.0"?><test/>', :content_type => 'application/xml')
-    
+
 Delete a resource
 -----------------
 

data/Rakefile

@@ -12,7 +12,7 @@ begin
     p.email           = "psadauskas@gmail.com"
 
     p.ignore_pattern  = ["pkg/*", "tmp/*"]
-    p.dependencies    = [['addressable', '>= 2.1.0'], 'httpauth', ['options', '>= 2.1.0']]
+    p.dependencies    = [['addressable', '>= 2.1.0'], 'httpauth', ['options', '>= 2.1.1']]
     p.development_dependencies = ['thin', 'yard', 'sinatra', 'rspec']
     p.retain_gemspec  = true
   end

data/lib/resourceful.rb

@@ -9,15 +9,18 @@ require 'resourceful/util'
 
 require 'resourceful/header'
 require 'resourceful/http_accessor'
+require 'resourceful/simple'
 
 module Resourceful
   autoload :MultipartFormData, 'resourceful/multipart_form_data'
   autoload :UrlencodedFormData, 'resourceful/urlencoded_form_data'
   autoload :StubbedResourceProxy, 'resourceful/stubbed_resource_proxy'
+
+  extend Simple
 end
 
 # Resourceful is a library that provides a high level HTTP interface.
 module Resourceful
-  VERSION = "0.6.4"
+  VERSION = "1.0.0"
   RESOURCEFUL_USER_AGENT_TOKEN = "Resourceful/#{VERSION}(Ruby/#{RUBY_VERSION})"
 end

data/lib/resourceful/cache_manager.rb

@@ -150,7 +150,7 @@ module Resourceful
       @entries.each(&block)
     end
     
-    # Looks of a Entry that could fullfil the request. Returns nil if none
+    # Looks for an Entry that could fullfil the request. Returns nil if none
     # was found.
     #
     # @param [Resourceful::Request] request
@@ -215,7 +215,9 @@ module Resourceful
     #   The request to do the lookup on. 
     def valid_for?(request)
       request.uri == @request_uri and 
-        @request_vary_headers.all? {|key, value| request.header[key] == value}
+        @request_vary_headers.all? {|key, value| 
+          request.header[key] == value
+        }
     end
 
     # Selects the headers from the request named by the response's Vary header
@@ -229,7 +231,7 @@ module Resourceful
       header = Resourceful::Header.new
 
       response.header['Vary'].each do |name|
-        header[name] = request.header[name]
+        header[name] = request.header[name] if request.header[name]
       end if response.header['Vary']
 
       header

data/lib/resourceful/header.rb

@@ -1,6 +1,5 @@
 require 'options'
 require 'set'
-require 'facets/memoize'
 
 # Represents the header fields of an HTTP message.  To access a field
 # you can use `#[]` and `#[]=`.  For example, to get the content type
@@ -51,6 +50,10 @@ module Resourceful
       field_def(k).set_to(v, @raw_fields)
     end
 
+    def delete(k)
+      field_def(k).delete(@raw_fields)
+    end
+
     def has_key?(k)
       field_def(k).exists_in?(@raw_fields)
     end
@@ -160,6 +163,10 @@ module Resourceful
                                 end
       end
       
+      def delete(raw_fields_hash)
+        raw_fields_hash.delete(name)
+      end
+      
       def exists_in?(raw_fields_hash)
         raw_fields_hash.has_key?(name)
       end
@@ -182,7 +189,7 @@ module Resourceful
       end
       
       def name_pattern
-        @name_pattern || @name_pattern = Regexp.new('^' + name.gsub('-', '[_-]') + '$', Regexp::IGNORECASE)
+        @name_pattern ||= Regexp.new('^' + name.gsub('-', '[_-]') + '$', Regexp::IGNORECASE)
       end
       
       def methodized_name

data/lib/resourceful/resource.rb

@@ -8,9 +8,9 @@ module Resourceful
 
     # Build a new resource for a uri
     #
-    # @param accessor<HttpAccessor> 
+    # @param accessor<HttpAccessor>
     #   The parent http accessor
-    # @param uri<String, Addressable::URI> 
+    # @param uri<String, Addressable::URI>
     #   The uri for the location of the resource
     def initialize(accessor, uri, default_header = {})
       @accessor, @uris = accessor, [uri]
@@ -22,7 +22,7 @@ module Resourceful
     # used to create the resource, but in the case of a permanent redirect, this
     # will always reflect the lastest uri.
     #
-    # @return Addressable::URI 
+    # @return Addressable::URI
     #   The current uri of the resource
     def effective_uri
       @uris.first
@@ -55,10 +55,10 @@ module Resourceful
     #   end
     #
     # @yieldparam callback<request, response>
-    #   The action to be executed when a request results in a redirect. Yields the 
+    #   The action to be executed when a request results in a redirect. Yields the
     #   current request and result objects to the callback.
     #
-    # @raise ArgumentError if called without a block 
+    # @raise ArgumentError if called without a block
     def on_redirect(&callback)
       if block_given?
         @on_redirect = callback
@@ -84,7 +84,7 @@ module Resourceful
     # :call-seq:
     #   post(data = "", :content_type => mime_type)
     #
-    # Performs a POST with the given data to the resource, following redirects as 
+    # Performs a POST with the given data to the resource, following redirects as
     # neccessary.
     #
     # @param [String] data
@@ -104,7 +104,7 @@ module Resourceful
     # :call-seq:
     #   put(data = "", :content_type => mime_type)
     #
-    # Performs a PUT with the given data to the resource, following redirects as 
+    # Performs a PUT with the given data to the resource, following redirects as
     # neccessary.
     #
     # @param [String] data
@@ -139,14 +139,14 @@ module Resourceful
 
     # Ensures that the request has a content type header
     def ensure_content_type(body, header)
-      return if header.has_key?('Content-Type') 
-      
+      return if header.has_key?('Content-Type')
+
       if body.respond_to?(:content_type)
         header['Content-Type'] = body.content_type
         return
       end
-      
-      return if default_header.has_key?('Content-Type') 
+
+      return if default_header.has_key?('Content-Type')
 
       # could not figure it out
       raise MissingContentType
@@ -159,10 +159,7 @@ module Resourceful
 
       data = StringIO.new(data) if data.kind_of?(String)
 
-      logger.debug { header.map {|k,v| "#{k}: #{v}"}.join("\n\t\t") }
-      logger.debug { data = StringIO.new(data.read); data.string } if data
-      
-      log_request_with_time "#{method.to_s.upcase} [#{uri}]" do        
+      log_request_with_time "#{method.to_s.upcase} [#{uri}]" do
         request = Request.new(method, self, data, header)
         request.fetch_response
       end

data/lib/resourceful/response.rb

@@ -82,7 +82,9 @@ module Resourceful
     end
 
     def body
+      raise(NotImplementedError, 'Chained encodings are not supported') if header['Content-Encoding'] && header['Content-Encoding'].length > 1
       encoding = header['Content-Encoding'] && header['Content-Encoding'].first
+
       case encoding
       when nil
         # body is identity encoded; just return it

data/lib/resourceful/simple.rb

@@ -0,0 +1,36 @@
+module Resourceful
+  module Simple
+    def request(method, uri, header = {}, data =nil)
+      default_accessor.resource(uri).request(method, data, header)
+    end
+    
+    def default_accessor
+      @default_accessor ||= Resourceful::HttpAccessor.new
+    end
+    
+    def add_authenticator(an_authenticator)
+      default_accessor.add_authenticator(an_authenticator)
+    end
+
+    def get(uri, header = {})
+      request(:get, uri, header)
+    end
+
+    def head(uri, header = {})
+      request(:head, uri, header)
+    end
+
+    def delete(uri, header = {})
+      request(:delete, uri, header)
+    end
+ 
+    def post(uri, data = nil, header = {})
+      request(:post, uri, header, data)
+    end
+
+    def put(uri, data = nil, header = {})
+      request(:put, uri, header, data)
+    end
+  end
+
+end

data/resourceful.gemspec

@@ -2,15 +2,15 @@
 
 Gem::Specification.new do |s|
   s.name = %q{resourceful}
-  s.version = "0.6.4"
+  s.version = "1.0.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
   s.authors = ["Paul Sadauskas"]
-  s.date = %q{2009-09-29}
+  s.date = %q{2010-01-26}
   s.description = %q{An HTTP library for Ruby that takes advantage of everything HTTP has to offer.}
   s.email = %q{psadauskas@gmail.com}
-  s.extra_rdoc_files = ["lib/resourceful/abstract_form_data.rb", "lib/resourceful/authentication_manager.rb", "lib/resourceful/cache_manager.rb", "lib/resourceful/exceptions.rb", "lib/resourceful/header.rb", "lib/resourceful/http_accessor.rb", "lib/resourceful/memcache_cache_manager.rb", "lib/resourceful/multipart_form_data.rb", "lib/resourceful/net_http_adapter.rb", "lib/resourceful/request.rb", "lib/resourceful/resource.rb", "lib/resourceful/response.rb", "lib/resourceful/stubbed_resource_proxy.rb", "lib/resourceful/urlencoded_form_data.rb", "lib/resourceful/util.rb", "lib/resourceful.rb", "README.markdown"]
-  s.files = ["History.txt", "lib/resourceful/abstract_form_data.rb", "lib/resourceful/authentication_manager.rb", "lib/resourceful/cache_manager.rb", "lib/resourceful/exceptions.rb", "lib/resourceful/header.rb", "lib/resourceful/http_accessor.rb", "lib/resourceful/memcache_cache_manager.rb", "lib/resourceful/multipart_form_data.rb", "lib/resourceful/net_http_adapter.rb", "lib/resourceful/request.rb", "lib/resourceful/resource.rb", "lib/resourceful/response.rb", "lib/resourceful/stubbed_resource_proxy.rb", "lib/resourceful/urlencoded_form_data.rb", "lib/resourceful/util.rb", "lib/resourceful.rb", "Manifest", "MIT-LICENSE", "Rakefile", "README.markdown", "resourceful.gemspec", "spec/acceptance/authorization_spec.rb", "spec/acceptance/caching_spec.rb", "spec/acceptance/header_spec.rb", "spec/acceptance/redirecting_spec.rb", "spec/acceptance/resource_spec.rb", "spec/acceptance_shared_specs.rb", "spec/caching_spec.rb", "spec/old_acceptance_specs.rb", "spec/resourceful/header_spec.rb", "spec/resourceful/http_accessor_spec.rb", "spec/resourceful/multipart_form_data_spec.rb", "spec/resourceful/resource_spec.rb", "spec/resourceful/response_spec.rb", "spec/resourceful/urlencoded_form_data_spec.rb", "spec/simple_sinatra_server.rb", "spec/simple_sinatra_server_spec.rb", "spec/spec.opts", "spec/spec_helper.rb"]
+  s.extra_rdoc_files = ["README.markdown", "lib/resourceful.rb", "lib/resourceful/abstract_form_data.rb", "lib/resourceful/authentication_manager.rb", "lib/resourceful/cache_manager.rb", "lib/resourceful/exceptions.rb", "lib/resourceful/header.rb", "lib/resourceful/http_accessor.rb", "lib/resourceful/memcache_cache_manager.rb", "lib/resourceful/multipart_form_data.rb", "lib/resourceful/net_http_adapter.rb", "lib/resourceful/request.rb", "lib/resourceful/resource.rb", "lib/resourceful/response.rb", "lib/resourceful/simple.rb", "lib/resourceful/stubbed_resource_proxy.rb", "lib/resourceful/urlencoded_form_data.rb", "lib/resourceful/util.rb"]
+  s.files = ["History.txt", "MIT-LICENSE", "Manifest", "README.markdown", "Rakefile", "lib/resourceful.rb", "lib/resourceful/abstract_form_data.rb", "lib/resourceful/authentication_manager.rb", "lib/resourceful/cache_manager.rb", "lib/resourceful/exceptions.rb", "lib/resourceful/header.rb", "lib/resourceful/http_accessor.rb", "lib/resourceful/memcache_cache_manager.rb", "lib/resourceful/multipart_form_data.rb", "lib/resourceful/net_http_adapter.rb", "lib/resourceful/request.rb", "lib/resourceful/resource.rb", "lib/resourceful/response.rb", "lib/resourceful/simple.rb", "lib/resourceful/stubbed_resource_proxy.rb", "lib/resourceful/urlencoded_form_data.rb", "lib/resourceful/util.rb", "resourceful.gemspec", "spec/acceptance/authorization_spec.rb", "spec/acceptance/caching_spec.rb", "spec/acceptance/header_spec.rb", "spec/acceptance/redirecting_spec.rb", "spec/acceptance/resource_spec.rb", "spec/acceptance_shared_specs.rb", "spec/caching_spec.rb", "spec/old_acceptance_specs.rb", "spec/resourceful/header_spec.rb", "spec/resourceful/http_accessor_spec.rb", "spec/resourceful/multipart_form_data_spec.rb", "spec/resourceful/resource_spec.rb", "spec/resourceful/response_spec.rb", "spec/resourceful/urlencoded_form_data_spec.rb", "spec/resourceful_spec.rb", "spec/simple_sinatra_server.rb", "spec/simple_sinatra_server_spec.rb", "spec/spec.opts", "spec/spec_helper.rb"]
   s.homepage = %q{http://github.com/paul/resourceful}
   s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Resourceful", "--main", "README.markdown"]
   s.require_paths = ["lib"]
@@ -25,7 +25,7 @@ Gem::Specification.new do |s|
     if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
       s.add_runtime_dependency(%q<addressable>, [">= 2.1.0"])
       s.add_runtime_dependency(%q<httpauth>, [">= 0"])
-      s.add_runtime_dependency(%q<options>, [">= 2.1.0"])
+      s.add_runtime_dependency(%q<options>, [">= 2.1.1"])
       s.add_development_dependency(%q<thin>, [">= 0"])
       s.add_development_dependency(%q<yard>, [">= 0"])
       s.add_development_dependency(%q<sinatra>, [">= 0"])
@@ -33,7 +33,7 @@ Gem::Specification.new do |s|
     else
       s.add_dependency(%q<addressable>, [">= 2.1.0"])
       s.add_dependency(%q<httpauth>, [">= 0"])
-      s.add_dependency(%q<options>, [">= 2.1.0"])
+      s.add_dependency(%q<options>, [">= 2.1.1"])
       s.add_dependency(%q<thin>, [">= 0"])
       s.add_dependency(%q<yard>, [">= 0"])
       s.add_dependency(%q<sinatra>, [">= 0"])
@@ -42,7 +42,7 @@ Gem::Specification.new do |s|
   else
     s.add_dependency(%q<addressable>, [">= 2.1.0"])
     s.add_dependency(%q<httpauth>, [">= 0"])
-    s.add_dependency(%q<options>, [">= 2.1.0"])
+    s.add_dependency(%q<options>, [">= 2.1.1"])
     s.add_dependency(%q<thin>, [">= 0"])
     s.add_dependency(%q<yard>, [">= 0"])
     s.add_dependency(%q<sinatra>, [">= 0"])

data/spec/resourceful_spec.rb

@@ -0,0 +1,79 @@
+require File.dirname(__FILE__) + "/spec_helper.rb"
+
+
+describe Resourceful do 
+  it "should have a default accessor" do 
+    Resourceful.default_accessor.should be_kind_of Resourceful::HttpAccessor
+  end
+
+  it "should delegate request making (minimal)" do 
+    stub_resource = mock(:resource)
+    Resourceful.default_accessor.should_receive(:resource).with( 'http://foo.invalid/bar').and_return(stub_resource)
+    stub_resource.should_receive(:request).with(:get, nil, {})
+                                                            
+    Resourceful.request(:get, 'http://foo.invalid/bar')
+  end
+
+  it "should delegate request making (with header)" do 
+    stub_resource = mock(:resource)
+    Resourceful.default_accessor.should_receive(:resource).with( 'http://foo.invalid/bar').and_return(stub_resource)
+    stub_resource.should_receive(:request).with(:get, nil, {:accept => :json})
+                                                            
+    Resourceful.request(:get, 'http://foo.invalid/bar', :accept => :json)
+  end
+
+  it "should delegate request making (with body)" do 
+    stub_resource = mock(:resource)
+    Resourceful.default_accessor.should_receive(:resource).with( 'http://foo.invalid/bar').and_return(stub_resource)
+    stub_resource.should_receive(:request).with(:get, 'body', {})
+                                                            
+    Resourceful.request(:get, 'http://foo.invalid/bar', {}, 'body')
+  end
+
+  it "should allow convenient get requests" do 
+    stub_resource = mock(:resource)
+    Resourceful.default_accessor.should_receive(:resource).with( 'http://foo.invalid/bar').and_return(stub_resource)
+    stub_resource.should_receive(:request).with(:get, nil, :header_marker)
+    
+    Resourceful.get 'http://foo.invalid/bar', :header_marker
+  end
+
+  it "should allow convenient head requests" do 
+    stub_resource = mock(:resource)
+    Resourceful.default_accessor.should_receive(:resource).with( 'http://foo.invalid/bar').and_return(stub_resource)
+    stub_resource.should_receive(:request).with(:head, nil, :header_marker)
+    
+    Resourceful.head 'http://foo.invalid/bar', :header_marker
+  end
+
+  it "should allow convenient delete requests" do 
+    stub_resource = mock(:resource)
+    Resourceful.default_accessor.should_receive(:resource).with( 'http://foo.invalid/bar').and_return(stub_resource)
+    stub_resource.should_receive(:request).with(:delete, nil, :header_marker)
+    
+    Resourceful.delete 'http://foo.invalid/bar', :header_marker
+  end
+
+  it "should allow convenient post requests" do 
+    stub_resource = mock(:resource)
+    Resourceful.default_accessor.should_receive(:resource).with( 'http://foo.invalid/bar').and_return(stub_resource)
+    stub_resource.should_receive(:request).with(:post, :body_marker, :header_marker)
+    
+    Resourceful.post 'http://foo.invalid/bar', :body_marker, :header_marker
+  end
+
+  it "should allow convenient put requests" do 
+    stub_resource = mock(:resource)
+    Resourceful.default_accessor.should_receive(:resource).with( 'http://foo.invalid/bar').and_return(stub_resource)
+    stub_resource.should_receive(:request).with(:put, :body_marker, :header_marker)
+    
+    Resourceful.put 'http://foo.invalid/bar', :body_marker, :header_marker
+  end
+
+
+  it "should allow new authenticators to be added to default accessor" do
+    Resourceful.default_accessor.should_receive(:add_authenticator).with(:my_authentcator_marker)
+    
+    Resourceful.add_authenticator(:my_authentcator_marker)
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: resourceful
 version: !ruby/object:Gem::Version 
-  version: 0.6.4
+  version: 1.0.0
 platform: ruby
 authors: 
 - Paul Sadauskas
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-09-29 00:00:00 -06:00
+date: 2010-01-26 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -40,7 +40,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 2.1.0
+        version: 2.1.1
     version: 
 - !ruby/object:Gem::Dependency 
   name: thin
@@ -89,6 +89,8 @@ executables: []
 extensions: []
 
 extra_rdoc_files: 
+- README.markdown
+- lib/resourceful.rb
 - lib/resourceful/abstract_form_data.rb
 - lib/resourceful/authentication_manager.rb
 - lib/resourceful/cache_manager.rb
@@ -101,13 +103,17 @@ extra_rdoc_files:
 - lib/resourceful/request.rb
 - lib/resourceful/resource.rb
 - lib/resourceful/response.rb
+- lib/resourceful/simple.rb
 - lib/resourceful/stubbed_resource_proxy.rb
 - lib/resourceful/urlencoded_form_data.rb
 - lib/resourceful/util.rb
-- lib/resourceful.rb
-- README.markdown
 files: 
 - History.txt
+- MIT-LICENSE
+- Manifest
+- README.markdown
+- Rakefile
+- lib/resourceful.rb
 - lib/resourceful/abstract_form_data.rb
 - lib/resourceful/authentication_manager.rb
 - lib/resourceful/cache_manager.rb
@@ -120,14 +126,10 @@ files:
 - lib/resourceful/request.rb
 - lib/resourceful/resource.rb
 - lib/resourceful/response.rb
+- lib/resourceful/simple.rb
 - lib/resourceful/stubbed_resource_proxy.rb
 - lib/resourceful/urlencoded_form_data.rb
 - lib/resourceful/util.rb
-- lib/resourceful.rb
-- Manifest
-- MIT-LICENSE
-- Rakefile
-- README.markdown
 - resourceful.gemspec
 - spec/acceptance/authorization_spec.rb
 - spec/acceptance/caching_spec.rb
@@ -143,6 +145,7 @@ files:
 - spec/resourceful/resource_spec.rb
 - spec/resourceful/response_spec.rb
 - spec/resourceful/urlencoded_form_data_spec.rb
+- spec/resourceful_spec.rb
 - spec/simple_sinatra_server.rb
 - spec/simple_sinatra_server_spec.rb
 - spec/spec.opts