glimmer-dsl-swt 0.6.1 → 0.6.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 470667c11a2cadd8113d2067cffbf7db92647712dab8367a5b71ce0cbb990c02
-  data.tar.gz: 634143f2c4adbe46aeb5b09cbf373b20d1e513584fbfc405ceb5d74212d7ffd1
+  metadata.gz: 2efe946d6209511675a9b2e91c76b71a69fa52ece7ea821229783c1ddf52c2da
+  data.tar.gz: 3df579040ae3a9183388d1b6d3bca864a911679973e33ff7faae8a421384f64a
 SHA512:
-  metadata.gz: cbe32cbaf2d2f2bc7670a982abbaac8c490f41b307a2500b08158aa30bc775425d29be576411ef9618e0a3c9cc1118913f2017b4374c90e70fb196dd76beff95
-  data.tar.gz: 6656c29c0221adc159007c3e8f728e355d8d5cb8dbe193d049e5e24d4da0b53c30525e2ee79fc5b303be3d0e2787bc890321d0b83ca0d1783052f680e3f3fefd
+  metadata.gz: b3a057aabf006662881fa9adf157722831a4c6a2e397353a71b6c7d52fbc360bca96f095a5b5d4077bb271dd5b3eae9505cf8cd489bc801230179a8bf0d51aa8
+  data.tar.gz: ebe5556abe7c1dfe1446f2a42c0f71a799a47153b545f9cc463240d13a85bddf4c9e83eaab96e0b4f498de4753c48a8761306517714c19385a1d89c4e6f054d8

data/README.md

@@ -1,11 +1,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 0.6.1 (Desktop GUI)
+# [<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 0.6.6 (Desktop 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)
 [![Maintainability](https://api.codeclimate.com/v1/badges/aaf1cba142dd351f84bd/maintainability)](https://codeclimate.com/github/AndyObtiva/glimmer-dsl-swt/maintainability)
 [![Join the chat at https://gitter.im/AndyObtiva/glimmer](https://badges.gitter.im/AndyObtiva/glimmer.svg)](https://gitter.im/AndyObtiva/glimmer?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 
-[Glimmer](https://github.com/AndyObtiva/glimmer) DSL for [SWT](https://www.eclipse.org/swt/) enables desktop development with [Glimmer](https://github.com/AndyObtiva/glimmer).
+[Glimmer](https://github.com/AndyObtiva/glimmer) DSL for [SWT](https://www.eclipse.org/swt/) enables desktop development with [Glimmer](https://github.com/AndyObtiva/glimmer) in [JRuby](https://www.jruby.org/).
 
 [Glimmer](https://github.com/AndyObtiva/glimmer) is a native-GUI cross-platform desktop development library written in Ruby. Glimmer's main innovation is a JRuby DSL that enables productive and efficient authoring of desktop application user-interfaces while relying on the robust Eclipse SWT library. Glimmer additionally innovates by having built-in data-binding support to greatly facilitate synchronizing the GUI with domain models. As a result, that achieves true decoupling of object oriented components, enabling developers to solve business problems without worrying about GUI concerns, or alternatively drive development GUI-first, and then write clean business models test-first afterwards.
 
@@ -15,6 +15,7 @@ Other [Glimmer](https://github.com/AndyObtiva/glimmer) DSL gems:
 - [glimmer-dsl-opal](https://github.com/AndyObtiva/glimmer-dsl-opal): Glimmer DSL for Opal (Web GUI Adapter for Desktop Apps)
 - [glimmer-dsl-xml](https://github.com/AndyObtiva/glimmer-dsl-xml): Glimmer DSL for XML (& HTML)
 - [glimmer-dsl-css](https://github.com/AndyObtiva/glimmer-dsl-css): Glimmer DSL for CSS (Cascading Style Sheets)
+- [glimmer-dsl-tk](https://github.com/AndyObtiva/glimmer-dsl-tk): Glimmer DSL for Tk (MRI Ruby Desktop GUI)
 
 ## Example
 

data/VERSION

@@ -1 +1 @@
-0.6.1
+0.6.6

data/bin/girb

@@ -1,4 +1,4 @@
-#!/usr/bin/env ruby
+#!/usr/bin/env jruby
 
 trap "SIGINT" do
   # No Op for irb

data/bin/glimmer

@@ -1,5 +1,9 @@
-#!/usr/bin/env ruby
+#!/usr/bin/env jruby
 
+if ARGV.empty?
+  require 'rake-tui'
+  require 'tty-screen'
+end
 require_relative '../lib/glimmer/launcher'
 
 Glimmer::Launcher.new(ARGV).launch

data/lib/ext/glimmer/config.rb

@@ -48,6 +48,10 @@ module Glimmer
       
       def logging_appender_options
         @@logging_appender_options = {async: true, auto_flushing: 500, write_size: 500, flush_period: 60, immediate_at: [:error, :fatal], layout: logging_layout} unless defined? @@logging_appender_options
+        # TODO make this a glimmer command option
+        if ENV['GLIMMER_LOGGER_ASYNC'].to_s.downcase == 'false'
+          @@logging_appender_options.merge!(async: false, auto_flushing: 1, immediate_at: [:debug, :info, :warn, :error, :fatal])
+        end
         @@logging_appender_options
       end
       
@@ -90,9 +94,13 @@ module Glimmer
           end
           logger.appenders = appenders
         end
+        
       end
+      
     end
+    
   end
+  
 end
 
 Glimmer::Config.reset_logger!
@@ -100,7 +108,11 @@ if ENV['GLIMMER_LOGGER_LEVEL']
   # if glimmer log level is being overridden for debugging purposes, then disable async logging making logging immediate
   Glimmer::Config.logging_appender_options = Glimmer::Config.logging_appender_options.merge(async: false, auto_flushing: 1)
   Glimmer::Config.logging_devices = [:stdout]
-  Glimmer::Config.logger.level = ENV['GLIMMER_LOGGER_LEVEL']
+  begin
+    Glimmer::Config.logger.level = ENV['GLIMMER_LOGGER_LEVEL'].strip
+  rescue => e
+    puts e.message
+  end
 end
 Glimmer::Config.excluded_keyword_checkers << lambda do |method_symbol, *args|
   method = method_symbol.to_s

data/lib/glimmer-dsl-swt.rb

@@ -2,15 +2,11 @@ $LOAD_PATH.unshift(File.expand_path('..', __FILE__))
 
 # External requires
 require 'java'
-if ENV['BUNDLER_REQUIRE'].to_s.downcase == 'true'
-  require 'bundler'
-  Bundler.require
-else
-  require 'glimmer'
-  require 'logging'
-  require 'nested_inherited_jruby_include_package'
-  require 'super_module'
-end
+require 'puts_debuggerer' if ("#{ENV['pd']}#{ENV['PD']}").to_s.downcase.include?('true')
+require 'glimmer'
+require 'logging'
+require 'nested_inherited_jruby_include_package'
+require 'super_module'
 
 # Internal requires
 require 'ext/glimmer/config'

data/lib/glimmer/Rakefile

@@ -0,0 +1,5 @@
+# This Rakefile gets used from Glimmer::Launcher when the current directory for running the `glimmer` command 
+# does not have a Rakefile (e.g. during scaffolding). 
+# It is not needed when running from inside a scaffolded app or gem, or an app with a Rakefile that has
+# `require 'glimmer/rake_task'`
+require 'glimmer/rake_task'

data/lib/glimmer/data_binding/table_items_binding.rb

@@ -30,7 +30,10 @@ module Glimmer
       end
 
       def call(new_model_collection=nil)
-        new_model_collection = @model_binding.evaluate_property # this ensures applying converters (e.g. :on_read)        
+        new_model_collection = @model_binding.evaluate_property # this ensures applying converters (e.g. :on_read)
+        table_cells = @table.swt_widget.items.map {|item| @table.column_properties.size.times.map {|i| item.get_text(i)} }
+        model_cells = new_model_collection.to_a.map {|m| @table.cells_for(m)}
+        return if table_cells == model_cells
         if new_model_collection and new_model_collection.is_a?(Array)
           @table_items_observer_registration&.unobserve
           @table_items_observer_registration = observe(new_model_collection, @column_properties)

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

@@ -1,5 +1,4 @@
 require 'glimmer/dsl/expression'
-require 'glimmer/dsl/top_level_expression'
 require 'glimmer/swt/cursor_proxy'
 
 module Glimmer
@@ -8,11 +7,9 @@ module Glimmer
       # cursor expression
       # Note: Cannot be a static expression because it clashes with cursor property expression
       class CursorExpression < Expression
-        include TopLevelExpression
-  
         def can_interpret?(parent, keyword, *args, &block)
           keyword.to_s == 'cursor' and
-          (parent.nil? or !parent.respond_to?('cursor')) and
+            (parent.nil? or !parent.respond_to?('cursor')) and
             args.size == 1 and
             (args.first.is_a?(Integer) or textual?(args.first))
         end

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

@@ -26,6 +26,7 @@ module Glimmer
           data_binding
           cursor
           font
+          image
           property
           block_property
           widget

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

@@ -12,7 +12,9 @@ module Glimmer
   
         def can_interpret?(parent, keyword, *args, &block)
           keyword.to_s == 'font' and     
-          (parent.nil? || !parent.respond_to?('font')) && args.size == 1 && args.first.is_a?(Hash)
+            (parent.nil? || !parent.respond_to?('font')) and
+            args.size == 1 and 
+            args.first.is_a?(Hash)
         end
   
         def interpret(parent, keyword, *args, &block)

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

@@ -0,0 +1,21 @@
+require 'glimmer/dsl/expression'
+require 'glimmer/swt/image_proxy'
+
+module Glimmer
+  module DSL
+    module SWT
+      # image expression
+      # Note: Cannot be a static expression because it clashes with image property expression
+      class ImageExpression < Expression
+        def can_interpret?(parent, keyword, *args, &block)
+          keyword.to_s == 'image' and
+            (parent.nil? or !parent.respond_to?('image'))
+        end
+  
+        def interpret(parent, keyword, *args, &block)
+          Glimmer::SWT::ImageProxy.new(*args)
+        end
+      end
+    end
+  end
+end

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

@@ -16,7 +16,15 @@ module Glimmer
 
         def interpret(parent, keyword, *args, &block)
           potential_parent = args.first
-          parent = args.shift if potential_parent.is_a?(Shell) || (potential_parent.respond_to?(:swt_widget) && potential_parent.swt_widget.is_a?(Shell))
+          potential_parent = potential_parent.swt_widget if potential_parent.respond_to?(:swt_widget)
+          parent = nil          
+          if potential_parent.is_a?(Shell)
+            args.shift
+            parent = potential_parent
+          elsif potential_parent.is_a?(Widget)
+            args.shift
+            parent = potential_parent.shell
+          end
           Glimmer::SWT::MessageBoxProxy.new(parent, Glimmer::SWT::SWTProxy[args])
         end
       end

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

@@ -17,14 +17,14 @@ module Glimmer
         end
   
         def interpret(parent, keyword, *args, &block)
-          begin
-            class_name = "#{keyword.camelcase(:upper)}Proxy".to_sym
-            widget_class = Glimmer::SWT.const_get(class_name)
-          rescue
-            widget_class = Glimmer::SWT::WidgetProxy
-          end
-          widget_class.new(keyword, parent, args)
+          Glimmer::SWT::WidgetProxy.create(keyword, parent, args)
         end
+        
+        def add_content(parent, &block)
+          super
+          parent.post_add_content
+        end
+        
       end
     end
   end

data/lib/glimmer/launcher.rb

@@ -1,36 +1,31 @@
+require 'fileutils'
+
 require_relative 'rake_task'
 
 module Glimmer
   class Launcher
     OPERATING_SYSTEMS_SUPPORTED = ["mac", "windows", "linux"]
     
-    TEXT_USAGE_PREFIX = <<~MULTI_LINE_STRING
+    TEXT_USAGE = <<~MULTI_LINE_STRING
+      Glimmer (Ruby Desktop Development GUI Library) - JRuby Gem: glimmer-dsl-swt v#{File.read(File.expand_path('../../../VERSION', __FILE__))}      
       Usage: glimmer [--quiet] [--debug] [--log-level=VALUE] [[ENV_VAR=VALUE]...] [[-jruby-option]...] (application.rb or task[task_args]) [[application2.rb]...]
     
-      Runs Glimmer applications/tasks.
-    
-      Either a single task or one or more applications may be specified.
-    
-      When a task is specified, it runs via rake. Some tasks take arguments in square brackets.
-    
-      Available tasks are below (you may also lookup by adding `require 'glimmer/rake_task'` in Rakefile and running rake -T):
-    MULTI_LINE_STRING
-
-    TEXT_USAGE_SUFFIX = <<~MULTI_LINE_STRING
+      Runs Glimmer applications and tasks.    
     
       When applications are specified, they are run using JRuby, 
       automatically preloading the glimmer Ruby gem and SWT jar dependency.
     
-      Optionally, extra Glimmer options, JRuby options and environment variables may be passed in.
+      Optionally, extra Glimmer options, JRuby options, and/or environment variables may be passed in.
     
       Glimmer options:
       - "--quiet"           : Does not announce file path of Glimmer application being launched
       - "--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
+      Tasks are run via rake. Some tasks take arguments in square brackets.
     
-      This runs the Glimmer application samples/hello_world.rb
+      Available tasks are below (if you do not see any, please add `require 'glimmer/rake_task'` to Rakefile and rerun or run rake -T):
+      
     MULTI_LINE_STRING
 
     GLIMMER_LIB_LOCAL = File.expand_path(File.join('lib', 'glimmer-dsl-swt.rb'))
@@ -73,6 +68,10 @@ module Glimmer
         end
         @glimmer_lib
       end
+      
+      def dev_mode?
+        glimmer_lib == GLIMMER_LIB_LOCAL
+      end
 
       def glimmer_option_env_vars(glimmer_options)
         GLIMMER_OPTION_ENV_VAR_MAPPING.reduce({}) do |hash, pair|
@@ -89,13 +88,23 @@ module Glimmer
       def launch(application, jruby_options: [], env_vars: {}, glimmer_options: {})
         jruby_options_string = jruby_options.join(' ') + ' ' if jruby_options.any?
         env_vars = env_vars.merge(glimmer_option_env_vars(glimmer_options))
-        env_vars_string = env_vars.map {|k,v| "#{k}=#{v}"}.join(' ')
+        env_vars_string = env_vars.map do |k,v| 
+          if OS.windows? && ENV['PROMPT'] # detect command prompt (or powershell)
+            "set #{k}=#{v} && "
+          else
+            "export #{k}=#{v} && "
+          end
+        end.join
         the_glimmer_lib = glimmer_lib
         devmode_require = nil
         if the_glimmer_lib == GLIMMER_LIB_LOCAL
           devmode_require = '-r puts_debuggerer '
         end
         rake_tasks = Rake.application.tasks.map(&:to_s).map {|t| t.sub('glimmer:', '')}
+         
+        # handle a bash quirk with calling package[msi] while there is a "packages" directory locally (it passes package[msi] as packages)
+        application = 'package[msi]' if application == 'packages'
+        
         potential_rake_task_parts = application.match(REGEX_RAKE_TASK_WITH_ARGS)
         application = potential_rake_task_parts[1]
         rake_task_args = potential_rake_task_parts[2].split(',')
@@ -109,8 +118,16 @@ module Glimmer
             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}"
+          if !env_vars_string.empty? && OS.windows?
+            command = "bash -c \"#{command}\"" if ENV['SHELL'] # do in Windows Git Bash only
+            command = "cmd /C \"#{command}\"" if ENV['PROMPT'] # do in Windows Command Prompt only (or Powershell)
+          end
           puts command if jruby_options_string.to_s.include?('--debug')
-          exec command
+          if command.include?(' irb ')
+            exec command
+          else
+            system command
+          end
         end
       end
     end
@@ -155,10 +172,32 @@ module Glimmer
     end
 
     def display_usage
-      rake_tasks = `rake -T`.gsub('rake glimmer:', 'glimmer ').split("\n").select {|l| l.start_with?('glimmer ')}
-      puts TEXT_USAGE_PREFIX
-      puts rake_tasks.join("\n")
-      puts TEXT_USAGE_SUFFIX
+      puts TEXT_USAGE
+      display_tasks
+    end
+    
+    def display_tasks
+      if OS.windows?
+        tasks = Rake.application.tasks
+        task_lines = tasks.reject do |task|
+          task.comment.nil?
+        end.map do |task|
+          max_task_size = tasks.map(&:name_with_args).map(&:size).max + 1
+          task_name = task.name_with_args.sub('glimmer:', '')
+          line = "glimmer #{task_name.ljust(max_task_size)} # #{task.comment}"
+          bound = TTY::Screen.width - 6
+          line.size <= bound ? line : "#{line[0..(bound - 3)]}..."          
+        end
+        puts task_lines.to_a
+      else
+        Rake::TUI.run(branding_header: nil, prompt_question: 'Select a Glimmer task to run:') do |task, tasks|
+          max_task_size = tasks.map(&:name_with_args).map(&:size).max + 1
+          task_name = task.name_with_args.sub('glimmer:', '')
+          line = "glimmer #{task_name.ljust(max_task_size)} # #{task.comment}"
+          bound = TTY::Screen.width - 6
+          line.size <= bound ? line : "#{line[0..(bound - 3)]}..."          
+        end    
+      end
     end
 
     def extract_application_paths(options)

data/lib/glimmer/package.rb

@@ -6,6 +6,7 @@ module Glimmer
   module Package
     class << self
       attr_accessor :javapackager_extra_args
+      alias jpackage_extra_args :javapackager_extra_args
       
       def clean
         require 'fileutils'
@@ -42,14 +43,15 @@ module Glimmer
       end
       
       def lock_jars
-        puts 'Locking JARs with jar-dependencies...'
-        command = "lock_jars --vendor-dir vendor"
+        puts 'Locking gem jar-dependencies by downloading & storing in vendor/jars...'
+        FileUtils.mkdir_p('vendor/jars')
+        command = "lock_jars --vendor-dir vendor/jars"
         puts command
         system command      
       end
       
-      def native(native_type=nil)
-        puts "Generating native executable with javapackager..."
+      def native(native_type=nil, native_extra_args)
+        puts "Generating native executable with javapackager/jpackage..."
         require 'facets/string/titlecase'
         require 'facets/string/underscore'
         project_name = File.basename(File.expand_path('.'))
@@ -59,13 +61,28 @@ module Glimmer
         license = (File.read(license_file).strip if File.exists?(license_file) && File.file?(license_file)) rescue nil
         copyright = license.split("\n").first
         human_name = project_name.underscore.titlecase
-        command = "javapackager -deploy -native #{native_type} -outdir packages -outfile \"#{project_name}\" -srcfiles \"dist/#{project_name}.jar\" -appclass JarMain -name \"#{human_name}\" -title \"#{human_name}\" -Bmac.CFBundleName=\"#{human_name}\" -Bmac.CFBundleIdentifier=\"org.#{project_name}.application.#{project_name}\" -Bmac.category=\"public.app-category.business\" -BinstalldirChooser=true -Bvendor=\"#{human_name}\" -Bwin.menuGroup=\"#{human_name}\" -BsystemWide=#{OS.mac?} "
-        command += " -BjvmOptions=-XstartOnFirstThread " if OS.mac?
-        command += " -BappVersion=#{version} -Bmac.CFBundleVersion=#{version} " if version
-        command += " -srcfiles LICENSE.txt -BlicenseFile=LICENSE.txt " if license
-        command += " -Bcopyright=\"#{copyright}\" " if copyright
+        icon = "package/#{OS.mac? ? 'macosx' : 'windows'}/#{human_name}.#{OS.mac? ? 'icns' : 'ico'}"
+        if (`javapackager`.to_s.include?('Usage: javapackager') rescue nil)
+          command = "javapackager -deploy -native #{native_type} -outdir packages -outfile \"#{project_name}\" -srcfiles \"dist/#{project_name}.jar\" -appclass JarMain -name \"#{human_name}\" -title \"#{human_name}\" -Bmac.CFBundleName=\"#{human_name}\" -Bmac.CFBundleIdentifier=\"org.#{project_name}.application.#{project_name}\" -Bmac.category=\"public.app-category.business\" -BinstalldirChooser=true -Bvendor=\"#{human_name}\" -Bwin.menuGroup=\"#{human_name}\" "
+          command += " -BsystemWide=false " if OS.windows?
+          command += " -BjvmOptions=-XstartOnFirstThread " if OS.mac?
+          command += " -BappVersion=#{version} -Bmac.CFBundleVersion=#{version} " if version
+          command += " -srcfiles LICENSE.txt -BlicenseFile=LICENSE.txt " if license
+          command += " -Bcopyright=\"#{copyright}\" " if copyright
+        elsif (`jpackage`.to_s.include?('Usage: jpackage') rescue nil)
+          command = "jpackage --type #{native_type} --dest 'packages/bundles' --input 'dist' --main-class JarMain --main-jar '#{project_name}.jar' --name '#{human_name}' --vendor '#{human_name}' --icon '#{icon}' "
+          command += " --win-per-user-install --win-dir-chooser --win-menu --win-menu-group '#{human_name}' " if OS.windows?
+          command += " --java-options '-XstartOnFirstThread' --mac-package-name '#{human_name}' --mac-package-identifier 'org.#{project_name}.application.#{project_name}' " if OS.mac?
+          command += " --app-version \"#{version}\" " if version
+          command += " --license-file LICENSE.txt " if license
+          command += " --copyright \"#{copyright}\" " if copyright
+        else
+          puts "Neither javapackager nor jpackage exist in your Java installation. Please ensure javapackager or jpackage is available in PATH environment variable."
+          return
+        end
         command += " #{javapackager_extra_args} " if javapackager_extra_args
         command += " #{ENV['JAVAPACKAGER_EXTRA_ARGS']} " if ENV['JAVAPACKAGER_EXTRA_ARGS']
+        command += " #{native_extra_args} " if native_extra_args
         puts command
         system command      
       end

data/lib/glimmer/rake_task.rb

@@ -3,6 +3,116 @@ require 'rake'
 require_relative 'package'
 
 namespace :glimmer do
+  namespace :sample do
+    desc 'Runs a Glimmer internal sample [included in gem]. If no name is supplied, it runs all samples.'
+    task :run, [:name] => :requires do |t, args|
+      name = args[:name]
+      name = name.underscore.downcase unless name.nil?
+      samples = (Dir.glob(File.expand_path('../../../samples/hello/*.rb', __FILE__)) + Dir.glob(File.expand_path('../../../samples/elaborate/*.rb', __FILE__))).sort
+      samples = samples.select {|path| path.include?("#{name}.rb")} unless name.nil?      
+      Rake::Task['glimmer:sample:code'].invoke(name) if samples.size == 1
+      Glimmer::Launcher.new(samples << '--quiet=false').launch
+    end
+    
+    namespace :run do    
+      task :hello do
+        samples = Dir.glob(File.expand_path('../../../samples/hello/*.rb', __FILE__)).sort
+        Glimmer::Launcher.new(samples << '--quiet=false').launch        
+      end    
+      
+      task :elaborate do
+        samples = Dir.glob(File.expand_path('../../../samples/elaborate/*.rb', __FILE__)).sort
+        Glimmer::Launcher.new(samples << '--quiet=false').launch        
+      end    
+    end
+  
+    desc 'Lists Glimmer internal samples [included in gem]. Filters by query if specified (query is optional)'
+    task :list, [:query] do |t, args|
+      Rake::Task['glimmer:sample:list:hello'].invoke(args[:query])
+      Rake::Task['glimmer:sample:list:elaborate'].invoke(args[:query])
+    end
+    
+    namespace :list do
+      task :hello, [:query] => :requires do |t, args|
+        array_of_arrays = Dir.glob(File.expand_path('../../../samples/hello/*.rb', __FILE__)).map do |path| 
+          File.basename(path, '.rb')
+        end.select do |path| 
+          args[:query].nil? || path.include?(args[:query])
+        end.map do |path| 
+          [path, path.underscore.titlecase, "#{'bin/' if Glimmer::Launcher.dev_mode?}glimmer sample:run[#{path}]"]
+        end.sort
+        if array_of_arrays.empty?
+          puts "No Glimmer Hello Samples match the query."
+        else
+          puts 
+          puts "  Glimmer Hello Samples (run all via: #{'bin/' if Glimmer::Launcher.dev_mode?}glimmer sample:run:hello):"
+          puts Text::Table.new(
+            :head => %w[Name Description Run],
+            :rows => array_of_arrays,
+            :horizontal_padding    => 1,
+            :vertical_boundary     => ' ',
+            :horizontal_boundary   => ' ',
+            :boundary_intersection => ' '
+          )        
+        end
+      end
+      
+      task :elaborate, [:query] => :requires do |t, args|
+        array_of_arrays = Dir.glob(File.expand_path('../../../samples/elaborate/*.rb', __FILE__)).map do |path| 
+          File.basename(path, '.rb')
+        end.select do |path| 
+          args[:query].nil? || path.include?(args[:query])
+        end.map do |path| 
+          [path, path.underscore.titlecase, "#{'bin/' if Glimmer::Launcher.dev_mode?}glimmer sample:run[#{path}]"]
+        end.sort
+        if array_of_arrays.empty?
+          puts "No Glimmer Elaborate Samples match the query."
+        else
+          puts 
+          puts "  Glimmer Elaborate Samples (run all via: #{'bin/' if Glimmer::Launcher.dev_mode?}glimmer sample:run:elaborate):"
+          puts Text::Table.new(
+            :head => %w[Name Description Run],
+            :rows => array_of_arrays,
+            :horizontal_padding    => 1,
+            :vertical_boundary     => ' ',
+            :horizontal_boundary   => ' ',
+            :boundary_intersection => ' '
+          )        
+        end
+      end      
+    end
+  
+    desc 'Outputs code for a Glimmer internal sample [included in gem] (name is required)'
+    task :code, [:name] => :requires do |t, args|
+      require 'tty-markdown' unless OS.windows?
+      samples = (Dir.glob(File.expand_path('../../../samples/hello/*.rb', __FILE__)) + Dir.glob(File.expand_path('../../../samples/elaborate/*.rb', __FILE__))).sort
+      sample = samples.detect {|path| path.include?("#{args[:name].to_s.underscore.downcase}.rb")}
+      sample_additional_files = Dir.glob(File.join(sample.sub('.rb', ''), '**', '*.rb'))
+      code = ([sample] + sample_additional_files).map do |file|
+        <<~RUBY
+        
+        # #{file}
+        
+        #{File.read(file)}
+        
+        # # #
+        
+        RUBY
+      end.join("\n")
+      code = TTY::Markdown.parse("```ruby\n#{code}\n```") unless OS.windows?
+      puts code
+    end
+    
+    task :requires do
+      require 'text-table'
+      require 'facets/string/titlecase'
+      require 'facets/string/underscore'
+      
+      require_relative 'launcher'        
+    end
+  
+  end
+
   namespace :package do
     desc 'Clean by removing "dist" and "packages" directories'
     task :clean do
@@ -24,22 +134,22 @@ namespace :glimmer do
       Glimmer::Package.lock_jars
     end
 
-    desc 'Generate Native files (DMG/PKG/APP on the Mac, MSI/EXE/IMAGE on Windows, RPM/DEB on Linux) (type is optional)'
+    desc 'Generate Native files. type can be dmg/pkg on the Mac, msi/exe on Windows, and rpm/deb on Linux (type is optional)'
     task :native, [:type] do |t, args|
-      Glimmer::Package.native(args[:type])
+      extra_args = ARGV.partition {|arg| arg.include?('package:native')}.last.to_a.join(' ')
+      Glimmer::Package.native(args[:type], extra_args)
     end
   end
 
   desc 'Package app for distribution (generating config, jar, and native files) (type is optional)'
   task :package, [:type] do |t, args|
+    Rake::Task['gemspec:generate'].execute
+    Rake::Task['glimmer:package:lock_jars'].execute
     Rake::Task['glimmer:package:config'].execute
     Rake::Task['glimmer:package:jar'].execute
-    Rake::Task['glimmer:package:lock_jars'].execute
-    Rake::Task['gemspec:generate'].execute
     Rake::Task['glimmer:package:native'].execute(args)
   end
 
-
   desc 'Scaffold Glimmer application directory structure to build a new app'
   task :scaffold, [:app_name] do |t, args|
     require_relative 'scaffold'