raw 0.49.0

data/doc/CONTRIBUTORS

@@ -0,0 +1,106 @@
+LEAD DEVELOPER:
+
+* George K. Moschovitis <george.moschovitis@gmail.com>
+  Project leader, architecture and design, main coder, 
+  documentation, maintainer (http://www.gmosx.com).
+
+
+TEAM NITRO:
+
+Team Nitro is group of important contributors to the project.
+
+* Jonas Pfenniger <zimba.tm@gmail.com>
+  Patches, new features, bug fixes.
+
+* Bryan Soto <bryan.a.soto@gmail.com>
+  Patches, bug fixes, docs, quality assurance, community 
+  management.
+
+* Guillaume Pierronnet <guillaume.pierronnet@laposte.net>
+  Patches, new features, bug fixes.
+
+* Thomas Sawyer <transfire@gmail.com>
+  Small bug fixes, patches.
+  
+* Jonathan Buch <jonathan.buch@gmail.net>
+  Patches, documentation.
+
+* Fabian Buch <fabian@fabian-buch.de>
+  FeedHelper, various patches.
+
+* Michael Fellinger <m.fellinger@gmail.com>
+  Patches, bug fixes.
+  
+IDEAS, ADDITIONAL CODING, SUPPORT:
+
+* Rob Pitt <rob@motionpath.co.uk>
+  Patches, Bug fixes, Scaffolding improvements.
+      
+* Chris Farmiloe <chris.farmiloe@farmiloe.com>
+  Patches, new features, bug fixes.
+  
+* Aidan Rogers <aidan@infurious.com>
+  Documentation, Bug reports, patches.
+
+* James Britt <james_b@neurogami.com>
+  Evangelising, documentation, design, additional code, bug reports.
+
+* Aleksi Niemela <Aleksi.Niemela@cs.helsinki.fi>
+  Bug fixes, patches, documentation.
+
+* Brian Bugh <brian@xsi-design.com>
+  Fixes, Patches.
+
+* Gabriele Renzi <surrender_it@yahoo.it>
+  Patches, new features.
+
+* Fang Sun <nusgnaf@gmail.com>
+  Patches.
+  
+* <neokolor@gmx.de>
+  Patches.
+  
+* Zed A. Shaw <zedshaw@zedshaw.com>
+  SCGI adapter.
+
+* Peter Abrahamsen <rainhead@gmail.com>  
+  Documentation, small patches.
+
+* Massimo Maria Ghisalberti 
+  Patches.
+
+* John A. Lambert
+  Patches.
+  
+* Dan Yoder <dan@zeraweb.com>
+  Original 'Elements' implementation, bug reports.
+    
+* Joshua Hoke
+  Patches.
+
+* Michael Neumann <mneumann@ntecs.de>
+  Wee integration, patches.
+
+* Alexander Lazic <al-nitrogen@none.at>
+  Patches, bug reports.
+
+* Darrick W <darrick@innatesoftware.com>
+  Patches.
+    
+* Anastasios Koutoumanos <ak@navel.gr>
+  Ideas, bug reports.
+
+* Kostas Nasis <kostas@nasis.com>
+  Ideas and bug reports.
+  
+
+DONATIONS:
+
+The following people have genereously donated money for the
+advancement of the Nitro project:
+
+* Jonas Pfenniger <zimba.tm@gmail.com>
+
+* Emmanuel Piperakis
+
+* Matt Bowen <matt.bowen@farweststeel.com>

data/doc/LICENSE

@@ -0,0 +1,32 @@
+The BSD License
+
+Copyright (c) 2004-2007, George K. Moschovitis. (http://www.gmosx.com)
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without 
+modification, are permitted provided that the following conditions are 
+met:
+
+* Redistributions of source code must retain the above copyright 
+notice, this list of conditions and the following disclaimer.
+  
+* Redistributions in binary form must reproduce the above copyright 
+notice, this list of conditions and the following disclaimer in the 
+documentation and/or other materials provided with the distribution.
+  
+* Neither the name of Nitro nor the names of its contributors may be 
+used to endorse or promote products derived from this software 
+without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED 
+TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

data/doc/coding_conventions.txt

@@ -0,0 +1,11 @@
+Coding conventions:
+
+* Use two spaces for identation.
+* Try to make the source code lines less than 64 chars wide. This
+  improves the visibility. But please, do not go out of the way 
+  (artificially breaking your code) to enforce this rule.
+* Use "" as delimeter for both static and dynamic strings.
+* Use 
+    alias :new :old 
+  instead of 
+    alias_method :new, :old

data/lib/raw.rb

@@ -0,0 +1,42 @@
+# = Raw, Rapid Applications for the Web 
+#
+# Copyright (c) 2004-2007, George Moschovitis (http://www.gmosx.com)
+#
+# Raw (http://www.nitroproject.org) is copyrighted free software 
+# created and maintained by George Moschovitis 
+# (mailto:george.moschovitis@gmail.com) and released under the 
+# standard BSD Licence. For details consult the file doc/LICENCE.
+
+module Raw
+  # The version of Raw.
+
+  Version = "0.50.0"
+  
+  # Library path.
+
+  LibPath = File.dirname(__FILE__)
+  
+  # The Mixin namespace
+  
+  module Mixin; end
+  
+  # Include the Mixin namespace.
+  
+  include Mixin
+end
+
+# Include Raw::Mixin in the TopLevel for extra convienience.
+
+include Raw::Mixin unless $NITRO_DONT_INCLUDE_MIXINS
+
+#--
+# gmosx: leave them here.
+#++
+
+require "raw/errors"
+require "raw/context"
+require "raw/context/global"
+require "raw/controller"
+require "raw/dispatcher"
+require "raw/render"
+require "raw/scaffold"

data/lib/raw/adapter.rb

@@ -0,0 +1,113 @@
+require "cgi"
+require "socket"
+
+require "facets/core/string/demodulize"
+require "facets/core/string/underscore"
+require "facets/core/string/humanize"
+
+require "raw/cgi"
+
+# Speeds things up, more compatible with OSX.
+
+Socket.do_not_reverse_lookup = true
+
+module Raw
+
+# The base Adapter class. All other adapters extend this class.
+# An adapter conceptually connects Nitro with a Front Web Server.
+# Please notice that many Adapters (for example Webrick and
+# Mongrel implement an 'inline' Front Web Server).
+#
+# The Adapter typically initializes a Handler to handle the
+# http requests. 
+
+class Adapter
+  
+  # Initialize the adapter.
+  
+  def initialize
+  end
+
+  # Setup the adapter (used as a hook).
+  
+  def setup(app)
+  end
+  
+  # Start the adapter.
+  
+  def start(app)
+    info "Starting #{self.class.name.demodulize.underscore.humanize} on #{app.address}:#{app.port}"
+    info "Press Ctrl-C to shutdown; Run with --help for options."
+
+    setup(app)
+  end
+  
+  # Stop the adapter.
+  
+  def stop
+    info "Stoping #{self.class.name.demodulize.underscore.humanize}."
+  end
+  
+end
+
+# This mixin provides default functionality to adapter handlers.
+
+module AdapterHandlerMixin
+
+  # Handle a context. Returns the generated output.
+  
+  def handle_context(context)
+    Cgi.parse_params(context)
+    Cgi.parse_cookies(context)    
+    
+    controller, action, query, params, ext = @application.dispatcher.dispatch_context(context)
+    context.content_type = context.format.content_type
+    
+    Thread.current[:CURRENT_CONTROLLER] = controller
+    controller = controller.new(context)
+
+    controller.send(action, params)
+    # res.chunked = true if controller.out.is_a?(IO) and context["SERVER_PROTOCOL"] == "HTTP/1.1"    
+  rescue RenderExit, ActionExit => e1
+    # Just stop rendering.     
+    
+  rescue ActionError => e2
+    # Client Error family of errors, typically send 4XX
+    # status code.
+    debug e2.to_s if $DBG
+        
+  rescue Object => e3
+    # Server Error family of errors, typically send 5XX
+    # status code.
+    error "Error while handling '#{context.uri}'"
+    error pp_exception(e3)
+    
+  ensure
+    Og.manager.put_store if defined?(Og) and Og.respond_to?(:manager) and Og.manager
+    return context.output_buffer
+  end
+  
+  # Try to rewrite the path to a filename.
+
+  def rewrite(req)
+    if req.path_info == "/"
+      req.path_info = "/index.html" 
+    elsif req.path_info =~ /^([^.]+)$/
+      req.path_info = "#{$1}.html" 
+    end
+  end
+
+  # Rewrite back to the original path.
+
+  def unrewrite(req)
+    if req.path_info == "/index.html"
+      req.path_info = "/" 
+    elsif req.path_info =~ /^([^.]+)\.html$/    
+      req.path_info = $1 
+    end
+  end
+
+end
+
+
+end

data/lib/raw/adapter/cgi.rb

@@ -0,0 +1,41 @@
+require "cgi"
+require "stringio"
+require "tempfile"
+
+require "raw/adapter"
+
+#--
+# Adapt the default CGI object to suit Nitro.
+#++
+
+class CGI # :nodoc: all
+  def env
+    ENV
+  end
+end
+
+# No multi-threading.
+
+Og.thread_safe = false if defined?(Og) and Og.respond_to?(:thread_safe)
+
+module Raw
+
+# A plain CGI adapter. To be used only in development 
+# environments, this adapter is *extremely* slow for
+# live/production environments. This adapter is provided for
+# the sake of completeness.
+
+class CgiAdapter
+  #--
+  # No need for connection pooling, CGI uses process.
+  #++
+  
+  def self.start(server)
+    cgi = CGI.new
+    Router.strip_path = cgi.env["SCRIPT_NAME"]
+    Cgi.process(server, cgi, $stdin, $stdout)
+  end
+  
+end
+
+end

data/lib/raw/adapter/fastcgi.rb

@@ -0,0 +1,48 @@
+require 'cgi'
+require 'fcgi'
+
+require "raw/context"
+require "raw/dispatcher"
+require "raw/cgi"
+
+# Speeds things up, more comaptible with OSX.
+
+Socket.do_not_reverse_lookup = true
+
+# No multi-threading.
+
+Og.thread_safe = false if defined?(Og) and Og.respond_to?(:thread_safe)
+
+module Raw
+
+# FastCGI Adaptor. FastCGI is a language independent, 
+# scalable, open extension to CGI that provides high 
+# performance without the limitations of server 
+# specific APIs.
+#
+# === Sessions
+#
+# As FCGI is process based, you have can't use the default
+# in-memory session store. For production web sites you should
+# use the drb session store. Moreover, there is no need for 
+# DB connection pooling in Og.
+#
+#--
+# gmosx: I always thought that the concept of FastCGI is stupid!
+# Why don't you use a proxy setup? (For example Apache + Mongrel)
+#++
+
+class FastCGI
+
+  def self.start(server)
+    FCGI.each do |cgi|
+      begin
+        Cgi.process(server, cgi, cgi.in, cgi.out)
+        cgi.finish
+      end
+    end
+  end
+
+end
+
+end

data/lib/raw/adapter/mongrel.rb

@@ -0,0 +1,146 @@
+require "stringio"
+
+require "mongrel"
+require "mongrel/handlers"
+
+require "raw/adapter"
+
+#--
+# Customize Mongrel to make compatible with Nitro.
+#++
+
+module Mongrel # :nodoc: all
+
+  class HttpRequest
+    def method_missing(name, *args)
+      if @params.has_key?(name.to_s.upcase)
+        return @params[name.to_s.upcase]
+      elsif name.to_s =~ /\A(.*)=\Z/ && @params.has_key?($1.upcase)
+        @params[$1.upcase] = args[0]
+      else
+        super
+      end
+    end
+  end
+
+end
+
+module Raw
+
+# A Mongrel Adapter.
+#
+# Mongrel is a fast HTTP library and server for Ruby that is 
+# intended for hosting Ruby web applications of any kind using 
+# plain HTTP rather than FastCGI or SCGI. 
+#
+# This is the preferred adapter for production Nitro 
+# applications.
+
+class MongrelAdapter < Adapter
+
+  def start(application)
+    super
+    
+    @mongrel = Mongrel::Configurator.new(:host => application.address) do
+      listener(:port => application.port) do
+        uri "/", :handler => MongrelHandler.new(application)
+        trap("INT") { stop(application) }
+        run
+      end
+    end
+
+    @mongrel.join()
+  end
+  
+  def stop
+    super
+    @mongrel.stop()
+  end
+
+end
+
+# The Mongrel Handler, handles an HTTP request.
+
+class MongrelHandler < Mongrel::HttpHandler
+  include AdapterHandlerMixin
+  
+  def initialize(application)
+    @application = application
+  end
+  
+  # Handle a static file. Also handles cached pages. Typically
+  # *not* used in production applications.
+
+  def handle_file(req, res)
+    return false unless @application.handle_static_files    
+
+    filename = File.join(@application.public_dir, req.path_info).squeeze("/")
+
+    File.open(filename, "rb") do |f|
+      # TODO: check whether path circumvents public_root directory?
+      res.status = 200
+      res.body << f.read # XXX inefficient for large files, may cause leaks
+    end
+    
+    return true
+  rescue Errno::ENOENT => ex # TODO: Lookup Win32 error for 'file missing'
+    return false
+  end
+
+  # Handle the request.
+  #--
+  # TODO: recode this like the camping mongrel handler.
+  #++
+  
+  def process(req, res)
+    # Perform default rewriting rules.
+    
+    rewrite(req)
+
+    # First, try to serve a static file from disk.
+
+    return if handle_file(req, res)
+
+    context = Context.new(@application)
+
+    if req.body.is_a? String
+      context.in = StringIO.new(req.body)
+    else
+      context.in =   req.body
+    end
+
+    context.headers = {}
+    req.params.each { |h, v|
+      if h =~ /\AHTTP_(.*)\Z/
+        context.headers[$1.gsub("_", "-")] = v
+      end
+      context.headers[h] = v
+    }
+    
+    # hackfix: make it behave like webrick and fcgi
+    context.headers["REQUEST_URI"] << "?#{context.headers['QUERY_STRING']}" if context.headers["QUERY_STRING"]
+    context.headers["QUERY_STRING"] ||= ""
+
+    output = handle_context(context)
+
+    # THINK: what is the error code if a request without a handler 
+    # is comming?!
+    
+    res.start(context.status, true) do |head, out|
+      context.response_headers.each do |key, value|
+        head[key] = value
+      end
+      
+      context.response_cookies.each do |cookie|
+        head["Set-Cookie"] = cookie
+      end if context.response_cookies
+      
+      out.write(output)
+    end
+  
+    context.close
+  end  
+  
+end
+
+end