glimmer-dsl-libui 0.0.8 → 0.0.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5098a4f3a6ab5f314440a317cc77cc4d1c7fc65f2f190261d83710ffa9554dea
-  data.tar.gz: 7387058961fb36e05c598d8ef5c5e6ef109ce06eebac3626bed0628bc37511af
+  metadata.gz: 8be478e9d224fabeac6b2d42b7ccae6f7063491c88b1ea14e90cf1665e379bdf
+  data.tar.gz: b8b9b58fe072ec1973263ae20dbbe5407d7dceb30290420dd6734397cd850918
 SHA512:
-  metadata.gz: 40f5597274951ddcf6b96d26923d2012b2a5d59cacbb53e384b14e2bf619609b11f3d9c035768dcf9a4e38fe2608106eee15e91e0b5f72f282d7e009f05ebacd
-  data.tar.gz: b8bfe79a0acb9def38d25682c04f17c8fcfebc44af81c12e20368654381e81ac902e29329470d2888d69fca0d1ebdd9ee505898164ef7dcc168281c349a06724
+  metadata.gz: 534bf3ffa94019746c5a1291af5d8a676766221ea299e627cbb38dd1e3814f941688b8cf0182f243b942e73180f2f642c93598ca4d03a3a2df36cc249459316a
+  data.tar.gz: 3d6a77dcaffdedc6149d2efdb05df1e01f6499114054d5d43f83d576abeed0791d7cc6138335087fbfbd4d29bd481b1c016e71fe4c40af963218fd6e5227b3be

data/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Change Log
 
+## 0.0.12
+
+- Have examples/meta_example.rb allow code editing to enable experimentation and learning
+- Fix issue with examples/meta_example using puts_debuggerer (a development gem)
+
+## 0.0.11
+
+- New examples/basic_color.rb
+- Support `color_button` `color` property
+- Proper destroy of controls (deleting from parent `box`, `window`, or `group` first)
+- On the Mac only, if no menu is specified, add a Quit menu item automatically to allow quitting with CMD+Q
+
+## 0.0.10
+
+- Support examples/font_button.rb
+- Support `font_button` control
+- Add File -> Quit menu item to examples/meta_example.rb
+- Glimmer Style Guide added to README.md
+
+## 0.0.9
+
+- Build a meta-example (example of examples)
+
 ## 0.0.8
 
 - Add `?` suffixed aliases to all boolean property methods

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.0.8
+# [<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.0.12
 ## Prerequisite-Free Ruby Desktop Development GUI Library
 [![Gem Version](https://badge.fury.io/rb/glimmer-dsl-libui.svg)](http://badge.fury.io/rb/glimmer-dsl-libui)
 [![Maintainability](https://api.codeclimate.com/v1/badges/ce2853efdbecf6ebdc73/maintainability)](https://codeclimate.com/github/AndyObtiva/glimmer-dsl-libui/maintainability)
@@ -6,18 +6,18 @@
 
 [Glimmer](https://github.com/AndyObtiva/glimmer) DSL for [LibUI](https://github.com/kojix2/LibUI) is a prerequisite-free Ruby desktop development GUI library. No need to pre-install any prerequisites. Just install the gem and have platform-independent native GUI that just works!
 
-[LibUI](https://github.com/kojix2/LibUI) is a thin [Ruby](https://www.ruby-lang.org/en/) wrapper around [libui](https://github.com/andlabs/libui), a relatively new C GUI library that renders native widgets on every platform (similar to [SWT](https://www.eclipse.org/swt/), but without the heavy weight of the [Java Virtual Machine](https://www.java.com/en/)).
+[LibUI](https://github.com/kojix2/LibUI) is a thin [Ruby](https://www.ruby-lang.org/en/) wrapper around [libui](https://github.com/andlabs/libui), a relatively new C GUI library that renders native controls on every platform (similar to [SWT](https://www.eclipse.org/swt/), but without the heavy weight of the [Java Virtual Machine](https://www.java.com/en/)).
 
 The main trade-off in using [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) as opposed to [Glimmer DSL for SWT](https://github.com/AndyObtiva/glimmer-dsl-swt) or [Glimmer DSL for Tk](https://github.com/AndyObtiva/glimmer-dsl-tk) is the fact that [SWT](https://www.eclipse.org/swt/) and [Tk](https://www.tcl.tk/) are more mature than mid-alpha [libui](https://github.com/andlabs/libui) as GUI toolkits. Still, if there is only a need to build a small simple application, [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) could be a good convenient choice due to having zero prerequisites beyond the dependencies included in the [Ruby gem](https://rubygems.org/gems/glimmer-dsl-libui). Also, just like [Glimmer DSL for Tk](https://github.com/AndyObtiva/glimmer-dsl-tk), its apps start instantly and have a small memory footprint. [LibUI](https://github.com/kojix2/LibUI) is a promising new GUI toolkit that might prove quite worthy in the future.
 
 [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) 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 that visually maps to the GUI widget hierarchy
+- Declarative DSL syntax that visually maps to the GUI control 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
-- Custom Widget support
-- Scaffolding for new custom widgets, apps, and gems
-- Native-Executable packaging on Mac, Windows, and Linux
+- Custom Control support
+- Scaffolding for new custom controls, apps, and gems
+- Native-Executable packaging on Mac, Windows, and Linux.
 
 Example:
 
@@ -43,7 +43,7 @@ Other [Glimmer](https://rubygems.org/gems/glimmer) DSL gems you might be interes
 
 ## Table of Contents
 
-- [Glimmer DSL for LibUI 0.0.8](#-glimmer-dsl-for-libui-008)
+- [Glimmer DSL for LibUI 0.0.12](#-glimmer-dsl-for-libui-0012)
   - [Glimmer GUI DSL Concepts](#glimmer-gui-dsl-concepts)
   - [Usage](#usage)
   - [API](#api)
@@ -54,6 +54,7 @@ Other [Glimmer](https://rubygems.org/gems/glimmer) DSL gems you might be interes
     - [Extra Operations](#extra-operations)
     - [Smart Defaults and Conventions](#smart-defaults-and-conventions)
     - [Original API](#original-api)
+  - [Glimmer Style Guide](#glimmer-style-guide)
   - [Girb (Glimmer IRB)](#girb-glimmer-irb)
   - [Examples](#examples)
     - [Basic Window](#basic-window)
@@ -62,6 +63,8 @@ Other [Glimmer](https://rubygems.org/gems/glimmer) DSL gems you might be interes
     - [Simple Notepad](#simple-notepad)
     - [Midi Player](#midi-player)
     - [Control Gallery](#control-gallery)
+    - [Font Button](#font-button)
+    - [Color Button](#color-button)
   - [Contributing to glimmer-dsl-libui](#contributing-to-glimmer-dsl-libui)
   - [Help](#help)
     - [Issues](#issues)
@@ -76,9 +79,9 @@ Other [Glimmer](https://rubygems.org/gems/glimmer) DSL gems you might be interes
 
 The Glimmer GUI DSL provides object-oriented declarative hierarchical syntax for [LibUI](https://github.com/kojix2/LibUI) that:
 - Supports smart defaults (e.g. automatic `on_closing` listener that quits `window`)
-- Automates wiring of widgets (e.g. `button` is automatically set as child of `window`)
+- Automates wiring of controls (e.g. `button` is automatically set as child of `window`)
 - Hides lower-level details (e.g. `LibUI.main` loop is started automatically when triggering `show` on `window`)
-- Nests widgets according to their visual hierarchy
+- Nests controls according to their visual hierarchy
 - Requires the minimum amount of syntax needed to describe an app's GUI
 
 The Glimmer GUI DSL follows these simple concepts in mapping from [LibUI](https://github.com/kojix2/LibUI) syntax:
@@ -149,7 +152,7 @@ gem install glimmer-dsl-libui
 Or install via Bundler `Gemfile`:
 
 ```ruby
-gem 'glimmer-dsl-libui', '~> 0.0.8'
+gem 'glimmer-dsl-libui', '~> 0.0.12'
 ```
 
 Add `require 'glimmer-dsl-libui'` at the top, and then `include Glimmer` into the top-level main object for testing or into an actual class for serious usage.
@@ -208,12 +211,12 @@ Control(Args) | Properties | Listeners
 `button(text as String)` | `text` (`String`) | `on_clicked`
 `checkbox(text as String)` | `checked` (Boolean), `text` (`String`) | `on_toggled`
 `combobox` | `items` (`Array` of `String`), `selected` (`Integer`) | `on_selected`
-`color_button` | `color` (r `Numeric`, g `Numeric`, b `Numeric`, a `Numeric`) | `on_changed`
+`color_button` | `color` (Array of `red` as `Float`, `green` as `Float`, `blue` as `Float`, `alpha` as `Float`), `red` as `Float`, `green` as `Float`, `blue` as `Float`, `alpha` as `Float` | `on_changed`
 `date_picker` | `time` (`LibUI::FFI::TM`) | `on_changed`
 `date_time_picker` | `time` (`LibUI::FFI::TM`) | `on_changed`
 `editable_combobox` | `items` (`Array` of `String`), `text` (`String`) | `on_changed`
 `entry` | `read_only` (Boolean), `text` (`String`) | `on_changed`
-`font_button` | `font` (`LibUI::FFI::FontDescriptor`) | `on_changed`
+`font_button` | `font` [read-only] (`Hash` of keys: `:family`, `:size`, `:weight`, `:italic`, `:stretch`), `family` as `String`, `size` as `Float`, `weight` as `Integer`, `italic` as `Integer`, `stretch` as `Integer` | `on_changed`
 `group(text as String)` | `margined` (Boolean), `title` (`String`) | None
 `horizontal_box` | `padded` (Boolean) | None
 `horizontal_separator` | None | None
@@ -265,9 +268,9 @@ Control(Args) | Properties | Listeners
 
 ### Smart Defaults and Conventions
 
-- `horizontal_box` and `vertical_box` controls have `padded` as `1` upon instantiation to ensure more user-friendly GUI by default
-- `group` controls have `margined` as `1` upon instantiation to ensure more user-friendly GUI by default
-- All controls nested under a `horizontal_box` or `vertical_box` have `stretchy` property (passed to `box_append` method) as `1` by default (filling maximum space)
+- `horizontal_box` and `vertical_box` controls have `padded` as `true` upon instantiation to ensure more user-friendly GUI by default
+- `group` controls have `margined` as `true` upon instantiation to ensure more user-friendly GUI by default
+- All controls nested under a `horizontal_box` or `vertical_box` have `stretchy` property (passed to `box_append` method) as `true` by default (filling maximum space)
 - `window` constructor args can be left off and have the following defaults when unspecified: `title` as `'Glimmer'`, `width` as `150`, `height` as `150`, and `has_menubar` as `true`)
 - `window` has an `on_closing` listener by default that quits application upon hitting the close button (can be overridden with a manual `on_closing` implementation that returns integer `0` for success)
 - `quit_menu_item` has an `on_clicked` listener by default that quits application upon selecting the quit menu item (can be overridden with a manual `on_clicked` implementation that returns integer `0` for success)
@@ -276,12 +279,26 @@ Control(Args) | Properties | Listeners
 - All boolean property readers return `true` or `false` in Ruby instead of the [libui](https://github.com/andlabs/libui) original `0` or `1` in C.
 - All boolean property writers accept `true`/`false` in addition to `1`/`0` in Ruby
 - All string property readers return a `String` object in Ruby instead of the [libui](https://github.com/andlabs/libui) Fiddle pointer object.
+- Automatically allocate font descriptors upon instantiating `font_button` controls and free them when destorying `font_button` controls
+- Automatically allocate color value pointers upon instantiating `color_button` controls and free them when destorying `color_button` controls
+- On the Mac, if no `menu` items were added, an automatic `quit_menu_item` is added to enable quitting with CTRL+Q
+- When destroying a control nested under a `horizontal_box` or `vertical_box`, it is automatically deleted from the box's children
+- When destroying a control nested under a `window` or `group`, it is automatically unset as their child to allow successful destruction
 
 ### Original API
 
 To learn more about the [LibUI](https://github.com/kojix2/LibUI) API exposed through [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui),
 check out the [libui C headers](https://github.com/andlabs/libui/blob/master/ui.h)
 
+## Glimmer Style Guide
+
+- Control arguments are always wrapped by parentheses
+- Control blocks are always declared with curly braces to clearly visualize hierarchical view code and separate from logic code
+- Control property declarations always have arguments and never take a block
+- Control property arguments are never wrapped inside parentheses
+- Control listeners are always declared starting with on_ prefix and affixing listener event method name afterwards in underscored lowercase form. Their multi-line blocks have a `do; end` style.
+- Pure logic multi-line blocks that do not constitute GUI DSL view elements have `do; end` style to clearly separate logic code from view code.
+
 ## Girb (Glimmer IRB)
 
 You can run the `girb` command (`bin/girb` if you cloned the project locally):
@@ -296,7 +313,103 @@ Gotcha: On the Mac, when you close a window opened in `girb`, it remains open un
 
 ## Examples
 
-These examples reimplement the ones in the [LibUI](https://github.com/kojix2/LibUI) project utilizing the [Glimmer GUI DSL](#glimmer-gui-dsl-concepts).
+These examples include reimplementions of the examples in the [LibUI](https://github.com/kojix2/LibUI) project utilizing the [Glimmer GUI DSL](#glimmer-gui-dsl-concepts) as well as brand new examples.
+
+To browse all examples, simply launch the [Meta-Example](examples/meta_example.rb), which lists all examples and displays each example's code when selected. It also enables code editing to facilitate experimentation and learning.
+
+[examples/meta_example.rb](examples/meta_example.rb)
+
+Run with this command from the root of the project if you cloned the project:
+
+```
+ruby -r './lib/glimmer-dsl-libui' examples/meta_example.rb
+```
+
+Run with this command if you installed the [Ruby gem](https://rubygems.org/gems/glimmer-dsl-libui):
+
+```
+ruby -r glimmer-dsl-libui -e "require 'examples/meta_example'"
+```
+
+Mac
+
+![glimmer-dsl-libui-mac-meta-example.png](images/glimmer-dsl-libui-mac-meta-example.png)
+
+Linux
+
+![glimmer-dsl-libui-linux-meta-example.png](images/glimmer-dsl-libui-linux-meta-example.png)
+
+New [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version:
+
+```ruby
+require 'glimmer-dsl-libui'
+require 'facets'
+
+class MetaExample
+  include Glimmer
+  
+  def examples
+    if @examples.nil?
+      example_files = Dir.glob(File.join(File.expand_path('.', __dir__), '**', '*.rb'))
+      example_file_names = example_files.map { |f| File.basename(f, '.rb') }
+      example_file_names = example_file_names.reject { |f| f == 'meta_example' }
+      @examples = example_file_names.map { |f| f.underscore.titlecase }
+    end
+    @examples
+  end
+  
+  def file_path_for(example)
+    File.join(File.expand_path('.', __dir__), "#{example.underscore}.rb")
+  end
+  
+  def glimmer_dsl_libui_file
+    File.expand_path('../lib/glimmer-dsl-libui', __dir__)
+  end
+  
+  def launch
+    window('Meta-Example', 700, 500) { |w|
+      margined true
+      
+      horizontal_box {
+        vertical_box {
+          @rbs = radio_buttons {
+            stretchy false
+            items examples
+            selected 0
+            
+            on_selected do
+              @nwme.text = File.read(file_path_for(@examples[@rbs.selected]))
+            end
+          }
+          button('Launch') {
+            stretchy false
+            
+            on_clicked do
+              begin
+                meta_example_file = File.join(Dir.home, '.meta_example.rb')
+                File.write(meta_example_file, @nwme.text)
+                result = `ruby -r #{glimmer_dsl_libui_file} #{meta_example_file} 2>&1`
+                msg_box(w, 'Error Running Example', result) if result.include?('error')
+              rescue => e
+                puts 'Unable to write code changes! Running original example...'
+                system "ruby -r #{glimmer_dsl_libui_file} #{file_path_for(@examples[@rbs.selected])}"
+              end
+            end
+          }
+        }
+        vertical_box {
+          @nwme = non_wrapping_multiline_entry {
+            text File.read(file_path_for(@examples[@rbs.selected]))
+          }
+        }
+      }
+    }.show
+  end
+end
+
+MetaExample.new.launch
+```
+
 
 ### Basic Window
 
@@ -379,7 +492,7 @@ ruby -r glimmer-dsl-libui -e "require 'examples/basic_button'"
 Mac
 
 ![glimmer-dsl-libui-mac-basic-button.png](images/glimmer-dsl-libui-mac-basic-button.png)
-![glimmer-dsl-libui-mac-basic-button-msg-box.png](images/glimmer-dsl-libui-basic-button-msg-box.png)
+![glimmer-dsl-libui-mac-basic-button-msg-box.png](images/glimmer-dsl-libui-mac-basic-button-msg-box.png)
 
 Linux
 
@@ -424,7 +537,7 @@ require 'glimmer-dsl-libui'
 
 include Glimmer
 
-window('hello world', 300, 200) { |w|
+window('hello world', 300, 200, true) { |w|
   button('Button') {
     on_clicked do
       msg_box(w, 'Information', 'You clicked the button')
@@ -444,7 +557,7 @@ require 'glimmer-dsl-libui'
 
 include Glimmer
 
-window { # args can alternatively be set via properties with 4th arg has_menubar=true by default
+window { # first 3 args can be set via properties with 4th arg has_menubar=true by default
   title 'hello world'
   content_size 300, 200
   
@@ -1239,6 +1352,135 @@ MAIN_WINDOW = window('Control Gallery', 600, 500) {
 MAIN_WINDOW.show
 ```
 
+### Font Button
+
+[examples/font_button.rb](examples/font_button.rb)
+
+Run with this command from the root of the project if you cloned the project:
+
+```
+ruby -r './lib/glimmer-dsl-libui' examples/font_button.rb
+```
+
+Run with this command if you installed the [Ruby gem](https://rubygems.org/gems/glimmer-dsl-libui):
+
+```
+ruby -r glimmer-dsl-libui -e "require 'examples/font_button'"
+```
+
+Mac
+
+![glimmer-dsl-libui-mac-font-button.png](images/glimmer-dsl-libui-mac-font-button.png)
+![glimmer-dsl-libui-mac-font-button-selection.png](images/glimmer-dsl-libui-mac-font-button-selection.png)
+
+Linux
+
+![glimmer-dsl-libui-linux-font-button.png](images/glimmer-dsl-libui-linux-font-button.png)
+![glimmer-dsl-libui-linux-font-button-selection.png](images/glimmer-dsl-libui-linux-font-button-selection.png)
+
+[LibUI](https://github.com/kojix2/LibUI) Original Version:
+
+```ruby
+require 'libui'
+
+UI = LibUI
+
+UI.init
+
+main_window = UI.new_window('hello world', 300, 200, 1)
+
+font_button = UI.new_font_button
+font_descriptor = UI::FFI::FontDescriptor.malloc
+UI.font_button_on_changed(font_button) do
+  UI.font_button_font(font_button, font_descriptor)
+  p family: font_descriptor.Family.to_s,
+    size: font_descriptor.Size,
+    weight: font_descriptor.Weight,
+    italic: font_descriptor.Italic,
+    stretch: font_descriptor.Stretch
+end
+
+UI.window_on_closing(main_window) do
+  puts 'Bye Bye'
+  UI.control_destroy(main_window)
+  UI.quit
+  0
+end
+
+UI.window_set_child(main_window, font_button)
+UI.control_show(main_window)
+
+UI.main
+UI.quit
+
+```
+
+[Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version:
+
+```ruby
+require 'glimmer-dsl-libui'
+
+include Glimmer
+
+window('hello world', 300, 200) {
+  font_button { |fb|
+    on_changed do
+      font_descriptor = fb.font
+      p font_descriptor
+    end
+  }
+  
+  on_closing do
+    puts 'Bye Bye'
+  end
+}.show
+```
+
+### Color Button
+
+[examples/color_button.rb](examples/color_button.rb)
+
+Run with this command from the root of the project if you cloned the project:
+
+```
+ruby -r './lib/glimmer-dsl-libui' examples/color_button.rb
+```
+
+Run with this command if you installed the [Ruby gem](https://rubygems.org/gems/glimmer-dsl-libui):
+
+```
+ruby -r glimmer-dsl-libui -e "require 'examples/color_button'"
+```
+
+Mac
+
+![glimmer-dsl-libui-mac-color-button.png](images/glimmer-dsl-libui-mac-color-button.png)
+![glimmer-dsl-libui-mac-color-button-selection.png](images/glimmer-dsl-libui-mac-color-button-selection.png)
+
+Linux
+
+![glimmer-dsl-libui-linux-color-button.png](images/glimmer-dsl-libui-linux-color-button.png)
+![glimmer-dsl-libui-linux-color-button-selection.png](images/glimmer-dsl-libui-linux-color-button-selection.png)
+
+New [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version:
+
+```ruby
+# frozen_string_literal: true
+
+require 'glimmer-dsl-libui'
+
+include Glimmer
+
+window('color button', 230) {
+  color_button { |cb|
+    on_changed do
+      rgba = cb.color
+      p rgba
+    end
+  }
+}.show
+```
+
 ## Contributing to glimmer-dsl-libui
 
 -   Check out the latest master to make sure the feature hasn't been

data/VERSION

@@ -1 +1 @@
-0.0.8
+0.0.12

data/examples/basic_window2.rb

@@ -4,7 +4,7 @@ require 'glimmer-dsl-libui'
 
 include Glimmer
 
-window { # args can alternatively be set via properties with 4th arg has_menubar=true by default
+window { # first 3 args can be set via properties with 4th arg has_menubar=true by default
   title 'hello world'
   content_size 300, 200
   

data/examples/color_button.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require 'glimmer-dsl-libui'
+
+include Glimmer
+
+window('color button', 230) {
+  color_button { |cb|
+    on_changed do
+      rgba = cb.color
+      p rgba
+    end
+  }
+}.show

data/examples/font_button.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require 'glimmer-dsl-libui'
+
+include Glimmer
+
+window('hello world', 300, 200) {
+  font_button { |fb|
+    on_changed do
+      font_descriptor = fb.font
+      p font_descriptor
+    end
+  }
+  
+  on_closing do
+    puts 'Bye Bye'
+  end
+}.show

data/examples/meta_example.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+require 'glimmer-dsl-libui'
+require 'facets'
+
+class MetaExample
+  include Glimmer
+  
+  def examples
+    if @examples.nil?
+      example_files = Dir.glob(File.join(File.expand_path('.', __dir__), '**', '*.rb'))
+      example_file_names = example_files.map { |f| File.basename(f, '.rb') }
+      example_file_names = example_file_names.reject { |f| f == 'meta_example' }
+      @examples = example_file_names.map { |f| f.underscore.titlecase }
+    end
+    @examples
+  end
+  
+  def file_path_for(example)
+    File.join(File.expand_path('.', __dir__), "#{example.underscore}.rb")
+  end
+  
+  def glimmer_dsl_libui_file
+    File.expand_path('../lib/glimmer-dsl-libui', __dir__)
+  end
+  
+  def launch
+    window('Meta-Example', 700, 500) { |w|
+      margined true
+      
+      horizontal_box {
+        vertical_box {
+          @rbs = radio_buttons {
+            stretchy false
+            items examples
+            selected 0
+            
+            on_selected do
+              @nwme.text = File.read(file_path_for(@examples[@rbs.selected]))
+            end
+          }
+          button('Launch') {
+            stretchy false
+            
+            on_clicked do
+              begin
+                meta_example_file = File.join(Dir.home, '.meta_example.rb')
+                File.write(meta_example_file, @nwme.text)
+                result = `ruby -r #{glimmer_dsl_libui_file} #{meta_example_file} 2>&1`
+                msg_box(w, 'Error Running Example', result) if result.include?('error')
+              rescue => e
+                puts 'Unable to write code changes! Running original example...'
+                system "ruby -r #{glimmer_dsl_libui_file} #{file_path_for(@examples[@rbs.selected])}"
+              end
+            end
+          }
+        }
+        vertical_box {
+          @nwme = non_wrapping_multiline_entry {
+            text File.read(file_path_for(@examples[@rbs.selected]))
+          }
+        }
+      }
+    }.show
+  end
+end
+
+MetaExample.new.launch

data/lib/glimmer/libui/box.rb

@@ -29,12 +29,22 @@ module Glimmer
       def post_initialize_child(child)
         child.stretchy = true if child.stretchy.nil?
         ::LibUI.box_append(@libui, child.libui, ControlProxy.boolean_to_integer(child.stretchy))
+        children << child
       end
       
       def libui_api_keyword
         'box'
       end
       
+      def children
+        @children ||= []
+      end
+      
+      def destroy_child(child)
+        ::LibUI.send("box_delete", @libui, children.index(child))
+        ControlProxy.all_control_proxies.delete(child)
+      end
+      
       private
       
       def build_control

data/lib/glimmer/libui/color_button_proxy.rb

@@ -0,0 +1,64 @@
+# Copyright (c) 2021 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/libui/control_proxy'
+
+module Glimmer
+  module LibUI
+    # Proxy for LibUI color button objects
+    #
+    # Follows the Proxy Design Pattern
+    class ColorButtonProxy < ControlProxy
+      def color
+        @red ||= Fiddle::Pointer.malloc(8) # double
+        @green ||= Fiddle::Pointer.malloc(8) # double
+        @blue ||= Fiddle::Pointer.malloc(8) # double
+        @alpha ||= Fiddle::Pointer.malloc(8) # double
+        ::LibUI.color_button_color(@libui, @red, @green, @blue, @alpha)
+        [@red[0, 8].unpack1('d') * 255.0, @green[0, 8].unpack1('d') * 255.0, @blue[0, 8].unpack1('d') * 255.0, @alpha[0, 8].unpack1('d')]
+      end
+      
+      def red
+        color[0]
+      end
+      
+      def green
+        color[1]
+      end
+      
+      def blue
+        color[2]
+      end
+      
+      def alpha
+        color[3]
+      end
+      
+      def destroy
+        Fiddle.free @red unless @red.nil?
+        Fiddle.free @green unless @green.nil?
+        Fiddle.free @blue unless @blue.nil?
+        Fiddle.free @alpha unless @alpha.nil?
+        super
+      end
+    end
+  end
+end

data/lib/glimmer/libui/control_proxy.rb

@@ -52,7 +52,7 @@ module Glimmer
         end
         
         def main_window_proxy
-          all_control_proxies.find {|c| c.is_a?(WindowProxy)}
+          all_control_proxies.find {|c| c.is_a?(Glimmer::LibUI::WindowProxy)}
         end
         
         def integer_to_boolean(int)
@@ -62,6 +62,10 @@ module Glimmer
         def boolean_to_integer(bool)
           bool.nil? ? nil : (bool ? 1 : 0)
         end
+        
+        def menu_proxies
+          all_control_proxies.select {|c| c.keyword == 'menu' }
+        end
       end
       
       BOOLEAN_PROPERTIES = %w[
@@ -167,7 +171,7 @@ module Glimmer
           ::LibUI.send("#{libui_api_keyword}_#{method_name}", @libui, *args)
         elsif ::LibUI.respond_to?("control_#{method_name.to_s.sub(/\?$/, '')}") && args.empty?
           property = method_name.to_s.sub(/\?$/, '')
-          value = ::LibUI.send("control_#{method_name.to_s.sub(/\?$/, '')}", @libui, *args)
+          value = ::LibUI.send("control_#{property}", @libui, *args)
           handle_string_property(property, handle_boolean_property(property, value))
         elsif ::LibUI.respond_to?("control_set_#{method_name.to_s.sub(/=$/, '')}")
           property = method_name.to_s.sub(/=$/, '')
@@ -198,6 +202,23 @@ module Glimmer
         @keyword
       end
       
+      def destroy
+        if parent_proxy.nil?
+          default_destroy
+        else
+          parent_proxy.destroy_child(self)
+        end
+      end
+      
+      def destroy_child(child)
+        child.default_destroy
+      end
+      
+      def default_destroy
+        send_to_libui('destroy')
+        ControlProxy.all_control_proxies.delete(self)
+      end
+            
       def enabled(value = nil)
         if value.nil?
           @enabled
@@ -229,11 +250,6 @@ module Glimmer
       alias set_visible visible
       alias visible= visible
       
-      def destroy
-        send_to_libui('destroy')
-        self.class.all_control_proxies.delete(self)
-      end
-            
       private
       
       def build_control

data/lib/glimmer/libui/font_button_proxy.rb

@@ -0,0 +1,68 @@
+# Copyright (c) 2021 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/libui/control_proxy'
+
+module Glimmer
+  module LibUI
+    # Proxy for LibUI font button objects
+    #
+    # Follows the Proxy Design Pattern
+    class FontButtonProxy < ControlProxy
+      def font
+        @font_descriptor ||= ::LibUI::FFI::FontDescriptor.malloc
+        ::LibUI.font_button_font(@libui, @font_descriptor)
+        {
+          family: @font_descriptor.Family.to_s,
+          size: @font_descriptor.Size,
+          weight: @font_descriptor.Weight,
+          italic: @font_descriptor.Italic,
+          stretch: @font_descriptor.Stretch
+        }
+      end
+      
+      def family
+        font[:family]
+      end
+      
+      def size
+        font[:size]
+      end
+      
+      def weight
+        font[:weight]
+      end
+      
+      def italic
+        font[:italic]
+      end
+      
+      def stretch
+        font[:stretch]
+      end
+      
+      def destroy
+        ::LibUI.free_font_button_font(@font_descriptor) unless @font_descriptor.nil?
+        super
+      end
+    end
+  end
+end

data/lib/glimmer/libui/group_proxy.rb

@@ -31,6 +31,11 @@ module Glimmer
         ::LibUI.group_set_child(@libui, child.libui)
       end
       
+      def destroy_child(child)
+        ::LibUI.send("group_set_child", @libui, nil)
+        super
+      end
+    
       private
       
       def build_control

data/lib/glimmer/libui/window_proxy.rb

@@ -35,9 +35,14 @@ module Glimmer
       def post_initialize_child(child)
         ::LibUI.window_set_child(@libui, child.libui)
       end
+      
+      def destroy_child(child)
+        ::LibUI.send("window_set_child", @libui, nil)
+        super
+      end
     
       def show
-        send_to_libui('show')
+        super
         unless @shown_at_least_once
           @shown_at_least_once = true
           ::LibUI.main
@@ -64,6 +69,10 @@ module Glimmer
       private
       
       def build_control
+        if OS.mac? && ControlProxy.menu_proxies.empty?
+          menu_proxy = ControlProxy.create('menu', nil, [''])
+          quit_menu_item_proxy = ControlProxy.create('quit_menu_item', menu_proxy, [])
+        end
         construction_args = @args.dup
         construction_args[0] = DEFAULT_TITLE if construction_args.size == 0
         construction_args[1] = DEFAULT_WIDTH if construction_args.size == 1

data/lib/glimmer-dsl-libui.rb

@@ -26,6 +26,7 @@ require 'glimmer'
 # require 'logging'
 # require 'puts_debuggerer' if ENV['pd'].to_s.downcase == 'true'
 # require 'super_module'
+require 'os'
 require 'libui'
 
 # Internal requires

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glimmer-dsl-libui
 version: !ruby/object:Gem::Version
-  version: 0.0.8
+  version: 0.0.12
 platform: ruby
 authors:
 - Andy Maleh
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-09-19 00:00:00.000000000 Z
+date: 2021-09-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: glimmer
@@ -24,6 +24,26 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 2.1.2
+- !ruby/object:Gem::Dependency
+  name: os
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.0.0
 - !ruby/object:Gem::Dependency
   name: libui
   requirement: !ruby/object:Gem::Requirement
@@ -164,7 +184,10 @@ files:
 - examples/basic_entry.rb
 - examples/basic_window.rb
 - examples/basic_window2.rb
+- examples/color_button.rb
 - examples/control_gallery.rb
+- examples/font_button.rb
+- examples/meta_example.rb
 - examples/midi_player.rb
 - examples/simple_notepad.rb
 - glimmer-dsl-libui.gemspec
@@ -180,11 +203,13 @@ files:
 - lib/glimmer/libui/about_menu_item_proxy.rb
 - lib/glimmer/libui/box.rb
 - lib/glimmer/libui/check_menu_item_proxy.rb
+- lib/glimmer/libui/color_button_proxy.rb
 - lib/glimmer/libui/combobox_proxy.rb
 - lib/glimmer/libui/control_proxy.rb
 - lib/glimmer/libui/date_picker_proxy.rb
 - lib/glimmer/libui/date_time_picker_proxy.rb
 - lib/glimmer/libui/editable_combobox_proxy.rb
+- lib/glimmer/libui/font_button_proxy.rb
 - lib/glimmer/libui/group_proxy.rb
 - lib/glimmer/libui/horizontal_box_proxy.rb
 - lib/glimmer/libui/menu_item_proxy.rb