cosmos 3.5.1 → 3.5.2

data/lib/cosmos/tools/launcher/launcher.rb

@@ -1,188 +1,188 @@
-# encoding: ascii-8bit
-
-# Copyright 2014 Ball Aerospace & Technologies Corp.
-# All Rights Reserved.
-#
-# This program is free software; you can modify and/or redistribute it
-# under the terms of the GNU General Public License
-# as published by the Free Software Foundation; version 3 with
-# attribution addendums as found in the LICENSE.txt
-
-require 'cosmos'
-Cosmos.catch_fatal_exception do
-  require 'cosmos/gui/qt_tool'
-  require 'cosmos/tools/launcher/launcher_config'
-  require 'cosmos/tools/launcher/launcher_tool'
-  require 'cosmos/tools/launcher/launcher_multitool'
-  require 'cosmos/gui/dialogs/legal_dialog'
-end
-
-module Cosmos
-
-  class Launcher < QtTool
-
-    def initialize(options)
-      super(options) # MUST BE FIRST - All code before super is executed twice in RubyQt Based classes
-
-      # Set environment variable of COSMOS_USERPATH so that all launched apps know where to find the configuration
-      ENV['COSMOS_USERPATH'] = Cosmos::USERPATH
-
-      Cosmos.load_cosmos_icon("launcher.png")
-      layout.setSizeConstraint(Qt::Layout::SetFixedSize)
-
-      @about_string = "Launcher provides a list of applications to launch at the click of a button. It can also launch multiple applications and configure their exact placement on the screen."
-      initialize_actions()
-      initialize_menus()
-      initialize_central_widget()
-      complete_initialize()
-    end
-
-    def initialize_menus
-      # File Menu
-      @file_menu = menuBar().addMenu(tr('&File'))
-      @file_menu.addAction(@exit_action)
-
-      # Help Menu
-      initialize_help_menu()
-    end
-
-    def initialize_central_widget
-      # Create the central widget
-      central_widget = Qt::Widget.new
-      setCentralWidget(central_widget)
-
-      # Read the configuration file
-      config_file = File.join(Cosmos::USERPATH, 'config', 'tools', 'launcher', @options.config_file)
-      begin
-        config = LauncherConfig.new(config_file)
-      rescue => error
-        ExceptionDialog.new(self, error, "Error parsing #{config_file}")
-      end
-
-      # Set the title
-      self.window_title = config.title
-
-      # Create each button or divider
-      default_icon_filename = 'COSMOS_64x64.png'
-      widgets = []
-      config.items.each do |item_type, text, shell_command_or_settings, capture_io, icon_filename, variable_parameters|
-        case item_type
-        when :TOOL, :MULTITOOL
-          layout = Qt::VBoxLayout.new
-          if icon_filename
-            icon = Cosmos.get_icon(icon_filename)
-          else
-            icon = Cosmos.get_icon(default_icon_filename)
-          end
-          button = Qt::PushButton.new('')
-          button.setIcon(icon)
-          button.setIconSize(Qt::Size.new(64,64))
-          if item_type == :TOOL
-            connect(button,
-                    SIGNAL('clicked()'),
-                    LauncherTool.new(self, text, shell_command_or_settings, capture_io, variable_parameters),
-                    SLOT('button_clicked()'))
-          else
-            connect(button,
-                    SIGNAL('clicked()'),
-                    LauncherMultitool.new(self, shell_command_or_settings),
-                    SLOT('button_clicked()'))
-          end
-          if Kernel.is_mac?
-            button.setFixedSize(84,84)
-          else
-            stylesheet = "padding:4px; text-align:center; " \
-              "font-family:#{config.tool_font_settings[0]}; " \
-              "font-size:#{config.tool_font_settings[1]}px"
-            button.setStyleSheet(stylesheet)
-            button.setFixedSize(74,74)
-          end
-          label = Qt::Label.new(text)
-          stylesheet = "text-align:center; " \
-            "font-family:#{config.tool_font_settings[0]}; " \
-            "font-size:#{config.tool_font_settings[1]}px"
-          label.setStyleSheet(stylesheet)
-          label.wordWrap = true
-          label.setFixedWidth(70)
-          label.setSizePolicy(Qt::SizePolicy::Fixed, Qt::SizePolicy::Fixed)
-          label.setMinimumSize(label.sizeHint)
-          label.setAlignment(Qt::AlignHCenter)
-          layout.addWidget(button)
-          layout.addWidget(label)
-          layout.setAlignment(button, Qt::AlignHCenter)
-          layout.setAlignment(label, Qt::AlignHCenter)
-          widgets << layout
-
-        when :DIVIDER
-          divider = Qt::Frame.new
-          divider.setFrameStyle(Qt::Frame::HLine | Qt::Frame::Raised)
-          divider.setLineWidth(1)
-          divider.setMidLineWidth(1)
-          widgets << divider
-
-        when :LABEL
-          label = Qt::Label.new(text)
-          stylesheet = "text-align:center; " \
-            "font-family:#{config.label_font_settings[0]}; " \
-            "font-size:#{config.label_font_settings[1]}px"
-          label.setStyleSheet(stylesheet)
-          widgets << label
-
-        else
-          raise "Unhandled item type from LauncherConfig: #{item_type}"
-        end
-      end
-
-      # Add widgets to layout
-      col = 0
-      h_layout = nil
-      v_layout = Qt::VBoxLayout.new
-      central_widget.layout = v_layout
-      widgets.each do |widget|
-        if Qt::VBoxLayout === widget
-          unless h_layout
-            h_layout = Qt::HBoxLayout.new
-            v_layout.addLayout(h_layout)
-            col = 0
-          end
-          widget.setAlignment(Qt::AlignTop | Qt::AlignLeft)
-          h_layout.addLayout(widget)
-          col += 1
-          if col >= config.num_columns
-            col = 0
-            h_layout = nil
-          end
-        else
-          # Divider or Label
-          h_layout.addStretch(0) if h_layout
-          v_layout.addWidget(widget)
-          h_layout = nil
-        end
-      end
-      h_layout.addStretch(0) if h_layout
-    end
-
-    def self.pre_window_new_hook(options)
-      # Show legal dialog
-      LegalDialog.new
-    end
-
-    def self.run(option_parser = nil, options = nil)
-      Cosmos.catch_fatal_exception do
-        unless option_parser and options
-          option_parser, options = create_default_options()
-          options.title = 'Launcher'
-          options.config_file = 'launcher.txt'
-          option_parser.separator "Launcher Specific Options:"
-          option_parser.on("-c", "--config FILE", "Use the specified configuration file") do |arg|
-            options.config_file = arg
-          end
-        end
-
-        super(option_parser, options)
-      end
-    end
-
-  end # class Launcher
-
-end
+# encoding: ascii-8bit
+
+# Copyright 2014 Ball Aerospace & Technologies Corp.
+# All Rights Reserved.
+#
+# This program is free software; you can modify and/or redistribute it
+# under the terms of the GNU General Public License
+# as published by the Free Software Foundation; version 3 with
+# attribution addendums as found in the LICENSE.txt
+
+require 'cosmos'
+Cosmos.catch_fatal_exception do
+  require 'cosmos/gui/qt_tool'
+  require 'cosmos/tools/launcher/launcher_config'
+  require 'cosmos/tools/launcher/launcher_tool'
+  require 'cosmos/tools/launcher/launcher_multitool'
+  require 'cosmos/gui/dialogs/legal_dialog'
+end
+
+module Cosmos
+
+  class Launcher < QtTool
+
+    def initialize(options)
+      super(options) # MUST BE FIRST - All code before super is executed twice in RubyQt Based classes
+
+      # Set environment variable of COSMOS_USERPATH so that all launched apps know where to find the configuration
+      ENV['COSMOS_USERPATH'] = Cosmos::USERPATH
+
+      Cosmos.load_cosmos_icon("launcher.png")
+      layout.setSizeConstraint(Qt::Layout::SetFixedSize)
+
+      @about_string = "Launcher provides a list of applications to launch at the click of a button. It can also launch multiple applications and configure their exact placement on the screen."
+      initialize_actions()
+      initialize_menus()
+      initialize_central_widget()
+      complete_initialize()
+    end
+
+    def initialize_menus
+      # File Menu
+      @file_menu = menuBar().addMenu(tr('&File'))
+      @file_menu.addAction(@exit_action)
+
+      # Help Menu
+      initialize_help_menu()
+    end
+
+    def initialize_central_widget
+      # Create the central widget
+      central_widget = Qt::Widget.new
+      setCentralWidget(central_widget)
+
+      # Read the configuration file
+      config_file = File.join(Cosmos::USERPATH, 'config', 'tools', 'launcher', @options.config_file)
+      begin
+        config = LauncherConfig.new(config_file)
+      rescue => error
+        ExceptionDialog.new(self, error, "Error parsing #{config_file}")
+      end
+
+      # Set the title
+      self.window_title = config.title
+
+      # Create each button or divider
+      default_icon_filename = 'COSMOS_64x64.png'
+      widgets = []
+      config.items.each do |item_type, text, shell_command_or_settings, capture_io, icon_filename, variable_parameters|
+        case item_type
+        when :TOOL, :MULTITOOL
+          layout = Qt::VBoxLayout.new
+          if icon_filename
+            icon = Cosmos.get_icon(icon_filename)
+          else
+            icon = Cosmos.get_icon(default_icon_filename)
+          end
+          button = Qt::PushButton.new('')
+          button.setIcon(icon)
+          button.setIconSize(Qt::Size.new(64,64))
+          if item_type == :TOOL
+            connect(button,
+                    SIGNAL('clicked()'),
+                    LauncherTool.new(self, text, shell_command_or_settings, capture_io, variable_parameters),
+                    SLOT('button_clicked()'))
+          else
+            connect(button,
+                    SIGNAL('clicked()'),
+                    LauncherMultitool.new(self, shell_command_or_settings),
+                    SLOT('button_clicked()'))
+          end
+          if Kernel.is_mac?
+            button.setFixedSize(84,84)
+          else
+            stylesheet = "padding:4px; text-align:center; " \
+              "font-family:#{config.tool_font_settings[0]}; " \
+              "font-size:#{config.tool_font_settings[1]}px"
+            button.setStyleSheet(stylesheet)
+            button.setFixedSize(74,74)
+          end
+          label = Qt::Label.new(text)
+          stylesheet = "text-align:center; " \
+            "font-family:#{config.tool_font_settings[0]}; " \
+            "font-size:#{config.tool_font_settings[1]}px"
+          label.setStyleSheet(stylesheet)
+          label.wordWrap = true
+          label.setFixedWidth(70)
+          label.setSizePolicy(Qt::SizePolicy::Fixed, Qt::SizePolicy::Fixed)
+          label.setMinimumSize(label.sizeHint)
+          label.setAlignment(Qt::AlignHCenter)
+          layout.addWidget(button)
+          layout.addWidget(label)
+          layout.setAlignment(button, Qt::AlignHCenter)
+          layout.setAlignment(label, Qt::AlignHCenter)
+          widgets << layout
+
+        when :DIVIDER
+          divider = Qt::Frame.new
+          divider.setFrameStyle(Qt::Frame::HLine | Qt::Frame::Raised)
+          divider.setLineWidth(1)
+          divider.setMidLineWidth(1)
+          widgets << divider
+
+        when :LABEL
+          label = Qt::Label.new(text)
+          stylesheet = "text-align:center; " \
+            "font-family:#{config.label_font_settings[0]}; " \
+            "font-size:#{config.label_font_settings[1]}px"
+          label.setStyleSheet(stylesheet)
+          widgets << label
+
+        else
+          raise "Unhandled item type from LauncherConfig: #{item_type}"
+        end
+      end
+
+      # Add widgets to layout
+      col = 0
+      h_layout = nil
+      v_layout = Qt::VBoxLayout.new
+      central_widget.layout = v_layout
+      widgets.each do |widget|
+        if Qt::VBoxLayout === widget
+          unless h_layout
+            h_layout = Qt::HBoxLayout.new
+            v_layout.addLayout(h_layout)
+            col = 0
+          end
+          widget.setAlignment(Qt::AlignTop | Qt::AlignLeft)
+          h_layout.addLayout(widget)
+          col += 1
+          if col >= config.num_columns
+            col = 0
+            h_layout = nil
+          end
+        else
+          # Divider or Label
+          h_layout.addStretch(0) if h_layout
+          v_layout.addWidget(widget)
+          h_layout = nil
+        end
+      end
+      h_layout.addStretch(0) if h_layout
+    end
+
+    def self.pre_window_new_hook(options)
+      # Show legal dialog
+      LegalDialog.new
+    end
+
+    def self.run(option_parser = nil, options = nil)
+      Cosmos.catch_fatal_exception do
+        unless option_parser and options
+          option_parser, options = create_default_options()
+          options.title = 'Launcher'
+          options.config_file = 'launcher.txt'
+          option_parser.separator "Launcher Specific Options:"
+          option_parser.on("-c", "--config FILE", "Use the specified configuration file") do |arg|
+            options.config_file = arg
+          end
+        end
+
+        super(option_parser, options)
+      end
+    end
+
+  end # class Launcher
+
+end

data/lib/cosmos/tools/launcher/launcher_config.rb

@@ -1,256 +1,256 @@
-# encoding: ascii-8bit
-
-# Copyright 2014 Ball Aerospace & Technologies Corp.
-# All Rights Reserved.
-#
-# This program is free software; you can modify and/or redistribute it
-# under the terms of the GNU General Public License
-# as published by the Free Software Foundation; version 3 with
-# attribution addendums as found in the LICENSE.txt
-
-require 'cosmos'
-require 'cosmos/config/config_parser'
-require 'ostruct'
-require 'bundler'
-
-module Cosmos
-
-  # Reads and interprets the Launcher configuration file
-  class LauncherConfig
-
-    # Launcher title
-    attr_reader :title
-
-    # Array for tool font settings [font_name, font_size]
-    attr_reader :tool_font_settings
-
-    # Array for label font settings [font_name, font_size]
-    attr_reader :label_font_settings
-
-    # Array of [[item_type, text, shell command, icon filename, variable params], ...]
-    # Where variable params is nil or an array of [[parameter name, parameter value], ...]
-    attr_reader :items
-
-    # Number of columns per row
-    attr_reader :num_columns
-
-    # Processes a file and adds in the configuration defined in the file
-    #
-    # @param filename [String] Name of the configuration file to parse
-    def initialize(filename)
-      @title = 'COSMOS Launcher'
-      @tool_font_settings  = ['Arial', 12]
-      @label_font_settings = ['Arial', 16]
-      @num_columns = 4
-      @items = []
-
-      if File.exist?(filename.to_s)
-        parse_file(filename)
-      else
-        raise "Launcher configuration file does not exist: #{filename}"
-      end
-    end # def initialize
-
-    # Create a ConfigParser and parse all the lines in the configuration file
-    #
-    # @param filename [String] Name of the configuration file to parse
-    def parse_file(filename)
-      multitool = nil
-
-      # Loop over each line of the configuration file
-      parser = ConfigParser.new
-      parser.parse_file(filename) do |keyword, params|
-        # Handle each keyword
-        case keyword
-
-        when 'AUTO_GEM_TOOLS'
-          parse_gem_tool(parser)
-
-        when 'TOOL'
-          parse_tool(parser, params, multitool)
-
-        when 'MULTITOOL_START'
-          parser.verify_num_parameters(1, 2, "MULTITOOL_START <Button Text> <Icon Filename (optional)>")
-          multitool = OpenStruct.new
-          multitool.text = params[0]
-          multitool.icon_filename = ConfigParser.handle_nil(params[1])
-          multitool.icon_filename = 'multi.png' unless multitool.icon_filename
-          multitool.settings = []
-
-        when 'MULTITOOL_END'
-          parser.verify_num_parameters(0, 0, "MULTITOOL_END")
-          raise parser.error("No TOOLs defined within the MULTITOOL") if multitool.settings.select {|setting| setting[0] == :TOOL }.empty?
-          @items << [:MULTITOOL, multitool.text, multitool.settings, true, multitool.icon_filename, nil]
-          multitool = nil
-
-        when 'DELAY'
-          if multitool
-            parser.verify_num_parameters(1, 1, "DELAY <Delay in seconds>")
-            multitool.settings << [:DELAY, Float(params[0]), true]
-          else
-            raise parser.error("DELAY keyword only valid within MULTITOOL")
-          end
-
-        when 'DIVIDER'
-          parser.verify_num_parameters(0, 0, "DIVIDER")
-          @items << [:DIVIDER, nil, nil, nil, nil]
-
-        when 'LABEL'
-          parser.verify_num_parameters(1, 1, "LABEL <Label Text>")
-          @items << [:LABEL, params[0], nil, nil, nil]
-
-        when 'TOOL_FONT', 'LABEL_FONT'
-          usage = "#{keyword} <Font Name> <Font Size>"
-          parser.verify_num_parameters(2, 2, usage)
-          begin
-            @tool_font_settings = [params[0], Integer(params[1])] if keyword == 'TOOL_FONT'
-            @label_font_settings = [params[0], Integer(params[1])] if keyword == 'LABEL_FONT'
-          rescue ArgumentError
-            raise parser.error("#{usage} passed '#{params[0]} #{params[1]}'")
-          end
-
-        when 'TITLE'
-          parser.verify_num_parameters(1, 1, "TITLE <Title Text>")
-          @title = params[0]
-
-        when 'NUM_COLUMNS'
-          usage = "NUM_COLUMNS <Num Columns>"
-          parser.verify_num_parameters(1, 1, usage)
-          begin
-            @num_columns = Integer(params[0])
-          rescue ArgumentError
-            raise parser.error("#{usage} passed '#{params[0]}'")
-          end
-
-        when 'DONT_CAPTURE_IO'
-          parser.verify_num_parameters(0, 0, "DONT_CAPTURE_IO")
-          if multitool
-            if multitool.settings[-1].nil? || multitool.settings[-1][0] != :TOOL
-              raise parser.error("DONT_CAPTURE_IO must follow a TOOL")
-            end
-            multitool.settings[-1][2] = false
-          else
-            if @items[-1].nil? || @items[-1][0] != :TOOL
-              raise parser.error("DONT_CAPTURE_IO must follow a TOOL")
-            end
-            @items[-1][3] = false
-          end
-
-        else # UNKNOWN
-          raise parser.error("Unknown keyword '#{keyword}'.") if keyword
-        end # case keyword
-      end # parser.parse_file
-    end
-
-    protected
-
-    def parse_gem_tool(parser)
-      parser.verify_num_parameters(0, 0, parser.keyword)
-      Bundler.load.specs.each do |spec|
-        spec_name_split = spec.name.split('-')
-        if spec_name_split.length > 1 and spec_name_split[0] == 'cosmos'
-          # Filter to just tools and not targets
-          if File.exist?(File.join(spec.gem_dir, 'tools'))
-            Dir[File.join(spec.gem_dir, 'tools', '*')].each do |filename|
-              if File.extname(filename) == ''
-                @items << [:TOOL, File.basename(filename), format_shell_command(parser, "LAUNCH_GEM #{File.basename(filename)}"), true, File.basename(filename).class_name_to_filename(false) + '.png', nil]
-              end
-            end
-          end
-        end
-      end
-    rescue Bundler::GemfileNotFound
-      # No Gemfile - so no gem based tools
-    end
-
-    def parse_tool(parser, params, multitool)
-      if multitool
-        parser.verify_num_parameters(1, 1, "TOOL <Shell command>")
-        multitool.settings << [:TOOL, format_shell_command(parser, params[0]), true]
-      else
-        parser.verify_num_parameters(2, nil, "TOOL <Button Text> <Shell command> <Icon Filename (optional)> <Parameter Name #1 (optional)> <Parameter Value #1 (optional)> ...")
-        variable_params = nil
-        # Determine if there are parameters which will be displayed in a GUI
-        # dialog when the tool starts
-        if params.length > 3
-          raise parser.error("Unbalanced variable params for #{params[0]}") if (params.length % 2) != 1
-          variable_params = []
-          params[3..-1].each_slice(2) { |variable_parameter| variable_params << variable_parameter }
-        end
-        @items << [:TOOL, params[0], format_shell_command(parser, params[1]), true, ConfigParser.handle_nil(params[2]), variable_params]
-      end
-    end
-
-    def format_shell_command(parser, shell_command)
-      formatted_command = ''
-      case shell_command.split[0]
-      when 'LAUNCH'
-        formatted_command = parse_launch(shell_command)
-      when 'LAUNCH_TERMINAL'
-        formatted_command = parse_launch_terminal(shell_command)
-      when 'LAUNCH_GEM'
-        formatted_command = parse_launch_gem(shell_command)
-      else
-        # Nothing to do if they aren't using our keywords
-        formatted_command = shell_command
-      end
-      if Kernel.is_windows?
-        rubyw_sub = 'rubyw'
-      else
-        rubyw_sub = 'ruby'
-      end
-
-      formatted_command.gsub!('RUBYW', rubyw_sub)
-      formatted_command
-    end
-
-    def parse_launch(command)
-      split = command.split
-      if Kernel.is_mac? and File.exist?(File.join(USERPATH, 'tools', 'mac'))
-        formatted = "open tools/mac/#{split[1]}.app --args #{split[2..-1].join(' ')}".strip
-      else
-        formatted = "RUBYW tools/#{split[1]} #{split[2..-1].join(' ')}".strip
-      end
-      formatted
-    end
-
-    def parse_launch_terminal(command)
-      split = command.split
-      if Kernel.is_mac?
-        formatted = "osascript -e 'tell application \"Terminal\" to do script \"cd #{File.expand_path(USERPATH)} && ruby tools/#{split[1]} #{split[2..-1].join(' ')}\"' -e 'return'"
-      elsif Kernel.is_windows?
-        formatted = "start ruby tools/#{split[1]} #{split[2..-1].join(' ')}".strip
-      else
-        formatted = "gnome-terminal -e \"ruby tools/#{split[1]} #{split[2..-1].join(' ')}\""
-      end
-      formatted
-    end
-
-    def parse_launch_gem(command)
-      split = command.split
-
-      # Find the gem with this file
-      begin
-        Bundler.load.specs.each do |spec|
-          spec_name_split = spec.name.split('-')
-          if spec_name_split.length > 1 and spec_name_split[0] == 'cosmos'
-            # Filter to just tools and not targets
-            if File.exist?(File.join(spec.gem_dir, 'tools', split[1]))
-              if Kernel.is_mac? and File.exist?(File.join(USERPATH, 'tools', 'mac'))
-                return "open #{spec.gem_dir}/tools/mac/#{split[1]}.app --args #{split[2..-1].join(' ')}".strip
-              else
-                return "RUBYW #{spec.gem_dir}/tools/#{split[1]} #{split[2..-1].join(' ')}".strip
-              end
-            end
-          end
-        end
-      rescue Bundler::GemfileNotFound
-        # No Gemfile - so no gem based tools
-      end
-
-      raise "Could not find gem containing tool: #{split[1]} - Make sure the appropriate gem is in your Gemfile"
-    end
-
-  end # class LauncherConfig
-
-end # module Cosmos
+# encoding: ascii-8bit
+
+# Copyright 2014 Ball Aerospace & Technologies Corp.
+# All Rights Reserved.
+#
+# This program is free software; you can modify and/or redistribute it
+# under the terms of the GNU General Public License
+# as published by the Free Software Foundation; version 3 with
+# attribution addendums as found in the LICENSE.txt
+
+require 'cosmos'
+require 'cosmos/config/config_parser'
+require 'ostruct'
+require 'bundler'
+
+module Cosmos
+
+  # Reads and interprets the Launcher configuration file
+  class LauncherConfig
+
+    # Launcher title
+    attr_reader :title
+
+    # Array for tool font settings [font_name, font_size]
+    attr_reader :tool_font_settings
+
+    # Array for label font settings [font_name, font_size]
+    attr_reader :label_font_settings
+
+    # Array of [[item_type, text, shell command, icon filename, variable params], ...]
+    # Where variable params is nil or an array of [[parameter name, parameter value], ...]
+    attr_reader :items
+
+    # Number of columns per row
+    attr_reader :num_columns
+
+    # Processes a file and adds in the configuration defined in the file
+    #
+    # @param filename [String] Name of the configuration file to parse
+    def initialize(filename)
+      @title = 'COSMOS Launcher'
+      @tool_font_settings  = ['Arial', 12]
+      @label_font_settings = ['Arial', 16]
+      @num_columns = 4
+      @items = []
+
+      if File.exist?(filename.to_s)
+        parse_file(filename)
+      else
+        raise "Launcher configuration file does not exist: #{filename}"
+      end
+    end # def initialize
+
+    # Create a ConfigParser and parse all the lines in the configuration file
+    #
+    # @param filename [String] Name of the configuration file to parse
+    def parse_file(filename)
+      multitool = nil
+
+      # Loop over each line of the configuration file
+      parser = ConfigParser.new
+      parser.parse_file(filename) do |keyword, params|
+        # Handle each keyword
+        case keyword
+
+        when 'AUTO_GEM_TOOLS'
+          parse_gem_tool(parser)
+
+        when 'TOOL'
+          parse_tool(parser, params, multitool)
+
+        when 'MULTITOOL_START'
+          parser.verify_num_parameters(1, 2, "MULTITOOL_START <Button Text> <Icon Filename (optional)>")
+          multitool = OpenStruct.new
+          multitool.text = params[0]
+          multitool.icon_filename = ConfigParser.handle_nil(params[1])
+          multitool.icon_filename = 'multi.png' unless multitool.icon_filename
+          multitool.settings = []
+
+        when 'MULTITOOL_END'
+          parser.verify_num_parameters(0, 0, "MULTITOOL_END")
+          raise parser.error("No TOOLs defined within the MULTITOOL") if multitool.settings.select {|setting| setting[0] == :TOOL }.empty?
+          @items << [:MULTITOOL, multitool.text, multitool.settings, true, multitool.icon_filename, nil]
+          multitool = nil
+
+        when 'DELAY'
+          if multitool
+            parser.verify_num_parameters(1, 1, "DELAY <Delay in seconds>")
+            multitool.settings << [:DELAY, Float(params[0]), true]
+          else
+            raise parser.error("DELAY keyword only valid within MULTITOOL")
+          end
+
+        when 'DIVIDER'
+          parser.verify_num_parameters(0, 0, "DIVIDER")
+          @items << [:DIVIDER, nil, nil, nil, nil]
+
+        when 'LABEL'
+          parser.verify_num_parameters(1, 1, "LABEL <Label Text>")
+          @items << [:LABEL, params[0], nil, nil, nil]
+
+        when 'TOOL_FONT', 'LABEL_FONT'
+          usage = "#{keyword} <Font Name> <Font Size>"
+          parser.verify_num_parameters(2, 2, usage)
+          begin
+            @tool_font_settings = [params[0], Integer(params[1])] if keyword == 'TOOL_FONT'
+            @label_font_settings = [params[0], Integer(params[1])] if keyword == 'LABEL_FONT'
+          rescue ArgumentError
+            raise parser.error("#{usage} passed '#{params[0]} #{params[1]}'")
+          end
+
+        when 'TITLE'
+          parser.verify_num_parameters(1, 1, "TITLE <Title Text>")
+          @title = params[0]
+
+        when 'NUM_COLUMNS'
+          usage = "NUM_COLUMNS <Num Columns>"
+          parser.verify_num_parameters(1, 1, usage)
+          begin
+            @num_columns = Integer(params[0])
+          rescue ArgumentError
+            raise parser.error("#{usage} passed '#{params[0]}'")
+          end
+
+        when 'DONT_CAPTURE_IO'
+          parser.verify_num_parameters(0, 0, "DONT_CAPTURE_IO")
+          if multitool
+            if multitool.settings[-1].nil? || multitool.settings[-1][0] != :TOOL
+              raise parser.error("DONT_CAPTURE_IO must follow a TOOL")
+            end
+            multitool.settings[-1][2] = false
+          else
+            if @items[-1].nil? || @items[-1][0] != :TOOL
+              raise parser.error("DONT_CAPTURE_IO must follow a TOOL")
+            end
+            @items[-1][3] = false
+          end
+
+        else # UNKNOWN
+          raise parser.error("Unknown keyword '#{keyword}'.") if keyword
+        end # case keyword
+      end # parser.parse_file
+    end
+
+    protected
+
+    def parse_gem_tool(parser)
+      parser.verify_num_parameters(0, 0, parser.keyword)
+      Bundler.load.specs.each do |spec|
+        spec_name_split = spec.name.split('-')
+        if spec_name_split.length > 1 and spec_name_split[0] == 'cosmos'
+          # Filter to just tools and not targets
+          if File.exist?(File.join(spec.gem_dir, 'tools'))
+            Dir[File.join(spec.gem_dir, 'tools', '*')].each do |filename|
+              if File.extname(filename) == ''
+                @items << [:TOOL, File.basename(filename), format_shell_command(parser, "LAUNCH_GEM #{File.basename(filename)}"), true, File.basename(filename).class_name_to_filename(false) + '.png', nil]
+              end
+            end
+          end
+        end
+      end
+    rescue Bundler::GemfileNotFound
+      # No Gemfile - so no gem based tools
+    end
+
+    def parse_tool(parser, params, multitool)
+      if multitool
+        parser.verify_num_parameters(1, 1, "TOOL <Shell command>")
+        multitool.settings << [:TOOL, format_shell_command(parser, params[0]), true]
+      else
+        parser.verify_num_parameters(2, nil, "TOOL <Button Text> <Shell command> <Icon Filename (optional)> <Parameter Name #1 (optional)> <Parameter Value #1 (optional)> ...")
+        variable_params = nil
+        # Determine if there are parameters which will be displayed in a GUI
+        # dialog when the tool starts
+        if params.length > 3
+          raise parser.error("Unbalanced variable params for #{params[0]}") if (params.length % 2) != 1
+          variable_params = []
+          params[3..-1].each_slice(2) { |variable_parameter| variable_params << variable_parameter }
+        end
+        @items << [:TOOL, params[0], format_shell_command(parser, params[1]), true, ConfigParser.handle_nil(params[2]), variable_params]
+      end
+    end
+
+    def format_shell_command(parser, shell_command)
+      formatted_command = ''
+      case shell_command.split[0]
+      when 'LAUNCH'
+        formatted_command = parse_launch(shell_command)
+      when 'LAUNCH_TERMINAL'
+        formatted_command = parse_launch_terminal(shell_command)
+      when 'LAUNCH_GEM'
+        formatted_command = parse_launch_gem(shell_command)
+      else
+        # Nothing to do if they aren't using our keywords
+        formatted_command = shell_command
+      end
+      if Kernel.is_windows?
+        rubyw_sub = 'rubyw'
+      else
+        rubyw_sub = 'ruby'
+      end
+
+      formatted_command.gsub!('RUBYW', rubyw_sub)
+      formatted_command
+    end
+
+    def parse_launch(command)
+      split = command.split
+      if Kernel.is_mac? and File.exist?(File.join(USERPATH, 'tools', 'mac'))
+        formatted = "open tools/mac/#{split[1]}.app --args #{split[2..-1].join(' ')}".strip
+      else
+        formatted = "RUBYW tools/#{split[1]} #{split[2..-1].join(' ')}".strip
+      end
+      formatted
+    end
+
+    def parse_launch_terminal(command)
+      split = command.split
+      if Kernel.is_mac?
+        formatted = "osascript -e 'tell application \"Terminal\" to do script \"cd #{File.expand_path(USERPATH)} && ruby tools/#{split[1]} #{split[2..-1].join(' ')}\"' -e 'return'"
+      elsif Kernel.is_windows?
+        formatted = "start ruby tools/#{split[1]} #{split[2..-1].join(' ')}".strip
+      else
+        formatted = "gnome-terminal -e \"ruby tools/#{split[1]} #{split[2..-1].join(' ')}\""
+      end
+      formatted
+    end
+
+    def parse_launch_gem(command)
+      split = command.split
+
+      # Find the gem with this file
+      begin
+        Bundler.load.specs.each do |spec|
+          spec_name_split = spec.name.split('-')
+          if spec_name_split.length > 1 and spec_name_split[0] == 'cosmos'
+            # Filter to just tools and not targets
+            if File.exist?(File.join(spec.gem_dir, 'tools', split[1]))
+              if Kernel.is_mac? and File.exist?(File.join(USERPATH, 'tools', 'mac'))
+                return "open #{spec.gem_dir}/tools/mac/#{split[1]}.app --args #{split[2..-1].join(' ')}".strip
+              else
+                return "RUBYW #{spec.gem_dir}/tools/#{split[1]} #{split[2..-1].join(' ')}".strip
+              end
+            end
+          end
+        end
+      rescue Bundler::GemfileNotFound
+        # No Gemfile - so no gem based tools
+      end
+
+      raise "Could not find gem containing tool: #{split[1]} - Make sure the appropriate gem is in your Gemfile"
+    end
+
+  end # class LauncherConfig
+
+end # module Cosmos