nested_array 2.2.0 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d8f6db479729f7d6924b27d7b18d12ef9f20eab329ceb794624b98203316569b
-  data.tar.gz: a0114a0c9169e8247a69081dc5f037ef14aead1bdc64410ea82ccee8eea323f2
+  metadata.gz: 0f9301a9227bde8d348c788d152e3f673629fe658bf5081f7dbf46510b26159b
+  data.tar.gz: 6bdd98b0b83e52224afa7db078007805ffc19762ae9cb1f042dfe40f0add9248
 SHA512:
-  metadata.gz: 84f1752a4dc9d6158c735ed68622cbc136838bee43cc780a5e415e9f2f0725455f7dcba4c5c60ec2d02de74fe3ef2d5490f4b16bf761ddfdb21857b960ff366e
-  data.tar.gz: 751204ab59242230156ebf4891897a98bafc67cd328173bf44f2cfcabe86d8b1839e5b8c6dc0ca204b16d5135ed929de7d2345dc65cc88dab690e6792392f860
+  metadata.gz: 106227d9e4b3f3c79fc2cac1ca1c340e18019ea674291d72d4712f5a780209d86913cc9c2f069f9be830bda1235a1f9572cf3a8b73f4dcff0d5c725853a29136
+  data.tar.gz: 0c2bb221a8a49d0ac5d4deaeb0f6879ccb472a0be79866603a7c56843503a6aedec3a8910c6f396548cd6a986ed07304842076f4d4df2178be7931e5b5f72413

data/.gitignore

@@ -7,3 +7,4 @@
 /spec/reports/
 /tmp/
 *.gem
+.byebug_history

data/Gemfile

@@ -2,4 +2,4 @@ source "https://rubygems.org"
 
 gemspec
 
-gem 'activesupport', '~> 5.0', '>= 5.0.0.1'
+gem 'activesupport', '~> 6.0'

data/Gemfile.lock

@@ -1,23 +1,24 @@
 PATH
   remote: .
   specs:
-    nested_array (2.2.0)
+    nested_array (2.2.1)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (5.2.4.1)
+    activesupport (6.0.3.2)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 0.7, < 2)
       minitest (~> 5.1)
       tzinfo (~> 1.1)
+      zeitwerk (~> 2.2, >= 2.2.2)
     awesome_print (1.8.0)
     byebug (11.0.1)
-    concurrent-ruby (1.1.5)
+    concurrent-ruby (1.1.6)
     diff-lcs (1.3)
-    i18n (1.7.0)
+    i18n (1.8.3)
       concurrent-ruby (~> 1.0)
-    minitest (5.13.0)
+    minitest (5.14.1)
     rake (10.5.0)
     rspec (3.9.0)
       rspec-core (~> 3.9.0)
@@ -33,14 +34,15 @@ GEM
       rspec-support (~> 3.9.0)
     rspec-support (3.9.0)
     thread_safe (0.3.6)
-    tzinfo (1.2.6)
+    tzinfo (1.2.7)
       thread_safe (~> 0.1)
+    zeitwerk (2.3.0)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  activesupport (~> 5.0, >= 5.0.0.1)
+  activesupport (~> 6.0)
   awesome_print (~> 1.8)
   bundler (~> 2.0)
   byebug (~> 11.0)

data/README-ru.md

@@ -1,6 +1,8 @@
 # NestedArray
 
-Предназначен для преобразования в древовидную структуру плоских данных описанных по паттерну «Список смежности» (Adjacency List), то есть в нодах указа предок `parent_id`. Например:
+Предназначен для преобразования в древовидную структуру плоских данных описанных
+по паттерну «Список смежности» (Adjacency List), то есть в нодах указа предок
+`parent_id`. Например:
 
 ```ruby
 [
@@ -25,8 +27,15 @@
 Добавте строку в _Gemfile_ вашего приложения:
 
 ```ruby
-gem 'nested_array', '~> 1.0.0' # версия не расширяет базовый класс Array методами гема. Для использования необходимо преобразовать данные к новому типу, см ниже.
-gem 'nested_array', '~> 2.0.0' # Версия с автоматическим расширением базового класса Array методами гема.
+# Версия не расширяет базовый класс Array методами гема. Для использования необходимо преобразовать данные к новому типу, см ниже.
+
+# Работа с древовидными массивами.
+gem 'nested_array', '~> 1.0.0'
+
+# Версия с автоматическим расширением базового класса Array методами гема.
+
+# Работа с древовидными массивами.
+gem "nested_array", "~> 2.0.0"
 ```
 
 И затем выполните `bundle install`.
@@ -64,7 +73,10 @@ b = a.to_nested
 
 __Опции__
 
-У каждой ноды вложенной структуры есть базовые свойства, такие как идентификатор, идентификатор предка и другие. Для доступа к этим данным используются ключи, которые можно настроить как в примере ниже. По умолчанию используются следующие __строковые__ (_чувствительны к string/symbol_) ключи:
+У каждой ноды вложенной структуры есть базовые свойства, такие как
+идентификатор, идентификатор предка и другие. Для доступа к этим данным
+используются ключи, которые можно настроить как в примере ниже. По умолчанию
+используются следующие __строковые__ (_чувствительны к string/symbol_) ключи:
 
 ```ruby
 b = a.to_nested({

data/TODO.md

@@ -0,0 +1,26 @@
+# Что реализовано, необходимо реализовать и почему
+
+## Почему
+
+### Почему возвращаем массив Hash
+
+Когда хотим из плоской структуры получить древовидную, то на руках мы можем
+иметь данные различного типа, например, массив Hash или массив ActiveRecord,
+результатом обработки должен быть массив объектов у которых должно быть поле
+children содержащее потомков. Именно поэтому мы не можем оставлять в результате
+массив ActiveRecord, так как поле children будет конфликтовать с уже
+существующим методом, например при использовании гема closure_tree. С другой
+стороны мы моглибы внедрить поле nested_children во все объекты ActiveRecord,
+но такой подход, мне кажется, похож на «Monkey patch».
+
+
+## TODO
+
+Хочу возвращать массив OpenStruct вместо массива Hash.
+
+При возврате массива OpenStruct (всегда) пропадает смысл метода `each_nested!`
+который должен отдавать в переменной node исходные данные (ну они не исходые
+уже). Поэтому необходимо выпустить версию 3.0.0 с удалением метода
+`each_nested!`.
+
+Переработать README-ru и на английский доперевести в конце концов.

data/lib/nested_array/nested.rb

@@ -56,7 +56,7 @@ module NestedArray::Nested
       if node != nil
         is_last_children = cache[level][i[level]].blank?
 
-        yield(node.clone, parents.clone, level, is_last_children)
+        yield(node.clone, parents.clone, level, is_last_children, node.origin)
 
         if !node[options[:children]].nil? && node[options[:children]].length > 0
           level+= 1
@@ -85,8 +85,9 @@ module NestedArray::Nested
       node = cache[level][i[level]]
       i[level]+= 1
       if node != nil
+        is_last_children = cache[level][i[level]].blank?
 
-        yield(node, parents, level)
+        yield(node, parents, level, is_last_children, node.origin)
 
         if !node[options[:children]].nil? && node[options[:children]].length > 0
           level+= 1
@@ -115,13 +116,14 @@ module NestedArray::Nested
     nested = options[:hashed] ? {} : []
     # Перебираем элементы в любом порядке!
     self.each do |value|
+      origin = value
       value = value.serializable_hash if !value.is_a? Hash
       # 1. Если нет родителя текущего элемента, и текущий элемент не корневой, то:
       # 1.1 создадим родителя
       # 1.2 поместим в кэш
       if !(cache.key? value[fields[:parent_id]]) && (value[fields[:parent_id]] != options[:root_id])
         # 1.1
-        temp = {}
+        temp = OpenStruct.new
         fields.each do |key, field|
           case key
           when :id
@@ -151,6 +153,7 @@ module NestedArray::Nested
         value.keys.each do |field|
           cache[value[fields[:id]]][field] = value[field] if !(field.in? fields)
         end
+        cache[value[fields[:id]]].origin = origin
         # 2.2
         # Если текущий элемент не корневой - поместим в родителя, беря его из кэш
         if value[fields[:parent_id]] != options[:root_id]
@@ -174,7 +177,7 @@ module NestedArray::Nested
       # 3.3 поместим в родителя
       else
         # 3.1
-        temp = {}
+        temp = OpenStruct.new
         fields.each do |key, field|
           case key
           when :id
@@ -190,6 +193,7 @@ module NestedArray::Nested
         value.keys.each do |field|
           temp[field] = value[field] if !(field.in? fields)
         end
+        temp.origin = origin
         # 3.2
         cache[value[fields[:id]]] = temp
         # 3.3
@@ -302,7 +306,7 @@ module NestedArray::Nested
       node_level = (1..level).map{|l| last[l] == true ? ' ' : '┃'}.join
       node_last = is_last ? '┗' : '┣'
       node_children = node[options[:children]].present? && node[options[:children]].length > 0 ? '┳' : '━'
-      option_text = "#{node_level}#{node_last}#{node_children}╸#{node_text}"
+      option_text = "#{node_level}#{node_last}#{node_children}╸".html_safe + "#{node_text}"
       option_value = node[options[:option_value]]
       ret.push [option_text, option_value]
     end

data/lib/nested_array/version.rb

@@ -1,3 +1,3 @@
 module NestedArray
-  VERSION = "2.2.0"
+  VERSION = "2.3.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nested_array
 version: !ruby/object:Gem::Version
-  version: 2.2.0
+  version: 2.3.0
 platform: ruby
 authors:
 - zlatov
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-03-10 00:00:00.000000000 Z
+date: 2023-01-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -87,7 +87,6 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".byebug_history"
 - ".gitignore"
 - ".rspec"
 - ".ruby-version"
@@ -97,6 +96,7 @@ files:
 - README-ru.md
 - README.md
 - Rakefile
+- TODO.md
 - bash/build/gem.sh
 - bash/push/gem.sh
 - bash/test/gem.sh
@@ -140,7 +140,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.2.25
 signing_key: 
 specification_version: 4
 summary: Convert a flat array into a nested one in 1 pass and another…

data/.byebug_history

@@ -1,18 +0,0 @@
-c
-fixture.first.deep_symbolize_keys
-fixture.first
-fixture.deep_symbolize_keys
-fixture
-fixture = JSON.parse File.read(fixture_path)
-File.exist?(fixture_path)
-fixture_path = Pathname.new(Dir.pwd).join("spec", "fixtures", "json", "#{name}.json")
-name
-Dir.pwd
-b = a.join $0
-a = Pathname.new Dir.pwd
-$0
-Dir.pwd
-Pathname
-Dir.entries(File.dirname(__FILE__)).reject{|e| e == '.' || e == '..'}.select{|e| File.directory? e}
-File.dirname(__FILE__)
-__FILE__