glimmer-dsl-swt 4.20.13.7 → 4.20.13.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e20d1ff3e84168b2937444cf859e28249a859789adbd3d24993e0087a51addf5
-  data.tar.gz: 272ffc7415a569b4ef635da5919128399c19cd2077c11b280e34357d37b1ac09
+  metadata.gz: 431a3ee9e9fdbc1565e616a3ebee9e7bc7f026cae40d9c95a2df304647b3880b
+  data.tar.gz: 7b0bea9d898d0f42d5788ef36ce4279e81f3b3491c1102c148656f5c0e979328
 SHA512:
-  metadata.gz: 1057ae99a81ceb633ff2ed436ef150036ab3475ca663a4b0514173f6af1e136ec0a4a822898ef3c320b4f285180d65ef1c254a245959e219667e12beca1353a6
-  data.tar.gz: 7d62cc987fe8bbd20972d33ef7a7331844635f28f3d19273d99e4305ded7bdb60f1cb2d2b021d27f598f916fb501689017ff90208864026e5345a219778b7717
+  metadata.gz: 03a6fd9ea40d222acd37118cf42a7b299995ded46e334f8d9bff73fed74dc4db1e57913eaca40109bda7962977eafb546b92dbb8fdb72309ec9f5cf7c591d644
+  data.tar.gz: a9a3ed0e5e6cd57b26c64b6d030bdc35d14a29cb3576b11ed9e086d66a8dc7f76b206dd40539ed271e042b1073a85bca53f24415c68058df71b4571de93a161b

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Change Log
 
+### 4.20.13.10
+
+- Update Glimmer Style Guide, scaffolding, and samples to have `before_body` and `after_body` in custom widgets/shells/shapes always take a `do; end` block since they contain logic not visuals
+
+### 4.20.13.9
+
+- Update Klondike Solitaire to have playing card suit symbols and avoid clipping of cards on the boundaries
+
+### 4.20.13.8
+
+- Glimmer Klondike Solitaire elaborate sample
+
 ### 4.20.13.7
 
 - Support accepting ImageProxy objects in Canvas Shape DSL (not just image paths)

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.20.13.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 SWT 4.20.13.11
 ## 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)
@@ -15,7 +15,7 @@
 [<img src="https://covers.oreillystatic.com/images/9780596519650/lrg.jpg" width=105 /><br />
 Featured in JRuby Cookbook](http://shop.oreilly.com/product/9780596519650.do) and [Chalmers/Gothenburg University Software Engineering Master's Lecture Material](http://www.cse.chalmers.se/~bergert/slides/guest_lecture_DSLs.pdf)
 
-[Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) 4.20.13.7 includes [SWT 4.20](https://download.eclipse.org/eclipse/downloads/drops4/R-4.20-202106111600/), which was released on June 11, 2021. 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. Note that SWT now supports AARCH64 on Mac and Linux, but it is not fully tested in Glimmer DSL for SWT yet, so deem its support experimental for the time being without guarantees for functionality until declared otherwise (report any issues you may encounter).
+[Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) 4.20.13.11 includes [SWT 4.20](https://download.eclipse.org/eclipse/downloads/drops4/R-4.20-202106111600/), which was released on June 11, 2021. 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. Note that SWT now supports AARCH64 on Mac and Linux, but it is not fully tested in Glimmer DSL for SWT yet, so deem its support experimental for the time being without guarantees for functionality until declared otherwise (report any issues you may encounter).
 
 **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 (keep in mind that it is still a beta, so default back to `bind` whenever needed).
 
@@ -326,7 +326,7 @@ jgem install glimmer-dsl-swt
 
 Or this command if you want a specific version:
 ```
-jgem install glimmer-dsl-swt -v 4.20.13.7
+jgem install glimmer-dsl-swt -v 4.20.13.11
 ```
 
 `jgem` is JRuby's version of `gem` command.
@@ -354,7 +354,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.20.13.7'
+gem 'glimmer-dsl-swt', '~> 4.20.13.11'
 ```
 
 And, then run:
@@ -375,7 +375,7 @@ glimmer
 ```
 
 ```
-Glimmer (JRuby Desktop Development GUI Framework) - JRuby Gem: glimmer-dsl-swt v4.20.13.7
+Glimmer (JRuby Desktop Development GUI Framework) - JRuby Gem: glimmer-dsl-swt v4.20.13.11
       
 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.20.13.7
+4.20.13.11

data/docs/reference/GLIMMER_SAMPLES.md

@@ -61,7 +61,9 @@
     - [Login](#login)
     - [Tic Tac Toe](#tic-tac-toe)
     - [Contact Manager](#contact-manager)
+    - [Game of Life](#game-of-life)
     - [Glimmer Tetris](#glimmer-tetris)
+    - [Klondike Solitaire](#klondike-solitaire)
     - [Mandelbrot Fractal](#mandelbrot-fractal)
     - [Stock Ticker](#stock-ticker)
     - [Metronome](#metronome)
@@ -1070,6 +1072,16 @@ Contact Manager - Edit Done
 
 ![Contact Manager](/images/glimmer-contact-manager-edit-done.png)
 
+#### Game of Life
+
+This sample demonstrates how to build an interactive canvas-based visualization of Conway's Game of Life (test-first), taking advantage of data-binding and multi-threading.
+
+Code:
+
+[samples/elaborate/game_of_life.rb](/samples/elaborate/game_of_life.rb)
+
+![Game of Life](/images/glimmer-game-of-life.gif)
+
 #### Glimmer Tetris
 
 This sample demonstrates how to build an interactive animated game with MVC architecture, custom-shell/custom-widgets, multi-threading, asynchronous programming, data-binding, canvas shape graphic decorations, canvas shape icon image generation, and keyboard events/shortcuts.
@@ -1098,6 +1110,18 @@ Code:
 
 ![Tetris Help Menu](/images/glimmer-tetris-help-menu.png)
 
+#### Klondike Solitaire
+
+This sample demonstrates how to build an interactive card game with MVC architecture, canvas, custom-shapes, data-binding, observers, and drag & drop.
+
+Code:
+
+[samples/elaborate/klondike_solitaire.rb](/samples/elaborate/klondike_solitaire.rb)
+
+![Klondike Solitaire](/images/glimmer-klondike-solitaire.png)
+
+![Klondike Solitaire Played](/images/glimmer-klondike-solitaire-played.png)
+
 #### Mandelbrot Fractal
 
 This sample demonstrates how to render canvas graphics with multi-threaded processing taking advantage of all CPU cores and doing background processing of images.

data/docs/reference/GLIMMER_STYLE_GUIDE.md

@@ -10,6 +10,7 @@
 - Widget listeners are always declared starting with `on_` prefix and affixing listener event method name afterwards in underscored lowercase form. Their multi-line blocks rely on the `do; end` style.
 - Widget listeners are always followed by a block using curly braces (Only when declared in DSL. When invoked on widget object directly outside of GUI declarations, standard Ruby conventions apply)
 - Data-binding is done via `bind` keyword, which always takes arguments wrapped in parentheses
-- Custom widget `body`, `before_body`, and `after_body` blocks open their blocks and close them with curly braces.
+- Custom widget/shell/shape `body` blocks open and close with curly braces.
+- Custom widget/shell/shape `before_body` and `after_body` blocks are declared as `do; end` blocks.
 - Custom widgets receive additional keyword arguments called options, which come after the SWT styles.
 - Pure logic multi-line blocks that do not constitute GUI DSL view elements (such as `Thread.new`, `loop`, `each` and `observe` blocks) rely on the `do; end` style to clearly separate logic code from view code.

data/lib/glimmer/rake_task/scaffold.rb

@@ -607,7 +607,7 @@ module Glimmer
           
           if %i[gem app desktopify].include?(shell_type)
             custom_shell_file_content += <<-MULTI_LINE_STRING
-      before_body {
+      before_body do
         Display.app_name = '#{shell_type == :gem ? human_name(custom_shell_name) : human_name(namespace)}'
         Display.app_version = VERSION
         @display = display {
@@ -618,13 +618,13 @@ module Glimmer
             #{shell_type == :desktopify ? 'display_about_dialog' : 'display_preferences_dialog'}
           }
         }
-      }
+      end
             MULTI_LINE_STRING
           else
             custom_shell_file_content += <<-MULTI_LINE_STRING
-      # before_body {
+      # before_body do
       #
-      # }
+      # end
             MULTI_LINE_STRING
           end
     
@@ -632,9 +632,9 @@ module Glimmer
   
       ## Use after_body block to setup observers for widgets in body
       #
-      # after_body {
+      # after_body do
       #
-      # }
+      # end
   
       ## Add widget content inside custom shell body
       ## Top-most widget must be a shell or another custom shell
@@ -767,15 +767,15 @@ end
       ## Use before_body block to pre-initialize variables to use in body
       #
       #
-      # before_body {
+      # before_body do
       #
-      # }
+      # end
   
       ## Use after_body block to setup observers for widgets in body
       #
-      # after_body {
+      # after_body do
       #
-      # }
+      # end
   
       ## Add widget content under custom widget body
       ##
@@ -817,15 +817,15 @@ end
       ## Use before_body block to pre-initialize variables to use in body
       #
       #
-      # before_body {
+      # before_body do
       #
-      # }
+      # end
   
       ## Use after_body block to setup observers for shapes in body
       #
-      # after_body {
+      # after_body do
       #
-      # }
+      # end
   
       ## Add shape content under custom shape body
       #

data/lib/glimmer/swt/custom/code_text.rb

@@ -121,7 +121,7 @@ module Glimmer
           @line_numbers_styled_text_proxy.content(&block)
         end
         
-        before_body {
+        before_body do
           require 'rouge'
           require 'ext/rouge/themes/glimmer'
           @swt_style = swt_style == 0 ? [:border, :multi, :v_scroll, :h_scroll] : swt_style
@@ -132,11 +132,11 @@ module Glimmer
             @lines_width = lines[:width]
           end
           @dsl_mode = true
-        }
+        end
         
-        after_body {
+        after_body do
           @dsl_mode = nil
-        }
+        end
         
         body {
           if lines

data/samples/elaborate/calculator.rb

@@ -15,7 +15,7 @@ class Calculator
 
   attr_reader :presenter
 
-  before_body {
+  before_body do
     @presenter = Model::Presenter.new
     
     Display.setAppName('Glimmer Calculator')
@@ -30,7 +30,7 @@ class Calculator
         display_about_dialog
       }
     }
-  }
+  end
 
   body {
     shell {

data/samples/elaborate/contact_manager.rb

@@ -26,10 +26,10 @@ require_relative "contact_manager/contact_manager_presenter"
 class ContactManager
   include Glimmer::UI::CustomShell
 
-  before_body {
+  before_body do
     @contact_manager_presenter = ContactManagerPresenter.new
     @contact_manager_presenter.list
-  }
+  end
 
   body {
     shell {

data/samples/elaborate/game_of_life.rb

@@ -0,0 +1,111 @@
+# 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
+# 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-swt'
+
+require_relative 'game_of_life/model/grid'
+
+class GameOfLife
+  include Glimmer::UI::CustomShell
+  
+  WIDTH = 20
+  HEIGHT = 20
+  CELL_WIDTH = 25
+  CELL_HEIGHT = 25
+  
+  before_body do
+    @grid = GameOfLife::Model::Grid.new(WIDTH, HEIGHT)
+  end
+  
+  body {
+    shell {
+      row_layout :vertical
+      text "Conway's Game of Life (Glimmer Edition)"
+    
+      canvas {
+        layout_data {
+          width WIDTH*CELL_WIDTH
+          height HEIGHT*CELL_HEIGHT
+        }
+        (0...HEIGHT).each do |row_index|
+          (0...WIDTH).each do |column_index|
+            rectangle(column_index*CELL_WIDTH, row_index*CELL_HEIGHT, CELL_WIDTH, CELL_HEIGHT) {
+              background <= [@grid.cell_rows[row_index][column_index], "alive", on_read: ->(a) {a ? :black : :white}]
+              
+              on_mouse_down {
+                @grid.cell_rows[row_index][column_index].toggle_aliveness!
+              }
+            }
+          end
+        end
+      }
+        
+      composite {
+        row_layout(:horizontal) {
+          margin_width 0
+        }
+                
+        button {
+          text 'Step'
+          enabled <= [@grid, :playing, on_read: :! ]
+          
+          on_widget_selected {
+            @grid.step!
+          }
+        }
+        
+        button {
+          text 'Clear'
+          enabled <= [@grid, :playing, on_read: :! ]
+          
+          on_widget_selected {
+            @grid.clear!
+          }
+        }
+                
+        button {
+          text <= [@grid, :playing, on_read: ->(p) { p ? 'Stop' : 'Play' }]
+          
+          on_widget_selected {
+            @grid.toggle_playback!
+          }
+        }
+  
+        label {
+          text 'Slower'
+        }
+              
+        scale {
+          minimum 1
+          maximum 100
+          selection <=> [@grid, :speed]
+        }
+          
+        label {
+          text 'Faster'
+        }
+          
+      }
+    }
+  }
+end
+
+GameOfLife.launch

data/samples/elaborate/game_of_life/model/cell.rb

@@ -0,0 +1,51 @@
+class GameOfLife
+  module Model
+    class Cell
+      attr_reader :grid, :row_index, :column_index
+      attr_accessor :alive
+      alias alive? alive
+    
+      def initialize(grid, row_index, column_index, alive=false)
+        @grid = grid
+        @row_index = row_index
+        @column_index = column_index
+        @alive = alive
+      end
+      
+      def live!
+        self.alive = true
+      end
+      
+      def die!
+        self.alive = false
+      end
+      
+      def toggle_aliveness!
+        return if grid.playing?
+        dead ? live! : die!
+      end
+      
+      def dead?
+        !alive?
+      end
+      alias dead dead?
+      
+      # step into the next generation
+      def step!
+        self.alive = (alive? && alive_neighbor_count.between?(2, 3)) || (dead? && alive_neighbor_count == 3)
+      end
+      
+      def alive_neighbor_count
+        [row_index - 1, 0].max.upto([row_index + 1, grid.row_count - 1].min).map do |current_row_index|
+          [column_index - 1, 0].max.upto([column_index + 1, grid.column_count - 1].min).map do |current_column_index|
+            if current_row_index == row_index && current_column_index == column_index
+              0
+            else
+              grid.previous_cell_rows[current_row_index][current_column_index].alive? ? 1 : 0
+            end
+          end
+        end.flatten.reduce(:+)
+      end
+    end
+  end
+end

data/samples/elaborate/game_of_life/model/grid.rb

@@ -0,0 +1,76 @@
+require_relative 'cell'
+
+class GameOfLife
+  module Model
+    class Grid
+      include Glimmer # included only to utilize sync_exec/async_exec
+      DEFAULT_ROW_COUNT = 100
+      DEFAULT_COLUMN_COUNT = 100
+      
+      attr_reader :row_count, :column_count
+      attr_accessor :cell_rows, :previous_cell_rows, :playing, :speed
+      alias playing? playing
+    
+      def initialize(row_count=DEFAULT_ROW_COUNT, column_count=DEFAULT_COLUMN_COUNT)
+        @row_count = row_count
+        @column_count = column_count
+        @speed = 1.0
+        build_cells
+      end
+      
+      def clear!
+        cell_rows.each do |row|
+          row.each do |cell|
+            cell.die!
+          end
+        end
+      end
+      
+      # steps into the next generation of cells given their current neighbors
+      def step!
+        self.previous_cell_rows = cell_rows.map do |row|
+          row.map do |cell|
+            cell.clone
+          end
+        end
+        cell_rows.each do |row|
+          row.each do |cell|
+            cell.step!
+          end
+        end
+      end
+      
+      def toggle_playback!
+        if playing?
+          stop!
+        else
+          play!
+        end
+      end
+      
+      def play!
+        self.playing = true
+        Thread.new do
+          while @playing
+            sync_exec { step! }
+            sleep(1.0/@speed)
+          end
+        end
+      end
+      
+      def stop!
+        self.playing = false
+      end
+      
+      private
+      
+      def build_cells
+        @cell_rows = @row_count.times.map do |row_index|
+          @column_count.times.map do |column_index|
+            Cell.new(self, row_index, column_index)
+          end
+        end
+      end
+    end
+  end
+end