netzke-core 0.1.1.1

data/CHANGELOG

@@ -0,0 +1,13 @@
+v0.1.1.1
+Meta: moving from GitHub to RubyForge
+
+v0.1.1
+Inter-widget dependencies code reworked
+JS-class code generation code slightly reworked
+
+v0.1.0.2
+Meta: fix outdated Manifest
+
+v0.1.0.1 Meta work: replacing underscore with dash in the name
+
+v0.1.0 Initial release

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Sergei Kozlov
+
+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,39 @@
+CHANGELOG
+generators/netzke_core/netzke_core_generator.rb
+generators/netzke_core/templates/create_netzke_layouts.rb
+generators/netzke_core/templates/create_netzke_preferences.rb
+generators/netzke_core/templates/netzke.html.erb
+generators/netzke_core/USAGE
+init.rb
+install.rb
+javascripts/core.js
+lib/app/controllers/netzke_controller.rb
+lib/app/models/netzke_layout.rb
+lib/app/models/netzke_preference.rb
+lib/netzke/base.rb
+lib/netzke/controller_extensions.rb
+lib/netzke/core_ext.rb
+lib/netzke/js_class_builder.rb
+lib/netzke-core.rb
+lib/vendor/facets/hash/recursive_merge.rb
+LICENSE
+Manifest
+netzke-core.gemspec
+Rakefile
+README.mdown
+tasks/netzke_core_tasks.rake
+test/app_root/app/controllers/application.rb
+test/app_root/config/boot.rb
+test/app_root/config/database.yml
+test/app_root/config/environment.rb
+test/app_root/config/environments/in_memory.rb
+test/app_root/config/environments/mysql.rb
+test/app_root/config/environments/postgresql.rb
+test/app_root/config/environments/sqlite.rb
+test/app_root/config/environments/sqlite3.rb
+test/app_root/config/routes.rb
+test/app_root/script/console
+test/core_ext_test.rb
+test/netzke_core_test.rb
+test/test_helper.rb
+uninstall.rb

data/README.mdown

@@ -0,0 +1,11 @@
+netzke-core
+==========
+
+Create ExtJS/Rails reusable components (widgets) with minimum effort.
+
+Example
+=======
+
+See the tutorials on http://blog.writelesscode.com
+
+Copyright (c) 2008 Sergei Kozlov, released under the MIT license

data/Rakefile

@@ -0,0 +1,14 @@
+require 'echoe'
+
+Echoe.new("netzke-core") do |p|
+  p.author = "Sergei Kozlov"
+  p.email = "sergei@writelesscode.com"
+  p.summary = "Build ExtJS/Rails widgets with minimum effort"
+  p.url = "http://writelesscode.com"
+  p.development_dependencies = []
+  p.test_pattern = 'test/**/*_test.rb'
+  p.retain_gemspec = true
+  
+  # fixing the problem with lib/*-* files being removed while doing manifest
+  p.clean_pattern = ["pkg", "doc", 'build/*', '**/coverage', '**/*.o', '**/*.so', '**/*.a', '**/*.log', "{ext,lib}/*.{bundle,so,obj,pdb,lib,def,exp}", "ext/Makefile", "{ext,lib}/**/*.{bundle,so,obj,pdb,lib,def,exp}", "ext/**/Makefile", "pkg", "*.gem", ".config"]
+end

data/generators/netzke_core/USAGE

@@ -0,0 +1,8 @@
+Description:
+    Explain the generator
+
+Example:
+    ./script/generate netzke-core Thing
+
+    This will create:
+        what/will/it/create

data/generators/netzke_core/netzke_core_generator.rb

@@ -0,0 +1,13 @@
+# class NetzkeCoreGenerator < Rails::Generator::NamedBase
+class NetzkeCoreGenerator < Rails::Generator::Base
+  def manifest
+    record do |m|
+      # m.directory "public/javascripts/netzke"
+      # m.file 'netzke.js', "public/javascripts/netzke/netzke.js"
+      m.file 'netzke.html.erb', "app/views/layouts/netzke.html.erb"
+      m.migration_template 'create_netzke_preferences.rb', "db/migrate", {:migration_file_name => "create_netzke_preferences"}
+      # FIXME: how do we avoid getting the same migration IDs?
+      m.migration_template 'create_netzke_layouts.rb', "db/migrate", {:migration_file_name => "create_netzke_layouts"}
+    end
+  end
+end

data/generators/netzke_core/templates/create_netzke_layouts.rb

@@ -0,0 +1,14 @@
+class CreateNetzkeLayouts < ActiveRecord::Migration
+  def self.up
+    create_table :netzke_layouts do |t|
+      t.string  :widget_name
+      t.string  :items_class
+      t.integer :user_id
+      t.timestamps
+    end
+  end
+
+  def self.down
+    drop_table :netzke_layouts
+  end
+end

data/generators/netzke_core/templates/create_netzke_preferences.rb

@@ -0,0 +1,18 @@
+class CreateNetzkePreferences < ActiveRecord::Migration
+  def self.up
+    create_table :netzke_preferences do |t|
+      t.string :name
+      t.string :pref_type
+      t.string :value
+      t.integer :user_id
+      t.integer :role_id
+      t.string :custom_field
+
+      t.timestamps
+    end
+  end
+
+  def self.down
+    drop_table :netzke_preferences
+  end
+end

data/generators/netzke_core/templates/netzke.html.erb

@@ -0,0 +1,10 @@
+<head>
+	<meta http-equiv="Content-type" content="text/html; charset=utf-8">
+	<title><%= @widget_name %></title>
+	<%= javascript_include_tag("/extjs/adapter/ext/ext-base.js", "/extjs/ext-all-debug.js") %>
+	<%= javascript_include_tag("/netzke/netzke.js") %>
+	<%= stylesheet_link_tag("/extjs/resources/css/ext-all.css") %>
+</head>
+<body id="">
+<%= yield %>	
+</body>

data/init.rb

@@ -0,0 +1 @@
+# require 'netzke-core'

data/install.rb

@@ -0,0 +1 @@
+# Install hook code here

data/javascripts/core.js

@@ -0,0 +1,124 @@
+Ext.BLANK_IMAGE_URL = "/extjs/resources/images/default/s.gif";
+Ext.componentCache = {};
+
+Ext.namespace('Ext.netzke');
+
+// helper method to do multiple Ext.apply's
+Ext.chainApply = function(objectArray){
+	var res = {};
+	Ext.each(objectArray, function(obj){Ext.apply(res, obj)});
+	return res;
+};
+
+// implementation of totalProperty, successProperty and root configuration options for ArrayReader
+Ext.data.ArrayReader = Ext.extend(Ext.data.JsonReader, {
+    readRecords : function(o){
+     	var sid = this.meta ? this.meta.id : null;
+    	var recordType = this.recordType, fields = recordType.prototype.fields;
+    	var records = [];
+			// console.info(this.meta);
+    	var root = o[this.meta.root] || o, totalRecords = o[this.meta.totalProperty], success = o[this.meta.successProperty];
+	    for(var i = 0; i < root.length; i++){
+		    var n = root[i];
+	        var values = {};
+	        var id = ((sid || sid === 0) && n[sid] !== undefined && n[sid] !== "" ? n[sid] : null);
+	        for(var j = 0, jlen = fields.length; j < jlen; j++){
+                var f = fields.items[j];
+                var k = f.mapping !== undefined && f.mapping !== null ? f.mapping : j;
+                var v = n[k] !== undefined ? n[k] : f.defaultValue;
+                v = f.convert(v, n);
+                values[f.name] = v;
+            }
+	        var record = new recordType(values, id);
+	        record.json = n;
+	        records[records.length] = record;
+	    }
+	    return {
+	        records : records,
+	        totalRecords : totalRecords,
+					success : success
+	    };
+    }
+});
+
+// Methods common to all widget classes
+Ext.widgetMixIn = {
+	widgetInit:function(config){
+    this.app = Ext.getCmp('application');
+    if (config.tools) Ext.each(config.tools, function(i){i.on.click = this[i.on.click].createDelegate(this)}, this);
+    if (config.actions) Ext.each(config.actions, function(i){i.handler = this[i.handler].createDelegate(this);}, this);
+	},
+
+	setEvents: function(){
+		this.on('beforedestroy', function(){
+			// clean-up menus
+			if (this.app && !!this.app.unhostMenus) {
+				// alert('beforedestroy');
+				this.app.unhostMenus(this)
+			}
+		}, this);
+		
+		this.on('render', this.onWidgetLoad, this);
+	},
+
+	feedback:function(msg){
+		if (this.app && !!this.app.showFeedback) {
+			this.app.showFeedback(msg)
+		} else {
+			// there's no application to show the feedback - so, we do it ourselves
+			if (typeof msg == 'string'){
+				alert(msg)
+			} else {
+				var compoundResponse = ""
+				Ext.each(msg, function(m){
+          compoundResponse += m.msg + "\n"
+        })
+				if (compoundResponse != "") alert(compoundResponse);
+			}
+		};
+	},
+
+	addMenus:function(menus){
+		if (this.app && !!this.app.hostMenu) {
+			Ext.each(menus, function(menu){this.app.hostMenu(menu, this)}, this)
+		}
+	},
+	
+	onWidgetLoad:Ext.emptyFn // gets overridden
+};
+
+// Make Panel with layout 'fit' capable to dynamically load widgets
+Ext.override(Ext.Panel, {
+	getWidget: function(){
+		return this.items.get(0)
+	},
+	
+	loadWidget: function(url, params){
+		if (!params) params = {}
+		
+		this.remove(this.getWidget()); // first delete previous widget
+		
+		// we will let the server know which components we have cached
+		var cachedComponentNames = [];
+		for (name in Ext.componentCache) {
+			cachedComponentNames.push(name);
+		}
+		
+		this.disable(); // to visually emphasize loading
+		
+		Ext.Ajax.request(
+			{url:url, params:Ext.apply(params, {components_cache:Ext.encode(cachedComponentNames)}), script:false, callback:function(panel, success, response){
+				var response = Ext.decode(response.responseText);
+				if (response['classDefinition']) eval(response['classDefinition']); // evaluate widget's class if it was sent
+
+				response.config.parent = this // we might want to know the parent panel in advance (e.g. to know its size)
+				var instance = new Ext.componentCache[response.config.widgetClassName](response.config)
+				
+				this.add(instance);
+				this.doLayout();
+				this.enable();
+			}, scope:this}
+		)
+		
+	}
+});

data/lib/app/controllers/netzke_controller.rb

@@ -0,0 +1,16 @@
+class NetzkeController < ActionController::Base
+
+  # collect javascripts from all plugins that registered it in Netzke::Base.config[:javascripts]
+  def netzke
+    respond_to do |format|
+      format.js {
+        res = ""
+        Netzke::Base.config[:javascripts].each do |path|
+          f = File.new(path)
+          res << f.read
+        end
+        render :text => res
+      }
+    end
+  end
+end

data/lib/app/models/netzke_layout.rb

@@ -0,0 +1,75 @@
+class NetzkeLayout < ActiveRecord::Base
+  # has_many :layout_items#, :class_name => "ExtWidget::LayoutItem", :order => :position
+  # has_many :objects, :class_name => "Objects", :foreign_key => "class_name_id"
+  # belongs_to :role
+  # belongs_to :user
+
+  UNRELATED_ATTRS = %w(created_at updated_at position layout_id)
+
+  def self.user_id
+    @@user_id ||= nil
+  end
+  
+  def layout_items
+    items_class.constantize.find_all_by_layout_id(id, :order => 'position')
+  end
+  
+  #   
+  # def self.user_id=(user_id)
+  #   @@user_id = user_id
+  # end
+  # 
+  # def self.layout_items(widget_name)
+  #   layout = self.layout(widget_name)
+  #   layout.nil? ? nil : layout.layout_items.map(&:attributes).map{|item| item.delete_if{|k,v| UNRELATED_ATTRS.include?(k)}}
+  # end
+  # 
+  def self.by_widget(widget_name)
+    self.find(:first, :conditions => {:widget_name => widget_name, :user_id => self.user_id})
+  end
+
+  def move_item(old_index, new_index)
+    layout_item = layout_items[old_index]
+    layout_item.remove_from_list
+    layout_item.insert_at(new_index + 1)
+  end
+
+  # def self.layout_items(widget_name)
+  #   layout = self.by_widget(widget_name)
+  #   if layout
+  #     layout.layout_items
+  #   else
+  #     # create new layout and fill it out with default values
+  #     layout = Layout.create({:widget_name => widget_name, :user_id => self.user_id})
+  #   end
+  # end
+  
+  def items_hash
+    layout_items.map(&:attributes).map{|item| item.delete_if{|k,v| UNRELATED_ATTRS.include?(k)}}.map{ |i| i.convert_keys{ |k| k.to_sym } }
+  end
+ 
+  # if layout items are provided, use them instead of defaults (exsposed) layout items, but merge their configs with the default
+  # def self.create_layout_for_widget(widget_name, data_class_name, layout_item_class_name, items = nil)
+  #   layout = self.create(:widget_name => widget_name, :items_class => layout_item_class_name, :user_id => self.user_id)
+  #   data_class = data_class_name.constantize
+  #   layout_item_class = layout_item_class_name.constantize
+  #   
+  #   
+  #   if items.nil?
+  #     complete_items = data_class.exposed_columns
+  #   else
+  #     # normalize columns
+  #     columns = columns.
+  #     default_columns = data_class.exposed_columns.map{|c| c.is_a?(Symbol) ? {:name => c} : c}
+  #     columns.each
+  #   
+  #   complete_columns = columns.nil? ?  : columns
+  #   complete_columns.each do |c|
+  #     config = c.is_a?(Hash) ? c : {:name => c}
+  #     # we have to merge layout_id in order to have :position set up properly
+  #     item = layout_item_class.create_with_defaults(config.merge({:layout_id => layout.id}), data_class)
+  #   end
+  #   layout
+  # end
+  
+end

data/lib/app/models/netzke_preference.rb

@@ -0,0 +1,66 @@
+class NetzkePreference < ActiveRecord::Base
+  CONVERTION_METHODS= {'Fixnum' => 'to_i', 'String' => 'to_s', 'Float' => 'to_f', 'Symbol' => 'to_sym'}
+
+  def self.user=(user)
+    @@user = user
+  end
+  
+  def self.user
+    @@user ||= nil
+  end
+  
+  def self.custom_field=(value)
+    @@custom_field = value
+  end
+  
+  def self.custom_field
+    @@custom_field ||= nil
+  end
+  
+  def normalized_value
+    klass = read_attribute(:pref_type)
+    norm_value = read_attribute(:value)
+    if klass.nil?
+      # do not cast
+      r = norm_value
+    elsif klass == 'Boolean'
+      r = norm_value == 'false' ? false : (norm_value == 'true' || norm_value)
+    elsif klass == 'NilClass'
+      r = nil
+    elsif klass == 'Array'
+      r = JSON.parse(norm_value)
+    else
+      r = norm_value.send(CONVERTION_METHODS[klass])
+    end
+    r
+  end
+  
+  def normalized_value=(new_value)
+    # norm_value = (new_value.to_s if new_value == true or new_value == false) || new_value
+    case new_value.class.to_s
+    when "Array"
+      write_attribute(:value, new_value.to_json)
+    else
+      write_attribute(:value, new_value.to_s)
+    end
+    write_attribute(:pref_type, [TrueClass, FalseClass].include?(new_value.class) ? 'Boolean' : new_value.class.to_s)
+  end
+  
+  def self.[](pref_name)
+    pref_name = pref_name.to_s
+    conditions = {:name => pref_name, :user_id => self.user, :custom_field => self.custom_field}
+    pref = self.find(:first, :conditions => conditions)
+    # pref = @@user.nil? ? self.find_by_name(pref_name) : self.find_by_name_and_user_id(pref_name, @@user.id)
+    pref && pref.normalized_value
+  end
+  
+  def self.[]=(pref_name, new_value)
+    pref_name = pref_name.to_s
+    conditions = {:name => pref_name, :user_id => self.user, :custom_field => self.custom_field}
+    pref = self.find(:first, :conditions => conditions) || self.create(conditions)
+    # pref = self.user.nil? ? self.find_or_create_by_name(pref_name) : self.find_or_create_by_name_and_user_id(pref_name, self.user.id)
+    pref.normalized_value = new_value
+    pref.save!
+  end
+  
+end