nested_array 2.2.1 → 2.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9e82939abe3e113f9ce8e54713fd52221362f5e68f5e510ec00153e5504c7198
-  data.tar.gz: 7a854bb61bbb605396b154246b71f2c4e482c1356b37f1f6cb9c2bc4bda6e7f4
+  metadata.gz: 0b49067e4c7566810e2689fd293994ae2f8c8b5cb40dfab84e7eb73f440dccd6
+  data.tar.gz: 3cf05731a72c97d59486f916ac89ce33c3d8c32cd6775e14ceefad498ee11022
 SHA512:
-  metadata.gz: 1dc59a5a4ae0393bc3f3ab1156273e5490b2ac9a3495595d9ff23a0d9d3dfd79f215f7762f7a361ab0c0827f4a7bbcd606b105dec23c2b22ec3d92e3faf7f2ac
-  data.tar.gz: a0a0b98e8f8a3c440a8d8c56f1744352b0f94fbc626cb2380fe0b382fbbae2f52cd84ea05812fa2f03b1bda0402e9f7b6c9fc4139c58030c28307c21b55bb855
+  metadata.gz: c79be9c3ad75d6ee6c6d170fdc7116587e3bd0f0924e8a904ca74f2abb0486c9e748325e66173c1055622106ea6e10a20bd107f6e7e4c56398210d867afa46eb
+  data.tar.gz: ef2dc1b64710fe0a647f6fd81f0e05cd26ad68abda8a76fb6e4f27c05ccf3be38ca4e5d69bd2d241d692505e619f942df894601dbebdf8b4324ab4e2de7e901f

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

@@ -6,18 +6,19 @@ PATH
 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

@@ -55,6 +55,7 @@ __Список методов__
 * [each_nested!](#each_nested) — перебирает вложенную стуктуру, предоставляя доступ к исходным данным;
 * [nested_to_html](#nested_to_html) — преобразует вложенную структуру в html вёрстку (многоуровневый список `<ul><li>…`);
 * [nested_to_options](#nested_to_options) — преобразует вложенную структуру в массив для формирования опций html-тега `<select>` с псевдографикой;
+* [nested_to_collection_select](#nested_to_collection_select) — преобразует вложенную структуру в плоскую но добавляет псевдографику в тектовое поле для формирования тэга `<select>`;
 * [concat_nested](#concat_nested) — скеивание вложенных структур, ноды склеиваются если путь к ним одинаков.
 
 
@@ -199,6 +200,56 @@ option_text: 'name',
 
 
 
+<a name="nested_to_collection_select"></a>
+### nested_to_collection_select [↑](#methods "К методам")
+
+Преобразует вложенную структуру данных в плоскую, но добавляет в значение поля
+отвечающего за текстовое представление (:name) псевдографику древовидной
+структуры.
+
+Это позволяет вывести тэг select в сносном виде для использования с вложенными
+структурами.
+
+Пример с хелпером `collection_select`
+
+```rb
+<%= form.collection_select :catalog_ids,
+  Catalog.all.to_a.to_nested.nested_to_collection_select, :id, :name,
+  {
+    # prompt: true
+    # include_blank: true
+  },
+  {
+    multiple: true,
+    size: 10
+  }
+%>
+```
+
+Пример с хелпером `select` в сочетании с `options_from_collection_for_select`
+
+```erb
+<% catalogs = Catalog.all.to_a %>
+<%= form.select :catalog_ids,
+  options_from_collection_for_select(
+    catalogs.to_nested.nested_to_collection_select, :id, :name,
+    disabled: catalogs.select{|x| x.hidden?}.pluck(:id),
+    selected: form.object.catalog_ids
+  ),
+  {
+    # prompt: true
+    # include_blank: true
+  },
+  {
+    multiple: true,
+    size: 10
+  }
+%>
+```
+
+
+
+
 <a name="concat_nested"></a>
 ### concat_nested [↑](#methods "К методам")
 

data/TODO.md

@@ -0,0 +1,29 @@
+# Что реализовано, необходимо реализовать и почему
+
+## Почему
+
+### Почему возвращаем массив 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!`.
+
+Добавлен метод nested_to_collection_select, нужно пересмотреть метод
+nested_to_options (возможно удалить в следующей версии).
+
+Переработать 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
@@ -309,6 +313,29 @@ module NestedArray::Nested
     ret
   end
 
+  # Преобразует вложенную структуру данных в плоскую, но добавляет в значение
+  # поля отвечающего за текстовое представление (:name) псевдографику
+  # древовидной структуры.
+  # Это позволяет вывести тэг select в сносном виде для использования с
+  # вложенными структурами.
+  def nested_to_collection_select(options={})
+    options = NESTED_OPTIONS.merge options
+    ret = []
+    last = []
+    each_nested do |node, parents, level, is_last, origin|
+      last[level+1] = is_last
+      node_text = node[options[:option_text]]
+      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}╸".html_safe + "#{node_text}"
+      option_value = node[options[:option_value]]
+      node[options[:option_text]] = option_text
+      ret.push node
+    end
+    ret
+  end
+
   # "Скеивание" вложенных структур
   # ноды склеиваются если путь к ним одинаков;
   # путь определяется из сложения Текстов (конфигурируемо через :path_key);

data/lib/nested_array/version.rb

@@ -1,3 +1,3 @@
 module NestedArray
-  VERSION = "2.2.1"
+  VERSION = "2.4.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nested_array
 version: !ruby/object:Gem::Version
-  version: 2.2.1
+  version: 2.4.0
 platform: ruby
 authors:
 - zlatov
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-01-14 00:00:00.000000000 Z
+date: 2023-01-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -96,6 +96,7 @@ files:
 - README-ru.md
 - README.md
 - Rakefile
+- TODO.md
 - bash/build/gem.sh
 - bash/push/gem.sh
 - bash/test/gem.sh