glimmer 0.7.7 → 0.7.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 76d86f5e3e322edba85aee815e28a0bb19b6ed56694ff44b1311a759b249b189
-  data.tar.gz: ad84ddf98c7a9da150f1dd4897e7a7df0e7d8cf06d317a1a748929c1446895ce
+  metadata.gz: 7a3d10cd74668598ac83511994d117f3b99f7332d798d671ddc412dcac3c92fa
+  data.tar.gz: 1daf7b7330d0e73790ec98c5ef3afdf3f991f0f447f5b72ce47bc70901bb8baa
 SHA512:
-  metadata.gz: dbbd46186a07700fed156566a5a0de4fb5ad90720ae2e24eb0662bc1ef3a64850f29d4f91fa577f388136511e3ec20689a97e1686e25f34112fabf35c05c2981
-  data.tar.gz: f484803847e17525090f815ea117d429f10abc87f12a5c38343c9d6e2f56ff6bf055b153f5fa3f250ae60adde2b5ff4cba7b209b0b1693bc98d0f619cc1d15db
+  metadata.gz: 81136d0e73a2e26f01bc16b8986f8569910a63509730766d6cb70a533e1fbe38fdce3bfc7e0488d5bbe2a76e10413a46b0765811960698f70a343d45ab3c78a2
+  data.tar.gz: e20bab1be17773690ac997385921e47520e324afe3b4efcf0f0b6ae4dcf00cd6bcaea9b36c048c9c1eec54023af4c853e8c9aaa55138b40fa58f4262cbd09872

data/README.md

@@ -1,4 +1,4 @@
-# Glimmer 0.7.7 Beta (Desktop Development Library for Ruby)
+# Glimmer 0.7.8 Beta (Desktop Development Library for Ruby)
 [![Gem Version](https://badge.fury.io/rb/glimmer.svg)](http://badge.fury.io/rb/glimmer)
 [![Travis CI](https://travis-ci.com/AndyObtiva/glimmer.svg?branch=master)](https://travis-ci.com/github/AndyObtiva/glimmer)
 [![Test Coverage](https://api.codeclimate.com/v1/badges/38fbc278022862794414/test_coverage)](https://codeclimate.com/github/AndyObtiva/glimmer/test_coverage)
@@ -75,7 +75,7 @@ NOTE: Glimmer is in beta mode. Please help make better by adopting for small or
 
 ## Table of Contents
 
-- [Glimmer 0.7.7 Beta (Desktop Development Library for Ruby)](#glimmer-075-beta-desktop-development-library-for-ruby)
+- [Glimmer 0.7.8 Beta (Desktop Development Library for Ruby)](#glimmer-078-beta-desktop-development-library-for-ruby)
   - [Examples](#examples)
     - [Hello, World!](#hello-world)
     - [Tic Tac Toe](#tic-tac-toe)
@@ -105,6 +105,7 @@ NOTE: Glimmer is in beta mode. Please help make better by adopting for small or
   - [Samples](#samples)
     - [Hello Samples](#hello-samples)
     - [Elaborate Samples](#elaborate-samples)
+    - [External Samples](#external-samples)
   - [In Production](#in-production)
   - [SWT Reference](#swt-reference)
   - [SWT Packages](#swt-packages)
@@ -112,7 +113,8 @@ NOTE: Glimmer is in beta mode. Please help make better by adopting for small or
   - [Raw JRuby Command](#raw-jruby-command)
     - [Mac Support](#mac-support)
   - [Packaging & Distribution](#packaging--distribution)
-    - [Defaults](#defaults)
+    - [Packaging Defaults](#packaging-defaults)
+    - [Packaging Configuration](#packaging-configuration)
     - [javapackager Extra Arguments](#javapackager-extra-arguments)
     - [Mac Application Distribution](#mac-application-distribution)
     - [Self Signed Certificate](#self-signed-certificate)
@@ -152,8 +154,9 @@ https://www.eclipse.org/swt/faq.php
 ## Pre-requisites
 
 - SWT 4.15 (comes included in Glimmer gem)
-- JRuby 9.2.11.1 (supporting Ruby 2.5.x syntax) (find at https://www.jruby.org/download)
-- Java SE Runtime Environment 7 or higher (find at https://www.oracle.com/java/technologies/javase-downloads.html)
+- JRuby 9.2.11.1 (supporting Ruby 2.5.x syntax) (find at [https://www.jruby.org/download](https://www.jruby.org/download))
+- Java SE Runtime Environment 7 or higher (find at [https://www.oracle.com/java/technologies/javase-downloads.html](https://www.oracle.com/java/technologies/javase-downloads.html))
+- (Optional) RVM is needed for [Scaffolding](#scaffolding) only (find at [https://rvm.io/](https://rvm.io/))
 
 On **Mac** and **Linux**, an easy way to obtain JRuby is through [RVM](http://rvm.io) by running:
 
@@ -171,7 +174,7 @@ Please follow these instructions to make the `glimmer` command available on your
 
 Run this command to install directly:
 ```
-jgem install glimmer -v 0.7.7
+jgem install glimmer -v 0.7.8
 ```
 
 `jgem` is JRuby's version of `gem` command. 
@@ -182,7 +185,7 @@ Otherwise, you may also run `jruby -S gem install ...`
 
 Add the following to `Gemfile`:
 ```
-gem 'glimmer', '~> 0.7.7'
+gem 'glimmer', '~> 0.7.8'
 ```
 
 And, then run:
@@ -219,7 +222,7 @@ bin/glimmer samples/hello/hello_world.rb
 Below are the full usage instructions that come up when running `glimmer` without args.
 
 ```
-Usage: glimmer [--debug] [--log-level=VALUE] [[ENV_VAR=VALUE]...] [[-jruby-option]...] (application.rb or task[task_args]) [[application2.rb]...]
+Usage: glimmer [--quiet] [--debug] [--log-level=VALUE] [[ENV_VAR=VALUE]...] [[-jruby-option]...] (application.rb or task[task_args]) [[application2.rb]...]
 
 Runs Glimmer applications/tasks.
 
@@ -234,7 +237,7 @@ glimmer package:jar                                               # Generate JAR
 glimmer package:native                                            # Generate Native files (DMG/PKG/APP on the Mac)
 glimmer scaffold[app_name]                                        # Scaffold a Glimmer application directory structure to begin building a new app
 glimmer scaffold:custom_shell[custom_shell_name,namespace]        # Scaffold a Glimmer::UI::CustomShell subclass (represents a full window view) under app/views (namespace is optional)
-glimmer scaffold:custom_shell_gem[custom_widget_name,namespace]   # Scaffold a Glimmer::UI::CustomShell subclass (represents a full window view) under its own Ruby gem project (namespace is required)
+glimmer scaffold:custom_shell_gem[custom_shell_name,namespace]    # Scaffold a Glimmer::UI::CustomShell subclass (represents a full window view) under its own Ruby gem + app project (namespace is required)
 glimmer scaffold:custom_widget[custom_widget_name,namespace]      # Scaffold a Glimmer::UI::CustomWidget subclass (represents a part of a view) under app/views (namespace is optional)
 glimmer scaffold:custom_widget_gem[custom_widget_name,namespace]  # Scaffold a Glimmer::UI::CustomWidget subclass (represents a part of a view) under its own Ruby gem project (namespace is required)
 
@@ -244,8 +247,9 @@ automatically preloading the glimmer Ruby gem and SWT jar dependency.
 Optionally, extra Glimmer options, JRuby options and environment variables may be passed in.
 
 Glimmer options:
-- "--debug"           : Displays extra debugging information and passes "--debug" to JRuby
-- "--log-level=VALUE" : Sets Glimmer's Ruby logger level ("ERROR" / "WARN" / "INFO" / "DEBUG"; default is "WARN")
+- "--quiet"           : Does not announce file path of Glimmer application being launched nor enable logging
+- "--debug"           : Displays extra debugging information, passes "--debug" to JRuby, and enables debug logging
+- "--log-level=VALUE" : Sets Glimmer's Ruby logger level ("ERROR" / "WARN" / "INFO" / "DEBUG"; default is none)
 
 Example: glimmer samples/hello_world.rb
 
@@ -277,7 +281,7 @@ getting you to a running and delivered state of an advanced "Hello, World!" Glim
 This should greatly facilitate building a new Glimmer app by helping you be productive and focus on app details while 
 letting Glimmer scaffolding take care of initial app file structure concerns, such as adding:
 - Main application class that includes Glimmer
-- Main application view that houses main window content
+- Main application view that houses main window content, about dialog, and preferences dialog
 - View and Model directories
 - Rakefile including Glimmer tasks
 - Version
@@ -285,7 +289,7 @@ letting Glimmer scaffolding take care of initial app file structure concerns, su
 - Icon
 - Bin file for starting application
 
-NOTE: Scaffolding currently supports Mac packaging only at the moment. 
+NOTE: Scaffolding requires RVM and currently supports Mac packaging only at the moment. 
 
 #### App
 
@@ -344,8 +348,10 @@ glimmer scaffold:custom_widget[custom_widget_name]
 #### Custom Shell Gem
 
 Custom shell gems are self-contained Glimmer apps as well as reusable custom shells. 
-As such, they are packaged as both a native executable (e.g. Mac DMG/PKG/APP) and a Ruby gem.
-Of course, you can build a Ruby gem and disregard its native executable packaging if you do not need it.
+They have everything scaffolded Glimmer apps come with in addition to gem content like a Jeweler Rakefile that can build gemspec and release gems. 
+Unlike scaffolded Glimmer apps, custom shell gem content lives under the `lib` directory (not `app`).
+They can be packaged as both a native executable (e.g. Mac DMG/PKG/APP) and a Ruby gem.
+Of course, you can just build a Ruby gem and disregard native executable packaging if you do not need it.
 
 To scaffold a Glimmer custom shell gem (full window view distributed as a Ruby gem), run the following command:
 
@@ -359,7 +365,10 @@ The Ruby gem name will follow the convention "glimmer-cs-customwidgetname-namesp
 
 Only official Glimmer gems created by the Glimmer project committers will have no namespace (e.g. [glimmer-cs-gladiator](https://rubygems.org/gems/glimmer-cs-gladiator) Ruby gem)
 
-Example: [https://github.com/AndyObtiva/glimmer-cs-gladiator](https://github.com/AndyObtiva/glimmer-cs-gladiator)
+Examples: 
+
+- [glimmer-cs-gladiator](https://github.com/AndyObtiva/glimmer-cs-gladiator): Gladiator (Glimmer Editor)
+- [glimmer-cs-calculator](https://github.com/AndyObtiva/glimmer-cs-calculator): Glimmer Calculator
 
 #### Custom Widget Gem
 
@@ -619,6 +628,12 @@ Shell widget proxy has extra methods specific to SWT Shell:
 - `#pack`: Packs contained widgets using SWT's `Shell#pack` method
 - `#pack_same_size`: Packs contained widgets without changing shell's size when widget sizes change
 
+#### Dialog
+
+Dialog is a variation on Shell. It is basically a shell that is modal (blocks what's behind it) and belongs to another shell. It only has a close button.
+
+Glimmer facilitates building dialogs by using the `dialog` keyword, which automatically adds the SWT::DIALOG_TRIM and SWT::APPLICATION_MODAL [widget styles](#widget-styles) needed for a dialog.
+
 #### Menus
 
 Glimmer DSL provides support for SWT Menu and MenuItem widgets.
@@ -1535,17 +1550,17 @@ Notice how `Red::Composite` became `red__composite` with double-underscore, whic
 
 Keep in mind that namespaces are not needed to be specified if the Custom Widget class has a unique name, not clashing with a basic SWT widget or another custom widget name.
 
-Custom Widgets have the following attributes (attribute readers) available to call from inside the `#body` method:
+Custom Widgets have the following attributes available to call from inside the `#body` method:
 - `#parent`: Glimmer object parenting custom widget
 - `#swt_style`: SWT style integer. Can be useful if you want to allow consumers to customize a widget inside the custom widget body
-- `#options`: a hash of options passed in parentheses when declaring a custom widget (useful for passing in model data) (e.g. `calendar(events: events)`). Custom widget class can declare option names (array) with `.options` method as shown below, which generates attribute readers for every option (not to be confused with `#options` instance method for retrieving options hash containing names & values)
+- `#options`: a hash of options passed in parentheses when declaring a custom widget (useful for passing in model data) (e.g. `calendar(events: events)`). Custom widget class can declare option names (array) with `::options` class method as shown below, which generates attribute accessors for every option (not to be confused with `#options` instance method for retrieving options hash containing names & values)
 - `#content`: nested block underneath custom widget. It will be automatically called at the end of processing the custom widget body. Alternatively, the custom widget body may call `content.call` at the place where the content is needed to show up as shown in the following example.
 - `#body_root`: top-most (root) widget returned from `#body` method.
 - `#swt_widget`: actual SWT widget for `body_root`
 
 Additionally, custom widgets can call the following class methods:
-- `.options`: declares a list of options by taking an option name array (symbols/strings). This generates option attribute readers (e.g. `options :orientation, :bg_color` generates `#orientation` and `#bg_color` attribute readers)
-- `.option`: declares a single option taking option name and default value as arguments (also generates an attribute reader just like `.options`)
+- `.options`: declares a list of options by taking an option name array (symbols/strings). This generates option attribute accessors (e.g. `options :orientation, :bg_color` generates `#orientation`, `#orientation=(v)`, `#bg_color`, and `#bg_color=(v)` attribute accessors)
+- `.option`: declares a single option taking option name and default value as arguments (also generates attribute accessors just like `.options`)
 
 #### Content/Options Example (you may copy/paste in [`girb`](#girb-glimmer-irb-command)):
 
@@ -1977,11 +1992,21 @@ glimmer samples/hello/hello_computed.rb # demonstrates computed data-binding
 For more elaborate samples, check the following:
 
 ```
-glimmer samples/elaborate/login.rb # demonstrates general data-binding
+glimmer samples/elaborate/login.rb # demonstrates basic data-binding
 glimmer samples/elaborate/contact_manager.rb # demonstrates table data-binding
 glimmer samples/elaborate/tic_tac_toe.rb # demonstrates a full MVC application
 ```
 
+### External Samples
+
+#### [Glimmer Calculator](https://github.com/AndyObtiva/glimmer-cs-calculator)
+
+![Glimmer Calculator](https://raw.githubusercontent.com/AndyObtiva/glimmer-cs-calculator/v1.0.0/glimmer-cs-calculator-screenshot.png)
+
+[Glimmer Calculator](https://github.com/AndyObtiva/glimmer-cs-calculator) is a basic calculator sample project demonstrating data-binding and TDD (test-driven-development) with Glimmer following the MVP pattern (Model-View-Presenter).
+
+#### [Gladiator](https://github.com/AndyObtiva/glimmer-cs-gladiator)
+
 ![Gladiator](https://raw.githubusercontent.com/AndyObtiva/glimmer-cs-gladiator/v0.1.5/images/glimmer-gladiator.png)
 
 [Gladiator](https://github.com/AndyObtiva/glimmer-cs-gladiator) (short for Glimmer Editor) is a Glimmer sample project under on-going development.
@@ -2111,33 +2136,20 @@ Glimmer apps may be packaged and distributed on the Mac, Windows, and Linux via
 - Warbler (https://github.com/jruby/warbler): Enables bundling a Glimmer app into a JAR file
 - javapackager (https://docs.oracle.com/javase/8/docs/technotes/tools/unix/javapackager.html): Enables packaging a JAR file as a DMG file on Mac, EXE on Windows, and multiple Linux supported formats on Linux.
 
-Glimmer simplifies the process for Mac packaging by providing a rake task.
-
-To use:
-- Create `Rakefile` in your app root directory
-- Add the following line to it: `require 'glimmer/rake_task'`
-- Create a Ruby script under bin (e.g. `bin/math_bowling`) to require the application file that uses Glimmer (e.g. `'../app/my_application.rb'`):
-```ruby
-require_relative '../app/my_application.rb'
-```
-- Include Icon (Optional): If you'd like to include an icon for your app (.icns format on the Mac), place it under `package/macosx` matching the humanized application local directory name (e.g. 'Math Bowling.icns' [containing space] for MathBowling or math_bowling). You may generate your Mac icon easily using tools like Image2Icon (http://www.img2icnsapp.com/) or manually using the Mac terminal command `iconutil` (iconutil guide: https://applehelpwriter.com/tag/iconutil/)
-- Include Version (Optional): Create a `VERSION` file in your application and fill it your app version on one line (e.g. `1.1.0`)
-- Include License (Optional): Create a `LICENSE.txt` file in your application and fill it up with your license (e.g. MIT). It will show up to people when installing your app. Note that, you may optionally also specify license type, but you'd have to do so manually via `-BlicenseType=MIT` shown in an [example below](#javapackager-extra-arguments).
-- Extra args (Optional): You may optionally add the following to `Rakefile` to configure extra arguments for javapackager: `Glimmer::Packager.javapackager_extra_args = "..."` (Useful to avoid re-entering extra arguments on every run of rake task.). Read about them in [their section below](#javapackager-extra-arguments).
+Glimmer simplifies the process of Mac packaging via the `glimmer package` command. It works out of the box for any application generated by [Glimmer Scaffolding](https://github.com/AndyObtiva/glimmer/blob/master/README.md#scaffolding):
 
-Now, you can run the following rake command to package your app into a Mac DMG file (using both Warbler and javapackager):
 ```
-rake glimmer:package
+glimmer package
 ```
 
-This will generate a JAR file under `./dist` directory, which is then used to generate a DMG file (and pkg/app) under `./packages/bundles`. 
+This will automatically generate a JAR file under `./dist` directory using Warbler, which is then used to automatically generate a DMG file (and pkg/app) under `./packages/bundles` using `javapackager`. 
 JAR file name will match your application local directory name (e.g. `MathBowling.jar` for `~/code/MathBowling`)
 DMG file name will match the humanized local directory name + dash + application version (e.g. `Math Bowling-1.0.dmg` for `~/code/MathBowling` with version 1.0 or unspecified)
 
-THe rake task will automatically set "mac.CFBundleIdentifier" to ="org.#{project_name}.application.#{project_name}". 
+The `glimmer package` command will automatically set "mac.CFBundleIdentifier" to ="org.#{project_name}.application.#{project_name}". 
 You may override by configuring as an extra argument for javapackger (e.g. Glimmer::Package.javapackager_extra_args = " -Bmac.CFBundleIdentifier=org.andymaleh.application.MathBowling")
 
-### Defaults
+### Packaging Defaults
 
 Glimmer employs smart defaults in packaging.
 
@@ -2145,13 +2157,24 @@ The package application name (shows up in top menu bar on the Mac) will be a hum
 
 Also, the package will only include these directories: app, config, db, lib, script, bin, docs, fonts, images, sounds, videos
 
-After running once, you will find a `config/warble.rb` file. It has the JAR packaging configuration. You may adjust included directories in it if needed, and then rerun `rake glimmer:package` and it will pick up your custom configuration. Alternatively, if you'd like to customize the included directories to begin with, don't run `rake glimmer:package` right away. Run this command first:
+After running once, you will find a `config/warble.rb` file. It has the JAR packaging configuration. You may adjust included directories in it if needed, and then rerun `glimmer package` and it will pick up your custom configuration. Alternatively, if you'd like to customize the included directories to begin with, don't run `glimmer package` right away. Run this command first:
 
 ```
-rake glimmer:package:config
+glimmer package:config
 ```
 
-This will generate `config/warble.rb`, which you may configure and then run `rake glimmer:package` afterwards.
+This will generate `config/warble.rb`, which you may configure and then run `glimmer package` afterwards.
+
+### Packaging Configuration
+
+- Ensure you have a Ruby script under `bin` directory that launches the application, preferably matching your project directory name (e.g. `bin/math_bowling`) :
+```ruby
+require_relative '../app/my_application.rb'
+```
+- Include Icon (Optional): If you'd like to include an icon for your app (.icns format on the Mac), place it under `package/macosx` matching the humanized application local directory name (e.g. 'Math Bowling.icns' [containing space] for MathBowling or math_bowling). You may generate your Mac icon easily using tools like Image2Icon (http://www.img2icnsapp.com/) or manually using the Mac terminal command `iconutil` (iconutil guide: https://applehelpwriter.com/tag/iconutil/)
+- Include Version (Optional): Create a `VERSION` file in your application and fill it your app version on one line (e.g. `1.1.0`)
+- Include License (Optional): Create a `LICENSE.txt` file in your application and fill it up with your license (e.g. MIT). It will show up to people when installing your app. Note that, you may optionally also specify license type, but you'd have to do so manually via `-BlicenseType=MIT` shown in an [example below](#javapackager-extra-arguments).
+- Extra args (Optional): You may optionally add the following to `Rakefile` to configure extra arguments for javapackager: `Glimmer::Packager.javapackager_extra_args = "..."` (Useful to avoid re-entering extra arguments on every run of rake task.). Read about them in [their section below](#javapackager-extra-arguments).
 
 ### javapackager Extra Arguments
 
@@ -2179,7 +2202,7 @@ https://developer.apple.com/library/archive/releasenotes/General/SubmittingToMac
 Example (env var):
 
 ```
-JAVAPACKAGER_EXTRA_ARGS='-Bmac.CFBundleName="Math Bowling Game"' rake glimmer:package
+JAVAPACKAGER_EXTRA_ARGS='-Bmac.CFBundleName="Math Bowling Game"' glimmer package
 ```
 
 That overrides the default application display name.
@@ -2224,7 +2247,7 @@ Example:
 Glimmer::Package.javapackager_extra_args = '-Bmac.signing-key-developer-id-app="Andy Maleh"'
 ```
 
-Now, when you run `rake glimmer:package`, it builds a self-signed DMG file. When you make available online, and users download, upon launching application, they are presented with your certificate, which they have to sign if they trust you in order to use the application.
+Now, when you run `glimmer package`, it builds a self-signed DMG file. When you make available online, and users download, upon launching application, they are presented with your certificate, which they have to sign if they trust you in order to use the application.
 
 ### Gotchas
 
@@ -2241,7 +2264,7 @@ Glimmer::Package.javapackager_extra_args = '-srcfiles "ACME.txt" -BlicenseFile="
 
 2. Mounted DMG Residue
 
-If you run `rake glimmer:package` multiple times, sometimes it leaves a mounted DMG project in your finder. Unmount before you run the command again or it might fail with an error saying: "Error: Bundler "DMG Installer" (dmg) failed to produce a bundle."
+If you run `glimmer package` multiple times, sometimes it leaves a mounted DMG project in your finder. Unmount before you run the command again or it might fail with an error saying: "Error: Bundler "DMG Installer" (dmg) failed to produce a bundle."
 
 By the way, keep in mind that during normal operation, it does also indicate a false-negative while completing successfully similar to the following (please ignore): 
 

data/VERSION

@@ -1 +1 @@
-0.7.7
+0.7.8

data/lib/glimmer/dsl/swt/dialog_expression.rb

@@ -0,0 +1,26 @@
+require 'glimmer/dsl/static_expression'
+require 'glimmer/dsl/parent_expression'
+require 'glimmer/dsl/top_level_expression'
+require 'glimmer/swt/shell_proxy'
+
+module Glimmer
+  module DSL
+    module SWT
+      class DialogExpression < StaticExpression
+        include TopLevelExpression
+        include ParentExpression
+
+        def can_interpret?(parent, keyword, *args, &block)
+          keyword == 'dialog' and
+            (parent.nil? or parent.is_a?(Glimmer::SWT::ShellProxy))
+        end
+  
+        def interpret(parent, keyword, *args, &block)
+          args = [parent] + args unless parent.nil?
+          args += [:dialog_trim, :application_modal]
+          Glimmer::SWT::ShellProxy.send(:new, *args)
+        end
+      end
+    end
+  end
+end

data/lib/glimmer/launcher.rb

@@ -8,7 +8,7 @@ module Glimmer
     OPERATING_SYSTEMS_SUPPORTED = ["mac", "windows", "linux"]
     
     TEXT_USAGE_PREFIX = <<~MULTI_LINE_STRING
-      Usage: glimmer [--debug] [--log-level=VALUE] [[ENV_VAR=VALUE]...] [[-jruby-option]...] (application.rb or task[task_args]) [[application2.rb]...]
+      Usage: glimmer [--quiet] [--debug] [--log-level=VALUE] [[ENV_VAR=VALUE]...] [[-jruby-option]...] (application.rb or task[task_args]) [[application2.rb]...]
     
       Runs Glimmer applications/tasks.
     
@@ -27,8 +27,9 @@ module Glimmer
       Optionally, extra Glimmer options, JRuby options and environment variables may be passed in.
     
       Glimmer options:
-      - "--debug"           : Displays extra debugging information and passes "--debug" to JRuby
-      - "--log-level=VALUE" : Sets Glimmer's Ruby logger level ("ERROR" / "WARN" / "INFO" / "DEBUG"; default is "WARN")
+      - "--quiet"           : Does not announce file path of Glimmer application being launched nor enable logging
+      - "--debug"           : Displays extra debugging information, passes "--debug" to JRuby, and enables debug logging
+      - "--log-level=VALUE" : Sets Glimmer's Ruby logger level ("ERROR" / "WARN" / "INFO" / "DEBUG"; default is none)
     
       Example: glimmer samples/hello_world.rb
     
@@ -37,7 +38,7 @@ module Glimmer
 
     GLIMMER_LIB_LOCAL = File.expand_path(File.join(__FILE__, '..', '..', 'glimmer.rb'))
     GLIMMER_LIB_GEM = 'glimmer'
-    GLIMMER_OPTIONS = %w[--log-level]
+    GLIMMER_OPTIONS = %w[--log-level --quiet]
     GLIMMER_OPTION_ENV_VAR_MAPPING = {
       '--log-level' => 'GLIMMER_LOGGER_LEVEL'
     }
@@ -77,8 +78,8 @@ module Glimmer
       end
 
       def glimmer_option_env_vars(glimmer_options)
-        glimmer_options.reduce({}) do |hash, pair|
-          hash.merge(GLIMMER_OPTION_ENV_VAR_MAPPING[pair.first] => pair.last)
+        GLIMMER_OPTION_ENV_VAR_MAPPING.reduce({}) do |hash, pair|
+          glimmer_options[pair.first] ? hash.merge(GLIMMER_OPTION_ENV_VAR_MAPPING[pair.first] => glimmer_options[pair.first]) : hash
         end
       end
 
@@ -108,7 +109,7 @@ module Glimmer
           Rake::Task[rake_task].invoke(*rake_task_args)
         else
           @@mutex.synchronize do
-            puts "Launching Glimmer Application: #{application}" unless application.to_s.match(/(irb)|(gladiator)/)
+            puts "Launching Glimmer Application: #{application}" if jruby_options_string.to_s.include?('--debug') || glimmer_options['--quiet'].to_s.downcase != 'true'
           end
           command = "#{env_vars_string} jruby #{jruby_options_string}#{jruby_os_specific_options} #{devmode_require}-r #{the_glimmer_lib} -S #{application}"
           puts command if jruby_options_string.to_s.include?('--debug')
@@ -123,6 +124,8 @@ module Glimmer
     attr_reader :jruby_options
 
     def initialize(raw_options)
+      raw_options << '--quiet' if !caller.join("\n").include?('/bin/glimmer:') && !raw_options.join.include?('--quiet=')
+      raw_options << '--log-level=DEBUG' if raw_options.join.include?('--debug') && !raw_options.join.include?('--log-level=')
       @application_paths = extract_application_paths(raw_options)
       @env_vars = extract_env_vars(raw_options)
       @glimmer_options = extract_glimmer_options(raw_options)
@@ -140,7 +143,7 @@ module Glimmer
     private
 
     def launch_application
-      load File.expand_path('./Rakefile') if File.exist?(File.expand_path('./Rakefile'))
+      load File.expand_path('./Rakefile') if File.exist?(File.expand_path('./Rakefile')) && caller.join("\n").include?('/bin/glimmer:')
       threads = @application_paths.map do |application_path|
         Thread.new do
           self.class.launch(
@@ -188,8 +191,8 @@ module Glimmer
       end.each do |glimmer_option|
         options.delete(glimmer_option)
       end.reduce({}) do |hash, glimmer_option_string|
-        match = glimmer_option_string.match(/^([^=]+)=?(.*)$/)
-        hash.merge(match[1] => match[2])
+        match = glimmer_option_string.match(/^([^=]+)=?(.+)?$/)
+        hash.merge(match[1] => (match[2] || 'true'))
       end
     end
   end

data/lib/glimmer/rake_task.rb

@@ -76,9 +76,9 @@ namespace :glimmer do
       Scaffold.custom_widget(args[:custom_widget_name], args[:namespace])
     end
     
-    desc 'Scaffold a Glimmer::UI::CustomShell subclass (represents a full window view) under its own Ruby gem project (namespace is required)'
-    task :custom_shell_gem, [:custom_widget_name, :namespace] do |t, args|
-      Scaffold.custom_shell_gem(args[:custom_widget_name], args[:namespace])
+    desc 'Scaffold a Glimmer::UI::CustomShell subclass (represents a full window view) under its own Ruby gem + app project (namespace is required)'
+    task :custom_shell_gem, [:custom_shell_name, :namespace] do |t, args|
+      Scaffold.custom_shell_gem(args[:custom_shell_name], args[:namespace])
     end
     
     desc 'Scaffold a Glimmer::UI::CustomWidget subclass (represents a part of a view) under its own Ruby gem project (namespace is required)'

data/lib/glimmer/scaffold.rb

@@ -107,7 +107,7 @@ class Scaffold
     RAKEFILE = <<~MULTI_LINE_STRING
       require 'glimmer/rake_task'
       
-      ## Uncomment the following section if you would like to customize javapackager
+      ## Use the following configuration if you would like to customize javapackager
       ## arguments for `glimmer package` command.
       #
       # Glimmer::Package.javapackager_extra_args =
@@ -146,7 +146,7 @@ class Scaffold
       write "app/#{file_name(app_name)}.rb", app_main_file(app_name)
       mkdir 'app/models'
       mkdir 'app/views'
-      custom_shell('AppView', current_dir_name)
+      custom_shell('AppView', current_dir_name, :app)
       if OS.mac?
         mkdir_p 'package/macosx'
         icon_file = "package/macosx/#{human_name(app_name)}.icns"
@@ -161,12 +161,12 @@ class Scaffold
       # TODO generate rspec test suite
     end
 
-    def custom_shell(custom_shell_name, namespace)
+    def custom_shell(custom_shell_name, namespace, shell_type = nil)
       namespace ||= current_dir_name
       root_dir = File.exists?('app') ? 'app' : 'lib'
       parent_dir = "#{root_dir}/views/#{file_name(namespace)}"
       mkdir_p parent_dir unless File.exists?(parent_dir)
-      write "#{parent_dir}/#{file_name(custom_shell_name)}.rb", custom_shell_file(custom_shell_name, namespace)
+      write "#{parent_dir}/#{file_name(custom_shell_name)}.rb", custom_shell_file(custom_shell_name, namespace, shell_type)
     end
 
     def custom_widget(custom_widget_name, namespace)
@@ -179,7 +179,7 @@ class Scaffold
 
     def custom_shell_gem(custom_shell_name, namespace)
       gem_name = "glimmer-cs-#{compact_name(custom_shell_name)}"
-      gem_summary = "Glimmer Custom Widget - #{human_name(custom_shell_name)}"
+      gem_summary = "#{human_name(custom_shell_name)} - Glimmer Custom Shell"
       if namespace
         gem_name += "-#{compact_name(namespace)}"
         gem_summary += " (#{human_name(namespace)})"
@@ -196,9 +196,10 @@ class Scaffold
       write 'Rakefile', gem_rakefile(custom_shell_name, namespace)
       append "lib/#{gem_name}.rb", gem_main_file(custom_shell_name, namespace)
       mkdir 'lib/views'
-      custom_shell(custom_shell_name, namespace)
+      custom_shell(custom_shell_name, namespace, :gem)
       mkdir 'bin'
-      write "bin/#{file_name(custom_shell_name)}", gem_bin_file(gem_name, custom_shell_name, namespace)
+      write "bin/#{gem_name}", gem_bin_file(gem_name, custom_shell_name, namespace)
+      write "bin/#{file_name(custom_shell_name)}", gem_bin_command_file(gem_name)
       FileUtils.chmod 0755, "bin/#{file_name(custom_shell_name)}"      
       if OS.mac?
         mkdir_p 'package/macosx'
@@ -217,7 +218,7 @@ class Scaffold
 
     def custom_widget_gem(custom_widget_name, namespace)
       gem_name = "glimmer-cw-#{compact_name(custom_widget_name)}"
-      gem_summary = "Glimmer Custom Widget - #{human_name(custom_widget_name)}"
+      gem_summary = "#{human_name(custom_widget_name)} - Glimmer Custom Widget"
       if namespace
         gem_name += "-#{compact_name(namespace)}"
         gem_summary += " (#{human_name(namespace)})"
@@ -291,7 +292,8 @@ class Scaffold
           include Glimmer
         
           APP_ROOT = File.expand_path('../..', __FILE__)        
-          VERSION = File.read(File.expand_path('VERSION', APP_ROOT))
+          VERSION = File.read(File.join(APP_ROOT, 'VERSION'))
+          LICENSE = File.read(File.join(APP_ROOT, 'LICENSE.txt'))          
                     
           def open
             app_view.open
@@ -335,13 +337,30 @@ class Scaffold
       MULTI_LINE_STRING
     end
 
+    def gem_bin_command_file(gem_name)
+      <<~MULTI_LINE_STRING
+        #!/usr/bin/env ruby
+        
+        require 'glimmer/launcher'
+        
+        runner = File.expand_path("../#{gem_name}", __FILE__)
+        launcher = Glimmer::Launcher.new([runner] + ARGV)
+        launcher.launch
+      MULTI_LINE_STRING
+    end
+
     def gem_rakefile(custom_shell_name = nil, namespace = nil)
       rakefile_content = File.read('Rakefile')
       lines = rakefile_content.split("\n")
       require_rake_line_index = lines.index(lines.detect {|l| l.include?("require 'rake'") })
       lines.insert(require_rake_line_index, "require 'glimmer/launcher'")
       gem_files_line_index = lines.index(lines.detect {|l| l.include?('# dependencies defined in Gemfile') })
-      lines.insert(gem_files_line_index, "  gem.files = Dir['lib/**/*.rb']")
+      if custom_shell_name
+        lines.insert(gem_files_line_index, "  gem.files = Dir['VERSION', 'LICENSE.txt', 'lib/**/*.rb', 'bin/**/*']")
+        lines.insert(gem_files_line_index+1, "  gem.executables = ['#{file_name(custom_shell_name)}']")
+      else
+        lines.insert(gem_files_line_index, "  gem.files = Dir['lib/**/*.rb']")
+      end
       spec_pattern_line_index = lines.index(lines.detect {|l| l.include?('spec.pattern =') })
       lines.insert(spec_pattern_line_index+1, "  spec.ruby_opts = [Glimmer::Launcher.jruby_swt_options]")
       lines << "\nrequire 'glimmer/rake_task'\n"       
@@ -382,52 +401,143 @@ class Scaffold
       lines.join("\n")
     end
 
-    def custom_shell_file(custom_shell_name, namespace)
+    def custom_shell_file(custom_shell_name, namespace, shell_type)    
       namespace_type = class_name(namespace) == class_name(current_dir_name) ? 'class' : 'module'
 
-      <<~MULTI_LINE_STRING
-        #{namespace_type} #{class_name(namespace)}
-          class #{class_name(custom_shell_name)}
-            include Glimmer::UI::CustomShell
-        
-            ## Add options like the following to configure CustomShell by outside consumers
-            #
-            # options :title, :background_color
-            # option :width, 320
-            # option :height, 240
-        
-            ## Uncomment before_body block to pre-initialize variables to use in body
-            #
-            #
-            # before_body {
-            # 
-            # }
-        
-            ## Uncomment after_body block to setup observers for widgets in body
-            #
-            # after_body {
-            # 
-            # }
+      custom_shell_file_content = <<-MULTI_LINE_STRING
+#{namespace_type} #{class_name(namespace)}
+  class #{class_name(custom_shell_name)}
+    include Glimmer::UI::CustomShell
+    
+      MULTI_LINE_STRING
+      
+      if shell_type == :gem
+        custom_shell_file_content += <<-MULTI_LINE_STRING
+    GEM_ROOT = File.expand_path('../../../..', __FILE__)
+    VERSION = File.read(File.join(GEM_ROOT, 'VERSION'))
+    LICENSE = File.read(File.join(GEM_ROOT, 'LICENSE.txt'))
         
-            ## Add widget content inside custom shell body
-            ## Top-most widget must be a shell or another custom shell
-            #
-            body {
-              shell {
-                # Replace example content below with custom shell content
-                minimum_size 320, 240
-                text "#{human_name(namespace)} - #{human_name(custom_shell_name)}"
-                grid_layout
-                label {
-                  text "Hello, World!"
-                  font height: 40
-                  layout_data :center, :center, true, true
-                }
+        MULTI_LINE_STRING
+      end
+      
+      custom_shell_file_content += <<-MULTI_LINE_STRING
+    ## Add options like the following to configure CustomShell by outside consumers
+    #
+    # options :title, :background_color
+    # option :width, 320
+    # option :height, 240
+    option :greeting, 'Hello, World!'
+
+    ## Use before_body block to pre-initialize variables to use in body
+    #
+    #
+      MULTI_LINE_STRING
+      
+      if %i[gem app].include?(shell_type)
+        custom_shell_file_content += <<-MULTI_LINE_STRING
+    before_body {
+      Display.setAppName('#{shell_type == :gem ? human_name(custom_shell_name) : human_name(namespace)}')
+      Display.setAppVersion(VERSION)
+    }
+        MULTI_LINE_STRING
+      else
+        custom_shell_file_content += <<-MULTI_LINE_STRING
+    # before_body {
+    #
+    # }
+        MULTI_LINE_STRING
+      end
+
+      custom_shell_file_content += <<-MULTI_LINE_STRING
+
+    ## Use after_body block to setup observers for widgets in body
+    #
+    # after_body {
+    # 
+    # }
+
+    ## Add widget content inside custom shell body
+    ## Top-most widget must be a shell or another custom shell
+    #
+    body {
+      shell {
+        # Replace example content below with custom shell content
+        minimum_size 320, 240
+        text "#{human_name(namespace)} - #{human_name(custom_shell_name)}"
+        grid_layout
+      MULTI_LINE_STRING
+      
+      if %i[gem app].include?(shell_type)
+        custom_shell_file_content += <<-MULTI_LINE_STRING      
+        on_about {
+          display_about_dialog
+        }
+        on_preferences {
+          display_preferences_dialog
+        }
+        MULTI_LINE_STRING
+      end
+      
+      custom_shell_file_content += <<-MULTI_LINE_STRING
+        label(:center) {
+          text bind(self, :greeting)
+          font height: 40
+          layout_data :fill, :center, true, true
+        }
+      }
+    }
+      MULTI_LINE_STRING
+
+      if %i[gem app].include?(shell_type)
+        custom_shell_file_content += <<-MULTI_LINE_STRING
+
+    def display_about_dialog
+      message_box = MessageBox.new(swt_widget)
+      message_box.setText("About")
+      message = "#{human_name(namespace)} - #{human_name(custom_shell_name)} \#{VERSION}\n\n"
+      message += LICENSE
+      message_box.setMessage(message)
+      message_box.open
+    end
+    
+    def display_preferences_dialog
+      dialog(swt_widget) {
+        text 'Preferences'
+        grid_layout {
+          margin_height 5
+          margin_width 5
+        }
+        group {
+          row_layout {
+            type :vertical
+            spacing 10
+          }
+          text 'Greeting'
+          font style: :bold
+          [
+            'Hello, World!', 
+            'Howdy, Partner!'
+          ].each do |greeting_text|
+            button(:radio) {
+              text greeting_text
+              selection bind(self, :greeting) { |g| g == greeting_text }
+              layout_data {
+                width 160
+              }
+              on_widget_selected { |event|
+                self.greeting = event.widget.getText
               }
             }
-        
           end
-        end
+        }
+      }.open
+    end
+        MULTI_LINE_STRING
+      end
+      
+      custom_shell_file_content += <<-MULTI_LINE_STRING
+  end
+end
       MULTI_LINE_STRING
     end
 
@@ -444,14 +554,14 @@ class Scaffold
             # options :custom_text, :background_color
             # option :foreground_color, :red
         
-            ## Uncomment before_body block to pre-initialize variables to use in body
+            ## Use before_body block to pre-initialize variables to use in body
             #
             #
             # before_body {
             # 
             # }
         
-            ## Uncomment after_body block to setup observers for widgets in body
+            ## Use after_body block to setup observers for widgets in body
             #
             # after_body {
             # 

data/lib/glimmer/ui/custom_widget.rb

@@ -83,7 +83,7 @@ module Glimmer
           else
             new_options = new_options.reduce({}) {|new_options_hash, new_option| new_options_hash.merge(new_option => nil)}
             @options = options.merge(new_options)
-            def_option_attr_readers(new_options)
+            def_option_attr_accessors(new_options)
           end
         end
 
@@ -91,15 +91,18 @@ module Glimmer
           new_option = new_option.to_s.to_sym
           new_options = {new_option => new_option_default}
           @options = options.merge(new_options)
-          def_option_attr_readers(new_options)
+          def_option_attr_accessors(new_options)
         end
 
-        def def_option_attr_readers(new_options)
+        def def_option_attr_accessors(new_options)
           new_options.each do |option, default|
             class_eval <<-end_eval, __FILE__, __LINE__
               def #{option}
                 options[:#{option}]
               end
+              def #{option}=(option_value)
+                self.options[:#{option}] = option_value
+              end
             end_eval
           end
         end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glimmer
 version: !ruby/object:Gem::Version
-  version: 0.7.7
+  version: 0.7.8
 platform: ruby
 authors:
 - AndyMaleh
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-05-28 00:00:00.000000000 Z
+date: 2020-05-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
@@ -216,6 +216,7 @@ files:
 - lib/glimmer/dsl/swt/combo_selection_data_binding_expression.rb
 - lib/glimmer/dsl/swt/custom_widget_expression.rb
 - lib/glimmer/dsl/swt/data_binding_expression.rb
+- lib/glimmer/dsl/swt/dialog_expression.rb
 - lib/glimmer/dsl/swt/display_expression.rb
 - lib/glimmer/dsl/swt/dsl.rb
 - lib/glimmer/dsl/swt/exec_expression.rb