netzke-core 0.6.3 → 0.6.4

data/CHANGELOG.rdoc

@@ -1,4 +1,13 @@
-= v0.6.3 - EDGE
+= v0.6.4 - 2010-11-05
+* enhancements
+  * Implemented Netzke.isLoading(), useful for testing
+  * Persistence support
+
+* API change
+  * +endpoint+ DSL call now results in a method called <endpoint_name>_endpoint, _not_ just <endpoint_name> (beware when overriding endpoint definitions, or calling endpoint methods on child components)
+  * Using +api+ for endpoint declaration is gone
+
+= v0.6.3 - 2010-11-02
 * The +ext_config+ option is back, deprecated.
 
 = v0.6.2 - 2010-10-27
@@ -122,7 +131,7 @@
 * New: String#to_b converts a string to true/false
 * New: Netzke::Base.session introduced for session data
 * New: weak_children_config and strong_children_config can now be declared by a widget, which specifies weak and strong configuration that every child of this widget will receive (e.g. display/hide configuration tool)
-* Fix: (degradation) flash message is now shown again in case of erroneous attempt to load a widget
+* Fix: (degradation) flash message is now shown again in case of erroneous attempt to load a widge
 * New: widgets now can check session[:netzke_just_logged_in] and session[:netzke_just_logged_out] automatically set by Netzke after login/logout
 
 = v0.2.11
@@ -213,4 +222,4 @@
 * Meta work: replacing underscore with dash in the name
 
 = v0.1.0 - 2008-12-11
-* Initial release
+* Initial release

data/Rakefile

@@ -14,7 +14,7 @@ begin
 
 ========================================================================
 
-           Thanks for installing Netzke Core!
+           Thanks for installing netzke-core!
 
   Netzke home page:     http://netzke.org
   Netzke Google Groups: http://groups.google.com/group/netzke

data/app/controllers/netzke_controller.rb

@@ -49,7 +49,7 @@ class NetzkeController < ApplicationController
     if action
       w_instance = Netzke::Base.instance_by_config(Netzke::Core.session[:netzke_components][component_name])
       # only component's actions starting with "endpoint_" are accessible from outside (security)
-      endpoint_action = action.to_s.index('__') ? action : "endpoint_#{action}"
+      endpoint_action = action.to_s.index('__') ? action : "_#{action}_ep_wrapper"
       render :text => w_instance.send(endpoint_action, params), :layout => false
     else
       super

data/javascripts/core.js

@@ -10,6 +10,11 @@ At this time the following constants have been set by Rails:
 Ext.BLANK_IMAGE_URL = Netzke.RelativeExtUrl + "/resources/images/default/s.gif";
 Ext.ns('Ext.netzke'); // namespace for extensions that depend on Ext
 
+Netzke.isLoading=function () {
+	return Netzke.runningRequests!=0;				
+}
+Netzke.runningRequests=0
+
 Netzke.deprecationWarning = function(msg){
   if (typeof console == 'undefined') {
     // no console defined
@@ -479,6 +484,7 @@ Netzke.componentMixin = function(receiver){
 
     // Does the call to the server and processes the response
     callServer : function(intp, params, callback, scope){
+      Netzke.runningRequests++;
       if (!params) params = {};
         Ext.Ajax.request({
         params: params,
@@ -497,6 +503,7 @@ Netzke.componentMixin = function(receiver){
         },
         scope : this
       });
+      Netzke.runningRequests--;
     },
 
     setResult: function(result) {

data/lib/netzke/actions.rb

@@ -22,7 +22,6 @@ module Netzke
     extend ActiveSupport::Concern
 
     ACTION_METHOD_NAME = "%s_action"
-    ACTION_METHOD_REGEXP = /^(.+)_action$/
 
     included do
       alias_method_chain :js_config, :actions
@@ -30,6 +29,7 @@ module Netzke
 
     module ClassMethods
       def action(name, config = {}, &block)
+        register_action(name)
         config[:name] = name.to_s
         method_name = ACTION_METHOD_NAME % name
 
@@ -47,15 +47,24 @@ module Netzke
           end
         end
       end
+
+      # Register an action
+      def register_action(name)
+        current_actions = read_inheritable_attribute(:actions) || []
+        current_actions << name
+        write_inheritable_attribute(:actions, current_actions.uniq)
+      end
+
+      # Returns registered actions
+      def registered_actions
+        read_inheritable_attribute(:actions) || []
+      end
+
     end
 
-    # Actions to be used in the config
+    # All actions for this instance
     def actions
-      # Call all the action related methods to collect the actions
-      self.class.instance_methods.grep(ACTION_METHOD_REGEXP).inject({}) do |r, m|
-        m.match(ACTION_METHOD_REGEXP)
-        r.merge($1.to_sym => normalize_action_config(send(m)))
-      end
+      @actions ||= self.class.registered_actions.inject({}){ |res, name| res.merge(name.to_sym => normalize_action_config(send(ACTION_METHOD_NAME % name))) }
     end
 
     def js_config_with_actions #:nodoc
@@ -99,4 +108,4 @@ module Netzke
       # end
 
   end
-end
+end

data/lib/netzke/base.rb

@@ -5,7 +5,7 @@ require 'netzke/stylesheets'
 require 'netzke/services'
 require 'netzke/composition'
 require 'netzke/configuration'
-require 'netzke/persistence'
+require 'netzke/state'
 require 'netzke/embedding'
 require 'netzke/actions'
 require 'netzke/session'
@@ -28,7 +28,7 @@ module Netzke
     self.default_instance_config = {}
 
     include Session
-    include Persistence
+    include State
     include Configuration
     include Javascript
     include Services

data/lib/netzke/composition.rb

@@ -4,6 +4,8 @@ module Netzke
   module Composition
     extend ActiveSupport::Concern
 
+    COMPONENT_METHOD_NAME = "%s_component"
+
     included do
 
       # Loads a component on browser's request. Every Nettzke component gets this endpoint.
@@ -46,16 +48,23 @@ module Netzke
       #       {:data_class => "Book", :title => orig[:title] + ", extended"}
       #     end
       def component(name, config = {}, &block)
+        register_component(name)
         config = config.dup
         config[:class_name] ||= name.to_s.camelize
         config[:name] = name.to_s
-        method_name = "_#{name}_component"
+        method_name = COMPONENT_METHOD_NAME % name
 
         if block_given?
           define_method(method_name, &block)
         else
-          define_method(method_name) do
-            config
+          if superclass.instance_methods.map(&:to_s).include?(method_name)
+            define_method(method_name) do
+              super().merge(config)
+            end
+          else
+            define_method(method_name) do
+              config
+            end
           end
         end
       end
@@ -67,6 +76,18 @@ module Netzke
         config.merge(:component => name)
       end
 
+      # Register a component
+      def register_component(name)
+        current_components = read_inheritable_attribute(:components) || []
+        current_components << name
+        write_inheritable_attribute(:components, current_components.uniq)
+      end
+
+      # Returns registered components
+      def registered_components
+        read_inheritable_attribute(:components) || []
+      end
+
     end
 
     module InstanceMethods
@@ -81,16 +102,7 @@ module Netzke
 
       # All components for this instance, which includes components defined on class level, and components detected in :items
       def components
-        # items if @components.nil? # simply trigger collecting @components from items
-        # self.class.components.merge(@components || {})
-
-        @components ||= begin
-          method_regexp = /^_(.+)_component$/
-          self.class.instance_methods.grep(method_regexp).inject({}) do |r, m|
-            m.match(method_regexp)
-            r.merge($1.to_sym => send(m))
-          end
-        end
+        @components ||= self.class.registered_components.inject({}){ |res, name| res.merge(name.to_sym => send(COMPONENT_METHOD_NAME % name)) }
       end
 
       def non_late_components
@@ -211,7 +223,7 @@ module Netzke
         if action
           if components[component]
             # only actions starting with "endpoint_" are accessible
-            endpoint_action = action.to_s.index('__') ? action : "endpoint_#{action}"
+            endpoint_action = action.to_s.index('__') ? action : "_#{action}_ep_wrapper"
             component_instance(component).send(endpoint_action, params)
           else
             component_missing(component)

data/lib/netzke/configuration.rb

@@ -48,7 +48,7 @@ module Netzke
 
       # Config that is not overridden by parents and sessions
       def independent_config
-        @independent_config ||= initial_config.merge(weak_independent_options).merge(persistent_options)
+        @independent_config ||= initial_config.merge(weak_independent_options).merge(initial_config[:persistence] ? persistent_options : {})
       end
 
       def session_config

data/lib/netzke/core/session.rb

@@ -1,15 +1,6 @@
 module Netzke
   module Core
     module Session
-      # Access to controller sessions
-      def session
-        @@session ||= {}
-      end
-
-      def session=(s)
-        @@session = s
-      end
-
       # Should be called by session controller at the moment of successfull login
       def login
         session[:_netzke_next_request_is_first_after_login] = true

data/lib/netzke/core/version.rb

@@ -3,7 +3,7 @@ module Netzke
     module Version
       MAJOR = 0
       MINOR = 6
-      PATCH = 3
+      PATCH = 4
 
       STRING = [MAJOR, MINOR, PATCH].compact.join('.')
     end

data/lib/netzke/core.rb

@@ -21,7 +21,12 @@ module Netzke
     extend Session
     extend Masquerading
 
+    # set in Netzke::ControllerExtensions
     mattr_accessor :controller
+    
+    # set in Netzke::ControllerExtensions
+    mattr_accessor :session
+    @@session = {}
 
     mattr_accessor :javascripts
     @@javascripts = ["#{File.dirname(__FILE__)}/../../javascripts/core.js"]
@@ -32,8 +37,8 @@ module Netzke
     mattr_accessor :external_css
     @@external_css = []
 
+    # Set in the Engine after_initialize callback
     mattr_accessor :ext_location
-
     mattr_accessor :with_icons
 
     mattr_accessor :icons_uri
@@ -42,6 +47,12 @@ module Netzke
     mattr_accessor :javascript_on_main_page
     @@javascript_on_main_page = true
 
+    mattr_accessor :persistence_manager
+    @@persistence_manager = "NetzkeComponentState"
+    
+    # Set in the Engine after_initialize callback
+    mattr_accessor :persistence_manager_class
+
     def self.setup
       yield self
     end

data/lib/netzke/core_ext/symbol.rb

@@ -8,10 +8,10 @@ class Symbol
   end
 
   def action(config = {})
-    config.merge(:action => self.to_s)
+    config.merge(:action => self)
   end
 
   def component(config = {})
-    config.merge(:component => self.to_s)
+    config.merge(:component => self)
   end
 end

data/lib/netzke/javascript.rb

@@ -217,7 +217,7 @@ module Netzke
         res[:components] = comp_hash unless comp_hash.empty?
 
         # Api (besides the default "deliver_component" - JavaScript side already knows about it)
-        endpoints = self.class.endpoints - [:deliver_component]
+        endpoints = self.class.registered_endpoints - [:deliver_component]
         res.merge!(:endpoints => endpoints) unless endpoints.empty?
 
         # Inform the JavaScript side if persistent_config is enabled

data/lib/netzke/services.rb

@@ -15,45 +15,45 @@ module Netzke
       # See netzke-basepack's GridPanel for an example.
       #
       def api(*api_points)
-        ::ActiveSupport::Deprecation.warn("Using the 'api' call is deprecated. Use the 'endpoint' approach instead", caller)
+        ::ActiveSupport::Deprecation.warn("Using the 'api' call has no longer effect. Define endpoints instead.", caller)
 
-        api_points.each do |apip|
-          add_endpoint(apip)
-        end
+        # api_points.each do |apip|
+        #   register_endpoint(apip)
+        # end
 
         # It may be needed later for security
-        api_points.each do |apip|
-          module_eval <<-END, __FILE__, __LINE__
-          def endpoint_#{apip}(*args)
-            before_api_call_result = defined?(before_api_call) && before_api_call('#{apip}', *args) || {}
-            (before_api_call_result.empty? ? #{apip}(*args) : before_api_call_result).to_nifty_json
-          end
-          END
-        end
+        # api_points.each do |apip|
+        #   module_eval <<-END, __FILE__, __LINE__
+        #   def endpoint_#{apip}(*args)
+        #     before_api_call_result = defined?(before_api_call) && before_api_call('#{apip}', *args) || {}
+        #     (before_api_call_result.empty? ? #{apip}(*args) : before_api_call_result).to_nifty_json
+        #   end
+        #   END
+        # end
       end
 
       # Defines an endpoint
       def endpoint(name, options = {}, &block)
-        add_endpoint(name)
-        define_method name, &block if block # if no block is given, the method is supposed to be defined elsewhere
+        register_endpoint(name)
+        define_method("#{name}_endpoint", &block) if block # if no block is given, the method is supposed to be defined elsewhere
 
         # define_method name, &block if block # if no block is given, the method is supposed to be defined elsewhere
-        define_method :"endpoint_#{name}" do |*args|
-          res = send(name, *args)
+        define_method :"_#{name}_ep_wrapper" do |*args|
+          res = send("#{name}_endpoint", *args)
           res.respond_to?(:to_nifty_json) && res.to_nifty_json || ""
         end
       end
 
       # Register an endpoint
-      def add_endpoint(ep)
+      def register_endpoint(ep)
         current_endpoints = read_inheritable_attribute(:endpoints) || []
         current_endpoints << ep
         write_inheritable_attribute(:endpoints, current_endpoints.uniq)
       end
 
       # Returns registered endpoints
-      def endpoints
-        read_inheritable_attribute(:endpoints)
+      def registered_endpoints
+        read_inheritable_attribute(:endpoints) || []
       end
     end
 

data/lib/netzke/state.rb

@@ -0,0 +1,64 @@
+require 'active_support/core_ext/hash/indifferent_access'
+module Netzke
+  # When a persistence subsystem (such as {netzke-persistence}[https://github.com/skozlov/netzke-persistence]) is used, a widget can store its state using the +update_state+ method that accepts a hash, e.g.:
+  #     update_state(:position => {:x => 100, :y => 200})
+  # 
+  # Later the state can be retrieved by calling the +state+ method:
+  # 
+  #     state[:position] #=> {:x => 100, :y => 200}
+  # 
+  # To enable persistence for a specific component, configure it with +persistence+ option set to +true+.
+  # 
+  # == Sharing state
+  # 
+  # Different components can share the state by sharing the persistence key, which can be provided as configuration option, e.g.:
+  # 
+  #     netzke :books, :class_name => "Basepack::GridPanel", :persistence_key => "books_state_identifier"
+  #     netzke :deleted_books, :class_name => "Basepack::GridPanel", :persistence_key => "books_state_identifier"
+  # 
+  # Make sure that the provided persistence_key has effect on _application_ level, _not_ only within the view.
+  # By default persistence_key is set to component's global id. Thus, <i>two components named equally will share the state even being used in different views</i>.
+  # 
+  module State
+    # A string which will identify the component in persistence subsystem.
+    # If +persistence_key+ is passed, use it. Otherwise use global_id.
+    def persistence_key
+      initial_config[:persistence_key] ? initial_config[:persistence_key] : global_id
+    end
+
+    # Component's persistent state.
+    def state
+      @state ||= (state_manager.state || {}).symbolize_keys
+    end
+    
+    # Merges passed hash into component's state.
+    def update_state(hsh)
+      state_manager.update_state!(hsh)
+      @state = nil # reset cache
+    end
+
+    # Options merged into component's configuration right after default and user-passed config, thus being reflected in +Netzke::Base#independent_config+ (see Netzke::Configuration).
+    def persistent_options
+      (state[:persistent_options] || {}).symbolize_keys
+    end
+    
+    # Updates +persistent_options+
+    def update_persistent_options(hsh)
+      new_persistent_options = persistent_options.merge(hsh)
+      new_persistent_options.delete_if{ |k,v| v.nil? } # setting values to nil means deleting them
+      update_state(:persistent_options => new_persistent_options)
+    end
+
+    protected 
+    
+    # Initialized state manager class. At this moment this class has current_user, component, and session set.
+    def state_manager
+      @state_manager ||= Netzke::Core.persistence_manager_class.init({
+        :component => persistence_key,
+        :current_user => Netzke::Core.controller.respond_to?(:current_user) && Netzke::Core.controller.current_user,
+        :session => Netzke::Core.session
+      })
+    end
+
+  end
+end

data/lib/netzke-core.rb

@@ -14,6 +14,7 @@ module Netzke
       # Do some initialization which is only possible after Rails is initialized
       Netzke::Core.ext_location ||= ::Rails.root.join("public", "extjs")
       Netzke::Core.with_icons = File.exists?("#{Rails.root}/public#{Netzke::Core.icons_uri}") if Netzke::Core.with_icons.nil?
+      Netzke::Core.persistence_manager_class = Netzke::Core.persistence_manager.constantize rescue nil
     end
   end
 end

data/netzke-core.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{netzke-core}
-  s.version = "0.6.3"
+  s.version = "0.6.4"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Sergei Kozlov"]
-  s.date = %q{2010-11-02}
+  s.date = %q{2010-11-05}
   s.description = %q{Allows building ExtJS/Rails reusable code in a DRY way}
   s.email = %q{sergei@playcode.nl}
   s.extra_rdoc_files = [
@@ -45,14 +45,9 @@ Gem::Specification.new do |s|
     "features/step_definitions/web_steps.rb",
     "features/support/env.rb",
     "features/support/paths.rb",
-    "generators/netzke_core/USAGE",
-    "generators/netzke_core/netzke_core_generator.rb",
     "init.rb",
     "install.rb",
     "javascripts/core.js",
-    "lib/generators/migration_helper.rb",
-    "lib/generators/netzke/USAGE",
-    "lib/generators/netzke/core_generator.rb",
     "lib/netzke-core.rb",
     "lib/netzke/actions.rb",
     "lib/netzke/base.rb",
@@ -71,12 +66,12 @@ Gem::Specification.new do |s|
     "lib/netzke/embedding.rb",
     "lib/netzke/ext_component.rb",
     "lib/netzke/javascript.rb",
-    "lib/netzke/persistence.rb",
     "lib/netzke/rails/action_view_ext.rb",
     "lib/netzke/rails/controller_extensions.rb",
     "lib/netzke/rails/routes.rb",
     "lib/netzke/services.rb",
     "lib/netzke/session.rb",
+    "lib/netzke/state.rb",
     "lib/netzke/stylesheets.rb",
     "lib/tasks/netzke_core_tasks.rake",
     "netzke-core.gemspec",
@@ -88,7 +83,6 @@ Gem::Specification.new do |s|
     "spec/spec.opt",
     "spec/spec_helper.rb",
     "stylesheets/core.css",
-    "templates/core/create_netzke_preferences.rb",
     "test/fixtures/roles.yml",
     "test/fixtures/users.yml",
     "test/rails_app/.gitignore",
@@ -166,7 +160,7 @@ Gem::Specification.new do |s|
   s.post_install_message = %q{
 ========================================================================
 
-           Thanks for installing Netzke Core!
+           Thanks for installing netzke-core!
 
   Netzke home page:     http://netzke.org
   Netzke Google Groups: http://groups.google.com/group/netzke

data/test/rails_app/app/components/extended_server_caller.rb

@@ -10,7 +10,7 @@ class ExtendedServerCaller < ServerCaller
     }
   JS
 
-  def whats_up(params)
+  def whats_up_endpoint(params)
     orig = super
     orig.merge(:set_title => orig[:set_title] + ", shiny weather")
   end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 6
-  - 3
-  version: 0.6.3
+  - 4
+  version: 0.6.4
 platform: ruby
 authors: 
 - Sergei Kozlov
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-11-02 00:00:00 +01:00
+date: 2010-11-05 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -70,14 +70,9 @@ files:
 - features/step_definitions/web_steps.rb
 - features/support/env.rb
 - features/support/paths.rb
-- generators/netzke_core/USAGE
-- generators/netzke_core/netzke_core_generator.rb
 - init.rb
 - install.rb
 - javascripts/core.js
-- lib/generators/migration_helper.rb
-- lib/generators/netzke/USAGE
-- lib/generators/netzke/core_generator.rb
 - lib/netzke-core.rb
 - lib/netzke/actions.rb
 - lib/netzke/base.rb
@@ -96,12 +91,12 @@ files:
 - lib/netzke/embedding.rb
 - lib/netzke/ext_component.rb
 - lib/netzke/javascript.rb
-- lib/netzke/persistence.rb
 - lib/netzke/rails/action_view_ext.rb
 - lib/netzke/rails/controller_extensions.rb
 - lib/netzke/rails/routes.rb
 - lib/netzke/services.rb
 - lib/netzke/session.rb
+- lib/netzke/state.rb
 - lib/netzke/stylesheets.rb
 - lib/tasks/netzke_core_tasks.rake
 - netzke-core.gemspec
@@ -113,7 +108,6 @@ files:
 - spec/spec.opt
 - spec/spec_helper.rb
 - stylesheets/core.css
-- templates/core/create_netzke_preferences.rb
 - test/fixtures/roles.yml
 - test/fixtures/users.yml
 - test/rails_app/.gitignore
@@ -191,7 +185,7 @@ homepage: http://netzke.org
 licenses: []
 
 post_install_message: "\n\
-  ========================================================================\n\n           Thanks for installing Netzke Core!\n\n  Netzke home page:     http://netzke.org\n  Netzke Google Groups: http://groups.google.com/group/netzke\n  Netzke tutorials:     http://blog.writelesscode.com\n\n\
+  ========================================================================\n\n           Thanks for installing netzke-core!\n\n  Netzke home page:     http://netzke.org\n  Netzke Google Groups: http://groups.google.com/group/netzke\n  Netzke tutorials:     http://blog.writelesscode.com\n\n\
   ========================================================================\n\n"
 rdoc_options: []
 

data/generators/netzke_core/USAGE

@@ -1,8 +0,0 @@
-Description:
-    Generates a netzke preferences migration
-
-Example:
-    ./script/generate netzke-core
-
-    This will create:
-        A netzke preferences migration

data/generators/netzke_core/netzke_core_generator.rb

@@ -1,18 +0,0 @@
-# class NetzkeCoreGenerator < Rails::Generator::NamedBase
-class NetzkeCoreGenerator < Rails::Generator::Base
-  def manifest
-    record do |m|
-      m.migration_template 'create_netzke_preferences.rb', 'db/migrate', :assigns => {
-        :migration_name => "CreateNetzkePreferences"
-      }, :migration_file_name => "create_netzke_preferences"
-    end
-  end
-
-  def self.gem_root
-    File.expand_path('../../../', __FILE__)
-  end
-
-  def self.source_root
-    File.join(gem_root, 'templates', 'core')
-  end
-end

data/lib/generators/migration_helper.rb

@@ -1,32 +0,0 @@
-module MigrationHelper
-  include Rails::Generators::Migration
-
-  module ClassMethods
-    def migration_lookup_at(dirname) #:nodoc:
-      Dir.glob("#{dirname}/[0-9]*_*.rb")
-    end
-
-    def migration_exists?(dirname, file_name) #:nodoc:
-      migration_lookup_at(dirname).grep(/\d+_#{file_name}.rb$/).first
-    end
-
-    def current_migration_number(dirname) #:nodoc:
-      migration_lookup_at(dirname).collect do |file|
-        File.basename(file).split("_").first.to_i
-      end.max.to_i
-    end
-
-    def next_migration_number(dirname) #:nodoc:
-      orm = Rails.configuration.generators.options[:rails][:orm]
-      require "rails/generators/#{orm}"
-      "#{orm.to_s.camelize}::Generators::Base".constantize.next_migration_number(dirname)
-    rescue
-      raise NotImplementedError
-    end
-  end
-
-  def self.included(base) #:nodoc:
-    puts "MigrationHelper included by #{base}"
-    base.extend ClassMethods
-  end
-end

data/lib/generators/netzke/USAGE

@@ -1,8 +0,0 @@
-Description:
-    Generates a netzke preferences migration
-
-Example:
-    rails g netzke:core
-
-    This will create:
-        A netzke preferences migration

data/lib/generators/netzke/core_generator.rb

@@ -1,24 +0,0 @@
-require 'rails/generators'
-require 'rails/generators/migration'
-require 'generators/migration_helper'
-
-module Netzke
-  module Generators
-    class CoreGenerator < Rails::Generators::Base
-      include ::MigrationHelper
-
-      def execute
-        migration_template 'create_netzke_preferences.rb', 'db/migrate/create_netzke_preferences.rb'
-      end
-
-      def self.source_root
-        File.join(gem_root, 'templates', 'core')
-      end
-
-      def self.gem_root
-        File.expand_path("../../../../", __FILE__)
-      end
-
-    end
-  end
-end

data/lib/netzke/persistence.rb

@@ -1,118 +0,0 @@
-module Netzke
-  # TODO:
-  # rename persistence_ to persistence_
-  module Persistence
-
-    module ClassMethods
-      # Persistent config manager class
-      def persistence_manager_class
-        Netzke::Base.persistence_manager.try(:constantize)
-      rescue NameError
-        nil
-      end
-
-    end
-
-    module InstanceMethods
-
-      # If the component has persistent config in its disposal
-      def persistence_enabled?
-        !persistence_manager_class.nil? && initial_config[:persistent_config]
-      end
-
-      # Access to own persistent config, e.g.:
-      #     persistent_config["window.size"] = 100
-      #     persistent_config["window.size"] => 100
-      # This method is user/role-aware
-      # def persistent_config
-      #   if persistence_enabled?
-      #     config_class = self.class.persistence_manager_class
-      #     config_class.component_name = persistence_key.to_s # pass to the config class our unique name
-      #     config_class
-      #   else
-      #     # if we can't use presistent config, all the calls to it will always return nil,
-      #     # and the "="-operation will be ignored
-      #     logger.debug "==> NETZKE: no persistent config is set up for component '#{global_id}'"
-      #     {}
-      #   end
-      # end
-
-      # Access to the global persistent config (e.g. of another component)
-      def global_persistent_config(owner = nil)
-        config_class = self.class.persistence_manager_class
-        config_class.component_name = owner
-        config_class
-      end
-
-      # A string which will identify NetzkePreference records for this component.
-      # If <tt>persistence_key</tt> is passed, use it. Otherwise use global component's id.
-      def persistence_key #:nodoc:
-        # initial_config[:persistence_key] ? parent.try(:persistence_key) ? "#{parent.persistence_key}__#{initial_config[:persistence_key]}".to_sym : initial_config[:persistence_key] : global_id.to_sym
-        initial_config[:persistence_key] ? initial_config[:persistence_key] : global_id.to_sym
-      end
-
-      # def update_persistent_ext_config(hsh)
-      #   current_config = persistent_config[:ext_config] || {}
-      #   current_config.deep_merge!(hsh.deep_convert_keys{ |k| k.to_s }) # first, recursively stringify the keys
-      #   persistent_config[:ext_config] = current_config
-      # end
-
-      # Returns a hash built from all persistent config values for the current component, following the double underscore
-      # naming convention. E.g., if we have the following persistent config pairs:
-      #     enabled  => true
-      #     layout__width => 100
-      #     layout__header__height => 20
-      #
-      # this method will return the following hash:
-      #     {:enabled => true, :layout => {:width => 100, :header => {:height => 20}}}
-      # def persistence_hash_OLD
-      #   return {} if !persistence_enabled?
-      #
-      #   @persistence_hash ||= begin
-      #     prefs = NetzkePreference.find_all_for_component(persistence_key.to_s)
-      #     res = {}
-      #     prefs.each do |p|
-      #       hsh_levels = p.name.split("__").map(&:to_sym)
-      #       tmp_res = {} # it decends into itself, building itself
-      #       anchor = {} # it will keep the tail of tmp_res
-      #       hsh_levels.each do |level_prefix|
-      #         tmp_res[level_prefix] ||= level_prefix == hsh_levels.last ? p.normalized_value : {}
-      #         anchor = tmp_res[level_prefix] if level_prefix == hsh_levels.first
-      #         tmp_res = tmp_res[level_prefix]
-      #       end
-      #       # Now 'anchor' is a hash that represents the path to the single value,
-      #       # for example: {:ext_config => {:title => 100}} (which corresponds to ext_config__title)
-      #       # So we need to recursively merge it into the final result
-      #       res.deep_merge!(hsh_levels.first => anchor)
-      #     end
-      #     res.deep_convert_keys{ |k| k.to_sym } # recursively symbolize the keys
-      #   end
-      # end
-
-      def update_persistent_options(hash)
-        if persistence_enabled?
-          options = persistent_options
-          persistence_manager_class.pref_to_write(global_id).update_attribute(:value, options.deep_merge(hash))
-        else
-          logger && logger.debug("Netzke warning: No persistence enabled for component '#{global_id}'")
-        end
-      end
-
-      def persistent_options
-        return {} if !persistence_enabled?
-        persistence_manager_class.pref_to_read(global_id).try(:value) || {}
-      end
-
-      # A convenience method for instances
-      def persistence_manager_class
-        self.class.persistence_manager_class
-      end
-
-    end
-
-    def self.included(receiver)
-      receiver.extend         ClassMethods
-      receiver.send :include, InstanceMethods
-    end
-  end
-end

data/templates/core/create_netzke_preferences.rb

@@ -1,18 +0,0 @@
-class CreateNetzkePreferences < ActiveRecord::Migration
-  def self.up
-    drop_table(:netzke_preferences) if table_exists?(:netzke_preferences)
-
-    create_table :netzke_preferences do |t|
-      t.string  :key
-      t.text    :value
-      t.integer :user_id
-      t.integer :role_id
-
-      t.timestamps
-    end
-  end
-
-  def self.down
-    drop_table :netzke_preferences
-  end
-end