the_sortable_tree 2.1.0 → 2.2.0

data/README.md

@@ -1,4 +1,4 @@
-# TheSortableTree v2.1.0
+# TheSortableTree v2.2.0
 
 Nested Set + Drag&Drop GUI. Very fast! Best render helper! **2000 nodes/sec**. Ready for rails 4 ([RubyGems](http://rubygems.org/gems/the_sortable_tree))
 
@@ -103,31 +103,39 @@ class PagesController < ApplicationController
 end
 ```
 
+## Basic Render Method
+
+```ruby
+build_server_tree(tree, options)
+```
+
 ## Render Tree
 
 **app/views/pages/manage.html.haml**
 
 ```haml
-%ol.tree= build_server_tree @pages
+%ol.tree= just_tree @pages
 ```
 
-## Render Sortable Tree
+**just_tree** is just alias of **build_server_tree(tree, type: :tree)**
 
-**app/views/pages/manage.html.haml**
+## Render Sortable Tree
 
 ```haml
 %ol.sortable_tree{ data: { max_levels: 5, rebuild_url: rebuild_pages_url } }
-  = build_server_tree @pages, type: :sortable
+  = sortable_tree @pages
 ```
+**sortable_tree** is just alias of **build_server_tree(tree, type: :sortable)**
 
 ## Render Nested Options Tree
 
-**app/views/pages/manage.html.haml**
-
 ```haml
-= select_tag :pages, nested_options(@pages, :selected => Page.last), class: :nested_options
+= select_tag :page_id, nested_options(@pages, :selected => Page.last), class: :nested_options
 ```
 
+**nested_options** is just alias of **build_server_tree(tree, type: :nested_options)**
+
+
 ## build_server_tree options
 
 **Client side:**
@@ -144,11 +152,20 @@ Required params for sortable GUI! Must be defined at root element of tree.
 
 **Server side:**
 
+
+define
+
+```ruby
+build_server_tree(pages, {:option_1 => :value_1, :option_2 => :value_2})
+```
+
+use
+
 ```ruby
 options[:NAME]
 ```
 
-Optional params
+Options list:
 
 1. **id** - id field of node
 2. **title** - title field of node
@@ -201,11 +218,12 @@ bundle exec rails g the_sortable_tree:views assets
 
 BANCHMARK:
 
-- Server Side, 16.000 nodes, 3 levels
+tree params: 16.000 nodes, 3 levels
+
 - Views: 7999.6ms | ActiveRecord: 79.2ms
 - WebInspector full time ~ 9.64s
 
-total: ~**2000 nodes/sec**
+total: ~ **2000 nodes/sec**
 
 ## Looking for maintainers
 
@@ -219,6 +237,13 @@ Try to create view helpers for:
 4. Comments Tree gem
 3. gem Ancestry (???)
 
+## I want to try! I need tests!
+
+1. I'm develop gem with test app [the_sortable_tree_test_app](https://github.com/the-teacher/the_sortable_tree_test_app). You can clone it and see some testcase-pages for gem
+2. Sorry, but I have not tests for this gem. Gem is so easy. It's easy to test only with test app.
+3. You can write some tests, if your need.
+4. No! I know RSpec. I can write tests. But I have not reasons to write tests here.
+
 ##  Аcknowledgment
 
 1. [mjsarfatti/nestedSortable](https://github.com/mjsarfatti/nestedSortable)

data/app/helpers/{render_select_options_helper.rb → render_nested_options_helper.rb}

@@ -1,4 +1,4 @@
-module RenderSelectOptionsHelper
+module RenderNestedOptionsHelper
   class Render
     class << self
       attr_accessor :h, :options
@@ -10,7 +10,7 @@ module RenderSelectOptionsHelper
         selected = (options[:selected] == node) ? ' selected' : nil
 
         "
-        <option value='#{node[:id]}' class='l_#{ options[:level] }#{selected}'>#{ node[:title] }</option>
+        <option value='#{node[:id]}' class='l_#{ options[:level] }#{selected}'>#{ node.send(options[:title]) }</option>
         #{ options[:children] }
         "
       end

data/app/helpers/the_sortable_tree_helper.rb

@@ -9,7 +9,7 @@ module TheSortableTreeHelper
   TREE_RENDERERS = {
     :tree     => RenderTreeHelper,
     :sortable => RenderSortableTreeHelper,
-    :select_options => RenderSelectOptionsHelper
+    :nested_options => RenderNestedOptionsHelper
   }
 
   ###############################################
@@ -29,13 +29,19 @@ module TheSortableTreeHelper
   end
 
   ###############################################
-  # Nested Options Helper
+  # Shortcuts
   ###############################################
+  
+  def just_tree tree, options = {}
+    build_server_tree(tree, { :type => :tree }.merge!(options))
+  end
+
+  def sortable_tree tree, options = {}
+    build_server_tree(tree, { :type => :sortable }.merge!(options))
+  end
 
   def nested_options tree, options = {}
-    opts = { :type => :select_options }
-    opts.merge!(options)
-    build_server_tree(tree, opts)
+    build_server_tree(tree, { :type => :nested_options }.merge!(options))
   end
 
   ###############################################
@@ -72,6 +78,8 @@ module TheSortableTreeHelper
     opts[:klass] = define_class_of_elements_of(tree) unless opts[:klass]
 
     # BOOST PATCH (BUILD ONCE)
+    # solution of main perfomance problem
+    # magick index-array, which made me happy!
     if opts[:boost].empty?
       tree.each do |item|
         num = item.parent_id || 0
@@ -91,9 +99,11 @@ module TheSortableTreeHelper
       end
 
       # children rendering
-      roots.each do |root|
-        _opts  =  opts.merge({ :node => root, :root => true, :level => opts[:level].next, :boost => opts[:boost] })
-        result << build_server_tree(tree, _opts)
+      if roots
+        roots.each do |root|
+          _opts  =  opts.merge({ :node => root, :root => true, :level => opts[:level].next, :boost => opts[:boost] })
+          result << build_server_tree(tree, _opts)
+        end
       end
     else
       # RENDER NODE'S CHILDREN

data/lib/the_sortable_tree/version.rb

@@ -1,3 +1,3 @@
 module TheSortableTree
-  VERSION = "2.1.0"
+  VERSION = "2.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: the_sortable_tree
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-20 00:00:00.000000000 Z
+date: 2013-01-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
-  requirement: &81000690 !ruby/object:Gem::Requirement
+  requirement: &85373190 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '3.1'
   type: :runtime
   prerelease: false
-  version_requirements: *81000690
+  version_requirements: *85373190
 - !ruby/object:Gem::Dependency
   name: sqlite3
-  requirement: &81000310 !ruby/object:Gem::Requirement
+  requirement: &85372810 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *81000310
+  version_requirements: *85372810
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &80999910 !ruby/object:Gem::Requirement
+  requirement: &85372410 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *80999910
+  version_requirements: *85372410
 - !ruby/object:Gem::Dependency
   name: rspec-rails
-  requirement: &80999620 !ruby/object:Gem::Requirement
+  requirement: &85372120 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,7 +54,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *80999620
+  version_requirements: *85372120
 description: Drag&Drop GUI for awesom_nested_set. Render Tree Helper. Very fast! Ready
   for Rails 4
 email:
@@ -81,10 +81,10 @@ files:
 - app/assets/javascripts/sortable_tree/initializer.js.coffee
 - app/views/sortable/client/_tree.html.erb
 - app/views/tree/client/_tree.html.erb
-- app/helpers/render_select_options_helper.rb
 - app/helpers/render_tree_helper.rb
 - app/helpers/the_sortable_tree_helper.rb
 - app/helpers/render_sortable_tree_helper.rb
+- app/helpers/render_nested_options_helper.rb
 - lib/the_sortable_tree/version.rb
 - lib/the_sortable_tree/engine.rb
 - lib/generators/the_sortable_tree/views_generator.rb