rack-app 7.5.1 → 7.5.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0fa1cbbfa3a7debe947b55c0f876563c3d41bc29
-  data.tar.gz: 7275baae82226050a885bfa29dafb205e41cedab
+  metadata.gz: 685044ceae379bb1f514e908eec4f1cf747b7410
+  data.tar.gz: 238ae60171c5a954598a548b6daeab3aa37a2595
 SHA512:
-  metadata.gz: 495a0e592d611f7ea125c85468efd76a5d254ff4d387e4115da8bf16a135e8779419d182b9eea9b92ab91bbeb7f89609edc2bcce4d9d8fe119e76b22c8e51da4
-  data.tar.gz: 043431aa915f8d5eaaabd78f2cb6f62cd95db9af21e5a14ad4356ad27ea293e86761e1b9d81e6951f46962f8fd97cc0103c87640feee8133470929e28f63bce8
+  metadata.gz: f03f8c6bd826cd76337141ae81894555b47a4c327478566df7481643256e11fc1922b9d410476375040371099a0e24881e3e4ed43faf9e35d29b0479fe0cad07
+  data.tar.gz: 1ecea638458f5af0e04659d774680ac7bc2e68def972046332082041198a3dcced104bf0fc91dd789c924ae5fb85743f380c9d23ce3f9270246af27342e10a85

data/README.md

@@ -94,6 +94,12 @@ Yes, in fact it's already powering heroku hosted micro-services.
   * note that this is not only memory friendly way pure rack solution, but also 2x faster than the usually solution which includes buffering in memory
 * params validation with ease
 
+## Under the hood
+
+rack-app's router relies on a tree structure which makes heavy use of *common prefixes*,
+it is basically a *compact* [*prefix tree*](https://en.wikipedia.org/wiki/Trie) (or just [*Radix tree*](https://en.wikipedia.org/wiki/Radix_tree)).
+Nodes with a common prefix also share a common parent.
+
 ## Contributors
 
 * **[Daniel Nagy](https://github.com/thilonel)**
@@ -112,12 +118,14 @@ Yes, in fact it's already powering heroku hosted micro-services.
 
   * [wrote an awesome article](https://www.sitepoint.com/rack-app-a-performant-and-pragmatic-web-microframework/) about the project
 
+* **[TheSmartnik](https://github.com/TheSmartnik)**
+
+  * Clarify examples in the documentation
+
 ## [Contributing](CONTRIBUTING.md)
 
 ## Usage
 
-config.ru
-
 #### basic
 
 ```ruby
@@ -143,8 +151,6 @@ require 'rack/app'
 
 class App < Rack::App
 
-  apply_extensions :front_end
-
   mount SomeAppClass
 
   headers 'Access-Control-Allow-Origin' => '*',
@@ -158,11 +164,12 @@ class App < Rack::App
   validate_params do
     required 'words', :class => Array, :of => String, :desc => 'some word', :example => ['pug']
     optional 'word', :class => String, :desc => 'one word', :example => 'pug'
+    optional 'boolean', :class => :boolean, :desc => 'boolean value', :example => true
   end
   get '/hello' do
-    puts(validate_params['words'])
+    puts(params['words'])
 
-    return 'Hello World!'
+    'Hello World!'
   end
 
   namespace '/users' do
@@ -206,6 +213,40 @@ Rack::Response as response method.
 
 By default if you dont write anything to the response 'body' the endpoint block logic return will be used
 
+### Frontend Example
+
+if you don't mind extend your dependency list, than you can use the front_end extension for creating template based web applications.
+
+```ruby
+require 'rack/app'
+require 'rack/app/front_end' # You need to add `gem 'rack-app-front_end'` to your Gemfile
+
+class App < Rack::App
+
+  apply_extensions :front_end
+
+  helpers do
+
+    def method_that_can_be_used_in_template
+      'hello world!'
+    end
+
+  end
+
+  # use ./app/layout.html.erb as layout, this is optionable
+  layout 'layout.html.erb'
+
+  # at '/' the endpoint will serve (render)
+  # the ./app/index.html content as response body and wrap around with layout if layout is given
+  get '/' do
+    render 'index.html'
+  end
+
+end
+```
+
+this example expects an "app" folder next to the "app.rb" file that included templates being used such as layout.html.erb and index.html.
+
 ## Testing
 
 for testing use rack/test or the bundled testing module for writing unit test for your rack application
@@ -223,7 +264,7 @@ describe App do
 
   describe '/hello' do
     # example for params and headers and payload use
-    subject{ get(url: '/hello', params: {'dog' => 'meat'}, headers: {'X-Cat' => 'fur'}, payload: 'some string') }
+    subject { get(url: '/hello', params: {'dog' => 'meat'}, headers: {'X-Cat' => 'fur'}, payload: 'some string') }
 
     it { expect(subject.status).to eq 200 }
 
@@ -232,7 +273,7 @@ describe App do
 
   describe '/users/:user_id' do
     # restful endpoint example
-    subject{ get(url: '/users/1234') }
+    subject { get(url: '/users/1234') }
 
     it { expect(subject.body).to eq 'hello 1234!'}
 
@@ -242,7 +283,7 @@ describe App do
 
   describe '/make_error' do
     # error handled example
-    subject{ get(url: '/make_error') }
+    subject { get(url: '/make_error') }
 
     it { expect(subject.body).to eq '{:error=>"error block rescued"}' }
   end

data/VERSION

@@ -1 +1 @@
-7.5.1
+7.5.2

data/lib/rack/app/middlewares/set_path_params.rb

@@ -1,7 +1,7 @@
 class Rack::App::Middlewares::SetPathParams
 
-  def initialize(app, params_lookup_hash)
-    @params_lookup_hash = params_lookup_hash
+  def initialize(app, build_env)
+    @build_env = build_env
     @app = app
   end
 
@@ -16,19 +16,21 @@ class Rack::App::Middlewares::SetPathParams
   protected
 
   def populate_path_params(env)
-    @params_lookup_hash.each do |index, key|
+    @build_env.params.each do |index, key|
       env[E::PATH_SEGMENTS_PARAMS][key] = env[E::SPLITTED_PATH_INFO][index]
     end
   end
 
   def correct_last_value_from_extensions(env)
+    return if @build_env.endpoint.config.serializer.extnames.empty?
     last_index = env[E::SPLITTED_PATH_INFO].length - 1
-    return if @params_lookup_hash[last_index].nil?
-    extless(env[E::PATH_SEGMENTS_PARAMS][@params_lookup_hash[last_index]])
+    return if @build_env.params[last_index].nil?
+    extless(env[E::PATH_SEGMENTS_PARAMS][@build_env.params[last_index]])
   end
 
   def extless(value)
     extname = File.extname(value)
+    return unless @build_env.endpoint.config.serializer.extnames.include?(extname)
     value.slice!(/#{Regexp.escape(extname)}$/) unless extname.empty?
   end
 

data/lib/rack/app/router/tree/leaf.rb

@@ -48,5 +48,4 @@ class Rack::App::Router::Tree::Leaf < ::Hash
     self[path_part] ||= Rack::App::Router::Tree::Vein.new
   end
 
-
 end

data/lib/rack/app/router/tree/vein.rb

@@ -21,12 +21,12 @@ class Rack::App::Router::Tree::Vein < ::Hash
 
   def create_app(env)
     app = env.endpoint.to_app
-    env.params.empty? ? app : wrap(app, env.params)
+    env.params.empty? ? app : wrap(app, env)
   end
 
-  def wrap(app, params)
+  def wrap(app, env)
     builder = Rack::Builder.new
-    builder.use(Rack::App::Middlewares::SetPathParams, params)
+    builder.use(Rack::App::Middlewares::SetPathParams, env)
     builder.run(app)
     builder.to_app
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rack-app
 version: !ruby/object:Gem::Version
-  version: 7.5.1
+  version: 7.5.2
 platform: ruby
 authors:
 - Adam Luzsi
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-11-26 00:00:00.000000000 Z
+date: 2018-07-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -226,7 +226,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.14
+rubygems_version: 2.6.8
 signing_key: 
 specification_version: 4
 summary: Your next favourite, performance designed micro framework!