hierarchy 1.0.5 → 1.0.7

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3216ee2327673134cabc227dba69a8c0c65aea3a76de131147882a1b469e06b5
+  data.tar.gz: be02935315adf7c8aa28c5509524cd770fe12c0f46c35a3cf8284e8f8dc4bbb8
+SHA512:
+  metadata.gz: 529e2c8961cde1ecf43f4eb709238e4fed99d2be60b62db09421e39261bc1023684494f9130fdd0af533dee5fd1b7261538836b7ad1fe5c4e27cc937f4170eaa
+  data.tar.gz: b266febc4eff1430db81651581052d326126b4717da80b293424a825c40adcbc49fbe5809f2ae85f7dd0d1506ea55514ed9e893899c82121ab7d65503057dfb6

data/README.md

@@ -0,0 +1,106 @@
+> ⚠️ **DEPRECATED:** `hierarchy` is no longer maintained. Consider `ancestry`,
+> `closure_tree`, or `acts_as_tree` for tree-structured ActiveRecord data. The
+> final release is v1.0.7.
+
+Hierarchy
+=========
+
+**Use PostgreSQL `LTREE` columns in ActiveRecord**
+
+|             |                                 |
+|:------------|:--------------------------------|
+| **Author**  | Tim Morgan                      |
+| **Version** | 1.0.6 (Nov 27, 2010)            |
+| **License** | Released under the MIT license. |
+
+About
+-----
+
+The `LTREE` column type is a PostgreSQL-specific type (available from the ltree
+extension) for representing hierarchies. It is more efficient than the typical
+way of accomplishing hierarchical structures in SQL, the `parent_id` column (or
+similar).
+
+This gem lets you use an `LTREE`-utilizing hierarchy in ActiveRecord. Including
+this gem in your project gets you a module you can include in your models,
+providing an abundance of methods to help you navigate and manipulate the
+hierarchy.
+
+Installation
+------------
+
+**Important Note:** This gem requires Ruby 1.9+ and Rails 3.0+.
+
+Firstly, add the gem to your Rails project's `Gemfile`:
+
+```` ruby
+gem 'hierarchy'
+````
+
+Then, run the generator to install the migration:
+
+```` sh
+rails generate hierarchy
+````
+
+Note that *this migration must precede any tables using `LTREEs`*, so reorder
+the migration if you have to.
+
+Usage
+-----
+
+Because this gem was hastily extracted from a personal project, it's a little
+constraining in how it can be used. (Sorry.) Currently the gem requires that
+your table schema have a column named @path@ of type `LTREE`, defined as in the
+example below:
+
+```` sql
+path LTREE NOT NULL DEFAULT ''
+````
+
+Once you've got that column in your model, feel free to include the `Hierarchy`
+module:
+
+```` ruby
+class Person < ActiveRecord::Base
+  include Hierarchy
+end
+````
+
+You can now define hierarchy by setting a model's `parent`, like so:
+
+```` ruby
+person.parent = mother #=> Sets the `path` column appropriately
+````
+
+You also have access to a wealth of ways to traverse the hierarchy:
+
+```` ruby
+person.children.where(gender: :male)
+person.top_level?
+Person.treeified #=> returns a traversible tree of all people
+````
+
+For more information on what you can do, see the {Hierarchy} module
+documentation.
+
+Development
+-----------
+
+If you wish to develop for Hierarchy, the first thing you will want to do is get
+specs up and running. This requires a call to `bundle install` (obviously) and
+setting up your test database.
+
+As you can see in the `spec/spec_helper.rb` file, the specs require that a
+PostgreSQL database named `hierarchy_test` exist and be owned by a
+`hierarchy_tester` user. Unfortunately I haven't written a way to configure this
+(though patches are welcome). So, the following commands should suffice to get
+you started:
+
+```` sh
+createuser hierarchy_tester # answer "no" to all prompts
+createdb -O hierarchy_tester hierarchy_test
+````
+
+With those steps done you should be able to run `rake spec` and see the Glorious
+Green.

data/hierarchy.gemspec

@@ -2,75 +2,70 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
+# stub: hierarchy 1.0.7 ruby lib
 
 Gem::Specification.new do |s|
-  s.name = %q{hierarchy}
-  s.version = "1.0.5"
+  s.name = "hierarchy"
+  s.version = "1.0.7"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Tim Morgan"]
-  s.date = %q{2010-11-27}
-  s.description = %q{Adds ActiveRecord support for hierarchial data structures using PostgreSQL's LTREE column type.}
-  s.email = %q{git@timothymorgan.info}
+  s.date = "2013-12-08"
+  s.description = "Adds ActiveRecord support for hierarchical data structures using PostgreSQL's LTREE column type."
+  s.email = "git@timothymorgan.info"
   s.extra_rdoc_files = [
     "LICENSE",
-    "README.textile"
+    "README.md"
   ]
   s.files = [
-    ".document",
-    ".rspec",
-    "Gemfile",
-    "Gemfile.lock",
     "LICENSE",
-    "README.textile",
-    "Rakefile",
-    "VERSION",
+    "README.md",
     "hierarchy.gemspec",
     "lib/hierarchy.rb",
     "lib/hierarchy/index_path.rb",
     "lib/hierarchy/node.rb",
     "lib/hierarchy_generator.rb",
-    "spec/hierarchy_spec.rb",
-    "spec/index_path_spec.rb",
-    "spec/spec_helper.rb",
     "templates/add_ltree_type.rb"
   ]
-  s.homepage = %q{http://github.com/riscfuture/hierarchy}
+  s.homepage = "http://github.com/riscfuture/hierarchy"
   s.require_paths = ["lib"]
   s.required_ruby_version = Gem::Requirement.new(">= 1.9")
-  s.rubygems_version = %q{1.3.7}
-  s.summary = %q{Use PostgreSQL LTREE type with ActiveRecord}
-  s.test_files = [
-    "spec/hierarchy_spec.rb",
-    "spec/index_path_spec.rb",
-    "spec/spec_helper.rb"
-  ]
+  s.rubygems_version = "2.1.11"
+  s.summary = "[DEPRECATED] Use PostgreSQL LTREE type with ActiveRecord"
+  s.post_install_message = <<~MSG
+
+    ⚠️  DEPRECATED: hierarchy is no longer maintained.
+
+    No longer maintained. Consider `ancestry`, `closure_tree`, or `acts_as_tree` for tree-structured ActiveRecord data.
+
+    This is the final release. No further updates are planned.
+
+  MSG
 
   if s.respond_to? :specification_version then
-    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
-    s.specification_version = 3
+    s.specification_version = 4
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
       s.add_runtime_dependency(%q<rails>, [">= 3.0.2"])
+      s.add_runtime_dependency(%q<pg>, [">= 0"])
       s.add_development_dependency(%q<jeweler>, [">= 0"])
       s.add_development_dependency(%q<yard>, [">= 0"])
       s.add_development_dependency(%q<RedCloth>, [">= 0"])
-      s.add_development_dependency(%q<pg>, [">= 0"])
       s.add_development_dependency(%q<rspec>, [">= 0"])
     else
       s.add_dependency(%q<rails>, [">= 3.0.2"])
+      s.add_dependency(%q<pg>, [">= 0"])
       s.add_dependency(%q<jeweler>, [">= 0"])
       s.add_dependency(%q<yard>, [">= 0"])
       s.add_dependency(%q<RedCloth>, [">= 0"])
-      s.add_dependency(%q<pg>, [">= 0"])
       s.add_dependency(%q<rspec>, [">= 0"])
     end
   else
     s.add_dependency(%q<rails>, [">= 3.0.2"])
+    s.add_dependency(%q<pg>, [">= 0"])
     s.add_dependency(%q<jeweler>, [">= 0"])
     s.add_dependency(%q<yard>, [">= 0"])
     s.add_dependency(%q<RedCloth>, [">= 0"])
-    s.add_dependency(%q<pg>, [">= 0"])
     s.add_dependency(%q<rspec>, [">= 0"])
   end
 end

data/lib/hierarchy/index_path.rb

@@ -1,7 +1,7 @@
 module Hierarchy
-  
+
   # An array of integers representing an ordered list of IDs. Duck-types an
-  # @Array@ in many ways.
+  # `Array` in many ways.
 
   class IndexPath
     include Enumerable
@@ -25,9 +25,9 @@ module Hierarchy
       @indexes = indexes
     end
 
-    # Creates an index path from a PostgreSQL @LTREE@ column.
+    # Creates an index path from a PostgreSQL `LTREE` column.
     #
-    # @param [String] string An @LTREE@ column value, such as "1.10.22".
+    # @param [String] string An `LTREE` column value, such as "1.10.22".
     # @return [IndexPath] A corresponding index path.
 
     def self.from_ltree(string)

data/lib/hierarchy/node.rb

@@ -1,5 +1,5 @@
 module Hierarchy
-  
+
   # A node in a tree structure. A node can have zero or more {#children}, and
   # has a reverse link back to its parent.
 
@@ -7,7 +7,7 @@ module Hierarchy
     # @return [Array<Node>] This node's children.
     attr_reader :children
 
-    # @return [Node, nil] This node's parent, or @nil@ if it is a root node.
+    # @return [Node, nil] This node's parent, or `nil` if it is a root node.
     attr_reader :parent
 
     # @return The object this node contains.

data/lib/hierarchy.rb

@@ -1,38 +1,20 @@
-# @private
-module Arel
-  # @private
-  module Attributes
-    # @private
-    def self.for_with_psql(column)
-      case column.sql_type
-        when 'ltree' then String
-        else for_without_psql(column)
-      end
-    end
-    unless singleton_class.method_defined?(:for_without_psql)
-      singleton_class.send :alias_method, :for_without_psql, :for
-      singleton_class.send :alias_method, :for, :for_with_psql
-    end
-  end
-end
-
 require 'hierarchy_generator'
 require 'hierarchy/index_path'
 require 'hierarchy/node'
 
-# Adds a tree structure to a model. This is very similar to @acts_as_nested_set@
-# but uses the PostgreSQL-specific @ltree@ feature for schema storage.
+# Adds a tree structure to a model. This is very similar to `acts_as_nested_set`
+# but uses the PostgreSQL-specific `ltree` feature for schema storage.
 #
-# Your model must have a @path@ field of type @ltree@. This field will be a
+# Your model must have a `path` field of type `ltree`. This field will be a
 # period-delimited list of IDs of records above this one in the hierarchy. In
 # addition, you should also consider the following indexes:
 #
-# <pre><code>
+# ```` sql
 # CREATE INDEX index1 ON table USING gist(path)
 # CREATE INDEX index2 ON table USING btree(path)
-# </code></pre>
+# ````
 #
-# replacing @table@ with your table and @index1@/@index2@ with appropriate names
+# replacing `table` with your table and `index1`/`index2` with appropriate names
 # for these indexes.
 #
 # @example
@@ -42,21 +24,19 @@ require 'hierarchy/node'
 
 module Hierarchy
   extend ActiveSupport::Concern
-  
+
   # @private
-  included do |base|
-    base.extend ActiveSupport::Memoizable
-    base.memoize :index_path, :ancestors
-    
-    base.scope :parent_of, ->(obj) { obj.top_level? ? base.where('false') : base.where(id: obj.index_path.last) }
-    base.scope :children_of, ->(obj) { base.where(path: obj.my_path) }
-    base.scope :ancestors_of, ->(obj) { obj.top_level? ? base.where('false') : base.where(id: obj.index_path.to_a) }
-    base.scope :descendants_of, ->(obj) { base.where([ "path <@ ?", obj.my_path ]) }
-    base.scope :siblings_of, ->(obj) { base.where(path: obj.path) }
-    base.scope :priority_order, base.order("NLEVEL(path) ASC")
-    base.scope :top_level, base.where([ "path IS NULL or path = ?", '' ])
-    
-    base.before_save { |obj| obj.path ||= '' }
+  included do
+    scope :parent_of, ->(obj) { obj.top_level? ? where('false') : where(id: obj.index_path.last) }
+    scope :children_of, ->(obj) { where(path: obj.my_path) }
+    scope :ancestors_of, ->(obj) { obj.top_level? ? where('false') : where(id: obj.index_path.to_a) }
+    scope :descendants_of, ->(obj) { where("path <@ ?", obj.my_path) }
+    scope :siblings_of, ->(obj) { where(path: obj.path) }
+    scope :priority_order, -> { order("NLEVEL(path) ASC") }
+    scope :top_level, -> { where("path IS NULL or path = ?", '') }
+
+    before_save { |obj| obj.path ||= '' }
+    before_save :update_children_with_new_parent
   end
 
   module ClassMethods
@@ -85,81 +65,94 @@ module Hierarchy
     end
   end
 
-  # Methods added to instances of the class this module is included into.
-
-  module InstanceMethods
-    # Sets the object above this one in the hierarchy.
-    #
-    # @param [ActiveRecord::Base] parent The parent object.
-    # @raise [ArgumentError] If @parent@ is an unsaved record with no primary key.
+  # Sets the object above this one in the hierarchy.
+  #
+  # @param [ActiveRecord::Base] parent The parent object.
+  # @raise [ArgumentError] If `parent` is an unsaved record with no primary key.
 
-    def parent=(parent)
-      raise ArgumentError, "Parent cannot be a new record" if parent.try(:new_record?)
-      self.path = parent.try(:my_path)
-    end
+  def parent=(parent)
+    raise ArgumentError, "Parent cannot be a new record" if parent.try(:new_record?)
+    self.path = parent.try(:my_path)
+  end
 
-    # Returns an array of ancestors above this object. Note that a) this array
-    # is ordered with the most senior ancestor at the beginning of the list, and
-    # b) this is an _array_, not a _relation_. For that reason, you can pass
-    # any additional scope options to the method.
-    #
-    # @param [Hash] options Additional finder options.
-    # @return [Array] The objects above this one in the hierarchy.
+  # Returns an array of ancestors above this object. Note that a) this array
+  # is ordered with the most senior ancestor at the beginning of the list, and
+  # b) this is an _array_, not a _relation_. For that reason, you can pass
+  # any additional scope options to the method.
+  #
+  # @param [Hash] options Additional finder options.
+  # @return [Array] The objects above this one in the hierarchy.
 
-    def ancestors(options={})
+  def ancestors(options={})
+    @ancestors ||= begin
       return [] if top_level?
       objects = self.class.ancestors_of(self).scoped(options).group_by(&:id)
       index_path.map { |id| objects[id].first }
     end
+  end
 
-    # @return [ActiveRecord::Relation] The objects below this one in the
-    #   hierarchy.
+  # @return [ActiveRecord::Relation] The objects below this one in the
+  #   hierarchy.
 
-    def descendants
-      self.class.descendants_of self
-    end
+  def descendants
+    self.class.descendants_of self
+  end
 
-    # @return [ActiveRecord::Base] The object directly above this one in the
-    #   hierarchy.
+  # @return [ActiveRecord::Base] The object directly above this one in the
+  #   hierarchy.
 
-    def parent
-      top_level? ? nil : self.class.parent_of(self).first
-    end
+  def parent
+    top_level? ? nil : self.class.parent_of(self).first
+  end
 
-    # @return [ActiveRecord::Relation] The objects directly below this one
-    #   in the hierarchy.
+  # @return [ActiveRecord::Relation] The objects directly below this one
+  #   in the hierarchy.
 
-    def children
-      self.class.children_of self
-    end
+  def children
+    self.class.children_of self
+  end
 
-    # @return [Array] The objects at the same hierarchical level of this one.
+  # @return [Array] The objects at the same hierarchical level of this one.
 
-    def siblings
-      self.class.siblings_of(self) - [ self ]
-    end
+  def siblings
+    self.class.siblings_of(self) - [ self ]
+  end
 
-    # @return [true, false] Whether or not this object has no parents.
+  # @return [true, false] Whether or not this object has no parents.
 
-    def top_level?
-      path.blank?
-    end
+  def top_level?
+    path.blank?
+  end
 
-    # @return [true, false] Whether or not this object has no children. Makes a
-    #   database call.
+  # @return root parent or nil(if current obj is top level)
+  def root
+    self.top_level? ? nil : self.class.find(self.path.split('.').first)
+  end
 
-    def bottom_level?
-      children.empty?
-    end
+  # @return [true, false] Whether or not this object has no children. Makes a
+  #   database call.
 
-    # @private
-    def my_path
-      path.blank? ? id.to_s : "#{path}.#{id}"
-    end
+  def bottom_level?
+    children.empty?
+  end
+
+  # @private
+  def my_path
+    path.blank? ? id.to_s : "#{path}.#{id}"
+  end
+
+  # @private
+  def index_path
+    @index_path ||= IndexPath.from_ltree path.to_s
+  end
+
+  private
 
-    # @private
-    def index_path
-      IndexPath.from_ltree path.to_s
+  # if our parent has changed, update our children's paths
+  def update_children_with_new_parent
+    if path_changed? and not new_record? then
+      old_path = (path_was.blank? ? id.to_s : "#{path_was}.#{id}")
+      self.class.where("path <@ ?", old_path).update_all([ "path = TEXT2LTREE(REPLACE(LTREE2TEXT(path), ?, ?))", old_path, my_path ])
     end
   end
 end

data/lib/hierarchy_generator.rb

@@ -5,18 +5,18 @@ require 'rails/generators/migration'
 # @private
 class HierarchyGenerator < Rails::Generators::Base
   include Rails::Generators::Migration
-  
+
   source_root "#{File.dirname __FILE__}/../templates"
-  
+
   def self.next_migration_number(dirname)
     if ActiveRecord::Base.timestamped_migrations then
-      Time.now.utc.strftime "%Y%m%d%H%M%S"
+      Time.now.utc.strftime '%Y%m%d%H%M%S'
     else
-      "%.3d" % (current_migration_number(dirname) + 1)
+      '%.3d' % (current_migration_number(dirname) + 1)
     end
   end
-  
+
   def copy_files
-    migration_template "add_ltree_type.rb", "db/migrate/add_ltree_type.rb"
+    migration_template 'add_ltree_type.rb', 'db/migrate/add_ltree_type.rb'
   end
 end

data/templates/add_ltree_type.rb

@@ -1,15 +1,9 @@
 class AddLtreeType < ActiveRecord::Migration
-  def self.up
-    cmd = "psql -f `pg_config --sharedir`/contrib/ltree.sql #{ActiveRecord::Base.connection.instance_variable_get(:@config)[:database]}"
-    puts cmd
-    result = system(cmd)
-    raise "Bad exit" unless result
+  def up
+    execute "CREATE EXTENSION ltree"
   end
 
-  def self.down
-    cmd = "psql -f `pg_config --sharedir`/contrib/uninstall_ltree.sql #{ActiveRecord::Base.connection.instance_variable_get(:@config)[:database]}"
-    puts cmd
-    result = system(cmd)
-    raise "Bad exit" unless result
+  def down
+    execute "DROP EXTENSION ltree"
   end
 end

metadata

@@ -1,163 +1,142 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: hierarchy
-version: !ruby/object:Gem::Version 
-  prerelease: false
-  segments: 
-  - 1
-  - 0
-  - 5
-  version: 1.0.5
+version: !ruby/object:Gem::Version
+  version: 1.0.7
 platform: ruby
-authors: 
+authors:
 - Tim Morgan
-autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2010-11-27 00:00:00 -08:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2013-12-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: rails
-  requirement: &id001 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
     - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 3
-        - 0
-        - 2
+      - !ruby/object:Gem::Version
         version: 3.0.2
   type: :runtime
   prerelease: false
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.2
+- !ruby/object:Gem::Dependency
+  name: pg
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
   name: jeweler
-  requirement: &id002 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
     - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        version: "0"
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
   prerelease: false
-  version_requirements: *id002
-- !ruby/object:Gem::Dependency 
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
   name: yard
-  requirement: &id003 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
     - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        version: "0"
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
   prerelease: false
-  version_requirements: *id003
-- !ruby/object:Gem::Dependency 
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
   name: RedCloth
-  requirement: &id004 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
     - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        version: "0"
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
   prerelease: false
-  version_requirements: *id004
-- !ruby/object:Gem::Dependency 
-  name: pg
-  requirement: &id005 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
     - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        version: "0"
-  type: :development
-  prerelease: false
-  version_requirements: *id005
-- !ruby/object:Gem::Dependency 
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &id006 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
     - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        version: "0"
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
   prerelease: false
-  version_requirements: *id006
-description: Adds ActiveRecord support for hierarchial data structures using PostgreSQL's LTREE column type.
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Adds ActiveRecord support for hierarchical data structures using PostgreSQL's
+  LTREE column type.
 email: git@timothymorgan.info
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
 - LICENSE
-- README.textile
-files: 
-- .document
-- .rspec
-- Gemfile
-- Gemfile.lock
+- README.md
+files:
 - LICENSE
-- README.textile
-- Rakefile
-- VERSION
+- README.md
 - hierarchy.gemspec
 - lib/hierarchy.rb
 - lib/hierarchy/index_path.rb
 - lib/hierarchy/node.rb
 - lib/hierarchy_generator.rb
-- spec/hierarchy_spec.rb
-- spec/index_path_spec.rb
-- spec/spec_helper.rb
 - templates/add_ltree_type.rb
-has_rdoc: true
 homepage: http://github.com/riscfuture/hierarchy
 licenses: []
+metadata: {}
+post_install_message: |2+
 
-post_install_message: 
-rdoc_options: []
+  ⚠️  DEPRECATED: hierarchy is no longer maintained.
+
+  No longer maintained. Consider `ancestry`, `closure_tree`, or `acts_as_tree` for tree-structured ActiveRecord data.
+
+  This is the final release. No further updates are planned.
 
-require_paths: 
+rdoc_options: []
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
   - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 1
-      - 9
-      version: "1.9"
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
+    - !ruby/object:Gem::Version
+      version: '1.9'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
   - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 0
-      version: "0"
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
-rubyforge_project: 
-rubygems_version: 1.3.7
-signing_key: 
-specification_version: 3
-summary: Use PostgreSQL LTREE type with ActiveRecord
-test_files: 
-- spec/hierarchy_spec.rb
-- spec/index_path_spec.rb
-- spec/spec_helper.rb
+rubygems_version: 4.0.11
+specification_version: 4
+summary: "[DEPRECATED] Use PostgreSQL LTREE type with ActiveRecord"
+test_files: []
+...

data/.document

@@ -1,5 +0,0 @@
-README.rdoc
-lib/**/*.rb
-bin/*
-features/**/*.feature
-LICENSE

data/.rspec

@@ -1 +0,0 @@
--cfs

data/Gemfile

@@ -1,11 +0,0 @@
-source :rubygems
-
-gem 'rails', '>= 3.0.2'
-
-group :development do
-  gem 'jeweler'
-  gem 'yard'
-  gem 'RedCloth', require: 'redcloth'
-  gem 'pg'
-  gem 'rspec'
-end

data/Gemfile.lock

@@ -1,93 +0,0 @@
-GEM
-  remote: http://rubygems.org/
-  specs:
-    RedCloth (4.2.3)
-    abstract (1.0.0)
-    actionmailer (3.0.3)
-      actionpack (= 3.0.3)
-      mail (~> 2.2.9)
-    actionpack (3.0.3)
-      activemodel (= 3.0.3)
-      activesupport (= 3.0.3)
-      builder (~> 2.1.2)
-      erubis (~> 2.6.6)
-      i18n (~> 0.4)
-      rack (~> 1.2.1)
-      rack-mount (~> 0.6.13)
-      rack-test (~> 0.5.6)
-      tzinfo (~> 0.3.23)
-    activemodel (3.0.3)
-      activesupport (= 3.0.3)
-      builder (~> 2.1.2)
-      i18n (~> 0.4)
-    activerecord (3.0.3)
-      activemodel (= 3.0.3)
-      activesupport (= 3.0.3)
-      arel (~> 2.0.2)
-      tzinfo (~> 0.3.23)
-    activeresource (3.0.3)
-      activemodel (= 3.0.3)
-      activesupport (= 3.0.3)
-    activesupport (3.0.3)
-    arel (2.0.4)
-    builder (2.1.2)
-    diff-lcs (1.1.2)
-    erubis (2.6.6)
-      abstract (>= 1.0.0)
-    git (1.2.5)
-    i18n (0.4.2)
-    jeweler (1.5.1)
-      bundler (~> 1.0.0)
-      git (>= 1.2.5)
-      rake
-    mail (2.2.10)
-      activesupport (>= 2.3.6)
-      i18n (~> 0.4.1)
-      mime-types (~> 1.16)
-      treetop (~> 1.4.8)
-    mime-types (1.16)
-    pg (0.9.0)
-    polyglot (0.3.1)
-    rack (1.2.1)
-    rack-mount (0.6.13)
-      rack (>= 1.0.0)
-    rack-test (0.5.6)
-      rack (>= 1.0)
-    rails (3.0.3)
-      actionmailer (= 3.0.3)
-      actionpack (= 3.0.3)
-      activerecord (= 3.0.3)
-      activeresource (= 3.0.3)
-      activesupport (= 3.0.3)
-      bundler (~> 1.0)
-      railties (= 3.0.3)
-    railties (3.0.3)
-      actionpack (= 3.0.3)
-      activesupport (= 3.0.3)
-      rake (>= 0.8.7)
-      thor (~> 0.14.4)
-    rake (0.8.7)
-    rspec (2.1.0)
-      rspec-core (~> 2.1.0)
-      rspec-expectations (~> 2.1.0)
-      rspec-mocks (~> 2.1.0)
-    rspec-core (2.1.0)
-    rspec-expectations (2.1.0)
-      diff-lcs (~> 1.1.2)
-    rspec-mocks (2.1.0)
-    thor (0.14.6)
-    treetop (1.4.9)
-      polyglot (>= 0.3.1)
-    tzinfo (0.3.23)
-    yard (0.6.3)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  RedCloth
-  jeweler
-  pg
-  rails (>= 3.0.2)
-  rspec
-  yard

data/README.textile

@@ -1,96 +0,0 @@
-h1. Hierarchy -- Use PostgreSQL @LTREE@ columns in ActiveRecord
-
-| *Author* | Tim Morgan |
-| *Version* | 1.0.5 (Nov 27, 2010) |
-| *License* | Released under the MIT license. |
-
-h2. About
-
-The @LTREE@ column type is a PostgreSQL-specific type (installation script is
-available in the @contrib@ directory in your PostgreSQL installation) for
-representing hierarchies. It is more efficient than the typical way of
-accomplishing hierarchal structures in SQL, the @parent_id@ column (or similar).
-
-This gem lets you use an @LTREE@-utilizing hierarchy in ActiveRecord. Including
-this gem in your project gets you a) monkey-patches* to Arel to support @LTREE@
-columns, and b) a module you can include in your models, providing an abundance
-of methods to help you navigate and manipulate the hierarchy.
-
-*Though I don't know for sure, I suspect when Arel 2.0 is supported in Rails, I
-will be able to remove this monkey-patching ugliness.
-
-h2. Installation
-
-*Important Note:* This gem requires Ruby 1.9 and Rails 3.0.
-
-Firstly, add the gem to your Rails project's @Gemfile@:
-
-<pre><code>
-gem 'hierarchy'
-</code></pre>
-
-Then, run the generator to install the migration:
-
-<pre><code>
-rails generate hierarchy
-</code></pre>
-
-Note that *this migration must precede any tables using @LTREEs@*, so reorder
-the migration if you have to.
-
-h2. Usage
-
-Because this gem was hastily extracted from a personal project, it's a little
-constraining in how it can be used. (Sorry.) Currently the gem requires that
-your table schema have a column named @path@ of type @LTREE@, defined as in the
-example below:
-
-<pre><code>
-path LTREE NOT NULL DEFAULT ''
-</code></pre>
-
-Once you've got that column in your model, feel free to include the @Hierarchy@
-module:
-
-<pre><code>
-class Person < ActiveRecord::Base
-  include Hierarchy
-end
-</code></pre>
-
-You can now define hierarchy by setting a model's @parent@, like so:
-
-<pre><code>
-person.parent = mother #=> Sets the `path` column appropriately
-</code></pre>
-
-You also have access to a wealth of ways to traverse the hierarchy:
-
-<pre><code>
-person.children.where(gender: :male)
-person.top_level?
-Person.treeified #=> returns a traversable tree of all people
-</code></pre>
-
-For more information on what you can do, see the {Hierarchy} module
-documentation.
-
-h2. Development
-
-If you wish to develop for Hierarchy, the first thing you will want to do is get
-specs up and running. This requires a call to @bundle install@ (obviously) and
-setting up your test database.
-
-As you can see in the @spec/spec_helper.rb@ file, the specs require that a
-PostgreSQL database named @hierarchy_test@ exist and be owned by a
-@hierarchy_tester@ user. Unfortunately I haven't written a way to configure this
-(though patches are welcome). So, the following commands should suffice to get
-you started:
-
-<pre><code>
-createuser hierarchy_tester # answer "no" to all prompts
-createdb -O hierarchy_tester hierarchy_test
-</code></pre>
-
-With those steps done you should be able to run @rake spec@ and see the Glorious
-Green.

data/Rakefile

@@ -1,39 +0,0 @@
-require 'rubygems'
-require 'bundler'
-begin
-  Bundler.setup(:default, :development)
-rescue Bundler::BundlerError => e
-  $stderr.puts e.message
-  $stderr.puts "Run `bundle install` to install missing gems"
-  exit e.status_code
-end
-require 'rake'
-
-require 'jeweler'
-Jeweler::Tasks.new do |gem|
-  gem.name = "hierarchy"
-  gem.summary = %Q{Use PostgreSQL LTREE type with ActiveRecord}
-  gem.description = %Q{Adds ActiveRecord support for hierarchial data structures using PostgreSQL's LTREE column type.}
-  gem.email = "git@timothymorgan.info"
-  gem.homepage = "http://github.com/riscfuture/hierarchy"
-  gem.authors = [ "Tim Morgan" ]
-  gem.required_ruby_version = '>= 1.9'
-end
-Jeweler::RubygemsDotOrgTasks.new
-
-require 'rspec/core/rake_task'
-RSpec::Core::RakeTask.new
-
-require 'yard'
-YARD::Rake::YardocTask.new('doc') do |doc|
-  doc.options << "-m" << "textile"
-  doc.options << "--protected"
-  doc.options << "--no-private"
-  doc.options << "-r" << "README.textile"
-  doc.options << "-o" << "doc"
-  doc.options << "--title" << "Hierarchy Documentation".inspect
-  
-  doc.files = [ 'lib/**/*', 'README.textile' ]
-end
-
-task(default: :spec)

data/VERSION

@@ -1 +0,0 @@
-1.0.5

data/spec/hierarchy_spec.rb

@@ -1,116 +0,0 @@
-require 'spec_helper'
-
-describe Hierarchy do
-  before :each do
-    @objects = Hash.new
-    2.times { |i| @objects[:"grandparent_#{i + 1}"] = Model.create! }
-    2.times do |gp_num|
-      2.times { |i| @objects[:"parent_#{gp_num + 1}_#{i + 1}"] = Model.create!(parent: @objects[:"grandparent_#{gp_num + 1}"]) }
-    end
-    2.times do |gp_num|
-      2.times do |p_num|
-        2.times { |i| @objects[:"child_#{gp_num + 1}_#{p_num + 1}_#{i + 1}"] = Model.create!(parent: @objects[:"parent_#{gp_num + 1}_#{p_num + 1}"]) }
-      end
-    end
-  end
-
-  describe ".parent_of" do
-    it "should return the parent object" do
-      Model.parent_of(@objects[:parent_1_1]).should == [ @objects[:grandparent_1] ]
-      Model.parent_of(@objects[:parent_2_2]).should == [ @objects[:grandparent_2] ]
-    end
-
-    it "should return an empty relation for top-level objects" do
-      Model.parent_of(@objects[:grandparent_1]).should be_empty
-      Model.parent_of(@objects[:grandparent_2]).should be_empty
-    end
-  end
-
-  describe ".children_of" do
-    it "should return the direct children of an object" do
-      Model.children_of(@objects[:grandparent_1]).should == [ :parent_1_1, :parent_1_2 ].map { |name| @objects[name] }
-      Model.children_of(@objects[:parent_2_1]).should == [ :child_2_1_1, :child_2_1_2 ].map { |name| @objects[name] }
-    end
-
-    it "should return an empty relation for leaf objects" do
-      Model.children_of(@objects[:child_1_1_1]).should be_empty
-      Model.children_of(@objects[:child_2_2_2]).should be_empty
-    end
-  end
-
-  describe ".ancestors_of" do
-    it "should return all ancestors of an object" do
-      Model.ancestors_of(@objects[:child_1_2_1]).should == [ :grandparent_1, :parent_1_2 ].map { |name| @objects[name] }
-      Model.ancestors_of(@objects[:parent_2_1]).should == [ @objects[:grandparent_2] ]
-    end
-
-    it "should return an empty relation for top-level objects" do
-      Model.ancestors_of(@objects[:grandparent_1]).should be_empty
-    end
-  end
-
-  describe ".descendants_of" do
-    it "should return all descendants of an object" do
-      Model.descendants_of(@objects[:grandparent_2]).should == [ :parent_2_1, :parent_2_2, :child_2_1_1, :child_2_1_2, :child_2_2_1, :child_2_2_2 ].map { |name| @objects[name] }
-      Model.descendants_of(@objects[:parent_2_1]).should == [ :child_2_1_1, :child_2_1_2 ].map { |name| @objects[name] }
-    end
-
-    it "should return an empty relation for leaf objects" do
-      Model.children_of(@objects[:child_1_1_1]).should be_empty
-      Model.children_of(@objects[:child_2_2_2]).should be_empty
-    end
-  end
-
-  describe ".siblings_of" do
-    it "should return all sibling objects" do
-      Model.siblings_of(@objects[:parent_1_1]).should == [ :parent_1_1, :parent_1_2 ].map { |name| @objects[name] }
-    end
-  end
-
-  describe "#parent=" do
-    it "should raise an error if parent is unsaved" do
-      expect { Model.create!.parent = Model.new }.to raise_error(ArgumentError)
-    end
-
-    it "should set the path ltree appropriately" do
-      ggp = Model.create!
-      gp = Model.create!(path: ggp.id.to_s)
-      pa = Model.create!(path: "#{ggp.id}.#{gp.id}")
-      path = [ ggp.id, gp.id, pa.id ].join('.')
-
-      object = Model.new
-      parent = Model.create!(path: path)
-      object.parent = parent
-      object.save!
-      object.path.should eql("#{path}.#{parent.id}")
-    end
-  end
-
-  describe "#top_level?" do
-    it "should return true for a top-level object" do
-      Model.create!.should be_top_level
-    end
-
-    it "should return false for an object with a parent" do
-      parent = Model.create!
-      Model.create!(parent: parent).should_not be_top_level
-    end
-  end
-
-  describe "#bottom_level?" do
-    it "should return true for an object with no children" do
-      Model.create!.should be_bottom_level
-    end
-    it "should return false for an object with children" do
-      parent = Model.create!
-      Model.create!(parent: parent)
-      parent.should_not be_bottom_level
-    end
-  end
-  
-  describe "#ancestors" do
-    it "should return an empty array for a top-level object" do
-      Model.create!.ancestors.should eql([])
-    end
-  end
-end

data/spec/index_path_spec.rb

@@ -1,31 +0,0 @@
-require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
-
-describe Hierarchy::IndexPath do
-  describe ".<=>" do
-    def compare(ip1, ip2)
-      Hierarchy::IndexPath.new(*ip1) <=> Hierarchy::IndexPath.new(*ip2)
-    end
-
-    it "should return -1 if this index path comes before the given index path" do
-      # all except last digit equal
-      compare([ 1,2,3 ], [ 1,2,4 ]).should eql(-1)
-      # unequal in higher precedence
-      compare([ 1,2,3 ], [ 1,3,2 ]).should eql(-1)
-      # other is longer
-      compare([ 1,2,3 ], [ 1,2,3,4 ]).should eql(-1)
-    end
-
-    it "should return 1 if this index path comes after the given index path" do
-      # all except last digit equal
-      compare([ 1,2,4 ], [ 1,2,3 ]).should eql(1)
-      # unequal in higher precedence
-      compare([ 1,3,2 ], [ 1,2,3 ]).should eql(1)
-      # this is longer
-      compare([ 1,2,3,4 ], [ 1,2,3, ]).should eql(1)
-    end
-
-    it "should return 0 if the index paths are equal" do
-      compare([ 1,2,3 ], [ 1,2,3 ]).should eql(0)
-    end
-  end
-end

data/spec/spec_helper.rb

@@ -1,26 +0,0 @@
-Bundler.require :default, :test
-require 'active_support'
-require 'active_record'
-
-$LOAD_PATH.unshift(File.dirname(__FILE__))
-$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
-
-require 'hierarchy'
-
-ActiveRecord::Base.establish_connection(
-  adapter: 'postgresql',
-  database: 'hierarchy_test',
-  username: 'hierarchy_tester'
-)
-system "psql -f `pg_config --sharedir`/contrib/ltree.sql hierarchy_test &>/dev/null"
-
-class Model < ActiveRecord::Base
-  include Hierarchy
-end
-
-RSpec.configure do |config|
-  config.before(:each) do
-    Model.connection.execute "DROP TABLE IF EXISTS models"
-    Model.connection.execute "CREATE TABLE models (id SERIAL PRIMARY KEY, path LTREE NOT NULL DEFAULT '')"
-  end
-end