hierarchical_db 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8702a58ec4688699a35046a850ce350e00f54f72
-  data.tar.gz: f71234610e0718fa40f823a92d0d3027d01746a4
+  metadata.gz: 861a2dffcff74a32cc269574fe99e5efde59fc2c
+  data.tar.gz: 1c07b2bf9a7386b441b8439006f70fadfda6fd60
 SHA512:
-  metadata.gz: c3505c248cd6384c9e0794cb5ffb3d090257e8020be9c6c1c90e7b96a7c7c9d43f3b09222d0a140d2b362f73a0ec0dbc3816a175fe77fc455406939c54f6f15b
-  data.tar.gz: 13529ef441028d66c44d7e6e2ac775c265ea200cba704b6929ee7398cd49cde3e6f7b63b7d09754e7e5748977abab996b48973b0f29b9eccf413c64890305bec
+  metadata.gz: 1fe5c03619545c96e4ebcee1b50f59182a5fb59a621238931f443fd1541fa0774cd3b985712267339dfd52af668559d44a65ba076891246dfe1780975714a081
+  data.tar.gz: 8c93dd008ced535632adc8d94c5ce97fc1e5491cdc8531fb9bfcddd67fcb8325c3470466fa9d1d103366d124667c94d710a20b467fe0f6fc57f1b29635719f9a

data/.gitignore

@@ -1,9 +1,12 @@
-/.bundle/
-/.yardoc
-/Gemfile.lock
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+_yardoc
+coverage
+doc/
+pkg
+tmp
+gemfiles/*.lock

data/README.md

@@ -18,22 +18,19 @@ Or install it yourself as:
 
     $ gem install hierarchical_db
 
-Next you have to add a migration into your model with attributes *lft* and *rgt*. For example, if you have a model called *Territory* (to manage countries, cities and all the other hierarchies) with the following relationship:
+Next you have to use the hierarchical_db generator into your model. For example, if you have a model called *Territory* (to manage countries, cities and all the other hierarchies) with the following relationship:
 ```ruby
 class Territory < ActiveRecord::Base
   belongs_to :parent_territory, class_name: 'Territory'
 end
 ```
-You have to add a migration like this:
-```ruby
-class AddSortedTreeFields < ActiveRecord::Migration
-  def change
-    add_column :territories, :lft, :integer
-    add_column :territories, :rgt, :integer
-  end
-end
+You have to execute the generator with the code below:
+```
+rails g hierarchical_db territories
 ```
-Into the model you have to include Hierarchies adding the code below:
+Now your model has the attributes *lft* and *rgt* that are essential to the gem work properly.
+
+Next into the model you have to include Hierarchies adding the code below:
 ```ruby
 class Territory < ActiveRecord::Base
   include HierarchicalDb #we added this
@@ -56,7 +53,27 @@ Continuing the example, if you have data inside your Territory model, then you h
 ```ruby
   Territory.sort_tree
 ```
-This command initializes your tree and fills *lft* and *rgt* attributes with corresponding information.
+This is a Class method and is imperative to use this after load seeds or when you first enter information inside your model. If you don't have any data inside your model this method doesn't have any sense. On the other hand, if you have data inside your model and you has never executed *sort_tree* then this gem won't work.<br>
+Sort_tree initializes your tree and fills *lft* and *rgt* attributes with corresponding information.<br>
+After execute this command you will able to use all useful methods below
+###Useful Methods
+
+#####display_tree
+This is a Class method and returns graphically and tabulated the entire tree. Example:
+```ruby
+Territory.display_tree
+```
+#####descendants
+Returns an array with all childrens order by lft attribute, example:
+```ruby
+object.descendants
+```
+#####descendants_count
+If you want to know how many descendants has your model, then you can execute:
+```ruby
+ object.descendants_count
+ ```
+ It returns a number of descendants.
 
 ## Development
 

data/hierarchical_db.gemspec

@@ -5,7 +5,7 @@ require 'hierarchical_db/version'
 
 Gem::Specification.new do |spec|
   spec.name          = "hierarchical_db"
-  spec.version       = "0.1.1"
+  spec.version       = "0.1.2"
   spec.authors       = ["Gustavo"]
   spec.email         = ["ginzunza@rebuss.cl"]
 

data/lib/hierarchical_db.rb

@@ -2,13 +2,15 @@ require "hierarchical_db/version"
 require 'active_support/concern'
 
 module HierarchicalDb extend ActiveSupport::Concern
-
+  @sorted = 0
   included do
   end
 
   module ClassMethods
     def saludar
-      puts "Hola"
+      puts "Hola: #{self.sorted}"
+      self.sorted = 1
+      puts "Después Hola: #{self.sorted}"
     end
     
     def sort_tree
@@ -20,6 +22,7 @@ module HierarchicalDb extend ActiveSupport::Concern
         right = 2
         root_nodes.each{|n| right = n.sort_subtree(right) }
       end
+      # self.sorted = 1
     end
 
     def display_tree

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hierarchical_db
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Gustavo
@@ -54,17 +54,6 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
-- hierarchical_db-0.0.0.gem
-- hierarchical_db-0.0.1.gem
-- hierarchical_db-0.0.2.gem
-- hierarchical_db-0.0.3.gem
-- hierarchical_db-0.0.4.gem
-- hierarchical_db-0.0.5.gem
-- hierarchical_db-0.0.6.gem
-- hierarchical_db-0.0.7.gem
-- hierarchical_db-0.0.8.gem
-- hierarchical_db-0.0.9.gem
-- hierarchical_db-0.1.0.gem
 - hierarchical_db.gemspec
 - lib/generators/hierarchical_db/templates/migration_existing.rb
 - lib/generators/hierarchical_db_generator.rb