table_structure 0.1.4 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: af7a012ce96e50bfc67ff0360ba39b8f2c2f0b0772e0260b17729777b805eeb7
-  data.tar.gz: 4fd45259f91bde2016be845200cbd88ba3b50c3e7b6c75b257e228f4475a500a
+  metadata.gz: e3c3fdd974ce55df18db48df989c744dd8bc13b28ec4c754d01a815cfde31b93
+  data.tar.gz: 624360f1775a9c3f7be02453c347adb55870b656eb0e79e6f4cb9c0c84037939
 SHA512:
-  metadata.gz: dc61fd25875979c3c3e06ba9e0648bea2eed3abcf058072ef2802c1c0379b194aeee4213b76268ae10118368cbd0076303658ca3ce2d19c85ea366709ae6f3f5
-  data.tar.gz: 82203dac6eaf8418eecb9ee4ed62b550277f6c57d54f4f78d04b72edb317a7cec91b16f1f16fa43749d56a55ebb28d871be82e11bccf72ab3db128e45e3c6795
+  metadata.gz: 044f11d274989855569f1931d98555e7f7cd153e1bc3fe271685860e310b40065bdbff5e87f576025f5401a5db9bb67f0f082d7a0798b2d8e83e040e717cbb1e
+  data.tar.gz: 110bd8d5cf2cfb215cee9ca0806ec6cbc0ee3074a7b4c944cd1bce0ecc7e031b567e908fe9ff1b3acaed10aaae8ebee44e82f200cf0922b8effae15d4c541608

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    table_structure (0.1.4)
+    table_structure (0.2.0)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -106,6 +106,78 @@ response.headers['Content-Disposition'] = 'attachment; filename="sample.csv"'
 response_body = Enumerator.new { |y| writer.write(items, to: CSV.new(y)) }
 ```
 
+#### TableStructure::Iterator
+Specifying `result_type: :hash` option of `TableStructure::Schema` works well.
+To use this option, define `column(s)` with `:key`.
+```ruby
+class SampleTableSchema
+  include TableStructure::Schema
+
+  # If header is required, :name must also be defined.
+  column  key: :id,
+          value: ->(row, *) { row[:id] }
+
+  column  key: :name,
+          value: ->(row, *) { row[:name] }
+
+  columns key: %i[pet1 pet2 pet3],
+          value: ->(row, *) { row[:pets] }
+
+  columns ->(table) {
+    table[:questions].map do |question|
+      {
+        key: question[:id].downcase.to_sym,
+        value: ->(row, *) { row[:answers][question[:id]] }
+      }
+    end
+  }
+
+  column_converter :to_s, ->(val, *) { val.to_s }
+end
+
+context = {
+  questions: [
+    { id: 'Q1', text: 'Do you like sushi?' },
+    { id: 'Q2', text: 'Do you like yakiniku?' },
+    { id: 'Q3', text: 'Do you like ramen?' }
+  ]
+}
+
+schema = SampleTableSchema.new(context: context, result_type: :hash) # default is :array
+iterator = TableStructure::Iterator.new(schema, header_omitted: true)
+## or
+# writer = TableStructure::Writer.new(schema, header_omitted: true)
+# iterator = TableStructure::Iterator.new(writer)
+
+items = [
+  {
+    id: 1,
+    name: 'Taro',
+    pets: ['🐱', '🐶'],
+    answers: { 'Q1' => '⭕️', 'Q2' => '❌', 'Q3' => '⭕️' }
+  },
+  {
+    id: 2,
+    name: 'Hanako',
+    pets: ['🐇', '🐢', '🐿', '🦒'],
+    answers: { 'Q1' => '⭕️', 'Q2' => '⭕️', 'Q3' => '❌' }
+  }
+]
+
+enum = iterator.iterate(items)
+
+## Enumerator methods is available
+enum.each do |item|
+  # ...
+end
+
+enum.map(&:itself)
+# => [{:id=>"1", :name=>"Taro", :pet1=>"🐱", :pet2=>"🐶", :pet3=>"", :q1=>"⭕️", :q2=>"❌", :q3=>"⭕️"}, {:id=>"2", :name=>"Hanako", :pet1=>"🐇", :pet2=>"🐢", :pet3=>"🐿", :q1=>"⭕️", :q2=>"⭕️", :q3=>"❌"}]
+
+enum.lazy.select { |item| item[:q1] == '⭕️' }.take(1).force
+# => [{:id=>"1", :name=>"Taro", :pet1=>"🐱", :pet2=>"🐶", :pet3=>"", :q1=>"⭕️", :q2=>"❌", :q3=>"⭕️"}]
+```
+
 ### Advanced
 
 You can also use `context_builder`.

data/lib/table_structure.rb

@@ -17,4 +17,5 @@ module TableStructure
   require 'table_structure/schema/column'
   require 'table_structure/schema/utils'
   require 'table_structure/writer'
+  require 'table_structure/iterator'
 end

data/lib/table_structure/iterator.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module TableStructure
+  class Iterator
+    def initialize(schema_or_writer, **options)
+      case
+      when schema_or_writer.is_a?(Schema)
+        schema = schema_or_writer
+        @writer = Writer.new(schema, options)
+      when schema_or_writer.is_a?(Writer)
+        @writer = schema_or_writer
+      else
+        raise ::TableStructure::Error.new('First argument must be either Schema or Writer.')
+      end
+    end
+
+    def iterate(items)
+      Enumerator.new { |y| @writer.write(items, to: y) }
+    end
+  end
+end

data/lib/table_structure/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TableStructure
-  VERSION = '0.1.4'
+  VERSION = '0.2.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: table_structure
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.2.0
 platform: ruby
 authors:
 - jsmmr
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-08-21 00:00:00.000000000 Z
+date: 2019-08-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -71,6 +71,7 @@ files:
 - bin/console
 - bin/setup
 - lib/table_structure.rb
+- lib/table_structure/iterator.rb
 - lib/table_structure/schema.rb
 - lib/table_structure/schema/column.rb
 - lib/table_structure/schema/definition.rb