glimmer-dsl-wx 0.0.7 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d67fb5f483b55ca655215bf87926ae501dd680b4ffeebbfe02756b257398d4f3
-  data.tar.gz: fffd53b54fba50092ea146df9bb90b268f333cc903a29b6178e9cc80217b9d3a
+  metadata.gz: 29fe9921216dd94b4784192eebb73db6125697148b8c617f05f41dc919b55f59
+  data.tar.gz: 1b1299da11273e591436920f6c3dd3d495f6b9941602144f5968ba79ffc1623a
 SHA512:
-  metadata.gz: 9e1544b9b4dedfc9f99b31833982642bba382e69b857957a6647aecc8e93ae8d7a7d60af5a6c7f0cdff858ef555c3d7a5b12536a61ce3ba49322051f39ed17fe
-  data.tar.gz: 402553fc0c1462d0f7e20d9931d894347739f9d9229bb1616731ec42897ba45a5e2a37f7ca54f8c06514a726e48cc4f1e4a1e9e2cd641aa810b5b0d793e12046
+  metadata.gz: 94a29ba03eb985c4ef98abc95e60734d711f2282322d0b4b0bed0bf9e78f947f91c2c45636ae21fcd73bfbc5b7ca89e3b5477c562312166193562c6a3f15ef76
+  data.tar.gz: 4c6b627cc677c733d921d860d1e8b466ff21d8eaac654f3e7f530067939a5fb0bb7d7bf095a35d6b15da26f93402a2d55d46fbfa3219d71868c45b2f8dde2fd3

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Change Log
 
+## 0.1.0
+
+- Upgrade to wxruby3 1.0.0
+- Upgrade to glimmer 2.7.7
+- Support control operations (methods) in the DSL
+- Improve detection of property setter methods on controls when invoking from DSL
+- Support property unidirectional data-binding for all controls
+- Support property bidirectional data-binding for text_ctrl
+- Support property bidirectional data-binding for spin_ctrl
+- Support property bidirectional data-binding for spin_ctrl_double
+- Support property bidirectional data-binding for slider
+- Hello, Data-Binding! Sample
+
 ## 0.0.7
 
 - Sizer addable support (e.g. supporting `growable_col(1, 1)`, using `add_growable_col(1, 1)` method in wxruby3 API)

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2023 Andy Maleh
+Copyright (c) 2023-2024 Andy Maleh
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -1,10 +1,12 @@
-# [<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 WX 0.0.7
+# [<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 WX 0.1.0
 ## wxWidgets Ruby Desktop Development GUI Library
 [![Gem Version](https://badge.fury.io/rb/glimmer-dsl-wx.svg)](https://badge.fury.io/rb/glimmer-dsl-wx)
 [![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 [WX](https://www.wxwidgets.org/) is an [MRI Ruby](https://www.ruby-lang.org) desktop development GUI (Graphical User Interface) library for the cross-platform native widget [wxWidgets](https://www.wxwidgets.org/) GUI toolkit. It provides a Glimmer GUI DSL on top of the [wxruby3](https://github.com/mcorino/wxRuby3) binding.
 
+![Hello, Data-Binding!](/screenshots/glimmer-dsl-wx-sample-hello-data-binding.gif?raw=true)
+
 [Glimmer DSL for WX](https://rubygems.org/gems/glimmer-dsl-wx) aims to provide a DSL similar to the [Glimmer DSL for SWT](https://github.com/AndyObtiva/glimmer-dsl-swt) to enable more productive desktop development in Ruby with:
 - [Declarative DSL syntax](#glimmer-gui-dsl-concepts) that visually maps to the GUI control hierarchy
 - [Convention over configuration](#smart-defaults-and-conventions) via smart defaults and automation of low-level details
@@ -24,7 +26,7 @@ include Glimmer
 frame(title: 'Hello, World!')
 ```
 
-![Hello, World!](https://github.com/AndyObtiva/glimmer-dsl-wx/blob/master/screenshots/glimmer-dsl-wx-sample-hello-world.png?raw=true)
+![Hello, World!](/screenshots/glimmer-dsl-wx-sample-hello-world.png?raw=true)
 
 **Hello Button!**
 
@@ -54,35 +56,25 @@ frame { |main_frame|
 }
 ```
 
-![Hello, Button!](https://github.com/AndyObtiva/glimmer-dsl-wx/blob/master/screenshots/glimmer-dsl-wx-sample-hello-button.png?raw=true)
-
-![Hello, Button! Clicked](https://github.com/AndyObtiva/glimmer-dsl-wx/blob/master/screenshots/glimmer-dsl-wx-sample-hello-button-clicked.png?raw=true)
-
-**[Glimmer](https://rubygems.org/gems/glimmer) DSL Comparison Table:**
-DSL | Platforms | Native? | Vector Graphics? | Pros | Cons | Prereqs
-----|-----------|---------|------------------|------|------|--------
-[Glimmer DSL for SWT (JRuby Desktop Development GUI Framework)](https://github.com/AndyObtiva/glimmer-dsl-swt) | Mac / Windows / Linux | Yes | Yes (Canvas Shape DSL) | Very Mature / Scaffolding / Native Executable Packaging / Custom Widgets | Slow JRuby Startup Time / Heavy Memory Footprint | Java / JRuby
-[Glimmer DSL for Opal (Pure Ruby Web GUI and Auto-Webifier of Desktop Apps)](https://github.com/AndyObtiva/glimmer-dsl-opal) | All Web Browsers | No | Yes (Canvas Shape DSL) | Simpler than All JavaScript Technologies / Auto-Webify Desktop Apps | Setup Process / Only Rails 5 Support for Now | Rails
-[Glimmer DSL for LibUI (Prerequisite-Free Ruby Desktop Development GUI Library)](https://github.com/AndyObtiva/glimmer-dsl-libui) | Mac / Windows / Linux | Yes | Yes (Area API) | Fast Startup Time / Light Memory Footprint | LibUI is an Incomplete Mid-Alpha Only | None Other Than MRI Ruby
-[Glimmer DSL for Tk (Ruby Tk Desktop Development GUI Library)](https://github.com/AndyObtiva/glimmer-dsl-tk) | Mac / Windows / Linux | Some Native-Themed Widgets (Not Truly Native) | Yes (Canvas) | Fast Startup Time / Light Memory Footprint | Complicated Setup / Widgets Do Not Look Truly Native, Espcially on Linux | ActiveTcl / MRI Ruby
-[Glimmer DSL for GTK (Ruby-GNOME Desktop Development GUI Library)](https://github.com/AndyObtiva/glimmer-dsl-gtk) | Mac / Windows / Linux | Only on Linux | Yes (Cairo) | Complete Access to GNOME Features on Linux (Forte) | Not Native on Mac and Windows | None Other Than MRI Ruby on Linux / Brew Packages on Mac / MSYS & MING Toolchains on Windows / MRI Ruby
-[Glimmer DSL for FX (FOX Toolkit Ruby Desktop Development GUI Library)](https://github.com/AndyObtiva/glimmer-dsl-fx) | Mac (requires XQuartz) / Windows / Linux | No | Yes (Canvas) | No Prerequisites on Windows (Forte Since Binaries Are Included Out of The Box) | Widgets Do Not Look Native / Mac Usage Obtrusively Starts XQuartz | None Other Than MRI Ruby on Windows / XQuarts on Mac / MRI Ruby
-[Glimmer DSL for WX (wxWidgets Ruby Desktop Development GUI Library)](https://github.com/AndyObtiva/glimmer-dsl-wx) | Mac / Windows / Linux | Yes | Yes | Fast Startup Time / Light Memory Footprint | wxruby3 is still beta and does not support Mac yet | wxWidgets library, Doxygen, and other prereqs
-[Glimmer DSL for JFX (JRuby JavaFX Desktop Development GUI Library)](https://github.com/AndyObtiva/glimmer-dsl-jfx) | Mac / Windows / Linux | No | Yes (javafx.scene.shape and javafx.scene.canvas) | Rich in Custom Widgets | Slow JRuby Startup Time / Heavy Memory Footprint / Widgets Do Not Look Native | Java / JRuby / JavaFX SDK
-[Glimmer DSL for Swing (JRuby Swing Desktop Development GUI Library)](https://github.com/AndyObtiva/glimmer-dsl-swing) | Mac / Windows / Linux | No | Yes (Java2D) | Very Mature | Slow JRuby Startup Time / Heavy Memory Footprint / Widgets Do Not Look Native | Java / JRuby
-[Glimmer DSL for XML (& HTML)](https://github.com/AndyObtiva/glimmer-dsl-xml) | All Web Browsers | No | Yes (SVG) | Programmable / Lighter-weight Than Actual XML | XML Elements Are Sometimes Not Well-Named (Many Types of Input) | None
-[Glimmer DSL for CSS](https://github.com/AndyObtiva/glimmer-dsl-css) | All Web Browsers | No | Yes | Programmable | CSS Is Over-Engineered / Too Many Features To Learn | None
+![Hello, Button!](/screenshots/glimmer-dsl-wx-sample-hello-button.png?raw=true)
+
+![Hello, Button! Clicked](/screenshots/glimmer-dsl-wx-sample-hello-button-clicked.png?raw=true)
+
+Learn more about the differences between various [Glimmer](https://github.com/AndyObtiva/glimmer) DSLs by looking at the **[Glimmer DSL Comparison Table](https://github.com/AndyObtiva/glimmer#glimmer-dsl-comparison-table)**.
 
 ## Table of Contents
 
 - [Glimmer DSL for WX](#)
   - [Setup](#setup)
+  - [Usage](#usage)
   - [GIRB (Glimmer IRB)](#girb-glimmer-irb)
   - [Smart Defaults and Conventions](#smart-defaults-and-conventions)
   - [Samples](#samples)
     - [Hello, World!](#hello-world)
     - [Hello, Button!](#hello-button)
     - [Hello, Sizer!](#hello-sizer)
+    - [Hello, Data-Binding!](#hello-data-binding)
+  - [Coming From wxruby3](#coming-from-wxruby3)
   - [Process](#process)
   - [Resources](#resources)
   - [Help](#help)
@@ -108,7 +100,7 @@ gem install glimmer-dsl-wx
 Or install via Bundler `Gemfile`:
 
 ```ruby
-gem 'glimmer-dsl-wx', '~> 0.0.7'
+gem 'glimmer-dsl-wx', '~> 0.1.0'
 ```
 
 Test that installation worked by running a sample:
@@ -123,6 +115,127 @@ If you cloned project, test by running a sample locally:
 ruby -r ./lib/glimmer-dsl-wx.rb samples/hello/hello_world.rb
 ```
 
+## Usage
+
+To use [glimmer-dsl-wx](https://rubygems.org/gems/glimmer-dsl-wx):
+1. Add `require 'glimmer-dsl-wx'` at the top of the Ruby file (this will automatically `require 'wxruby3'` too)
+2. Add `include Glimmer` into the top-level main object for testing or into an actual class for serious application usage.
+3. Write GUI DSL code beginning with `frame` to build a window first and then nest other controls/sizers within it.
+
+Example:
+
+```ruby
+require 'glimmer-dsl-wx'
+
+include Glimmer
+
+frame { |main_frame|
+  title 'Hello, Button!'
+  
+  h_box_sizer {
+    button {
+      sizer_args 0, Wx::RIGHT, 10
+      label 'Click To Find Who Built This!'
+      
+      on_button do
+        message_dialog(
+          "The Glimmer DSL for WX Team",
+          "Greeting",
+          Wx::OK | Wx::ICON_INFORMATION
+        ).show_modal
+      end
+    }
+  }
+}
+```
+
+![Hello, Button!](/screenshots/glimmer-dsl-wx-sample-hello-button.png?raw=true)
+
+Glimmer DSL for WX follows these simple concepts in mapping from wxruby3 syntax to Glimmer GUI DSL syntax:
+
+**Keyword(args)**: wxruby3 controls/sizers may be declared by lower-case underscored name. For example, `Frame` becomes `frame`. `HBoxSizer` becomes `h_box_sizer`. And, they receive the same arguments as the wxruby3 class constructor. For example, `Frame.new(title: 'Hello')` becomes `frame(title: 'Hello')`.
+
+**Content Block** (Properties/Listeners/Controls): Any keyword may be optionally followed by a declarative Ruby curly-brace multi-line content block containing properties (attributes), listeners, and/or nested controls/sizers.
+
+Example:
+
+```ruby
+frame(title: 'Hello, Button') {
+  h_box_sizer {
+    button(label: 'Click To Find Who Built This!')
+  }
+}
+```
+
+Content block optionally receives one arg representing the control or sizer it represents.
+
+Example:
+
+```ruby
+frame(title: 'Hello, Button!') { |main_frame|
+  h_box_sizer {
+    button {
+      sizer_args 0, Wx::RIGHT, 10
+      label 'Click To Find Who Built This!'
+      
+      on_button do
+        about_box(
+          name: main_frame.title,
+          version: Wx::WXRUBY_VERSION,
+          description: "This is the Hello, Button! sample",
+          developers: ['The Glimmer DSL for WX Development Team']
+        )
+      end
+    }
+  }
+}
+```
+
+**Property**: Control properties may be declared inside keyword blocks with lower-case underscored name followed by property value args (e.g. `title "Hello"` inside `frame`). Behind the scenes, properties correspond to `control.property=` methods like `frame.title=`.
+
+Controls and sizers (objects that organize controls within certain layouts) could accept a special `sizer_args` property, which takes the arguments normally passed to the `sizer.add` method. For example, `sizer_args 0, Wx::RIGHT, 10` translates to `sizer.add(control, 0, Wx::Right, 10)` behind the scenes.
+
+**Listener**: Control listeners may be declared inside keyword blocks with listener lower-case underscored name beginning with `on_` followed by event name (translates to `frame.evt_#{event_name}` like `frame.evt_button` for the click of a button) and receiving required block handler (always followed by a `do; end` style block to signify imperative Model logic vs declarative View control/sizer nesting).
+
+Example:
+
+```ruby
+button('click') {
+  on_clicked do
+    puts 'clicked'
+  end
+}
+```
+
+Optionally, the listener block can receive an arg representing the control.
+
+```ruby
+...
+    button {
+      sizer_args 0, Wx::RIGHT, 10
+      label 'Click To Find Who Built This!'
+      
+      on_button do
+        # Do work!
+      end
+    }
+...
+```
+
+Behind the scenes, listeners correspond to `frame.evt_#{event_name}` methods. So, for `on_button`, the event name is `button`, and that translates to `frame.evt_button(button, &listener)` behind the scenes.
+
+**Operation**: Controls have methods that invoke certain operations on them. For example, `message_dialog` has a `#show_modal` method that shows the message dialog GUI.
+
+```ruby
+...
+        message_dialog(
+          "The Glimmer DSL for WX Team",
+          "Greeting",
+          Wx::OK | Wx::ICON_INFORMATION
+        ).show_modal
+...
+```
+
 ## GIRB (Glimmer IRB)
 
 You can run the `girb` command (`bin/girb` if you cloned the project locally) to do some quick and dirty experimentation and learning:
@@ -142,7 +255,7 @@ This gives you `irb` with the `glimmer-dsl-wx` gem loaded and the `Glimmer` modu
 
 ### Hello, World!
 
-![Hello, World!](https://github.com/AndyObtiva/glimmer-dsl-wx/blob/master/screenshots/glimmer-dsl-wx-sample-hello-world.png?raw=true)
+![Hello, World!](/screenshots/glimmer-dsl-wx-sample-hello-world.png?raw=true)
 
 ```ruby
 require 'glimmer-dsl-wx'
@@ -166,9 +279,9 @@ frame {
 
 ### Hello Button!
 
-![Hello, Button!](https://github.com/AndyObtiva/glimmer-dsl-wx/blob/master/screenshots/glimmer-dsl-wx-sample-hello-button.png?raw=true)
+![Hello, Button!](/screenshots/glimmer-dsl-wx-sample-hello-button.png?raw=true)
 
-![Hello, Button! Clicked](https://github.com/AndyObtiva/glimmer-dsl-wx/blob/master/screenshots/glimmer-dsl-wx-sample-hello-button-clicked.png?raw=true)
+![Hello, Button! Clicked](/screenshots/glimmer-dsl-wx-sample-hello-button-clicked.png?raw=true)
 
 ```ruby
 require 'glimmer-dsl-wx'
@@ -223,9 +336,9 @@ frame { |main_frame|
 
 ### Hello Sizer!
 
-![Hello, Sizer!](https://github.com/AndyObtiva/glimmer-dsl-wx/blob/master/screenshots/glimmer-dsl-wx-sample-sizer-button.png?raw=true)
+![Hello, Sizer!](/screenshots/glimmer-dsl-wx-sample-hello-sizer.png?raw=true)
 
-![Hello, Sizer! Clicked](https://github.com/AndyObtiva/glimmer-dsl-wx/blob/master/screenshots/glimmer-dsl-wx-sample-hello-sizer-clicked.png?raw=true)
+![Hello, Sizer! Clicked](/screenshots/glimmer-dsl-wx-sample-hello-sizer-clicked.png?raw=true)
 
 ```ruby
 require 'glimmer-dsl-wx'
@@ -246,7 +359,7 @@ frame { |main_frame|
         on_button do
           message_dialog(
             "Hello",
-            "Greeting",
+            "Greeting 1",
             Wx::OK | Wx::ICON_INFORMATION
           ).show_modal
         end
@@ -261,7 +374,7 @@ frame { |main_frame|
         on_button do
           message_dialog(
             "Howdy",
-            "Greeting",
+            "Greeting 2",
             Wx::OK | Wx::ICON_INFORMATION
           ).show_modal
         end
@@ -276,7 +389,7 @@ frame { |main_frame|
         on_button do
           message_dialog(
             "Hi",
-            "Greeting",
+            "Greeting 3",
             Wx::OK | Wx::ICON_INFORMATION
           ).show_modal
         end
@@ -293,7 +406,7 @@ frame { |main_frame|
         on_button do
           message_dialog(
             "Ciao",
-            "Greeting",
+            "Greeting 4",
             Wx::OK | Wx::ICON_INFORMATION
           ).show_modal
         end
@@ -308,7 +421,7 @@ frame { |main_frame|
         on_button do
           message_dialog(
             "Aloha",
-            "Greeting",
+            "Greeting 5",
             Wx::OK | Wx::ICON_INFORMATION
           ).show_modal
         end
@@ -323,7 +436,7 @@ frame { |main_frame|
         on_button do
           message_dialog(
             "Salut",
-            "Greeting",
+            "Greeting 6",
             Wx::OK | Wx::ICON_INFORMATION
           ).show_modal
         end
@@ -333,6 +446,165 @@ frame { |main_frame|
 }
 ```
 
+### Hello Data-Binding!
+
+Glimmer DSL for WX supports data-binding via `<=` for unidirectional data-binding and `<=>` for bidirectional data-binding.
+
+![Hello, Data-Binding!](/screenshots/glimmer-dsl-wx-sample-hello-data-binding.gif?raw=true)
+
+```ruby
+require 'glimmer-dsl-wx'
+
+class Donor
+  DONATION_AMOUNT_MIN = 0
+  DONATION_AMOUNT_MAX = 100
+  DONATION_AMOUNT_DEFAULT = 50
+  
+  attr_accessor :first_name, :last_name, :donation_amount
+  
+  def initialize
+    @last_name = @first_name = ''
+    @donation_amount = DONATION_AMOUNT_DEFAULT
+  end
+  
+  def full_name
+    full_name_parts = [first_name, last_name]
+    full_name_string = full_name_parts.join(' ').strip
+    if full_name_string.empty?
+      'Anonymous'
+    else
+      full_name_string
+    end
+  end
+  
+  def summary
+    "#{full_name} donated $#{donation_amount}"
+  end
+end
+
+donor = Donor.new
+
+include Glimmer
+
+frame(title: 'Hello, Data-Binding!') { |window|
+  panel {
+    v_box_sizer {
+      h_box_sizer {
+        sizer_args 0, Wx::DOWN, 10
+        
+        static_text(label: 'First Name:') {
+          sizer_args 0, Wx::RIGHT, 10
+        }
+        text_ctrl {
+          sizer_args 0, Wx::RIGHT, 10
+          # data-bind donor.first_name to text_ctrl.value bidirectionally,
+          # ensuring changes to either attribute update the other attribute
+          value <=> [donor, :first_name]
+        }
+      }
+      
+      h_box_sizer {
+        sizer_args 0, Wx::DOWN, 10
+        
+        static_text(label: 'Last Name:') {
+          sizer_args 0, Wx::RIGHT, 10
+        }
+        text_ctrl {
+          sizer_args 0, Wx::RIGHT, 10
+          # data-bind donor.last_name to text_ctrl.value bidirectionally,
+          # ensuring changes to either attribute update the other attribute
+          value <=> [donor, :last_name]
+        }
+      }
+      
+      h_box_sizer {
+        sizer_args 0, Wx::DOWN, 10
+        
+        static_text(label: 'Donation Amount: $') {
+          sizer_args 0, Wx::RIGHT, 1
+        }
+        spin_ctrl {
+          sizer_args 0, Wx::RIGHT, 10
+          range Donor::DONATION_AMOUNT_MIN, Donor::DONATION_AMOUNT_MAX
+          # data-bind donor.donation_amount to spin_ctrl.value bidirectionally,
+          # ensuring changes to either attribute update the other attribute
+          value <=> [donor, :donation_amount]
+        }
+      }
+      
+      h_box_sizer {
+        sizer_args 0, Wx::DOWN, 10
+        
+        slider {
+          sizer_args 0, Wx::RIGHT, 10
+          range Donor::DONATION_AMOUNT_MIN, Donor::DONATION_AMOUNT_MAX
+          # data-bind donor.first_name to spinner.value bidirectionally,
+          # ensuring changes to either attribute update the other attribute
+          value <=> [donor, :donation_amount]
+        }
+      }
+      
+      h_box_sizer {
+        sizer_args 0, Wx::DOWN, 10
+        
+        static_text(label: '') {
+          sizer_args 0, Wx::RIGHT, 10
+          # data-bind donor.summary to static_text.label unidirectionally,
+          # with computed data-binding from donor summary dependencies: first_name, last_name, and donation_amount
+          # ensuring changes to donor.summary or any of its dependencies update static_text.label
+          label <= [donor, :summary, computed_by: [:first_name, :last_name, :donation_amount]]
+        }
+      }
+    }
+  }
+}
+```
+
+## Coming From wxruby3
+
+If you would like to translate wxruby3 code into Glimmer DSL for WX code, read the [Usage](#usage) section to understand how Glimmer GUI DSL syntax works, and then check out the example below, which is written in both wxruby3 and Glimmer DSL for WX.
+
+Example written in wxruby3:
+
+```ruby
+require 'wx'
+
+class TheFrame < Wx::Frame
+  def initialize(title)
+    super(nil, title: title)
+    panel = Wx::Panel.new(self)
+    button = Wx::Button.new(panel, label: 'Click me')
+    button.evt_button(Wx::ID_ANY) { Wx.message_box('Hello. Thanks for clicking me!', 'Hello Button sample') }
+  end
+end
+
+Wx::App.run { TheFrame.new('Hello world!').show }
+```
+
+![Hello_Button](https://raw.githubusercontent.com/mcorino/wxRuby3/master/assets/hello_button.png)
+![Hello_Button_Clicked](https://raw.githubusercontent.com/mcorino/wxRuby3/master/assets/hello_button_clicked.png)
+
+Example re-written in Glimmer DSL for WX:
+
+```ruby
+require 'glimmer-dsl-wx'
+
+include Glimmer
+
+frame(title: 'Hello world!') {
+  panel {
+    button(label: 'Click me') {
+      on_button do
+        Wx.message_box('Hello. Thanks for clicking me!', 'Hello Button sample')
+      end
+    }
+  }
+}
+```
+
+![Hello_Button](https://raw.githubusercontent.com/mcorino/wxRuby3/master/assets/hello_button.png)
+![Hello_Button_Clicked](https://raw.githubusercontent.com/mcorino/wxRuby3/master/assets/hello_button_clicked.png)
+
 ## Process
 
 [Glimmer Process](https://github.com/AndyObtiva/glimmer/blob/master/PROCESS.md)
@@ -340,8 +612,10 @@ frame { |main_frame|
 ## Resources
 
 - [Code Master Blog](https://andymaleh.blogspot.com)
-- [wxruby3 Bindings](https://github.com/mcorino/wxRuby3)
-- [wxWidgets GUI Toolkit](https://www.wxwidgets.org/)
+- [wxruby3 Bindings](https://github.com/mcorino/wxRuby3) (used by Glimmer DSL for WX)
+- [wxWidgets GUI Toolkit](https://www.wxwidgets.org/) (used by Glimmer DSL for WX)
+- [wxWidgets Controls](https://docs.wxwidgets.org/3.0/group__group__class__ctrl.html)
+- [wxWidgets Sizers](https://docs.wxwidgets.org/3.0/overview_sizer.html)
 
 ## Help
 
@@ -393,7 +667,7 @@ Note that the latest development sometimes takes place in the [development](http
 
 [MIT](LICENSE.txt)
 
-Copyright (c) 2023 Andy Maleh
+Copyright (c) 2023-2024 Andy Maleh
 
 --
 

data/VERSION

@@ -1 +1 @@
-0.0.7
+0.1.0

data/bin/girb

@@ -1,6 +1,6 @@
 #!/usr/bin/env ruby
 
-# Copyright (c) 2023 Andy Maleh
+# Copyright (c) 2023-2024 Andy Maleh
 #
 # Permission is hereby granted, free of charge, to any person obtaining
 # a copy of this software and associated documentation files (the

data/bin/girb_runner.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 Andy Maleh
+# Copyright (c) 2023-2024 Andy Maleh
 #
 # Permission is hereby granted, free of charge, to any person obtaining
 # a copy of this software and associated documentation files (the

data/lib/glimmer/dsl/wx/about_box_expression.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 Andy Maleh
+# Copyright (c) 2023-2024 Andy Maleh
 #
 # Permission is hereby granted, free of charge, to any person obtaining
 # a copy of this software and associated documentation files (the

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

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 Andy Maleh
+# Copyright (c) 2023-2024 Andy Maleh
 #
 # Permission is hereby granted, free of charge, to any person obtaining
 # a copy of this software and associated documentation files (the
@@ -19,18 +19,18 @@
 # 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/static_expression'
-# require 'glimmer/dsl/bind_expression'
-#
-# module Glimmer
-#   module DSL
-#     module Libui
-      ### 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
-      ### DataBindingExpression
-#       class BindExpression < StaticExpression
-#         include Glimmer::DSL::BindExpression
-#       end
-#     end
-#   end
-# end
+require 'glimmer/dsl/static_expression'
+require 'glimmer/dsl/bind_expression'
+
+module Glimmer
+  module DSL
+    module Wx
+      # 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
+      # DataBindingExpression
+      class BindExpression < StaticExpression
+        include Glimmer::DSL::BindExpression
+      end
+    end
+  end
+end

data/lib/glimmer/dsl/wx/control_expression.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 Andy Maleh
+# Copyright (c) 2023-2024 Andy Maleh
 #
 # Permission is hereby granted, free of charge, to any person obtaining
 # a copy of this software and associated documentation files (the

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

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 Andy Maleh
+# Copyright (c) 2023-2024 Andy Maleh
 #
 # Permission is hereby granted, free of charge, to any person obtaining
 # a copy of this software and associated documentation files (the
@@ -19,27 +19,27 @@
 # 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'
-# require 'glimmer/data_binding/model_binding'
-#
-# module Glimmer
-#   module DSL
-#     module Libui
-      ### Responsible for wiring data-binding
-      ### Depends on BindExpression
-#       class DataBindingExpression < Expression
-#         def can_interpret?(parent, keyword, *args, &block)
-#           args.size == 1 and
-#             args[0].is_a?(DataBinding::ModelBinding) and
-#             parent.respond_to?(:data_bind)
-#         end
-#
-#         def interpret(parent, keyword, *args, &block)
-#           property = keyword
-#           model_binding = args[0]
-#           parent.data_bind(property, model_binding)
-#         end
-#       end
-#     end
-#   end
-# end
+require 'glimmer/dsl/expression'
+require 'glimmer/data_binding/model_binding'
+
+module Glimmer
+  module DSL
+    module Wx
+      # Responsible for wiring data-binding
+      # Depends on BindExpression
+      class DataBindingExpression < Expression
+        def can_interpret?(parent, keyword, *args, &block)
+          args.size == 1 and
+            args[0].is_a?(DataBinding::ModelBinding) and
+            parent.respond_to?(:data_bind)
+        end
+  
+        def interpret(parent, keyword, *args, &block)
+          property = keyword
+          model_binding = args[0]
+          parent.data_bind(property, model_binding)
+        end
+      end
+    end
+  end
+end

data/lib/glimmer/dsl/wx/dsl.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 Andy Maleh
+# Copyright (c) 2023-2024 Andy Maleh
 #
 # Permission is hereby granted, free of charge, to any person obtaining
 # a copy of this software and associated documentation files (the
@@ -35,18 +35,15 @@ module Glimmer
     module Wx
       Engine.add_dynamic_expressions(
         Wx,
-#           listener
-#           data_binding
-#           shine_data_binding
-#           property
-#           operation
-#           control
         %w[
           listener
+          data_binding
+          shine_data_binding
           sizer_args
           sizer_addable
           sizer
           property
+          operation
           control
         ]
       )