almost-sinatra 0.1.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e893991c5706400658705b56a665b65727bdbb4c
-  data.tar.gz: 6a013d524a66d24d7b065b32b8fea6a6dd56d3c4
+  metadata.gz: 70ffc92b28161e2db66b6bed8149acbaf7e85a3f
+  data.tar.gz: 1ca81d13f7633e8d75249242a534aeffda3cce43
 SHA512:
-  metadata.gz: ad0e291fee7da826346f6c0569e3e144cd533bb373e6d1424e3e433ae6fb392c40da01fa9376e772586163631a82ba2f5fbd3d0b3d88f3c500ec150311291c44
-  data.tar.gz: c5431ba712ded1e434510410ed8ca8211b113dffd5c38c5bb26c10bb3e2ec4959e9be9cf8e67640f4729580c121418fd31957ceb3f4408236fee01a58295587e
+  metadata.gz: 2064e179bd420c95f64551896963f30fd40648ff0274482f3dfbb4af3055c57299cdc86f36868c1a5149ddddaa0a726bbd1697c442496ec8edbd0e864c8fa992
+  data.tar.gz: d09540bedba02aa5c8ef1c3284ab258af7f27507f92176acd66125324cf91bb31c61cddf22d84d196093993180c71a20f773884e0896678002b6627dcb510b7c

data/LICENSE.md

@@ -0,0 +1,116 @@
+CC0 1.0 Universal
+
+Statement of Purpose
+
+The laws of most jurisdictions throughout the world automatically confer
+exclusive Copyright and Related Rights (defined below) upon the creator and
+subsequent owner(s) (each and all, an "owner") of an original work of
+authorship and/or a database (each, a "Work").
+
+Certain owners wish to permanently relinquish those rights to a Work for the
+purpose of contributing to a commons of creative, cultural and scientific
+works ("Commons") that the public can reliably and without fear of later
+claims of infringement build upon, modify, incorporate in other works, reuse
+and redistribute as freely as possible in any form whatsoever and for any
+purposes, including without limitation commercial purposes. These owners may
+contribute to the Commons to promote the ideal of a free culture and the
+further production of creative, cultural and scientific works, or to gain
+reputation or greater distribution for their Work in part through the use and
+efforts of others.
+
+For these and/or other purposes and motivations, and without any expectation
+of additional consideration or compensation, the person associating CC0 with a
+Work (the "Affirmer"), to the extent that he or she is an owner of Copyright
+and Related Rights in the Work, voluntarily elects to apply CC0 to the Work
+and publicly distribute the Work under its terms, with knowledge of his or her
+Copyright and Related Rights in the Work and the meaning and intended legal
+effect of CC0 on those rights.
+
+1. Copyright and Related Rights. A Work made available under CC0 may be
+protected by copyright and related or neighboring rights ("Copyright and
+Related Rights"). Copyright and Related Rights include, but are not limited
+to, the following:
+
+  i. the right to reproduce, adapt, distribute, perform, display, communicate,
+  and translate a Work;
+
+  ii. moral rights retained by the original author(s) and/or performer(s);
+
+  iii. publicity and privacy rights pertaining to a person's image or likeness
+  depicted in a Work;
+
+  iv. rights protecting against unfair competition in regards to a Work,
+  subject to the limitations in paragraph 4(a), below;
+
+  v. rights protecting the extraction, dissemination, use and reuse of data in
+  a Work;
+
+  vi. database rights (such as those arising under Directive 96/9/EC of the
+  European Parliament and of the Council of 11 March 1996 on the legal
+  protection of databases, and under any national implementation thereof,
+  including any amended or successor version of such directive); and
+
+  vii. other similar, equivalent or corresponding rights throughout the world
+  based on applicable law or treaty, and any national implementations thereof.
+
+2. Waiver. To the greatest extent permitted by, but not in contravention of,
+applicable law, Affirmer hereby overtly, fully, permanently, irrevocably and
+unconditionally waives, abandons, and surrenders all of Affirmer's Copyright
+and Related Rights and associated claims and causes of action, whether now
+known or unknown (including existing as well as future claims and causes of
+action), in the Work (i) in all territories worldwide, (ii) for the maximum
+duration provided by applicable law or treaty (including future time
+extensions), (iii) in any current or future medium and for any number of
+copies, and (iv) for any purpose whatsoever, including without limitation
+commercial, advertising or promotional purposes (the "Waiver"). Affirmer makes
+the Waiver for the benefit of each member of the public at large and to the
+detriment of Affirmer's heirs and successors, fully intending that such Waiver
+shall not be subject to revocation, rescission, cancellation, termination, or
+any other legal or equitable action to disrupt the quiet enjoyment of the Work
+by the public as contemplated by Affirmer's express Statement of Purpose.
+
+3. Public License Fallback. Should any part of the Waiver for any reason be
+judged legally invalid or ineffective under applicable law, then the Waiver
+shall be preserved to the maximum extent permitted taking into account
+Affirmer's express Statement of Purpose. In addition, to the extent the Waiver
+is so judged Affirmer hereby grants to each affected person a royalty-free,
+non transferable, non sublicensable, non exclusive, irrevocable and
+unconditional license to exercise Affirmer's Copyright and Related Rights in
+the Work (i) in all territories worldwide, (ii) for the maximum duration
+provided by applicable law or treaty (including future time extensions), (iii)
+in any current or future medium and for any number of copies, and (iv) for any
+purpose whatsoever, including without limitation commercial, advertising or
+promotional purposes (the "License"). The License shall be deemed effective as
+of the date CC0 was applied by Affirmer to the Work. Should any part of the
+License for any reason be judged legally invalid or ineffective under
+applicable law, such partial invalidity or ineffectiveness shall not
+invalidate the remainder of the License, and in such case Affirmer hereby
+affirms that he or she will not (i) exercise any of his or her remaining
+Copyright and Related Rights in the Work or (ii) assert any associated claims
+and causes of action with respect to the Work, in either case contrary to
+Affirmer's express Statement of Purpose.
+
+4. Limitations and Disclaimers.
+
+  a. No trademark or patent rights held by Affirmer are waived, abandoned,
+  surrendered, licensed or otherwise affected by this document.
+
+  b. Affirmer offers the Work as-is and makes no representations or warranties
+  of any kind concerning the Work, express, implied, statutory or otherwise,
+  including without limitation warranties of title, merchantability, fitness
+  for a particular purpose, non infringement, or the absence of latent or
+  other defects, accuracy, or the present or absence of errors, whether or not
+  discoverable, all to the greatest extent permissible under applicable law.
+
+  c. Affirmer disclaims responsibility for clearing rights of other persons
+  that may apply to the Work or any use thereof, including without limitation
+  any person's Copyright and Related Rights in the Work. Further, Affirmer
+  disclaims responsibility for obtaining any necessary consents, permissions
+  or other rights required for any use of the Work.
+
+  d. Affirmer understands and acknowledges that Creative Commons is not a
+  party to this document and has no duty or obligation with respect to this
+  CC0 or use of the Work.
+
+For more information, please see
+<http://creativecommons.org/publicdomain/zero/1.0/>

data/Manifest.txt

@@ -1,4 +1,5 @@
 HISTORY.md
+LICENSE.md
 Manifest.txt
 README.md
 Rakefile

data/README.md

@@ -1 +1,335 @@
 # Almost Sinatra
+
+
+## What's Sinatra?
+
+Simple (yet powerful and flexible) micro webframework.
+
+``` ruby
+require 'sinatra'
+
+get '/' do
+  'Hallo Vienna! Servus Wien!'
+end
+```
+
+Trivia Quiz - How Many Lines of Ruby Code?
+
+- (A) 20 Lines
+- (B) 200 Lines
+- (C) 2 000 Lines
+- (D) 20 000 Lines
+
+
+## What's Almost Sinatra?
+
+Sinatra refactored, only six lines now. A hack by Konstantin Haase.
+
+[almost_sinatra.rb](https://github.com/rkh/almost-sinatra/blob/master/almost_sinatra.rb):
+
+``` ruby
+%w.rack tilt date INT TERM..map{|l|trap(l){$r.stop}rescue require l};$u=Date;$z=($u.new.year + 145).abs;puts "== Almost Sinatra/No Version has taken the stage on #$z for development with backup from Webrick"
+$n=Module.new{extend Rack;a,D,S,q=Rack::Builder.new,Object.method(:define_method),/@@ *([^\n]+)\n(((?!@@)[^\n]*\n)*)/m
+%w[get post put delete].map{|m|D.(m){|u,&b|a.map(u){run->(e){[200,{"Content-Type"=>"text/html"},[a.instance_eval(&b)]]}}}}
+Tilt.mappings.map{|k,v|D.(k){|n,*o|$t||=(h=$u._jisx0301("hash, please");File.read(caller[0][/^[^:]+/]).scan(S){|a,b|h[a]=b};h);v[0].new(*o){n=="#{n}"?n:$t[n.to_s]}.render(a,o[0].try(:[],:locals)||{})}}
+%w[set enable disable configure helpers use register].map{|m|D.(m){|*_,&b|b.try :[]}};END{Rack::Handler.get("webrick").run(a,Port:$z){|s|$r=s}}
+%w[params session].map{|m|D.(m){q.send m}};a.use Rack::Session::Cookie;a.use Rack::Lock;D.(:before){|&b|a.use Rack::Config,&b};before{|e|q=Rack::Request.new e;q.params.dup.map{|k,v|params[k.to_sym]=v}}}
+```
+
+
+
+## Almost Sinatra - A Breakdown Line by Line
+
+### Line 1/6
+
+(Like) Sinatra  = Rack + Tilt
+
+Line 1:
+
+``` ruby
+%w.rack tilt date INT TERM..map{|l|trap(l){$r.stop}rescue require l};$u=Date;$z=($u.new.year + 145).abs;puts "== Almost Sinatra/No Version has taken the stage on #$z for development with backup from Webrick"
+```
+
+Breakdown:
+
+```
+require 'rack'
+require 'tilt'
+
+trap( 'INT' )  { $server.stop }  # rename $r to $server
+trap( 'TERM' ) { $server.stop }
+
+$port = 4567              # rename $z to $port
+
+puts "== Almost Sinatra has taken the stage on #{$port} for development with backup from Webrick"
+```
+
+
+**Aside - What's rack?**
+
+Lets you mix 'n' match servers and apps.
+
+Lets you stack apps inside apps inside apps inside apps inside apps.
+
+Good News: A Sinatra app is a Rack app.
+
+Learn more about Rack @ [`rack.github.io`](http://rack.github.io).
+
+
+
+**Aside - What's tilt?**
+
+
+Tilt offers a standard "generic" interface for template engines.
+
+Let's check-up what formats and template engines tilt includes out-of-the-box:
+
+``` ruby
+require 'tilt'
+
+Tilt.mappings.each do |ext, engines|
+  puts "#{ext.ljust(12)} : #{engines.inspect}"
+end
+```
+
+Will result in:
+
+``` ruby
+str          : [Tilt::StringTemplate]
+erb          : [Tilt::ErubisTemplate, Tilt::ERBTemplate]
+rhtml        : [Tilt::ErubisTemplate, Tilt::ERBTemplate]
+erubis       : [Tilt::ErubisTemplate]
+etn          : [Tilt::EtanniTemplate]
+etanni       : [Tilt::EtanniTemplate]
+haml         : [Tilt::HamlTemplate]
+sass         : [Tilt::SassTemplate]
+scss         : [Tilt::ScssTemplate]
+less         : [Tilt::LessTemplate]
+rcsv         : [Tilt::CSVTemplate]
+coffee       : [Tilt::CoffeeScriptTemplate]
+nokogiri     : [Tilt::NokogiriTemplate]
+builder      : [Tilt::BuilderTemplate]
+mab          : [Tilt::MarkabyTemplate]
+liquid       : [Tilt::LiquidTemplate]
+radius       : [Tilt::RadiusTemplate]
+markdown     : [Tilt::RedcarpetTemplate, Tilt::RedcarpetTemplate::Redcarpet2, Tilt::RedcarpetTemplate::Redcarpet1, Tilt::RDiscountTemplate, Tilt::BlueClothTemplate, Tilt::KramdownTemplate, Tilt::MarukuTemplate]
+mkd          : [Tilt::RedcarpetTemplate, Tilt::RedcarpetTemplate::Redcarpet2, Tilt::RedcarpetTemplate::Redcarpet1, Tilt::RDiscountTemplate, Tilt::BlueClothTemplate, Tilt::KramdownTemplate, Tilt::MarukuTemplate]
+md           : [Tilt::RedcarpetTemplate, Tilt::RedcarpetTemplate::Redcarpet2, Tilt::RedcarpetTemplate::Redcarpet1, Tilt::RDiscountTemplate, Tilt::BlueClothTemplate, Tilt::KramdownTemplate, Tilt::MarukuTemplate]
+textile      : [Tilt::RedClothTemplate]
+rdoc         : [Tilt::RDocTemplate]
+wiki         : [Tilt::WikiClothTemplate, Tilt::CreoleTemplate]
+creole       : [Tilt::CreoleTemplate]
+mediawiki    : [Tilt::WikiClothTemplate]
+mw           : [Tilt::WikiClothTemplate]
+yajl         : [Tilt::YajlTemplate]
+ad           : [Tilt::AsciidoctorTemplate]
+adoc         : [Tilt::AsciidoctorTemplate]
+asciidoc     : [Tilt::AsciidoctorTemplate]
+html         : [Tilt::PlainTemplate]
+```
+
+
+### Line 2/6
+
+Line 2:
+
+``` ruby
+$n=Module.new{extend Rack;a,D,S,q=Rack::Builder.new,Object.method(:define_method),/@@ *([^\n]+)\n(((?!@@)[^\n]*\n)*)/m
+´´´
+
+Breakdown:
+
+´´´ ruby
+$n = Module.new do
+  app = Rack::Builder.new      # rename a to app
+  req = nil                    # rename q to req
+´´´
+
+
+### Line 3/6
+
+Line 3:
+
+``` ruby
+%w[get post put delete].map{|m|D.(m){|u,&b|a.map(u){run->(e){[200,{"Content-Type"=>"text/html"},[a.instance_eval(&b)]]}}}}
+```
+
+Breakdown:
+
+```
+  ['get','post','put','delete'].each do |method|
+    define_method method do |path, &block|
+      app.map( path ) do
+        run ->(env){ [200, {'Content-Type'=>'text/html'}, [app.instance_eval( &block )]]}
+      end
+    end
+  end
+```
+
+
+### Line 4/6
+
+Line 4:
+
+``` ruby
+Tilt.mappings.map{|k,v|D.(k){|n,*o|$t||=(h=$u._jisx0301("hash, please");File.read(caller[0][/^[^:]+/]).scan(S){|a,b|h[a]=b};h);v[0].new(*o){n=="#{n}"?n:$t[n.to_s]}.render(a,o[0].try(:[],:locals)||{})}}
+```
+
+Breakdown:
+
+``` ruby
+  Tilt.mappings.each do |ext, engines|          # rename k to ext and v to engines
+    define_method ext do |text, *args|          # rename n to text and o to args
+      template = engines[0].new(*args) do
+        text
+      end
+      locals = (args[0].respond_to?(:[]) ? args[0][:locals] : nil) || {}    # was o[0].try(:[],:locals)||{}
+      template.render( app, locals )
+    end
+  end
+```
+
+Commentary: Almost Sinatra will define a method for every format so you can use, for example:
+
+```
+markdown "Strong emphasis, aka bold, with **asterisks** or __underscores__."
+```
+
+or
+
+```
+erb "Hello <%= name %>!", locals: { name: params['name'] }
+```
+
+
+
+###  Line 5/6
+
+Line 5:
+
+``` ruby
+%w[set enable disable configure helpers use register].map{|m|D.(m){|*_,&b|b.try :[]}};END{Rack::Handler.get("webrick").run(a,Port:$z){|s|$r=s}}
+```
+
+Breakdown:
+
+```
+  # was END { ... }; change to run! method
+  define_method 'run!' do
+    Rack::Handler.get('webrick').run( app, Port:$port ) {|server| $server=server }
+  end
+```
+
+
+### Line 6/6
+
+Line 6:
+
+``` ruby
+%w[params session].map{|m|D.(m){q.send m}};a.use Rack::Session::Cookie;a.use Rack::Lock;D.(:before){|&b|a.use Rack::Config,&b};before{|e|q=Rack::Request.new e;q.params.dup.map{|k,v|params[k.to_sym]=v}}}
+```
+
+Breakdown:
+
+``` ruby
+  ['params','session'].each do |method|
+    define_method method do
+      req.send method
+    end
+  end
+
+  app.use Rack::Session::Cookie
+  app.use Rack::Lock
+  app.use Rack::Config do |env|
+    req = Rack::Request.new( env )
+  end
+end # Module.new
+```
+
+
+##  The Proof of the Pudding  - hello.rb
+
+`samples/hello.rb`:
+
+``` ruby
+require 'almost-sinatra'
+
+include $n    # include "anonymous" Almost Sinatra DSL module
+
+get '/hello' do
+  erb "Hello <%%= name %>!", locals: { name: params['name'] }
+end
+
+get '/' do
+  markdown <<EOS
+## Welcome to Almost Sinatra
+
+A six line ruby hack by Konstantin Haase.
+
+Try:
+- [Say hello!](/hello?name=Nancy)
+
+Powered by Almost Sinatra (#{Time.now})
+EOS
+end
+
+
+run!
+```
+
+Use
+
+```
+$ ruby -I ./lib ./samples/hello.rb
+```
+
+
+## Got Inspired? Build Your Own Microframework
+
+- New York, New York
+- Nancy
+- Rum
+- Cuba
+- Roda
+- and many more
+
+
+## Real World Case Study - webservice gem - (Yet Another) HTTP JSON API (Web Service) Builder
+
+Micro "framework" for building HTTP JSON APIs (about 100 lines of code).
+Example:
+
+``` ruby
+get '/beer/:key' do
+  Beer.find_by_key!( params[ :key ] )
+end
+
+get '/brewery/:key' do
+  Brewery.find_by_key!( params[ :key ] )
+end
+```
+
+
+## Links, Links, Links
+
+- Article :: [Decoding Almost Sinatra](https://robm.me.uk/2013/12/13/decoding-almost-sinatra.html), by Rob Miller
+- Article :: [Code Safari: Almost Sinatra, Almost Readable](http://www.sitepoint.com/code-safari-almost-sinatra-almost-readable/), by Xavier Shay
+- Article :: [tilt gem - let's build (yet another) micro web framework in less than 33 lines of code](http://planetruby.github.io/gems/tilt.html), by Gerald Bauer
+
+
+
+## Bonus: Fun Almost Sinatra Obfuscation Hacks
+
+"Calculate" the Sinatra Port 4567:
+
+```
+(Date.new.year + 145).abs     # Date.new.year always returns -4712, the default value for years
+# => 4567
+```
+
+"Get" empty Hash (e.g. `{}`):
+
+```
+Date._jisx0301("hash, please")
+# => {}
+```

data/Rakefile

@@ -2,7 +2,7 @@ require 'hoe'
 
 Hoe.spec 'almost-sinatra' do
 
-  self.version = '0.1.0'
+  self.version = '1.0.0'
 
   self.summary = 'almost-sinatra - six lines of almost sinatra refactored and bundled up for easy (re)use - build your own webframework from scratch with rack and tilt'
   self.description = summary
@@ -17,8 +17,8 @@ Hoe.spec 'almost-sinatra' do
   self.history_file = 'HISTORY.md'
 
   self.extra_deps = [
-    ['rack' ],
-    ['tilt' ],
+    ['rack', '>= 2.0' ],
+    ['tilt', '>= 2.0' ],
   ]
 
   self.licenses = ['Public Domain']

data/lib/almost-sinatra.rb

@@ -70,9 +70,10 @@ $n = Module.new do
 # Line 4:
 #  Tilt.mappings.map{|k,v|D.(k){|n,*o|$t||=(h=$u._jisx0301("hash, please");File.read(caller[0][/^[^:]+/]).scan(S){|a,b|h[a]=b};h);v[0].new(*o){n=="#{n}"?n:$t[n.to_s]}.render(a,o[0].try(:[],:locals)||{})}}
 
-  Tilt.mappings.each do |ext, engines|          # rename k to ext and v to engines
-    define_method ext do |text, *args|          # rename n to text and o to args
-      template = engines[0].new(*args) do
+  Tilt.default_mapping.lazy_map.each do |ext, engines|          # rename k to ext and v to engines
+    define_method ext do |text, *args|
+      # rename n to text and o to args
+      template = Kernel.const_get(engines[0][0]).new(*args) do
         text
       end
       locals = (args[0].respond_to?(:[]) ? args[0][:locals] : nil) || {}    # was o[0].try(:[],:locals)||{}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: almost-sinatra
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Konstantin Haase
@@ -17,28 +17,28 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: tilt
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
@@ -74,10 +74,12 @@ executables: []
 extensions: []
 extra_rdoc_files:
 - HISTORY.md
+- LICENSE.md
 - Manifest.txt
 - README.md
 files:
 - HISTORY.md
+- LICENSE.md
 - Manifest.txt
 - README.md
 - Rakefile