glimmer-dsl-libui 0.6.0 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cd6518993a36f3108798c6e510e7e8b4cf948738106d78320e3c50a0537d6046
-  data.tar.gz: a06bd741f0900f8311a771cd5acdabefa22e7f7d07f7a2878cc85e03a086c916
+  metadata.gz: c6c85518c66987d793c3e2883d3053f0361a1b21f0f572961d4f92b5e99f8e21
+  data.tar.gz: f69cc3e77d0f95ea5f0e9261588cbc4039bcaafae7b9460ff0890f2210477f00
 SHA512:
-  metadata.gz: b42863592aeff2f871c596bbe8e43fd74646d4a3b7b413ead62bd07f8baf1a40f3109a73e23709441eb32403edac51088211c0c373ea0fa5c29c1f97c6581ff3
-  data.tar.gz: cb642dc20da632413d2fc7a29900158120d9d4146401c334a8681044a048e7a925ed05d7f845ecaf6e75f05a5fbdabc055c5bac28c7713228c466ef116f9db01
+  metadata.gz: db79e052ef21f04e89d0afaa7672b49329370ce7ce4c908885d6eb19f3b715f1ab3c3a6f926d1b0ce3e12ae69a7d7202ba68609ddc1d3bc45cc27d38f5605272
+  data.tar.gz: '088b796cf6521383d92cdc37225e00cc4ef8c4528d0b24f9f92ad4bb552245616090d35f3ee3339d6ddf216f78dbcaa710ec823a040bd1fbf78dbbab853ccd97'

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Change Log
 
+## 0.6.1
+
+- `examples/lazy_table.rb` (and `examples/lazy_table2.rb` variation)
+- Support `table` `cell_rows` implicit data-binding to a collection of models (only supported an array of arrays before in implicit data-binding)
+
 ## 0.6.0
 
 - Upgrade to `libui` Ruby gem version 0.1.0.pre.0, which includes a newer C libui alpha release (libui-ng Nov 13, 2022)

data/README.md

@@ -1,4 +1,4 @@
-# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for LibUI 0.6.0
+# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for LibUI 0.6.1
 ## Prerequisite-Free Ruby Desktop Development GUI Library
 ### The Quickest Way From Zero To GUI
 [![Gem Version](https://badge.fury.io/rb/glimmer-dsl-libui.svg)](http://badge.fury.io/rb/glimmer-dsl-libui)
@@ -542,7 +542,7 @@ gem install glimmer-dsl-libui
 Or install via Bundler `Gemfile`:
 
 ```ruby
-gem 'glimmer-dsl-libui', '~> 0.6.0'
+gem 'glimmer-dsl-libui', '~> 0.6.1'
 ```
 
 Test that installation worked by running the [Meta-Example](#examples):
@@ -2000,8 +2000,10 @@ That is data-binding `entered_text` attribute on `self` to `entry` `text` proper
 ##### Table Data-Binding
 
 One note about `table` `cell_rows` data-binding is that it works with either:
-- Raw data `Array` (rows) of `Array`s (column cells)
-- Model `Array` (rows) of objects having attributes (column cells) matching the underscored names of `table` columns by convention. Model attribute names can be overridden when needed by passing an `Array` enumerating all mapped model attributes in the order of `table` columns or alternatively a `Hash` mapping only the column names that have model attribute names different from their table column underscored version.
+- Raw data `Array` (rows) of `Array`s (column cells) (see [Form Table example versions 4-5](https://github.com/AndyObtiva/glimmer-dsl-libui/blob/master/docs/examples/GLIMMER-DSL-LIBUI-ADVANCED-EXAMPLES.md#form-table)).
+- Model `Array` (rows) of objects having attributes (column cells) matching the underscored names of `table` columns by convention. Model attribute names can be overridden when needed by passing an `Array` enumerating all mapped model attributes in the order of `table` columns or alternatively a `Hash` mapping only the column names that have model attribute names different from their table column underscored version (see [Form Table example versions 1-3](https://github.com/AndyObtiva/glimmer-dsl-libui/blob/master/docs/examples/GLIMMER-DSL-LIBUI-ADVANCED-EXAMPLES.md#form-table)).
+- Raw data `Enumerator` or `Enumerator::Lazy` that generates `Array`s (column cells). This option enables rendering a table instantly even if it contained millions of rows, before all its rows have been generated. Rows are gradually generated as the user scrolls through the table.
+- Model `Enumerator` or `Enumerator::Lazy` that generates objects having attributes (column cells) matching the underscored names of `table` columns. This option enables rendering a table instantly even if it contained millions of rows, before all its rows have been generated. Rows are gradually generated as the user scrolls through the table (see [Lazy Table](https://github.com/AndyObtiva/glimmer-dsl-libui/blob/master/docs/examples/GLIMMER-DSL-LIBUI-ADVANCED-EXAMPLES.md#lazy-table) example).
 
 Example of `table` implicit data-binding of `cell_rows` to raw data `Array` of `Array`s (you may copy/paste in [`girb`](#girb-glimmer-irb)):
 

data/VERSION

@@ -1 +1 @@
-0.6.0
+0.6.1

data/docs/examples/GLIMMER-DSL-LIBUI-ADVANCED-EXAMPLES.md

@@ -13,6 +13,7 @@
   - [Form Table](#form-table)
   - [GPT2 Notepad](#gpt2-notepad)
   - [Paginated Refined Table](#paginated-refined-table)
+  - [Lazy Table](#lazy-table)
   - [Grid](#grid)
   - [Histogram](#histogram)
   - [Login](#login)
@@ -337,125 +338,47 @@ Mac | Windows | Linux
 
 New [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version:
 
-```ruby
-require 'glimmer-dsl-libui'
+[examples/paginated_refined_table.rb](/examples/paginated_refined_table.rb)
 
-class PaginatedRefinedTable
-  Contact = Struct.new(:name, :email, :phone, :city, :state)
-  
-  include Glimmer::LibUI::Application
-  
-  NAMES_FIRST = %w[
-    Liam Noah William James Oliver Benjamin Elijah Lucas Mason Logan Alexander Ethan Jacob Michael Daniel Henry Jackson Sebastian
-    Aiden Matthew Samuel David Joseph Carter Owen Wyatt John Jack Luke Jayden Dylan Grayson Levi Isaac Gabriel Julian Mateo
-    Anthony Jaxon Lincoln Joshua Christopher Andrew Theodore Caleb Ryan Asher Nathan Thomas Leo Isaiah Charles Josiah Hudson
-    Christian Hunter Connor Eli Ezra Aaron Landon Adrian Jonathan Nolan Jeremiah Easton Elias Colton Cameron Carson Robert Angel
-    Maverick Nicholas Dominic Jaxson Greyson Adam Ian Austin Santiago Jordan Cooper Brayden Roman Evan Ezekiel Xaviar Jose Jace
-    Jameson Leonardo Axel Everett Kayden Miles Sawyer Jason Emma Olivia Bartholomew Corey Danielle Eva Felicity
-  ]
-  
-  NAMES_LAST = %w[
-    Smith Johnson Williams Brown Jones Miller Davis Wilson Anderson Taylor George Harrington Iverson Jackson Korby Levinson
-  ]
-  
-  CITIES = [
-    'Bellesville', 'Lombardia', 'Steepleton', 'Deerenstein', 'Schwartz', 'Hollandia', 'Saint Pete', 'Grandville', 'London',
-    'Berlin', 'Elktown', 'Paris', 'Garrison', 'Muncy', 'St Louis',
-  ]
-  
-  STATES = [ 'AK', 'AL', 'AR', 'AZ', 'CA', 'CO', 'CT', 'DC', 'DE', 'FL', 'GA',
-             'HI', 'IA', 'ID', 'IL', 'IN', 'KS', 'KY', 'LA', 'MA', 'MD', 'ME',
-             'MI', 'MN', 'MO', 'MS', 'MT', 'NC', 'ND', 'NE', 'NH', 'NJ', 'NM',
-             'NV', 'NY', 'OH', 'OK', 'OR', 'PA', 'RI', 'SC', 'SD', 'TN', 'TX',
-             'UT', 'VA', 'VT', 'WA', 'WI', 'WV', 'WY']
-             
-  attr_accessor :contacts, :name, :email, :phone, :city, :state, :filter_value, :index
-  
-  before_body do
-    @contacts = 50_000.times.map do |n|
-      n += 1
-      first_name = NAMES_FIRST.sample
-      last_name = NAMES_LAST.sample
-      city = CITIES.sample
-      state = STATES.sample
-      Contact.new("#{first_name} #{last_name}", "#{first_name.downcase}#{n}@#{last_name.downcase}.com", '555-555-5555', city, state)
-    end
-  end
-  
-  body {
-    window("50,000 Paginated Contacts", 600, 700) {
-      margined true
-      
-      vertical_box {
-        form {
-          stretchy false
-          
-          entry {
-            label 'Name'
-            text <=> [self, :name] # bidirectional data-binding between entry text and self.name
-          }
-          
-          entry {
-            label 'Email'
-            text <=> [self, :email]
-          }
-          
-          entry {
-            label 'Phone'
-            text <=> [self, :phone]
-          }
-          
-          entry {
-            label 'City'
-            text <=> [self, :city]
-          }
-          
-          entry {
-            label 'State'
-            text <=> [self, :state]
-          }
-        }
-        
-        button('Save Contact') {
-          stretchy false
-          
-          on_clicked do
-            new_row = [name, email, phone, city, state]
-            if new_row.map(&:to_s).include?('')
-              msg_box_error('Validation Error!', 'All fields are required! Please make sure to enter a value for all fields.')
-            else
-              @contacts << Contact.new(*new_row) # automatically inserts a row into the table due to explicit data-binding
-              @unfiltered_contacts = @contacts.dup
-              self.name = '' # automatically clears name entry through explicit data-binding
-              self.email = ''
-              self.phone = ''
-              self.city = ''
-              self.state = ''
-            end
-          end
-        }
-        
-        refined_table(
-          model_array: contacts,
-          table_columns: {
-            'Name'  => {text: {editable: false}},
-            'Email' => :text,
-            'Phone' => :text,
-            'City'  => :text,
-            'State' => :text,
-          },
-          table_editable: true,
-          per_page: 20,
-          # page: 1, # initial page is 1
-          # visible_page_count: true, # page count can be shown if preferred
-        )
-      }
-    }
-  }
-end
+## Lazy Table
+
+A lazy table is loaded with row data lazily via Ruby `Enumerator` or `Enumerator::Lazy`.
+That enables starting the app and rendering the table instantly before generating/loading all data,
+even if the table was to contain millions of rows.
+
+[examples/lazy_table.rb](/examples/lazy_table.rb)
+
+Run with this command from the root of the project if you cloned the project:
+
+```
+ruby -r './lib/glimmer-dsl-libui' examples/lazy_table.rb
+```
+
+Run with this command if you installed the [Ruby gem](https://rubygems.org/gems/glimmer-dsl-libui):
 
-PaginatedRefinedTable.launch
 ```
+ruby -r glimmer-dsl-libui -e "require 'examples/paginated_refined_table'"
+```
+
+Mac | Windows | Linux
+----|---------|------
+![glimmer-dsl-libui-mac-paginated-refined-table.png](/images/glimmer-dsl-libui-mac-paginated-refined-table.png)| ![glimmer-dsl-libui-windows-paginated-refined-table.png](/images/glimmer-dsl-libui-windows-paginated-refined-table.png)| ![glimmer-dsl-libui-linux-paginated-refined-table.png](/images/glimmer-dsl-libui-linux-paginated-refined-table.png)
+
+`Enumerator` Subclass [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version:
+
+[examples/lazy_table.rb](/examples/lazy_table.rb)
+
+`Enumerator` [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version 2:
+
+[examples/lazy_table2.rb](/examples/lazy_table2.rb)
+
+`Enumerator::Lazy` Subclass [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version 3:
+
+[examples/lazy_table3.rb](/examples/lazy_table3.rb)
+
+`Enumerator::Lazy` [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version 4:
+
+[examples/lazy_table4.rb](/examples/lazy_table4.rb)
 
 ## Grid
 

data/examples/lazy_table.rb

@@ -0,0 +1,76 @@
+require 'glimmer-dsl-libui'
+
+class LazyTable
+  Contact = Struct.new(:name, :email, :phone, :city, :state)
+  
+  # Extending Enumerator enables building a collection generator in an encapsulated maintainable fashion
+  class ContactGenerator < Enumerator
+    NAMES_FIRST = %w[
+      Liam Noah William James Oliver Benjamin Elijah Lucas Mason Logan Alexander Ethan Jacob Michael Daniel Henry Jackson Sebastian
+      Aiden Matthew Samuel David Joseph Carter Owen Wyatt John Jack Luke Jayden Dylan Grayson Levi Isaac Gabriel Julian Mateo
+      Anthony Jaxon Lincoln Joshua Christopher Andrew Theodore Caleb Ryan Asher Nathan Thomas Leo Isaiah Charles Josiah Hudson
+      Christian Hunter Connor Eli Ezra Aaron Landon Adrian Jonathan Nolan Jeremiah Easton Elias Colton Cameron Carson Robert Angel
+      Maverick Nicholas Dominic Jaxson Greyson Adam Ian Austin Santiago Jordan Cooper Brayden Roman Evan Ezekiel Xaviar Jose Jace
+      Jameson Leonardo Axel Everett Kayden Miles Sawyer Jason Emma Olivia Bartholomew Corey Danielle Eva Felicity
+    ]
+    
+    NAMES_LAST = %w[
+      Smith Johnson Williams Brown Jones Miller Davis Wilson Anderson Taylor George Harrington Iverson Jackson Korby Levinson
+    ]
+    
+    CITIES = [
+      'Bellesville', 'Lombardia', 'Steepleton', 'Deerenstein', 'Schwartz', 'Hollandia', 'Saint Pete', 'Grandville', 'London',
+      'Berlin', 'Elktown', 'Paris', 'Garrison', 'Muncy', 'St Louis',
+    ]
+    
+    STATES = [ 'AK', 'AL', 'AR', 'AZ', 'CA', 'CO', 'CT', 'DC', 'DE', 'FL', 'GA',
+               'HI', 'IA', 'ID', 'IL', 'IN', 'KS', 'KY', 'LA', 'MA', 'MD', 'ME',
+               'MI', 'MN', 'MO', 'MS', 'MT', 'NC', 'ND', 'NE', 'NH', 'NJ', 'NM',
+               'NV', 'NY', 'OH', 'OK', 'OR', 'PA', 'RI', 'SC', 'SD', 'TN', 'TX',
+               'UT', 'VA', 'VT', 'WA', 'WI', 'WV', 'WY']
+               
+    def initialize(contact_count)
+      # Make sure to pass super constructor size argument as it gets used by Glimmer DSL for LibUI
+      # to determine the number of rows in the table before generating all its data
+      super(contact_count) do |yielder|
+        contact_count.times do |index|
+          # Data will get lazy loaded into the table as the user scrolls through.
+          # After data is built, it is cached long-term, till updating table `cell_rows`.
+          yielder << contact_for(index)
+        end
+      end
+    end
+    
+    def contact_for(index)
+      number = index + 1
+      first_name = NAMES_FIRST.sample
+      last_name = NAMES_LAST.sample
+      phone = 10.times.map { rand(10) }.yield_self { |numbers| [numbers[0..2], numbers[3..5], numbers[6..9]].map(&:join).join('-') }
+      city = CITIES.sample
+      state = STATES.sample
+      Contact.new("#{first_name} #{last_name}", "#{first_name.downcase}#{number}@#{last_name.downcase}.com", phone, city, state)
+    end
+  end
+  
+  include Glimmer::LibUI::Application
+             
+  body {
+    window("1,000,000 Lazy Loaded Contacts", 600, 700) {
+      margined true
+      
+      vertical_box {
+        table {
+          text_column('Name')
+          text_column('Email')
+          text_column('Phone')
+          text_column('City')
+          text_column('State')
+          
+          cell_rows ContactGenerator.new(1_000_000)
+        }
+      }
+    }
+  }
+end
+
+LazyTable.launch

data/examples/lazy_table2.rb

@@ -0,0 +1,71 @@
+require 'glimmer-dsl-libui'
+
+class LazyTable
+  Contact = Struct.new(:name, :email, :phone, :city, :state)
+  
+  include Glimmer::LibUI::Application
+  
+  NAMES_FIRST = %w[
+    Liam Noah William James Oliver Benjamin Elijah Lucas Mason Logan Alexander Ethan Jacob Michael Daniel Henry Jackson Sebastian
+    Aiden Matthew Samuel David Joseph Carter Owen Wyatt John Jack Luke Jayden Dylan Grayson Levi Isaac Gabriel Julian Mateo
+    Anthony Jaxon Lincoln Joshua Christopher Andrew Theodore Caleb Ryan Asher Nathan Thomas Leo Isaiah Charles Josiah Hudson
+    Christian Hunter Connor Eli Ezra Aaron Landon Adrian Jonathan Nolan Jeremiah Easton Elias Colton Cameron Carson Robert Angel
+    Maverick Nicholas Dominic Jaxson Greyson Adam Ian Austin Santiago Jordan Cooper Brayden Roman Evan Ezekiel Xaviar Jose Jace
+    Jameson Leonardo Axel Everett Kayden Miles Sawyer Jason Emma Olivia Bartholomew Corey Danielle Eva Felicity
+  ]
+  
+  NAMES_LAST = %w[
+    Smith Johnson Williams Brown Jones Miller Davis Wilson Anderson Taylor George Harrington Iverson Jackson Korby Levinson
+  ]
+  
+  CITIES = [
+    'Bellesville', 'Lombardia', 'Steepleton', 'Deerenstein', 'Schwartz', 'Hollandia', 'Saint Pete', 'Grandville', 'London',
+    'Berlin', 'Elktown', 'Paris', 'Garrison', 'Muncy', 'St Louis',
+  ]
+  
+  STATES = [ 'AK', 'AL', 'AR', 'AZ', 'CA', 'CO', 'CT', 'DC', 'DE', 'FL', 'GA',
+             'HI', 'IA', 'ID', 'IL', 'IN', 'KS', 'KY', 'LA', 'MA', 'MD', 'ME',
+             'MI', 'MN', 'MO', 'MS', 'MT', 'NC', 'ND', 'NE', 'NH', 'NJ', 'NM',
+             'NV', 'NY', 'OH', 'OK', 'OR', 'PA', 'RI', 'SC', 'SD', 'TN', 'TX',
+             'UT', 'VA', 'VT', 'WA', 'WI', 'WV', 'WY']
+             
+  before_body do
+    contact_count = 1_000_000
+    # Make sure to pass Enumerator constructor size argument as it gets used by Glimmer DSL for LibUI
+    # to determine the number of rows in the table before generating all its data
+    @contacts = Enumerator.new(contact_count) do |yielder|
+      contact_count.times do |index|
+        number = index + 1
+        first_name = NAMES_FIRST.sample
+        last_name = NAMES_LAST.sample
+        phone = 10.times.map { rand(10) }.yield_self { |numbers| [numbers[0..2], numbers[3..5], numbers[6..9]].map(&:join).join('-') }
+        city = CITIES.sample
+        state = STATES.sample
+        
+        # Data will get lazy loaded into the table as the user scrolls through.
+        # After data is built, it is cached long-term, till updating table `cell_rows`.
+        yielder << Contact.new("#{first_name} #{last_name}", "#{first_name.downcase}#{number}@#{last_name.downcase}.com", phone, city, state)
+      end
+    end
+  end
+  
+  body {
+    window("1,000,000 Lazy Loaded Contacts", 600, 700) {
+      margined true
+      
+      vertical_box {
+        table {
+          text_column('Name')
+          text_column('Email')
+          text_column('Phone')
+          text_column('City')
+          text_column('State')
+          
+          cell_rows @contacts
+        }
+      }
+    }
+  }
+end
+
+LazyTable.launch

data/examples/lazy_table3.rb

@@ -0,0 +1,74 @@
+require 'glimmer-dsl-libui'
+
+class LazyTable
+  Contact = Struct.new(:name, :email, :phone, :city, :state)
+  
+  # Extending Enumerator::Lazy enables building a collection generator in an encapsulated maintainable fashion
+  class ContactGenerator < Enumerator::Lazy
+    NAMES_FIRST = %w[
+      Liam Noah William James Oliver Benjamin Elijah Lucas Mason Logan Alexander Ethan Jacob Michael Daniel Henry Jackson Sebastian
+      Aiden Matthew Samuel David Joseph Carter Owen Wyatt John Jack Luke Jayden Dylan Grayson Levi Isaac Gabriel Julian Mateo
+      Anthony Jaxon Lincoln Joshua Christopher Andrew Theodore Caleb Ryan Asher Nathan Thomas Leo Isaiah Charles Josiah Hudson
+      Christian Hunter Connor Eli Ezra Aaron Landon Adrian Jonathan Nolan Jeremiah Easton Elias Colton Cameron Carson Robert Angel
+      Maverick Nicholas Dominic Jaxson Greyson Adam Ian Austin Santiago Jordan Cooper Brayden Roman Evan Ezekiel Xaviar Jose Jace
+      Jameson Leonardo Axel Everett Kayden Miles Sawyer Jason Emma Olivia Bartholomew Corey Danielle Eva Felicity
+    ]
+    
+    NAMES_LAST = %w[
+      Smith Johnson Williams Brown Jones Miller Davis Wilson Anderson Taylor George Harrington Iverson Jackson Korby Levinson
+    ]
+    
+    CITIES = [
+      'Bellesville', 'Lombardia', 'Steepleton', 'Deerenstein', 'Schwartz', 'Hollandia', 'Saint Pete', 'Grandville', 'London',
+      'Berlin', 'Elktown', 'Paris', 'Garrison', 'Muncy', 'St Louis',
+    ]
+    
+    STATES = [ 'AK', 'AL', 'AR', 'AZ', 'CA', 'CO', 'CT', 'DC', 'DE', 'FL', 'GA',
+               'HI', 'IA', 'ID', 'IL', 'IN', 'KS', 'KY', 'LA', 'MA', 'MD', 'ME',
+               'MI', 'MN', 'MO', 'MS', 'MT', 'NC', 'ND', 'NE', 'NH', 'NJ', 'NM',
+               'NV', 'NY', 'OH', 'OK', 'OR', 'PA', 'RI', 'SC', 'SD', 'TN', 'TX',
+               'UT', 'VA', 'VT', 'WA', 'WI', 'WV', 'WY']
+                 
+    def initialize(contact_count)
+      # Make sure to pass super constructor size (2nd) argument as it gets used by Glimmer DSL for LibUI
+      # to determine the number of rows in the table before generating all its data
+      super(contact_count.times, contact_count) do |yielder, index|
+        # Data will get lazy loaded into the table as the user scrolls through.
+        # After data is built, it is cached long-term, till updating table `cell_rows`.
+        yielder << contact_for(index)
+      end
+    end
+    
+    def contact_for(index)
+      number = index + 1
+      first_name = NAMES_FIRST.sample
+      last_name = NAMES_LAST.sample
+      phone = 10.times.map { rand(10) }.yield_self { |numbers| [numbers[0..2], numbers[3..5], numbers[6..9]].map(&:join).join('-') }
+      city = CITIES.sample
+      state = STATES.sample
+      Contact.new("#{first_name} #{last_name}", "#{first_name.downcase}#{number}@#{last_name.downcase}.com", phone, city, state)
+    end
+  end
+  
+  include Glimmer::LibUI::Application
+
+  body {
+    window("1,000,000 Lazy Loaded Contacts", 600, 700) {
+      margined true
+      
+      vertical_box {
+        table {
+          text_column('Name')
+          text_column('Email')
+          text_column('Phone')
+          text_column('City')
+          text_column('State')
+          
+          cell_rows ContactGenerator.new(1_000_000)
+        }
+      }
+    }
+  }
+end
+
+LazyTable.launch

data/examples/lazy_table4.rb

@@ -0,0 +1,69 @@
+require 'glimmer-dsl-libui'
+
+class LazyTable
+  Contact = Struct.new(:name, :email, :phone, :city, :state)
+  
+  include Glimmer::LibUI::Application
+  
+  NAMES_FIRST = %w[
+    Liam Noah William James Oliver Benjamin Elijah Lucas Mason Logan Alexander Ethan Jacob Michael Daniel Henry Jackson Sebastian
+    Aiden Matthew Samuel David Joseph Carter Owen Wyatt John Jack Luke Jayden Dylan Grayson Levi Isaac Gabriel Julian Mateo
+    Anthony Jaxon Lincoln Joshua Christopher Andrew Theodore Caleb Ryan Asher Nathan Thomas Leo Isaiah Charles Josiah Hudson
+    Christian Hunter Connor Eli Ezra Aaron Landon Adrian Jonathan Nolan Jeremiah Easton Elias Colton Cameron Carson Robert Angel
+    Maverick Nicholas Dominic Jaxson Greyson Adam Ian Austin Santiago Jordan Cooper Brayden Roman Evan Ezekiel Xaviar Jose Jace
+    Jameson Leonardo Axel Everett Kayden Miles Sawyer Jason Emma Olivia Bartholomew Corey Danielle Eva Felicity
+  ]
+  
+  NAMES_LAST = %w[
+    Smith Johnson Williams Brown Jones Miller Davis Wilson Anderson Taylor George Harrington Iverson Jackson Korby Levinson
+  ]
+  
+  CITIES = [
+    'Bellesville', 'Lombardia', 'Steepleton', 'Deerenstein', 'Schwartz', 'Hollandia', 'Saint Pete', 'Grandville', 'London',
+    'Berlin', 'Elktown', 'Paris', 'Garrison', 'Muncy', 'St Louis',
+  ]
+  
+  STATES = [ 'AK', 'AL', 'AR', 'AZ', 'CA', 'CO', 'CT', 'DC', 'DE', 'FL', 'GA',
+             'HI', 'IA', 'ID', 'IL', 'IN', 'KS', 'KY', 'LA', 'MA', 'MD', 'ME',
+             'MI', 'MN', 'MO', 'MS', 'MT', 'NC', 'ND', 'NE', 'NH', 'NJ', 'NM',
+             'NV', 'NY', 'OH', 'OK', 'OR', 'PA', 'RI', 'SC', 'SD', 'TN', 'TX',
+             'UT', 'VA', 'VT', 'WA', 'WI', 'WV', 'WY']
+             
+  before_body do
+    contact_count = 1_000_000
+    # Make sure to pass Enumerator::Lazy constructor size (2nd) argument as it gets used by Glimmer DSL for LibUI
+    # to determine the number of rows in the table before generating all its data
+    @contacts = Enumerator::Lazy.new(contact_count.times, contact_count) do |yielder, index|
+      number = index + 1
+      first_name = NAMES_FIRST.sample
+      last_name = NAMES_LAST.sample
+      phone = 10.times.map { rand(10) }.yield_self { |numbers| [numbers[0..2], numbers[3..5], numbers[6..9]].map(&:join).join('-') }
+      city = CITIES.sample
+      state = STATES.sample
+      
+      # Data will get lazy loaded into the table as the user scrolls through.
+      # After data is built, it is cached long-term, till updating table `cell_rows`.
+      yielder << Contact.new("#{first_name} #{last_name}", "#{first_name.downcase}#{number}@#{last_name.downcase}.com", phone, city, state)
+    end
+  end
+  
+  body {
+    window("1,000,000 Lazy Loaded Contacts", 600, 700) {
+      margined true
+      
+      vertical_box {
+        table {
+          text_column('Name')
+          text_column('Email')
+          text_column('Phone')
+          text_column('City')
+          text_column('State')
+          
+          cell_rows @contacts
+        }
+      }
+    }
+  }
+end
+
+LazyTable.launch

data/lib/glimmer/libui/control_proxy/table_proxy.rb

@@ -38,7 +38,7 @@ module Glimmer
         
         CUSTOM_LISTENER_NAMES = ['on_changed', 'on_edited']
         
-        attr_reader :model_handler, :model, :table_params, :columns, :column_attributes
+        attr_reader :model_handler, :model, :table_params, :columns
       
         def initialize(keyword, parent, args, &block)
           @keyword = keyword
@@ -110,12 +110,12 @@ module Glimmer
         
         def expand_cell_row(cell_row)
           return cell_row if cell_row.nil?
-          cell_row = expand_cell_row_from_model(cell_row) if !cell_row.is_a?(Array) && @column_attributes&.any?
+          cell_row = expand_cell_row_from_model(cell_row) if !cell_row.is_a?(Array) && column_attributes.any?
           cell_row.flatten(1)
         end
         
         def expand_cell_row_from_model(cell_row)
-          @column_attributes.to_a.map {|attribute| cell_row.send(attribute) }
+          column_attributes.to_a.map {|attribute| cell_row.send(attribute) }
         end
         
         def editable(value = nil)
@@ -129,6 +129,10 @@ module Glimmer
         alias set_editable editable
         alias editable? editable
         
+        def column_attributes
+          @column_attributes ||= columns.select {|column| column.is_a?(Column)}.map(&:name).map(&:underscore)
+        end
+        
         def data_bind_read(property, model_binding)
           if model_binding.binding_options[:column_attributes].is_a?(Array)
             @column_attributes = model_binding.binding_options[:column_attributes]
@@ -141,7 +145,7 @@ module Glimmer
             new_value = model_binding.evaluate_property
             if model_binding.binding_options[:column_attributes] || (!new_value.nil? && (!new_value.is_a?(String) || !new_value.empty?) && (!new_value.is_a?(Array) || !new_value.first.is_a?(Array)))
               @model_attribute_array_observer_registration&.deregister
-              @model_attribute_array_observer_registration = model_attribute_observer.observe(new_value, @column_attributes, ignore_frozen: true, attribute_writer_type: [:attribute=, :set_attribute])
+              @model_attribute_array_observer_registration = model_attribute_observer.observe(new_value, column_attributes, ignore_frozen: true, attribute_writer_type: [:attribute=, :set_attribute])
               model_attribute_observer.add_dependent(model_attribute_observer_registration => @model_attribute_array_observer_registration)
             end
             # TODO look if multiple notifications are happening as a result of observing array and observing model binding
@@ -326,7 +330,7 @@ module Glimmer
                 if cell_row.is_a?(Array)
                   cell_row[compound_column_index_for(column)] = -1
                 else
-                  attribute = @column_attributes[column]
+                  attribute = column_attributes[column]
                   cell_row.send("#{attribute}=", -1)
                 end
                 ::LibUI.new_table_value_int(old_value)
@@ -349,7 +353,7 @@ module Glimmer
               if table_cell_row.is_a?(Array)
                 table_cell_row[column] = ::LibUI.table_value_string(val).to_s
               else
-                attribute = @column_attributes[column]
+                attribute = column_attributes[column]
                 table_cell_row.send("#{attribute}=", ::LibUI.table_value_string(val).to_s)
               end
             when Column::TextColorColumnProxy
@@ -358,7 +362,7 @@ module Glimmer
                 table_cell_row[column] ||= []
                 table_cell_row[column][0] = ::LibUI.table_value_string(val).to_s
               else
-                attribute = @column_attributes[column]
+                attribute = column_attributes[column]
                 table_cell_row.send("#{attribute}=", []) unless table_cell_row.send(attribute)
                 table_cell_row.send(attribute)[0] = ::LibUI.table_value_string(val).to_s
               end
@@ -368,7 +372,7 @@ module Glimmer
                 table_cell_row[column] ||= []
                 table_cell_row[column][1] = ::LibUI.table_value_string(val).to_s
               else
-                attribute = @column_attributes[column]
+                attribute = column_attributes[column]
                 table_cell_row.send("#{attribute}=", []) unless table_cell_row.send(attribute)
                 table_cell_row.send(attribute)[1] = ::LibUI.table_value_string(val).to_s
               end
@@ -379,7 +383,7 @@ module Glimmer
               if table_cell_row.is_a?(Array)
                 table_cell_row[column] = ::LibUI.table_value_int(val).to_i == 1
               else
-                attribute = @column_attributes[column]
+                attribute = column_attributes[column]
                 table_cell_row.send("#{attribute}=", ::LibUI.table_value_int(val).to_i == 1)
               end
             when Column::CheckboxTextColumnProxy
@@ -388,7 +392,7 @@ module Glimmer
                 table_cell_row[column] ||= []
                 table_cell_row[column][0] = ::LibUI.table_value_int(val).to_i == 1
               else
-                attribute = @column_attributes[column]
+                attribute = column_attributes[column]
                 table_cell_row.send("#{attribute}=", []) unless table_cell_row.send(attribute)
                 table_cell_row.send(attribute)[0] = ::LibUI.table_value_int(val).to_i == 1
               end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glimmer-dsl-libui
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.6.1
 platform: ruby
 authors:
 - Andy Maleh
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-01-09 00:00:00.000000000 Z
+date: 2023-01-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: glimmer
@@ -348,6 +348,10 @@ files:
 - examples/grid.rb
 - examples/histogram.rb
 - examples/histogram2.rb
+- examples/lazy_table.rb
+- examples/lazy_table2.rb
+- examples/lazy_table3.rb
+- examples/lazy_table4.rb
 - examples/login.rb
 - examples/login2.rb
 - examples/login3.rb