glimmer-dsl-libui 0.0.15 → 0.0.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 45785cccb2a89070b2230fdae1c7418b48c6b8ac4682bf6ee0c2eb832f35bc1c
-  data.tar.gz: 0a5544bef68a214ddb4ed55eb4ff71efa5916ce8c7e2d0b1c6d8f36d5b5fbd6f
+  metadata.gz: 2ab738eba1965fffc98860a23a44f2e1ed15c0c426ba4d21bcbb3fc4812ecde5
+  data.tar.gz: 2d5c195882767b63d941d9b8bad8338bc5d5ce160e97f34a9f57f5631c833fac
 SHA512:
-  metadata.gz: '08005e8f56a310c7b534bfafde7e958617ee483985f30facf02a62a015d860a6378e4f7d5399b37fa5a247ef899a7092c313f120d5599a72d288bd3781a43820'
-  data.tar.gz: befd92a20a6bc56c19049cfc385970bd8e113ae191c45ac3c3fffb513dd9140838229b79859392aed2e452d6e235d95059fe5d7847b3ac48cc5b4261aae50b26
+  metadata.gz: 23e1de3b8f30f90abb605a351e6cd9302dd778da2e711f7c72c4ad39b267090bab324bd056ca3855c343781c53757af320ca67c0d4aacac4c6351f7cf4a646e8
+  data.tar.gz: 18f3d9b8d48bc15a342efeb38f6979e1b2516b5144a790876d931c28a2803da840f980d0d9b9cd4c96484817d4cf241d19b7b64c751229fa1ae6a236029545ac

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Change Log
 
+## 0.0.16
+
+- Support ability to instantiate without args and set args as properties afterwards inside block (e.g. `window { title 'Greeter'; content_size 300, 400; button {text 'Greet'; on_clicked {puts 'Hi'}} }`)
+  - window (was supported before, but changed default title to empty string)
+  - button
+  - checkbox
+  - group
+  - label
+
 ## 0.0.15
 
 - New examples/form.rb

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.15
+# [<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.16
 ## 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)
@@ -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.15](#-glimmer-dsl-for-libui-0015)
+- [Glimmer DSL for LibUI 0.0.16](#-glimmer-dsl-for-libui-0016)
   - [Glimmer GUI DSL Concepts](#glimmer-gui-dsl-concepts)
   - [Usage](#usage)
   - [API](#api)
@@ -156,7 +156,7 @@ gem install glimmer-dsl-libui
 Or install via Bundler `Gemfile`:
 
 ```ruby
-gem 'glimmer-dsl-libui', '~> 0.0.15'
+gem 'glimmer-dsl-libui', '~> 0.0.16'
 ```
 
 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.
@@ -284,9 +284,11 @@ Control(Args) | Properties | Listeners
 
 - `horizontal_box`, `vertical_box`, `grid`, and `form` 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`)
+- All controls nested under a `horizontal_box`, `vertical_box`, and `form` have `stretchy` property (fill maximum space) as `true` by default (passed to `box_append`/`form_append` method)
+- `window` instatiation args can be left off, having the following defaults when unspecified: `title` as `''`, `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)
+- `group` has `title` property default to `''` if not specified in instantiation args, so it can be instantiated without args with `title` property specified in nested block (e.g. `group {title 'Address'; ...}`)
+- `button`, `checkbox`, and `label` have `text` default to `''` if not specified in instantiation args, so they can be instantiated without args with `text` property specified in nested block (e.g. `button {text 'Greet'; on_clicked {puts 'Hello'}}`)
 - `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)
 - If an `on_closing` listener was defined on `window` and it does not return an integer, default exit behavior is assumed (`window.destroy` is called followed by `LibUI.quit`, returning `0`).
 - If an `on_clicked` listener was defined on `quit_menu_item` and it does not return an integer, default exit behavior is assumed (`main_window.destroy` is called followed by `LibUI.quit`, returning `0`).
@@ -674,7 +676,7 @@ window('Basic Entry', 300, 50) { |w|
     }
     
     button('Button') {
-      stretchy false
+      stretchy false # stretchy property is available when control is nested under horizontal_box
       
       on_clicked do
         text = e.text
@@ -1730,13 +1732,11 @@ window('Form') { |w|
   vertical_box {
     form {
       @first_name_entry = entry {
-        # stretchy true # Smart default option for appending to form
-        label 'First Name'
+        label 'First Name' # label property is available when control is nested under form
       }
       
       @last_name_entry = entry {
-        # stretchy true # Smart default option for appending to form
-        label 'Last Name'
+        label 'Last Name' # label property is available when control is nested under form
       }
     }
     

data/VERSION

@@ -1 +1 @@
-0.0.15
+0.0.16

data/examples/basic_entry.rb

@@ -16,7 +16,7 @@ window('Basic Entry', 300, 50) { |w|
     }
     
     button('Button') {
-      stretchy false
+      stretchy false # stretchy property is available when control is nested under horizontal_box
       
       on_clicked do
         text = e.text

data/examples/form.rb

@@ -10,13 +10,11 @@ window('Form') { |w|
   vertical_box {
     form {
       @first_name_entry = entry {
-        # stretchy true # Smart default option for appending to form
-        label 'First Name'
+        label 'First Name' # label property is available when control is nested under form
       }
       
       @last_name_entry = entry {
-        # stretchy true # Smart default option for appending to form
-        label 'Last Name'
+        label 'Last Name' # label property is available when control is nested under form
       }
     }
     

data/lib/glimmer/libui/button_proxy.rb

@@ -0,0 +1,41 @@
+# 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 button objects
+    #
+    # Follows the Proxy Design Pattern
+    class ButtonProxy < ControlProxy
+      DEFAULT_TEXT = ''
+      
+      private
+      
+      def build_control
+        construction_args = @args.dup
+        construction_args[0] = DEFAULT_TEXT if construction_args.size == 0
+        @libui = ControlProxy.new_control(@keyword, construction_args)
+      end
+    end
+  end
+end

data/lib/glimmer/libui/checkbox_proxy.rb

@@ -0,0 +1,41 @@
+# 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 checkbox objects
+    #
+    # Follows the Proxy Design Pattern
+    class CheckboxProxy < ControlProxy
+      DEFAULT_TEXT = ''
+      
+      private
+      
+      def build_control
+        construction_args = @args.dup
+        construction_args[0] = DEFAULT_TEXT if construction_args.size == 0
+        @libui = ControlProxy.new_control(@keyword, construction_args)
+      end
+    end
+  end
+end

data/lib/glimmer/libui/control_proxy.rb

@@ -66,6 +66,10 @@ module Glimmer
         def menu_proxies
           all_control_proxies.select {|c| c.keyword == 'menu' }
         end
+        
+        def new_control(keyword, args)
+          ::LibUI.send("new_#{keyword}", *args)
+        end
       end
       
       BOOLEAN_PROPERTIES = %w[
@@ -254,7 +258,7 @@ module Glimmer
       
       def build_control
         @libui = if ::LibUI.respond_to?("new_#{keyword}")
-          ::LibUI.send("new_#{@keyword}", *@args)
+          ControlProxy.new_control(@keyword, @args)
         elsif ::LibUI.respond_to?(keyword)
           @args[0] = @args.first.libui if @args.first.is_a?(ControlProxy)
           ::LibUI.send(@keyword, *@args)

data/lib/glimmer/libui/group_proxy.rb

@@ -27,6 +27,8 @@ module Glimmer
     #
     # Follows the Proxy Design Pattern
     class GroupProxy < ControlProxy
+      DEFAULT_TITLE = ''
+      
       def post_initialize_child(child)
         ::LibUI.group_set_child(@libui, child.libui)
       end
@@ -39,7 +41,10 @@ module Glimmer
       private
       
       def build_control
-        super.tap do
+        construction_args = @args.dup
+        construction_args[0] = DEFAULT_TITLE if construction_args.size == 0
+        @libui = ControlProxy.new_control(@keyword, construction_args)
+        @libui.tap do
           self.margined = true
         end
       end

data/lib/glimmer/libui/label_proxy.rb

@@ -0,0 +1,41 @@
+# 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 label objects
+    #
+    # Follows the Proxy Design Pattern
+    class LabelProxy < ControlProxy
+      DEFAULT_TEXT = ''
+      
+      private
+      
+      def build_control
+        construction_args = @args.dup
+        construction_args[0] = DEFAULT_TEXT if construction_args.size == 0
+        @libui = ControlProxy.new_control(@keyword, construction_args)
+      end
+    end
+  end
+end

data/lib/glimmer/libui/menu_proxy.rb

@@ -0,0 +1,41 @@
+# 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 menu objects
+    #
+    # Follows the Proxy Design Pattern
+    class MenuProxy < ControlProxy
+      DEFAULT_TEXT = ''
+      
+      private
+      
+      def build_control
+        construction_args = @args.dup
+        construction_args[0] = DEFAULT_TEXT if construction_args.size == 0
+        @libui = ControlProxy.new_control(@keyword, construction_args)
+      end
+    end
+  end
+end

data/lib/glimmer/libui/window_proxy.rb

@@ -27,7 +27,7 @@ module Glimmer
     #
     # Follows the Proxy Design Pattern
     class WindowProxy < ControlProxy
-      DEFAULT_TITLE = 'Glimmer'
+      DEFAULT_TITLE = ''
       DEFAULT_WIDTH = 150
       DEFAULT_HEIGHT = 150
       DEFAULT_HAS_MENUBAR = 1
@@ -79,7 +79,7 @@ module Glimmer
         construction_args[2] = DEFAULT_HEIGHT if construction_args.size == 2
         construction_args[3] = DEFAULT_HAS_MENUBAR if construction_args.size == 3
         construction_args[3] = ControlProxy.boolean_to_integer(construction_args[3]) if construction_args.size == 4 && (construction_args[3].is_a?(TrueClass) || construction_args[3].is_a?(FalseClass))
-        @libui = ::LibUI.send("new_window", *construction_args)
+        @libui = ControlProxy.new_control(@keyword, construction_args)
         @libui.tap do
           handle_listener('on_closing') do
             destroy

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glimmer-dsl-libui
 version: !ruby/object:Gem::Version
-  version: 0.0.15
+  version: 0.0.16
 platform: ruby
 authors:
 - Andy Maleh
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-09-22 00:00:00.000000000 Z
+date: 2021-09-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: glimmer
@@ -205,7 +205,9 @@ files:
 - lib/glimmer/dsl/libui/tab_item_expression.rb
 - lib/glimmer/libui/about_menu_item_proxy.rb
 - lib/glimmer/libui/box.rb
+- lib/glimmer/libui/button_proxy.rb
 - lib/glimmer/libui/check_menu_item_proxy.rb
+- lib/glimmer/libui/checkbox_proxy.rb
 - lib/glimmer/libui/color_button_proxy.rb
 - lib/glimmer/libui/combobox_proxy.rb
 - lib/glimmer/libui/control_proxy.rb
@@ -217,7 +219,9 @@ files:
 - lib/glimmer/libui/grid_proxy.rb
 - lib/glimmer/libui/group_proxy.rb
 - lib/glimmer/libui/horizontal_box_proxy.rb
+- lib/glimmer/libui/label_proxy.rb
 - lib/glimmer/libui/menu_item_proxy.rb
+- lib/glimmer/libui/menu_proxy.rb
 - lib/glimmer/libui/multiline_entry_proxy.rb
 - lib/glimmer/libui/non_wrapping_multiline_entry_proxy.rb
 - lib/glimmer/libui/preferences_menu_item_proxy.rb