cosmos 3.0.1 → 3.1.0

data/lib/cosmos/system/target.rb

@@ -1,178 +1,178 @@
-# 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/config/config_parser'
-
-module Cosmos
-
-  # Target encapsulates the information about a COSMOS target. Targets are
-  # accessed through interfaces and have command and telemetry definition files
-  # which define their access.
-  class Target
-    # @return [String] Name of the target. This can be overridden when
-    #   the system processes the target.
-    attr_reader :name
-
-    # @return [String] Name of the target as defined by the
-    #   target directory name. This name does not change.
-    attr_reader :original_name
-
-    # @return [Boolean] Indicates if substitution should take place or not
-    attr_reader :substitute
-
-    # @return [Array<String>] List of filenames that must be required by Ruby
-    #   before parsing the command and telemetry definitions for this target
-    attr_reader :requires
-
-    # @return [Array<String>] List of parameters that should be ignored. Tools
-    #   which access this target should not display or manipulate these
-    #   parameters.
-    attr_reader :ignored_parameters
-
-    # @return [Array<String>] List of items that should be ignored. Tools
-    #   which access this target should not display or manipulate these
-    #   items.
-    attr_reader :ignored_items
-
-    # @return [Boolean] Whether auto screen substitution is enabled
-    attr_reader :auto_screen_substitute
-
-    # @return [Array<String>] List of configuration files which define the
-    #   commands and telemetry for this target
-    attr_reader :cmd_tlm_files
-
-    # @return [String] Target filename for this target
-    attr_reader :filename
-
-    # @return [String] The directory which contains this target. The directory
-    #   is by default <USERPATH>/config/targets/<original_name>. Once a target
-    #   has been processed it is copied to a saved configuration location and
-    #   the dir will be updated to return this location.
-    attr_reader :dir
-
-    # @return [Interface] The interface used to access the target
-    attr_accessor :interface
-
-    # @return [Integer] The number of command packets send to this target
-    attr_accessor :cmd_cnt
-
-    # @return [Integer] The number of telemetry packets received from this target
-    attr_accessor :tlm_cnt
-
-    # Creates a new target by processing the target.txt file in the directory
-    # given by the path joined with the target_name. Records all the command
-    # and telemetry definition files found in the targets cmd_tlm directory.
-    # System uses this list and processes them using PacketConfig.
-    #
-    # @param target_name [String] The name of the target. This must match the
-    #   directory name which contains the target.
-    # @param substitute_name [String] The name COSMOS should use when refering
-    #   to the target. All accesses will ignore the original target_name.
-    # @param path [String] Path to the target directory. Passing nil sets the
-    #   path to the default of <USERPATH>/config/targets.
-    # @param target_filename [String] Configuration file for the target. Normally
-    #   target.txt
-    def initialize(target_name, substitute_name = nil, path = nil, target_filename = nil)
-      path = File.join(USERPATH,'config','targets') unless path
-      @original_name = target_name.clone.upcase.freeze
-      if substitute_name
-        @substitute = true
-        @name = substitute_name.clone.upcase.freeze
-      else
-        @substitute = false
-        @name = @original_name
-      end
-      @requires = []
-      @ignored_parameters = []
-      @ignored_items = []
-      @auto_screen_substitute = false
-
-      @dir = File.join(path, @original_name)
-      lib_dir = File.join(@dir, 'lib')
-      Cosmos.add_to_search_path(lib_dir, false) if File.exist?(lib_dir)
-
-      @cmd_tlm_files = []
-      @filename = File.join(@dir, target_filename || 'target.txt')
-      if File.exist?(@filename)
-        process_file(@filename)
-      else
-        raise "Target file #{target_filename} for target #{@name} does not exist" if target_filename
-      end
-
-      if @cmd_tlm_files.empty?
-        if Dir.exist?(File.join(@dir, 'cmd_tlm'))
-          Dir.foreach(File.join(@dir, 'cmd_tlm')) do |dir_filename|
-            if dir_filename[0] != '.'
-              @cmd_tlm_files << File.join(@dir, 'cmd_tlm', dir_filename)
-            end
-          end
-        end
-        @cmd_tlm_files.sort!
-      end
-
-      @interface = nil
-      @routers = []
-      @cmd_cnt = 0
-      @tlm_cnt = 0
-    end
-
-    # Parses the target configuration file
-    #
-    # @param filename [String] The target configuration file to parse
-    def process_file(filename)
-      Logger.instance.info "Processing target definition in file '#{filename}'"
-      parser = ConfigParser.new
-      parser.parse_file(filename) do |keyword, parameters|
-        case keyword
-        when 'REQUIRE'
-          usage = "#{keyword} <FILENAME>"
-          parser.verify_num_parameters(1, 1, usage)
-          begin
-            require parameters[0]
-          rescue LoadError => err
-            msg = "Unable to require #{parameters[0]} due to #{err.message}. " +
-              "Ensure #{parameters[0]} is in the COSMOS lib directory."
-            Logger.instance.error msg
-            raise parser.error(msg)
-          end
-          @requires << parameters[0]
-
-        when 'IGNORE_PARAMETER'
-          usage = "#{keyword} <PARAMETER NAME>"
-          parser.verify_num_parameters(1, 1, usage)
-          @ignored_parameters << parameters[0].upcase
-
-        when 'IGNORE_ITEM'
-          usage = "#{keyword} <ITEM NAME>"
-          parser.verify_num_parameters(1, 1, usage)
-          @ignored_items << parameters[0].upcase
-
-        when 'COMMANDS', 'TELEMETRY'
-          usage = "#{keyword} <FILENAME>"
-          parser.verify_num_parameters(1, 1, usage)
-          filename = File.join(@dir, 'cmd_tlm', parameters[0])
-          raise parser.error("#{filename} not found") unless File.exist?(filename)
-          @cmd_tlm_files << filename
-
-        when 'AUTO_SCREEN_SUBSTITUTE'
-          usage = "#{keyword}"
-          parser.verify_num_parameters(0, 0, usage)
-          @auto_screen_substitute = true
-
-        else
-          # blank lines will have a nil keyword and should not raise an exception
-          raise parser.error("Unknown keyword '#{keyword}'") if keyword
-        end # case keyword
-      end
-    end
-
-  end # class Target
-
-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/config/config_parser'
+
+module Cosmos
+
+  # Target encapsulates the information about a COSMOS target. Targets are
+  # accessed through interfaces and have command and telemetry definition files
+  # which define their access.
+  class Target
+    # @return [String] Name of the target. This can be overridden when
+    #   the system processes the target.
+    attr_reader :name
+
+    # @return [String] Name of the target as defined by the
+    #   target directory name. This name does not change.
+    attr_reader :original_name
+
+    # @return [Boolean] Indicates if substitution should take place or not
+    attr_reader :substitute
+
+    # @return [Array<String>] List of filenames that must be required by Ruby
+    #   before parsing the command and telemetry definitions for this target
+    attr_reader :requires
+
+    # @return [Array<String>] List of parameters that should be ignored. Tools
+    #   which access this target should not display or manipulate these
+    #   parameters.
+    attr_reader :ignored_parameters
+
+    # @return [Array<String>] List of items that should be ignored. Tools
+    #   which access this target should not display or manipulate these
+    #   items.
+    attr_reader :ignored_items
+
+    # @return [Boolean] Whether auto screen substitution is enabled
+    attr_reader :auto_screen_substitute
+
+    # @return [Array<String>] List of configuration files which define the
+    #   commands and telemetry for this target
+    attr_reader :cmd_tlm_files
+
+    # @return [String] Target filename for this target
+    attr_reader :filename
+
+    # @return [String] The directory which contains this target. The directory
+    #   is by default <USERPATH>/config/targets/<original_name>. Once a target
+    #   has been processed it is copied to a saved configuration location and
+    #   the dir will be updated to return this location.
+    attr_reader :dir
+
+    # @return [Interface] The interface used to access the target
+    attr_accessor :interface
+
+    # @return [Integer] The number of command packets send to this target
+    attr_accessor :cmd_cnt
+
+    # @return [Integer] The number of telemetry packets received from this target
+    attr_accessor :tlm_cnt
+
+    # Creates a new target by processing the target.txt file in the directory
+    # given by the path joined with the target_name. Records all the command
+    # and telemetry definition files found in the targets cmd_tlm directory.
+    # System uses this list and processes them using PacketConfig.
+    #
+    # @param target_name [String] The name of the target. This must match the
+    #   directory name which contains the target.
+    # @param substitute_name [String] The name COSMOS should use when refering
+    #   to the target. All accesses will ignore the original target_name.
+    # @param path [String] Path to the target directory. Passing nil sets the
+    #   path to the default of <USERPATH>/config/targets.
+    # @param target_filename [String] Configuration file for the target. Normally
+    #   target.txt
+    def initialize(target_name, substitute_name = nil, path = nil, target_filename = nil)
+      path = File.join(USERPATH,'config','targets') unless path
+      @original_name = target_name.clone.upcase.freeze
+      if substitute_name
+        @substitute = true
+        @name = substitute_name.clone.upcase.freeze
+      else
+        @substitute = false
+        @name = @original_name
+      end
+      @requires = []
+      @ignored_parameters = []
+      @ignored_items = []
+      @auto_screen_substitute = false
+
+      @dir = File.join(path, @original_name)
+      lib_dir = File.join(@dir, 'lib')
+      Cosmos.add_to_search_path(lib_dir, false) if File.exist?(lib_dir)
+
+      @cmd_tlm_files = []
+      @filename = File.join(@dir, target_filename || 'target.txt')
+      if File.exist?(@filename)
+        process_file(@filename)
+      else
+        raise "Target file #{target_filename} for target #{@name} does not exist" if target_filename
+      end
+
+      if @cmd_tlm_files.empty?
+        if Dir.exist?(File.join(@dir, 'cmd_tlm'))
+          Dir.foreach(File.join(@dir, 'cmd_tlm')) do |dir_filename|
+            if dir_filename[0] != '.'
+              @cmd_tlm_files << File.join(@dir, 'cmd_tlm', dir_filename)
+            end
+          end
+        end
+        @cmd_tlm_files.sort!
+      end
+
+      @interface = nil
+      @routers = []
+      @cmd_cnt = 0
+      @tlm_cnt = 0
+    end
+
+    # Parses the target configuration file
+    #
+    # @param filename [String] The target configuration file to parse
+    def process_file(filename)
+      Logger.instance.info "Processing target definition in file '#{filename}'"
+      parser = ConfigParser.new
+      parser.parse_file(filename) do |keyword, parameters|
+        case keyword
+        when 'REQUIRE'
+          usage = "#{keyword} <FILENAME>"
+          parser.verify_num_parameters(1, 1, usage)
+          begin
+            require parameters[0]
+          rescue LoadError => err
+            msg = "Unable to require #{parameters[0]} due to #{err.message}. " +
+              "Ensure #{parameters[0]} is in the COSMOS lib directory."
+            Logger.instance.error msg
+            raise parser.error(msg)
+          end
+          @requires << parameters[0]
+
+        when 'IGNORE_PARAMETER'
+          usage = "#{keyword} <PARAMETER NAME>"
+          parser.verify_num_parameters(1, 1, usage)
+          @ignored_parameters << parameters[0].upcase
+
+        when 'IGNORE_ITEM'
+          usage = "#{keyword} <ITEM NAME>"
+          parser.verify_num_parameters(1, 1, usage)
+          @ignored_items << parameters[0].upcase
+
+        when 'COMMANDS', 'TELEMETRY'
+          usage = "#{keyword} <FILENAME>"
+          parser.verify_num_parameters(1, 1, usage)
+          filename = File.join(@dir, 'cmd_tlm', parameters[0])
+          raise parser.error("#{filename} not found") unless File.exist?(filename)
+          @cmd_tlm_files << filename
+
+        when 'AUTO_SCREEN_SUBSTITUTE'
+          usage = "#{keyword}"
+          parser.verify_num_parameters(0, 0, usage)
+          @auto_screen_substitute = true
+
+        else
+          # blank lines will have a nil keyword and should not raise an exception
+          raise parser.error("Unknown keyword '#{keyword}'") if keyword
+        end # case keyword
+      end
+    end
+
+  end # class Target
+
+end # module Cosmos

data/lib/cosmos/tools/cmd_extractor/cmd_extractor.rb

@@ -1,253 +1,254 @@
-# 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/gui/dialogs/packet_log_dialog'
-  require 'cosmos/gui/dialogs/splash'
-  require 'cosmos/gui/dialogs/progress_dialog'
-end
-
-module Cosmos
-
-  # Breaks a binary log of commands into readable text.
-  class CmdExtractor < QtTool
-
-    def initialize(options)
-      # MUST BE FIRST - All code before super is executed twice in RubyQt Based classes
-      super(options)
-
-      # Define instance variables
-      @output_filename = nil
-      @input_filenames = []
-      @log_dir = System.paths['LOGS']
-      @export_dir = @log_dir.clone
-      @packet_log_reader = System.default_packet_log_reader.new
-      @time_start = nil
-      @time_end = nil
-
-      Cosmos.load_cosmos_icon("cmd_extractor.png")
-
-      initialize_actions()
-      initialize_menus()
-      initialize_central_widget()
-      complete_initialize()
-
-      # Bring up slash screen for long duration tasks after creation
-      Splash.execute(self) do |splash|
-        ConfigParser.splash = splash
-        System.commands
-        ConfigParser.splash = nil
-      end
-    end
-
-    def initialize_actions
-      super()
-
-      # Mode Menu Actions
-      @include_raw = Qt::Action.new(tr('Include &Raw Data'), self)
-      @include_raw_keyseq = Qt::KeySequence.new(tr('Ctrl+R'))
-      @include_raw.shortcut = @include_raw_keyseq
-      @include_raw.statusTip = tr('Include raw packet data in the text output')
-      @include_raw.setCheckable(true)
-    end
-
-    def initialize_menus
-      # File Menu
-      @file_menu = menuBar.addMenu(tr('&File'))
-      @file_menu.addAction(@exit_action)
-
-      # Mode Menu
-      @mode_menu = menuBar.addMenu(tr('&Mode'))
-      @mode_menu.addAction(@include_raw)
-
-      # Help Menu
-      @about_string = "Command Extractor extracts commands from a binary command log file into a human readable text file."
-      initialize_help_menu()
-    end
-
-    def initialize_central_widget
-      @central_widget = Qt::Widget.new
-      setCentralWidget(@central_widget)
-      @top_layout = Qt::VBoxLayout.new(@central_widget)
-
-      # Packet Log Frame
-      @packet_log_frame = PacketLogFrame.new(self, @log_dir, System.default_packet_log_reader.new, @input_filenames, @output_filename, true, true, true, Cosmos::CMD_FILE_PATTERN, Cosmos::TXT_FILE_PATTERN)
-      @packet_log_frame.change_callback = method(:change_callback)
-      @top_layout.addWidget(@packet_log_frame)
-
-      # Separator before buttons
-      @sep2 = Qt::Frame.new(@central_widget)
-      @sep2.setFrameStyle(Qt::Frame::HLine | Qt::Frame::Sunken)
-      @top_layout.addWidget(@sep2)
-
-      # Process and Open Buttons
-      @button_layout = Qt::HBoxLayout.new
-      @process_button = Qt::PushButton.new('&Process Files')
-      @process_button.connect(SIGNAL('clicked()')) { process_log_files() }
-      @button_layout.addWidget(@process_button)
-
-      @open_button = Qt::PushButton.new('&Open in Text Editor')
-      @open_button.connect(SIGNAL('clicked()')) { open_button() }
-      @open_button.setEnabled(false)
-      @button_layout.addWidget(@open_button)
-      @top_layout.addLayout(@button_layout)
-    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.width = 700
-          options.height = 425
-          options.title = "Command Extractor"
-        end
-
-        super(option_parser, options)
-      end
-    end
-
-    protected
-
-    ###############################################################################
-    # File Menu Handlers
-    ###############################################################################
-
-    def process_log_files
-      @cancel = false
-      begin
-        @packet_log_reader = @packet_log_frame.packet_log_reader
-        @input_filenames = @packet_log_frame.filenames.sort
-        @time_start = @packet_log_frame.time_start
-        @time_end = @packet_log_frame.time_end
-        @output_filename = @packet_log_frame.output_filename
-        include_raw = @include_raw.isChecked
-        return unless pre_process_tests()
-
-        ProgressDialog.execute(self, # parent
-                               'Log File Progress', # title
-                               600, # width, height
-                               300) do |progress_dialog|
-          progress_dialog.cancel_callback = method(:cancel_callback)
-          progress_dialog.enable_cancel_button
-
-          begin
-            Cosmos.set_working_dir do
-              File.open(@output_filename, 'w') do |output_file|
-                process_files(output_file, include_raw, progress_dialog)
-              end
-            end
-          ensure
-            progress_dialog.complete
-            Qt.execute_in_main_thread(true) do
-              @open_button.setEnabled(true)
-            end
-          end
-        end
-      rescue => error
-        Qt::MessageBox.critical(self, 'Error!', "Error Processing Log File(s)\n#{error.formatted}")
-      end
-    end # def process_log_files
-
-    def open_button
-      Cosmos.open_in_text_editor(@output_filename)
-    end
-
-    ###############################################################################
-    # Helper Methods
-    ###############################################################################
-
-    def process_files(output_file, include_raw, progress_dialog)
-      log_file_count = 1
-      @input_filenames.each do |log_file|
-        begin
-          file_size = File.size(log_file).to_f
-          progress_dialog.append_text("Processing File #{log_file_count}/#{@input_filenames.length}: #{log_file}")
-          progress_dialog.set_step_progress(0.0)
-          output_file.puts '-' * (log_file.length * 1.4).to_i
-          output_file.puts log_file
-          output_file.puts '-' * (log_file.length * 1.4).to_i
-          output_file.puts
-          @packet_log_reader.each(
-            log_file, # log filename
-            true,     # identify and define packet
-            @time_start,
-            @time_end) do |packet|
-
-            break if @cancel
-            progress_dialog.set_step_progress(@packet_log_reader.bytes_read / file_size)
-            if packet.received_time
-              output_file.puts "#{packet.target_name} #{packet.packet_name}"
-              output_file.puts "  RECEIVED_TIMEFORMATTED: #{packet.received_time.formatted}"
-            end
-            output_file.puts packet.formatted(:WITH_UNITS, 2)
-            if include_raw or !packet.identified? or !packet.defined?
-              output_file.puts "  RAW PACKET DATA (#{packet.length} bytes):"
-              output_file.puts packet.buffer.formatted(1, 16, ' ', 4)
-            end
-            output_file.puts
-          end
-          progress_dialog.set_step_progress(1.0) if !@cancel
-          progress_dialog.set_overall_progress(log_file_count.to_f / @input_filenames.length.to_f) if !@cancel
-        rescue Exception => error
-          progress_dialog.append_text("Error processing: #{error.formatted}\n")
-        end
-        log_file_count += 1
-      end
-    end
-
-    ###############################################################################
-    # Helper Methods
-    ###############################################################################
-
-    def pre_process_tests
-      unless @input_filenames and @input_filenames[0]
-        Qt::MessageBox.critical(self, 'Error', 'Please select at least 1 input file')
-        return false
-      end
-
-      unless @output_filename
-        Qt::MessageBox.critical(self, 'Error', 'No Output File Selected')
-        return false
-      end
-
-      if File.exist?(@output_filename)
-        result = Qt::MessageBox.warning(self, 'Warning!', 'Output File Already Exists. Overwrite?', Qt::MessageBox::Yes | Qt::MessageBox::No)
-        return false if result == Qt::MessageBox::No
-      end
-
-      true
-    end
-
-    ###############################################################################
-    # Additional Callbacks
-    ###############################################################################
-
-    def cancel_callback(progress_dialog = nil)
-      @cancel = true
-      return true, false
-    end
-
-    def change_callback(item_changed)
-      if item_changed == :INPUT_FILES
-        filename = @packet_log_frame.filenames[0]
-        if filename
-          extension = File.extname(filename)
-          filename_no_extension = filename[0..-(extension.length + 1)]
-          filename = filename_no_extension << '.txt'
-          @packet_log_frame.output_filename = filename
-        end
-      end
-    end
-
-  end # class CmdExtractor
-
-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'
+Cosmos.catch_fatal_exception do
+  require 'cosmos/gui/qt_tool'
+  require 'cosmos/gui/dialogs/packet_log_dialog'
+  require 'cosmos/gui/dialogs/splash'
+  require 'cosmos/gui/dialogs/progress_dialog'
+end
+
+module Cosmos
+
+  # Breaks a binary log of commands into readable text.
+  class CmdExtractor < QtTool
+
+    def initialize(options)
+      # MUST BE FIRST - All code before super is executed twice in RubyQt Based classes
+      super(options)
+
+      # Define instance variables
+      @output_filename = nil
+      @input_filenames = []
+      @log_dir = System.paths['LOGS']
+      @export_dir = @log_dir.clone
+      @packet_log_reader = System.default_packet_log_reader.new
+      @time_start = nil
+      @time_end = nil
+
+      Cosmos.load_cosmos_icon("cmd_extractor.png")
+
+      initialize_actions()
+      initialize_menus()
+      initialize_central_widget()
+      complete_initialize()
+
+      # Bring up slash screen for long duration tasks after creation
+      Splash.execute(self) do |splash|
+        ConfigParser.splash = splash
+        System.commands
+        ConfigParser.splash = nil
+      end
+    end
+
+    def initialize_actions
+      super()
+
+      # Mode Menu Actions
+      @include_raw = Qt::Action.new(tr('Include &Raw Data'), self)
+      @include_raw_keyseq = Qt::KeySequence.new(tr('Ctrl+R'))
+      @include_raw.shortcut = @include_raw_keyseq
+      @include_raw.statusTip = tr('Include raw packet data in the text output')
+      @include_raw.setCheckable(true)
+    end
+
+    def initialize_menus
+      # File Menu
+      @file_menu = menuBar.addMenu(tr('&File'))
+      @file_menu.addAction(@exit_action)
+
+      # Mode Menu
+      @mode_menu = menuBar.addMenu(tr('&Mode'))
+      @mode_menu.addAction(@include_raw)
+
+      # Help Menu
+      @about_string = "Command Extractor extracts commands from a binary command log file into a human readable text file."
+      initialize_help_menu()
+    end
+
+    def initialize_central_widget
+      @central_widget = Qt::Widget.new
+      setCentralWidget(@central_widget)
+      @top_layout = Qt::VBoxLayout.new(@central_widget)
+
+      # Packet Log Frame
+      @packet_log_frame = PacketLogFrame.new(self, @log_dir, System.default_packet_log_reader.new, @input_filenames, @output_filename, true, true, true, Cosmos::CMD_FILE_PATTERN, Cosmos::TXT_FILE_PATTERN)
+      @packet_log_frame.change_callback = method(:change_callback)
+      @top_layout.addWidget(@packet_log_frame)
+
+      # Separator before buttons
+      @sep2 = Qt::Frame.new(@central_widget)
+      @sep2.setFrameStyle(Qt::Frame::HLine | Qt::Frame::Sunken)
+      @top_layout.addWidget(@sep2)
+
+      # Process and Open Buttons
+      @button_layout = Qt::HBoxLayout.new
+      @process_button = Qt::PushButton.new('&Process Files')
+      @process_button.connect(SIGNAL('clicked()')) { process_log_files() }
+      @button_layout.addWidget(@process_button)
+
+      @open_button = Qt::PushButton.new('&Open in Text Editor')
+      @open_button.connect(SIGNAL('clicked()')) { open_button() }
+      @open_button.setEnabled(false)
+      @button_layout.addWidget(@open_button)
+      @top_layout.addLayout(@button_layout)
+    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.width = 700
+          options.height = 425
+          options.title = "Command Extractor"
+        end
+
+        super(option_parser, options)
+      end
+    end
+
+    protected
+
+    ###############################################################################
+    # File Menu Handlers
+    ###############################################################################
+
+    def process_log_files
+      @cancel = false
+      begin
+        @packet_log_reader = @packet_log_frame.packet_log_reader
+        @input_filenames = @packet_log_frame.filenames.sort
+        @time_start = @packet_log_frame.time_start
+        @time_end = @packet_log_frame.time_end
+        @output_filename = @packet_log_frame.output_filename
+        include_raw = @include_raw.isChecked
+        return unless pre_process_tests()
+
+        ProgressDialog.execute(self, # parent
+                               'Log File Progress', # title
+                               600, # width, height
+                               300) do |progress_dialog|
+          progress_dialog.cancel_callback = method(:cancel_callback)
+          progress_dialog.enable_cancel_button
+
+          begin
+            Cosmos.set_working_dir do
+              File.open(@output_filename, 'w') do |output_file|
+                process_files(output_file, include_raw, progress_dialog)
+              end
+            end
+          ensure
+            progress_dialog.complete
+            Qt.execute_in_main_thread(true) do
+              @open_button.setEnabled(true)
+            end
+          end
+        end
+      rescue => error
+        Qt::MessageBox.critical(self, 'Error!', "Error Processing Log File(s)\n#{error.formatted}")
+      end
+    end # def process_log_files
+
+    def open_button
+      Cosmos.open_in_text_editor(@output_filename)
+    end
+
+    ###############################################################################
+    # Helper Methods
+    ###############################################################################
+
+    def process_files(output_file, include_raw, progress_dialog)
+      log_file_count = 1
+      @input_filenames.each do |log_file|
+        break if @cancel
+        begin
+          file_size = File.size(log_file).to_f
+          progress_dialog.append_text("Processing File #{log_file_count}/#{@input_filenames.length}: #{log_file}")
+          progress_dialog.set_step_progress(0.0)
+          output_file.puts '-' * (log_file.length * 1.4).to_i
+          output_file.puts log_file
+          output_file.puts '-' * (log_file.length * 1.4).to_i
+          output_file.puts
+          @packet_log_reader.each(
+            log_file, # log filename
+            true,     # identify and define packet
+            @time_start,
+            @time_end) do |packet|
+
+            break if @cancel
+            progress_dialog.set_step_progress(@packet_log_reader.bytes_read / file_size)
+            if packet.received_time
+              output_file.puts "#{packet.target_name} #{packet.packet_name}"
+              output_file.puts "  RECEIVED_TIMEFORMATTED: #{packet.received_time.formatted}"
+            end
+            output_file.puts packet.formatted(:WITH_UNITS, 2)
+            if include_raw or !packet.identified? or !packet.defined?
+              output_file.puts "  RAW PACKET DATA (#{packet.length} bytes):"
+              output_file.puts packet.buffer.formatted(1, 16, ' ', 4)
+            end
+            output_file.puts
+          end
+          progress_dialog.set_step_progress(1.0) if !@cancel
+          progress_dialog.set_overall_progress(log_file_count.to_f / @input_filenames.length.to_f) if !@cancel
+        rescue Exception => error
+          progress_dialog.append_text("Error processing: #{error.formatted}\n")
+        end
+        log_file_count += 1
+      end
+    end
+
+    ###############################################################################
+    # Helper Methods
+    ###############################################################################
+
+    def pre_process_tests
+      unless @input_filenames and @input_filenames[0]
+        Qt::MessageBox.critical(self, 'Error', 'Please select at least 1 input file')
+        return false
+      end
+
+      unless @output_filename
+        Qt::MessageBox.critical(self, 'Error', 'No Output File Selected')
+        return false
+      end
+
+      if File.exist?(@output_filename)
+        result = Qt::MessageBox.warning(self, 'Warning!', 'Output File Already Exists. Overwrite?', Qt::MessageBox::Yes | Qt::MessageBox::No)
+        return false if result == Qt::MessageBox::No
+      end
+
+      true
+    end
+
+    ###############################################################################
+    # Additional Callbacks
+    ###############################################################################
+
+    def cancel_callback(progress_dialog = nil)
+      @cancel = true
+      return true, false
+    end
+
+    def change_callback(item_changed)
+      if item_changed == :INPUT_FILES
+        filename = @packet_log_frame.filenames[0]
+        if filename
+          extension = File.extname(filename)
+          filename_no_extension = filename[0..-(extension.length + 1)]
+          filename = filename_no_extension << '.txt'
+          @packet_log_frame.output_filename = filename
+        end
+      end
+    end
+
+  end # class CmdExtractor
+
+end # module Cosmos