nemo 0.1.0

data/INSTALL

@@ -0,0 +1,5 @@
+= Installation
+
+1. Download and Install RubyGems: http://rubygems.rubyforge.org
+
+2. Install Wee: <tt>gem install nemo</tt>

data/README

@@ -0,0 +1,25 @@
+== Nemo
+
+== Copyright and License
+
+Copyright (c) 2004, 2005 by Kevin Howe (kh@newclear.ca).
+
+Released under the same terms of license as Ruby.
+
+== Introduction
+
+Nemo is a Ruby port of Mewa
+
+  http://www.adrian-lienhard.ch/files/mewa.pdf
+
+using Michael Neumann's Wee
+
+  http://rubyforge.org/projects/wee
+
+as the Seaside2 equivalent.
+
+Nemo is a web-application platform that uses object metadata to automatically construct web-interfaces (Editors and Viewers). It is highly object-oriented with strong emphasis on reusable components.
+
+== Status
+
+Nemo is build on top of Wee, and should not be considered production ready until Wee itself is ready.

data/lib/nemo.rb

@@ -0,0 +1,47 @@
+# Ruby port of Mewa
+#
+# Meta-level Architecture for Generic Web-Application Construction
+#
+# http://www.adrian-lienhard.ch/files/mewa.pdf
+#
+# Author::  Kevin Howe
+# License:: Distributes under the same terms as Ruby
+#
+module Nemo
+
+  Version = "0.1.0"
+
+  require 'date'
+  require 'wee'
+  require 'wee/utils/cache'
+  require 'nemo/util'
+  require 'nemo/components'
+  require 'nemo/metaobject'
+  require 'nemo/visitors'
+  require 'nemo/examples'
+
+  module_function
+
+  # Define a new MetaObject
+  #
+  def metaobject_for(*args, &block)
+    Nemo::MetaObject::MetaObject.new(*args, &block)
+  end
+
+end
+
+class Wee::HtmlCanvas
+
+  # Nemo's standard calendar button
+  #
+  #   class MyComponent < Wee::Component
+  #     def render
+  #       r.nemo_calendar_button.callback {}
+  #     end
+  #   end
+  #
+  def nemo_calendar_button
+    image_button.src('/nemo/calendar.gif').width(16).height(16).alt('Calendar').style('border: 0')
+  end
+
+end

data/lib/nemo/components.rb

@@ -0,0 +1,4 @@
+module Nemo::Components; end
+require 'nemo/components/calendar'
+require 'nemo/components/confirm'
+require 'nemo/components/multiattr'

data/lib/nemo/components/calendar.rb

@@ -0,0 +1,191 @@
+# Browsable Calendar component
+#
+# =Use as a date picker
+# By default, clicking a day will <tt>answer</tt> with an associated Date object.
+#
+# =Use as a calendar viewer
+# No <tt>answer</tt> is given when in browse mode:
+#
+#   call( Nemo::Components::MiniCalendar.new(date).browse )
+#
+# =CSS Styles
+# Overload render_styles to add a custom <link> or <style> tag.
+#
+class Nemo::Components::MiniCalendar < Wee::Component
+
+  # Browse mode: if true, no answer will be given
+  attr_accessor :browse
+
+  # Holds the current chosen date
+  attr_accessor :date
+
+  # Initialize the MiniCalendar
+  #
+  def initialize(date=Date.today)
+    super()
+    @month = Date.new(date.year, date.month, 1)
+    @day = date
+    @browse = false
+  end
+
+  # Backtrack state
+  #
+  def backtrack_state(snapshot)
+    super
+    snapshot.add(self)
+  end
+
+  # Set to browse-only (no answer will be given)
+  #
+  def browse(value=true)
+    @browse = (value && true)
+    self
+  end
+  
+  # True if in browser-only mode
+  #  
+  def browse?
+    @browse
+  end
+  
+  # True if the given date is the currently selected month
+  #
+  def current_month?(date)
+    Date.new(date.year, date.month, 1) == @month
+  end
+
+  # True if the given date is the currently selected day
+  #
+  def selected_day?(date)
+    date == @day
+  end
+  
+  # Date object representing the previous month
+  #
+  def prev_month
+    @month << 1
+  end
+
+  # Date object representing the next month
+  #
+  def next_month
+    @month >> 1
+  end
+
+  # String to be displayed as the month heading
+  #
+  def month_heading
+    @month.strftime('%B %Y')
+  end
+  
+  # String to be displayed indicating the current date
+  #
+  def today_string
+    Date.today.strftime('Today is %A, %b %d %Y')
+  end
+  
+  # Render a given day
+  #
+  def render_day(date)
+    if current_month?(date)
+      selected_day?(date) ? render_selected_day(date) : render_month_day(date)
+    else
+      render_other_day(date)
+    end
+  end
+  
+  # Render a day of the currently selected month
+  #
+  def render_month_day(date)
+    r.table_data { r.anchor.callback { save(date) }.with(date.day) }
+  end
+  
+  # Render the currently selected day
+  #
+  def render_selected_day(date)
+    r.table_data.style('border: 1px solid black').with do
+      r.anchor.style('font-weight: bold').callback { save(date) }.with(date.day)
+    end
+  end
+  
+  # Render days of the previous or next month
+  #
+  def render_other_day(date)
+    r.table_data do
+      r.anchor.style('color: silver').callback { save(date) }.with(date.day)
+    end
+  end
+  
+  # Render CSS styles
+  #
+  def render_styles
+    r.link.type('text/css').rel('stylesheet').href('/nemo/calendar.css')
+  end
+  
+  # Render Calender header
+  #
+  def render_header
+    r.table_row do
+      r.table_header.colspan(4).with { r.encoded_text(month_heading) }
+      r.table_header { r.anchor.callback { go_prev }.with(prev_month.strftime('%b')) }
+      r.table_header { r.anchor.callback { go_next }.with(next_month.strftime('%b')) }
+      r.table_header { browse? ? r.space : r.anchor.callback { back }.style('color: black').with('X') }
+    end
+  end
+  
+  # Render Calendar footer
+  #
+  def render_footer
+    r.table_row { r.table_header.colspan(7).with { r.encoded_text(today_string) } }
+  end
+  
+  # Render Calendar
+  #
+  def render
+    r.html do
+      r.head { r.title('Calendar'); render_styles }
+      r.body do
+        r.text(sprintf('<!--Month: %s, Day: %s-->', @month, @day))
+        r.table { r.table_row { r.table_header {
+          r.table do
+            render_header
+            r.table_row { Date::ABBR_DAYNAMES.each { |day| r.table_header(day) } }
+            @month.calendar.each do |week|
+              r.table_row do
+                week.each { |day| render_day(day) }
+              end
+            end
+            render_footer
+          end
+        }}}
+      end
+    end
+  end
+  
+  # Return without changes
+  #
+  def back
+    answer nil unless browse?
+  end
+  
+  # Select the previous month
+  #
+  def go_prev
+    @month = prev_month
+  end
+  
+  # Select the next month
+  #
+  def go_next
+    @month = next_month
+  end
+  
+  # Save the given day
+  #
+  def save(day)
+    @day = day
+    @month = Date.new(day.year, day.month, 1)
+    answer(day) unless browse?
+  end
+
+end

data/lib/nemo/components/confirm.rb

@@ -0,0 +1,30 @@
+# Confirmation dialog box
+#
+# Displays a message with OK(true) and Cancel(false) buttons.
+#
+class Nemo::Components::ConfirmDialog < Wee::Component
+
+  attr_accessor :text
+
+  def initialize(text)
+    super()
+    @text = text 
+  end
+
+  def render
+    r.html do
+      r.head { r.title('Confirm') }
+      r.body.style('text-align: center').with do
+        r.break
+        r.encode_text(@text)
+        r.form do 
+          r.submit_button.value('OK').callback{ answer true }
+          r.space
+          r.submit_button.value('Cancel').callback{ answer false }
+        end
+        r.break
+      end
+    end
+  end
+
+end

data/lib/nemo/components/multiattr.rb

@@ -0,0 +1,93 @@
+# Multiple Attribute container
+#
+# Interface to Add/Edit/Delete/View the related data of the given attribute.
+#
+class Nemo::Components::MultipleAttributeContainer < Wee::Component
+
+  attr_accessor :attribute, :components
+
+  def initialize(a)
+    super()
+    @attribute = a
+    @components = Array.new
+    a.cache.each { |obj| @components << viewer_for(obj.metaobject) }
+    @components << create_empty_editor
+  end
+
+  def children
+    @components
+  end
+
+  def backtrack_state(snapshot)
+    super
+    snapshot.add(self.children)
+  end
+
+  def delete(component)
+    @attribute.remove_from_cache(component.metaobject.baseobject)
+    @components.delete(component)
+    @components.pop
+    @components << create_empty_editor
+  end
+
+  def switch_to_edit_mode(viewer)
+    viewer.viewer = false
+    viewer.call( editor_for(viewer.metaobject) )
+    viewer.viewer = true
+  end
+  
+  def create_empty_editor
+    metaobject = @attribute.base_class.new.metaobject
+    if @components.size < @attribute.item_limit
+      editor = editor_for(metaobject)
+      answer = Wee::AnswerDecoration.new
+      answer.on_answer = method(:on_edit)
+      editor.add_decoration(answer)
+      editor
+    else
+      Nemo::Visitors::Visitor.new(metaobject) # placeholder
+    end
+  end
+
+  def on_edit(obj)
+    if obj.nil?
+      @components.pop
+      @components << create_empty_editor
+    else
+      @attribute.add_to_cache(obj)
+      @components.pop
+      @components << viewer_for(obj.metaobject)
+      @components << create_empty_editor
+    end
+  end
+
+  def editor_for(metaobject)
+    obj = Nemo::Visitors::Editor.new(metaobject)
+    obj.subform = true
+    obj
+  end
+
+  def viewer_for(metaobject)
+    Nemo::Visitors::Viewer.new(metaobject)
+  end
+
+  def render
+    @components.each do |component|
+      if component.viewer?
+        r.render(component)
+        r.submit_button.value('edit').callback{ switch_to_edit_mode(component) }
+        if @attribute.item_delete?
+          r.space
+          r.submit_button.value('delete').callback { delete(component) }
+        end
+        if @attribute.item_limit > 1
+          r.break
+          r.break
+        end
+      else
+        r.render(component)
+      end
+    end
+  end
+
+end

data/lib/nemo/examples.rb

@@ -0,0 +1,5 @@
+# Example Applications
+#
+module Nemo::Examples; end
+require 'nemo/examples/date_picker'
+require 'nemo/examples/person_editor'

data/lib/nemo/examples/date_picker.rb

@@ -0,0 +1,74 @@
+# Demonstrates the MiniCalendar component
+#
+module Nemo::Examples::DatePicker; end
+  
+# Set the value of a text field to a date string using a MiniCalendar.
+#
+class Nemo::Examples::DatePicker::Root < Wee::Component
+
+  # Holds the currently chosen date
+  attr_accessor :date
+
+  # Initialize with a Date object (defaults to today)
+  #
+  def initialize(date=Date.today)
+    super()
+    @date = date
+  end
+  
+  # Backtrack state
+  #
+  def backtrack_state(snapshot)
+    super
+    snapshot.add(self)
+  end
+  
+  # Render CSS styles
+  #
+  def render_styles
+    r.link.type('text/css').rel('stylesheet').href('/nemo/calendar.css')
+  end
+
+  # Render date field, allow user to choose a Date using a MiniCalendar
+  #
+  def render
+    super
+    r.html do
+      r.head { r.title('Calendar Demo'); render_styles }
+      r.body do
+        r.form do
+          r.table { r.table_row { r.table_header {
+            r.table do
+              r.table_row { r.table_header('Calendar Demo') }
+              r.table_row { r.table_data {
+                r.text_input.value(@date.strftime('%b %d, %Y')).callback { |input| @date = begin Date.parse(input) rescue Date.today end }
+                r.space
+                r.nemo_calendar_button.callback { calendar }
+              }}
+            end
+          }}}
+        end
+      end
+    end
+  end
+  
+  # Call the calendar component
+  #
+  def calendar
+    if date = call( Nemo::Components::MiniCalendar.new(@date) )
+      @date = date
+    end
+  end
+
+end
+
+class Nemo::Examples::DatePicker::Session < Wee::Session
+
+  def initialize
+    super do
+      self.root_component = Nemo::Examples::DatePicker::Root.new
+      self.page_store = Wee::Utils::LRUCache.new(25) # backtrack up to 25 pages
+    end
+  end
+
+end