rack-multiplexer 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8d1e0bdf595729dcdd3fac639b011df34a1b61c7
+  data.tar.gz: b65076613cb6838caadf1c331e95b45c2c5caed9
+SHA512:
+  metadata.gz: f07494becb8829ad92ec7162e1c13bf639f1d1ef6f24a4a66d53bf984d19962d1e0afd8de52d233953ef0f79ed01248cbfec6c32fad1bbf45afd7af5df02e3fb
+  data.tar.gz: 1fca83e571656bc8d76b62b61d9e2bc96a014cf29dafaa262c8db2d13e45d15c0dd89744003807f04e5eabb42ddb05b7114351d5d12333a15a2bac63574c1d9f

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in rack-multiplexer.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Ryo Nakamura
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,25 @@
+# Rack::Multiplexer
+Provides a simple router & dispatcher for Rack applications.
+
+## Installation
+```
+gem install rack-multiplexer
+```
+
+## Usage
+For `rackup`.
+
+```ruby
+# config.ru
+require "rack-multiplexer"
+
+multiplexer = Rack::Multiplexer.new
+multiplexer.get("/a", ->(env) { [200, {}, ["a"]] })
+multiplexer.get("/b", ->(env) { [200, {}, ["b"]] })
+multiplexer.post("/c", ->(env) { [200, {}, ["c"]] })
+multiplexer.put("/d", ->(env) { [200, {}, ["c"]] })
+multiplexer.delete("/e", ->(env) { [200, {}, ["c"]] })
+multiplexer.get("/f/:g", ->(env) { [200, {}, [env["rack.request.query_hash"]["g"]]] })
+
+run multiplexer
+```

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/config.ru

@@ -0,0 +1,11 @@
+require "rack-multiplexer"
+
+multiplexer = Rack::Multiplexer.new
+multiplexer.get("/a", ->(env) { [200, {}, ["a"]] })
+multiplexer.get("/b", ->(env) { [200, {}, ["b"]] })
+multiplexer.post("/c", ->(env) { [200, {}, ["c"]] })
+multiplexer.put("/d", ->(env) { [200, {}, ["c"]] })
+multiplexer.delete("/e", ->(env) { [200, {}, ["c"]] })
+multiplexer.get("/f/:g", ->(env) { [200, {}, [env["rack.request.query_hash"]["g"]]] })
+
+run multiplexer

data/lib/rack-multiplexer.rb

@@ -0,0 +1 @@
+require "rack/multiplexer"

data/lib/rack/multiplexer.rb

@@ -0,0 +1,105 @@
+require "rack/multiplexer/version"
+require "rack/request"
+
+module Rack
+  class Multiplexer
+    DEFAULT_NOT_FOUND_APPLICATION = ->(env) {
+      [
+        404,
+        {
+          "Content-Type" => "text/plain",
+          "Content-Length" => "0",
+        },
+        [""],
+      ]
+    }
+
+    def initialize(not_found_application = DEFAULT_NOT_FOUND_APPLICATION, &block)
+      @not_found_application = not_found_application
+      instance_eval(&block) if block
+    end
+
+    def call(env)
+      path = env["PATH_INFO"]
+      (
+        routes[env["REQUEST_METHOD"]].find {|route| route.match?(path) } ||
+        routes["ANY"].find {|route| route.match?(path) } ||
+        @not_found_application
+      ).call(env)
+    end
+
+    def get(pattern, application)
+      append("GET", pattern, application)
+    end
+
+    def post(pattern, application)
+      append("POST", pattern, application)
+    end
+
+    def put(pattern, application)
+      append("PUT", pattern, application)
+    end
+
+    def delete(pattern, application)
+      append("DELETE", pattern, application)
+    end
+
+    def any(pattern, application)
+      append("ANY", pattern, application)
+    end
+
+    def append(method, pattern, application)
+      routes[method] << Route.new(pattern, application)
+    end
+
+    # @routes are indexed by method.
+    def routes
+      @routes ||= Hash.new {|hash, key| hash[key] = [] }
+    end
+
+    def default_not_found_application
+      ->(env) {
+        [
+          404,
+          {
+            "Content-Type" => "text/plain",
+            "Content-Length" => 0,
+          },
+          [""],
+        ]
+      }
+    end
+
+    class Route
+      PLACEHOLDER_REGEXP = /:(\w+)/
+
+      def initialize(pattern, application)
+        @application = application
+        @regexp, @keys = compile(pattern)
+      end
+
+      def call(env)
+        request = Rack::Request.new(env)
+        data = @regexp.match(env["PATH_INFO"])
+        (data.size - 1).times {|i| request.update_param(@keys[i], data[i + 1]) }
+        @application.call(request.env)
+      end
+
+      def match?(path)
+        @regexp === path
+      end
+
+      def compile(pattern)
+        keys = []
+        segments = []
+        pattern.split("/").each do |segment|
+          segments << segment.gsub(PLACEHOLDER_REGEXP, "([^#?/]+)")
+          if key = Regexp.last_match(1)
+            keys << key
+          end
+        end
+        return Regexp.new("\\A#{segments.join(?/)}\\z"), keys
+      end
+    end
+  end
+end

data/lib/rack/multiplexer/version.rb

@@ -0,0 +1,5 @@
+module Rack
+  class Multiplexer
+    VERSION = "0.0.1"
+  end
+end

data/rack-multiplexer.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'rack/multiplexer/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "rack-multiplexer"
+  spec.version       = Rack::Multiplexer::VERSION
+  spec.authors       = ["Ryo Nakamura"]
+  spec.email         = ["r7kamura@gmail.com"]
+  spec.summary       = "Provides a simple router & dispatcher for Rack."
+  spec.homepage      = "https://github.com/r7kamura/rack-multiplexer"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "rack"
+  spec.add_dependency "rspec", ">= 2.14.1"
+  spec.add_development_dependency "activesupport", ">= 3.2.14"
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "rake"
+end

data/spec/rack/multiplexer_spec.rb

@@ -0,0 +1,105 @@
+require "spec_helper"
+require "active_support/core_ext/object/to_query"
+require "active_support/core_ext/object/try"
+
+describe Rack::Multiplexer do
+  let(:application) do
+    ->(env) {
+      [
+        200,
+        {},
+        ["#{env['PATH_INFO']}?#{env['rack.request.query_hash'].try(:to_param)}&#{env['QUERY_STRING']}"]
+      ]
+    }
+  end
+
+  let(:env) do
+    {
+      "SCRIPT_NAME" => "",
+      "SERVER_NAME" => "localhost",
+      "SERVER_PORT" => "80",
+      "rack.input" => StringIO.new(""),
+    }
+  end
+
+  describe "#call" do
+    context "with unrelated path request" do
+      it "sends request to default not found application" do
+        multiplexer = described_class.new
+        multiplexer.call(env.merge("REQUEST_METHOD" => "GET", "PATH_INFO" => "/a")).should == [
+          404,
+          { "Content-Type" => "text/plain", "Content-Length" => 0 },
+          [""],
+        ]
+      end
+    end
+
+    context "with custom not found application" do
+      it "sends request to custom not found application" do
+        multiplexer = described_class.new(->(env) { [404, {}, ["custom"]] })
+        multiplexer.call(env.merge("REQUEST_METHOD" => "GET", "PATH_INFO" => "/a")).should == [
+          404,
+          {},
+          ["custom"],
+        ]
+      end
+    end
+
+    context "with unrelated method" do
+      it "delegates to not found application" do
+        multiplexer = described_class.new
+        multiplexer.post("/a", application)
+        multiplexer.call(env.merge("REQUEST_METHOD" => "GET", "PATH_INFO" => "/a"))[0].should == 404
+      end
+    end
+
+    context "with related method" do
+      it "delegates to registered application" do
+        multiplexer = described_class.new
+        multiplexer.get("/a", application)
+        multiplexer.call(env.merge("REQUEST_METHOD" => "GET", "PATH_INFO" => "/a"))[0].should == 200
+      end
+    end
+
+    context "with 2 registered routes" do
+      it "delegates to first-registered application" do
+        multiplexer = described_class.new
+        multiplexer.get("/a", application)
+        multiplexer.get("/:any", application)
+        multiplexer.call(env.merge("REQUEST_METHOD" => "GET", "PATH_INFO" => "/a"))[2][0].should == "/a?&"
+      end
+    end
+
+    context "with path parameters pattern" do
+      it "delegates with rack.request.query_hash" do
+        multiplexer = described_class.new
+        multiplexer.get("/:any", application)
+        multiplexer.call(env.merge("REQUEST_METHOD" => "GET", "PATH_INFO" => "/a"))[2][0].should == "/a?any=a&"
+      end
+    end
+
+    context "with duplicated params in path & query string" do
+      it "delegates with rack.request.query_hash & QUERY_STRING" do
+        multiplexer = described_class.new
+        multiplexer.get("/:any", application)
+        multiplexer.call(
+          env.merge(
+            "REQUEST_METHOD" => "GET",
+            "PATH_INFO" => "/a",
+            "QUERY_STRING" => "any=b"
+          )
+        )[2][0].should == "/a?any=a&any=b"
+      end
+    end
+
+    context "with any routing" do
+      it "matches any method" do
+        multiplexer = described_class.new
+        multiplexer.any("/a", application)
+        multiplexer.call(env.merge("REQUEST_METHOD" => "GET", "PATH_INFO" => "/a"))[0].should == 200
+        multiplexer.call(env.merge("REQUEST_METHOD" => "POST", "PATH_INFO" => "/a"))[0].should == 200
+        multiplexer.call(env.merge("REQUEST_METHOD" => "HEAD", "PATH_INFO" => "/a"))[0].should == 200
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+$LOAD_PATH.unshift File.expand_path("../../lib", __FILE__)
+require "rack/multiplexer"
+
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+end

metadata

@@ -0,0 +1,143 @@
+--- !ruby/object:Gem::Specification
+name: rack-multiplexer
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Ryo Nakamura
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 3.2.14
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 3.2.14
+- !ruby/object:Gem::Dependency
+  name: bundler
+  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: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- r7kamura@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- config.ru
+- lib/rack-multiplexer.rb
+- lib/rack/multiplexer.rb
+- lib/rack/multiplexer/version.rb
+- rack-multiplexer.gemspec
+- spec/rack/multiplexer_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/r7kamura/rack-multiplexer
+licenses:
+- MIT
+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: Provides a simple router & dispatcher for Rack.
+test_files:
+- spec/rack/multiplexer_spec.rb
+- spec/spec_helper.rb
+has_rdoc: