glimmer-dsl-swt 4.25.0.2 → 4.26.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 33dcda40fcdf220f308eacd22b6fa2071fd80f9bd8cd5cbc7d56c53f9e74fbb5
-  data.tar.gz: 94874ac017afdbf04fe7d9c56f95ca5a6c9fd3c242db6414c55b23ddc9016c75
+  metadata.gz: 64899b22884e8dfc8b0a6f166485e404c56fcbdb134a2a71d237873d7cf58420
+  data.tar.gz: bbb1aa3ca961e50306ebf3475c71020e1cdc49f02db2b090abb6e8d773edb59d
 SHA512:
-  metadata.gz: 60ad5e3647148971dd5dd11d6689d49d43dbad002d8a63df882f072c3bc2ac77cc01cabb0442483b33910c71f5a6c7c0aad418ef7fce73e8833097b0148ac669
-  data.tar.gz: 27cadffe2d34a89dfbbad5159441adca861e91f57c76c4e7bf257624abbcb1b63f5d84fc87bc4aba4dbc42425298975e79089ac48eecf46bdedf1a47ce448e41
+  metadata.gz: b6a61eaf29771e2e3dd549ac97debf2d7d241aac5092da177591ed6630549f3b9197291eacfc678a56dd647a02afe3d1a3d6a48ab7b1eeeb31f9b154a542f99c
+  data.tar.gz: a8d235d26a235e33ab4c36b417580f732325ae7cff526867d3878540d6a492e86ef35cf2cfd2016b3b5b302f36b3bfa2d3b323d86139e81b5c7486fd3ff63ca3

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Change Log
 
+## 4.26.0.0
+
+- Upgrade to SWT 4.26
+- Ensure that scaffolded custom widget (red label) uses SWT constants passed to custom widget
+- Update sash form weights in Meta Sample for bigger monitors (give more space to code)
+- Pass border to multi-line lists since it will not be included by default anymore given they are overridden with :multi SWT style
+
 ## 4.25.0.2
 
 - Fix issue with Hello, Label! crashing because image width is getting passed as 0 and the new SWT 4.25 ImageData API rejecting it as not a valid argument

data/README.md

@@ -1,5 +1,6 @@
-# [<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.25.0.2
+# [<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.26.0.0
 ## JRuby Desktop Development GUI Framework
+### The Quickest Way From Zero To GUI
 [![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)
 [![Coverage Status](https://coveralls.io/repos/github/AndyObtiva/glimmer-dsl-swt/badge.svg?branch=master)](https://coveralls.io/github/AndyObtiva/glimmer-dsl-swt?branch=master)
@@ -8,6 +9,8 @@
 
 **(The Original Glimmer Library Handling the World’s Ruby GUI Needs Since 2007. Beware of Imitators!)**
 
+(**[Presenting ***"Building Native GUI Apps in Ruby"*** at RubyConf 2022](https://andymaleh.blogspot.com/2022/09/rubyconf-2022-building-native-gui-apps.html)**)
+
 [GLIMMER VIDEO TUTORIAL CHANNEL](https://www.youtube.com/channel/UC5hzDE23HZXsZLAxYk2UJEw)
 
 ![Glimmer DSL for SWT Demo of Hello, World!](/images/glimmer-dsl-swt-demo-hello-world.gif)
@@ -21,7 +24,7 @@ Featured in JRuby Cookbook](http://shop.oreilly.com/product/9780596519650.do) an
 
 ![Eclipse SWT RCP NASA Mars Rover](/images/glimmer-eclipse-swt-rcp-nasa-mars-rover.png)
 
-[Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) 4.25.0.2 includes [SWT 4.25](https://download.eclipse.org/eclipse/downloads/drops4/R-4.25-202208311800/), which was released on 31 Aug 2022. Gem version numbers are in sync with the SWT library versions. The first two digits represent the SWT version number. The last two digits represent the minor and patch versions of Glimmer DSL for SWT.
+[Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) 4.26.0.0 includes [SWT 4.26](https://download.eclipse.org/eclipse/downloads/drops4/R-4.26-202211231800/), which was released on 23 Nov 2022. Gem version numbers are in sync with the SWT library versions. The first two digits represent the SWT version number. The last two digits represent the minor and patch versions of Glimmer DSL for SWT.
 
 **Starting in version 4.20.0.0, [Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) comes with the new [***Shine***](/docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#shine) syntax** for highly intuitive and visually expressive View/Model Attribute Mapping, relying on `<=>` for bidirectional (two-way) data-binding and `<=` for unidirectional (one-way) data-binding, providing an alternative to the `bind` keyword. That was [originally conceived back in 2007](https://andymaleh.blogspot.com/2007/12/data-shining-in-glimmer.html).
 
@@ -338,7 +341,7 @@ jgem install glimmer-dsl-swt
 
 Or this command if you want a specific version:
 ```
-jgem install glimmer-dsl-swt -v 4.25.0.2
+jgem install glimmer-dsl-swt -v 4.26.0.0
 ```
 
 `jgem` is JRuby's version of `gem` command.
@@ -366,7 +369,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.25.0.2'
+gem 'glimmer-dsl-swt', '~> 4.26.0.0'
 ```
 
 And, then run:
@@ -389,7 +392,7 @@ glimmer
 ```
 
 ```
-Glimmer (JRuby Desktop Development GUI Framework) - JRuby Gem: glimmer-dsl-swt v4.25.0.2
+Glimmer (JRuby Desktop Development GUI Framework) - JRuby Gem: glimmer-dsl-swt v4.26.0.0
       
 Usage: glimmer [--bundler] [--pd] [--quiet] [--debug] [--log-level=VALUE] [[ENV_VAR=VALUE]...] [[-jruby-option]...] (application.rb or task[task_args]) [[application2.rb]...]
 

data/VERSION

@@ -1 +1 @@
-4.25.0.2
+4.26.0.0

data/docs/reference/GLIMMER_COMMAND.md

@@ -146,7 +146,7 @@ You need to have your Git `user.name` and `github.user` configured before scaffo
 
 #### App
 
-Before you start, make sure you are in a JRuby environment with Glimmer gem installed as per "Direct Install" pre-requisites.
+Before you start, make sure you are in a JRuby environment with [glimmer-dsl-swt](https://rubygems.org/gems/glimmer-dsl-swt) gem installed as per "Direct Install" pre-requisites.
 
 To scaffold a Glimmer app from scratch, run the following command:
 

data/docs/reference/GLIMMER_GUI_DSL_SYNTAX.md

@@ -65,6 +65,15 @@ This guide should help you get started with Glimmer DSL for SWT. For more advanc
     - [Observing Widgets](#observing-widgets)
       - [Alternative Syntax](#alternative-syntax)
     - [Observing Models](#observing-models)
+  - [Software Architecture](#software-architecture)
+    - [MVC](#mvc)
+    - [MVP](#mvp)
+    - [Software Architecture Examples](#software-architecture-examples)
+      - [MVC Example - Explicit Controller](#mvc-example---explicit-controller)
+      - [MVC Example - Implicit Controller](#mvc-example---implicit-controller)
+      - [MVP Example - Explicit Presenter](#mvp-example---explicit-presenter)
+      - [MVP Example - Implicit Presenter](#mvp-example---implicit-presenter)
+      - [MVP Example - Implicit Presenter with Bidirectional Data-Binding](#mvp-example---implicit-presenter-with-bidirectional-data-binding)
   - [Custom Widgets](#custom-widgets)
     - [Simple Example](#simple-example)
       - [Method-Based Custom Widget Example](#method-based-custom-widget-example)
@@ -1136,7 +1145,7 @@ Example:
 
 ```ruby
 # ...
-list(:multi) { # SWT styles go inside ()
+list(:multi, :border) { # SWT styles go inside ()
   # ...
 }
 # ...
@@ -3971,7 +3980,7 @@ class HelloListMultiSelection
     person = Person.new
     shell {
       composite {
-        list(:multi) {
+        list(:multi, :border) {
           selection bind(person, :provinces)
         }
         button {
@@ -4607,6 +4616,303 @@ class TicTacToe
 end
 ```
 
+### Software Architecture
+
+Glimmer DSL for SWT supports both MVC (Model View Controller) and MVP (Model View Presenter) architectural patterns.
+
+#### MVC
+
+Model View Controller architectural pattern is embodied by this diagram.
+
+![model view controller](/images/glimmer-software-architecture-model-view-controller.png)
+
+#### MVP
+
+Model View Presenter architectural pattern is embodied by this diagram.
+
+![model view presenter](/images/glimmer-software-architecture-model-view-presenter.png)
+
+#### Software Architecture Examples
+
+Here are 4 different ways of implementing the [Hello, Button!](/docs/reference/GLIMMER_SAMPLES.md#hello-button) sample (other than the included default implementation).
+
+![Hello Button](/images/glimmer-hello-button.png)
+
+##### MVC Example - Explicit Controller
+
+(you may copy/paste in [`girb`](GLIMMER_GIRB.md))
+
+```ruby
+require 'glimmer-dsl-swt'
+
+class Counter
+  attr_accessor :count
+  
+  def initialize
+    self.count = 0
+  end
+  
+  def increment
+    self.count += 1
+  end
+end
+
+class CounterController
+  def initialize(counter)
+    @counter = counter
+  end
+  
+  def increment_count
+    @counter.increment
+  end
+end
+
+class HelloButton
+  include Glimmer::UI::Application
+  
+  before_body do
+    @counter = Counter.new
+    @counter_controller = CounterController.new(@counter)
+  end
+  
+  after_body do
+    observe(@counter, :count) do |changed_count|
+      @button.text = "Click To Increment: #{changed_count}  "
+    end
+  end
+  
+  body {
+    shell {
+      text 'Hello, Button!'
+      
+      @button = button {
+        text "Click To Increment: 0  "
+        
+        on_widget_selected do
+          @counter_controller.increment_count
+        end
+      }
+    }
+  }
+end
+
+HelloButton.launch
+```
+
+##### MVC Example - Implicit Controller
+
+(you may copy/paste in [`girb`](GLIMMER_GIRB.md))
+
+```ruby
+require 'glimmer-dsl-swt'
+
+class Counter
+  attr_accessor :count
+  
+  def initialize
+    self.count = 0
+  end
+  
+  def increment
+    self.count += 1
+  end
+end
+
+class HelloButton
+  include Glimmer::UI::Application
+  
+  before_body do
+    @counter = Counter.new
+  end
+  
+  after_body do
+    observe(@counter, :count) do |changed_count|
+      @button.text = "Click To Increment: #{changed_count}  "
+    end
+  end
+  
+  body {
+    shell {
+      text 'Hello, Button!'
+      
+      @button = button {
+        text "Click To Increment: 0  "
+        
+        on_widget_selected do
+          @counter.increment
+        end
+      }
+    }
+  }
+end
+
+HelloButton.launch
+```
+
+##### MVP Example - Explicit Presenter
+
+(you may copy/paste in [`girb`](GLIMMER_GIRB.md))
+
+```ruby
+require 'glimmer-dsl-swt'
+
+class Counter
+  attr_accessor :count
+  
+  def initialize
+    self.count = 0
+  end
+  
+  def increment
+    self.count += 1
+  end
+end
+
+class CounterPresenter
+  include Glimmer::DataBinding::Observer
+  
+  def initialize
+    @counter = Counter.new
+    
+    Glimmer::DataBinding::Observer.proc do |changed_count|
+      notify_observers(:count)
+    end.observe(@counter, :count)
+  end
+  
+  def count
+    @counter.count
+  end
+  
+  def increment_count
+    @counter.increment
+  end
+end
+
+class HelloButton
+  include Glimmer::UI::Application
+  
+  before_body do
+    @counter_presenter = CounterPresenter.new
+  end
+  
+  body {
+    shell {
+      text 'Hello, Button!'
+      
+      button {
+        text <= [@counter_presenter, :count, on_read: ->(value) { "Click To Increment: #{value}  " }]
+        
+        on_widget_selected do
+          @counter_presenter.increment_count
+        end
+      }
+      
+      
+    }
+  }
+end
+
+HelloButton.launch
+```
+
+##### MVP Example - Implicit Presenter
+
+(you may copy/paste in [`girb`](GLIMMER_GIRB.md))
+
+```ruby
+require 'glimmer-dsl-swt'
+
+class Counter
+  attr_accessor :count
+  
+  def initialize
+    self.count = 0
+  end
+  
+  def increment
+    self.count += 1
+  end
+end
+
+class HelloButton
+  include Glimmer::UI::Application
+  
+  before_body do
+    @counter = Counter.new
+  end
+  
+  body {
+    shell {
+      text 'Hello, Button!'
+      
+      button {
+        text <= [@counter, :count, on_read: ->(value) { "Click To Increment: #{value}  " }]
+        
+        on_widget_selected do
+          @counter.count += 1
+        end
+      }
+      
+      
+      
+    }
+  }
+end
+
+HelloButton.launch
+```
+
+##### MVP Example - Implicit Presenter with Bidirectional Data-Binding
+
+![Hello Button](/images/glimmer-hello-button-with-text-bidirectional-data-binding.png)
+
+This version diverges in behavior to demonstrate bidirectional data-binding through a text field that is data-bound bidirectionally to the same attribute that the button is data-bound to for the click count.
+
+```ruby
+require 'glimmer-dsl-swt'
+
+class Counter
+  attr_accessor :count
+  
+  def initialize
+    self.count = 0
+  end
+  
+  def increment
+    self.count += 1
+  end
+end
+
+class HelloButton
+  include Glimmer::UI::Application
+  
+  before_body do
+    @counter = Counter.new
+  end
+  
+  body {
+    shell {
+      fill_layout(:vertical)
+      text 'Hello, Button!'
+      
+      text {
+        text <=> [@counter, :count, on_read: :to_s, on_write: :to_i]
+      }
+      
+      button {
+        text <= [@counter, :count, on_read: ->(value) { "Click To Increment: #{value}  " }]
+        
+        on_widget_selected do
+          @counter.count += 1
+        end
+      }
+    }
+  }
+end
+
+HelloButton.launch
+```
+
 ### Custom Widgets
 
 Custom widgets are brand new Glimmer DSL keywords that represent aggregates of existing widgets (e.g. `address_form`), customized existing widgets (e.g. `greeting_label`), or brand new widgets (e.g. `oscilloscope`)

data/docs/reference/GLIMMER_PACKAGING_AND_DISTRIBUTION.md

@@ -223,7 +223,7 @@ The `image` keyword in Glimmer automatically does that work when passing an imag
 
 5- NAME.app is damaged and can't be opened. You should move it to the trash
 
-If you package an app for the Mac and an end-user gets the error message above upon installing, note that you probably have a system incompatibility issue between your OS/CPU Architecture and the end-user's OS/CPU Architecture. To resolve the issue, make sure to repackage the app for the Mac on a system perfectly matching the end-user's OS/CPU Architecture (sometimes, packaging on a newer MacOS with the same CPU Architecture also works, but you would have to test that to confirm and ensure full compatibility).
+If you package an app for the Mac and an end-user gets the error message above upon installing, note that you either have a security-blocked-app or a system incompatibility issue between your OS/CPU Architecture and the end-user's OS/CPU Architecture. To resolve the issue, first try to go to "System Preferences -> Privacy & Security" and open the security-blocked-app anyways. If that does not work, then make sure to repackage the app for the Mac on a system perfectly matching the end-user's OS/CPU Architecture (sometimes, packaging on a newer MacOS with the same CPU Architecture also works, but you would have to test that to confirm and ensure full compatibility).
 
 6- Message about a Mac app for which the developer cannot be verified (Move To Trash or Cancel)
 

data/lib/glimmer/rake_task/scaffold.rb

@@ -787,7 +787,7 @@ end
       #
       body {
         # Replace example content below with custom widget content
-        label {
+        label(*swt_constants) {
           background :red
         }
       }

data/samples/elaborate/meta_sample.rb

@@ -254,7 +254,7 @@ class MetaSampleApplication
       image File.expand_path('../../icons/scaffold_app.png', __dir__)
       
       sash_form {
-        weights 1, 2
+        weights 1, 3
       
         composite {
           grid_layout(1, false) {

data/samples/hello/hello_list_multi_selection.rb

@@ -62,7 +62,7 @@ class HelloListMultiSelection
       
       text 'Hello, List Multi Selection!'
       
-      list(:multi) {
+      list(:multi, :border) {
         selection <=> [@person, :provinces] # also binds to provinces_options by convention
       }
       

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glimmer-dsl-swt
 version: !ruby/object:Gem::Version
-  version: 4.25.0.2
+  version: 4.26.0.0
 platform: ruby
 authors:
 - Andy Maleh
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-10-02 00:00:00.000000000 Z
+date: 2022-12-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement