joshbuddy-rack-capabilities 0.0.2

data/README.rdoc

@@ -0,0 +1,49 @@
+= Rack::Capabilities
+
+== Usage
+
+  class CuriousMiddleware
+    def initialize(app)
+      @app = app
+    end
+
+    def curious?
+      true #and how!
+    end
+
+    def call(env)
+      # who is before me?
+      env['rack.capabilities'].before(self)
+      # returns Rack::Middleware2
+
+      # who is after me?
+      env['rack.capabilities'].after(self)
+      # returns Rack::Middleware4
+
+      # can I go find Rack::Middleware1?
+      env['rack.capabilities'].find(Rack::Middleware1)
+      # returns Rack::Middleware1
+
+      # or just find based on anything!
+      env['rack.capabilities'].find{|mw| mw.respond_to?(:curious?)}
+      # returns our friend, CuriousMiddleware
+
+      # And presumably you'd
+      # want to do stuff..
+      # but thats up to you
+
+      @app.call(env)
+    end
+
+  end
+
+  use Rack::Capabilities
+  use Rack::Middleware1
+  use Rack::Middleware2
+  use Rack::CuriousMiddleware
+  use Rack::Middleware4
+  use Rack::Middleware5
+
+== Caveats and Limitations
+
+Rack::Capabilities must be required (not autoloaded as it must monkey patch Rack::Builder). The rack.capabilities environment variable is *only* available at <tt>call</tt> time.

data/VERSION.yml

@@ -0,0 +1,4 @@
+--- 
+:major: 0
+:minor: 0
+:patch: 2

data/lib/rack/capabilities.rb

@@ -0,0 +1,52 @@
+class Rack::Builder
+  def use(middleware, *args, &block)
+    @capabilities ||= []
+    @ins << lambda { |app|
+      mw = middleware.new(app, *args, &block)
+      @capabilities.unshift(mw)
+      mw.list = @capabilities if Rack::Capabilities === mw
+      mw
+    }
+  end
+end
+
+module Rack
+
+  class Capabilities
+
+    attr_accessor :list
+
+    def initialize(app)
+      @app = app
+      @list = []
+    end
+
+    def call(env)
+      env['rack.capabilities'] = self
+      @app.call(env)
+    end
+
+    def each(&block)
+      list.each {|app| block.call(app) }
+    end
+
+    def find(clazz = nil, &block)
+      clazz ? list.find { |mw| clazz === mw } : list.find(&block)
+    end
+
+    def before(mw, distance = 1)
+      relative(mw, -distance)
+    end
+
+    def after(mw, distance = 1)
+      relative(mw, distance)
+    end
+
+    def relative(mw, pos)
+      index = list.index(mw)
+      index ? list[index + pos] : nil
+    end
+
+  end
+
+end

data/spec/rack_capabilities_spec.rb

@@ -0,0 +1,59 @@
+require 'spec_helper'
+
+GenericMiddleware = Class.new do
+  def initialize(app)
+    @app = app
+  end
+
+  def call(env)
+    @app.call(env)
+  end
+end
+
+GenericMiddleware1 = Class.new(GenericMiddleware)
+GenericMiddleware2 = Class.new(GenericMiddleware)
+GenericMiddleware3 = Class.new(GenericMiddleware)
+GenericMiddleware4 = Class.new(GenericMiddleware)
+GenericMiddleware5 = Class.new(GenericMiddleware)
+
+describe "Rack Capabilities" do
+
+  def app(&block)
+    @builder = Rack::Builder.new {
+      use Rack::Capabilities
+      use GenericMiddleware1
+      use GenericMiddleware2
+      use GenericMiddleware3
+      use GenericMiddleware4
+      use GenericMiddleware5
+      run lambda { |env| block[env]; [200, {}, []] }
+    }
+
+    @builder.call({})
+  end
+
+  it "should find a middleware by class" do
+    app do |env|
+      env['rack.capabilities'].find(GenericMiddleware3).class.should == GenericMiddleware3
+    end
+  end
+
+  it "should find a middleware by proc" do
+    app do |env|
+      env['rack.capabilities'].find{|mw| mw.class.to_s == 'GenericMiddleware2'}.class.should == GenericMiddleware2
+    end
+  end
+
+  it "should find a middleware before" do
+    app do |env|
+      env['rack.capabilities'].before(env['rack.capabilities'].find(GenericMiddleware3)).class.should == GenericMiddleware2
+    end
+  end
+
+  it "should find a middleware after" do
+    app do |env|
+      env['rack.capabilities'].after(env['rack.capabilities'].find(GenericMiddleware4)).class.should == GenericMiddleware5
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+require 'spec'
+require 'rubygems'
+require 'rack'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'rack/capabilities'
+
+Spec::Runner.configure do |config|
+
+end

metadata

@@ -0,0 +1,59 @@
+--- !ruby/object:Gem::Specification 
+name: joshbuddy-rack-capabilities
+version: !ruby/object:Gem::Version 
+  version: 0.0.2
+platform: ruby
+authors: 
+- Joshua Hull
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-05-09 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: 
+email: joshbuddy@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- README.rdoc
+- VERSION.yml
+- lib/rack
+- lib/rack/capabilities.rb
+- spec/rack_capabilities_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/joshbuddy/rack-capabilities
+post_install_message: 
+rdoc_options: 
+- --inline-source
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Discover rack middleware
+test_files: []
+