trellis 0.0.1

data/README

@@ -0,0 +1,156 @@
+= Project: Trellis
+
+Trellis is a component-based Web Application Framework written in Ruby. 
+Its main goal is to bring component-driven development to the micro-framework world. 
+The framework aims to be a zero-configuration framework. 
+
+It draws inspiration from:
+
+Ruby Web Frameworks
+===================
+* Rails
+* Camping
+* Merb
+* Iowa
+* Sinatra
+
+Java Web Frameworks
+===================
+* Tapesty
+* Wicket
+* The good parts of JSF (components)
+
+Others
+======
+* Seaside
+
+== Goals 
+Accomplished goals are marked with a (*)
+- * Pure HTML templates or in-line template creation with Markaby or HAML
+- * To abstract away the request-response nature of web development and replace 
+  with events and listeners
+- * Reusable, extensible components including invisible components (behavior 
+  providers), tags (stateless components) or stateful components
+- Easy component composition and markup inheritance
+- * Multi-threading support 
+- * Heavy CoC :-) (Convention Over Configuration) ala Rails
+- * No static code generation, no generators, just a Ruby file!
+- * Component Libraries as Gems
+- * Solid Ajax support attached to the event model using a single* massively tested
+  Ajax framework/toolkit such as JQuery
+- Skinnable components a la DotNet. That is the ability to apply a theme to a 
+  page and cascade that to the contained components
+- Support for continuations in a componentized fashion (maybe)
+- CRUD behaviours for Pages/Components and using Datamapper under the covers
+- Web-based debugging and administration of the application similar to what
+  Seaside provides
+
+== Development Goals (To-do's)
+
+- Keep the core framework in a single file
+- Keep the core components in another file
+- I have not done anything about exception handling (didn't wanted to litter the
+  code base). Currently I'm always sending an HTTP 200 back or I'm just letting 
+  the app blow chuncks and showing rack's exception page
+- Radius usage is really entrenched in the current component implementation need
+  to clean it up
+- Currently Trellis uses the Mongrel Rack Adapter. In the near future the 
+  particular web server would be configurable (one of the reasons to use Rack)
+
+== Classes
+
+Trellis::Application:: Base case for all Trellis applications
+Trellis::Page:: Base class for all application Pages
+Trellis::Renderer:: Renders XML/XHTML tags in the markup using Radius 
+Trellis::Component:: Base class for all Trellis components (work in progress)
+Trellis::DefaultRouter:: Encapsulates the default routing logic
+
+== <b>Notes</b>:: 
+
+* Event model is pretty shallow right now. Basically events are just
+  a convention of how the URLs are interpreted which results on a page method
+  being invoked. A given URL contains information about the target page, event, 
+  source of the event and possible context values.This information is used to 
+  map to a single method in the page.
+* Navigation is a la Tapestry; Page methods can return the instance of a 
+  injected Page or they can return self in which case the same page is 
+  re-rendered.
+* Component can register their event handlers with the page. The page wraps the
+  event handlers of the contained components and dispatches the events to the 
+  component instance. 
+* Currently the Application is a single object, the multi-threading (which I had 
+  nothing to do with is provided by Rack) happens in the request dispatching. 
+* Trellis is not a managed framework like Tapestry, in that sense it is more like 
+  Wicket. Pages instances are just created when needed, there is no pooling, 
+  or any of the complexity involved in activating/passivating objects to a pool.
+
+== Installation
+
+* <tt>gem install trellis</tt>
+
+A Trellis application consists of the Application class; a descendant of 
+Trellis::Application and one or more pages; descendants of Trellis::Page. The
+Application at a minimum needs to declare the starting or home page:
+
+  module Hello
+    class HelloWorld < Trellis::Application
+      home :home
+    end
+
+    class Home < Trellis::Page 
+      template do html { body { h1 "Hello World!" }} end
+    end
+  end
+
+To run the above application simply add the line:
+
+  Hello::HelloWorld.new.start
+
+That will start the application on Mongrel running on port 3000 by default. To 
+run on any other port pass the port number to the start method like:
+
+  Hello::HelloWorld.new.start 8282
+
+== Required Gems
+
+rack => http://rack.rubyforge.org
+mongrel => http://mongrel.rubyforge.org
+radius => http://radius.rubyforge.org
+builder => http://builder.rubyforge.org
+paginator => http://paginator.rubyforge.org
+hpricot => http://code.whytheluckystiff.net/hpricot
+extensions => http://extensions.rubyforge.org
+haml => http://haml.hamptoncatlin.com
+markaby => http://code.whytheluckystiff.net/markaby
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright &169;2001-2009 Integrallis Software, LLC.
+
+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 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.
+
+== Contact
+
+Author::     Brian Sam-Bodden
+Email::      bsbodden@integrallis.com
+Home Page::  http://integrallis.com
+License::    MIT Licence (http://www.opensource.org/licenses/mit-license.html)

data/README.txt

@@ -0,0 +1,156 @@
+= Project: Trellis
+
+Trellis is a component-based Web Application Framework written in Ruby. 
+Its main goal is to bring component-driven development to the micro-framework world. 
+The framework aims to be a zero-configuration framework. 
+
+It draws inspiration from:
+
+Ruby Web Frameworks
+===================
+* Rails
+* Camping
+* Merb
+* Iowa
+* Sinatra
+
+Java Web Frameworks
+===================
+* Tapesty
+* Wicket
+* The good parts of JSF (components)
+
+Others
+======
+* Seaside
+
+== Goals 
+Accomplished goals are marked with a (*)
+- * Pure HTML templates or in-line template creation with Markaby or HAML
+- * To abstract away the request-response nature of web development and replace 
+  with events and listeners
+- * Reusable, extensible components including invisible components (behavior 
+  providers), tags (stateless components) or stateful components
+- Easy component composition and markup inheritance
+- * Multi-threading support 
+- * Heavy CoC :-) (Convention Over Configuration) ala Rails
+- * No static code generation, no generators, just a Ruby file!
+- * Component Libraries as Gems
+- * Solid Ajax support attached to the event model using a single* massively tested
+  Ajax framework/toolkit such as JQuery
+- Skinnable components a la DotNet. That is the ability to apply a theme to a 
+  page and cascade that to the contained components
+- Support for continuations in a componentized fashion (maybe)
+- CRUD behaviours for Pages/Components and using Datamapper under the covers
+- Web-based debugging and administration of the application similar to what
+  Seaside provides
+
+== Development Goals (To-do's)
+
+- Keep the core framework in a single file
+- Keep the core components in another file
+- I have not done anything about exception handling (didn't wanted to litter the
+  code base). Currently I'm always sending an HTTP 200 back or I'm just letting 
+  the app blow chuncks and showing rack's exception page
+- Radius usage is really entrenched in the current component implementation need
+  to clean it up
+- Currently Trellis uses the Mongrel Rack Adapter. In the near future the 
+  particular web server would be configurable (one of the reasons to use Rack)
+
+== Classes
+
+Trellis::Application:: Base case for all Trellis applications
+Trellis::Page:: Base class for all application Pages
+Trellis::Renderer:: Renders XML/XHTML tags in the markup using Radius 
+Trellis::Component:: Base class for all Trellis components (work in progress)
+Trellis::DefaultRouter:: Encapsulates the default routing logic
+
+== <b>Notes</b>:: 
+
+* Event model is pretty shallow right now. Basically events are just
+  a convention of how the URLs are interpreted which results on a page method
+  being invoked. A given URL contains information about the target page, event, 
+  source of the event and possible context values.This information is used to 
+  map to a single method in the page.
+* Navigation is a la Tapestry; Page methods can return the instance of a 
+  injected Page or they can return self in which case the same page is 
+  re-rendered.
+* Component can register their event handlers with the page. The page wraps the
+  event handlers of the contained components and dispatches the events to the 
+  component instance. 
+* Currently the Application is a single object, the multi-threading (which I had 
+  nothing to do with is provided by Rack) happens in the request dispatching. 
+* Trellis is not a managed framework like Tapestry, in that sense it is more like 
+  Wicket. Pages instances are just created when needed, there is no pooling, 
+  or any of the complexity involved in activating/passivating objects to a pool.
+
+== Installation
+
+* <tt>gem install trellis</tt>
+
+A Trellis application consists of the Application class; a descendant of 
+Trellis::Application and one or more pages; descendants of Trellis::Page. The
+Application at a minimum needs to declare the starting or home page:
+
+  module Hello
+    class HelloWorld < Trellis::Application
+      home :home
+    end
+
+    class Home < Trellis::Page 
+      template do html { body { h1 "Hello World!" }} end
+    end
+  end
+
+To run the above application simply add the line:
+
+  Hello::HelloWorld.new.start
+
+That will start the application on Mongrel running on port 3000 by default. To 
+run on any other port pass the port number to the start method like:
+
+  Hello::HelloWorld.new.start 8282
+
+== Required Gems
+
+rack => http://rack.rubyforge.org
+mongrel => http://mongrel.rubyforge.org
+radius => http://radius.rubyforge.org
+builder => http://builder.rubyforge.org
+paginator => http://paginator.rubyforge.org
+hpricot => http://code.whytheluckystiff.net/hpricot
+extensions => http://extensions.rubyforge.org
+haml => http://haml.hamptoncatlin.com
+markaby => http://code.whytheluckystiff.net/markaby
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright &169;2001-2009 Integrallis Software, LLC.
+
+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 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.
+
+== Contact
+
+Author::     Brian Sam-Bodden
+Email::      bsbodden@integrallis.com
+Home Page::  http://integrallis.com
+License::    MIT Licence (http://www.opensource.org/licenses/mit-license.html)

data/Rakefile

@@ -0,0 +1,4 @@
+require 'config/requirements'
+require 'config/hoe' # setup Hoe + all gem configuration
+
+Dir['tasks/**/*.rake'].each { |rake| load rake }

data/config/hoe.rb

@@ -0,0 +1,83 @@
+require 'trellis/version'
+
+AUTHOR = 'Brian Sam-Bodden' 
+EMAIL = "bsbodden@integrallis.com"
+DESCRIPTION = "A component based web framework"
+GEM_NAME = 'trellis' 
+RUBYFORGE_PROJECT = 'trellis'
+HOMEPATH = "http://#{RUBYFORGE_PROJECT}.rubyforge.org"
+DOWNLOAD_PATH = "http://rubyforge.org/projects/#{RUBYFORGE_PROJECT}"
+EXTRA_DEPENDENCIES = [
+  ['paginator', '>= 1.1.1'],
+  ['rack', '>= 0.4.0'],
+  ['radius', '>= 0.5.1'],
+  ['builder', '>= 2.1.2'],
+  ['hpricot', '>= 0.6.0'],
+  ['extensions', '>= 0.6.0'],
+  ['haml', '>= 2.0.3'],
+  ['RedCloth', '>= 4.0.3'],
+  ['BlueCloth', '>= 1.0.0'],
+  ['markaby', '>= 0.5'],
+  ['log4r', '>= 1.0.5'],
+  ['dm-core', '>= 0.9.5'],
+  ['dm-validations', '>= 0.9.5'],
+  ['dm-timestamps', '>= 0.9.5'],
+  ['english', '>= 0.2.0']  
+]    # An array of rubygem dependencies [name, version]
+
+@config_file = "~/.rubyforge/user-config.yml"
+@config = nil
+RUBYFORGE_USERNAME = "bsbodden"
+def rubyforge_username
+  unless @config
+    begin
+      @config = YAML.load(File.read(File.expand_path(@config_file)))
+    rescue
+      puts <<-EOS
+ERROR: No rubyforge config file found: #{@config_file}
+Run 'rubyforge setup' to prepare your env for access to Rubyforge
+ - See http://newgem.rubyforge.org/rubyforge.html for more details
+      EOS
+      exit
+    end
+  end
+  RUBYFORGE_USERNAME.replace @config["username"]
+end
+
+
+REV = nil
+VERS = Trellis::VERSION::STRING + (REV ? ".#{REV}" : "")
+RDOC_OPTS = ['--quiet', '--title', 'trellis documentation',
+    "--opname", "index.html",
+    "--line-numbers",
+    "--main", "README",
+    "--inline-source"]
+
+class Hoe
+  def extra_deps
+    @extra_deps.reject! { |x| Array(x).first == 'hoe' }
+    @extra_deps
+  end
+end
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+$hoe = Hoe.new(GEM_NAME, VERS) do |p|
+  p.developer(AUTHOR, EMAIL)
+  p.description = DESCRIPTION
+  p.summary = DESCRIPTION
+  p.url = HOMEPATH
+  p.rubyforge_name = RUBYFORGE_PROJECT if RUBYFORGE_PROJECT
+  p.test_globs = ["test/**/test_*.rb"]
+  p.clean_globs |= ['**/.*.sw?', '*.gem', '.config', '**/.DS_Store']  #An array of file patterns to delete on clean.
+
+  # == Optional
+  p.changes = p.paragraphs_of("History.txt", 0..1).join("\n\n")
+  p.extra_deps = EXTRA_DEPENDENCIES
+end
+
+CHANGES = $hoe.paragraphs_of('History.txt', 0..1).join("\\n\\n")
+PATH    = (RUBYFORGE_PROJECT == GEM_NAME) ? RUBYFORGE_PROJECT : "#{RUBYFORGE_PROJECT}/#{GEM_NAME}"
+$hoe.remote_rdoc_dir = File.join(PATH.gsub(/^#{RUBYFORGE_PROJECT}\/?/,''), 'rdoc')
+$hoe.rsync_args = '-av --delete --ignore-errors'
+$hoe.spec.post_install_message = File.open(File.dirname(__FILE__) + "/../PostInstall.txt").read rescue ""

data/config/requirements.rb

@@ -0,0 +1,15 @@
+require 'fileutils'
+include FileUtils
+
+require 'rubygems'
+%w[rake hoe newgem rubigen].each do |req_gem|
+  begin
+    require req_gem
+  rescue LoadError
+    puts "This Rakefile requires the '#{req_gem}' RubyGem."
+    puts "Installation: gem install #{req_gem} -y"
+    exit
+  end
+end
+
+$:.unshift(File.join(File.dirname(__FILE__), %w[.. lib]))

data/examples/crud_components/html/address_view_edit.xhtml

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- 
+    Document   : address_view_edit
+    Created on : Jul 3, 2008, 10:51:05 AM
+    Author     : bsbodden
+-->
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+    <head>
+        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+        <link rel="stylesheet" type="text/css" href="/style/trellis.css" />
+        <title>Trellis Grid Example</title>
+    </head>
+    <body>
+        <p>
+            <trellis:object_editor tid="address" />
+        </p>
+    </body>
+</html>

data/examples/crud_components/html/addresses.xhtml

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- 
+    Document   : addresses
+    Created on : Jul 3, 2008, 10:50:44 AM
+    Author     : bsbodden
+-->
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+    <head>
+        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+        <link rel="stylesheet" type="text/css" href="/style/trellis.css" />
+        <title>Trellis Grid Example</title>
+    </head>
+    <body>
+        <h1>Addresses</h1>
+        <p>
+            <trellis:grid tid="addresses" source="all_addresses"/>
+        </p>
+    </body>
+</html>