serverside 0.1.59

data/CHANGELOG

@@ -0,0 +1,97 @@
+*SVN*
+
+* Added a profiled version of a static server - /test/functional/static_profile.rb.
+
+* Added freezing of HTTP headers.
+
+* Small change to documentation.
+ 
+* Changed filename for cluster pid file to serverside_cluster.pid.
+
+* Added documentation.
+
+* Fixed require in serverside script to load the gem.
+
+* Fixed the Daemon pid file for static file server mode.
+
+* Added directory listing to static file server.
+
+* Fixed request header parsing Regexp so a trailing slash would be ignored. 
+
+* Added static application. Using the binary script in static mode works.
+
+* Added cluster class with unit tests.
+
+* Added unit tests for static server.
+
+* Added static server functional test.
+
+* Added static file serving code.
+
+* Renamed ServerSide::Request to ServerSide::Connection. This is more appropriate.
+
+* Added functional static server test.
+
+* Added test/functional for functional tests. Updated Rakefile.
+
+* Added Request.send_response and stream.
+
+* Added faster Symbol.to_s to core_ext.
+
+* Added HTTP parsing code with unit tests.
+
+* Started adding request code.
+
+* More unit tests for application code.
+
+* Basic server code works with unit tests.
+
+* Started work on application code.
+
+* Added option parsing to serverside script.
+
+* Added daemon code and unit tests.
+
+* Created serverside script.
+
+* Created Gem spec.
+
+* Created directory structure.
+
+*Mongrel-based branch*
+
+* Added host attribute to Controller::Request.
+
+* Added ability to create rules on any request attribute, not just path.
+
+* Added ability to mount controllers with a block for a rule.
+
+* Wrote object extensions to create frozen constants on the fly.
+
+* Changed DirHandler to use frozen strings for cache header.
+
+* Hooked Mongrel server to Controller::Router.
+
+* Imported request code with unit tests.
+
+* Wrote unit tests for daemon module.
+
+* Wrote unit tests for controller routing code.
+
+* Refactored controller routing code.
+
+* Imported unit tests for extensions.
+
+* Created Rakefile.
+
+* Prototypical routing code.
+
+* Fixed location of daemon pid files.
+
+* Imported Mongrel code from Reality project.
+
+* Imported extensions from Reality project.
+
+* Implemented daemon and server cluster.
+
+* Basic configuration infrastructure is ready.

data/COPYING

@@ -0,0 +1,18 @@
+Copyright (c) 2006 Sharon Rosner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to
+deal in the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+  
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+   
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+THE AUTHORS 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

@@ -0,0 +1,51 @@
+= about ServerSide
+
+ServerSide is an HTTP server framework designed to be as fast as possible, and
+as easy as possible to use. ServerSide includes a full-featured HTTP server, a
+controller-view system and a bunch of other tools to easily create servers and
+clusters of servers.
+
+== Installation
+
+<tt>sudo gem install serverside</tt>
+
+== Source Code
+
+http://serverside.googlecode.com/svn/
+
+== The Daemon
+
+Once you have the ServerSide gem installed, you can use the <tt>serverside</tt>
+script to control servers. For example:
+
+<tt>serverside -p 8000 start .</tt>
+
+will start an HTTP server, serving the content of the working directory. You can
+stop the server by running <tt>serverside stop .</tt>
+ 
+== Serving Dynamic Content
+
+You can use the ServerSide::Application and ServerSide::Controller classes to
+create dynamic web applications. The ServerSide framework also lets you route
+requests based on any attribute of incoming requests, such as host name, path,
+URL parameters etc.
+
+To start your app, you can either supply the <tt>serverside</tt> script with 
+your Ruby code file:
+
+<tt>serverside start ~/myapp/myapp.rb</tt>
+
+Or you can put your code in a file called <tt>serverside.rb</tt> and tell the
+<tt>serverside</tt> script the directory path:
+
+<tt>serverside start /home/nc/reality/production</tt>
+
+The script will then load <tt>/home/nc/reality/production/serverside.rb</tt> and
+take care of everything else.
+
+== Running a Cluster of Servers
+
+ServerSide makes it easy to control a cluster of servers. Just supply a range of
+ports instead of a single port:
+
+<tt>serverside -p 8000..8009 start .</tt>

data/Rakefile

@@ -0,0 +1,92 @@
+require 'rake'
+require 'rake/clean'
+require 'rake/gempackagetask'
+require 'rake/rdoctask'
+require 'rake/testtask'
+require 'fileutils'
+include FileUtils
+
+NAME = "serverside"
+REV = File.read(".svn/entries")[/committed-rev="(\d+)"/, 1] rescue nil
+VERS = "0.1" + (REV ? ".#{REV}" : "")
+CLEAN.include ['**/.*.sw?', '*.gem', '.config']
+RDOC_OPTS = ['--quiet', '--title', "ServerSide Documentation",
+    "--opname", "index.html",
+    "--line-numbers", 
+    "--main", "README",
+    "--inline-source"]
+
+desc "Packages up ServerSide."
+task :default => [:package]
+task :package => [:clean]
+
+task :doc => [:rdoc]
+
+Rake::RDocTask.new do |rdoc|
+    rdoc.rdoc_dir = 'doc/rdoc'
+    rdoc.options += RDOC_OPTS
+    rdoc.main = "README"
+    rdoc.title = "ServerSide Documentation"
+    rdoc.rdoc_files.add ['README', 'CHANGELOG', 'COPYING', 'lib/serverside.rb', 'lib/serverside/*.rb']
+end
+
+spec =
+    Gem::Specification.new do |s|
+        s.name = NAME
+        s.version = VERS
+        s.platform = Gem::Platform::RUBY
+        s.has_rdoc = true
+        s.extra_rdoc_files = ["README", "CHANGELOG", "COPYING"]
+        s.rdoc_options += RDOC_OPTS + 
+          ['--exclude', '^(examples|extras)\/', '--exclude', 'lib/serverside.rb']
+        s.summary = "Performance-oriented web framework."
+        s.description = s.summary
+        s.author = "Sharon Rosner"
+        s.email = 'ciconia@gmail.com'
+        s.homepage = 'http://code.google.com/p/serverside/'
+        s.executables = ['serverside']
+
+        s.add_dependency('metaid')
+        s.required_ruby_version = '>= 1.8.2'
+
+        s.files = %w(COPYING README Rakefile) +
+          Dir.glob("{bin,doc,test,lib}/**/*") 
+        
+        s.require_path = "lib"
+        s.bindir = "bin"
+    end
+
+Rake::GemPackageTask.new(spec) do |p|
+    p.need_tar = true
+    p.gem_spec = spec
+end
+
+task :install do
+  sh %{rake package}
+  sh %{sudo gem install pkg/#{NAME}-#{VERS}}
+end
+
+task :uninstall => [:clean] do
+  sh %{sudo gem uninstall #{NAME}}
+end
+
+desc 'Run unit tests'
+Rake::TestTask.new('test_unit') do |t|
+  t.libs << 'test'
+  t.pattern = 'test/unit/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Run functional tests'
+Rake::TestTask.new('test_functional') do |t|
+  t.libs << 'test'
+  t.pattern = 'test/functional/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Run all tests'
+Rake::TestTask.new('test') do |t|
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end

data/bin/serverside

@@ -0,0 +1,74 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'serverside'
+require 'optparse'
+
+$cmd_config = {
+  :host => '0.0.0.0',
+  :ports => 8000..8000
+}
+
+opts = OptionParser.new do |opts|
+  opts.banner = "Usage: serverside start|stop|restart [app1 app2 ...]"
+  opts.define_head "ServerSide, a fast and simple web framework for ruby."
+  opts.separator ""
+  opts.separator "The supplied app paths can be directory or file references."
+  opts.separator ""
+  opts.separator "Options:"
+
+  opts.on("-h", "--host HOSTNAME", "Host to bind to (default is all IPs)") do |v|
+    $cmd_config[:host] = v
+  end
+  opts.on("-p", "--port NUM", "Port or port range (default is 8000)") do |v|
+    $cmd_config[:ports] = (v =~ /\.\./) ? eval(v) : v.to_i..v_to_i 
+  end
+
+  # No argument, shows at tail.  This will print an options summary.
+  # Try it and see!
+  opts.on_tail("-?", "--help", "Show this message") do
+    puts opts
+    exit
+  end
+
+  # Another typical switch to print the version.
+  opts.on_tail("-v", "--version", "Show version") do
+    class << Gem; attr_accessor :loaded_specs; end
+    specs = Gem.loaded_specs['serverside']
+    puts "ServerSide #{specs.version} (#{specs.date.strftime '%Y-%m-%d'})"
+    exit
+  end
+
+end
+
+opts.parse! ARGV
+if ARGV.length < 1
+  puts opts
+  exit
+end
+
+$cmd = ARGV.shift
+unless %w(start stop restart).include?($cmd)
+  puts "Invalid command specified. Known commands are: start, stop, restart."
+  exit
+end
+
+puts $cmd_config.inspect
+
+ARGV << '.' if ARGV.empty?
+path = ARGV.shift
+if File.file?(path)
+  puts "Application file #{path}"
+  require path
+  ServerSide::Application.daemonize($cmd)
+else
+  fn = File.join(path, 'serverside.rb')
+  if File.file?(fn)
+    puts "Application file #{fn}"
+    require fn
+    ServerSide::Application.daemonize($cmd)
+  else
+    puts "Static file server #{path}"
+    ServerSide::Application::Static.daemonize($cmd_config, $cmd)
+  end
+end

data/doc/rdoc/classes/Daemon.html

@@ -0,0 +1,253 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>Module: Daemon</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+
+    elemStyle = elem.style;
+    
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+
+    return true;
+  }
+  
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
+  
+  // ]]>
+  </script>
+
+</head>
+<body>
+
+
+
+    <div id="classHeader">
+        <table class="header-table">
+        <tr class="top-aligned-row">
+          <td><strong>Module</strong></td>
+          <td class="class-name-in-header">Daemon</td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>In:</strong></td>
+            <td>
+                <a href="../files/lib/serverside/daemon_rb.html">
+                lib/serverside/daemon.rb
+                </a>
+        <br />
+                <a href="../files/lib/serverside/cluster_rb.html">
+                lib/serverside/cluster.rb
+                </a>
+        <br />
+            </td>
+        </tr>
+
+        </table>
+    </div>
+  <!-- banner header -->
+
+  <div id="bodyContent">
+
+
+
+  <div id="contextContent">
+
+    <div id="description">
+      <p>
+The <a href="Daemon.html">Daemon</a> module takes care of starting and
+stopping daemons.
+</p>
+
+    </div>
+
+
+   </div>
+
+    <div id="method-list">
+      <h3 class="section-bar">Methods</h3>
+
+      <div class="name-list">
+      <a href="#M000005">control</a>&nbsp;&nbsp;
+      <a href="#M000006">start</a>&nbsp;&nbsp;
+      <a href="#M000007">stop</a>&nbsp;&nbsp;
+      </div>
+    </div>
+
+  </div>
+
+
+    <!-- if includes -->
+
+    <div id="section">
+
+    <div id="class-list">
+      <h3 class="section-bar">Classes and Modules</h3>
+
+      Module <a href="Daemon/PidFile.html" class="link">Daemon::PidFile</a><br />
+Class <a href="Daemon/Base.html" class="link">Daemon::Base</a><br />
+Class <a href="Daemon/Cluster.html" class="link">Daemon::Cluster</a><br />
+
+    </div>
+
+    <div id="constants-list">
+      <h3 class="section-bar">Constants</h3>
+
+      <div class="name-list">
+        <table summary="Constants">
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">WorkingDirectory</td>
+          <td>=</td>
+          <td class="context-item-value">FileUtils.pwd</td>
+        </tr>
+        </table>
+      </div>
+    </div>
+
+
+
+      
+
+
+    <!-- if method_list -->
+    <div id="methods">
+      <h3 class="section-bar">Public Class methods</h3>
+
+      <div id="method-M000005" class="method-detail">
+        <a name="M000005"></a>
+
+        <div class="method-heading">
+          <a href="#M000005" class="method-signature">
+          <span class="method-name">control</span><span class="method-args">(daemon, cmd = nil)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Controls a daemon according to the supplied command or command-line
+parameter. If an invalid command is specified, an error is raised.
+</p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000005-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000005-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/serverside/daemon.rb, line 31</span>
+31:   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">control</span>(<span class="ruby-identifier">daemon</span>, <span class="ruby-identifier">cmd</span> = <span class="ruby-keyword kw">nil</span>)
+32:     <span class="ruby-keyword kw">case</span> (<span class="ruby-identifier">cmd</span> <span class="ruby-operator">||</span> (<span class="ruby-operator">!</span><span class="ruby-constant">ARGV</span>.<span class="ruby-identifier">empty?</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-constant">ARGV</span>[<span class="ruby-value">0</span>]) <span class="ruby-operator">||</span> <span class="ruby-identifier">:nil</span>).<span class="ruby-identifier">to_sym</span>
+33:     <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:start</span>
+34:       <span class="ruby-identifier">start</span>(<span class="ruby-identifier">daemon</span>)
+35:     <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:stop</span>
+36:       <span class="ruby-identifier">stop</span>(<span class="ruby-identifier">daemon</span>)
+37:     <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:restart</span>
+38:       <span class="ruby-identifier">stop</span>(<span class="ruby-identifier">daemon</span>)
+39:       <span class="ruby-identifier">start</span>(<span class="ruby-identifier">daemon</span>)
+40:     <span class="ruby-keyword kw">else</span>
+41:       <span class="ruby-identifier">raise</span> <span class="ruby-value str">'Invalid command. Please specify start, stop or restart.'</span>
+42:     <span class="ruby-keyword kw">end</span>
+43:   <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000006" class="method-detail">
+        <a name="M000006"></a>
+
+        <div class="method-heading">
+          <a href="#M000006" class="method-signature">
+          <span class="method-name">start</span><span class="method-args">(daemon)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Starts the daemon by forking and bcoming session leader.
+</p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000006-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000006-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/serverside/daemon.rb, line 46</span>
+46:   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">start</span>(<span class="ruby-identifier">daemon</span>)
+47:     <span class="ruby-identifier">fork</span> <span class="ruby-keyword kw">do</span>
+48:       <span class="ruby-constant">Process</span>.<span class="ruby-identifier">setsid</span>
+49:       <span class="ruby-identifier">exit</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">fork</span>
+50:       <span class="ruby-constant">PidFile</span>.<span class="ruby-identifier">store</span>(<span class="ruby-identifier">daemon</span>, <span class="ruby-constant">Process</span>.<span class="ruby-identifier">pid</span>)
+51:       <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">chdir</span> <span class="ruby-constant">WorkingDirectory</span>
+52:       <span class="ruby-constant">File</span>.<span class="ruby-identifier">umask</span> <span class="ruby-value">0000</span>
+53:       <span class="ruby-constant">STDIN</span>.<span class="ruby-identifier">reopen</span> <span class="ruby-value str">&quot;/dev/null&quot;</span>
+54:       <span class="ruby-constant">STDOUT</span>.<span class="ruby-identifier">reopen</span> <span class="ruby-value str">&quot;/dev/null&quot;</span>, <span class="ruby-value str">&quot;a&quot;</span>
+55:       <span class="ruby-constant">STDERR</span>.<span class="ruby-identifier">reopen</span> <span class="ruby-constant">STDOUT</span>
+56:       <span class="ruby-identifier">trap</span>(<span class="ruby-value str">&quot;TERM&quot;</span>) {<span class="ruby-identifier">daemon</span>.<span class="ruby-identifier">stop</span>; <span class="ruby-identifier">exit</span>}
+57:       <span class="ruby-identifier">daemon</span>.<span class="ruby-identifier">start</span>
+58:     <span class="ruby-keyword kw">end</span>
+59:   <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000007" class="method-detail">
+        <a name="M000007"></a>
+
+        <div class="method-heading">
+          <a href="#M000007" class="method-signature">
+          <span class="method-name">stop</span><span class="method-args">(daemon)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Stops the daemon by sending it a TERM signal.
+</p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000007-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000007-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/serverside/daemon.rb, line 62</span>
+62:   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">stop</span>(<span class="ruby-identifier">daemon</span>)
+63:     <span class="ruby-identifier">pid</span> = <span class="ruby-constant">PidFile</span>.<span class="ruby-identifier">recall</span>(<span class="ruby-identifier">daemon</span>)
+64:     <span class="ruby-constant">FileUtils</span>.<span class="ruby-identifier">rm</span>(<span class="ruby-identifier">daemon</span>.<span class="ruby-identifier">pid_fn</span>)
+65:     <span class="ruby-identifier">pid</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-constant">Process</span>.<span class="ruby-identifier">kill</span>(<span class="ruby-value str">&quot;TERM&quot;</span>, <span class="ruby-identifier">pid</span>)
+66:   <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+
+    </div>
+
+
+  </div>
+
+
+<div id="validator-badges">
+  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+</div>
+
+</body>
+</html>