RubyGems - swerling-synfeld - Versions diffs - 0.0.2 → 0.0.4 - Mend

swerling-synfeld 0.0.2 → 0.0.4

Files changed (18) hide show

data/History.txt +13 -1
data/README.rdoc +105 -66
data/README.txt +105 -66
data/Rakefile +9 -1
data/TODO +1 -2
data/example/public/erb_files/erb_test.erb +7 -1
data/example/public/haml_files/home.haml +5 -1
data/example/public/html_files/html_test.html +1 -0
data/example/public/images/beef_interstellar_thm.jpg +0 -0
data/example/public/images/rails.png +0 -0
data/example/try_me.rb +39 -31
data/example/try_me.ru +5 -2
data/lib/synfeld.rb +6 -2
data/lib/synfeld/base.rb +168 -81
data/lib/synfeld_info.rb +1 -1
data/synfeld.gemspec +12 -8
data/work/rackmount-test.ru +59 -0
metadata +9 -5

data/History.txt CHANGED

@@ -1,3 +1,15 @@
+== 0.0.3 / 2009-09-12
+* switch from rack-router to rack-mount for routing
+== 0.0.3 / 2009-09-12
+* ruby1.9 compat
+== 0.0.2 / 2009-07-18
+* Add some static types.
 == 0.0.1 / 2009-07-18
-* initial release
+* initial releases

data/README.rdoc CHANGED

@@ -1,57 +1,48 @@
-synfeld
+== *Synfeld*
 by {Steven Swerling}[http://tab-a.slot-z.net]
 {rdoc}[http://tab-a.slot-z.net] | {github}[http://www.github.com/swerling/synfeld]
-== DESCRIPTION:
+== Description
 Synfeld is a web application framework that does practically nothing.
-Basically this is just a tiny wrapper for the Rack::Router (see http://github.com/carllerche/rack-router). If you want a web framework that is mostly just going to serve up json blobs, and occasionally serve up some simple content (eg. for help files) and media, Synfeld makes that easy. If you need session variables, a mailer, uploading, etc, look elsewhere.
+Synfeld is little more than a small wrapper for Rack::Mount (see http://github.com/josh/rack-mount). If you want a web framework that is mostly just going to serve up json blobs, and occasionally serve up some simple content (eg. help files) and media, Synfeld makes that easy.
-The sample app below shows pretty much everything that synfeld can do.
+The sample app below shows pretty much everything there is to know about synfeld, in particular:
-Very alpha-ish stuff here. Seems to work though.
+* How to define routes.
+* Simple rendering of erb, haml, html, json, and static files.
+* In the case of erb and haml, passing variables into the template is demonstrated.
+* A dynamic action where the status code, headers, and body are created 'manually' (/my/special/route below)
+* A simple way of creating format sensitive routes (/alphabet.html vs. /alphabet.json)
+* The erb demo link also demos the rendering of a partial (not visible in the code below, you have to look at the template file examples/public/erb_files/erb_test.erb).
-== SYNOPSIS:
+== Synopsis/Example
 Here is an example Synfeld application (foo_app.rb):
+  require 'synfeld'
+  require 'json'
   class FooApp < Synfeld::App
-    def initialize
-      super(:root_dir => File.expand_path(File.join(File.dirname(__FILE__), 'public')),
-            :logger => Logger.new(STDOUT))
-    end
-    def router
-      return @router ||= Rack::Router.new(nil, {}) do |r|
-        r.map "/yap/:yap_variable",        :get, :to => self, :with => { :action => "yap" }
-        r.map "/my/special/route",         :get, :to => self, :with => { :action => "my_special_route" }
-        r.map "/html_test",                :get, :to => self, :with => { :action => "html_test" }
-        r.map "/haml_test",                :get, :to => self, :with => { :action => "haml_test" }
-        r.map "/erb_test",                 :get, :to => self, :with => { :action => "erb_test" }
-        # These next 2 have to come last
-        r.map "/:anything_else",           :get, :to => self, :with => { :action => "handle_static" }
-        r.map "/",                         :get, :to => self, :with => { :action => "home" }
-      end
+    def add_routes
+      add_route "/yap/:yap_variable", :action => "yap"
+      add_route "/html_test", :action => "html_test"
+      add_route "/haml_test", :action => "haml_test"
+      add_route "/erb_test",  :action => "erb_test"
+      add_route '/alphabet.:format', :action => "alphabet"
+      add_route "/my/special/route", :action => "my_special_route",
+                                    :extra_parm1 => 'really',
+                                    :extra_parm2 => 'truly'
+      add_route '/', :action => "home"
     end
     # files are looked up relative to the root directory specified in initialize
     def home
-      serve('haml_files/home.haml')
-    end
-    def my_special_route
-      self.response[:status_code] = 200
-      self.response[:headers]['Content-Type'] = 'text/html'
-      self.response[:body] = <<-HTML
-        <html>
-          <body>I'm <i>special</i>.</body>
-        </html>
-      HTML
+      render_haml('haml_files/home.haml')
     end
     def yap
@@ -59,40 +50,82 @@ Here is an example Synfeld application (foo_app.rb):
     end
     def html_test
-      serve('html_files/html_test.html')
+      render_html('html_files/html_test.html')
     end
     def haml_test
-      serve('haml_files/haml_test.haml', {:ran100 => Kernel.rand(100) + 1, :time => Time.now})
+      render_haml('haml_files/haml_test.haml', :ran100 => Kernel.rand(100) + 1, :time => Time.now)
     end
     def erb_test
-      serve('erb_files/erb_test.erb', {:ran100 => Kernel.rand(100) + 1, :time => Time.now})
+      render_erb('erb_files/erb_test.erb', :ran100 => Kernel.rand(100) + 1, :time => Time.now)
     end
+    def alphabet
+      alphabet = ('a'..'z').collect{|ch|ch}
+      case params[:format]
+      when 'html'
+        return "<html><body>#{alphabet.join("<br/>")}</body></html>"
+      when 'json'
+        hash = {:desc => 'here is the alphabet', :alphabet => alphabet}
+        render_json hash.to_json
+      else
+        raise "Format not recognized: #{params[:format]}"
+      end
+    end
+    def my_special_route
+      self.response[:status_code] = 200
+      self.response[:headers]['Content-Type'] = 'text/html'
+      self.response[:body] = <<-HTML
+        <html>
+          <body>I'm <i>special</i>,
+          #{self.params[:extra_parm1]} and #{self.params[:extra_parm2]}</body>
+        </html>
+      HTML
+    end
   end
 And here is an example rack config, foo_app.ru:
   require '/path/to/foo_app.rb'
-  run FooApp.new.as_rack_app
+  use Rack::CommonLogger, logger = Logger.new('/tmp/synfeld.log')
+  foo_app = FooApp.new( :logger => logger, :root_dir => '/path/to/root/dir' )
+  run foo_app.as_rack_app
 Run FooApp w/ rackup or shotgun:
-  rackup --server=thin foo.ru -p 3000
+  rackup foo_app.ru -p 3000
     or
-  shotgun --server=thin foo.ru -p 3000
+  shotgun foo_app.ru -p 3000
+== Features
+==== The Router
+When a Synfeld application starts up, it will call your app's 'add_routes' method, where you have to create your routes using the #add_route method. Example calls to add_route:
+1.  add_route %r{/some/path/(?:<somevar>.*)}, :action => "haml_test"
+2.  add_route "/some/otherpath/:somevar", :action => "haml_test"
+3.  add_route "/yet/anotherpath/:var", :action => "haml_test", :method => 'post', :furthermore => 'art is dead'
-== FEATURES
+* At minimum, you have to provide the route and the :action to #add_route.
+* When a route is passed as a regex (the 1st add_route line above), it is passed straight through to rackmount as is, so rackmount's rules apply.
+* When using the convenience notation of the second add_route line above, the '/some/path/:somevar' is converted to a rackmount regex route under the covers, and :somevar will be passed to your app as a param (this is shown in the example code's #yap and #my_special_route methods).
+* The 3rd add_route example shows how you can set any additional parameters on the route by adding associations onto the end of the route (this is also shown in #my_special_route in the example application above).
+* If you happen to have a parameter called ':method', it will determine the request method required for the route (eg. 'get', 'put', 'post'). If the :method is not passed in, 'get' is assumed.
+Note that rack-mount is an evolving project, so the examples above may have to be tweaked a bit in the future.
+==== The Response
 When a Synfeld application handles a rack request, it
-1. Duplicates self (so it's thread safe)
-2. Sets @response, @params, @env (the rack env)
-3. Calls the action that Rack::Router route that matched. If the action returns a String, that is used for the @response[:body]
+1. Duplicates itself (so it's thread safe)
+2. Sets @response, @params, @env (@env is just the rack env)
+3. Calls the action that the route that matched.
 The @response is a hash used to return the rack status code, headers hash, and body.  Actions may do what they please with the response. Default response:
@@ -103,47 +136,52 @@ The @response is a hash used to return the rack status code, headers hash, and b
     }
-Actions are expected to side-effect the :status_code, :headers, and :body if the defaults are not appropriate. As a convenience, if an action returns a string, it is assumed that that string is the :body. An exception is thrown if the :body is not set to something.
-As the example app above shows, you can "serve" templated content in the form of 'haml' or 'erb' files.
+Actions are expected to side-effect the :status_code, :headers, and :body if the defaults are not appropriate. As a convenience, if an action returns a string, it is assumed that that string is to be used as the response[:body]. An exception is thrown if the :body is not set to something. The 'Content-Length' header will be derived from the body's size.
-Requests are bound to the first matching route. The 'handle_static' action considers the request path to be a path to a file relative to the 'root_dir' specified in initialize (see example app below).
+As the example app above shows, you can serve templated content in the form of 'haml' or 'erb' files (the #erb_test and #haml_test methods in the code above).
-Can currenty serve up the following types of static files:
+Synfeld can currenty serve up the following types of static files:
         js, css, png, gif, jpg, jpeg, html
-Can currently render the following dynamic content:
+Synfeld can currently render the following dynamic content:
+        erb, haml, json
+Additional file types can be added upon request. Or you can just look at the synfeld code, which is tiny, then roll your own render method.
-        erb, haml
+You can pass local variables to erb and haml.
-Synfeld does not do partials, but you can set local variables for dynamic content.
+Rendering 'partials' is trivial and is demonstrated in the included sample application file examples/public/erb_files/erb_test.erb.
-That's it. Really not much to see here.  Just gives you a thread-safe rack-based web framework that consists of little more than a router.
+==== That's It
-== PROBLEMS
+Synfeld just gives you a thread-safe rack-based web framework that consists of just a little more than a router.  There's really not much to see.  If you want caching, security, session access, etc, it is assumed you will add those as Rack middleware.
+== Problems
 None known.
-== REQUIREMENTS:
+== Requirements
+* ruby (either 1.8.X or 1.9.X)
 * ruby, rubygems, rack, rack-router
 * For rack-router, see http://github.com/carllerche/rack-router
-== INSTALL:
-  First install rack and rack-router.
-  There's no gem for rack-router at the moment,
-  to you will have to clone it and build it yourself.
-  Then:
+== Install
+  1. [install rack if necessary]
+  2. gem install josh-rack-mount --source=http://gems.github.com
+  3. gem install swerling-synfeld --source http://gems.github.com
-    gem install swerling-synfeld --source http://gems.github.com
+    (note: I noticed sometimes josh-rack-mount will complain about rack version
+    not being high enough, even if you are already on version 1.0.0. If that happens,
+    you have to clone the rack-mount repo locally and just build the rack-mount gem
+    yourself)
-== LICENSE:
+== License
-(The MIT License)
+(the MIT License)
 Copyright (c) 2009 Steven Swerling
@@ -165,3 +203,4 @@ 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.txt CHANGED

@@ -1,57 +1,48 @@
-synfeld
+== *Synfeld*
 by {Steven Swerling}[http://tab-a.slot-z.net]
 {rdoc}[http://tab-a.slot-z.net] | {github}[http://www.github.com/swerling/synfeld]
-== DESCRIPTION:
+== Description
 Synfeld is a web application framework that does practically nothing.
-Basically this is just a tiny wrapper for the Rack::Router (see http://github.com/carllerche/rack-router). If you want a web framework that is mostly just going to serve up json blobs, and occasionally serve up some simple content (eg. for help files) and media, Synfeld makes that easy. If you need session variables, a mailer, uploading, etc, look elsewhere.
+Synfeld is little more than a small wrapper for Rack::Mount (see http://github.com/josh/rack-mount). If you want a web framework that is mostly just going to serve up json blobs, and occasionally serve up some simple content (eg. help files) and media, Synfeld makes that easy.
-The sample app below shows pretty much everything that synfeld can do.
+The sample app below shows pretty much everything there is to know about synfeld, in particular:
-Very alpha-ish stuff here. Seems to work though.
+* How to define routes.
+* Simple rendering of erb, haml, html, json, and static files.
+* In the case of erb and haml, passing variables into the template is demonstrated.
+* A dynamic action where the status code, headers, and body are created 'manually' (/my/special/route below)
+* A simple way of creating format sensitive routes (/alphabet.html vs. /alphabet.json)
+* The erb demo link also demos the rendering of a partial (not visible in the code below, you have to look at the template file examples/public/erb_files/erb_test.erb).
-== SYNOPSIS:
+== Synopsis/Example
 Here is an example Synfeld application (foo_app.rb):
+  require 'synfeld'
+  require 'json'
   class FooApp < Synfeld::App
-    def initialize
-      super(:root_dir => File.expand_path(File.join(File.dirname(__FILE__), 'public')),
-            :logger => Logger.new(STDOUT))
-    end
-    def router
-      return @router ||= Rack::Router.new(nil, {}) do |r|
-        r.map "/yap/:yap_variable",        :get, :to => self, :with => { :action => "yap" }
-        r.map "/my/special/route",         :get, :to => self, :with => { :action => "my_special_route" }
-        r.map "/html_test",                :get, :to => self, :with => { :action => "html_test" }
-        r.map "/haml_test",                :get, :to => self, :with => { :action => "haml_test" }
-        r.map "/erb_test",                 :get, :to => self, :with => { :action => "erb_test" }
-        # These next 2 have to come last
-        r.map "/:anything_else",           :get, :to => self, :with => { :action => "handle_static" }
-        r.map "/",                         :get, :to => self, :with => { :action => "home" }
-      end
+    def add_routes
+      add_route "/yap/:yap_variable", :action => "yap"
+      add_route "/html_test", :action => "html_test"
+      add_route "/haml_test", :action => "haml_test"
+      add_route "/erb_test",  :action => "erb_test"
+      add_route '/alphabet.:format', :action => "alphabet"
+      add_route "/my/special/route", :action => "my_special_route",
+                                    :extra_parm1 => 'really',
+                                    :extra_parm2 => 'truly'
+      add_route '/', :action => "home"
     end
     # files are looked up relative to the root directory specified in initialize
     def home
-      serve('haml_files/home.haml')
-    end
-    def my_special_route
-      self.response[:status_code] = 200
-      self.response[:headers]['Content-Type'] = 'text/html'
-      self.response[:body] = <<-HTML
-        <html>
-          <body>I'm <i>special</i>.</body>
-        </html>
-      HTML
+      render_haml('haml_files/home.haml')
     end
     def yap
@@ -59,40 +50,82 @@ Here is an example Synfeld application (foo_app.rb):
     end
     def html_test
-      serve('html_files/html_test.html')
+      render_html('html_files/html_test.html')
     end
     def haml_test
-      serve('haml_files/haml_test.haml', {:ran100 => Kernel.rand(100) + 1, :time => Time.now})
+      render_haml('haml_files/haml_test.haml', :ran100 => Kernel.rand(100) + 1, :time => Time.now)
     end
     def erb_test
-      serve('erb_files/erb_test.erb', {:ran100 => Kernel.rand(100) + 1, :time => Time.now})
+      render_erb('erb_files/erb_test.erb', :ran100 => Kernel.rand(100) + 1, :time => Time.now)
     end
+    def alphabet
+      alphabet = ('a'..'z').collect{|ch|ch}
+      case params[:format]
+      when 'html'
+        return "<html><body>#{alphabet.join("<br/>")}</body></html>"
+      when 'json'
+        hash = {:desc => 'here is the alphabet', :alphabet => alphabet}
+        render_json hash.to_json
+      else
+        raise "Format not recognized: #{params[:format]}"
+      end
+    end
+    def my_special_route
+      self.response[:status_code] = 200
+      self.response[:headers]['Content-Type'] = 'text/html'
+      self.response[:body] = <<-HTML
+        <html>
+          <body>I'm <i>special</i>,
+          #{self.params[:extra_parm1]} and #{self.params[:extra_parm2]}</body>
+        </html>
+      HTML
+    end
   end
 And here is an example rack config, foo_app.ru:
   require '/path/to/foo_app.rb'
-  run FooApp.new.as_rack_app
+  use Rack::CommonLogger, logger = Logger.new('/tmp/synfeld.log')
+  foo_app = FooApp.new( :logger => logger, :root_dir => '/path/to/root/dir' )
+  run foo_app.as_rack_app
 Run FooApp w/ rackup or shotgun:
-  rackup --server=thin foo.ru -p 3000
+  rackup foo_app.ru -p 3000
     or
-  shotgun --server=thin foo.ru -p 3000
+  shotgun foo_app.ru -p 3000
+== Features
+==== The Router
+When a Synfeld application starts up, it will call your app's 'add_routes' method, where you have to create your routes using the #add_route method. Example calls to add_route:
+1.  add_route %r{/some/path/(?:<somevar>.*)}, :action => "haml_test"
+2.  add_route "/some/otherpath/:somevar", :action => "haml_test"
+3.  add_route "/yet/anotherpath/:var", :action => "haml_test", :method => 'post', :furthermore => 'art is dead'
-== FEATURES
+* At minimum, you have to provide the route and the :action to #add_route.
+* When a route is passed as a regex (the 1st add_route line above), it is passed straight through to rackmount as is, so rackmount's rules apply.
+* When using the convenience notation of the second add_route line above, the '/some/path/:somevar' is converted to a rackmount regex route under the covers, and :somevar will be passed to your app as a param (this is shown in the example code's #yap and #my_special_route methods).
+* The 3rd add_route example shows how you can set any additional parameters on the route by adding associations onto the end of the route (this is also shown in #my_special_route in the example application above).
+* If you happen to have a parameter called ':method', it will determine the request method required for the route (eg. 'get', 'put', 'post'). If the :method is not passed in, 'get' is assumed.
+Note that rack-mount is an evolving project, so the examples above may have to be tweaked a bit in the future.
+==== The Response
 When a Synfeld application handles a rack request, it
-1. Duplicates self (so it's thread safe)
-2. Sets @response, @params, @env (the rack env)
-3. Calls the action that Rack::Router route that matched. If the action returns a String, that is used for the @response[:body]
+1. Duplicates itself (so it's thread safe)
+2. Sets @response, @params, @env (@env is just the rack env)
+3. Calls the action that the route that matched.
 The @response is a hash used to return the rack status code, headers hash, and body.  Actions may do what they please with the response. Default response:
@@ -103,47 +136,52 @@ The @response is a hash used to return the rack status code, headers hash, and b
     }
-Actions are expected to side-effect the :status_code, :headers, and :body if the defaults are not appropriate. As a convenience, if an action returns a string, it is assumed that that string is the :body. An exception is thrown if the :body is not set to something.
-As the example app above shows, you can "serve" templated content in the form of 'haml' or 'erb' files.
+Actions are expected to side-effect the :status_code, :headers, and :body if the defaults are not appropriate. As a convenience, if an action returns a string, it is assumed that that string is to be used as the response[:body]. An exception is thrown if the :body is not set to something. The 'Content-Length' header will be derived from the body's size.
-Requests are bound to the first matching route. The 'handle_static' action considers the request path to be a path to a file relative to the 'root_dir' specified in initialize (see example app below).
+As the example app above shows, you can serve templated content in the form of 'haml' or 'erb' files (the #erb_test and #haml_test methods in the code above).
-Can currenty serve up the following types of static files:
+Synfeld can currenty serve up the following types of static files:
         js, css, png, gif, jpg, jpeg, html
-Can currently render the following dynamic content:
+Synfeld can currently render the following dynamic content:
+        erb, haml, json
+Additional file types can be added upon request. Or you can just look at the synfeld code, which is tiny, then roll your own render method.
-        erb, haml
+You can pass local variables to erb and haml.
-Synfeld does not do partials, but you can set local variables for dynamic content.
+Rendering 'partials' is trivial and is demonstrated in the included sample application file examples/public/erb_files/erb_test.erb.
-That's it. Really not much to see here.  Just gives you a thread-safe rack-based web framework that consists of little more than a router.
+==== That's It
-== PROBLEMS
+Synfeld just gives you a thread-safe rack-based web framework that consists of just a little more than a router.  There's really not much to see.  If you want caching, security, session access, etc, it is assumed you will add those as Rack middleware.
+== Problems
 None known.
-== REQUIREMENTS:
+== Requirements
+* ruby (either 1.8.X or 1.9.X)
 * ruby, rubygems, rack, rack-router
 * For rack-router, see http://github.com/carllerche/rack-router
-== INSTALL:
-  First install rack and rack-router.
-  There's no gem for rack-router at the moment,
-  to you will have to clone it and build it yourself.
-  Then:
+== Install
+  1. [install rack if necessary]
+  2. gem install josh-rack-mount --source=http://gems.github.com
+  3. gem install swerling-synfeld --source http://gems.github.com
-    gem install swerling-synfeld --source http://gems.github.com
+    (note: I noticed sometimes josh-rack-mount will complain about rack version
+    not being high enough, even if you are already on version 1.0.0. If that happens,
+    you have to clone the rack-mount repo locally and just build the rack-mount gem
+    yourself)
-== LICENSE:
+== License
-(The MIT License)
+(the MIT License)
 Copyright (c) 2009 Steven Swerling
@@ -165,3 +203,4 @@ 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/Rakefile CHANGED

@@ -48,13 +48,21 @@ task :myclobber => [:clobber] do
   sh "rm -rf #{File.join(mydir, 'ext/*.so')}"
   sh "rm -rf #{File.join(mydir, 'ext/Makefile')}"
   sh "rm -rf #{File.join(mydir, 'ext/Makefile')}"
+  sh "cp #{File.join(mydir, 'README.rdoc')} #{File.join(mydir, 'README.txt')}" # concession to bones
 end
 task :mypackage => [:myclobber] do
   Rake::Task['gem:package'].invoke
 end
 task :mydoc => [:myclobber] do
   FileUtils.rm_f doc_dir()
-  sh "cd #{this_dir()} && rdoc -o rdoc --inline-source --format=html -T hanna README.rdoc lib/**/*.rb"
+  #sh "cd #{this_dir()} && rdoc -o rdoc --inline-source --format=html -T hanna README.rdoc lib/**/*.rb"
+  this_dir = File.dirname(__FILE__) + '/'
+  files = []
+  files += Dir[File.join(this_dir, 'lib/**/*.rb')].map{|fn| fn.gsub(this_dir,'')}
+  files += Dir[File.join(this_dir, 'example/**/*.*')].map{|fn| fn.gsub(this_dir,'')}
+  files += ['README.rdoc']
+  files = files.reject{|fn| fn =~ /jpg/ }.sort
+  sh "cd #{this_dir()} && rdoc -o rdoc --inline-source #{files.flatten.join(" ")}"
 end
 task :taba => [:mydoc] do
   this_dir = File.join(File.dirname(__FILE__))

data/TODO CHANGED

@@ -1,2 +1 @@
-Try using USHER as the router
-  http://github.com/joshbuddy/usher/tree/master
+Create a sourceforge gem and move all the docs over there from slot-z.com.

data/example/public/erb_files/erb_test.erb CHANGED

@@ -3,8 +3,14 @@
     <div>
       <h3> Here is an erb test</h3>
       Here is the time: <%= time %>
-      <br/>ran100: <%= ran100 %>
+      <br/>ran100: <%= ran100 %> (local variable passed in)
       <br/><a href="/">home</a>
+      <br/>
+      <br/>
+      Here is the home page rendered as a partial:
+      <div style="margin-left: 50px">
+        <%= render_haml('haml_files/home.haml') %>
+     </div>
     </div>
   </body>
 </html>

data/example/public/haml_files/home.haml CHANGED

@@ -11,5 +11,9 @@
       %li
         %a{:href => '/html_test'} test an html file
       %li
-        %a{:href => '/my/special/route'} test of non-static action ('my_special_route')
+        %a{:href => '/my/special/route'} test of non-static action
+      %li
+        %a{:href => '/alphabet.json'} alphabet as json
+      %li
+        %a{:href => '/alphabet.html'} alphabet as html

data/example/public/html_files/html_test.html CHANGED

@@ -6,6 +6,7 @@
       <h3>Not much to see here</h3>
       Just testing render of a html file.
       <a href='http://www.github.com/swerling/synfeld'>synfeld on github</a>
+      <br/>Serve up a static: <a href='http://www.achewood.com/'> <img src='images/beef_interstellar_thm.jpg'/> </a>
     </p>
 </body>

data/example/public/images/beef_interstellar_thm.jpg ADDED

Binary file

data/example/public/images/rails.png ADDED

Binary file

data/example/try_me.rb CHANGED

@@ -1,39 +1,24 @@
 require File.expand_path(File.join(File.dirname(__FILE__), '../lib/synfeld.rb'))
+require 'json'
+# This is the sample Synfeld::App described in the README.rdoc
 class TryMe < Synfeld::App
-  def initialize
-    super(:root_dir => File.expand_path(File.join(File.dirname(__FILE__), 'public')),
-          :logger => Logger.new(STDOUT))
-  end
-  def router
-    return @router ||= Rack::Router.new(nil, {}) do |r|
-      r.map "/yap/:yap_variable",        :get, :to => self, :with => { :action => "yap" }
-      r.map "/my/special/route",         :get, :to => self, :with => { :action => "my_special_route" }
-      r.map "/html_test",                :get, :to => self, :with => { :action => "html_test" }
-      r.map "/haml_test",                :get, :to => self, :with => { :action => "haml_test" }
-      r.map "/erb_test",                 :get, :to => self, :with => { :action => "erb_test" }
-      # These next 2 have to come last
-      r.map "/:anything_else",           :get, :to => self, :with => { :action => "handle_static" }
-      r.map "/",                         :get, :to => self, :with => { :action => "home" }
-    end
+  def add_routes
+    add_route "/yap/:yap_variable", :action => "yap"
+    add_route "/html_test", :action => "html_test"
+    add_route "/haml_test", :action => "haml_test"
+    add_route "/erb_test",  :action => "erb_test"
+    add_route '/alphabet.:format', :action => "alphabet"
+    add_route "/my/special/route", :action => "my_special_route",
+                                   :extra_parm1 => 'really',
+                                   :extra_parm2 => 'truly'
+    add_route '/', :action => "home"
   end
   # files are looked up relative to the root directory specified in initialize
   def home
-    serve('haml_files/home.haml')
-  end
-  def my_special_route
-    self.response[:status_code] = 200
-    self.response[:headers]['Content-Type'] = 'text/html'
-    self.response[:body] = <<-HTML
-      <html>
-        <body>I'm <i>special</i>.</body>
-      </html>
-    HTML
+    render_haml('haml_files/home.haml')
   end
   def yap
@@ -41,17 +26,40 @@ class TryMe < Synfeld::App
   end
   def html_test
-    serve('html_files/html_test.html')
+    render_html('html_files/html_test.html')
   end
   def haml_test
-    serve('haml_files/haml_test.haml', {:ran100 => Kernel.rand(100) + 1, :time => Time.now})
+    render_haml('haml_files/haml_test.haml', :ran100 => Kernel.rand(100) + 1, :time => Time.now)
   end
   def erb_test
-    serve('erb_files/erb_test.erb', {:ran100 => Kernel.rand(100) + 1, :time => Time.now})
+    render_erb('erb_files/erb_test.erb', :ran100 => Kernel.rand(100) + 1, :time => Time.now)
+  end
+  def alphabet
+    alphabet = ('a'..'z').collect{|ch|ch}
+    case params[:format]
+    when 'html'
+      return "<html><body>#{alphabet.join("<br/>")}</body></html>"
+    when 'json'
+      hash = {:desc => 'here is the alphabet', :alphabet => alphabet}
+      render_json hash.to_json
+    else
+      raise "Format not recognized: #{params[:format]}"
+    end
   end
+  def my_special_route
+    self.response[:status_code] = 200
+    self.response[:headers]['Content-Type'] = 'text/html'
+    self.response[:body] = <<-HTML
+      <html>
+        <body>I'm <i>special</i>,
+        #{self.params[:extra_parm1]} and #{self.params[:extra_parm2]}</body>
+      </html>
+    HTML
+  end
 end

data/example/try_me.ru CHANGED

@@ -1,2 +1,5 @@
-require File.join(File.dirname(__FILE__),'try_me.rb')
-run TryMe.new.as_rack_app
+require ::File.join(::File.dirname(__FILE__),'try_me.rb')
+use Rack::CommonLogger, logger = Logger.new('/tmp/synfeld.log')
+try_me = TryMe.new( :logger => logger,
+                    :root_dir => ::File.expand_path(::File.join(::File.dirname(__FILE__), 'public')))
+run try_me.as_rack_app

data/lib/synfeld.rb CHANGED

@@ -1,13 +1,17 @@
+F = ::File
 # base ruby requires
+require 'rubygems'
 require 'logger'
 # gems dependencies
 require 'rubygems'
 require 'rack'
-require 'rack/router'
+require 'rack/mount'
+require 'rack/mime'
 # my files (require_all_libs_relative_to is a bones util method in synfeld_info.rb)
-require File.join(File.dirname(__FILE__), 'synfeld_info')
+require F.join(File.dirname(__FILE__), 'synfeld_info')
 Synfeld.require_all_libs_relative_to(__FILE__)

data/lib/synfeld/base.rb CHANGED

@@ -1,9 +1,10 @@
-module Synfeld
+module Synfeld # :nodoc:
   #
-  # See the synopsis section of README.txt for usage.
+  # See the synopsis section of README.rdoc for usage.
   #
-  # See the RackRouter project for the kinds of routes you can setup.
+  # See the README.rdoc for an overview of an Synfeld::App, and see the Rack::Mount project for
+  # more information on Rack::Mount style routing.
   #
   # Variables of note:
   #
@@ -16,7 +17,13 @@ module Synfeld
   #      The rack env passed into this apps #call method
   #
   #   @params
-  #      The params that the matching Rack::Router route set.
+  #      The params as determined by the matching Rack::Mount route.
+  #
+  #   @root_dir
+  #      This dir is prepended to relative paths to locate files.
+  #
+  #   @logger
+  #      Either you pass in the @logger that synfeld uses, or it sets one up on STDOUT.
   #
   class App
     attr_accessor :response, :params, :env, :root_dir, :logger
@@ -26,22 +33,37 @@ module Synfeld
     #              Note this is not the same thing as the rack access log (although you
     #              can pass that logger in if you want). Default: Logger.new(STDOUT)
     def initialize(opts = {})
-      @logger = opts[:logger] || Logger.new(STDOUT)
+      @logger = opts[:logger]
+      if self.logger.nil?
+        @logger = Logger.new(STDOUT)
+        puts "WARNING: Synfeld not configured with a logger, using STDOUT. Won't have much to say if running as a daemon."
+      end
       @root_dir = opts[:root_dir]
-      raise "You have to pass in the location of the 'root_dir', where all the files in your synfeld app are located" if self.root_dir.nil?
-      #Haml::Template.options[:format] = :html5
+      if self.root_dir.nil?
+        raise "You have to pass in the location of the 'root_dir', where all the files in your synfeld app are located"
+      end
+      Kernel.at_exit {self.whine("Alright, I'm outta here.")}
     end
-    # the router for this Synfeld::App. Subclasses are _required_ to override this.
-    # (see README.txt for example usage)
-    def router
-      raise "#{self.class} must implement a 'router' method that returns a Rack::Router"
-    end
+    #
+    #            RACK PLUMBING
+    #
-    # Alias for #router
+    # Return self as a rackup-able rack application.
     def as_rack_app
-      self.router
-      # TODO: add the no_route handler here. But waiting for rack-router to settle this issue.
+      routes = Rack::Mount::RouteSet.new_without_optimizations do |set|
+        @set = set
+        self.add_routes
+        add_route %r{^.*$},  :action => "render_static"
+      end
+      app = Rack::Builder.new {
+        #use Rack::CommonLogger, $stderr
+        #use Rack::Reloader, 0
+        run routes
+      }.to_app
     end
     # The rack #call method
@@ -50,48 +72,85 @@ module Synfeld
     end
     #
-    #  Misc Sugar
+    #            ROUTING
     #
-    # The name of the action method, determined by the Route that Rack::Router bound to the incoming request
-    def action
-      self.params[:action]
+    @@__regex_colon = (RUBY_VERSION =~ /^1.8/)? ':' : '' # :nodoc:
+    # See the README for a full explanation of how to use this method.
+    def add_route(string_or_regex, opts = {})
+      raise "You have to provide an :action method to call" unless opts[:action]
+      method = (opts.delete(:method) || 'GET').to_s.upcase
+      # Adapt string_or_regex into a rack-mount regex route. If it is a string, convert it to a
+      # rack-mount compatable regex. In paths that look like /some/:var/in/path, convert the ':var'
+      # bits to rack-mount variables.
+      if string_or_regex.is_a?(String)
+        regex_string = "^" + string_or_regex.gsub(/:(([^\/]+))/){|s| "(?#{@@__regex_colon}<#{$1}>.*)" } + "$"
+        regex = %r{#{regex_string}}
+        #puts regex_string # dbg
+      else
+        regex = string_or_regex
+      end
+      # Add the route to rack-mount
+      @set.add_route(self,
+                    {:path_info => regex, :request_method => method.upcase},
+                    opts)
     end
-    # Overridable method that handles missing action that was defined by a route
-    def theres_no_action
-      self.response[:body] = "Action '#{self.action}' not found in '#{self.class}'"
-      self.response[:status_code] = 500
+    #
+    #            ACCESSORS & SUGAR
+    #
+    # The name of the action method bound to the route that mathed the incoming request.
+    def action
+      self.params[:action]
     end
     protected
-      # :stopdoc:
-      def _call(env)
-        start_time = Time.now.to_f
+      def _call(env) # :nodoc:
+        begin
+          start_time = Time.now.to_f
+          @env = env
+          @params = env[ Rack::Mount::Const::RACK_ROUTING_ARGS ]
+          @response = {
+            :status_code => 200,
+            :headers => {'Content-Type' => 'text/html'},
+            :body => nil
+          }
+          action = self.action
+          if self.respond_to?(action)
+            result = self.send(self.action)
+          else
+            result = self.no_action
+          end
+          if result.is_a?(String)
+            response[:body] = result
+          else
+            raise "You have to set the response body" if response[:body].nil?
+          end
-        @env = env
-        @params = env['rack_router.params']
-        @response = {
-          :status_code => 200,
-          :headers => {'Content-Type' => 'text/html'},
-          :body => nil
-        }
+          response[:headers]["Content-Length"] = response[:body].size.to_s
-        action = self.action
-        if self.respond_to?(action)
-          body = self.send(self.action)
-        else
-          body = theres_no_action
+          logger.debug("It took #{Time.now.to_f - start_time} sec for #{self.class} to handle request.")
+          [response[:status_code], response[:headers], Array(response[:body])]
+        rescue Exception => e
+          # It seems like we should get this next line for free from the CommonLogger, so I guess
+          # I'm doing something wrong, missing some piece of rack middleware or something. Until I
+          # figure it out, I'm explicitly logging the exception manually.
+          self.whine "#{e.class}, #{e}\n\t#{e.backtrace.join("\n\t")} "
+          raise e
         end
+      end
+      # :startdoc:
-        response[:body] = body if body.is_a?(String)
-        raise "You have to set the response body" if response[:body].nil?
-        logger.debug("It took #{Time.now.to_f - start_time} sec for #{self.class} to handle request.")
-        [response[:status_code], response[:headers], response[:body]]
-      end
+      #
+      #            EXCEPTIONS
+      #
       # send an error message to the log prepended by "Synfeld: "
       def whine msg
@@ -100,33 +159,37 @@ module Synfeld
       end
-      # :startdoc:
-      def serve(fn, local = {})
-        full_fn = fn
-        full_fn = File.join(self.root_dir, fn) unless File.exist?(full_fn)
-        if File.exist?(full_fn)
-          ext = fn.split('.').last.downcase
+      # Overrideable method that handles a missing action that was defined by a route
+      def no_action
+        self.response[:body] = "Action '#{self.action}' not found in '#{self.class}'"
+        self.response[:status_code] = 500
+      end
-          self.content_type!(ext)
+      # Overrideable method that handles 404
+      def no_route
+          self.response[:body] = "route not found for: '#{self.env['REQUEST_URI']}'"
+          self.response[:status_code] = 404
+      end
-          case ext
-          when 'html'; return serve_html(full_fn)
-          when 'haml'; return serve_haml(full_fn, local)
-          when 'erb';  return serve_erb(full_fn, local)
-          else raise "Unrecognized file type: '#{ext}'";
-          end
-        else
-          raise "Could not find file '#{fn}' (full path '#{full_fn}')"
-        end
+      #
+      #            RENDERING
+      #
+      # Render an html file. 'fn' is a full path, or a path relative to @root_dir.
+      def render_html(fn)
+        F.read(full_path(fn))
       end
-      def serve_html(fn)
-        File.read(fn)
+      # Serve up a blob of json (just sets Content-Type to 'text/javascript' and
+      # sets the body to the json passed in to this method).
+      def render_json(json)
+        self.response[:headers]['Content-Type'] = 'text/javascript'
+        self.response[:body] = json
       end
-      def serve_haml(fn, locals = {})
+      # Render a haml file. 'fn' is a full path, or a path relative to @root_dir.
+      # 'locals' is a hash definining variables to be passed to the template.
+      def render_haml(fn, locals = {})
         if not defined? Haml
           begin
@@ -136,10 +199,12 @@ module Synfeld
           end
         end
-        Haml::Engine.new(File.read(fn) ).render(Object.new, locals)
+        Haml::Engine.new(F.read(full_path(fn)) ).render(Object.new, locals)
       end
-      def serve_erb(fn, locals = {})
+      # Render an erb file. 'fn' is a full path, or a path relative to @root_dir.
+      # 'locals' is a hash definining variables to be passed to the template.
+      def render_erb(fn, locals = {})
         if not defined? Erb
           begin
@@ -149,7 +214,7 @@ module Synfeld
           end
         end
-        template = ERB.new File.read(fn)
+        template = ERB.new F.read(full_path(fn))
         bind = binding
         locals.each do |n,v|
@@ -159,34 +224,56 @@ module Synfeld
         template.result(bind)
       end
-      def handle_static
-        fn = File.expand_path(File.join(root_dir, self.env['REQUEST_URI']))
+      def render_static
+        fn = F.expand_path(F.join(root_dir, self.env['REQUEST_URI']))
         #puts fn # dbg
-        if File.exist?(fn) and not File.directory?(fn)
+        if F.exist?(fn) and not F.directory?(fn)
           self.content_type!(fn.split('.').last)
-          File.read(fn)
+          F.read(fn)
         else
           return self.no_route
         end
       end
+      #
+      #            UTIL
+      #
+      # Given a file extention, determine the 'Content-Type' and then set the
+      # @response[:headers]['Content-Type']. Unrecognized extentions are
+      # set to content type of 'text/plain'.
       def content_type!(ext)
         case ext.downcase
-        when 'html'; t = 'text/html'
         when 'haml'; t = 'text/html'
-        when 'js'; t = 'text/javascript'
-        when 'css'; t = 'text/css'
-        when 'png'; t = 'image/png'
-        when 'gif'; t = 'image/gif'
-        when 'jpg'; t = 'image/jpeg'
-        when 'jpeg'; t = 'image/jpeg'
+        when 'erb'; t = 'text/html'
+# I believe all the rest are determined accurately by the Rack::Mime.mime_type call in the else clause below.
+#        when 'html'; t = 'text/html'
+#        when 'js'; t = 'text/javascript'
+#        when 'css'; t = 'text/css'
+#        when 'png'; t = 'image/png'
+#        when 'gif'; t = 'image/gif'
+#        when 'jpg'; t = 'image/jpeg'
+#        when 'jpeg'; t = 'image/jpeg'
+        else t = Rack::Mime.mime_type('.' + ext, 'text/plain')
         end
+        #puts("----#{ext}:" + t.inspect) # dbg
         (self.response[:headers]['Content-Type'] = t) if t
       end
-      def no_route
-          self.response[:body] = "route not found for: '#{self.env['REQUEST_URI']}'"
-          self.response[:status_code] = 404
+      # Return fn if a file by that name exists. If not, concatenate the @root_dir with the fn, and
+      # return that if it exists. Raise if the actual file cannot be determined.
+      #
+      # NOTE: no effort is made to protect access to files outside of your application's root
+      # dir. If you permit filepaths as request parameters, then it is up to you to make sure
+      # that they do not point to some sensitive part of your file-system.
+      def full_path(fn)
+        if F.exist?(fn)
+          return fn
+        elsif F.exist?(full_fn = F.join(self.root_dir, fn))
+          return full_fn
+        else
+          raise "Could not find file '#{fn}' (full path '#{full_fn}')"
+        end
       end
   end # class App

data/lib/synfeld_info.rb CHANGED

@@ -5,7 +5,7 @@ module Synfeld
   # :stopdoc:
-  VERSION = '0.0.2'
+  VERSION = '0.0.4'
   LIBPATH = ::File.expand_path(::File.dirname(__FILE__)) + ::File::SEPARATOR
   PATH = ::File.dirname(LIBPATH) + ::File::SEPARATOR

data/synfeld.gemspec CHANGED

@@ -2,27 +2,31 @@
 Gem::Specification.new do |s|
   s.name = %q{synfeld}
-  s.version = "0.0.2"
+  s.version = "0.0.4"
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Steven Swerling"]
-  s.date = %q{2009-08-29}
+  s.date = %q{2009-09-26}
   s.description = %q{Synfeld is a web application framework that does practically nothing.
-Basically this is just a tiny wrapper for the Rack::Router (see http://github.com/carllerche/rack-router). If you want a web framework that is mostly just going to serve up json blobs, and occasionally serve up some simple content (eg. for help files) and media, Synfeld makes that easy. If you need session variables, a mailer, uploading, etc, look elsewhere.
+Synfeld is little more than a small wrapper for Rack::Mount (see http://github.com/josh/rack-mount). If you want a web framework that is mostly just going to serve up json blobs, and occasionally serve up some simple content (eg. help files) and media, Synfeld makes that easy.
-The sample app below shows pretty much everything that synfeld can do.
+The sample app below shows pretty much everything there is to know about synfeld, in particular:
-Very alpha-ish stuff here. Seems to work though.}
+* How to define routes.
+* Simple rendering of erb, haml, html, json, and static files.
+* In the case of erb and haml, passing variables into the template is demonstrated.
+* A dynamic action where the status code, headers, and body are created 'manually' (/my/special/route below)
+* A simple way of creating format sensitive routes (/alphabet.html vs. /alphabet.json)
+* The erb demo link also demos the rendering of a partial (not visible in the code below, you have to look at the template file examples/public/erb_files/erb_test.erb).}
   s.email = %q{sswerling@yahoo.com}
   s.extra_rdoc_files = ["History.txt", "README.rdoc", "README.txt"]
-  s.files = [".gitignore", "History.txt", "README.rdoc", "README.txt", "Rakefile", "TODO", "example/public/erb_files/erb_test.erb", "example/public/haml_files/haml_test.haml", "example/public/haml_files/home.haml", "example/public/html_files/html_test.html", "example/try_me.rb", "example/try_me.ru", "lib/synfeld.rb", "lib/synfeld/base.rb", "lib/synfeld_info.rb", "spec/spec_helper.rb", "spec/synfeld_spec.rb", "synfeld.gemspec", "test/test_synfeld.rb"]
-  s.has_rdoc = true
+  s.files = [".gitignore", "History.txt", "README.rdoc", "README.txt", "Rakefile", "TODO", "example/public/erb_files/erb_test.erb", "example/public/haml_files/haml_test.haml", "example/public/haml_files/home.haml", "example/public/html_files/html_test.html", "example/public/images/beef_interstellar_thm.jpg", "example/public/images/rails.png", "example/try_me.rb", "example/try_me.ru", "lib/synfeld.rb", "lib/synfeld/base.rb", "lib/synfeld_info.rb", "spec/spec_helper.rb", "spec/synfeld_spec.rb", "synfeld.gemspec", "test/test_synfeld.rb", "work/rackmount-test.ru"]
   s.homepage = %q{http://tab-a.slot-z.net}
   s.rdoc_options = ["--inline-source", "--main", "README.txt"]
   s.require_paths = ["lib"]
   s.rubyforge_project = %q{synfeld}
-  s.rubygems_version = %q{1.3.2}
+  s.rubygems_version = %q{1.3.5}
   s.summary = %q{Synfeld is a web application framework that does practically nothing}
   s.test_files = ["test/test_synfeld.rb"]

data/work/rackmount-test.ru ADDED

@@ -0,0 +1,59 @@
+require 'rack/mount'
+#@usher ||= Usher.new(:generator => Usher::Util::Generators::URL.new)
+@app = proc do |env|
+  body = "Hi there #{env[ Rack::Mount::Const::RACK_ROUTING_ARGS].inspect}"
+  [
+    200,          # Status code
+    {             # Response headers
+      'Content-Type' => 'text/plain',
+      'Content-Length' => body.size.to_s,
+    },
+    [body]        # Response body
+  ]
+end
+@set = nil
+def add_a_route(opts = {})
+  method = (opts.delete(:method) || 'GET').upcase
+  string_or_regex = opts.delete(:path) || raise("You have to provide a :path")
+  colon = (RUBY_VERSION =~ /^1.8/)? ':' : ''
+  if string_or_regex.is_a?(String)
+    regex_string = "^" + string_or_regex.gsub(/:(([^\/]+))/){|s| "(?#{colon}<#{$1}>.*)" } + "$"
+    puts regex_string
+    regex = %r{#{regex_string}}
+  else
+    regex = string_or_regex
+  end
+  @set.add_route(@app,
+                {:path_info => regex, :request_method => method.upcase},
+                opts)
+end
+basic_set = Rack::Mount::RouteSet.new_without_optimizations do |set|
+  @set = set
+#  set.add_route(@app, { :path_info => %r{^/hello/(?:<hi>.*)$}, :request_method => 'GET' },
+#                     { :controller => 'spscontroller_a', :action => 'spsaction_a' })
+#  set.add_route(@app, { :path_info => %r{^/hi/(?<ho>.*)$}, :request_method => 'GET' },
+#                     { :controller => 'spscontroller_a', :action => 'spsaction_a' })
+#  set.add_route(@app, { :path_info => '/ho/steve', :request_method => 'GET' },
+#                     { :controller => 'spscontroller_a', :action => 'spsaction_a' })
+#  set.add_route(@app, { :path_info => Rack::Mount::Utils.normalize_path('/baz') },
+#                      { :controller => 'baz', :action => 'index' })
+  add_a_route(:path => '/hillo/:name',
+              :method => 'get',
+              :controller => 'spscontroller_a',
+              :action => 'spsaction_a' )
+  add_a_route( :path => '/ho/:nime/blah',
+               :controller => 'spscontroller_b',
+               :action => 'spsaction_b' )
+  add_a_route(:path => %r{^/hey/(?:<hi>.*)$}, :cont => 'cont_c', :act => 'action_c' )
+end
+run basic_set

metadata CHANGED

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: swerling-synfeld
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.4
 platform: ruby
 authors:
 - Steven Swerling
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
-date: 2009-08-29 00:00:00 -07:00
+date: 2009-09-26 00:00:00 -07:00
 default_executable:
 dependencies:
 - !ruby/object:Gem::Dependency
@@ -42,7 +42,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 2.5.1
     version:
-description: Synfeld is a web application framework that does practically nothing.  Basically this is just a tiny wrapper for the Rack::Router (see http://github.com/carllerche/rack-router). If you want a web framework that is mostly just going to serve up json blobs, and occasionally serve up some simple content (eg. for help files) and media, Synfeld makes that easy. If you need session variables, a mailer, uploading, etc, look elsewhere.  The sample app below shows pretty much everything that synfeld can do.   Very alpha-ish stuff here. Seems to work though.
+description: "Synfeld is a web application framework that does practically nothing.  Synfeld is little more than a small wrapper for Rack::Mount (see http://github.com/josh/rack-mount). If you want a web framework that is mostly just going to serve up json blobs, and occasionally serve up some simple content (eg. help files) and media, Synfeld makes that easy.   The sample app below shows pretty much everything there is to know about synfeld, in particular:  * How to define routes. * Simple rendering of erb, haml, html, json, and static files. * In the case of erb and haml, passing variables into the template is demonstrated. * A dynamic action where the status code, headers, and body are created 'manually' (/my/special/route below) * A simple way of creating format sensitive routes (/alphabet.html vs. /alphabet.json) * The erb demo link also demos the rendering of a partial (not visible in the code below, you have to look at the template file examples/public/erb_files/erb_test.erb)."
 email: sswerling@yahoo.com
 executables: []
@@ -63,6 +63,8 @@ files:
 - example/public/haml_files/haml_test.haml
 - example/public/haml_files/home.haml
 - example/public/html_files/html_test.html
+- example/public/images/beef_interstellar_thm.jpg
+- example/public/images/rails.png
 - example/try_me.rb
 - example/try_me.ru
 - lib/synfeld.rb
@@ -72,8 +74,10 @@ files:
 - spec/synfeld_spec.rb
 - synfeld.gemspec
 - test/test_synfeld.rb
-has_rdoc: true
+- work/rackmount-test.ru
+has_rdoc: false
 homepage: http://tab-a.slot-z.net
+licenses:
 post_install_message:
 rdoc_options:
 - --inline-source
@@ -96,7 +100,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubyforge_project: synfeld
-rubygems_version: 1.2.0
+rubygems_version: 1.3.5
 signing_key:
 specification_version: 3
 summary: Synfeld is a web application framework that does practically nothing