glimmer-dsl-tk 0.0.53 → 0.0.54

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4bc998830956c028c331da19e9238e69fe15198a0c2741af217cd15cae8fceb8
-  data.tar.gz: '040971d080dae49ebcb201631802566bcb415ddcd72ca623d6cca350c4587058'
+  metadata.gz: 556b89d33cee530135e72cd6f31a79a355db86cf45bbacfd65dbf14b8184b4c3
+  data.tar.gz: 7c5c0750b19380e8561a16e7789273bd742d33e50294d8100cd5759b6fa2d329
 SHA512:
-  metadata.gz: a573287857c8f89fb58226dc6c8f1c1629f5a7f7c2dac59952e3459738ba582b89539cc1365a8ebe0134d0c132e62757677fb438480a20b93f25c346846b20f8
-  data.tar.gz: 404e13705e7354d5e0bb2ae15993c7b17d09e77cb7161e111ab5dc908bbe18523501dffc041ff7ce69a71fb70db8d1cca8ef306fbab26f9d07faa2e5933eca53
+  metadata.gz: 2c25d0b5f8a677a82adf158fa7685a4dfb1e4ea006d4fc6a134d1046c3468e3af1261f37aa66678f802a0f4b0d6b2951ea49bf89cab76db89bcedd92d8eb78cd
+  data.tar.gz: 4bc9c4b2dd59849206e95f85118b230735d72bfb06810fa38fb39a71d4fc3419dc4415b1d5261a465dbf07a0b4d183a673f75f24872a8f4b2ece0f362bde1ad3

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Change Log
 
+## 0.0.54
+
+- Hello, Labelframe!
+- Add default padding to `labelframe`
+
 ## 0.0.53
 
 - Support menu item accelerators that include or end with function keys (e.g. `'Alt+F4'`)

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 Tk 0.0.53
+# [<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.54
 ## 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)
@@ -6,8 +6,6 @@
 [![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)
 
-**[Contributors Wanted! (Submit a Glimmer App Sample to Get Started)](CONTRIBUTING.md)**
-
 [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 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).
@@ -53,13 +51,19 @@ Glimmer app:
 
 NOTE: Glimmer DSL for Tk is currently in early alpha mode (only about 44% complete). If you want it developed faster, then [open an issue report](https://github.com/AndyObtiva/glimmer-dsl-tk/issues/new). I have completed some features much faster before due to [issue reports](https://github.com/AndyObtiva/glimmer-dsl-tk/issues) and [pull requests](https://github.com/AndyObtiva/glimmer-dsl-tk/pulls). Please help make better by contributing, adopting for small or low risk projects, and providing feedback. It is still an early alpha, so the more feedback and issues you report the better.
 
-Other [Glimmer](https://github.com/AndyObtiva/glimmer) DSL gems you might be interested in:
-- [glimmer-dsl-swt](https://github.com/AndyObtiva/glimmer-dsl-swt): Glimmer DSL for SWT (JRuby Desktop Development GUI Framework)
-- [glimmer-dsl-opal](https://github.com/AndyObtiva/glimmer-dsl-opal): Glimmer DSL for Opal (Pure Ruby Web GUI and Auto-Webifier of Desktop Apps)
-- [glimmer-dsl-libui](https://github.com/AndyObtiva/glimmer-dsl-libui): Glimmer DSL for LibUI (Prerequisite-Free Ruby Desktop Development GUI Library)
-- [glimmer-dsl-gtk](https://github.com/AndyObtiva/glimmer-dsl-gtk): Glimmer DSL for GTK (Ruby-GNOME Desktop Development GUI Library)
-- [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)
+**[Glimmer](https://rubygems.org/gems/glimmer) DSL Comparison Table:**
+DSL | Platforms | Native? | Vector Graphics? | Pros | Cons | Prereqs
+----|-----------|---------|------------------|------|------|--------
+[Glimmer DSL for SWT (JRuby Desktop Development GUI Framework)](https://github.com/AndyObtiva/glimmer-dsl-swt) | Mac / Windows / Linux | Yes | Yes (Canvas Shape DSL) | Very Mature / Scaffolding / Native Executable Packaging / Custom Widgets | Slow JRuby Startup Time / Heavy Memory Footprint | Java / JRuby
+[Glimmer DSL for Opal (Pure Ruby Web GUI and Auto-Webifier of Desktop Apps)](https://github.com/AndyObtiva/glimmer-dsl-opal) | All Web Browsers | No | Yes (Canvas Shape DSL) | Simpler than All JavaScript Technologies / Auto-Webify Desktop Apps | Setup Process / Incomplete Alpha | Rails
+[Glimmer DSL for LibUI (Prerequisite-Free Ruby Desktop Development GUI Library)](https://github.com/AndyObtiva/glimmer-dsl-libui) | Mac / Windows / Linux | Yes | Yes (Area API) | Fast Startup Time / Light Memory Footprint | LibUI is an Incomplete Mid-Alpha Only | None Other Than MRI Ruby
+[Glimmer DSL for Tk (MRI Ruby Desktop Development GUI Library)](https://github.com/AndyObtiva/glimmer-dsl-tk) | Mac / Windows / Linux | Some Native-Themed Widgets (Not Truly Native) | Yes (Canvas) | Fast Startup Time / Light Memory Footprint | Complicated setup / Widgets Do Not Look Truly Native, Espcially on Linux | ActiveTcl / MRI Ruby
+[Glimmer DSL for GTK (Ruby-GNOME Desktop Development GUI Library)](https://github.com/AndyObtiva/glimmer-dsl-gtk) | Mac / Windows / Linux | Only on Linux | Yes (Cairo) | Complete Access to GNOME Features on Linux (Forte) | Not Native on Mac and Windows | None Other Than MRI Ruby on Linux / Brew Packages on Mac / MSYS & MING Toolchains on Windows / MRI Ruby
+[Glimmer DSL for FX (FOX Toolkit Ruby Desktop Development GUI Library)](https://github.com/AndyObtiva/glimmer-dsl-fx) | Mac (requires XQuartz) / Windows / Linux | No | Yes (Canvas) | No Prerequisites on Windows (Forte Since Binaries Are Included Out of The Box) | Widgets Do Not Look Native / Mac Usage Obtrusively Starts XQuartz | None Other Than MRI Ruby on Windows / XQuarts on Mac / MRI Ruby
+[Glimmer DSL for JFX (JRuby JavaFX Desktop Development GUI Library)](https://github.com/AndyObtiva/glimmer-dsl-jfx) | Mac / Windows / Linux | No | Yes (javafx.scene.shape and javafx.scene.canvas) | Rich in Custom Widgets | Slow JRuby Startup Time / Heavy Memory Footprint / Widgets Do Not Look Native | Java / JRuby / JavaFX SDK
+[Glimmer DSL for Swing (JRuby Swing Desktop Development GUI Library)](https://github.com/AndyObtiva/glimmer-dsl-swing) | Mac / Windows / Linux | No | Yes (Java2D) | Very Mature | Slow JRuby Startup Time / Heavy Memory Footprint / Widgets Do Not Look Native | Java / JRuby
+[Glimmer DSL for XML (& HTML)](https://github.com/AndyObtiva/glimmer-dsl-xml) | All Web Browsers | No | Yes (SVG) | Programmable / Lighter-weight Than Actual XML | XML Elements Are Sometimes Not Well-Named (Many Types of Input) | None
+[Glimmer DSL for CSS](https://github.com/AndyObtiva/glimmer-dsl-css) | All Web Browsers | No | Yes | Programmable | CSS Is Over-Engineered / Too Many Features To Learn | None
 
 ## Table of Contents
 
@@ -127,6 +131,7 @@ Other [Glimmer](https://github.com/AndyObtiva/glimmer) DSL gems you might be int
     - [Hello, Scrollbar Frame!](#hello-scrollbar-frame)
     - [Hello, Menu Bar!](#hello-menu-bar)
     - [Hello, Contextual Menu!](#hello-contextual-menu)
+    - [Hello, Labelframe!](#hello-labelframe)
   - [Applications](#applications)
     - [Glimmer Tk Calculator](#glimmer-tk-calculator)
     - [Y3network Ruby UI](#y3network-ruby-ui)
@@ -186,7 +191,7 @@ gem install glimmer-dsl-tk
 
 Add the following to `Gemfile`:
 ```
-gem 'glimmer-dsl-tk', '0.0.53'
+gem 'glimmer-dsl-tk', '0.0.54'
 ```
 
 And, then run:
@@ -3726,6 +3731,169 @@ Glimmer app:
 
 ![glimmer dsl tk screenshot sample hello contextual-menu](images/glimmer-dsl-tk-screenshot-sample-hello-contextual-menu.png)
 
+### Hello, Labelframe!
+
+Glimmer code (from [samples/hello/hello_labelframe.rb](samples/hello/hello_labelframe.rb)):
+
+```ruby
+require 'glimmer-dsl-tk'
+
+include Glimmer
+
+root {
+  title 'Hello, Labelframe!'
+  
+  labelframe {
+    grid column: 0, row: 0, padx: 10, pady: 10
+    text 'Name:'
+    # labelanchor 'nw' # Default. Other options: 'n', 'ne', 'en', 'e', 'es', 'se', 's', 'sw', 'ws', 'w', 'wn'
+    
+    label {
+      grid column: 0, row: 0, sticky: 'w'
+      text 'First Name:'
+    }
+    entry {
+      grid column: 1, row: 0
+      width 15
+    }
+    
+    label {
+      grid column: 0, row: 1, sticky: 'w'
+      text 'Last Name:'
+    }
+    entry {
+      grid column: 1, row: 1
+      width 15
+    }
+  }
+  
+  labelframe {
+    grid column: 0, row: 1, padx: 10, pady: 10
+    text 'Address:'
+    
+    label {
+      grid column: 0, row: 0, sticky: 'w'
+      text 'Street:'
+    }
+    entry {
+      grid column: 1, row: 0
+      width 15
+    }
+    
+    label {
+      grid column: 0, row: 1, sticky: 'w'
+      text 'City:'
+    }
+    entry {
+      grid column: 1, row: 1
+      width 15
+    }
+    
+    label {
+      grid column: 0, row: 2, sticky: 'w'
+      text 'State:'
+    }
+    entry {
+      grid column: 1, row: 2
+      width 15
+    }
+    
+    label {
+      grid column: 0, row: 3, sticky: 'w'
+      text 'Zip:'
+    }
+    entry {
+      grid column: 1, row: 3
+      width 15
+    }
+  }
+  
+  labelframe {
+    grid column: 1, row: 0, rowspan: 2, padx: 10, pady: 10
+    text 'Medical Info:'
+    
+    label {
+      grid column: 0, row: 0, sticky: 'w'
+      text 'Family Doctor:'
+    }
+    entry {
+      grid column: 1, row: 0
+      width 15
+    }
+    
+    label {
+      grid column: 0, row: 1, sticky: 'w'
+      text 'Chronic Conditions:'
+    }
+    entry {
+      grid column: 1, row: 1
+      width 15
+    }
+    
+    label {
+      grid column: 0, row: 2, sticky: 'w'
+      text 'Past Surgeries:'
+    }
+    entry {
+      grid column: 1, row: 2
+      width 15
+    }
+    
+    label {
+      grid column: 0, row: 3, sticky: 'w'
+      text 'Health Insurance Info:'
+    }
+    entry {
+      grid column: 1, row: 3
+      width 15
+    }
+    
+    label {
+      grid column: 0, row: 4, sticky: 'w'
+      text 'Dental Insurance Info:'
+    }
+    entry {
+      grid column: 1, row: 4
+      width 15
+    }
+    
+    label {
+      grid column: 0, row: 5, sticky: 'w'
+      text 'Diet:'
+    }
+    entry {
+      grid column: 1, row: 5
+      width 15
+    }
+    
+    label {
+      grid column: 0, row: 6, sticky: 'w'
+      text 'Exercise:'
+    }
+    entry {
+      grid column: 1, row: 6
+      width 15
+    }
+  }
+}.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_labelframe'"
+```
+
+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_labelframe.rb
+```
+
+Glimmer app:
+
+![glimmer dsl tk screenshot sample hello label-frame](images/glimmer-dsl-tk-screenshot-sample-hello-labelframe.png)
+
 ## Applications
 
 ### Glimmer Tk Calculator

data/VERSION

@@ -1 +1 @@
-0.0.53
+0.0.54

data/lib/glimmer/tk/labelframe_proxy.rb

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

data/samples/hello/hello_labelframe.rb

@@ -0,0 +1,161 @@
+# Copyright (c) 2020-2022 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, Labelframe!'
+  
+  labelframe {
+    grid column: 0, row: 0, padx: 10, pady: 10
+    text 'Name:'
+    # labelanchor 'nw' # Default. Other options: 'n', 'ne', 'en', 'e', 'es', 'se', 's', 'sw', 'ws', 'w', 'wn'
+    
+    label {
+      grid column: 0, row: 0, sticky: 'w'
+      text 'First Name:'
+    }
+    entry {
+      grid column: 1, row: 0
+      width 15
+    }
+    
+    label {
+      grid column: 0, row: 1, sticky: 'w'
+      text 'Last Name:'
+    }
+    entry {
+      grid column: 1, row: 1
+      width 15
+    }
+  }
+  
+  labelframe {
+    grid column: 0, row: 1, padx: 10, pady: 10
+    text 'Address:'
+    
+    label {
+      grid column: 0, row: 0, sticky: 'w'
+      text 'Street:'
+    }
+    entry {
+      grid column: 1, row: 0
+      width 15
+    }
+    
+    label {
+      grid column: 0, row: 1, sticky: 'w'
+      text 'City:'
+    }
+    entry {
+      grid column: 1, row: 1
+      width 15
+    }
+    
+    label {
+      grid column: 0, row: 2, sticky: 'w'
+      text 'State:'
+    }
+    entry {
+      grid column: 1, row: 2
+      width 15
+    }
+    
+    label {
+      grid column: 0, row: 3, sticky: 'w'
+      text 'Zip:'
+    }
+    entry {
+      grid column: 1, row: 3
+      width 15
+    }
+  }
+  
+  labelframe {
+    grid column: 1, row: 0, rowspan: 2, padx: 10, pady: 10
+    text 'Medical Info:'
+    
+    label {
+      grid column: 0, row: 0, sticky: 'w'
+      text 'Family Doctor:'
+    }
+    entry {
+      grid column: 1, row: 0
+      width 15
+    }
+    
+    label {
+      grid column: 0, row: 1, sticky: 'w'
+      text 'Chronic Conditions:'
+    }
+    entry {
+      grid column: 1, row: 1
+      width 15
+    }
+    
+    label {
+      grid column: 0, row: 2, sticky: 'w'
+      text 'Past Surgeries:'
+    }
+    entry {
+      grid column: 1, row: 2
+      width 15
+    }
+    
+    label {
+      grid column: 0, row: 3, sticky: 'w'
+      text 'Health Insurance Info:'
+    }
+    entry {
+      grid column: 1, row: 3
+      width 15
+    }
+    
+    label {
+      grid column: 0, row: 4, sticky: 'w'
+      text 'Dental Insurance Info:'
+    }
+    entry {
+      grid column: 1, row: 4
+      width 15
+    }
+    
+    label {
+      grid column: 0, row: 5, sticky: 'w'
+      text 'Diet:'
+    }
+    entry {
+      grid column: 1, row: 5
+      width 15
+    }
+    
+    label {
+      grid column: 0, row: 6, sticky: 'w'
+      text 'Exercise:'
+    }
+    entry {
+      grid column: 1, row: 6
+      width 15
+    }
+  }
+}.open

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glimmer-dsl-tk
 version: !ruby/object:Gem::Version
-  version: 0.0.53
+  version: 0.0.54
 platform: ruby
 authors:
 - AndyMaleh
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-01-22 00:00:00.000000000 Z
+date: 2022-02-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: glimmer
@@ -213,6 +213,7 @@ files:
 - lib/glimmer/tk/entry_proxy.rb
 - lib/glimmer/tk/frame_proxy.rb
 - lib/glimmer/tk/label_proxy.rb
+- lib/glimmer/tk/labelframe_proxy.rb
 - lib/glimmer/tk/lbl_proxy.rb
 - lib/glimmer/tk/list_proxy.rb
 - lib/glimmer/tk/menu_item_proxy.rb
@@ -242,6 +243,7 @@ files:
 - samples/hello/hello_entry.rb
 - samples/hello/hello_frame.rb
 - samples/hello/hello_label.rb
+- samples/hello/hello_labelframe.rb
 - samples/hello/hello_list_multi_selection.rb
 - samples/hello/hello_list_single_selection.rb
 - samples/hello/hello_menu_bar.rb