glimmer-dsl-tk 0.0.15 → 0.0.20

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 12e68b40c6fb5c056f778d8864b88a01adb69ee4c0fe4273cc007a7d8d589cb9
-  data.tar.gz: 16281eeb0be0b1556390c42504f82d879ae6e13f427875215454f8a5d8949706
+  metadata.gz: 9b35ad7e7ce829ab16c8ded93da64a71120483982e1799afddf538ff0726d686
+  data.tar.gz: 6a5eec2b8c52f7df03d1f324780cc3b209b2969fe04ab64dc33efc8a1b3d05e7
 SHA512:
-  metadata.gz: 07ec8746537d220b0b768715f29f5796543f497c1054c55796b8a23ae0ac83c4007d545d378b3ac7896893f68a1a2f2d0b11a0bbd002254cddb5369d7d6a5653
-  data.tar.gz: aae794b82923901cd227d899fa914978e168fb8c35ff8433ccda048d7845e346aa9b74b001d91cc7779dcbe588cad46817fac48aa7c3ec3be1332ebf9ce80852
+  metadata.gz: 3b462e07684dc68a0c15096ea80cd5a516ac9332a1ba21f2235e85b5343b174561446d62633aa2dfc280557ff01531872fd3a033aafc1bf0eec6386b8b4d9901
+  data.tar.gz: 79dba86d404165e841ad94d034799bf3ba10e52fc286bdaa2af3d85b80d0ada8a075396f229e2de498fcea61274722cb8dacd762e68fb7243a9754b57e6221fe

data/CHANGELOG.md

@@ -1,5 +1,42 @@
 # Change Log
 
+## 0.0.20
+
+- Hello, Root! sample
+- Support `root` `width`, `height`, `x`, `y` attributes
+- Support `root` attribute: `resizable`
+- Support `root` attribute: `minsize`
+- Support `root` attribute: `maxsize`
+- Set minimum width/height on `root` (190 pixels)
+
+## 0.0.18
+
+- Hello, Frame! sample
+- Avoid setting grid geometry manager on `toplevel` widget
+- Support `frame` `width` and `height` attributes
+- Support `frame` `borderwidth` attribute
+- Support `frame` `relief` attribute
+- Support `frame` `padding` attribute
+- Rename Hello, Tab! to Hello, Notebook!
+
+## 0.0.17
+
+- Hello, Label! sample
+- Support `label` `anchor` attribute (`'e'`, `'se'`, `'s'`, `'sw'`, `'w'`, `'nw'` or `'center'`)
+- Support `label` `width` attributes
+- Support `label` `image` attribute
+- Support `label` `justify` attribute (`'left', 'center', 'right'`)
+- Support `label` `font` attribute (`'default', 'text', 'fixed', 'menu', 'heading', 'caption', 'small_caption', 'icon', 'tooltip'`)
+- Support `label` `foreground` attribute
+- Support `label` `background` attribute (note that it does not work in Mac 'aqua' theme)
+- Support `label` `compound` attribute
+- Support `label` `relief` attributes (`'flat' (default), 'raised', 'sunken', 'solid', 'ridge', 'groove'`)
+
+## 0.0.16
+
+- Support common themed widget state attributes: `active`, `disabled`, `focus`, `pressed`, `selected`, `background`, `readonly`, `alternate`, `invalid`, and `hover`
+- Update Hello, Button! to utilize `focus true` in first button.
+
 ## 0.0.15
 
 - Update Hello, Button! to demo all button attributes

data/README.md

@@ -1,6 +1,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 Tk 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 Tk 0.0.20
 ## MRI Ruby Desktop Development GUI Library
 [![Gem Version](https://badge.fury.io/rb/glimmer-dsl-tk.svg)](http://badge.fury.io/rb/glimmer-dsl-tk)
+[![Ruby](https://github.com/AndyObtiva/glimmer-dsl-tk/actions/workflows/ruby.yml/badge.svg)](https://github.com/AndyObtiva/glimmer-dsl-tk/actions/workflows/ruby.yml)
 [![Coverage Status](https://coveralls.io/repos/github/AndyObtiva/glimmer-dsl-tk/badge.svg?branch=master)](https://coveralls.io/github/AndyObtiva/glimmer-dsl-tk?branch=master)
 [![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)
@@ -9,7 +10,7 @@
 
 [Glimmer](https://github.com/AndyObtiva/glimmer) DSL for [Tk](https://www.tcl.tk/) enables desktop development with [Glimmer](https://github.com/AndyObtiva/glimmer) in [Ruby](https://github.com/ruby/ruby).
 
-[Tcl/Tk](https://www.tcl.tk/) has evolved into a practical desktop GUI toolkit due to gaining native looking themed 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.).
+[Tcl/Tk](https://www.tcl.tk/) has recently improved by gaining native looking themed 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](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).
 
@@ -61,6 +62,56 @@ Other [Glimmer](https://github.com/AndyObtiva/glimmer) DSL gems:
 - [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)
 
+## Table of Contents
+
+- [Glimmer DSL for Tk](#)
+  - [MRI Ruby Desktop Development GUI Library](#mri-ruby-desktop-development-gui-library)
+  - [Pre-requisites](#pre-requisites)
+  - [Setup](#setup)
+    - [Option 1: Install](#option-1-install)
+    - [Option 2: Bundler](#option-2-bundler)
+  - [Girb (Glimmer IRB)](#girb-glimmer-irb)
+  - [Tk Concepts](#tk-concepts)
+  - [Glimmer GUI DSL Concepts](#glimmer-gui-dsl-concepts)
+    - [Supported Widgets](#supported-widgets)
+      - [Common Attributes](#common-attributes)
+      - [Common Themed Widget States](#common-themed-widget-states)
+    - [Smart Defaults and Convensions](#smart-defaults-and-convensions)
+      - [Grid Layout](#grid-layout)
+      - [Label/Button Image](#labelbutton-image)
+      - [Notebook Frame](#notebook-frame)
+      - [Icon Photo](#icon-photo)
+  - [The Grid Geometry Manager](#the-grid-geometry-manager)
+  - [Bidirectional Data-Binding](#bidirectional-data-binding)
+    - [General Property Data-Binding](#general-property-data-binding)
+    - [Combobox Data-Binding](#combobox-data-binding)
+    - [List Single Selection Data-Binding](#list-single-selection-data-binding)
+    - [List Multi Selection Data-Binding](#list-multi-selection-data-binding)
+    - [Entry Data-Binding](#entry-data-binding)
+  - [Command Observer](#command-observer)
+  - [Gotchas](#gotchas)
+  - [Samples](#samples)
+    - [Hello, World!](#hello-world)
+    - [Hello, Button!](#hello-button)
+    - [Hello, Frame!](#hello-frame)
+    - [Hello, Root!](#hello-root)
+    - [Hello, Notebook!](#hello-notebook)
+    - [Hello, Label!](#hello-label)
+    - [Hello, Message Box!](#hello-message-box)
+    - [Hello, Combobox!](#hello-combobox)
+    - [Hello, List Single Selection!](#hello-list-single-selection)
+    - [Hello, List Multi Selection!](#hello-list-multi-selection)
+    - [Hello, Computed!](#hello-computed)
+  - [Help](#help)
+    - [Issues](#issues)
+    - [Chat](#chat)
+  - [Process](#process)
+  - [Planned Features and Feature Suggestions](#planned-features-and-feature-suggestions)
+  - [Change Log](#change-log)
+  - [Contributing](#contributing)
+  - [Contributors](#contributors)
+  - [License](#license)
+
 ## Pre-requisites
 
 - [Tcl/Tk](https://www.tcl.tk/): Follow the [install instructions](https://tkdocs.com/tutorial/install.html)
@@ -87,7 +138,7 @@ gem install glimmer-dsl-tk
 
 Add the following to `Gemfile`:
 ```
-gem 'glimmer-dsl-tk', '~> 0.0.15'
+gem 'glimmer-dsl-tk', '~> 0.0.20'
 ```
 
 And, then run:
@@ -134,7 +185,7 @@ Example of an app written in [Tk](https://www.tcl.tk/) imperative syntax:
 
 ```ruby
 root = TkRoot.new
-root.title = 'Hello, Tab!'
+root.title = 'Hello, Notebook!'
 
 notebook = ::Tk::Tile::Notebook.new(root).grid
 
@@ -155,7 +206,7 @@ Example of the same app written in [Glimmer](https://github.com/AndyObtiva/glimm
 
 ```ruby
 root {
-  title 'Hello, Tab!'
+  title 'Hello, Notebook!'
    
   notebook {
     frame(text: 'English') {
@@ -175,12 +226,12 @@ root {
 
 ### Supported Widgets
 
-keyword(args) | attributes | listeners / events / bindings / callbacks
+keyword(args) | attributes | event bindings & callbacks
 ------------- | ---------- | ---------
-`button` | `text`, `image`, `compound` (`'center', 'top', 'bottom', 'left', 'right'`), `default` (`'active', 'normal'`) | `command`
+`button` | `text`, `image` (optional keyword args: `subsample`, `zoom`, `from`, `to`, `shrink`, `compositingrule`), `compound` (`'center', 'top', 'bottom', 'left', 'right'`), `default` (`'active', 'normal'`) | `command`
 `entry` | `width`, `text` | None
-`frame(text: )` | None | None
-`label` | `text` | None
+`frame(text: nil)` | `width`, `height`, `borderwidth`, `relief` (`'flat' (default), 'raised', 'sunken', 'solid', 'ridge', 'groove'`) | None
+`label` | `text`, `image` (optional keyword args: `subsample`, `zoom`, `from`, `to`, `shrink`, `compositingrule`), `compound` (`'center', 'top', 'bottom', 'left', 'right'`), `font` (`'default', 'text', 'fixed', 'menu', 'heading', 'caption', 'small_caption', 'icon', 'tooltip'`), `relief` (`'flat' (default), 'raised', 'sunken', 'solid', 'ridge', 'groove'`), `justify` (`'left', 'center', 'right'`), `foreground`, `background` | None
 `list` | `selectmode`, `selection` | None
 `message_box(type: , message: , detail: , title: , icon: , default: , parent: )` | None | None
 `notebook` | None | None
@@ -188,7 +239,20 @@ keyword(args) | attributes | listeners / events / bindings / callbacks
 
 #### Common Attributes
 
-- `grid`
+- `grid`: `Hash` of `:row`, `:column`, `:padx`, `:pady`, `:sticky` (`'e', 'w', 'n', 's'` or any combination of direction letters)
+
+#### Common Themed Widget States
+
+- `active?`
+- `disabled?`
+- `focus?`
+- `pressed?`
+- `selected?`
+- `background?`
+- `readonly?`
+- `alternate?`
+- `invalid?`
+- `hover?`
 
 ### Smart Defaults and Convensions
 
@@ -196,6 +260,14 @@ keyword(args) | attributes | listeners / events / bindings / callbacks
 
 `grid` layout is the default on most widgets (which support it).
 
+#### Label/Button Image
+
+Label and Button `image` attribute can accept image path directly as an alternative to `TkPhotoImage` object in addition to key values for automatic processing of image (`subsample`, `zoom`, `from`, `to`, `shrink`, `compositingrule`)
+
+#### Notebook Frame
+
+When nesting `frame` under `notebook`, you can pass a `:text` keyword argument to indicate the tab title.
+
 #### Icon Photo
 
 The `iconphoto` attribute on `root` is set to the Glimmer icon by default if no icon photo is supplied.
@@ -362,6 +434,10 @@ This resets the person country.
 
 More details can be found in the [Hello, Combobox!](#hello-combobox) sample below.
 
+## Gotchas
+
+- Setting `background` attribute on `frame` or `label` does not work in `'aqua'` theme on the Mac (only in `'classic'` theme)
+
 ## Samples
 
 ### Hello, World!
@@ -429,6 +505,7 @@ class HelloButton
         button {
           text <= [self, :count, on_read: ->(value) { "Click To Increment: #{value}  " }]
           default 'active'
+          focus true
           
           command {
             self.count += 1
@@ -496,48 +573,284 @@ Glimmer app:
 
 ![glimmer dsl tk screenshot sample hello button](images/glimmer-dsl-tk-screenshot-sample-hello-button.png)
 
-### Hello, Tab!
+### Hello, Frame!
 
-Glimmer code (from [samples/hello/hello_tab.rb](samples/hello/hello_tab.rb)):
+Glimmer code (from [samples/hello/hello_frame.rb](samples/hello/hello_frame.rb)):
 
 ```ruby
+require 'glimmer-dsl-tk'
+
+class HelloFrame
+  include Glimmer
+  
+  def launch
+    root {
+      title 'Hello, Frame!'
+      
+      frame { # frame simply contains widgets for visual organization via a layout
+        relief 'sunken'
+        
+        label {
+          grid row: 0, column: 0, columnspan: 4, padx: 5, pady: 5
+          text 'Enter Your Full Name'
+          font 'caption'
+          anchor 'center'
+        }
+
+        label {
+          grid row: 1, column: 0, padx: 5
+          text "First Name:"
+        }
+        
+        entry {
+          grid row: 1, column: 1, padx: 5
+        }
+        
+        label {
+          grid row: 2, column: 0, padx: 5
+          text "Last Name:"
+        }
+        
+        entry {
+          grid row: 2, column: 1, padx: 5
+        }
+      }
+      
+      frame { # an empty frame can specify width and height
+        grid padx: 7, pady: 7
+        width 200
+        height 100
+        borderwidth 3
+        relief 'sunken'
+      }
+    }.open
+  end
+end
+
+HelloFrame.new.launch
+```
+
+Run with [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed:
+
+```
+ruby -r glimmer-dsl-tk -e "require 'samples/hello/hello_frame'"
+```
+
+Alternatively, run from cloned project without [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed:
+
+```
+ruby -r ./lib/glimmer-dsl-tk.rb ./samples/hello/hello_frame.rb
+```
+
+Glimmer app:
+
+![glimmer dsl tk screenshot sample hello frame](images/glimmer-dsl-tk-screenshot-sample-hello-frame.png)
+
+### Hello, Root!
+
+Glimmer code (from [samples/hello/hello_frame.rb](samples/hello/hello_frame.rb)):
+
+```ruby
+require 'glimmer-dsl-tk'
+
 include Glimmer
 
 root {
-  title 'Hello, Tab!'
-   
-  notebook {
-    frame(text: 'English') {
-      label {
-        text 'Hello, World!'
+  title 'Hello, Root!'
+  width 400
+  height 200
+  x 150
+  y 300
+  resizable true # same as `resizable true, true`, meaning cannot resize horizontally and vertically
+  minsize 200, 100
+  maxsize 600, 400
+}.open
+```
+
+Run with [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed:
+
+```
+ruby -r glimmer-dsl-tk -e "require 'samples/hello/hello_root'"
+```
+
+Alternatively, run from cloned project without [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed:
+
+```
+ruby -r ./lib/glimmer-dsl-tk.rb ./samples/hello/hello_root.rb
+```
+
+### Hello, Notebook!
+
+Glimmer code (from [samples/hello/hello_notebook.rb](samples/hello/hello_notebook.rb)):
+
+```ruby
+require 'glimmer-dsl-tk'
+
+class HelloNotebook
+  include Glimmer
+  
+  def launch
+    root {
+      title 'Hello, Notebook!'
+       
+      notebook {
+        frame(text: 'English') {
+          label {
+            text 'Hello, World!'
+          }
+        }
+         
+        frame(text: 'French') {
+          label {
+            text 'Bonjour, Univers!'
+          }
+        }
       }
-    }
-     
-    frame(text: 'French') {
-      label {
-        text 'Bonjour, Univers!'
+    }.open
+  end
+end
+
+HelloNotebook.new.launch
+```
+
+Run with [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed:
+
+```
+ruby -r glimmer-dsl-tk -e "require 'samples/hello/hello_notebook'"
+```
+
+Alternatively, run from cloned project without [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed:
+
+```
+ruby -r ./lib/glimmer-dsl-tk.rb ./samples/hello/hello_notebook.rb
+```
+
+Glimmer app:
+
+![glimmer dsl tk screenshot sample hello notebook English](images/glimmer-dsl-tk-screenshot-sample-hello-notebook-english.png)
+![glimmer dsl tk screenshot sample hello notebook French](images/glimmer-dsl-tk-screenshot-sample-hello-notebook-french.png)
+
+### Hello, Label!
+
+Glimmer code (from [samples/hello/hello_label.rb](samples/hello/hello_label.rb)):
+
+```ruby
+require 'glimmer-dsl-tk'
+
+class HelloLabel
+  include Glimmer
+  
+  LABEL_FONTS = ['default', 'text', 'fixed', 'menu', 'heading', 'caption', 'small_caption', 'icon', 'tooltip']
+  LABEL_RELIEFS = ['flat', 'raised', 'sunken', 'solid', 'ridge', 'groove']
+  
+  def launch
+    root {
+      title 'Hello, Label!'
+      
+      notebook {
+        frame(text: 'left-aligned') {
+          3.times do |n|
+            label {
+              text "Field #{n + 1} / default font / flat relief"
+              width 60
+              anchor 'w'
+            }
+          end
+        }
+        
+        frame(text: 'centered') {
+          9.times do |n|
+            label {
+              text "Field #{n + 1} / fixed font / raised relief"
+              width 80
+              anchor 'center'
+              font 'fixed'
+              relief 'raised'
+            }
+          end
+        }
+        
+        frame(text: 'right-aligned') {
+          9.times do |n|
+            label {
+              text "Field #{n + 1} / small_caption font / ridge relief"
+              width 80
+              anchor 'e'
+              font 'small_caption'
+              relief 'ridge'
+            }
+          end
+        }
+        
+        frame(text: 'justified') {
+          label {
+            text <<~MULTI_LINE_STRING
+              This is a very long paragraph that spans multiple lines. It looks better and
+              is easier to read when justified. In fact, this is how to make it look like a
+              new paper column. That results in professional looking text. Magazines use the
+              same sort of justified text. Word processors also support justified text. In
+              fact, this is how text is made for news papers and magainzes, and then published
+              in paper form and digitally.
+            MULTI_LINE_STRING
+            width 60
+            anchor 'center'
+            justify 'center' # other options are: 'left' and 'right'
+            font 'caption' # other options are: 'default', 'text', 'fixed', 'menu', 'heading', 'small_caption', 'icon', 'tooltip'
+            foreground 'blue'
+            relief 'sunken' # other options are: 'flat' (default), 'raised', 'solid', 'ridge', 'groove'
+          }
+        }
+        
+        frame(text: 'images') {
+          ['denmark', 'finland', 'norway'].each do |image_name|
+            label {
+              image File.expand_path("images/#{image_name}.png", __dir__)
+            }
+          end
+        }
+        
+        frame(text: 'background images') {
+          ['italy', 'france', 'mexico'].each do |image_name|
+            label {
+              text image_name.capitalize
+              image File.expand_path("images/#{image_name}.png", __dir__)
+              compound 'center'
+            }
+          end
+        }
       }
-    }
-  }
-}.open
+    }.open
+  end
+end
+
+HelloLabel.new.launch
 ```
 
 Run with [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed:
 
 ```
-ruby -r glimmer-dsl-tk -e "require 'samples/hello/hello_tab'"
+ruby -r glimmer-dsl-tk -e "require 'samples/hello/hello_label'"
 ```
 
 Alternatively, run from cloned project without [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed:
 
 ```
-ruby -e "require './lib/glimmer-dsl-tk'; require './samples/hello/hello_tab'"
+ruby -r ./lib/glimmer-dsl-tk.rb ./samples/hello/hello_label.rb
 ```
 
 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)
+![glimmer dsl tk screenshot sample hello label left aligned](images/glimmer-dsl-tk-screenshot-sample-hello-label-left-aligned.png)
+
+![glimmer dsl tk screenshot sample hello label centered](images/glimmer-dsl-tk-screenshot-sample-hello-label-centered.png)
+
+![glimmer dsl tk screenshot sample hello label right aligned](images/glimmer-dsl-tk-screenshot-sample-hello-label-right-aligned.png)
+
+![glimmer dsl tk screenshot sample hello label justified](images/glimmer-dsl-tk-screenshot-sample-hello-label-justified.png)
+
+![glimmer dsl tk screenshot sample hello label images](images/glimmer-dsl-tk-screenshot-sample-hello-label-images.png)
+
+![glimmer dsl tk screenshot sample hello label background images](images/glimmer-dsl-tk-screenshot-sample-hello-label-background-images.png)
 
 ### Hello, Message Box!
 
@@ -618,13 +931,13 @@ root { |r|
 Run with [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed:
 
 ```
-ruby -r glimmer-dsl-tk -e "require 'samples/hello/hello_tab'"
+ruby -r glimmer-dsl-tk -e "require 'samples/hello/hello_message_box'"
 ```
 
 Alternatively, run from cloned project without [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed:
 
 ```
-ruby -e "require './lib/glimmer-dsl-tk'; require './samples/hello/hello_tab'"
+ruby -r ./lib/glimmer-dsl-tk.rb ./samples/hello/hello_message_box.rb
 ```
 
 Glimmer app:
@@ -665,7 +978,7 @@ ruby -r glimmer-dsl-tk -e "require 'samples/hello/hello_combobox'"
 Alternatively, run from cloned project without [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed:
 
 ```
-ruby -e "require './lib/glimmer-dsl-tk'; require './samples/hello/hello_combobox'"
+ruby -r ./lib/glimmer-dsl-tk.rb ./samples/hello/hello_combobox.rb
 ```
 
 Glimmer app:
@@ -705,7 +1018,7 @@ ruby -r glimmer-dsl-tk -e "require 'samples/hello/hello_list_single_selection'"
 Alternatively, run from cloned project without [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed:
 
 ```
-ruby -e "require './lib/glimmer-dsl-tk'; require './samples/hello/hello_list_single_selection'"
+ruby -r ./lib/glimmer-dsl-tk.rb ./samples/hello/hello_list_single_selection.rb
 ```
 
 Glimmer app:
@@ -743,7 +1056,7 @@ ruby -r glimmer-dsl-tk -e "require 'samples/hello/hello_list_multi_selection'"
 Alternatively, run from cloned project without [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed:
 
 ```
-ruby -e "require './lib/glimmer-dsl-tk'; require './samples/hello/hello_list_multi_selection'"
+ruby -r ./lib/glimmer-dsl-tk.rb ./samples/hello/hello_list_multi_selection.rb
 ```
 
 Glimmer app:
@@ -823,7 +1136,7 @@ ruby -r glimmer-dsl-tk -e "require 'samples/hello/hello_computed'"
 Alternatively, run from cloned project without [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed:
 
 ```
-ruby -e "require './lib/glimmer-dsl-tk'; require './samples/hello/hello_computed'"
+ruby -r ./lib/glimmer-dsl-tk.rb ./samples/hello/hello_computed.rb
 ```
 
 Glimmer app:

data/VERSION

@@ -1 +1 @@
-0.0.15
+0.0.20

data/lib/glimmer/tk/label_proxy.rb

@@ -27,14 +27,14 @@ module Glimmer
     #
     # Follows the Proxy Design Pattern
     class LabelProxy < WidgetProxy
-      # TODO specify attribute setters
-#       def tk_widget_has_attribute_setter?(attribute)
-#         if ['anchor', 'justify'].include?(attribute.to_s)
-#           true
-#         else
-#           super
-#         end
-#       end
+      def set_attribute(attribute, *args)
+        if attribute.to_s == 'font'
+          args[0] = "tk_#{args[0]}_font".camelcase(:upper) if (args[0].is_a?(Symbol) || args[0].is_a?(String)) && args[0].to_s == args[0].to_s.downcase
+          super
+        else
+          super
+        end
+      end
     end
   end
 end

data/lib/glimmer/tk/root_proxy.rb

@@ -27,8 +27,13 @@ module Glimmer
     #
     # Follows the Proxy Design Pattern
     class RootProxy < WidgetProxy
+      REGEX_GEOMETRY = /[x+-]/
+      DEFAULT_WIDTH = 190
+      DEFAULT_HEIGHT = 95
+      
       def initialize(*args)
         @tk = ::TkRoot.new
+        @tk.minsize = DEFAULT_WIDTH, DEFAULT_HEIGHT
       end
 
       def post_add_content
@@ -43,19 +48,114 @@ module Glimmer
         Glimmer::DSL::Engine.add_content(self, Glimmer::DSL::Tk::RootExpression.new, keyword, *args, &block)
       end
       
+      def has_attribute?(attribute, *args)
+        %w[width height x y].include?(attribute.to_s) || super
+      end
+      
       def set_attribute(attribute, *args)
-        if attribute.to_s == 'iconphoto'
+        case attribute.to_s
+        when 'iconphoto'
           args[0..-1] = [image_argument(args)]
           super
+        when 'width'
+          @width = args.first.to_i
+          self.geometry = "#{args.first.to_i}x#{@height || DEFAULT_HEIGHT}#{x_sign}#{abs_x}#{y_sign}#{abs_y}"
+        when 'height'
+          @height = args.first.to_i
+          self.geometry = "#{@width || DEFAULT_WIDTH}x#{args.first.to_i}#{x_sign}#{abs_x}#{y_sign}#{abs_y}"
+        when 'x'
+          self.geometry = "#{@width || DEFAULT_WIDTH}x#{@height || DEFAULT_HEIGHT}#{args.first.to_i > 0 ? '+' : '-'}#{args.first.to_i.abs}#{y_sign}#{abs_y}"
+        when 'y'
+          self.geometry = "#{@width || DEFAULT_WIDTH}x#{@height || DEFAULT_HEIGHT}#{x_sign}#{abs_x}#{args.first.to_i > 0 ? '+' : '-'}#{args.first.to_i.abs}"
+        when 'resizable'
+          if args.size == 1 && !args.first.is_a?(Array)
+            self.resizable = [args.first]*2
+          else
+            super
+          end
         else
           super
         end
       end
-
+      
+      def get_attribute(attribute)
+        attribute = attribute.to_s
+        case attribute
+        when 'width'
+          geometry.split(REGEX_GEOMETRY)[0].to_i
+        when 'height'
+          geometry.split(REGEX_GEOMETRY)[1].to_i
+        when 'x'
+          sign_number(x_sign, geometry.split(REGEX_GEOMETRY)[2].to_i)
+        when 'y'
+          sign_number(y_sign, geometry.split(REGEX_GEOMETRY)[3].to_i)
+        else
+          super
+        end
+      end
+      
+      def width
+        get_attribute(:width)
+      end
+      
+      def height
+        get_attribute(:height)
+      end
+      
+      def x
+        get_attribute(:x)
+      end
+      
+      def y
+        get_attribute(:y)
+      end
+      
+      def width=(value)
+        set_attribute(:width, value)
+      end
+      
+      def height=(value)
+        set_attribute(:height, value)
+      end
+      
+      def x=(value)
+        set_attribute(:x, value)
+      end
+      
+      def y=(value)
+        set_attribute(:y, value)
+      end
+      
       # Starts Tk mainloop
       def start_event_loop
         ::Tk.mainloop
       end
+      
+      private
+      
+      def sign_number(sign, number)
+        "#{sign}1".to_i * number
+      end
+      
+      def abs_x
+        geometry.split(REGEX_GEOMETRY)[2].to_i
+      end
+      
+      def abs_y
+        geometry.split(REGEX_GEOMETRY)[3].to_i
+      end
+      
+      def x_sign
+        geometry_signs[0]
+      end
+      
+      def y_sign
+        geometry_signs[1]
+      end
+      
+      def geometry_signs
+        geometry.chars.select {|char| char.match(/[+-]/)}
+      end
     end
   end
 end

data/lib/glimmer/tk/widget_proxy.rb

@@ -85,7 +85,7 @@ module Glimmer
         tk_widget_class = self.class.tk_widget_class_for(underscored_widget_name)
         @tk = tk_widget_class.new(@parent_proxy.tk, *args)
         # a common widget initializer
-        @tk.grid
+        @tk.grid unless @tk.is_a?(::Tk::Toplevel)
         DEFAULT_INITIALIZERS[underscored_widget_name]&.call(@tk)
         @parent_proxy.post_initialize_child(self)
       end
@@ -117,13 +117,34 @@ module Glimmer
       end
       
       def tk_widget_has_attribute_getter_setter?(attribute)
-        @tk.respond_to?(attribute)
+        begin
+          # TK Widget currently doesn't support respond_to? properly, so I have to resort to this trick for now
+          @tk.send(attribute)
+          true
+        rescue
+          false
+        end
+      end
+      
+      def has_state?(attribute)
+        attribute = attribute.sub(/\?$/, '').sub(/=$/, '')
+        if @tk.respond_to?(:tile_state)
+          begin
+            @tk.tile_instate(attribute)
+            true
+          rescue
+            false
+          end
+        else
+          false
+        end
       end
       
       def has_attribute?(attribute, *args)
-        (widget_custom_attribute_mapping[tk.class] && widget_custom_attribute_mapping[tk.class][attribute.to_s]) ||
-          tk_widget_has_attribute_setter?(attribute) ||
-          tk_widget_has_attribute_getter_setter?(attribute) ||
+        (widget_custom_attribute_mapping[tk.class] and widget_custom_attribute_mapping[tk.class][attribute.to_s]) or
+          tk_widget_has_attribute_setter?(attribute) or
+          tk_widget_has_attribute_getter_setter?(attribute) or
+          has_state?(attribute) or
           respond_to?(attribute_setter(attribute), args)
       end
 
@@ -132,9 +153,22 @@ module Glimmer
         if widget_custom_attribute
           widget_custom_attribute[:setter][:invoker].call(@tk, args)
         elsif tk_widget_has_attribute_setter?(attribute)
-          @tk.send(attribute_setter(attribute), *args) unless @tk.send(attribute) == args.first
+          unless args.size == 1 && @tk.send(attribute) == args.first
+            if args.size == 1
+              @tk.send(attribute_setter(attribute), *args)
+            else
+              @tk.send(attribute_setter(attribute), args)
+            end
+          end
         elsif tk_widget_has_attribute_getter_setter?(attribute)
           @tk.send(attribute, *args)
+        elsif has_state?(attribute)
+          attribute = attribute.sub(/=$/, '')
+          if !!args.first
+            @tk.tile_state(attribute)
+          else
+            @tk.tile_state("!#{attribute}")
+          end
         else
           send(attribute_setter(attribute), args)
         end
@@ -146,6 +180,8 @@ module Glimmer
           widget_custom_attribute[:getter][:invoker].call(@tk, args)
         elsif tk_widget_has_attribute_getter_setter?(attribute)
           @tk.send(attribute)
+        elsif has_state?(attribute)
+          @tk.tile_instate(attribute.sub(/\?$/, ''))
         else
           send(attribute)
         end
@@ -159,8 +195,8 @@ module Glimmer
         @widget_custom_attribute_mapping ||= {
           ::Tk::Tile::TButton => {
             'image' => {
-              getter: {name: 'image', invoker: lambda { |widget, args| @tk.textvariable&.value }},
-              setter: {name: 'image=', invoker: lambda { |widget, args| @tk['image'] = image_argument(args) }},
+              getter: {name: 'image', invoker: lambda { |widget, args| @tk.image }},
+              setter: {name: 'image=', invoker: lambda { |widget, args| @tk.image = image_argument(args) }},
             },
           },
           ::Tk::Tile::TCombobox => {
@@ -174,6 +210,10 @@ module Glimmer
               getter: {name: 'text', invoker: lambda { |widget, args| @tk.textvariable&.value }},
               setter: {name: 'text=', invoker: lambda { |widget, args| @tk.textvariable&.value = args.first }},
             },
+            'image' => {
+              getter: {name: 'image', invoker: lambda { |widget, args| @tk.image }},
+              setter: {name: 'image=', invoker: lambda { |widget, args| @tk.image = image_argument(args) }},
+            },
           },
           ::Tk::Tile::TEntry => {
             'text' => {
@@ -244,9 +284,9 @@ module Glimmer
 
       def method_missing(method, *args, &block)
         method = method.to_s
-        if args.empty? && block.nil? && widget_custom_attribute_mapping[tk.class] && widget_custom_attribute_mapping[tk.class][method]
+        if args.empty? && block.nil? && ((widget_custom_attribute_mapping[tk.class] && widget_custom_attribute_mapping[tk.class][method]) || has_state?(method))
           get_attribute(method)
-        elsif widget_custom_attribute_mapping[tk.class] && widget_custom_attribute_mapping[tk.class][method.sub(/=$/, '')] && method.end_with?('=') && block.nil?
+        elsif method.end_with?('=') && block.nil? && ((widget_custom_attribute_mapping[tk.class] && widget_custom_attribute_mapping[tk.class][method.sub(/=$/, '')]) || has_state?(method))
           set_attribute(method.sub(/=$/, ''), *args)
         else
           tk.send(method, *args, &block)

data/samples/hello/hello_button.rb

@@ -42,9 +42,10 @@ class HelloButton
           text 'Text Button'
         }
         
-        button {
+        button { |b|
           text <= [self, :count, on_read: ->(value) { "Click To Increment: #{value}  " }]
           default 'active'
+          focus true
           
           command {
             self.count += 1

data/samples/hello/hello_frame.rb

@@ -0,0 +1,71 @@
+# Copyright (c) 2020-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-dsl-tk'
+
+class HelloFrame
+  include Glimmer
+  
+  def launch
+    root {
+      title 'Hello, Frame!'
+      
+      frame { # frame simply contains widgets for visual organization via a layout
+        relief 'sunken'
+        
+        label {
+          grid row: 0, column: 0, columnspan: 4, padx: 5, pady: 5
+          text 'Enter Your Full Name'
+          font 'caption'
+          anchor 'center'
+        }
+
+        label {
+          grid row: 1, column: 0, padx: 5
+          text "First Name:"
+        }
+        
+        entry {
+          grid row: 1, column: 1, padx: 5
+        }
+        
+        label {
+          grid row: 2, column: 0, padx: 5
+          text "Last Name:"
+        }
+        
+        entry {
+          grid row: 2, column: 1, padx: 5
+        }
+      }
+      
+      frame { # an empty frame can specify width and height
+        grid padx: 7, pady: 7
+        width 200
+        height 100
+        borderwidth 3
+        relief 'sunken'
+      }
+    }.open
+  end
+end
+
+HelloFrame.new.launch

data/samples/hello/hello_label.rb

@@ -0,0 +1,110 @@
+# Copyright (c) 2020-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-dsl-tk'
+
+class HelloLabel
+  include Glimmer
+  
+  LABEL_FONTS = ['default', 'text', 'fixed', 'menu', 'heading', 'caption', 'small_caption', 'icon', 'tooltip']
+  LABEL_RELIEFS = ['flat', 'raised', 'sunken', 'solid', 'ridge', 'groove']
+  
+  def launch
+    root {
+      title 'Hello, Label!'
+      
+      notebook {
+        frame(text: 'left-aligned') {
+          3.times do |n|
+            label {
+              text "Field #{n + 1} / default font / flat relief"
+              width 60
+              anchor 'w'
+            }
+          end
+        }
+        
+        frame(text: 'centered') {
+          9.times do |n|
+            label {
+              text "Field #{n + 1} / fixed font / raised relief"
+              width 80
+              anchor 'center'
+              font 'fixed'
+              relief 'raised'
+            }
+          end
+        }
+        
+        frame(text: 'right-aligned') {
+          9.times do |n|
+            label {
+              text "Field #{n + 1} / small_caption font / ridge relief"
+              width 80
+              anchor 'e'
+              font 'small_caption'
+              relief 'ridge'
+            }
+          end
+        }
+        
+        frame(text: 'justified') {
+          label {
+            text <<~MULTI_LINE_STRING
+              This is a very long paragraph that spans multiple lines. It looks better and
+              is easier to read when justified. In fact, this is how to make it look like a
+              new paper column. That results in professional looking text. Magazines use the
+              same sort of justified text. Word processors also support justified text. In
+              fact, this is how text is made for news papers and magainzes, and then published
+              in paper form and digitally.
+            MULTI_LINE_STRING
+            width 60
+            anchor 'center'
+            justify 'center' # other options are: 'left' and 'right'
+            font 'caption' # other options are: 'default', 'text', 'fixed', 'menu', 'heading', 'small_caption', 'icon', 'tooltip'
+            foreground 'blue'
+            relief 'sunken' # other options are: 'flat' (default), 'raised', 'solid', 'ridge', 'groove'
+          }
+        }
+        
+        frame(text: 'images') {
+          ['denmark', 'finland', 'norway'].each do |image_name|
+            label {
+              image File.expand_path("images/#{image_name}.png", __dir__)
+            }
+          end
+        }
+        
+        frame(text: 'background images') {
+          ['italy', 'france', 'mexico'].each do |image_name|
+            label {
+              text image_name.capitalize
+              image File.expand_path("images/#{image_name}.png", __dir__)
+              compound 'center'
+            }
+          end
+        }
+      }
+    }.open
+  end
+end
+
+HelloLabel.new.launch

data/samples/hello/{hello_tab.rb → hello_notebook.rb}

@@ -21,12 +21,12 @@
 
 require 'glimmer-dsl-tk'
 
-class HelloTab
+class HelloNotebook
   include Glimmer
   
   def launch
     root {
-      title 'Hello, Tab!'
+      title 'Hello, Notebook!'
        
       notebook {
         frame(text: 'English') {
@@ -45,4 +45,4 @@ class HelloTab
   end
 end
 
-HelloTab.new.launch
+HelloNotebook.new.launch

data/samples/hello/hello_root.rb

@@ -0,0 +1,35 @@
+# Copyright (c) 2020-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-dsl-tk'
+
+include Glimmer
+
+root {
+  title 'Hello, Root!'
+  width 400
+  height 200
+  x 150
+  y 300
+  resizable true # same as `resizable true, true`, meaning cannot resize horizontally and vertically
+  minsize 200, 100
+  maxsize 600, 400
+}.open

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glimmer-dsl-tk
 version: !ruby/object:Gem::Version
-  version: 0.0.15
+  version: 0.0.20
 platform: ruby
 authors:
 - AndyMaleh
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-10-09 00:00:00.000000000 Z
+date: 2021-10-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: glimmer
@@ -66,20 +66,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 3.5.0
-- !ruby/object:Gem::Dependency
-  name: rdoc
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.12'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.12'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -142,6 +128,20 @@ dependencies:
     - - '='
       - !ruby/object:Gem::Version
         version: 0.8.23
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.5.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.5.1
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -170,7 +170,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.7.0
-description: Glimmer DSL for Tk (Ruby Desktop Development GUI Library)
+description: Glimmer DSL for Tk (MRI Ruby Desktop Development GUI Library)
 email: andy.am@gmail.com
 executables:
 - girb
@@ -214,11 +214,23 @@ files:
 - samples/hello/hello_combobox.rb
 - samples/hello/hello_computed.rb
 - samples/hello/hello_computed/contact.rb
+- samples/hello/hello_frame.rb
+- samples/hello/hello_label.rb
 - samples/hello/hello_list_multi_selection.rb
 - samples/hello/hello_list_single_selection.rb
 - samples/hello/hello_message_box.rb
-- samples/hello/hello_tab.rb
+- samples/hello/hello_notebook.rb
+- samples/hello/hello_root.rb
 - samples/hello/hello_world.rb
+- samples/hello/images/denmark.png
+- samples/hello/images/finland.png
+- samples/hello/images/france.png
+- samples/hello/images/germany.png
+- samples/hello/images/italy.png
+- samples/hello/images/mexico.png
+- samples/hello/images/netherlands.png
+- samples/hello/images/norway.png
+- samples/hello/images/usa.png
 homepage: http://github.com/AndyObtiva/glimmer-dsl-tk
 licenses:
 - MIT