hierarchable 0.3.1 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 77318268a18001072d590f7ad65524e5f608923cea6c6e757946ad164862518b
-  data.tar.gz: 7740d0be435b42dd701fc626eaa706b58c50688c0bb7639da9caf8b5864d3f3b
+  metadata.gz: c906048aba37ae782246aaceec861dde107dfc1a17aed8be531ed5100f3bb5c2
+  data.tar.gz: 6ab096cae6a3fd9d8da70bd222732f513a63b693d414751fa44e6ebe085210eb
 SHA512:
-  metadata.gz: '078378d734ddc00ccfcecf685fdd142e581560af7444a34985172c354eae1aeedb91ea98a2b08fd47a20728ce8d594c5d965a49409e7957236549b34352a852f'
-  data.tar.gz: 4b9192aec201abb47df5be7589a207c46131fb3544bb2b7cb439dd5c4d6a5df4fe09bc98e32aba14b72b2f3aa789295933226793cb282741a90f1dcd442f38ca
+  metadata.gz: c31a773cafe33d14b83b63d25a7783ed4c75bb1385458de3e893b3c91530b42e2421c4d59c76d9590cddc6b2260aaef391c4f62b9af5f1ad91c6c0979b439827
+  data.tar.gz: 8ebef8dcc55ab798c7abad2f94cd895a6d3778e28c07aadbcc175bfbe1fc40c526d833590783e6c3c94793b6a9579c3ab3ee5c968660ea8e600cb410c6d81da9

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    hierarchable (0.3.1)
+    hierarchable (0.3.2)
       activerecord (> 4.2.0)
       activesupport (> 4.2.0)
 

data/README.md

@@ -1,6 +1,7 @@
 # Hierarchable
 
 [![CircleCI](https://dl.circleci.com/status-badge/img/gh/prschmid/hierarchable/tree/main.svg?style=shield)](https://dl.circleci.com/status-badge/redirect/gh/prschmid/hierarchable/tree/main)
+[![Gem Version](https://badge.fury.io/rb/hierarchable.svg)](https://badge.fury.io/rb/hierarchable)
 
 A simple way to define cross model hierarchical (parent, child, sibling) relationships between ActiveRecord models.
 
@@ -24,14 +25,14 @@ Or install it yourself as:
 
 Once the gem is installed, you will need to make sure that your models have the correct columns.
 
-* hierarchy_root: The root node in the hierarchy hierarchy (polymorphic)
-* hierarchy_parent: The parent of the current object (polymorphic)
-* hierarchy_ancestors_path: The string representation of all ancestors of
+* `hierarchy_root`: The root node in the hierarchy hierarchy (polymorphic)
+* `hierarchy_parent`: The parent of the current object (polymorphic)
+* `hierarchy_ancestors_path`: The string representation of all ancestors of
                             the current object (string).
 
 Assuming that you are using UUIDs for your IDs, this can be done by adding the following to the model(s) for which you wish to have hierarchy information:
 
-```
+```ruby
 t.references :hierarchy_root,
              polymorphic: true,
              null: true,
@@ -59,13 +60,13 @@ We will describe the usage using a simplistic Project and Task analogy where we
 class Project
   include Hierarchable
   hierarchable
-  # If desired, could explicitly setting the parent source to `nil`, but this is
-  # the same "under the hood"
+  # If desired, one could explicitly set the parent source to `nil` for clarity,
+  # but this is the same as omitting it.
   # hierarchable parent_source: nil
 end
 ```
 
-This will set up the `Project` as the root of the hierarchy. When a `Project` model is saved, it will not have any values for the hierarchy_root, hierarchy_parent, or hierarchy_ancestors_path. This is because for the root item as we are not guaranteed to have an ID for the object until after it is saved, and so there is no way for us to set these values in a consistent way across different use cases. This doesn't affect any of the usage of the library, it's just something to keep in mind.
+This will set up the `Project` as the root of the hierarchy. When a `Project` model is saved, it will not have any values for the hierarchy_root, hierarchy_parent, or hierarchy_ancestors_path (i.e. they are `nil`). This is because for the root item we are not guaranteed to have an ID for the object until after it is saved. Thus, there is no consistent way for us to set these values across different use cases. This doesn't affect any of the usage of the library, it's just something to keep in mind.
 
 ```ruby
 project = Project.create!
@@ -148,7 +149,7 @@ project.hierarchy_descendants
 
 The major distinction for what is returned is whether you are querying "up the hierarchy" or "down the hierarchy". As there is only 1 path up the hierchy to get to the root, the return values of `hierarchy_ancestors` is a list and `hierarchy_parent` is a single object. However, traversing down the list is a little more tricky as there are various models and potential paths to get all the way do to the leaves. As such, for all methods at the same level or going down the tree (`hierarchy_siblings`, `hierarchy_children`, and `hierarchy_descendants`), the return value is a hash that has the model class as the key, and either a `ActiveRecord::Relation` or a list as the value. For example, for a Project model that has tasks and milestones as descendants, the return value might be something like
 
-```
+```ruby
 {
   'Task': [all descendant tasks starting at the project]
   'Milestone': [all descendant milestones starting at the project]
@@ -166,7 +167,7 @@ All of the methods (except `hierarchy_parent`) take a `models` paramter that can
 
 There are times when we only need to get the siblings/children/descendants of one type and having a hash returned is a little cumbersome. To deal with this case, you can pass `compact: true` as a parameter and it will return just single result not as a hash. For example:
 
-```
+```ruby
 # Returns as a hash of the form `{Task: [..all descendants..]}`
 project.hierarch_descendants(models: ['Task'])
 
@@ -254,8 +255,6 @@ class SomeObject
 end
 ```
 
-Note: For the use case that this library was designed (e.g. creating breadcrumbs) this was a limitation that was perfectly acceptible. In the future we may plan to letusers create an optional "ancestry" table to make this more efficient. Once this table exists, inserts and updates will be slower as an extra object will need to be managed, but queries descenants will be improved.
-
 ### Configuring the separators
 
 By default the separators to use for the path and records are `/` and `|` respectively. This means that a hierarchy path will look something like

data/lib/hierarchable/hierarchable.rb

@@ -689,9 +689,9 @@ module Hierarchable
       return false if source.blank?
 
       changed_method = "#{source}_id_changed?"
-      public_send(changed_method) if respond_to?(changed_method)
+      return public_send(changed_method) if respond_to?(changed_method)
 
-      send(source).id == hierarchy_parent_id
+      send(source)&.id == hierarchy_parent_id
     end
 
     # Update the hierarchy_ancestors_path if the hierarchy has changed.

data/lib/hierarchable/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Hierarchable
-  VERSION = '0.3.1'
+  VERSION = '0.3.2'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hierarchable
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.3.2
 platform: ruby
 authors:
 - Patrick R. Schmid
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-01-07 00:00:00.000000000 Z
+date: 2023-01-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler