glimmer-dsl-swt 4.18.4.11 → 4.18.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cb72ad5f93c5c27a2f2ead87225e0ee045e2663e50b04346f5be6065fbf269c2
-  data.tar.gz: 394f955a01f7d5b568ae433dcab240f86b48749e5db428296299388ceaff5773
+  metadata.gz: dae230b3e4a50ef2425a4b5155e98ff598e0bb0e3d1f7a5c15eaadcbf5688d41
+  data.tar.gz: 7ec51028f89ec3ff207aecbb2f91ad43b03e1e6db8d03885e681972cdd9fd1f9
 SHA512:
-  metadata.gz: 18dd1f7062fdb14e063820d29168815df77b70f04275559fc812b605d2daf6053815b94579030a749cfc942188115150db093b0f0fc9863247177d112d165d90
-  data.tar.gz: c1809fda609b22045fd5872624cbc234b1353173522f2430767b8f36e4afd096063d5b4fe5fc41b0a24b0f96ec00d9fc0aada8df9537201d1d87fe8eebe26d59
+  metadata.gz: '0954400586b6df73a08070b2f7bd0669b11dca0ecb9ba614e1719b0a41e9966dad2f7d16c5f3b344bb14cbc4074978b793d206d6034dc3ce5034aee98e9732de'
+  data.tar.gz: '086c20606c6319fa70c480b3633d60682723d246a46c7d4f3d2b2e8d3c9ed83f2d22a7e7f3288cc35fb38f11f0895ed3b98b8297ee607767094f179612aabbc2'

data/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Change Log
 
+### 4.18.5.0
+
+- Automatic `sync_exec` usage from threads other than the GUI thread, thus absolving software engineers from the need to use `sync_exec` explicitly anymore.
+- `auto_exec` keyword to automatically use `sync_exec` with SWT code when needed (running from a thread other than GUI thread)
+- Implement `sync_exec:` option in `bind` keyword with table, tree, combo, and list data-binding (other data-binding types than the standard)
+- Add `async_exec` option to `bind` keyword (covering `data_binding_expression.rb` with `async_exec` properly)
+- Support tree multi-selection data-binding
+- Hello, Tree! sample
+- Enhance Hello, Canvas! with Shape Movement
+- Add Jars.lock to scaffold .gitignore file
+- Add Glimmer::GUI alias for Glimmer::UI module, thus permitting inclusion of Glimmer::GUI::CustomWidget, Glimmer::GUI::CustomShell, and Glimmer::GUI::CustomWindow
+- Provide a quick method for grabbing all available cursor/color options off of SWTProxy (SWTProxy.cursor_options, SWTProxy.cursor_styles, SWTProxy.color_options, SWTProxy.color_styles)
+- Remove explicit git gem dependency given that it is installed via juwelier during scaffolding and is not needed otherwise
+- Support partial image shape drawing by passing source and destination dimensions to `image` shape [documented in docs]
+- Support alternate Canvas Shape DSL syntax for `image` by passing nested properties
+- Canvas Shape DSL argument data-binding support for `image`
+- Support alternate Canvas Shape DSL syntax for `rectangle` by passing nested properties
+- Canvas Shape DSL argument data-binding support for `rectangle(x, y, width, height, fill: false)` standard rectangle, which can be optionally filled
+- Canvas Shape DSL argument data-binding support for `rectangle(x, y, width, height, arcWidth = 60, arcHeight = 60, fill: false, round: true)` round rectangle, which can be optionally filled, and takes optional extra round angle arguments
+- Canvas Shape DSL argument data-binding support for `rectangle(x, y, width, height, vertical = true, fill: true, gradient: true)` gradient rectangle, which is always filled, and takes an optional extra argument to specify true for vertical gradient (default) and false for horizontal gradient
+- Canvas Shape DSL argument data-binding support for `arc(x, y, width, height, startAngle, arcAngle, fill: false)` arc is part of a circle within an oval area, denoted by start angle (degrees) and end angle (degrees)
+- Canvas Shape DSL argument data-binding support for `focus(x, y, width, height)` this is just like rectangle but its foreground color is always that of the OS widget focus color (useful when capturing user interaction via a shape)
+- Canvas Shape DSL argument data-binding support for `line(x1, y1, x2, y2)` line
+- Canvas Shape DSL argument data-binding support for `oval(x, y, width, height, fill: false)` oval if width does not match heigh and circle if width matches height. Can be optionally filled.
+- Canvas Shape DSL argument data-binding support for `point(x, y)` point
+- Canvas Shape DSL argument data-binding support for `polygon(pointArray, fill: false)` polygon consisting of points, which close automatically to form a shape that can be optionally filled (when points only form a line, it does not show up as filled)
+- Canvas Shape DSL argument data-binding support for `polyline(pointArray)` polyline is just like a polygon, but it does not close up to form a shape, remaining open (unless the points close themselves by having the last point or an intermediate point match the first)
+- Canvas Shape DSL argument data-binding support for `text(string, x, y, flags = nil)` text with optional flags (flag format is `swt(comma_separated_flags)` where flags can be :draw_delimiter (i.e. new lines), :draw_tab, :draw_mnemonic, and :draw_transparent as explained in [GC API](https://help.eclipse.org/2020-12/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/swt/graphics/GC.html))
+- Update Hello, Button!, Hello, Table! sample, Hello, Checkbox Group! sample, Hello, Radio Group! sample, Hello, Combo! sample, Hello, List Single Selection! sample, Hello, List Multi Selection! sample to utilize a CustomShell
+- Refactor all samples to rely on Glimmer::UI::CustomShell given its new class launch method for productive app declaration
+- Fix issue with logging remaining async in debug mode
+- Fix issue with combo, list, radio group, and checkbox group not supporting nested data-binding
+
 ### 4.18.4.11
 
 - Support creating images pixel by pixel with `image(width, height) {|x,y| [r, g, b]}` keyword, which takes a block with x, y coordinates based on the image width and height and returns a pixel foreground color per point

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 SWT 4.18.4.11
+# [<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 SWT 4.18.5.0
 ## JRuby Desktop Development GUI Framework
 [![Gem Version](https://badge.fury.io/rb/glimmer-dsl-swt.svg)](http://badge.fury.io/rb/glimmer-dsl-swt)
 [![Travis CI](https://travis-ci.com/AndyObtiva/glimmer-dsl-swt.svg?branch=master)](https://travis-ci.com/github/AndyObtiva/glimmer-dsl-swt)
@@ -342,7 +342,7 @@ jgem install glimmer-dsl-swt
 
 Or this command if you want a specific version:
 ```
-jgem install glimmer-dsl-swt -v 4.18.4.11
+jgem install glimmer-dsl-swt -v 4.18.5.0
 ```
 
 `jgem` is JRuby's version of `gem` command.
@@ -360,7 +360,7 @@ Note: if you're using activerecord or activesupport, keep in mind that Glimmer u
 
 Add the following to `Gemfile`:
 ```
-gem 'glimmer-dsl-swt', '~> 4.18.4.11'
+gem 'glimmer-dsl-swt', '~> 4.18.5.0'
 ```
 
 And, then run:
@@ -404,10 +404,12 @@ Glimmer configuration may be done via the `Glimmer::Config` module.
 
 ## Samples
 
-Check the [samples](samples) directory in [glimmer-dsl-swt](https://github.com/AndyObtiva/glimmer-dsl-swt) for examples on how to write Glimmer applications. To run a sample, make sure to install the `glimmer` gem first and then use the `glimmer samples` command to run it (alternatively, you may clone the repo, follow [CONTRIBUTING.md](CONTRIBUTING.md) instructions, and run samples locally with development glimmer command: `bin/glimmer`).
-
 [docs/reference/GLIMMER_SAMPLES.md](docs/reference/GLIMMER_SAMPLES.md)
 
+Check the [samples](samples) directory in [glimmer-dsl-swt](https://github.com/AndyObtiva/glimmer-dsl-swt) for examples on how to write Glimmer applications. To run a sample, make sure to install the `glimmer-dsl-swt` gem first and then use the `glimmer samples` command to run it (alternatively, you may clone the repo, follow [CONTRIBUTING.md](CONTRIBUTING.md) instructions, and run samples locally with development glimmer command: `bin/glimmer`).
+
+![Glimmer Meta-Sample](/images/glimmer-meta-sample.png)
+
 ## In Production
 
 The following production apps have been built with Glimmer.

data/VERSION

@@ -1 +1 @@
-4.18.4.11
+4.18.5.0

data/bin/glimmer

@@ -1,7 +1,7 @@
 #!/usr/bin/env jruby
 
 # Copyright (c) 2007-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
@@ -9,10 +9,10 @@
 # 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

data/docs/reference/GLIMMER_CONFIGURATION.md

@@ -170,11 +170,15 @@ This just tells Glimmer whether to log excluded keywords or not (at the debug le
 
 ### auto_sync_exec
 
-(default = false)
+(default = true)
+
+This automatically uses sync_exec on GUI calls from threads other than the main GUI thread instead of requiring users to manually use sync_exec.
 
-This automatically uses sync_exec on GUI calls from threads other than the main GUI thread instead of requiring users to manually use sync_exec. Default value to false.
+Keep in mind that this could cause redraws on every minor change in the models instead of applying large scope changes together.
+In rare cases where you need to avoid causing stutter in the GUI as a result, you can wrap large-scale GUI updates in `auto_exec` manually.
 
-Keep in mind the caveat that it would force redraws on every minor changein the models instead of applying large scope changes all together, thus causing too much drawing/stutter in the GUI. As such, this is a good fit for simpler GUIs, not ones used with highly sophisticated 2D graphics. It may be mitigated in the future by introducing the idea of large-scale observation events that wrap around smaller events. Until then, keep the caveat in mind or just use sync_exec manually as usually done with Java SWT apps.
+As such, this saves developers a lot of headache by not requiring wrapping every bit of GUI update in other threads with `sync_exec`, yet only
+large scale updates in the rare cases where optimization is needed.
 
 ## License
 

data/docs/reference/GLIMMER_GUI_DSL_SYNTAX.md

@@ -1,7 +1,96 @@
-## Glimmer GUI DSL Syntax
-
 This guide should help you get started with Glimmer DSL for SWT. For more advanced SWT details, please refer to the [SWT Reference](/README.md#swt-reference).
 
+- [Glimmer GUI DSL Syntax](#glimmer-gui-dsl-syntax)
+  - [DSL Auto-Expansion](#dsl-auto-expansion)
+  - [Widgets](#widgets)
+    - [Glimmer GUI DSL Keywords](#glimmer-gui-dsl-keywords)
+    - [SWT Proxies](#swt-proxies)
+      - [swt_widget](#swt_widget)
+      - [Shell widget proxy methods](#shell-widget-proxy-methods)
+      - [Widget Content Block](#widget-content-block)
+      - [Shell Icon](#shell-icon)
+        - [Shell Icon Tip for Packaging on Windows](#shell-icon-tip-for-packaging-on-windows)
+    - [Dialog](#dialog)
+      - [message_box](#message_box)
+    - [Display](#display)
+    - [Multi-Threading](#multi-threading)
+      - [async_exec](#async_exec)
+      - [sync_exec](#sync_exec)
+      - [timer_exec](#timer_exec)
+    - [Menus](#menus)
+    - [ScrolledComposite](#scrolledcomposite)
+    - [Sash Form Widget](#sash-form-widget)
+    - [Browser Widget](#browser-widget)
+  - [Widget Styles](#widget-styles)
+    - [Explicit SWT Style Bit](#explicit-swt-style-bit)
+    - [Negative SWT Style Bits](#negative-swt-style-bits)
+    - [Extra SWT Styles](#extra-swt-styles)
+      - [Non-resizable Window](#non-resizable-window)
+  - [Widget Properties](#widget-properties)
+    - [Color](#color)
+      - [`#swt_color`](#swt_color)
+    - [Font](#font)
+  - [Image](#image)
+    - [Image Options](#image-options)
+  - [Cursor](#cursor)
+  - [Layouts](#layouts)
+  - [Layout Data](#layout-data)
+  - [Canvas Shape DSL](#canvas-shape-dsl)
+    - [Shapes inside a Widget](#shapes-inside-a-widget)
+    - [Shapes inside an Image](#shapes-inside-an-image)
+    - [Canvas Shape API](#canvas-shape-api)
+    - [Pixel Graphics](#pixel-graphics)
+  - [Canvas Transform DSL](#canvas-transform-dsl)
+    - [Top-Level Transform Fluent Interface](#top-level-transform-fluent-interface)
+  - [Canvas Animation DSL](#canvas-animation-dsl)
+    - [Animation via Data-Binding](#animation-via-data-binding)
+  - [Data-Binding](#data-binding)
+    - [General Examples](#general-examples)
+    - [Combo](#combo)
+    - [List](#list)
+    - [Table](#table)
+      - [Table Selection](#table-selection)
+      - [Table Editing](#table-editing)
+      - [Table Sorting](#table-sorting)
+    - [Tree](#tree)
+    - [DateTime](#datetime)
+  - [Observer](#observer)
+    - [Observing Widgets](#observing-widgets)
+      - [Alternative Syntax](#alternative-syntax)
+    - [Observing Models](#observing-models)
+  - [Custom Widgets](#custom-widgets)
+    - [Simple Example](#simple-example)
+      - [Method-Based Custom Widget Example](#method-based-custom-widget-example)
+      - [Class-Based Custom Widget Example](#class-based-custom-widget-example)
+    - [Custom Widget Lifecycle Hooks](#custom-widget-lifecycle-hooks)
+    - [Lifecycle Hooks Example](#lifecycle-hooks-example)
+    - [Custom Widget API](#custom-widget-api)
+    - [Content/Options Example](#contentoptions-example)
+    - [Custom Widget Gotchas](#custom-widget-gotchas)
+    - [Built-In Custom Widgets](#built-in-custom-widgets)
+      - [Checkbox Group Custom Widget](#checkbox-group-custom-widget)
+      - [Radio Group Custom Widget](#radio-group-custom-widget)
+      - [Code Text Custom Widget](#code-text-custom-widget)
+        - [Options](#options)
+      - [Video Custom Custom Widget](#video-custom-custom-widget)
+    - [Custom Widget Final Notes](#custom-widget-final-notes)
+  - [Custom Shells](#custom-shells)
+  - [Drag and Drop](#drag-and-drop)
+  - [Miscellaneous](#miscellaneous)
+    - [Multi-DSL Support](#multi-dsl-support)
+      - [SWT](#swt)
+      - [Opal](#opal)
+      - [XML](#xml)
+      - [CSS](#css)
+      - [Listing / Enabling / Disabling DSLs](#listing--enabling--disabling-dsls)
+    - [Application Menu Items (About/Preferences)](#application-menu-items-aboutpreferences)
+    - [App Name and Version](#app-name-and-version)
+    - [Performance Profiling](#performance-profiling)
+      - [SWT Browser Style Options](#swt-browser-style-options)
+- [License](#license)
+
+## Glimmer GUI DSL Syntax
+
 Glimmer's core is a GUI DSL with a lightweight visual syntax that makes it easy to visualize the nesting of widgets in the GUI hierarchy tree.
 
 It is available through mixing in the `Glimmer` module, which makes [Glimmer GUI DSL Keywords](#glimmer-gui-dsl-keywords) available to both the instance scope and class scope:
@@ -257,6 +346,7 @@ This is not an exaustive list, but should give you a good start in learning Glim
 - `async_exec`: featured in [Hello, Custom Widget!](GLIMMER_SAMPLES.md#hello-custom-widget) / [Hello, Custom Shell!](GLIMMER_SAMPLES.md#hello-custom-shell)
 - `sync_exec`: executes a block on the event loop synchronously (usually from another thread)
 - `timer_exec`: executes a block after a delay of time has passed
+- `auto_exec`: executes a block on the event loop synchronously only when needed (when running from a thread other than GUI thread)
 
 #### SWT Proxies
 
@@ -415,6 +505,11 @@ Most of the time, you simply get away with Ruby [Threads](https://ruby-doc.org/c
 
 Otherwise, if you need more advanced concurrency, Glimmer includes the [concurrent-ruby gem](https://rubygems.org/gems/concurrent-ruby), which supports many helpful concurrency techniques such as [Thread Pools](http://ruby-concurrency.github.io/concurrent-ruby/master/file.thread_pools.html) (used in the [Mandelbrot Fractal](GLIMMER_SAMPLES.md#mandelbrot-fractal) sample).
 
+One thing Glimmer DSL for SWT innovates over plain old SWT is not requiring developers to explicitly use `Display.syncExec` from threads other than the GUI threads.
+Glimmer automatically detects if you're running in a different thread and uses `Display.syncExec` automatically using its own enhanced `auto_exec`
+
+In any case, Glimmer still allows developers to manually use `sync_exec`, `async_exec`, `timer_exec`, and `auto_exec` when needed. M
+
 ##### async_exec
 
 `async_exec {}` is a Glimmer DSL keyword in addition to being a method on `display`. It accepts a block and when invoked, adds the block to the end of a queue of GUI events scheduled to run on the SWT event loop, executing asynchronously.
@@ -445,7 +540,11 @@ Thread.new {
 
 ##### sync_exec
 
-`sync_exec {}` works just like `async_exec` except it executes the block synchronously at the earliest opportunity possible, waiting for the block to be finished.
+`sync_exec {}` is required by SWT when running GUI update from a thread other than the GUI thread. In Glimmer, it is automatically invoked for you so that you wouldn't have to worry about it. It works just like `async_exec` except it executes the block synchronously at the earliest opportunity possible, waiting for the block to be finished.
+
+##### auto_exec
+
+`auto_exec(override_sync_exec:, override_async_exec) {}` only executes code block with `sync_exec` when necessary (running from a thread other than the GUI thread). It is used automatically all over the Glimmer DSL for SWT codebase, so you wouldn't need it unless you grab a direct handle on `swt_widget` from a widget proxy.
 
 ##### timer_exec
 
@@ -1296,6 +1395,7 @@ Shape keywords and their args (including defaults) are listed below (they basica
 - `arc(x, y, width, height, startAngle, arcAngle, fill: false)` arc is part of a circle within an oval area, denoted by start angle (degrees) and end angle (degrees)
 - `focus(x, y, width, height)` this is just like rectangle but its foreground color is always that of the OS widget focus color (useful when capturing user interaction via a shape)
 - `image(image, x = 0, y = 0)` sets [image](#image), which could be an [org.eclipse.swt.graphics.Image](https://help.eclipse.org/2020-12/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/swt/graphics/Image.html) object or just a file path string
+- `image(image, source_x, source_y, source_width, source_height, destination_x, destination_y, destination_width, destination_height)` sets part of an [image](#image) and scales it to fit destination dimensions on parent canvas/widget
 - `line(x1, y1, x2, y2)` line
 - `oval(x, y, width, height, fill: false)` oval if width does not match heigh and circle if width matches height. Can be optionally filled.
 - `point(x, y)` point
@@ -1515,6 +1615,16 @@ shell {
 
 ![Image Shape DSL](/images/glimmer-example-image-shape-dsl-app-switcher-icon.png)
 
+#### Canvas Shape API
+
+These Canvas Shape API methods help with manipulating shapes upon user interaction, such as mouse clicking a specific shape.
+
+- `WidgetProxy#shape_at_location(x, y)` : returns shape object at x, y location from a widget proxy like canvas
+- `Shape#include?(x, y)` : indicates if shape includes x, y point (`arc` and `oval` shapes currently include their entire rectangular region in their checks, `text` shapes always return false)
+- `Shape#move_by(x_delta, y_delta)` : moves shape object at x, y location
+
+Check [Hello, Canvas!](GLIMMER_SAMPLES.md#hello-canvas) for an example.
+
 #### Pixel Graphics
 
 **(Early Alpha Feature)**
@@ -1876,11 +1986,15 @@ This example adds on the one above it by specifying converters on read and write
 
 `text bind(contact, 'address.street', sync_exec: true)`
 
-This example adds does GUI updates via [sync_exec](#sync_exec) assuming they are coming from another thread (different from the GUI thread)
+**(ALPHA FEATURE)**
+
+This example forces GUI updates via [sync_exec](#sync_exec) assuming they are coming from another thread (different from the GUI thread)
 
 `text bind(contact, 'address.street', async_exec: true)`
 
-This example adds does GUI updates via [async_exec](#async_exec) assuming they are coming from another thread (different from the GUI thread)
+**(ALPHA FEATURE)**
+
+This example forces GUI updates via [async_exec](#async_exec) assuming they are coming from another thread (different from the GUI thread)
 
 `text bind(contact, 'address.street', on_read: lambda { |s| s[0..10] })`
 
@@ -2317,6 +2431,8 @@ This finds the root node. The array is a Java array. This enables easy passing o
 To edit a tree, you must invoke `TreeProxy#edit_selected_tree_item` or `TreeProxy#edit_tree_item`. This automatically leverages the SWT TreeEditor custom class behind the scenes, displaying
 a text widget to the user to change the selected or passed tree item text into something else. It automatically persists the change to `items` data-bound model on ENTER/FOCUS-OUT or cancels on ESC/NO-CHANGE.
 
+Learn more at the [Hello, Tree!](GLIMMER_SAMPLES.md#hello-tree) and [Gladiator](GLIMMER_SAMPLES.md#gladiator) samples.
+
 #### DateTime
 
 `date_time` represents the SWT DateTime widget.

data/docs/reference/GLIMMER_SAMPLES.md

@@ -1,5 +1,3 @@
-## Samples
-
 - [Samples](#samples)
   - [Hello Samples](#hello-samples)
     - [Hello, World!](#hello-world)
@@ -37,6 +35,7 @@
     - [Hello, Canvas Transform!](#hello-canvas-transform)
     - [Hello, Cursor!](#hello-cursor)
     - [Hello, Progress Bar!](#hello-progress-bar)
+    - [Hello, Tree!](#hello-tree)
   - [Elaborate Samples](#elaborate-samples)
     - [User Profile](#user-profile)
     - [Login](#login)
@@ -50,7 +49,9 @@
     - [Timer](#timer)
 - [License](#license)
 
-Check the [samples](/samples) directory in [glimmer-dsl-swt](https://github.com/AndyObtiva/glimmer-dsl-swt) for examples on how to write Glimmer applications. To run a sample, make sure to install the `glimmer` gem first and then use the `glimmer samples` command to run it (alternatively, you may clone the repo, follow [CONTRIBUTING.md](CONTRIBUTING.md) instructions, and run samples locally with development glimmer command: `bin/glimmer`).
+## Samples
+
+Check the [samples](/samples) directory in [glimmer-dsl-swt](https://github.com/AndyObtiva/glimmer-dsl-swt) for examples on how to write Glimmer applications. To run a sample, make sure to install the `glimmer-dsl-swt` gem first and then use the `glimmer samples` command to run it (alternatively, you may clone the repo, follow [CONTRIBUTING.md](CONTRIBUTING.md) instructions, and run samples locally with development glimmer command: `bin/glimmer`).
 
 You may run any sample via this command:
 
@@ -607,7 +608,7 @@ This sample demonstrates the use of the `progress_bar` widget keyword.
 
 It includes an `:indeterminate` progress bar on top, for cases when you could not calculate progress, but still want to inform the user there is an operation happening in the background.
 
-Below it, there are a determinate `:horizontal` (default) progress bar and a `:vertical` progress bar. 
+Below it, there are a determinate `:horizontal` (default) progress bar and a `:vertical` progress bar.
 
 Code:
 
@@ -617,6 +618,18 @@ Hello, Progress Bar!
 
 ![Hello Progress Bar](/images/glimmer-hello-progress-bar.gif)
 
+#### Hello, Tree!
+
+This sample demonstrates the use of the `tree` widget along with tree data-binding.
+
+Code:
+
+[samples/hello/hello_tree.rb](/samples/hello/hello_tree.rb)
+
+Hello, Tree!
+
+![Hello Tree](/images/glimmer-hello-tree.png)
+
 ### Elaborate Samples
 
 For more elaborate samples, check the following:

data/glimmer-dsl-swt.gemspec

@@ -2,16 +2,16 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Juwelier::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: glimmer-dsl-swt 4.18.4.11 ruby lib
+# stub: glimmer-dsl-swt 4.18.5.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "glimmer-dsl-swt".freeze
-  s.version = "4.18.4.11"
+  s.version = "4.18.5.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
   s.authors = ["AndyMaleh".freeze]
-  s.date = "2021-02-19"
+  s.date = "2021-02-22"
   s.description = "Glimmer DSL for SWT (JRuby Desktop Development GUI Framework) is a native-GUI cross-platform desktop development library written in JRuby, an OS-threaded faster JVM version of Ruby. Glimmer's main innovation is a declarative Ruby DSL that enables productive and efficient authoring of desktop application user-interfaces by relying on the robust Eclipse SWT library. Glimmer additionally innovates by having built-in data-binding support, which greatly facilitates synchronizing the GUI with domain models, thus achieving true decoupling of object oriented components and enabling developers to solve business problems (test-first) without worrying about GUI concerns, or alternatively drive development GUI-first, and then write clean business models (test-first) afterwards. Not only does Glimmer provide a large set of GUI widgets, but it also supports drawing Canvas Graphics like Shapes and Animations. To get started quickly, Glimmer offers scaffolding options for Apps, Gems, and Custom Widgets. Glimmer also includes native-executable packaging support, sorely lacking in other libraries, thus enabling the delivery of desktop apps written in Ruby as truly native DMG/PKG/APP files on the Mac + App Store, MSI/EXE files on Windows, and Gem Packaged Shell Scripts on Linux.".freeze
   s.email = "andy.am@gmail.com".freeze
   s.executables = ["glimmer".freeze, "girb".freeze]
@@ -58,6 +58,7 @@ Gem::Specification.new do |s|
     "lib/glimmer/data_binding/widget_binding.rb",
     "lib/glimmer/dsl/swt/animation_expression.rb",
     "lib/glimmer/dsl/swt/async_exec_expression.rb",
+    "lib/glimmer/dsl/swt/auto_exec_expression.rb",
     "lib/glimmer/dsl/swt/bind_expression.rb",
     "lib/glimmer/dsl/swt/block_property_expression.rb",
     "lib/glimmer/dsl/swt/checkbox_group_selection_data_binding_expression.rb",
@@ -115,6 +116,16 @@ Gem::Specification.new do |s|
     "lib/glimmer/swt/custom/drawable.rb",
     "lib/glimmer/swt/custom/radio_group.rb",
     "lib/glimmer/swt/custom/shape.rb",
+    "lib/glimmer/swt/custom/shape/arc.rb",
+    "lib/glimmer/swt/custom/shape/focus.rb",
+    "lib/glimmer/swt/custom/shape/image.rb",
+    "lib/glimmer/swt/custom/shape/line.rb",
+    "lib/glimmer/swt/custom/shape/oval.rb",
+    "lib/glimmer/swt/custom/shape/point.rb",
+    "lib/glimmer/swt/custom/shape/polygon.rb",
+    "lib/glimmer/swt/custom/shape/polyline.rb",
+    "lib/glimmer/swt/custom/shape/rectangle.rb",
+    "lib/glimmer/swt/custom/shape/text.rb",
     "lib/glimmer/swt/date_time_proxy.rb",
     "lib/glimmer/swt/directory_dialog_proxy.rb",
     "lib/glimmer/swt/display_proxy.rb",
@@ -142,6 +153,7 @@ Gem::Specification.new do |s|
     "lib/glimmer/swt/tree_proxy.rb",
     "lib/glimmer/swt/widget_listener_proxy.rb",
     "lib/glimmer/swt/widget_proxy.rb",
+    "lib/glimmer/ui.rb",
     "lib/glimmer/ui/custom_shell.rb",
     "lib/glimmer/ui/custom_widget.rb",
     "lib/glimmer/util/proc_tracker.rb",
@@ -202,6 +214,7 @@ Gem::Specification.new do |s|
     "samples/hello/hello_tab.rb",
     "samples/hello/hello_table.rb",
     "samples/hello/hello_table/baseball_park.png",
+    "samples/hello/hello_tree.rb",
     "samples/hello/hello_world.rb",
     "vendor/swt/linux/swt.jar",
     "vendor/swt/mac/swt.jar",
@@ -217,12 +230,11 @@ Gem::Specification.new do |s|
     s.specification_version = 4
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<glimmer>.freeze, ["~> 1.1.1"])
+      s.add_runtime_dependency(%q<glimmer>.freeze, ["~> 1.1.2"])
       s.add_runtime_dependency(%q<super_module>.freeze, [">= 1.4.1", "< 2.0.0"])
       s.add_runtime_dependency(%q<nested_inherited_jruby_include_package>.freeze, [">= 0.3.0", "< 2.0.0"])
       s.add_runtime_dependency(%q<puts_debuggerer>.freeze, [">= 0.11.0", "< 2.0.0"])
       s.add_runtime_dependency(%q<rake-tui>.freeze, [">= 0.2.3", "< 2.0.0"])
-      s.add_runtime_dependency(%q<git>.freeze, ["= 1.8.1"])
       s.add_runtime_dependency(%q<logging>.freeze, [">= 2.3.0", "< 3.0.0"])
       s.add_runtime_dependency(%q<os>.freeze, [">= 1.0.0", "< 2.0.0"])
       s.add_runtime_dependency(%q<rake>.freeze, [">= 10.1.0", "< 14.0.0"])
@@ -236,12 +248,11 @@ Gem::Specification.new do |s|
       s.add_development_dependency(%q<simplecov>.freeze, ["~> 0.16.1"])
       s.add_development_dependency(%q<simplecov-lcov>.freeze, ["~> 0.7.0"])
     else
-      s.add_dependency(%q<glimmer>.freeze, ["~> 1.1.1"])
+      s.add_dependency(%q<glimmer>.freeze, ["~> 1.1.2"])
       s.add_dependency(%q<super_module>.freeze, [">= 1.4.1", "< 2.0.0"])
       s.add_dependency(%q<nested_inherited_jruby_include_package>.freeze, [">= 0.3.0", "< 2.0.0"])
       s.add_dependency(%q<puts_debuggerer>.freeze, [">= 0.11.0", "< 2.0.0"])
       s.add_dependency(%q<rake-tui>.freeze, [">= 0.2.3", "< 2.0.0"])
-      s.add_dependency(%q<git>.freeze, ["= 1.8.1"])
       s.add_dependency(%q<logging>.freeze, [">= 2.3.0", "< 3.0.0"])
       s.add_dependency(%q<os>.freeze, [">= 1.0.0", "< 2.0.0"])
       s.add_dependency(%q<rake>.freeze, [">= 10.1.0", "< 14.0.0"])
@@ -256,12 +267,11 @@ Gem::Specification.new do |s|
       s.add_dependency(%q<simplecov-lcov>.freeze, ["~> 0.7.0"])
     end
   else
-    s.add_dependency(%q<glimmer>.freeze, ["~> 1.1.1"])
+    s.add_dependency(%q<glimmer>.freeze, ["~> 1.1.2"])
     s.add_dependency(%q<super_module>.freeze, [">= 1.4.1", "< 2.0.0"])
     s.add_dependency(%q<nested_inherited_jruby_include_package>.freeze, [">= 0.3.0", "< 2.0.0"])
     s.add_dependency(%q<puts_debuggerer>.freeze, [">= 0.11.0", "< 2.0.0"])
     s.add_dependency(%q<rake-tui>.freeze, [">= 0.2.3", "< 2.0.0"])
-    s.add_dependency(%q<git>.freeze, ["= 1.8.1"])
     s.add_dependency(%q<logging>.freeze, [">= 2.3.0", "< 3.0.0"])
     s.add_dependency(%q<os>.freeze, [">= 1.0.0", "< 2.0.0"])
     s.add_dependency(%q<rake>.freeze, [">= 10.1.0", "< 14.0.0"])