nested_array 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1226eabba471ff36c05d62793baa80196a9b5126182f43f0e8c17a1d381bbed0
-  data.tar.gz: 904e12afa79e89cde37afad62e1fb3d71896927d21da1ee8e4232009d253200e
+  metadata.gz: 540363bb5ada651621c74257b8d1f79015f3916443ce58a328a040eb53770edf
+  data.tar.gz: 743c036b6644d16f66822ad083cb5d3d72ecad7e47976e30e4c058d313101ff2
 SHA512:
-  metadata.gz: cd090bbf6513c6423df792a2bc1f9408e6dbc13d29e7ea1314320d87c6209585ba78c51144346f7a508e3db69abedc36bd9c043554cc1c49bdd22569ead700e3
-  data.tar.gz: 59c94c994b131ef551e2f36c3dfde6a3442522a6dd9260c66d44fd78f9bf81e833113513319b64e81858f24ed0e59b000f54828eb2fc29c8d557a50055e4a08b
+  metadata.gz: 45d7dc6fdfebfed713c4c45172a10ede2b4fe5fc562ae4c2a3faf148ac42e44ae1d3823875f45667f3a894bd02ca78df7bee5de217deb8b8dece8817847d9ee5
+  data.tar.gz: a0b0e64c7c8fa384ae20381fbbb361154445935d80ae1da742428976bd0f6d27e0389854120203e83741290397eda133d41c7d9966dcb22d565096d7845560c0

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    nested_array (1.0.1)
+    nested_array (1.2.0)
 
 GEM
   remote: https://rubygems.org/
@@ -49,4 +49,4 @@ DEPENDENCIES
   rspec (~> 3.9)
 
 BUNDLED WITH
-   2.0.1
+   2.1.4

data/README-ru.md

@@ -18,12 +18,15 @@
 ```
 
 
+
+
 ## Установка
 
 Добавте строку в _Gemfile_ вашего приложения:
 
 ```ruby
-gem 'nested_array', '~> 1.1.0'
+gem 'nested_array', '~> 1.0.0' # версия не расширяет базовый класс Array методами гема. Для использования необходимо преобразовать данные к новому типу, см ниже.
+gem 'nested_array', '~> 2.0.0' # Версия с автоматическим расширением базового класса Array методами гема.
 ```
 
 И затем выполните `bundle install`.
@@ -31,24 +34,31 @@ gem 'nested_array', '~> 1.1.0'
 Или установите его как `gem install nested_array`
 
 
+
+
 ## Использование
 
+<a name="methods"></a>
 __Список методов__
 
-* `to_nested` — преобразует плоскую структуро во вложенную;
-* `each_nested` — перебирает вложенную стуктуру;
-* `each_nested!` — перебирает вложенную стуктуру, предоставляя доступ к исходным данным;
-* `nested_to_html` — преобразует вложенную структуру в html вёрстку (многоуровневый список `<ul><li>…`);
-* `nested_to_options` — преобразует вложенную в массив для формирования опций html-тега `<select>` с псевдографикой;
-* `concat_nested` — скеивание вложенных структур, ноды склеиваются если путь к ним одинаков.
+* [to_nested](#to_nested) — преобразует плоскую структуру во вложенную;
+* [each_nested](#each_nested) — перебирает вложенную стуктуру;
+* [each_nested!](#each_nested) — перебирает вложенную стуктуру, предоставляя доступ к исходным данным;
+* [nested_to_html](#nested_to_html) — преобразует вложенную структуру в html вёрстку (многоуровневый список `<ul><li>…`);
+* [nested_to_options](#nested_to_options) — преобразует вложенную структуру в массив для формирования опций html-тега `<select>` с псевдографикой;
+* [concat_nested](#concat_nested) — скеивание вложенных структур, ноды склеиваются если путь к ним одинаков.
+
+
 
-### to_nested
 
-Преобразует плоскую структуро во вложенную.
+<a name="to_nested"></a>
+### to_nested [↑](#methods "К методам")
+
+Преобразует плоскую структуру во вложенную.
 
 ```ruby
 a = [{'id' => 1, 'parent_id' => nil}]
-a = NestedArray::Array.new 
+a = NestedArray::Array.new a
 b = a.to_nested
 ```
 
@@ -77,7 +87,11 @@ b = a.to_nested({
 })
 ```
 
-### each_nested
+
+
+
+<a name="each_nested"></a>
+### each_nested [↑](#methods "К методам")
 
 Перебирает вложенную стуктуру.
 
@@ -90,21 +104,69 @@ nested.each_nested do |node, parents, level, is_last_children|
 end
 ```
 
-### nested_to_html
+
+
+
+<a name="nested_to_html"></a>
+### nested_to_html [↑](#methods "К методам")
+
+Формирует _html_-код для вывода вложенных структур с использованием вложенных друг в друга списков `<ul>`.
+
+__Пример__
+
+```ruby
+[
+  {'id' => 1, 'parent_id' => nil, 'name' => 'first'},
+  {'id' => 2, 'parent_id' =>   1, 'name' => 'second'},
+  {'id' => 3, 'parent_id' =>   1, 'name' => 'third'}
+].to_nested.nested_to_html do |node|
+  node['name']
+end
+```
+
+Вернёт
+
+```html
+	<li>first
+		<ul>
+			<li>second</li>
+			<li>third</li>
+		</ul>
+	</li>
+```
+
+__Расширенный пример__
+
+```ruby
+.nested_to_html li: '<li class="my">', _ul: '<i></i></ul>' do |node, parents, level|
+  block_options = {}
+  block_options[:li] = '<li class="my current">' if node['id'] == 2
+  [
+  	"id: #{node['id']}, #{node['name']}, parent name: #{parents[level]&.[]('name')}",
+  	block_options
+  ]
+end
+```
 
 __Опции__
 
+Все опции могут быть аргументами метода, и только некоторые опции влияют на результат через блок — на лету (последняя строка блока).
+
 ```ruby
 tabulated: true,
 inline: false,
 tab: "\t",
-ul:  '<ul>',
+ul:  '<ul>', # может задаваться блоком
 _ul: '</ul>',
-li:  '<li>',
+li:  '<li>', # может задаваться блоком
 _li: '</li>',
 ```
 
-### nested_to_options
+
+
+
+<a name="nested_to_options"></a>
+### nested_to_options [↑](#methods "К методам")
 
 Формирования опций для html-тега &lt;select&gt;
 
@@ -122,7 +184,11 @@ option_value: 'id', # Что брать в качестве значений п
 option_text: 'name',
 ```
 
-### concat_nested
+
+
+
+<a name="concat_nested"></a>
+### concat_nested [↑](#methods "К методам")
 
 Скеивание вложенных структур.
 
@@ -136,16 +202,23 @@ path_separator: '-=path_separator=-',
 path_key: 'text',
 ```
 
-## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
-## Contributing
+## Разработка
+
+…
+
+
+
+
+## Содействие
+
+…
+
+
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/Zlatov/nested_array.
 
-## License
+## Лицензия
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+В соответствии с условиями [лицензии MIT](https://opensource.org/licenses/MIT).

data/README.md

@@ -24,6 +24,7 @@ Add this line to your application's Gemfile:
 
 ```ruby
 gem 'nested_array', '~> 1.0.0'
+gem 'nested_array', '~> 2.0.0'
 ```
 
 And then execute: `bundle`.

data/lib/nested_array/nested.rb

@@ -252,15 +252,16 @@ module NestedArray::Nested
       i[level]+= 1
       if node != nil
 
+        node_html, node_options = yield(node.clone, parents.clone, level)
         html+= options[:tab] * (level * 2 + 1) if options[:tabulated]
-        html+= options[:li]
-        html+= yield(node.clone, parents.clone, level)
+        html+= node_options&.[](:li) || options[:li]
+        html+= node_html.to_s
 
         if !node[options[:children]].nil? && node[options[:children]].length > 0
           level+= 1
           html+= "\n" if !options[:inline]
           html+= options[:tab] * (level * 2) if options[:tabulated]
-          html+= options[:ul]
+          html+= node_options&.[](:ul) || options[:ul]
           html+= "\n" if !options[:inline]
           parents[level] = node.clone
           cache[level] = node[options[:children]]

data/lib/nested_array/version.rb

@@ -1,3 +1,3 @@
 module NestedArray
-  VERSION = "1.1.0"
+  VERSION = "1.2.0"
 end

data/test.old/Gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+gem 'activesupport'
+gem 'awesome_print'
+gem 'nested_array', path: '../'

data/test.old/Gemfile.lock

@@ -0,0 +1,34 @@
+PATH
+  remote: ..
+  specs:
+    nested_array (1.0.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (6.0.2.1)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 0.7, < 2)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
+      zeitwerk (~> 2.2)
+    awesome_print (1.8.0)
+    concurrent-ruby (1.1.6)
+    i18n (1.8.2)
+      concurrent-ruby (~> 1.0)
+    minitest (5.14.0)
+    thread_safe (0.3.6)
+    tzinfo (1.2.6)
+      thread_safe (~> 0.1)
+    zeitwerk (2.2.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activesupport
+  awesome_print
+  nested_array!
+
+BUNDLED WITH
+   2.0.1

data/test.old/bash/run/bundle.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+
+set -eu
+
+cd "$(dirname "${0}")"
+
+cd ../..
+
+bundle install

data/test.old/bash/run/test.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+
+set -eu
+
+cd "$(dirname "${0}")"
+
+cd ../..
+
+bundle exec ruby test.rb

data/test.old/test.rb

@@ -0,0 +1,42 @@
+require 'active_support/all'
+require 'awesome_print'
+require 'nested_array'
+
+puts 'Начато тестирование.'.blue
+puts "Версия руби: #{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}"
+
+def to_nested_1
+  puts "Тестирование #{__method__}".blue
+  a = [
+    {'id' => 1, 'parent_id' => nil, 'name' => 'first'},
+    {'id' => 2, 'parent_id' => 1, 'name' => 'second'},
+    {'id' => 3, 'parent_id' => 1, 'name' => 'third'}
+  ]
+  a = NestedArray::Array.new a
+  b = a.to_nested
+  return false if b != [
+    {'id' => 1, 'parent_id' => nil, 'name' => 'first', 'children' => [
+      {'id' => 2, 'parent_id' => 1, 'name' => 'second'},
+      {'id' => 3, 'parent_id' => 1, 'name' => 'third'}
+    ]},
+  ]
+  b = a.to_nested add_level: true
+  return false if b != [
+    {'id' => 1, 'parent_id' => nil, 'name' => 'first', 'level' => 0, 'children' => [
+      {'id' => 2, 'parent_id' => 1, 'name' => 'second', 'level' => 1},
+      {'id' => 3, 'parent_id' => 1, 'name' => 'third', 'level' => 1}
+    ]},
+  ]
+  return true
+end
+
+
+
+
+begin
+  raise if !to_nested_1
+rescue => e
+  puts 'Тестирование не пройдено.'.red
+  exit 1
+end
+puts 'Тестирование пройдено.'.green

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nested_array
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - zlatov
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-02-14 00:00:00.000000000 Z
+date: 2020-03-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -113,6 +113,11 @@ files:
 - lib/nested_array/nested.rb
 - lib/nested_array/version.rb
 - nested_array.gemspec
+- test.old/Gemfile
+- test.old/Gemfile.lock
+- test.old/bash/run/bundle.sh
+- test.old/bash/run/test.sh
+- test.old/test.rb
 homepage: https://github.com/Zlatov/nested_array
 licenses:
 - MIT