reactive-wx 0.2.0

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008-2009 Pascal Hurni
+
+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.

data/Manifest

@@ -0,0 +1,45 @@
+LICENSE
+Manifest
+README
+Rakefile
+lib/reactive-wx.rb
+lib/reactive-wx/accessors.rb
+lib/reactive-wx/accessors/control_with_items.rb
+lib/reactive-wx/accessors/date_picker_ctrl.rb
+lib/reactive-wx/accessors/text_ctrl.rb
+lib/reactive-wx/binder.rb
+lib/reactive-wx/default_handler.rb
+lib/reactive-wx/helpers.rb
+lib/reactive-wx/helpers/asset_helper.rb
+lib/reactive-wx/helpers/exception_helper.rb
+lib/reactive-wx/helpers/forms.rb
+lib/reactive-wx/request.rb
+lib/reactive-wx/wx_ext.rb
+lib/reactive-wx/wx_ext/arranger.rb
+lib/reactive-wx/wx_ext/aui_toolbar.rb
+lib/reactive-wx/wx_ext/event_binder.rb
+lib/reactive-wx/wx_ext/form_grid_sizer.rb
+lib/reactive-wx/wx_ext/message_dialog.rb
+lib/reactive-wx/wx_ext/panel_dialog.rb
+lib/reactive-wx/wx_ext/semi_modal.rb
+lib/reactive-wx/wx_ext/toolbar.rb
+lib/reactive-wx/wx_ext/window.rb
+reactive_app_generators/wx/USAGE
+reactive_app_generators/wx/templates/application_helper.wx.rb
+reactive_app_generators/wx/templates/layout.wx.erb
+reactive_app_generators/wx/templates/main_controller.rb
+reactive_app_generators/wx/templates/main_helper.wx.rb
+reactive_app_generators/wx/templates/run.wx.erb
+reactive_app_generators/wx/templates/show.wx.erb
+reactive_app_generators/wx/wx_generator.rb
+reactive_generators/view/USAGE
+reactive_generators/view/templates/create.wx.rb
+reactive_generators/view/templates/delete.wx.rb
+reactive_generators/view/templates/destroy.wx.rb
+reactive_generators/view/templates/edit.wx.rb
+reactive_generators/view/templates/index.wx.rb
+reactive_generators/view/templates/layout.wx.rb
+reactive_generators/view/templates/new.wx.rb
+reactive_generators/view/templates/show.wx.rb
+reactive_generators/view/templates/update.wx.rb
+reactive_generators/view/view_generator.rb

data/README

@@ -0,0 +1,22 @@
+== reactive-wx
+
+This plugin is an output handler for wx code.
+It therefore runs code targeted for the wxWidgets toolkit using its ruby port
+named wxRuby.
+
+It is required to run on the client-side of the Reactive application.
+
+Version::  0.2.0
+Author::   Pascal Hurni
+Email::    phi@ruby-reactive.org
+Homepage:: http://www.ruby-reactive.org
+
+== Description
+
+Adds 
+
+== Requirements
+
+* reactive-core >=0.2.0
+* wxruby >=1.9.6
+* wx_sugar >= 0.1.19

data/Rakefile

@@ -0,0 +1,5 @@
+require 'rubygems'
+
+unless Gem.source_index.find_name('reactive-dev').empty?
+  require 'reactive-dev/tasks/plugin'
+end

data/lib/reactive-wx.rb

@@ -0,0 +1,19 @@
+Reactive::Initializer.init :wx do
+  require 'wx'
+  require 'wx_sugar'
+  require 'reactive-wx/wx_ext'
+
+  require 'reactive-wx/request'
+  require 'reactive-wx/binder'
+  require 'reactive-wx/default_handler'
+  require 'reactive-wx/accessors'
+  require 'reactive-wx/helpers'
+
+  Reactive::OutputHandler::Base.register_output_handler(:wx, Reactive::WxOutput::DefaultHandler)
+
+  # every event handler may do requests
+  Wx::EvtHandler.send(:include, Reactive::WxOutput::Binder)
+
+  # We want the ::Wx namespace to be directly available for our handlers
+  Reactive::OutputHandler::Base.helper(:wx, ::Wx)
+end

data/lib/reactive-wx/accessors.rb

@@ -0,0 +1,15 @@
+require 'reactive-wx/accessors/text_ctrl'
+require 'reactive-wx/accessors/control_with_items'
+require 'reactive-wx/accessors/date_picker_ctrl'
+
+module Reactive::WxOutput
+  module Accessors # :nodoc: all
+  end
+end
+
+# Introduces orthogonality to access control's data.
+# The majority of controls expose a #get_value method, but some don't.
+# These modules defines such a method to access the data.
+Wx::ControlWithItems.send(:include, Reactive::WxOutput::Accessors::ControlWithItems)
+Wx::TextCtrl.send(:include, Reactive::WxOutput::Accessors::TextCtrl)
+Wx::DatePickerCtrl.send(:include, Reactive::WxOutput::Accessors::DatePickerCtrl) if defined? Wx::DatePickerCtrl

data/lib/reactive-wx/accessors/control_with_items.rb

@@ -0,0 +1,22 @@
+module Reactive
+  module WxOutput
+    module Accessors
+    
+      # The data is identified by the related item_data (Wx) filled before
+      module ControlWithItems
+        include Enumerable
+      
+        def set_data(id)
+          if index = find {|i| get_item_data(i) == id}
+            set_selection(index)
+          end
+        end
+      
+        def get_data
+          get_item_data(get_selection)
+        end
+      end
+    
+    end
+  end
+end

data/lib/reactive-wx/accessors/date_picker_ctrl.rb

@@ -0,0 +1,17 @@
+module Reactive
+  module WxOutput
+    module Accessors
+    
+      module DatePickerCtrl
+        def set_data(value)
+          set_value(value)
+        end
+      
+        def get_data
+          get_value
+        end
+      end
+    
+    end
+  end
+end

data/lib/reactive-wx/accessors/text_ctrl.rb

@@ -0,0 +1,17 @@
+module Reactive
+  module WxOutput
+    module Accessors
+    
+      module TextCtrl
+        def set_data(value)
+          set_value(value.to_s)
+        end
+      
+        def get_data
+          get_value
+        end
+      end
+    
+    end
+  end
+end

data/lib/reactive-wx/binder.rb

@@ -0,0 +1,49 @@
+require 'reactive-wx/helpers/forms'
+
+module Reactive
+  module WxOutput
+  
+    module Binder
+      include Helpers::FormsHelper
+
+      # Let Reactive do the request
+      # The hash argument may be of three forms:
+      #  * Direct form: a record (for CRUD actions, the action is known by asking the record: CREATE => new_record?, UPDATE => changed?, DELETE => marked_for_destruction?, SHOW => none of them)
+      #     You may override the action by passing an :action entry in the options. A special action named :save will auto-determine the :create or :update state.
+      #  * Simple form: a params hash with at least entries for :controller and :action
+      #  * Complex form: a hash with a :link entry
+      # TODO: Refactor this new_params creation process
+      def do_request(*args)
+        hash = args.extract_options!
+        record = args.first
+        if record.class.respond_to?(:meta) && record.class.meta.is_a?(MetaModel::Model)
+          options = hash
+          new_params = hash.merge(:model => record)
+        else
+          # params may be of two forms, a simple params hash or a complex hash with embedded hashes. To distinguish: if the hash contains a :link key it is a complex one.
+          params, options = hash.has_key?(:link) ? [hash[:link], hash] : [hash, {}]
+          new_params = params.dup
+          
+          # handle forms params
+          new_params.update(forms_to_params(options[:forms]))
+          
+          # handle late update of params
+  #        return false unless handle_late_tag(options[:late], new_params, wx_event)
+          
+        end
+        # set up the request
+        request = Request.new(new_params)
+        request.local_assigns = options[:locals]
+        
+        # let the request run
+        Dispatcher::Base.dispatch(request)
+      end
+    
+#      def handle_late_tag(tag, params, wx_event)
+#        return true if tag.nil?
+#        tag.call(params, wx_event)
+#      end
+    end
+  
+  end
+end

data/lib/reactive-wx/default_handler.rb

@@ -0,0 +1,50 @@
+module Reactive
+  module WxOutput
+    # The TemplateError exception is raised when the compilation of the template fails. This exception then gathers a
+    # bunch of intimate details and uses it to report a very precise exception message.
+    class HandlerError < Error #:nodoc:
+      include Reactive::TemplateError
+    end
+  
+    class DefaultHandler < Reactive::OutputHandler::Base
+      cattr_reader :handler_name         # We are the default handler, so our name is nil!
+      
+      include Binder
+      
+      def default_treatment
+        :run
+      end
+
+      def run
+        copy_ivars(response.variables)
+        instance_eval("#{locals_code}\n#{response.body}", request_name, 0)
+      rescue Exception => e
+        if HandlerError === e
+          e.sub_template_of(request_name)
+          raise e
+        else
+          raise HandlerError.new(request_name, response.body, e)
+        end
+      end
+    
+      protected
+      
+      def copy_ivars(variables)
+        variables.each {|name, value| instance_variable_set("@#{name}", value)}
+      end
+    
+      def locals_code
+        @local_assigns = {}
+        code = "local_assigns = @local_assigns;"
+        if request.respond_to? :local_assigns
+          if request.local_assigns
+            @local_assigns = request.local_assigns
+            code <<request.local_assigns.keys.map { |key| "#{key} = @local_assigns[:#{key}];" }.join
+          end
+        end
+        code
+      end
+    
+    end
+  end
+end

data/lib/reactive-wx/helpers.rb

@@ -0,0 +1,10 @@
+# Load helper modules
+helpers_dir = "#{File.dirname(__FILE__)}/helpers"
+Dir.entries(helpers_dir).sort.each do |file|
+  next unless file =~ /^([a-z][a-z_]*_helper).rb$/
+  require File.join(helpers_dir, file)
+  helper_module_name = $1.camelize
+  if Reactive::WxOutput::Helpers.const_defined?(helper_module_name)
+    Reactive::OutputHandler::Base.helper(:wx, Reactive::WxOutput::Helpers.const_get(helper_module_name))
+  end
+end

data/lib/reactive-wx/helpers/asset_helper.rb

@@ -0,0 +1,21 @@
+module Reactive::WxOutput
+  module Helpers
+    module AssetHelper
+    
+      class AssetArtProvider < Wx::ArtProvider
+        include Reactive::WxOutput::Binder
+        
+        def create_bitmap(id, client, size)
+          unless id =~ /^wx/
+            begin
+              Wx::Bitmap.new(do_request(:asset => id, :kind => :ui), Wx::BITMAP_TYPE_ANY)
+            rescue Reactive::Dispatcher::AssetNotFound => e
+              nil
+            end
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/reactive-wx/helpers/exception_helper.rb

@@ -0,0 +1,82 @@
+module Reactive::WxOutput
+  module Helpers
+    module ExceptionHelper
+
+      def show_exception_dialog(exception)
+        send("show_#{Reactive.configuration.environment}_exception_dialog", exception)
+      end
+    
+      def show_production_exception_dialog(exception)
+        # TODO
+        show_development_exception_dialog(exception)
+      end
+    
+      def show_test_exception_dialog(exception)
+        # Tests should trap all exception, so re-raise it if it is not handled!
+        raise exception
+      end
+
+      def show_development_exception_dialog(exception)
+        dialog = WxExtensions::PanelDialog.new(nil, :style => Wx::DEFAULT_DIALOG_STYLE | Wx::RESIZE_BORDER) do |dialog|
+          html_win = Wx::HtmlWindow.new(dialog)
+          html_win.set_page(a=htmlize_exception(exception))
+          html_win
+        end
+        dialog.show_modal
+        dialog.destroy
+      end
+
+      HTML_ESCAPE = { '&' => '&amp;',  '>' => '&gt;',   '<' => '&lt;', '"' => '&quot;' }
+      def h(html)
+        sanitize_latin1(html).to_s.gsub(/[\"><]|&(?!([a-zA-Z]+|(#\d+));)/) { |special| HTML_ESCAPE[special] }
+      end
+    
+      def sanitize_latin1(text)
+        text.gsub(/[\x80-\xFF]/, '_')
+      end
+
+      def htmlize_trace(exception)
+        "<pre>#{exception.clean_backtrace.map{|line| line.sub(/:in (.+)/, ":in <font color=\"red\">\\1</font>")}.join("\n")}</pre>"
+      end
+
+      def htmlize_request(exception)
+      end
+
+      def htmlize_exception(exception)
+        if exception.respond_to? :template_error
+          <<EOS
+<h1>
+  #{h exception.original_exception.class.to_s } in
+  #{request.params[:controller] ? h(request.params[:controller].capitalize) : ''}##{h request.params[:action] }
+</h1>
+
+<p>
+  Showing <i>#{h exception.file_name }</i> where line <b>##{h exception.line_number }</b> raised:
+  <pre><code>#{h exception.message }</code></pre>
+</p>
+
+<p>Extracted source (around line <b>##{h exception.line_number }</b>):
+<pre><code>#{h exception.source_extract }</code></pre></p>
+
+<p>#{h exception.sub_template_message }</p>
+
+#{htmlize_trace(exception.original_exception || exception)}
+#{htmlize_request(exception)}
+EOS
+        else
+        <<EOS
+<h1>
+  #{h exception.class.to_s}
+  #{request.params[:controller] ? h('in ' + request.params[:controller].humanize + 'Controller' + (request.params[:action] ? '#' + request.params[:action] : '')) : ''}
+</h1>
+<pre>#{h exception.clean_message}</pre>
+
+#{htmlize_trace(exception)}
+#{htmlize_request(exception)}
+EOS
+        end
+      end
+    
+    end
+  end
+end

data/lib/reactive-wx/helpers/forms.rb

@@ -0,0 +1,40 @@
+module Reactive::WxOutput
+
+  class InvalidForm < Reactive::OutputHandler::Error
+  end
+
+  module Helpers
+    module FormsHelper
+
+      def forms_to_params(forms)
+        forms = [forms] unless forms.is_a?(Array)
+        forms.compact.inject({}) do |params, form|
+          form_name, container = form_name_and_container(form)
+          params.update(form_name => form_to_param(container))
+        end
+      end
+    
+      def form_to_param(container)
+        form_param = {}
+        container.get_children.each {|child| next unless child.get_name =~ /^[\da-z_]+$/ ;form_param[child.get_name] = child.get_data}       #TODO: Handle sub-children recursively
+        form_param
+      end
+    
+      def form_name_and_container(form)
+        case form
+          when ::Wx::Window
+            raise InvalidForm, "Window #{form} has no name!" unless name = form.get_name
+            [name, form]
+          when String
+            raise InvalidForm, "No window named #{form}" unless win = ::Wx::Window.find_window_by_name(form, self)
+            [form, win]
+          when Hash
+            form.to_a
+          else
+            raise InvalidForm, "Unhandled param, passed form: #{form.inspect}"
+        end
+      end
+
+    end
+  end
+end