acts_as_tree 1.3.0 → 1.4.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6345f6c0aff0309193dc564612c75fc1ea6b267a
+  data.tar.gz: 5d09b92e6dd13c1bf80be0f0b69d1cfb2c45328d
+SHA512:
+  metadata.gz: 9c048a9ed2b95836a0915e1e95619975ef8bc4a42f7937bdfb258977f3ec4bf9420fc38eb9c5fa21abe7fd359dbb6861ad61d0f003339813c1114610ef5c782a
+  data.tar.gz: 73fe82d6e696819c08633c5850ca1f1a4b588eb3033777df5bbd8331b2e4fc1de2dc636f5da1c5c9fb65fa9a9b8da4fc8740b69877bccd2c67386a199c2e8eb2

data/README.md

@@ -2,8 +2,7 @@
 [travis]: (http://travis-ci.org/amerine/acts_as_tree)
 
 
-ActsAsTree extends ActiveRecord to add simple support for organizing items into
-parent–children relationships.
+ActsAsTree extends ActiveRecord to add simple support for organizing items into parent–children relationships.
 
 ## Example
 
@@ -24,6 +23,27 @@ root.children # => [child1]
 root.children.first.children.first # => subchild1
 ```
 
+We also have a convenient `Presentation` module you can mixin if you want a little visual representation of the tree strucuture. Example:
+
+```ruby
+class Category < ActiveRecord::Base
+  include ActsAsTree
+  extend ActsAsTree::Presentation
+
+  acts_as_tree order: "name"
+end
+
+> Category.tree_view(:name)
+root
+ |_ child1
+ |    |_ subchild1
+ |    |_ subchild2
+ |_ child2
+      |_ subchild3
+      |_ subchild4
+=> nil
+```
+
 ## Compatibility
 
 We no longer support Ruby 1.8 or versions of Rails/ActiveRecord older than 3.0. If you're using a version of ActiveRecord older than 3.0 please use 0.1.1.
@@ -31,9 +51,12 @@ We no longer support Ruby 1.8 or versions of Rails/ActiveRecord older than 3.0.
 Moving forward we will do our best to support the latest versions of ActiveRecord and Ruby.
 
 ## Change Log
+* 1.4.0 - June 25th, 2013
+	* `Presentation#tree_view` -- rainchen
+	* `root?` && `leaf?` methods. -- xuanxu
 * 1.3.0 - March 29th, 2013
-  * Rails 4.0 Support! -- mischa78
-  * Readme Fixes -- mischa78 & seanhussey
+	* Rails 4.0 Support! -- mischa78
+	* Readme Fixes -- mischa78 & seanhussey
 * 1.2.0 - October 29th, 2012
 	* Adding new `self_with_ancestors` accessor -- fbuenemann
 	* `roots` is now a scope.

data/gemfiles/rails-4.0.gemfile

@@ -1,6 +1,6 @@
 source "https://rubygems.org"
 
-gem "rails", "~> 4.0.0.beta1"
+gem "rails", "~> 4.0"
 gem "acts_as_tree", path: "../"
 
 gemspec path: "../"

data/lib/acts_as_tree.rb

@@ -105,6 +105,38 @@ module ActsAsTree
         end
       EOV
     end
+
+  end
+
+  module Presentation
+    # show records in a tree view
+    # Example:
+    # root
+    #  |_ child1
+    #  |    |_ subchild1
+    #  |    |_ subchild2
+    #  |_ child2
+    #       |_ subchild3
+    #       |_ subchild4
+    #
+    def tree_view(label_method = :to_s,  node = nil, level = -1)
+      if node.nil?
+        puts "root"
+        nodes = roots
+      else
+        label = "|_ #{node.send(label_method)}"
+        if level == 0
+          puts " #{label}"
+        else
+          puts " |#{"    "*level}#{label}"
+        end
+        nodes = node.children
+      end
+      nodes.each do |child|
+        tree_view(label_method, child, level+1)
+      end
+    end
+
   end
 
   module InstanceMethods
@@ -152,6 +184,22 @@ module ActsAsTree
       [self] + self.ancestors
     end
 
+    # Returns true if node has no parent, false otherwise
+    #
+    #   subchild1.root? # => false
+    #   root.root?      # => true
+    def root?
+      parent.nil?
+    end
+
+    # Returns true if node has no children, false otherwise
+    #
+    #   subchild1.leaf? # => true
+    #   child1.leaf?    # => false
+    def leaf?
+      children.count == 0
+    end
+
     private
 
     def update_parents_counter_cache

data/lib/acts_as_tree/version.rb

@@ -1,3 +1,3 @@
 module ActsAsTree
-  VERSION = "1.3.0"
+  VERSION = "1.4.0"
 end

data/test/acts_as_tree_test.rb

@@ -179,6 +179,48 @@ class TreeTest < Test::Unit::TestCase
     assert_nil root4_child.reload.parent_id
   end
 
+  def test_is_root
+    assert_equal true, @root1.root?
+    assert_equal true, @root2.root?
+    assert_equal true, @root3.root?
+
+    assert_equal false, @root_child1.root?
+    assert_equal false, @child1_child.root?
+    assert_equal false, @child1_child_child.root?
+    assert_equal false, @root_child2.root?
+  end
+
+  def test_is_leaf
+    assert_equal true, @root2.leaf?
+    assert_equal true, @root3.leaf?
+    assert_equal true, @child1_child_child.leaf?
+    assert_equal true, @root_child2.leaf?
+
+    assert_equal false, @root1.leaf?
+    assert_equal false, @root_child1.leaf?
+    assert_equal false, @child1_child.leaf?
+  end
+
+  def test_tree_view
+    assert_equal false, Mixin.respond_to?(:tree_view)
+    Mixin.extend ActsAsTree::Presentation
+    assert_equal true,  TreeMixin.respond_to?(:tree_view)
+
+    tree_view_outputs = <<-END.gsub(/^ {6}/, '')
+      root
+       |_ 1
+       |    |_ 2
+       |        |_ 3
+       |            |_ 4
+       |    |_ 5
+       |_ 6
+       |_ 7
+    END
+    $stdout.reopen # reinitializes $stdout
+    TreeMixin.tree_view(:id)
+    assert_equal tree_view_outputs, $stdout.string
+  end
+
 end
 
 class TreeTestWithEagerLoading < Test::Unit::TestCase

metadata

@@ -1,8 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: acts_as_tree
 version: !ruby/object:Gem::Version
-  version: 1.3.0
-  prerelease: 
+  version: 1.4.0
 platform: ruby
 authors:
 - Erik Dahlstrand
@@ -12,54 +11,48 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-03-29 00:00:00.000000000 Z
+date: 2013-06-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: 3.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: 3.0.0
 - !ruby/object:Gem::Dependency
   name: sqlite3
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 description: A gem that adds simple support for organizing ActiveRecord models into
@@ -89,28 +82,27 @@ files:
 - test/acts_as_tree_test.rb
 homepage: https://github.com/amerine/acts_as_tree
 licenses: []
+metadata: {}
 post_install_message: 
 rdoc_options:
 - --charset=UTF-8
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.23
+rubygems_version: 2.0.0
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Provides a simple tree behaviour to active_record models.
 test_files:
 - test/acts_as_tree_test.rb