glimmer-dsl-tk 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3f1d6377c707655c2ae9b49e60f3412e31ef27869aefee78492c30feeba21ef5
-  data.tar.gz: 02bef3e445ba3e3fce1633d89af37c66860dadbe2ae5aa4472c6dbcbbcd3602c
+  metadata.gz: 2f57063e358754b89fbd0a57cb118fb9764595a8965eba5884aeb2988ab2d6b1
+  data.tar.gz: f55e3fc96a9388dd218d7c674cdf1585831c44a3f6412741e0e65f53185e2d98
 SHA512:
-  metadata.gz: 30f1946ae7324c585309f0986f5a320a427250ca2e6925999856a2bd07958ab420b8ba67e6227d1991f7ab68e43627337fc6644f4b97d81899a7dafaccc8db61
-  data.tar.gz: cba5744288234fe059aa9c5efe68d9c0404d81211d63096b07a45f89474fcaaa4c57b7faccb018003394c8a50a9750c5bfc4d26f17a5ee16b74f40f5dac60170
+  metadata.gz: 272ea64f1a285ebcef28edb4bc2092f1c8ac78bf9ea36e086f1555ba47a454cb09b8c698e06d5ed0aa76abab1fb7946535bae139e9d444663de8185483bba7f4
+  data.tar.gz: e6fa9a29aa2b6a7c096007489a0b0e07d0658f6c79ef836a4cbd4d2fc1300330ef19b97bb6ea62e5d7cac9e00f5a2fca32ee745b167cc8f0d826cacd98a13b1c

data/README.md

@@ -1,19 +1,24 @@
-# [<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 Tk 0.0.2 (Desktop GUI)
+# [<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 Tk 0.0.3 (Desktop GUI)
 [![Gem Version](https://badge.fury.io/rb/glimmer-dsl-tk.svg)](http://badge.fury.io/rb/glimmer-dsl-tk)
+[![Maintainability](https://api.codeclimate.com/v1/badges/ce2853efdbecf6ebdc73/maintainability)](https://codeclimate.com/github/AndyObtiva/glimmer-dsl-tk/maintainability)
 [![Join the chat at https://gitter.im/AndyObtiva/glimmer](https://badges.gitter.im/AndyObtiva/glimmer.svg)](https://gitter.im/AndyObtiva/glimmer?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 
 [Glimmer](https://github.com/AndyObtiva/glimmer) DSL for [Tk](https://www.tcl.tk/) enables desktop development with [Glimmer](https://github.com/AndyObtiva/glimmer).
 
 [Tcl/Tk](https://www.tcl.tk/) has evolved into a practical desktop GUI toolkit due to gaining true native widgets on Mac, Windows, and Linux in [Tk version 8.5](https://www.tcl.tk/software/tcltk/8.5.html#:~:text=Highlights%20of%20Tk%208.5&text=Font%20rendering%3A%20Now%20uses%20anti,and%20window%20layout%2C%20and%20more.).
 
-Additionally, Ruby 3.0 supports truly parallel multi-threading, making both [MRI](https://github.com/ruby/ruby) and [Tk](https://www.tcl.tk/) finally viable for support in [Glimmer](https://github.com/AndyObtiva/glimmer) (Ruby Desktop Development GUI Library).
+Additionally, [Ruby](https://www.ruby-lang.org/en/) 3.0 Ractor (formerly known as [Guilds](https://olivierlacan.com/posts/concurrency-in-ruby-3-with-guilds/)) supports truly parallel multi-threading, making both [MRI](https://github.com/ruby/ruby) and [Tk](https://www.tcl.tk/) finally viable for support in [Glimmer](https://github.com/AndyObtiva/glimmer) (Ruby Desktop Development GUI Library) as an alternative to [JRuby on SWT](https://github.com/AndyObtiva/glimmer-dsl-swt).
+
+The trade-off is that while [SWT](https://www.eclipse.org/swt/) provides a plethora of high quality reusable widgets for the Enterprise (such as [Nebula](https://www.eclipse.org/nebula/)), [Tk](https://www.tcl.tk/) enables very fast app startup time via [MRI Ruby](https://www.ruby-lang.org/en/).
 
 [Glimmer](https://github.com/AndyObtiva/glimmer) provides a DSL to enable more productive desktop development in Ruby with:
 - Declarative DSL syntax that visually maps to the GUI widget hierarchy
 - Convention over configuration via smart defaults and automation of low-level details
 - Requiring the least amount of syntax possible to build GUI
+- Bidirectional Data-Binding to declaratively wire and automatically synchronize GUI with Business Models
 - Scaffolding for new custom widgets, apps, and gems
 - Native-Executable packaging on Mac, Windows, and Linux
+- Custom Widget support
 
 **Hello, World!**
 
@@ -30,7 +35,7 @@ root {
 Run (with the [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed):
 
 ```
-ruby -e "require '../samples/hello/hello_world.rb'"
+ruby -r glimmer-dsl-tk -e "require '../samples/hello/hello_world.rb'"
 ```
 
 Glimmer app:
@@ -38,7 +43,7 @@ Glimmer app:
 ![glimmer dsl tk screenshot sample hello world](images/glimmer-dsl-tk-screenshot-sample-hello-world.png)
 
 Other [Glimmer](https://github.com/AndyObtiva/glimmer) DSL gems:
-- [glimmer-dsl-swt](https://github.com/AndyObtiva/glimmer-dsl-swt): Glimmer DSL for SWT (Desktop GUI via JRuby on SWT)
+- [glimmer-dsl-swt](https://github.com/AndyObtiva/glimmer-dsl-swt): Glimmer DSL for SWT (JRuby Desktop GUI)
 - [glimmer-dsl-opal](https://github.com/AndyObtiva/glimmer-dsl-opal): Glimmer DSL for Opal (Web GUI Adapter for Desktop Apps)
 - [glimmer-dsl-xml](https://github.com/AndyObtiva/glimmer-dsl-xml): Glimmer DSL for XML (& HTML)
 - [glimmer-dsl-css](https://github.com/AndyObtiva/glimmer-dsl-css): Glimmer DSL for CSS (Cascading Style Sheets)
@@ -61,6 +66,8 @@ Afterwards, if you open `irb`, you should be able to run `require 'tk'` successf
 
 Run this command to install directly:
 ```
+gem install logging
+gem install super_module
 gem install glimmer-dsl-tk
 ```
 
@@ -68,7 +75,9 @@ gem install glimmer-dsl-tk
 
 Add the following to `Gemfile`:
 ```
-gem 'glimmer-dsl-tk', '~> 0.0.2'
+gem 'logging'
+gem 'super_module'
+gem 'glimmer-dsl-tk', '~> 0.0.3'
 ```
 
 And, then run:
@@ -99,7 +108,7 @@ The Glimmer GUI DSL provides a declarative syntax for [Tk](https://www.tcl.tk/)
 The Glimmer GUI DSL follows these simple concepts in mapping from Tk syntax:
 - **Widget Keyword**: Any Tk widget (e.g. `Tk::Tile::Label`) or toplevel window (e.g. `TkRoot`) may be declared by its lower-case underscored name without the namespace (e.g. `label` or `root`). This is called a keyword and is represented in the Glimmer GUI DSL by a Ruby method behind the scenes.
 - **Args**: Any keyword method may optionally take arguments surrounded by parentheses (e.g. a `frame` nested under a `notebook` may receive tab options like `frame(text: 'Users')`, which gets used behind the scenes by Tk code such as `notebook.add tab, text: 'Users'`)
-- **Content/Options Block**: Any keyword may optionally be followed by a Ruby curly-brace block 
+- **Content/Options Block**: Any keyword may optionally be followed by a Ruby curly-brace block containing nested widgets (content) and attributes (options). Attributes are simply Tk option keywords followed by arguments and no block (e.g. `title 'Hello, World!'` under a `root`)
 
 Example of an app written in [Tk](https://www.tcl.tk/) imperative syntax:
 
@@ -144,6 +153,46 @@ root {
 }.open
 ```
 
+### Bidirectional Data-Binding
+
+Glimmer supports bidirectional data-binding via the `bind` keyword, which takes a model and an attribute.
+
+Example:
+
+This assumes a `Person` model with a `country` attribute representing their current country and a `country_options` attribute representing available options for the country attribute.
+
+```ruby
+  combobox { |proxy|
+    state 'readonly'       
+    text bind(person, :country)
+  }
+```
+
+That binds the `text` selection of the `combobox` to the `country` property on the `person` model.
+
+It automatically handles all the Tk plumbing behind the scenes, such as using `TkVariable` and setting `combobox` `values` from `person.country_options` by convention (attribute_name + "_options").
+
+More details can be found in the [Hello, Combo!](#hello-combo) sample below.
+
+### Command
+
+Buttons can set a `command` option to trigger when the user clicks the button. This may be done with the `command` keyword, passing in a block directly (no need for `proc` as per Tk)
+
+Example:
+
+```ruby
+  button { |proxy|
+    text "Reset Selection"
+    command {
+      person.reset_country
+    }
+  }
+```
+
+This resets the person country.
+
+More details can be found in the [Hello, Combo!](#hello-combo) sample below.
+
 ## Samples
 
 ### Hello, World!
@@ -151,6 +200,8 @@ root {
 Glimmer code (from [samples/hello/hello_world.rb](samples/hello/hello_world.rb)):
 
 ```ruby
+include Glimmer
+
 root {
   label {
     text 'Hello, World!'
@@ -161,7 +212,7 @@ root {
 Run (with the [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed):
 
 ```
-ruby -e "gem 'glimmer-dsl-tk'; require '../samples/hello/hello_world.rb'"
+ruby -r glimmer-dsl-tk -e "require '../samples/hello/hello_world.rb'"
 ```
 
 Glimmer app:
@@ -173,6 +224,8 @@ Glimmer app:
 Glimmer code (from [samples/hello/hello_tab.rb](samples/hello/hello_tab.rb)):
 
 ```ruby
+include Glimmer
+
 root {      
   title 'Hello, Tab!'
    
@@ -195,7 +248,7 @@ root {
 Run (with the [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed):
 
 ```
-ruby -e "gem 'glimmer-dsl-tk'; require '../samples/hello/hello_tab.rb'"
+ruby -r glimmer-dsl-tk -e "require '../samples/hello/hello_tab.rb'"
 ```
 
 Glimmer app:
@@ -203,6 +256,41 @@ Glimmer app:
 ![glimmer dsl tk screenshot sample hello tab English](images/glimmer-dsl-tk-screenshot-sample-hello-tab-english.png)
 ![glimmer dsl tk screenshot sample hello tab French](images/glimmer-dsl-tk-screenshot-sample-hello-tab-french.png)
 
+### Hello, Combo!
+
+Glimmer code (from [samples/hello/hello_combo.rb](samples/hello/hello_combo.rb)):
+
+```ruby
+# ... more code precedes
+root {
+  title 'Hello, Combo!'
+  
+  combobox { |proxy|
+    state 'readonly'       
+    text bind(person, :country)
+  }
+  
+  button { |proxy|
+    text "Reset Selection"
+    command {
+      person.reset_country
+    }
+  }
+}.open
+# ... more code follows
+```
+
+Run (with the [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed):
+
+```
+ruby -r glimmer-dsl-tk -e "require '../samples/hello/hello_combo.rb'"
+```
+
+Glimmer app:
+
+![glimmer dsl tk screenshot sample hello combo](images/glimmer-dsl-tk-screenshot-sample-hello-combo.png)
+![glimmer dsl tk screenshot sample hello combo dropdown](images/glimmer-dsl-tk-screenshot-sample-hello-combo-dropdown.png)
+
 ## Help
 
 ### Issues

data/VERSION

@@ -1 +1 @@
-0.0.2
+0.0.3

data/lib/glimmer-dsl-tk.rb

@@ -23,9 +23,9 @@ $LOAD_PATH.unshift(File.expand_path('..', __FILE__))
 
 # External requires
 require 'glimmer'
-require 'logging'
+# require 'logging'
 require 'puts_debuggerer' if ENV['pd'].to_s.downcase == 'true'
-require 'super_module'
+# require 'super_module'
 require 'tk'
 
 # Internal requires

data/lib/glimmer/data_binding/tk/widget_binding.rb

@@ -0,0 +1,28 @@
+require 'glimmer/data_binding/observable'
+require 'glimmer/data_binding/observer'
+
+module Glimmer
+  module DataBinding
+    module Tk
+      class WidgetBinding
+        include Glimmer
+        include Observable
+        include Observer
+  
+        attr_reader :widget, :attribute
+        def initialize(widget, attribute)
+          @widget = widget
+          @attribute = attribute  
+        end
+        
+        def call(value)
+          @widget.set_attribute(@attribute, value) unless evaluate_attribute == value
+        end
+        
+        def evaluate_attribute
+          @widget.get_attribute(@attribute)
+        end
+      end
+    end
+  end
+end

data/lib/glimmer/dsl/tk/bind_expression.rb

@@ -0,0 +1,36 @@
+require 'glimmer/dsl/static_expression'
+require 'glimmer/data_binding/model_binding'
+
+module Glimmer
+  module DSL
+    module Tk
+      # Responsible for setting up the return value of the bind keyword (command symbol)
+      # as a ModelBinding. It is then used by another command handler like
+      # DataBindingCommandHandler for text and other attributes
+      class BindExpression < StaticExpression
+        def can_interpret?(parent, keyword, *args, &block)
+          (
+            keyword == 'bind' and
+              (
+                (
+                  (args.size == 2) and
+                    textual?(args[1])
+                ) ||
+                  (
+                    (args.size == 3) and
+                      textual?(args[1]) and
+                      (args[2].is_a?(Hash))
+                  )
+              )
+          )
+        end
+  
+        def interpret(parent, keyword, *args, &block)
+          binding_options = args[2] || {}
+          binding_options[:on_read] = binding_options.delete(:on_read) || binding_options.delete('on_read') || block
+          DataBinding::ModelBinding.new(args[0], args[1].to_s, binding_options)
+        end
+      end
+    end
+  end
+end

data/lib/glimmer/dsl/tk/block_attribute_expression.rb

@@ -0,0 +1,41 @@
+# Copyright (c) 2020 Andy Maleh
+# 
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+# 
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'glimmer/dsl/expression'
+
+module Glimmer
+  module DSL
+    module Tk
+      class BlockAttributeExpression < Expression
+        def can_interpret?(parent, keyword, *args, &block)
+          block_given? and
+            args.size == 0 and
+            parent.respond_to?("#{keyword}_block=")
+        end
+  
+        def interpret(parent, keyword, *args, &block)
+          parent.send("#{keyword}_block=", block)
+          nil
+        end
+      end
+    end
+  end
+end

data/lib/glimmer/dsl/tk/data_binding_expression.rb

@@ -0,0 +1,32 @@
+require 'glimmer/dsl/expression'
+require 'glimmer/data_binding/model_binding'
+require 'glimmer/data_binding/tk/widget_binding'
+
+module Glimmer
+  module DSL
+    module Tk
+      # Responsible for wiring two-way data-binding.
+      # Does so by using the output of the bind(model, property) command in the form
+      # of a ModelBinding, which is then connected to an anonymous widget observer
+      #
+      # Depends on BindCommandHandler
+      class DataBindingExpression < Expression
+        def can_interpret?(parent, keyword, *args, &block)
+          args.size == 1 and
+            args[0].is_a?(DataBinding::ModelBinding)
+        end
+  
+        def interpret(parent, keyword, *args, &block)
+          model_binding = args[0]
+          widget_binding_parameters = [parent, keyword]
+          widget_binding = DataBinding::Tk::WidgetBinding.new(*widget_binding_parameters)
+          widget_binding.call(model_binding.evaluate_property)
+          #TODO make this options observer dependent and all similar observers in widget specific data binding handlers
+          widget_binding.observe(model_binding)
+          # TODO simplify this logic and put it where it belongs
+          parent.add_observer(model_binding, keyword) if parent.respond_to?(:add_observer, [model_binding, keyword])
+        end        
+      end
+    end
+  end
+end

data/lib/glimmer/dsl/tk/dsl.rb

@@ -36,6 +36,8 @@ module Glimmer
       Engine.add_dynamic_expressions(
         Tk,
         %w[
+          data_binding
+          block_attribute
           attribute
           widget
         ]

data/lib/glimmer/dsl/tk/widget_expression.rb

@@ -33,7 +33,7 @@ module Glimmer
   
         def can_interpret?(parent, keyword, *args, &block)
           !EXCLUDED_KEYWORDS.include?(keyword) and
-            parent.respond_to?(:tk_widget) and
+            parent.respond_to?(:tk) and
             Glimmer::Tk::WidgetProxy.widget_exists?(keyword)
         end
   
@@ -54,3 +54,4 @@ end
 require 'glimmer/tk/widget_proxy'
 require 'glimmer/tk/notebook_proxy'
 require 'glimmer/tk/frame_proxy'
+require 'glimmer/tk/button_proxy'

data/lib/glimmer/tk/button_proxy.rb

@@ -0,0 +1,35 @@
+# Copyright (c) 2020 Andy Maleh
+# 
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+# 
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'glimmer/tk/widget_proxy'
+
+module Glimmer
+  module Tk    
+    # Proxy for Tk::Tile::Button
+    #
+    # Follows the Proxy Design Pattern
+    class ButtonProxy < WidgetProxy
+      def command_block=(proc)
+        tk.command(proc)
+      end
+    end
+  end
+end

data/lib/glimmer/tk/notebook_proxy.rb

@@ -38,7 +38,7 @@ module Glimmer
     
       def post_initialize_child(child)
         @tab_proxies << child
-        @tk_widget.add child.tk_widget, child.tab_options
+        @tk.add child.tk, child.tab_options
       end
     end
   end

data/lib/glimmer/tk/root_proxy.rb

@@ -29,7 +29,7 @@ module Glimmer
     class RootProxy < WidgetProxy
 
       def initialize(*args)
-        @tk_widget = ::TkRoot.new
+        @tk = ::TkRoot.new
       end
 
       def open
@@ -37,7 +37,7 @@ module Glimmer
       end
 
       def content(&block)
-        Glimmer::DSL::Engine.add_content(self, Glimmer::DSL::SWT::RootExpression.new, &block)
+        Glimmer::DSL::Engine.add_content(self, Glimmer::DSL::Tk::RootExpression.new, &block)
       end
 
       # Starts Tk mainloop

data/lib/glimmer/tk/widget_proxy.rb

@@ -25,17 +25,11 @@ module Glimmer
     #
     # Follows the Proxy Design Pattern
     class WidgetProxy
-      attr_reader :parent_proxy, :tk_widget, :args
+      attr_reader :parent_proxy, :tk, :args
 
       DEFAULT_INITIALIZERS = {
-        'label' => lambda do |widget|
-          widget.grid
-        end,
-        'frame' => lambda do |widget|
-          widget.grid
-        end,
-        'notebook' => lambda do |widget|
-          widget.grid
+        'combobox' => lambda do |tk|
+          tk.textvariable = ::TkVariable.new          
         end,
       }
       
@@ -61,8 +55,15 @@ module Glimmer
         @parent_proxy = parent_proxy
         @args = args
         tk_widget_class = self.class.tk_widget_class_for(underscored_widget_name)
-        @tk_widget = tk_widget_class.new(@parent_proxy.tk_widget, *args)
-        DEFAULT_INITIALIZERS[underscored_widget_name]&.call(@tk_widget)        
+        @tk = tk_widget_class.new(@parent_proxy.tk, *args)
+        begin
+          # a common widget initializer
+          @tk.grid
+        rescue => e
+          # catching error just in case a widget doesn't support it
+          Glimmer::Config.logger.debug e.full_message
+        end
+        DEFAULT_INITIALIZERS[underscored_widget_name]&.call(@tk)        
         @parent_proxy.post_initialize_child(self)
       end
       
@@ -97,7 +98,7 @@ module Glimmer
         result = nil
         begin     
           # TK Widget currently doesn't support respond_to? properly, so I have to resort to this trick for now   
-          @tk_widget.send(attribute_setter(attribute_name), @tk_widget.send(attribute_name))
+          @tk.send(attribute_setter(attribute_name), @tk.send(attribute_name))
           result = true
         rescue => e
           result = false
@@ -110,35 +111,77 @@ module Glimmer
       end
 
       def set_attribute(attribute_name, *args)
-        if tk_widget_has_attribute?(attribute_name)
-          @tk_widget.send(attribute_setter(attribute_name), *args) unless @tk_widget.send(attribute_name) == args.first
+        widget_custom_attribute = widget_custom_attribute_mapping[tk.class] && widget_custom_attribute_mapping[tk.class][attribute_name.to_s]
+        if widget_custom_attribute
+          widget_custom_attribute[:setter][:invoker].call(@tk, args)
+        elsif tk_widget_has_attribute?(attribute_name)
+          @tk.send(attribute_setter(attribute_name), *args) unless @tk.send(attribute_name) == args.first
         else
           send(attribute_setter(attribute_name), args)
         end
       end
 
       def get_attribute(attribute_name)
-        @tk_widget.send(attribute_name)
+        widget_custom_attribute = widget_custom_attribute_mapping[tk.class] && widget_custom_attribute_mapping[tk.class][attribute_name.to_s]
+        if widget_custom_attribute
+          widget_custom_attribute[:getter][:invoker].call(@tk, args)
+        else
+          @tk.send(attribute_name)
+        end
       end      
 
       def attribute_setter(attribute_name)
         "#{attribute_name}="
       end
+      
+      def widget_custom_attribute_mapping
+        @widget_custom_attribute_mapping ||= {
+          ::Tk::Tile::TCombobox => {
+            'text' => {
+              getter: {name: 'text', invoker: lambda { |widget, args| @tk.textvariable&.value }},
+              setter: {name: 'text=', invoker: lambda { |widget, args| @tk.textvariable&.value = args.first }},
+            },
+          },
+        }
+      end
+      
+      def widget_property_listener_installers
+        @tk_widget_property_listener_installers ||= {
+          ::Tk::Tile::TCombobox => {
+            :text => lambda do |observer|
+              if observer.is_a?(Glimmer::DataBinding::ModelBinding)
+                model = observer.model
+                options_model_property = observer.property_name + '_options'
+                @tk.values = model.send(options_model_property) if model.respond_to?(options_model_property)
+              end
+              @tk.bind('<ComboboxSelected>') {
+                observer.call(@tk.textvariable.value)
+              }
+            end,
+          }
+        }
+      end
+      
+      def add_observer(observer, property_name)
+        property_listener_installers = @tk.class.ancestors.map {|ancestor| widget_property_listener_installers[ancestor]}.compact
+        widget_listener_installers = property_listener_installers.map{|installer| installer[property_name.to_s.to_sym]}.compact if !property_listener_installers.empty?
+        widget_listener_installers.to_a.first&.call(observer)
+      end      
 
       def content(&block)
         Glimmer::DSL::Engine.add_content(self, Glimmer::DSL::Tk::WidgetExpression.new, &block)
       end
 
       def method_missing(method, *args, &block)
-        tk_widget.send(method, *args, &block)
+        tk.send(method, *args, &block)
       rescue => e
-        Glimmer::Config.logger.debug {"Neither WidgetProxy nor #{tk_widget.class.name} can handle the method ##{method}"}
+        Glimmer::Config.logger.debug {"Neither WidgetProxy nor #{tk.class.name} can handle the method ##{method}"}
         super
       end
       
       def respond_to?(method, *args, &block)
         super || 
-          tk_widget.respond_to?(method, *args, &block)
+          tk.respond_to?(method, *args, &block)
       end
     end
   end

data/samples/hello/hello_combo.rb

@@ -0,0 +1,40 @@
+require 'glimmer-dsl-tk'
+
+class Person 
+  attr_accessor :country, :country_options
+
+  def initialize   
+    self.country_options=["", "Canada", "US", "Mexico"]
+    self.country = "Canada"
+  end
+
+  def reset_country
+    self.country = "Canada"
+  end
+end
+
+class HelloCombo
+  include Glimmer
+  
+  def launch
+    person = Person.new
+    
+    root {
+      title 'Hello, Combo!'
+      
+      combobox { |proxy|
+        state 'readonly'       
+        text bind(person, :country)
+      }
+      
+      button { |proxy|
+        text "Reset Selection"
+        command {
+          person.reset_country
+        }
+      }
+    }.open
+  end
+end
+
+HelloCombo.new.launch

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glimmer-dsl-tk
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
-- andy_maleh
+- AndyMaleh
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-09-11 00:00:00.000000000 Z
+date: 2020-09-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: glimmer
@@ -24,20 +24,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.10.3
-- !ruby/object:Gem::Dependency
-  name: puts_debuggerer
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.10.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.10.0
 - !ruby/object:Gem::Dependency
   name: tk
   requirement: !ruby/object:Gem::Requirement
@@ -94,20 +80,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '1.0'
-- !ruby/object:Gem::Dependency
-  name: simplecov
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: jeweler
   requirement: !ruby/object:Gem::Requirement
@@ -142,6 +114,62 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 0.2.1
+- !ruby/object:Gem::Dependency
+  name: puts_debuggerer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.8.23
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.8.23
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.16.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.16.1
+- !ruby/object:Gem::Dependency
+  name: simplecov-lcov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.0
 description: Glimmer DSL for Tk (Ruby Desktop GUI)
 email: andy.am@gmail.com
 executables: []
@@ -156,14 +184,20 @@ files:
 - README.md
 - VERSION
 - lib/glimmer-dsl-tk.rb
+- lib/glimmer/data_binding/tk/widget_binding.rb
 - lib/glimmer/dsl/tk/attribute_expression.rb
+- lib/glimmer/dsl/tk/bind_expression.rb
+- lib/glimmer/dsl/tk/block_attribute_expression.rb
+- lib/glimmer/dsl/tk/data_binding_expression.rb
 - lib/glimmer/dsl/tk/dsl.rb
 - lib/glimmer/dsl/tk/root_expression.rb
 - lib/glimmer/dsl/tk/widget_expression.rb
+- lib/glimmer/tk/button_proxy.rb
 - lib/glimmer/tk/frame_proxy.rb
 - lib/glimmer/tk/notebook_proxy.rb
 - lib/glimmer/tk/root_proxy.rb
 - lib/glimmer/tk/widget_proxy.rb
+- samples/hello/hello_combo.rb
 - samples/hello/hello_tab.rb
 - samples/hello/hello_world.rb
 homepage: http://github.com/AndyObtiva/glimmer-dsl-tk