refraction 0.1.2 → 0.1.3

data/README.md

@@ -40,6 +40,10 @@ Refraction can be installed in a Rails application as a plugin.
 
     $ script/plugin install git://github.com/pivotal/refraction.git
 
+It can also be used as a gem:
+
+    $ gem install refraction
+
 In `environments/production.rb`, add Refraction at or near the top of your middleware stack.
 
     config.middleware.insert_before(::Rack::Lock, ::Refraction, {})
@@ -102,6 +106,17 @@ The `found!` method tells Refraction to return a response with a `302 Found` sta
 URL for the Location header. Like `#rewrite!` it can take either a string or hash argument to set
 the URL or some of its components.
 
+### `RequestContext#respond!(status, headers, content)`
+
+Use `respond!` to return an arbitrary response to the request. This is useful for responding with
+the contents of a static file. For example:
+
+    req.respond!(503, {'Content-Type' => 'text/html'}, File.read(MAINTENANCE_PATH))
+
+The args are largely the same as the contents of a standard Rack response array with the exceptions
+that you don't need to wrap the content in an array, and the Content-Length header is generated so it
+should not be supplied.
+
 ### URL components
 
 The request object provides the following components of the URL for matching requests: `scheme`,

data/VERSION

@@ -1 +1 @@
-0.1.2
+0.1.3

data/lib/refraction.rb

@@ -26,12 +26,9 @@ class Refraction
     end
 
     def response
-      headers = {
-        'Location' => location,
-        'Content-Type' => 'text/plain',
-        'Content-Length' => message.length.to_s
-      }
-      [status, headers, message]
+      headers = @headers || { 'Location' => location, 'Content-Type' => 'text/plain' }
+      headers['Content-Length'] = message.length.to_s
+      [status, headers, [message]]
     end
 
     # URI part accessors
@@ -60,6 +57,15 @@ class Refraction
       @env['REQUEST_METHOD']
     end
 
+    # borrowed from Rack Request class, i.e. time to refactor
+    def ip
+      if addr = @env['HTTP_X_FORWARDED_FOR']
+        addr.split(',').last.strip
+      else
+        @env['REMOTE_ADDR']
+      end
+    end
+
     # actions
 
     def set(options)
@@ -95,6 +101,13 @@ class Refraction
       @message = "moved to #{@uri}"
     end
 
+    def respond!(status, headers, content)
+      @action = :respond
+      @status = status
+      @headers = headers
+      @message = content
+    end
+
     def location
       @uri.to_s
     end
@@ -124,7 +137,7 @@ class Refraction
       self.rules.call(context)
 
       case context.action
-      when :permanent, :found
+      when :permanent, :found, :respond
         context.response
       when :rewrite
         env["rack.url_scheme"]                 = context.scheme

data/refraction.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{refraction}
-  s.version = "0.1.0"
+  s.version = "0.1.3"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Pivotal Labs", "Josh Susser", "Sam Pierson", "Wai Lun Mang"]
-  s.date = %q{2009-10-29}
+  s.date = %q{2009-12-23}
   s.description = %q{Reflection is a Rails plugin and standalone Rack middleware library. Give up quirky config syntax and use plain old Ruby for your rewrite and redirection rules.}
   s.email = %q{gems@pivotallabs.com}
   s.extra_rdoc_files = [

data/spec/refraction_spec.rb

@@ -173,6 +173,24 @@ describe Refraction do
     end
   end
 
+  describe "generate arbitrary response" do
+    before(:each) do
+      Refraction.configure do |req|
+        req.respond!(503, {'Content-Type' => 'text/plain'}, "Site down for maintenance.")
+      end
+    end
+
+    it "should respond with status, headers and content" do
+      env = Rack::MockRequest.env_for('http://example.com', :method => 'get')
+      app = mock('app')
+      response = Refraction.new(app).call(env)
+      response[0].should == 503
+      response[1]['Content-Length'].to_i.should == "Site down for maintenance.".length
+      response[1]['Content-Type'].should == "text/plain"
+      response[2].should == ["Site down for maintenance."]
+    end
+  end
+
   describe "environment" do
     before(:each) do
       Refraction.configure do |req|

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: refraction
 version: !ruby/object:Gem::Version 
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors: 
 - Pivotal Labs
@@ -12,7 +12,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-11-13 00:00:00 -08:00
+date: 2009-12-23 00:00:00 -08:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency