glimmer 0.6.0 → 0.7.0

data/lib/glimmer/launcher.rb

@@ -1,25 +1,47 @@
 require 'os'
+require 'rake'
+
+require_relative 'rake_task'
 
 module Glimmer
   class Launcher
     OPERATING_SYSTEMS_SUPPORTED = ["mac", "windows", "linux"]
-    TEXT_USAGE = <<-MULTILINE
-  Usage: glimmer [--log-level=VALUE] [[ENV_VAR=VALUE]...] [[-jruby-option]...] application.rb [[application2.rb]...]
-
-  Runs Glimmer applications using JRuby, automatically preloading
-  the glimmer ruby gem and SWT jar dependency.
-
-  Optionally, JRuby options may be passed in.
+    
+    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]...]
+    
+      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
+    
+      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.
+    
+      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")
+    
+      Example: glimmer samples/hello_world.rb
+    
+      This runs the Glimmer application samples/hello_world.rb
+    MULTI_LINE_STRING
 
-  Example: glimmer samples/hello_world.rb
-  This runs the Glimmer application samples/hello_world.rb
-    MULTILINE
     GLIMMER_LIB_LOCAL = File.expand_path(File.join(__FILE__, '..', '..', 'glimmer.rb'))
     GLIMMER_LIB_GEM = 'glimmer'
     GLIMMER_OPTIONS = %w[--log-level]
     GLIMMER_OPTION_ENV_VAR_MAPPING = {
       '--log-level' => 'GLIMMER_LOGGER_LEVEL'
     }
+    REGEX_RAKE_TASK_WITH_ARGS = /^([^\[]+)\[?([^\]]*)\]?$/
 
     @@mutex = Mutex.new
 
@@ -44,7 +66,7 @@ module Glimmer
         @@mutex.synchronize do
           unless @glimmer_lib
             @glimmer_lib = GLIMMER_LIB_GEM
-            glimmer_gem_listing = `jgem list #{GLIMMER_LIB_GEM}`
+            glimmer_gem_listing = `jgem list #{GLIMMER_LIB_GEM}`.split("\n").map {|l| l.split.first}
             if !glimmer_gem_listing.include?(GLIMMER_LIB_GEM) && File.exists?(GLIMMER_LIB_LOCAL)
               @glimmer_lib = GLIMMER_LIB_LOCAL
               puts "[DEVELOPMENT MODE] (detected #{@glimmer_lib})"
@@ -55,22 +77,43 @@ module Glimmer
       end
 
       def glimmer_option_env_vars(glimmer_options)
-        glimmer_options.map do |k, v|
-          "#{GLIMMER_OPTION_ENV_VAR_MAPPING[k]}=#{v}"
-        end.join(' ')
+        glimmer_options.reduce({}) do |hash, pair|
+          hash.merge(GLIMMER_OPTION_ENV_VAR_MAPPING[pair.first] => pair.last)
+        end
+      end
+
+      def load_env_vars(env_vars)
+        env_vars.each do |key, value|
+          ENV[key] = value
+        end
       end
 
       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_string, glimmer_option_env_vars(glimmer_options)].join(' ')
         the_glimmer_lib = glimmer_lib
         devmode_require = nil
         if the_glimmer_lib == GLIMMER_LIB_LOCAL
           devmode_require = '-r puts_debuggerer '
         end
-        puts "#{env_vars_string} jruby #{jruby_options_string}#{jruby_os_specific_options} #{devmode_require}-r #{the_glimmer_lib} -S #{application}" if jruby_options_string.to_s.include?('--debug')
-        system "#{env_vars_string} jruby #{jruby_options_string}#{jruby_os_specific_options} #{devmode_require}-r #{the_glimmer_lib} -S #{application}"
+        rake_tasks = Rake.application.tasks.map(&:to_s).map {|t| t.sub('glimmer:', '')}
+        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(',')
+        if rake_tasks.include?(application)
+          load_env_vars(glimmer_option_env_vars(glimmer_options))
+          rake_task = "glimmer:#{application}"
+          puts "Running Glimmer rake task: #{rake_task}" if jruby_options_string.to_s.include?('--debug')
+          Rake::Task[rake_task].invoke(*rake_task_args)
+        else
+          @@mutex.synchronize do
+            puts "Launching Glimmer Application: #{application}" unless application.to_s.match(/(irb)|(gladiator)/)
+          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')
+          system command
+        end
       end
     end
 
@@ -93,7 +136,6 @@ module Glimmer
 
     def launch_application
       threads = @application_paths.map do |application_path|
-        puts "Launching Glimmer Application: #{application_path}" unless application_path.to_s.match(/(irb)|(gladiator)/)
         Thread.new do
           self.class.launch(
             application_path,
@@ -107,7 +149,10 @@ module Glimmer
     end
 
     def display_usage
-      puts TEXT_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
     end
 
     def extract_application_paths(options)

data/lib/glimmer/rake_task.rb

@@ -1,4 +1,7 @@
-require 'glimmer/package'
+require 'rake'
+
+require_relative 'package'
+require_relative 'scaffold'
 
 namespace :glimmer do
   namespace :package do
@@ -11,7 +14,10 @@ namespace :glimmer do
         system('warble config')
         new_config = File.read('config/warble.rb').split("\n").inject('') do |output, line|
           if line.include?('config.dirs =')
-            line = line.sub('# ', '').sub(/=[^=\n]+$/, '= %w(app config db lib script bin docs fonts images sounds videos)')
+            line = line.sub('# ', '').sub(/=[^=\n]+$/, '= %w(app config db lib script bin docs fonts icons images sounds videos)')
+          end
+          if line.include?('config.includes =')
+            line = line.sub('# ', '').sub(/=[^=\n]+$/, "= FileList['LICENSE.txt', 'VERSION']")
           end
           if line.include?('config.autodeploy_dir =')
             line = line.sub('# ', '')
@@ -21,28 +27,63 @@ namespace :glimmer do
         File.write('config/warble.rb', new_config)
       end
     end
+
+    desc 'Generate JAR file'
+    task :jar => 'package:config' do
+      system('mkdir -p dist')
+      puts "Generating JAR with Warbler..."
+      system('warble')
+    end
+
+    desc 'Generate Native files (DMG/PKG/APP on the Mac)'
+    task :native => 'package:jar' do
+      require 'facets/string/titlecase'
+      require 'facets/string/underscore'
+      project_name = File.basename(File.expand_path('.'))
+      version_file = File.expand_path('./VERSION')
+      version = (File.read(version_file).strip if File.exists?(version_file) && File.file?(version_file)) rescue nil
+      license_file = File.expand_path('./LICENSE.txt')
+      license = (File.read(license_file).strip if File.exists?(license_file) && File.file?(license_file)) rescue nil
+      human_name = project_name.underscore.titlecase
+      command = "javapackager -deploy -native -outdir packages -outfile \"#{project_name}\" -srcfiles \"dist/#{project_name}.jar\" -appclass JarMain -name \"#{human_name}\" -title \"#{human_name}\" -BjvmOptions=-XstartOnFirstThread -Bmac.CFBundleName=\"#{human_name}\" -Bmac.CFBundleIdentifier=\"org.#{project_name}.application.#{project_name}\" -Bmac.category=\"public.app-category.business\" "
+      command += " -BappVersion=#{version} -Bmac.CFBundleVersion=#{version} " if version
+      command += " -srcfiles LICENSE.txt -BlicenseFile=LICENSE.txt " if license
+      command += " #{Glimmer::Package.javapackager_extra_args} " if Glimmer::Package.javapackager_extra_args
+      command += " #{ENV['JAVAPACKAGER_EXTRA_ARGS']} " if ENV['JAVAPACKAGER_EXTRA_ARGS']
+      puts "Generating DMG/PKG/APP/JNLP with javapackager..."
+      puts command
+      system command
+    end
   end
 
-  desc 'Package app for distribution'
-  task :package => 'package:config' do
-    require 'facets/string/titlecase'
-    require 'facets/string/underscore'
-    project_name = File.basename(File.expand_path('.'))
-    version_file = File.expand_path('./VERSION')
-    version = (File.read(version_file).strip if File.exists?(version_file) && File.file?(version_file)) rescue nil
-    license_file = File.expand_path('./LICENSE.txt')
-    license = (File.read(license_file).strip if File.exists?(license_file) && File.file?(license_file)) rescue nil
-    human_name = project_name.underscore.titlecase
-    system('mkdir -p dist')
-    puts "Generating JAR with Warbler..."
-    system('warble')
-    command = "javapackager -deploy -native -outdir packages -outfile \"#{project_name}\" -srcfiles \"dist/#{project_name}.jar\" -appclass JarMain -name \"#{human_name}\" -title \"#{human_name}\" -BjvmOptions=-XstartOnFirstThread -Bmac.CFBundleName=\"#{human_name}\" -Bmac.CFBundleIdentifier=\"org.#{project_name}.application.#{project_name}\" "
-    command += " -BappVersion=#{version} -Bmac.CFBundleVersion=#{version} " if version
-    command += " -srcfiles LICENSE.txt -BlicenseFile=LICENSE.txt " if license
-    command += " #{Glimmer::Package.javapackager_extra_args} " if Glimmer::Package.javapackager_extra_args
-    command += " #{ENV['JAVAPACKAGER_EXTRA_ARGS']} " if ENV['JAVAPACKAGER_EXTRA_ARGS']
-    puts "Generating DMG/PKG/APP/JNLP with javapackager..."
-    puts command
-    system command
+  desc 'Package app for distribution (generating config, jar, and native files)'
+  task :package => 'package:native'
+
+
+  desc 'Scaffold a Glimmer application directory structure to begin building a new app'
+  task :scaffold, [:app_name] do |t, args|
+    Scaffold.app(args[:app_name])
+  end
+
+  namespace :scaffold do
+    desc 'Scaffold a Glimmer::UI::CustomShell subclass (represents a full window view) under app/views (namespace is optional)'
+    task :custom_shell, [:custom_shell_name, :namespace] do |t, args|
+      Scaffold.custom_shell(args[:custom_shell_name], args[:namespace])
+    end
+    
+    desc 'Scaffold a Glimmer::UI::CustomWidget subclass (represents a part of a view) under app/views (namespace is optional)'
+    task :custom_widget, [:custom_widget_name, :namespace] do |t, args|
+      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])
+    end
+    
+    desc 'Scaffold a Glimmer::UI::CustomWidget subclass (represents a part of a view) under its own Ruby gem project (namespace is required)'
+    task :custom_widget_gem, [:custom_widget_name, :namespace] do |t, args|
+      Scaffold.custom_widget_gem(args[:custom_widget_name], args[:namespace])
+    end
   end
 end

data/lib/glimmer/scaffold.rb

@@ -0,0 +1,442 @@
+require 'fileutils'
+require 'os'
+require 'facets'
+
+class Scaffold
+  class << self
+    include FileUtils
+
+    VERSION = File.read(File.expand_path('../../../VERSION', __FILE__)).strip
+    RUBY_VERSION = File.read(File.expand_path('../../../RUBY_VERSION', __FILE__)).strip
+
+    # TODO externalize all constants into scaffold/files
+
+    GITIGNORE = <<~MULTI_LINE_STRING
+      *.gem
+      *.rbc
+      /.config
+      /coverage/
+      /InstalledFiles
+      /pkg/
+      /spec/reports/
+      /spec/examples.txt
+      /test/tmp/
+      /test/version_tmp/
+      /tmp/
+      
+      # Used by dotenv library to load environment variables.
+      # .env
+      
+      ## Specific to RubyMotion:
+      .dat*
+      .repl_history
+      build/
+      *.bridgesupport
+      build-iPhoneOS/
+      build-iPhoneSimulator/
+      
+      ## Specific to RubyMotion (use of CocoaPods):
+      #
+      # We recommend against adding the Pods directory to your .gitignore. However
+      # you should judge for yourself, the pros and cons are mentioned at:
+      # https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
+      #
+      # vendor/Pods/
+      
+      ## Documentation cache and generated files:
+      /.yardoc/
+      /_yardoc/
+      /doc/
+      /rdoc/
+      
+      ## Environment normalization:
+      /.bundle/
+      /vendor/bundle
+      /lib/bundler/man/
+      
+      # for a library or gem, you might want to ignore these files since the code is
+      # intended to run in multiple environments; otherwise, check them in:
+      Gemfile.lock
+      # .ruby-version
+      # .ruby-gemset
+      
+      # unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+      .rvmrc
+      
+      # Mac
+      .DS_Store
+      
+      # Gladiator (Glimmer Editor)
+      .gladiator
+      
+      # Glimmer
+      dist
+      packages      
+    MULTI_LINE_STRING
+
+    GEMFILE_APP = <<~MULTI_LINE_STRING
+      # frozen_string_literal: true
+      
+      source "https://rubygems.org"
+      
+      git_source(:github) {|repo_name| "https://github.com/\#{repo_name}" }
+      
+      gem 'glimmer', '~> #{VERSION}'
+      
+      group :test do
+        gem 'rspec'
+      end
+    MULTI_LINE_STRING
+
+    GEMFILE_GEM = <<~MULTI_LINE_STRING
+      # frozen_string_literal: true
+      
+      source "https://rubygems.org"
+      
+      git_source(:github) {|repo_name| "https://github.com/\#{repo_name}" }
+      
+      gem 'glimmer', '~> #{VERSION}'
+      
+      group :development do
+        gem "rspec", "~> 3.5.0"
+        gem "jeweler", "2.3.9"
+        gem "simplecov", ">= 0"
+      end
+    MULTI_LINE_STRING
+
+    RAKEFILE = <<~MULTI_LINE_STRING
+      require 'glimmer/rake_task'
+      
+      ## Uncomment the following section if you would like to customize javapackager
+      ## arguments for `glimmer package` command.
+      #
+      # Glimmer::Package.javapackager_extra_args =
+      #   " -BlicenseType=" +
+      #   " -Bmac.CFBundleIdentifier=" +
+      #   " -Bmac.category=" +
+      #   " -Bmac.signing-key-developer-id-app="
+    MULTI_LINE_STRING
+
+    RVM_FUNCTION = <<~MULTI_LINE_STRING
+      # Load RVM into a shell session *as a function*
+      if [[ -s "$HOME/.rvm/scripts/rvm" ]] ; then
+      
+        # First try to load from a user install
+        source "$HOME/.rvm/scripts/rvm"
+      
+      elif [[ -s "/usr/local/rvm/scripts/rvm" ]] ; then
+      
+        # Then try to load from a root install
+        source "/usr/local/rvm/scripts/rvm"
+      
+      fi
+    MULTI_LINE_STRING
+
+    def app(app_name)
+      mkdir app_name
+      cd app_name
+      write '.gitignore', GITIGNORE
+      write '.ruby-version', RUBY_VERSION        
+      write '.ruby-gemset', app_name
+      write 'VERSION', '1.0.0'
+      write 'LICENSE.txt', "Copyright (c) #{Time.now.year} #{app_name}"
+      write 'Gemfile', GEMFILE_APP
+      write 'Rakefile', RAKEFILE
+      mkdir 'app'
+      write "app/#{file_name(app_name)}.rb", app_main_file(app_name)
+      mkdir 'app/models'
+      mkdir 'app/views'
+      custom_shell('AppView', current_dir_name)
+      if OS.mac?
+        mkdir_p 'package/macosx'
+        icon_file = "package/macosx/#{human_name(app_name)}.icns"
+        cp File.expand_path('../../../icons/scaffold_app.icns', __FILE__), icon_file
+        puts "Created #{current_dir_name}/#{icon_file}"
+      end
+      mkdir 'bin'
+      write "bin/#{file_name(app_name)}", app_bin_file(app_name)
+      FileUtils.chmod 0755, "bin/#{app_name.underscore}"
+      system "bash -c '#{RVM_FUNCTION}\n cd .\n bundle\n glimmer package\n'"
+      system "open packages/bundles/#{human_name(app_name).gsub(' ', '\ ')}.app"
+      # TODO generate rspec test suite
+    end
+
+    def custom_shell(custom_shell_name, namespace)
+      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)
+    end
+
+    def custom_widget(custom_widget_name, namespace)
+      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_widget_name)}.rb", custom_widget_file(custom_widget_name, namespace)
+    end
+
+    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)}"
+      if namespace
+        gem_name += "-#{compact_name(namespace)}"
+        gem_summary += " (#{human_name(namespace)})"
+      else
+        namespace = 'glimmer'
+      end
+      system "jeweler --rspec --summary '#{gem_summary}' --description '#{gem_summary}' #{gem_name}" 
+      cd gem_name
+      write '.gitignore', GITIGNORE
+      write '.ruby-version', RUBY_VERSION        
+      write '.ruby-gemset', gem_name
+      write 'VERSION', '1.0.0'
+      write 'Gemfile', GEMFILE_GEM      
+      write 'Rakefile', gem_rakefile
+      append "lib/#{gem_name}.rb", gem_main_file(custom_shell_name, namespace)
+      mkdir 'lib/views'
+      custom_shell(custom_shell_name, namespace)
+      system "bash -c '#{RVM_FUNCTION}\n cd .\n bundle\n'"
+      puts "Finished creating #{gem_name} Ruby gem."
+      puts 'Edit Rakefile to configure gem details.'
+      puts 'Run `rake` to execute specs.'
+      puts 'Run `rake build` to build gem.'
+      puts 'Run `rake release` to release into rubygems.org once ready.'
+    end
+
+    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)}"
+      if namespace
+        gem_name += "-#{compact_name(namespace)}"
+        gem_summary += " (#{human_name(namespace)})"
+      else
+        namespace = 'glimmer'
+      end
+      system "jeweler --rspec --summary '#{gem_summary}' --description '#{gem_summary}' #{gem_name}" 
+      cd gem_name
+      write '.gitignore', GITIGNORE
+      write '.ruby-version', RUBY_VERSION        
+      write '.ruby-gemset', gem_name
+      write 'VERSION', '1.0.0'
+      write 'Gemfile', GEMFILE_GEM      
+      write 'Rakefile', gem_rakefile
+      write 'spec/spec_helper.rb', spec_helper_file
+      append "lib/#{gem_name}.rb", gem_main_file(custom_widget_name, namespace)
+      mkdir 'lib/views'
+      custom_widget(custom_widget_name, namespace)
+      system "bash -c '#{RVM_FUNCTION}\n cd .\n bundle\n'"
+      puts "Finished creating #{gem_name} Ruby gem."
+      puts 'Edit Rakefile to configure gem details.'
+      puts 'Run `rake` to execute specs.'
+      puts 'Run `rake build` to build gem.'
+      puts 'Run `rake release` to release into rubygems.org once ready.'
+    end
+
+    private
+
+    def write(file, content)
+      File.write file, content
+      file_path = File.expand_path(file)
+      puts "Created #{current_dir_name}/#{file}"
+    end
+
+    def append(file, content)
+      File.open(file, 'a') do |f|
+        f.write(content)
+      end
+    end
+
+    def current_dir_name
+      File.basename(File.expand_path('.'))
+    end
+
+    def class_name(app_name)
+      app_name.camelcase(:upper)
+    end
+
+    def file_name(app_name)
+      app_name.underscore
+    end
+
+    def human_name(app_name)
+      app_name.underscore.titlecase
+    end
+
+    def compact_name(gem_name)
+      gem_name.camelcase.downcase
+    end
+
+    def app_main_file(app_name)
+      <<~MULTI_LINE_STRING
+        $LOAD_PATH.unshift(File.expand_path('..', __FILE__))
+
+        require 'bundler/setup'
+        Bundler.require(:default)
+        require 'views/#{file_name(app_name)}/app_view'
+
+        class #{class_name(app_name)}
+          include Glimmer
+        
+          APP_ROOT = File.expand_path('../..', __FILE__)        
+          VERSION = File.read(File.expand_path('VERSION', APP_ROOT))
+                    
+          def open
+            app_view.open
+          end
+        end
+        
+        #{class_name(app_name)}.new.open
+      MULTI_LINE_STRING
+    end
+
+    def gem_main_file(custom_widget_name, namespace = nil)
+      custom_widget_file_path = "views"
+      custom_widget_file_path += "/#{file_name(namespace)}" if namespace
+      custom_widget_file_path += "/#{file_name(custom_widget_name)}"
+
+      <<~MULTI_LINE_STRING
+        $LOAD_PATH.unshift(File.expand_path('..', __FILE__))
+        
+        require 'glimmer'
+        require '#{custom_widget_file_path}'
+      MULTI_LINE_STRING
+    end
+
+    def app_bin_file(app_name)
+      <<~MULTI_LINE_STRING
+        #!/usr/bin/env ruby
+
+        require_relative '../app/#{file_name(app_name)}'
+      MULTI_LINE_STRING
+    end
+
+    def gem_rakefile
+      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']")
+      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"
+      lines.join("\n")
+    end
+
+    def spec_helper_file
+      content = File.read('spec/spec_helper.rb')
+      lines = content.split("\n")
+      require_line_index = lines.index(lines.detect {|l| l.include?('glimmer-cw-video') })
+      lines[require_line_index...require_line_index] = [
+        "require 'bundler/setup'",
+        'Bundler.require(:default, :development)',
+      ]
+      configure_block_line_index = lines.index(lines.detect {|l| l.include?('RSpec.configure do') }) + 1
+      lines[configure_block_line_index...configure_block_line_index] = [
+        '  # The following ensures rspec tests that instantiate and set Glimmer DSL widgets in @target get cleaned after',
+        '  config.after do',
+        '    @target.dispose if @target && @target.respond_to?(:dispose)',
+        '    Glimmer::DSL::Engine.reset',
+        '  end',
+      ]
+      
+      lines << "\nrequire 'glimmer/rake_task'\n"
+      lines.join("\n")
+    end
+
+    def custom_shell_file(custom_shell_name, namespace)
+      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 {
+            # 
+            # }
+        
+            ## 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
+                }
+              }
+            }
+        
+          end
+        end
+      MULTI_LINE_STRING
+    end
+
+    def custom_widget_file(custom_widget_name, namespace)
+      namespace_type = class_name(namespace) == class_name(current_dir_name) ? 'class' : 'module'
+
+      <<~MULTI_LINE_STRING
+        #{namespace_type} #{class_name(namespace)}
+          class #{class_name(custom_widget_name)}
+            include Glimmer::UI::CustomWidget
+        
+            ## Add options like the following to configure CustomWidget by outside consumers
+            #
+            # options :custom_text, :background_color
+            # option :foreground_color, :red
+        
+            ## 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 {
+            # 
+            # }
+        
+            ## Add widget content under custom widget body
+            ##
+            ## If you want to add a shell as the top-most widget, 
+            ## consider creating a custom shell instead 
+            ## (Glimmer::UI::CustomShell offers shell convenience methods, like show and hide)
+            #
+            body {
+              # Replace example content below with custom widget content
+              label {
+                background :red
+              }
+            }
+        
+          end
+        end
+      MULTI_LINE_STRING
+    end
+  end
+end