keight 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: bc49bd013923bbf4714db247133b1dee371519d3
-  data.tar.gz: f5cda960b9bd0772aae79b835ceca64ae7470c5e
+  metadata.gz: 5674423ea6090c2163b9bff12f3ec5f2a1542dce
+  data.tar.gz: ecde3e22c5720bfd8be224b45bb3f2e28db092dc
 SHA512:
-  metadata.gz: 32ef664b317f9c4053f1bad16e61de02616bcec598d40eb566f278fcc9e87ac35511c6f031cd91a26fae2c06a9de088b2ee8db80530b7966473878f6e613c3d7
-  data.tar.gz: e45639182983542961cda6d1dfc9bdb7b4e6b282a235162a66dabe74da220bd0cdd46b177d5b4d2410a67ef48fc0d0bfa60dca17bf58fdf559a17b4f65eef4d6
+  metadata.gz: 0a976045af16e6ff169a3fe46decb0b9c0fe8d30ed4848dc8d5669298766c3651be375c2dc4690614f3b740c4b599ec209594d82203aaf3e3f05397f1eade1a3
+  data.tar.gz: 75720c41ec1250de00b5aeb2c1ed332b674d6c90e7a238bf4263fc1226caf9eedabb9c7d00ca1278f4a9d0609e9f59110d01e0b8e60f7e525d045e01bf744467

data/CHANGES.txt

@@ -0,0 +1,64 @@
+Changes
+=======
+
+
+Release 0.2.0 (2016-01-06)
+--------------------------
+
+* [change] `K8::RackApplication#mount()` is removed.
+  Use `K8::RackApplication.new([...])` instead.
+
+* [change] `k8rb init` is renamed to `k8rb project`.
+
+    $ k8rb project myapp1
+    $ cd myapp1
+
+* [enhance] Auto redirection support.
+  For example, `GET /books` is defined and `GET /books/` is requested,
+  then it will be redirected to `GET /books`.
+
+* [enhance] Performance improved for variable urlpath.
+
+* [enhance] Implement urlpath helpers.
+
+    p BookAPI[:do_update].method          #=> :PUT
+    p BookAPI[:do_update].urlpath(123)    #=> '/api/books/123'
+    p BookAPI[:do_update].form_action_attr(123)  #=> '/api/books/123?_method=PUT'
+
+* [change] `k8rb mapping` now prints output in text format, not YAML format.
+
+* [enhance] `k8rb mapping` supports `--format=FORMAT` option.
+
+    $ k8rb mapping --format=text   # or yaml/json/javascript/jquery/angular
+
+* [enhance] `k8rb` command supports `cdnjs` action which download JavaScript
+  libraries from cdnjs.com.
+
+    $ k8rb cdnjs                   # list library
+    $ k8rb cdnjs 'jquery*'         # search library
+    $ k8rb cdnjs jquery            # list versions
+    $ k8rb cdnjs jquery 2.1.4      # download library
+
+* [change] `k8rb init` command downloads jquery and modernizr from cdnjs.com.
+
+* [change] `K8::Mock` and `K8::TestApp` are removed.
+  Use rack-test_app gem instead.
+
+* [bugfix] Document fixed.
+
+* [internal] Remove `K8::ActionClassMapping`, 'K8::ActionRouter' and
+  'K8::ActionFinder' classes.
+
+* [internal] Define new class `K8::ActionMapping` instead of remove classes.
+
+
+Release 0.1.0 (2015-10-27)
+--------------------------
+
+* Public release
+
+
+Release 0.0.1 (2015-10-26)
+--------------------------
+
+* Test release

data/MIT-LICENSE

@@ -1,4 +1,4 @@
-$Copyright: copyright(c) 2014-2015 kuwata-lab.com all rights reserved $
+$Copyright: copyright(c) 2014-2016 kuwata-lab.com all rights reserved $
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -1,7 +1,7 @@
 Keight.rb README
 ================
 
-($Release: 0.1.0 $)
+($Release: 0.2.0 $)
 
 
 Overview
@@ -18,15 +18,15 @@ Benchmarks
 
 Measured with `app.call(env)` style in order to exclude server overhead:
 
-| FW      | Request            | sec/1000req | req/sec  |
-|:--------|:-------------------|------------:|---------:|
-| Rails   | GET /api/hello     |      7.5188 |    133.0 |
-| Rails   | GET /api/hello/123 |      8.0030 |    125.0 |
-| Sinatra | GET /api/hello     |      1.5034 |    665.2 |
-| Sinatra | GET /api/hello/123 |      1.6328 |    612.4 |
-| Rack    | GET /api/hello     |      0.0789 |  12674.3 |
-| Keight  | GET /api/hello     |      0.0773 |  12936.6 |
-| Keight  | GET /api/hello/123 |      0.1385 |   7220.2 |
+| Framework | Request            | usec/req | req/sec  |
+|:----------|:-------------------|---------:|---------:|
+| Rails     | GET /api/hello     |    738.7 |   1353.7 |
+| Rails     | GET /api/hello/123 |    782.2 |   1278.4 |
+| Sinatra   | GET /api/hello     |    144.1 |   6938.3 |
+| Sinatra   | GET /api/hello/123 |    158.4 |   6313.8 |
+| Rack      | GET /api/hello     |      9.9 | 101050.9 |
+| Keight    | GET /api/hello     |      7.6 | 132432.8 |
+| Keight    | GET /api/hello/123 |     10.6 |  94705.9 |
 
 * Ruby     2.2.3
 * Rails    4.2.4
@@ -48,7 +48,7 @@ $ export GEM_HOME=$PWD/gems
 $ export PATH=$GEM_HOME/bin:$PATH
 
 $ gem install keight
-$ vi hello.rb
+$ vi hello.rb      # see below
 $ vi config.ru     # != 'config.rb'
 $ rackup -p 8000 config.ru
 ```
@@ -81,44 +81,46 @@ class HelloAction < K8::Action
 end
 ```
 
-config.rb:
+config.ru:
 
 ```ruby
 # -*- coding: utf-8 -*-
 require 'keight'
 require './hello'
 
-app = K8::RackApplication.new()
-app.mount '/hello', HelloAction
-
-### or
-#mapping = [
-#  ['/api', [
-#    ['/hello'         , "./hello:HelloAction"],
-#  ]],
-#]
-#app = K8::RackApplication.new(mapping)
+mapping = [
+  ['/api', [
+    ['/hello'     , HelloAction],
+    ## or
+    #['/hello'    , "./hello:HelloAction"],
+  ]],
+]
+app = K8::RackApplication.new(mapping)
 
 run app
 ```
 
-Open http://localhost:8000/hello or http://localhost:8000/hello/123
+Open http://localhost:8000/api/hello or http://localhost:8000/api/hello/123
 with your browser.
 
-Do you like it? If so, try `k8rb init myapp1` to generate project skeleton.
+Do you like it? If so, try `k8rb project myapp1` to generate project skeleton.
 
 ```console
-$ k8rb init myapp1
+$ mkdir gems                         # if necessary
+$ export GEM_HOME=$PWD/gems          # if necessary
+$ export PATH=$GEM_HOME/bin:$PATH    # if necessary
+$ gem install -N keight
+$ k8rb help                          # show help
+$ k8rb project myapp1                # create new project
 $ cd myapp1/
+$ rake setup                         # install gems and download libs
 $ export APP_ENV=dev    # 'dev', 'prod', or 'stg'
-$ k8rb mapping
-$ k8rb configs
-$ rackup -p 8000 -E production config.ru
-$ open http://127.0.0.1:8000/
-$ ab -n 1000 -c 10 http://127.0.0.1:8000/api/hello
-## or:
-$ gem install puma
-$ rackup -p 8000 -E production -s puma config.ru
+$ k8rb help mapping
+$ k8rb mapping                       # list urlpath mappings
+$ k8rb mapping --format=javascript   # or jquery,angular,json,yaml
+$ k8rb configs                       # list config parameters
+$ rake server port=8000
+$ open http://localhost:8000/
 $ ab -n 10000 -c 100 http://localhost:8000/api/hello
 ```
 
@@ -132,8 +134,8 @@ require 'keight'
 class HelloAction < K8::Action
 
   ## mapping
-  mapping '',    :GET=>:do_hello_world
-  mapping '/{name:[a-zA-Z]+}',   :GET=>:do_hello
+  mapping '',              :GET=>:do_hello_world
+  mapping '/{name:\w+}',   :GET=>:do_hello
 
   ## request, response, and helpers
 
@@ -199,7 +201,7 @@ class HelloAction < K8::Action
   end
 
   def handle_exception(ex)   # exception handler
-    meth = "on_#{ex.class}"
+    meth = "on_#{ex.class.name}"
     return __send__(meth, ex) if respond_to?(meth)
     super
   end
@@ -227,6 +229,144 @@ opts = {
   urlpath_cache_size:  0,    # 0 means cache disabled
 }
 app = K8::RackApplication.new(urlpath_mapping, opts)
+
+## misc
+p HelloAction[:do_update].method        #=> :GET
+p HelloAction[:do_update].urlpath(123)  #=> "/api/books/123"
+p HelloAction[:do_update].form_action_attr(123)
+                                        #=> "/api/books/123?_method=PUT"
+```
+
+
+Topics
+------
+
+
+### Make Routing More Faster
+
+Specify `urlpath_cache_size: n` (where n is 100 or so) to
+`K8::RackApplication.new()`.
+
+```ruby
+urlpath_mapping = [
+  ....
+]
+rack_app = K8::RackApplication.new(urlpath_mapping,
+                                   urlpath_cache_size: 100)  # !!!
+```
+
+In general, there are two type of URL path pattern: fixed and variable.
+
+* Fixed URL path pattern doesn't contain any URL path parameter.<br>
+  Example: `/`, `/api/books`, `/api/books/new`.
+* Variable URL path pattern contains one or more URL path parameters.<br>
+  Example: `/api/books/{id}`, `/api/books/new.{format:html|json}`.
+
+Keight.rb caches fixed patterns and doesn't variable ones, therefore
+routing for fixed URL path is faster than variable one.
+
+If `urlpath_cache_size: n` is specified, Keight.rb caches latest `n` entries
+of request path matched to variable URL path pattern.
+This will make routing for variable one much faster.
+
+
+### Default Pattern of URL Path Parameter
+
+URL path parameter `{id}` and `{xxx_id}` are regarded as `{id:\d+}` and
+`{xxx_id:\d+}` respectively and converted into positive interger automatically.
+For example:
+
+```ruby
+class BooksAction < K8::Action
+  mapping '/{id}', :GET=>:do_show
+  def do_show(id)
+    p id.class    #=> Fixnum
+    ....
+  end
+end
+```
+
+URL path parameter `{date}` and `{xxx_date}` are regarded as
+`{date:\d\d\d\d-\d\d-\d\d}` and `{xxx_date:\d\d\d\d-\d\d-\d\d}` respectively
+and converted into Date object automatically.
+For example:
+
+```ruby
+class BlogAPI < K8::Action
+  mapping '/{date}', :GET=>:list_entries
+  def list_entries(date)
+    p date.class    #=> Date
+    ....
+  end
+end
+```
+
+**If you specify `{id:\d+}` or `{date:\d\d\d\d-\d\d-\d\d}` explicitly,
+URL path parameter value is not converted into integer nor Date object.**
+In other words, you can cancel automatic conversion by specifing regular
+expression of URL path parameters.
+
+
+### Nested Routing
+
+```ruby
+urlpath_mapping = [
+    ['/api', [
+        ['/books'                      , BookAPI],
+        ['/books/{book_id}/comments'   , BookCommentsAPI],
+    ]],
+]
+```
+
+
+### URL Path Helpers
+
+```ruby
+p BooksAPI[:do_index].method          #=> :GET
+p BooksAPI[:do_index].urlpath()       #=> "/api/books"
+
+p BooksAPI[:do_update].method         #=> :PUT
+p BooksAPI[:do_update].urlpath(123)   #=> "/api/books/123"
+p BooksAPI[:do_update].form_action_attr(123)   #=> "/api/books/123?_method=PUT"
+```
+
+(Notice that these are availabe after `K8::RackApplication` object is created.)
+
+
+### Routing for JavaScript
+
+Keight.rb can generate JavaScript routing file.
+
+```console
+$ k8rb project myapp1
+$ cd myapp1/
+$ k8rb mapping --format=javascript | less  # or 'jquery', 'angular'
+$ mkdir -p static/js
+$ jsfile=static/js/urlpath_mapping.js
+$ rm -f $jsfile
+$ echo 'var Mapping = {'           >> $jsfile
+$ k8rb mapping --format=javascript >> $jsfile
+$ echo '};'                        >> $jsfile
+```
+
+
+### Download JavaScript Libraries
+
+Keight.rb can download Javascript or CSS libraries from [cdnjs.com].
+It is good idea to make layout of JavaScript libraries to be same as CDN.
+
+[cdnjs.com]: https://cdnjs.com/
+
+```console
+$ k8rb project myapp1
+$ cd myapp1/
+$ k8rb help cdnjs
+$ k8rb cdnjs                 # list libraries
+$ k8rb cdnjs 'jquery*'       # search libraries
+$ k8rb cdnjs jquery          # list versions
+$ k8rb cdnjs jquery 2.1.4    # download library
+## or
+$ k8rb cdnjs --basedir=static/lib jquery 2.1.4
 ```
 
 
@@ -242,17 +382,17 @@ I don't think Keight.rb is so fast. Other frameworks are just too slow.
 
 #### How to setup template engine?
 
-Try `k8rb init myapp1; cd myapp1; less app/action.rb`.
+Try `k8rb project myapp1; cd myapp1; less app/action.rb`.
 
 
 #### How to support static files?
 
-Try `k8rb init myapp1; cd myapp1; less app/action.rb`.
+Try `k8rb project myapp1; cd myapp1; less app/action.rb`.
 
 
 #### How to setup session?
 
-Try `k8rb init myapp1; cd myapp1; less config.ru`.
+Try `k8rb project myapp1; cd myapp1; less config.ru`.
 
 
 #### Can I use Rack::Request and Rack::Response instead of Keight's?
@@ -260,24 +400,9 @@ Try `k8rb init myapp1; cd myapp1; less config.ru`.
 Try `K8::REQUEST_CLASS = Rack::Request; K8::RESPONSE_CLASS = Rack::Response`.
 
 
-#### What `urlpath_cache_size: 0` means?
-
-`K8::RackApplication` can take `urlpath_cache_size: n` keyword arugment.
-
-* If `n == 0` then Keight.rb doesn't cache urlpath mapping containig
-  urlpath parameters such as `/api/books/{id}`.
-* If `n > 0` then Keight.rb caches latest `n` entries of urlpath mapping
-  containing urlpath parameters.
-* Keight.rb always caches urlpath mapping which has no urlpath parameters.
-  For example, `/api/books` is always cached regardless
-  `urlpath_cache_size:` value.
-
-If you need more performance, try `urlpath_cache_size: 1000` or so.
-
-
 License and Copyright
 ---------------------
 
 $License: MIT License $
 
-$Copyright: copyright(c) 2014-2015 kuwata-lab.com all rights reserved $
+$Copyright: copyright(c) 2014-2016 kuwata-lab.com all rights reserved $

data/Rakefile

@@ -3,7 +3,7 @@
 ###
 
 RELEASE   = ENV['rel'] || '0.0.0'
-COPYRIGHT = 'copyright(c) 2014-2015 kuwata-lab.com all rights reserved'
+COPYRIGHT = 'copyright(c) 2014-2016 kuwata-lab.com all rights reserved'
 LICENSE   = 'MIT License'
 
 PROJECT   = 'keight'

data/bench/bench.rb

@@ -2,13 +2,31 @@
 
 $LOAD_PATH << '.'
 
-require 'rack'
-require 'sinatra/base'     rescue nil
-require 'rack-multiplexer' rescue nil
-require 'keight'           rescue nil
+def _version(cmdopt)
+  if cmdopt == '0'
+    return nil
+  end
+  begin
+    return yield
+  rescue LoadError
+    if cmdopt.to_s.empty?
+      return nil
+    else
+      raise
+    end
+  end
+end
+
+version_rack = _version($rack) { require 'rack'            ; Rack.release }
+version_sina = _version($sina) { require 'sinatra/base'    ; Sinatra::VERSION }
+version_mplx = _version($mplx) { require 'rack/multiplexer'; Rack::Multiplexer::VERSION }
+version_k8   = _version($k8  ) { require 'keight'          ; K8::RELEASE }
+version_jet  = _version($jet ) { require 'rack/jet_router' ; Rack::JetRouter::RELEASE }
 
+$api_entries = ('a'..'z').each_with_index.map {|x, i| "%s%02d" % [x*3, i+1] }
 
-if defined?(Rack)
+
+if version_rack
 
   class RackApp1
     def call(env)
@@ -48,14 +66,15 @@ if defined?(Rack)
 end
 
 
-$api_entries   = %w[books authors account orders ranking about news support]
-$admin_entries = ('a'..'z').each_with_index.collect {|c,i| "%s%02d" % [c*3, i+1] }
-
-
-if defined?(Sinatra)
+if version_sina
 
   class SinaApp < Sinatra::Base
 
+    set :sessions   , false
+    set :logging    , false
+    set :protection , false
+    set :x_cascade  , false
+
     for x in $api_entries
       get    "/api/#{x}"          do "<h1>index</h1>"  end
       post   "/api/#{x}"          do "<h1>create</h1>" end
@@ -66,14 +85,6 @@ if defined?(Sinatra)
       #get    "/api/#{x}/:id/edit" do "<h1>edit</h1>"   end
     end
 
-    for x in $admin_entries   # 'aaa01', 'bbb02', ..., 'zzz26'
-      get    "/admin/#{x}"        do '<p>index</p>'    end
-      post   "/admin/#{x}"        do '<p>create</p>'   end
-      get    "/admin/#{x}/:id"    do '<p>show</p>'     end
-      put    "/admin/#{x}/:id"    do '<p>update</p>'   end
-      delete "/admin/#{x}/:id"    do '<p>delete</p>'   end
-    end
-
   end
 
   sina_app = SinaApp.new
@@ -81,67 +92,35 @@ if defined?(Sinatra)
 end
 
 
-if defined?(Rack::Multiplexer)
-
-  mplx_dummy = proc {|env|
-    [200, {"Content-Type"=>"text/html"}, ["<h1>hello</h1>"]]
-    #req  = Rack::Request.new(env)
-    #resp = Rack::Response.new
-    #[resp.status, resp.headers, ["<h1>index</h1>"]]
-  }
-
-  mplx_app1 = Rack::Multiplexer.new
-
-  for x in $api_entries
-    mplx_app1.get    "/api/#{x}",           mplx_dummy
-    mplx_app1.post   "/api/#{x}",           mplx_dummy
-    #mplx_app1.get    "/api/#{x}/new",       mplx_dummy
-    mplx_app1.get    "/api/#{x}/:id",       mplx_dummy
-    mplx_app1.post   "/api/#{x}/:id",       mplx_dummy
-    mplx_app1.delete "/api/#{x}/:id",       mplx_dummy
-    #mplx_app1.get    "/api/#{x}/:id/edit",  mplx_dummy
-  end
-  for x in $admin_entries   # 'aaa01', 'bbb02', ..., 'zzz26'
-    mplx_app1.get    "/admin/#{x}",         mplx_dummy
-    mplx_app1.post   "/admin/#{x}",         mplx_dummy
-    mplx_app1.get    "/admin/#{x}/:id",     mplx_dummy
-    mplx_app1.put    "/admin/#{x}/:id",     mplx_dummy
-    mplx_app1.delete "/admin/#{x}/:id",     mplx_dummy
-  end
+if version_mplx
 
-  mplx_api = Rack::Multiplexer.new
-  for x in $api_entries
-    mplx_api.get    "/api/#{x}",           mplx_dummy
-    mplx_api.post   "/api/#{x}",           mplx_dummy
-   #mplx_api.get    "/api/#{x}/new",       mplx_dummy
-    mplx_api.get    "/api/#{x}/:id",       mplx_dummy
-    mplx_api.post   "/api/#{x}/:id",       mplx_dummy
-    mplx_api.delete "/api/#{x}/:id",       mplx_dummy
-   #mplx_api.get    "/api/#{x}/:id/edit",  mplx_dummy
-  end
-  mplx_admin = Rack::Multiplexer.new
-  for x in $admin_entries   # 'aaa01', 'bbb02', ..., 'zzz26'
-    mplx_admin.get    "/admin/#{x}",         mplx_dummy
-    mplx_admin.post   "/admin/#{x}",         mplx_dummy
-    mplx_admin.get    "/admin/#{x}/:id",     mplx_dummy
-    mplx_admin.put    "/admin/#{x}/:id",     mplx_dummy
-    mplx_admin.delete "/admin/#{x}/:id",     mplx_dummy
-  end
-  mplx_app2 = proc {|env|
-    urlpath = env['PATH_INFO']
-    if urlpath.start_with?('/api')
-      mplx_api.call(env)
-    elsif urlpath.start_with?('/admin')
-      mplx_admin.call(env)
-    else
-      [404, {}, []]
+  mplx_app = proc {
+    #
+    proc_ = proc {|env|
+      [200, {"Content-Type"=>"text/html"}, ["<h1>hello</h1>"]]
+      #req  = Rack::Request.new(env)
+      #resp = Rack::Response.new
+      #[resp.status, resp.headers, ["<h1>index</h1>"]]
+    }
+    #
+    app = Rack::Multiplexer.new
+    for x in $api_entries
+      app.get    "/api/#{x}",           proc_
+      app.post   "/api/#{x}",           proc_
+      #app.get    "/api/#{x}/new",       proc_
+      app.get    "/api/#{x}/:id",       proc_
+      app.post   "/api/#{x}/:id",       proc_
+      app.delete "/api/#{x}/:id",       proc_
+      #app.get    "/api/#{x}/:id/edit",  proc_
     end
-  }
+    #
+    app
+  }.call()
 
 end
 
 
-if defined?(K8)
+if version_k8
 
   class DummyAction < K8::Action
     mapping '',       :GET=>:do_index, :POST=>:do_create
@@ -157,37 +136,59 @@ if defined?(K8)
     def do_edit(id)     ; "<h1>edit</h1>"; end
   end
   #
-  k8_app_opts = {urlpath_cache_size: 0}
-  k8_app = K8::RackApplication.new(k8_app_opts)
-  k8_app.mount '/api', [
-    ['/books',   DummyAction],
-    ['/books/{id}/comments', DummyAction],
-    ['/authors', DummyAction],
-    ['/authors/{id}/comments', DummyAction],
-    ['/account', DummyAction],
-    ['/orders',  DummyAction],
-    ['/ranking', DummyAction],
-    ['/about',   DummyAction],
-    ['/news',    DummyAction],
-    ['/support', DummyAction],
-  ]
-  pairs = $admin_entries.collect {|x|  # 'aaa01', 'bbb02', ..., 'zzz26'
-    ["/#{x}", DummyAction]
-  }
-  k8_app.mount '/admin', pairs
-  #
-  k8_app.find('/')     # warm up
+  k8_app = proc {
+    mapping = [
+      ['/api', $api_entries.map {|x| ["/#{x}", DummyAction] }],
+    ]
+    opts = {
+      urlpath_cache_size: ($k8size || 0).to_i,
+      enable_urlpath_param_range: $k8range != '0',
+    }
+    K8::RackApplication.new(mapping, opts)
+  }.call()
+
+end
+
+
+if version_jet
+
+  jet_app = proc {
+    #
+    jet_proc = proc {|env|
+      [200, {"Content-Type"=>"text/html"}, ["<h1>hello</h1>"]]
+      #req  = Rack::Request.new(env)
+      #resp = Rack::Response.new
+      #[resp.status, resp.headers, ["<h1>index</h1>"]]
+    }
+    methods1 = {:GET=>jet_proc, :POST=>jet_proc}
+    methods2 = {:GET=>jet_proc, :PUT=>jet_proc, :DELETE=>jet_proc}
+    #
+    arr = $api_entries.map {|x| ["/#{x}", [['', methods1], ['/:id', methods2]]] }
+    jet_mapping = [
+        ['/api', $api_entries.map {|x| ["/#{x}", [
+                                           ['',     methods1],
+                                           ['/:id', methods2],
+                                       ]] }
+        ],
+    ]
+    #
+    jet_opts = {
+      urlpath_cache_size: ($jetcache || 0).to_i,
+      enable_urlpath_param_range: $jetrange != '0',
+    }
+    #
+    Rack::JetRouter.new(jet_mapping, jet_opts)
+  }.call()
 
 end
 
 
 def _chk(tuple)
   tuple[0] == 200  or raise "200 expected but got #{tuple[0]}"
-  GC.start
 end
 
-$environ = Rack::MockRequest.env_for("http://localhost/")
-$environ['REQUEST_METHOD'] = 'GET'
+require 'rack' unless defined?(Rack)
+$environ = Rack::MockRequest.env_for("http://localhost/", method: 'GET')
 
 def newenv(path)
   env = $environ.dup
@@ -198,21 +199,27 @@ end
 
 require 'benchmarker'
 
+N = ($N || 100000).to_i
 
-Benchmarker.new(:width=>30, :loop=>100000) do |bm|
-
-  flag_rack = flag_sinatra = flag_multiplexer = flag_keight = false
-  flag_rack        = defined?(Rack)
-  #flag_sinatra     = defined?(Sinatra)
-  flag_multiplexer = defined?(Rack::Multiplexer)
-  flag_keight      = defined?(K8)
-
-  urlpaths = %w[/api/books /api/books/123 /api/support /api/support/123
-                /admin/aaa01 /admin/aaa01/123 /admin/zzz26 /admin/zzz26/123]
+Benchmarker.new(:width=>30, :loop=>N) do |bm|
 
+  urlpaths = [
+    '/api/aaa01',
+    '/api/aaa01/123',
+    '/api/zzz26',
+    '/api/zzz26/789',
+  ]
 
   tuple = nil
 
+  puts ""
+  puts "** rack            : #{version_rack || '-'}"
+  puts "** rack-jet_router : #{version_jet  || '-'}"
+  puts "** rack-multiplexer: #{version_mplx || '-'}"
+  puts "** sinatra         : #{version_sina || '-'}"
+  puts "** keight          : #{version_k8   || '-'}"
+  puts ""
+  puts "** N=#{N}"
 
   ### empty task
 
@@ -222,10 +229,11 @@ Benchmarker.new(:width=>30, :loop=>100000) do |bm|
 
 
   ### Rack
-  if flag_rack
+  if version_rack
+    rack_labels = ['Rack', 'R:Rq', 'R:Rs', 'RqRs']
     rack_apps = [rack_app1, rack_app2, rack_app3, rack_app4]
-    for rack_app, i in rack_apps.each_with_index
-      bm.task("(Rack#{i+1}) /some/where") do
+    for rack_app, label in rack_apps.zip(rack_labels)
+      bm.task("(#{label}) /some/where") do
         tuple = rack_app.call(newenv("/some/where"))
       end
       _chk(tuple)
@@ -234,7 +242,7 @@ Benchmarker.new(:width=>30, :loop=>100000) do |bm|
 
 
   ### Sinatra
-  if flag_sinatra
+  if version_sina
     for upath in urlpaths
       bm.task("(Sina) #{upath}") do
         tuple = sina_app.call(newenv(upath))
@@ -245,34 +253,126 @@ Benchmarker.new(:width=>30, :loop=>100000) do |bm|
 
 
   ### Rack::Multiplexer
-  if flag_multiplexer
+  if version_mplx
     for upath in urlpaths
       bm.task("(Mplx) #{upath}") do
-        tuple = mplx_app1.call(newenv(upath))
+        tuple = mplx_app.call(newenv(upath))
       end
       _chk(tuple)
     end
   end
 
-  if flag_multiplexer
+
+  ### Keight
+
+  if version_k8
     for upath in urlpaths
-      bm.task("(Mplx') #{upath}") do
-        tuple = mplx_app2.call(newenv(upath))
+      bm.task("(K8  ) #{upath}") do
+        tuple = k8_app.call(newenv(upath))
       end
       _chk(tuple)
     end
   end
 
 
-  ### Keight
+  ### Rack::JetRouter
 
-  if flag_keight
+  if version_jet
     for upath in urlpaths
-      bm.task("(K8) #{upath}") do
-        tuple = k8_app.call(newenv(upath))
+      bm.task("(JetR) #{upath}") do
+        tuple = jet_app.call(newenv(upath))
       end
       _chk(tuple)
     end
   end
 
 end
+
+
+__END__
+
+###
+### Example result
+###
+
+$ ruby -I../lib -I. -s bench.rb -N=1000000
+
+benchmarker.rb:   release 0.0.0
+RUBY_VERSION:     2.3.0
+RUBY_PATCHLEVEL:  0
+RUBY_PLATFORM:    x86_64-darwin15
+
+** rack            : 1.6.4
+** rack-jet_router : 1.1.0
+** rack-multiplexer: 0.0.8
+** sinatra         : 1.4.6
+** keight          : 0.2.0
+
+** N=1000000
+
+##                                  user       sys     total      real
+(Empty)                           7.3000    0.0900    7.3900    7.4131
+(Rack) /some/where                0.8400   -0.0400    0.8000    0.7903
+(R:Rq) /some/where                0.8400   -0.0500    0.7900    0.7743
+(R:Rs) /some/where                6.1600   -0.0500    6.1100    6.0898
+(RqRs) /some/where                6.4200   -0.0600    6.3600    6.3407
+(Sina) /api/aaa01                84.5700   18.0800  102.6500  102.7069
+(Sina) /api/aaa01/123            94.1300   18.4800  112.6100  112.6892
+(Sina) /api/zzz26               125.7300   19.0800  144.8100  145.0454
+(Sina) /api/zzz26/789           133.8000   18.9600  152.7600  152.9070
+(Mplx) /api/aaa01                 5.0200    0.1700    5.1900    5.1821
+(Mplx) /api/aaa01/123            16.7100    0.3100   17.0200   17.0086
+(Mplx) /api/zzz26                23.3700   -0.0400   23.3300   23.3190
+(Mplx) /api/zzz26/789            35.6500    0.0100   35.6600   35.6661
+(K8  ) /api/aaa01                 5.9200    0.0300    5.9500    5.9423
+(K8  ) /api/aaa01/123             9.2200    0.0900    9.3100    9.2934
+(K8  ) /api/zzz26                 6.2700    0.0600    6.3300    6.3158
+(K8  ) /api/zzz26/789            10.0300    0.1300   10.1600   10.1547
+(JetR) /api/aaa01                 1.1800    0.0400    1.2200    1.2154
+(JetR) /api/aaa01/123             5.0400    0.1100    5.1500    5.1431
+(JetR) /api/zzz26                 0.9600    0.0300    0.9900    0.9681
+(JetR) /api/zzz26/789             5.6900    0.1100    5.8000    5.7946
+
+## Ranking                          real
+(R:Rq) /some/where                0.7743 (100.0%) ********************
+(Rack) /some/where                0.7903 ( 98.0%) ********************
+(JetR) /api/zzz26                 0.9681 ( 80.0%) ****************
+(JetR) /api/aaa01                 1.2154 ( 63.7%) *************
+(JetR) /api/aaa01/123             5.1431 ( 15.1%) ***
+(Mplx) /api/aaa01                 5.1821 ( 14.9%) ***
+(JetR) /api/zzz26/789             5.7946 ( 13.4%) ***
+(K8  ) /api/aaa01                 5.9423 ( 13.0%) ***
+(R:Rs) /some/where                6.0898 ( 12.7%) ***
+(K8  ) /api/zzz26                 6.3158 ( 12.3%) **
+(RqRs) /some/where                6.3407 ( 12.2%) **
+(K8  ) /api/aaa01/123             9.2934 (  8.3%) **
+(K8  ) /api/zzz26/789            10.1547 (  7.6%) **
+(Mplx) /api/aaa01/123            17.0086 (  4.6%) *
+(Mplx) /api/zzz26                23.3190 (  3.3%) *
+(Mplx) /api/zzz26/789            35.6661 (  2.2%)
+(Sina) /api/aaa01               102.7069 (  0.8%)
+(Sina) /api/aaa01/123           112.6892 (  0.7%)
+(Sina) /api/zzz26               145.0454 (  0.5%)
+(Sina) /api/zzz26/789           152.9070 (  0.5%)
+
+## Matrix                           real     [01]     [02]     [03]     [04]     [05]     [06]     [07]     [08]     [09]     [10]     [11]     [12]     [13]     [14]     [15]     [16]     [17]     [18]     [19]     [20]
+[01] (Rack2) /some/where          0.7743   100.0%   102.1%   125.0%   157.0%   664.2%   669.2%   748.3%   767.4%   786.5%   815.6%   818.9%  1200.2%  1311.4%  2196.6%  3011.5%  4606.1% 13264.0% 14553.1% 18731.7% 19747.0%
+[02] (Rack1) /some/where          0.7903    98.0%   100.0%   122.5%   153.8%   650.7%   655.7%   733.2%   751.9%   770.5%   799.1%   802.3%  1175.9%  1284.8%  2152.1%  2950.5%  4512.7% 12995.2% 14258.3% 18352.2% 19346.9%
+[03] (JetR) /api/zzz26            0.9681    80.0%    81.6%   100.0%   125.5%   531.2%   535.3%   598.5%   613.8%   629.0%   652.4%   654.9%   959.9%  1048.9%  1756.9%  2408.7%  3684.0% 10608.8% 11639.9% 14982.1% 15794.1%
+[04] (JetR) /api/aaa01            1.2154    63.7%    65.0%    79.7%   100.0%   423.2%   426.4%   476.8%   488.9%   501.0%   519.6%   521.7%   764.6%   835.5%  1399.4%  1918.6%  2934.5%  8450.4%  9271.7% 11933.8% 12580.6%
+[05] (JetR) /api/aaa01/123        5.1431    15.1%    15.4%    18.8%    23.6%   100.0%   100.8%   112.7%   115.5%   118.4%   122.8%   123.3%   180.7%   197.4%   330.7%   453.4%   693.5%  1997.0%  2191.1%  2820.2%  2973.1%
+[06] (Mplx) /api/aaa01            5.1821    14.9%    15.3%    18.7%    23.5%    99.2%   100.0%   111.8%   114.7%   117.5%   121.9%   122.4%   179.3%   196.0%   328.2%   450.0%   688.3%  1982.0%  2174.6%  2799.0%  2950.7%
+[07] (JetR) /api/zzz26/789        5.7946    13.4%    13.6%    16.7%    21.0%    88.8%    89.4%   100.0%   102.5%   105.1%   109.0%   109.4%   160.4%   175.2%   293.5%   402.4%   615.5%  1772.5%  1944.7%  2503.1%  2638.8%
+[08] (K8) /api/aaa01              5.9423    13.0%    13.3%    16.3%    20.5%    86.6%    87.2%    97.5%   100.0%   102.5%   106.3%   106.7%   156.4%   170.9%   286.2%   392.4%   600.2%  1728.4%  1896.4%  2440.9%  2573.2%
+[09] (Rack3) /some/where          6.0898    12.7%    13.0%    15.9%    20.0%    84.5%    85.1%    95.2%    97.6%   100.0%   103.7%   104.1%   152.6%   166.7%   279.3%   382.9%   585.7%  1686.5%  1850.5%  2381.8%  2510.9%
+[10] (K8) /api/zzz26              6.3158    12.3%    12.5%    15.3%    19.2%    81.4%    82.0%    91.7%    94.1%    96.4%   100.0%   100.4%   147.1%   160.8%   269.3%   369.2%   564.7%  1626.2%  1784.3%  2296.6%  2421.0%
+[11] (Rack4) /some/where          6.3407    12.2%    12.5%    15.3%    19.2%    81.1%    81.7%    91.4%    93.7%    96.0%    99.6%   100.0%   146.6%   160.2%   268.2%   367.8%   562.5%  1619.8%  1777.2%  2287.5%  2411.5%
+[12] (K8) /api/aaa01/123          9.2934     8.3%     8.5%    10.4%    13.1%    55.3%    55.8%    62.4%    63.9%    65.5%    68.0%    68.2%   100.0%   109.3%   183.0%   250.9%   383.8%  1105.2%  1212.6%  1560.7%  1645.3%
+[13] (K8) /api/zzz26/789         10.1547     7.6%     7.8%     9.5%    12.0%    50.6%    51.0%    57.1%    58.5%    60.0%    62.2%    62.4%    91.5%   100.0%   167.5%   229.6%   351.2%  1011.4%  1109.7%  1428.4%  1505.8%
+[14] (Mplx) /api/aaa01/123       17.0086     4.6%     4.6%     5.7%     7.1%    30.2%    30.5%    34.1%    34.9%    35.8%    37.1%    37.3%    54.6%    59.7%   100.0%   137.1%   209.7%   603.9%   662.5%   852.8%   899.0%
+[15] (Mplx) /api/zzz26           23.3190     3.3%     3.4%     4.2%     5.2%    22.1%    22.2%    24.8%    25.5%    26.1%    27.1%    27.2%    39.9%    43.5%    72.9%   100.0%   152.9%   440.4%   483.3%   622.0%   655.7%
+[16] (Mplx) /api/zzz26/789       35.6661     2.2%     2.2%     2.7%     3.4%    14.4%    14.5%    16.2%    16.7%    17.1%    17.7%    17.8%    26.1%    28.5%    47.7%    65.4%   100.0%   288.0%   316.0%   406.7%   428.7%
+[17] (Sina) /api/aaa01          102.7069     0.8%     0.8%     0.9%     1.2%     5.0%     5.0%     5.6%     5.8%     5.9%     6.1%     6.2%     9.0%     9.9%    16.6%    22.7%    34.7%   100.0%   109.7%   141.2%   148.9%
+[18] (Sina) /api/aaa01/123      112.6892     0.7%     0.7%     0.9%     1.1%     4.6%     4.6%     5.1%     5.3%     5.4%     5.6%     5.6%     8.2%     9.0%    15.1%    20.7%    31.6%    91.1%   100.0%   128.7%   135.7%
+[19] (Sina) /api/zzz26          145.0454     0.5%     0.5%     0.7%     0.8%     3.5%     3.6%     4.0%     4.1%     4.2%     4.4%     4.4%     6.4%     7.0%    11.7%    16.1%    24.6%    70.8%    77.7%   100.0%   105.4%
+[20] (Sina) /api/zzz26/789      152.9070     0.5%     0.5%     0.6%     0.8%     3.4%     3.4%     3.8%     3.9%     4.0%     4.1%     4.1%     6.1%     6.6%    11.1%    15.3%    23.3%    67.2%    73.7%    94.9%   100.0%