adams-visiona 1.0.0

data/lib/cosmos/gui/dialogs/cmd_details_dialog.rb

@@ -0,0 +1,51 @@
+# 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
+
+# This file contains the implementation and TlmDetailsDialog class.   This class
+# is used to view a telemetry items settings typically on a right click.
+
+require 'cosmos'
+require 'cosmos/gui/dialogs/details_dialog'
+
+module Cosmos
+  # Creates a dialog which shows the details of the given command.
+  class CmdDetailsDialog < DetailsDialog
+    # (see DetailsDialog#initialize)
+    def initialize(parent, target_name, packet_name, item_name)
+      super(parent, target_name, packet_name, item_name)
+
+      begin
+        packet = System.commands.packet(target_name, packet_name)
+        item = packet.get_item(item_name)
+
+        setWindowTitle("#{@target_name} #{@packet_name} #{@item_name} Details")
+
+        layout = Qt::VBoxLayout.new
+        layout.addWidget(Qt::Label.new("#{target_name} #{packet_name} #{item_name}"))
+
+        # Display the parameter details
+        item_details = Qt::GroupBox.new("Parameter Details")
+        item_details.setLayout(build_details_layout(item, :CMD))
+        layout.addWidget(item_details)
+
+        # Add the OK button
+        ok = Qt::PushButton.new("Ok")
+        connect(ok, SIGNAL('clicked()'), self, SLOT('accept()'))
+        layout.addWidget(ok)
+
+        self.setLayout(layout)
+        self.show
+        self.raise
+      rescue DRb::DRbConnError
+        # Just do nothing
+      end
+    end
+  end
+end

data/lib/cosmos/gui/dialogs/cmd_tlm_raw_dialog.rb

@@ -0,0 +1,167 @@
+# 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
+
+# This file contains the implementation of the TlmRawDialog class.   This class
+# is used to view a raw telemetry packet.
+
+require 'cosmos'
+require 'cosmos/gui/qt'
+
+module Cosmos
+  # Creates a dialog showing a packet formatted as a binary hex dump
+  class RawDialog < Qt::Dialog
+    slots 'packet_update_timeout()'
+
+    # Constant to indicate a command packet dump
+    CMD_TYPE = 'cmd'
+    # Constant to indicate a telemetry packet dump
+    TLM_TYPE = 'tlm'
+    # Dialog update period
+    PACKET_UPDATE_PERIOD_MS = 1000
+    # Header string to display over the dump
+    HEADER = "Address   Data                                             Ascii\n"\
+             "---------------------------------------------------------------------------\n"
+
+    # @return [Qt::Font] Font to display the dialog dump (should be monospaced)
+    @@font = nil
+
+    # @param parent [Qt::Dialog] Parent for the dialog
+    # @param type [String] Dialog type which must be 'cmd' or 'tlm'
+    # @param target_name [String] Name of the target
+    # @param packet_name [String] Name of the packet
+    def initialize(parent, type, target_name, packet_name)
+      super(parent, Qt::WindowTitleHint | Qt::WindowSystemMenuHint)
+      raise "RawDialog: Undefined type:#{type}" if (type != CMD_TYPE) && (type != TLM_TYPE)
+
+      @type = type
+      @done = false
+      @target_name = target_name
+      @packet_name = packet_name
+
+      begin
+        if @type == CMD_TYPE
+          title = "Raw Command Packet: #{target_name} #{packet_name}"
+        else
+          title = "Raw Telemetry Packet: #{target_name} #{packet_name}"
+        end
+        setWindowTitle(title)
+
+        @timer = Qt::Timer.new
+
+        overall_layout = Qt::VBoxLayout.new
+        top_layout = Qt::HBoxLayout.new
+        text_layout = Qt::VBoxLayout.new
+
+        title_label = Qt::Label.new(title)
+        text_layout.addWidget(title_label)
+        @packet_time = Qt::Label.new("Packet Time: ")
+        text_layout.addWidget(@packet_time)
+        @received_time = Qt::Label.new("Received Time: ")
+        text_layout.addWidget(@received_time)
+        top_layout.addLayout(text_layout)
+        top_layout.addStretch(1)
+
+        button = Qt::PushButton.new("Pause")
+        top_layout.addWidget(button)
+        button.connect(SIGNAL('clicked()')) do
+          if button.text == "Pause"
+            button.setText("Resume")
+            @timer.method_missing(:stop)
+          else
+            button.setText("Pause")
+            @timer.method_missing(:start, PACKET_UPDATE_PERIOD_MS)
+          end
+        end
+        overall_layout.addLayout(top_layout)
+
+        @packet_data = Qt::PlainTextEdit.new
+        @packet_data.setReadOnly(true)
+        @packet_data.setWordWrapMode(Qt::TextOption::NoWrap)
+        overall_layout.addWidget(@packet_data)
+        if Kernel.is_windows?
+          @@font = Cosmos.getFont('Courier', 10) unless @@font
+        else
+          @@font = Cosmos.getFont('Courier', 14) unless @@font
+        end
+        @format = @packet_data.currentCharFormat()
+        @format.setFont(@@font)
+        @packet_data.setCurrentCharFormat(@format)
+
+        connect(@timer, SIGNAL('timeout()'), self, SLOT('packet_update_timeout()'))
+        @timer.method_missing(:start, PACKET_UPDATE_PERIOD_MS)
+        packet_update_timeout()
+
+        self.setLayout(overall_layout)
+        self.resize(700, 280)
+        self.show
+        self.raise
+      rescue DRb::DRbConnError
+        # Just do nothing
+      end
+    end
+
+    # Callback to get the latest packet and update the dialog
+    def packet_update_timeout
+      if (@type == CMD_TYPE)
+        packet = System.commands.packet(@target_name, @packet_name)
+      else
+        packet = System.telemetry.packet(@target_name, @packet_name)
+      end
+      packet_data = packet.buffer
+      packet_time = packet.packet_time
+      @packet_time.setText("Packet Time: #{packet_time.formatted}") if packet_time
+      received_time = packet.received_time
+      @received_time.setText("Received Time: #{received_time.formatted}") if received_time
+      position_x = @packet_data.horizontalScrollBar.value
+      position_y = @packet_data.verticalScrollBar.value
+      @packet_data.setPlainText(HEADER + packet_data.formatted)
+      @packet_data.horizontalScrollBar.setValue(position_x)
+      @packet_data.verticalScrollBar.setValue(position_y)
+    end
+
+    def reject
+      super()
+      stop_timer if @timer
+      self.dispose
+    end
+
+    def closeEvent(event)
+      super(event)
+      stop_timer if @timer
+      self.dispose
+    end
+
+    def stop_timer
+      @timer.stop
+      @timer.dispose
+      @timer = nil
+    end
+  end
+
+  # Creates a dialog which displays a command packet as a hex dump
+  class CmdRawDialog < RawDialog
+    # @param parent (see RawDialog#initialize)
+    # @param target_name (see RawDialog#initialize)
+    # @param packet_name (see RawDialog#initialize)
+    def initialize(parent, target_name, packet_name)
+      super(parent, RawDialog::CMD_TYPE, target_name, packet_name)
+    end
+  end
+
+  # Creates a dialog which displays a telemetry packet as a hex dump
+  class TlmRawDialog < RawDialog
+    # @param parent (see RawDialog#initialize)
+    # @param target_name (see RawDialog#initialize)
+    # @param packet_name (see RawDialog#initialize)
+    def initialize(parent, target_name, packet_name)
+      super(parent, RawDialog::TLM_TYPE, target_name, packet_name)
+    end
+  end
+end

data/lib/cosmos/gui/dialogs/dart_dialog.rb

@@ -0,0 +1,60 @@
+# encoding: ascii-8bit
+
+# Copyright 2018 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
+
+# This file contains the implementation of the StreamPacketsDialog class.   This class
+# provides a dialog box to configure packet streaming from DART
+
+require 'cosmos'
+require 'cosmos/gui/qt'
+require 'cosmos/gui/widgets/dart_frame'
+
+module Cosmos
+  # Creates a dialog to allow a user to select the
+  # time period to process.
+  class DartDialog < Qt::Dialog
+    extend Forwardable
+    def_delegators :@stream_packets_frame, :time_start, :time_start=, :time_end, :time_end=, :meta_filters
+
+    # @param parent (see PacketLogFrame#initialize)
+    # @param title [String] Dialog title
+    # @param show_time (see PacketLogFrame#initialize)
+    def initialize(parent, title, show_time = true)
+      super(parent)
+      setWindowTitle(title)
+
+      @layout = Qt::VBoxLayout.new
+      @stream_packets_frame = DartFrame.new(self, show_time)
+      @stream_packets_frame.change_callback = method(:change_callback)
+      @layout.addWidget(@stream_packets_frame)
+
+      # Separator before buttons
+      @sep1 = Qt::Frame.new(self)
+      @sep1.setFrameStyle(Qt::Frame::HLine | Qt::Frame::Sunken)
+      @layout.addWidget(@sep1)
+
+      # Create OK and Cancel buttons
+      @button_layout = Qt::HBoxLayout.new
+      @ok_button = Qt::PushButton.new('OK')
+      @ok_button.connect(SIGNAL('clicked()')) { System.telemetry.reset; self.accept }
+      @button_layout.addWidget(@ok_button)
+      @cancel_button = Qt::PushButton.new('Cancel')
+      @cancel_button.connect(SIGNAL('clicked()')) { self.reject }
+      @button_layout.addWidget(@cancel_button)
+
+      @layout.addLayout(@button_layout)
+      setLayout(@layout)
+    end
+
+    protected
+
+    def change_callback(item_changed)
+    end
+  end
+end

data/lib/cosmos/gui/dialogs/details_dialog.rb

@@ -0,0 +1,205 @@
+# 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/gui/qt'
+require 'cosmos/script'
+
+module Cosmos
+  # Creates a dialog showing the details about a given command or telemetry
+  # item. This class is a base class and should not be instantiated. Use
+  # CmdDetailsDialog or TlmDetailsDialog.
+  class DetailsDialog < Qt::Dialog
+    # @return [Array<DetailsDialog>] Instances of the details dialog
+    @@instances = []
+
+    # @param parent [Qt::Dialog] Parent for the dialog
+    # @param target_name [String] Name of the target
+    # @param packet_name [String] Name of the packet
+    # @param item_name [String] Name of the item
+    def initialize(parent, target_name, packet_name, item_name)
+      super(parent, Qt::WindowTitleHint | Qt::WindowSystemMenuHint)
+
+      @target_name = target_name
+      @packet_name = packet_name
+      @item_name = item_name
+      @limits_layout = nil
+      @limits_labels = {}
+
+      @@instances << self
+    end
+
+    def update_limits_checking
+      return unless @limits_checking_enabled_label
+      begin
+        limits_enabled = limits_enabled?(@target_name, @packet_name, @item_name)
+      rescue RuntimeError
+        # Error most likely due to LATEST packet - Ignore
+        limits_enabled = nil
+      end
+      # Check for nil because true and false are both valid values
+      unless limits_enabled.nil?
+        @limits_checking_enabled_label.setText("#{show_nil(limits_enabled)}")
+      end
+    end
+
+    protected
+
+    # Creates and populates the layout for the dialog
+    def build_details_layout(item, cmd_tlm)
+      details_layout = Qt::FormLayout.new
+      details_layout.addRow("Bit Offset:", Qt::Label.new("#{show_nil(item.bit_offset)}"))
+      details_layout.addRow("Bit Size:", Qt::Label.new("#{show_nil(item.bit_size)}"))
+      details_layout.addRow("Data Type:", Qt::Label.new("#{show_data_type(item.data_type)}"))
+      details_layout.addRow("Array Size:", Qt::Label.new("#{show_nil(item.array_size)}"))
+      if cmd_tlm == :CMD
+        if item.range
+          details_layout.addRow("Minimum:", Qt::Label.new(item.range.first.to_s))
+          details_layout.addRow("Maximum:", Qt::Label.new(item.range.last.to_s))
+        end
+        details_layout.addRow("Default:", Qt::Label.new("#{show_nil(item.default)}")) if item.default
+      end
+      details_layout.addRow("Format String:", Qt::Label.new("#{show_nil(item.format_string)}"))
+      details_layout.addRow("Read_Conversion:", Qt::Label.new("#{show_conversion(item.read_conversion)}"))
+      details_layout.addRow("Write_Conversion:", Qt::Label.new("#{show_conversion(item.write_conversion)}"))
+      details_layout.addRow("Id Value:", Qt::Label.new("#{show_nil(item.id_value)}"))
+      details_layout.addRow("Description:", Qt::Label.new("#{show_nil(item.description)}"))
+      details_layout.addRow("Units Full:", Qt::Label.new("#{show_nil(item.units_full)}"))
+      details_layout.addRow("Units Abbreviation:", Qt::Label.new("#{show_nil(item.units)}"))
+      details_layout.addRow("Endianness:", Qt::Label.new("#{show_endianness(item.endianness)}"))
+      if item.states
+        details_layout.addRow(build_states_details(item))
+      else
+        details_layout.addRow("States:", Qt::Label.new("None"))
+      end
+      if cmd_tlm == :CMD
+        details_layout.addRow("Required:", Qt::Label.new(item.required.to_s))
+      else
+        limits = item.limits.values
+        if limits
+          details_layout.addRow(build_limits_details(limits))
+        else
+          details_layout.addRow("Limits:", Qt::Label.new("None"))
+        end
+        if limits || item.state_colors
+          @limits_checking_enabled_label = Qt::Label.new("#{show_nil(item.limits.enabled)}")
+          details_layout.addRow("Limits Checking Enabled:", @limits_checking_enabled_label)
+        end
+        if limits
+          details_layout.addRow("Limits Persistence Setting:", Qt::Label.new("#{show_nil(item.limits.persistence_setting)}"))
+          details_layout.addRow("Limits Persistence Count:", Qt::Label.new("#{show_nil(item.limits.persistence_count)}"))
+        end
+        if item.meta.empty?
+          details_layout.addRow("Meta:", Qt::Label.new("None"))
+        else
+          item.meta.each do |key, value|
+            details_layout.addRow("Meta[#{key}]:", Qt::Label.new(value.to_s))
+          end
+        end
+      end
+      details_layout
+    end
+
+    # Create the states details layout
+    def build_states_details(item)
+      states_details = Qt::GroupBox.new("States")
+      scroll_layout = Qt::VBoxLayout.new
+      states_details.setLayout(scroll_layout)
+      scroll_area = Qt::ScrollArea.new
+      scroll_area.setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOff)
+      scroll_layout.addWidget(scroll_area)
+      scroll_widget = Qt::Widget.new
+      scroll_area.setWidget(scroll_widget)
+      states_layout = Qt::FormLayout.new
+      scroll_widget.setLayout(states_layout)
+      item.states.sort {|a, b| a[1].to_i <=> b[1].to_i }.each do |state_name, state_value|
+        if item.state_colors
+          states_layout.addRow("#{state_name}:", Qt::Label.new("#{state_value} #{item.state_colors[state_name]}"))
+        else
+          states_layout.addRow("#{state_name}:", Qt::Label.new("#{state_value}"))
+        end
+      end
+      # Figure out the how big the states layout wants to be and set the
+      # scroll area to this height if possible. Otherwise limit it to 200px.
+      if states_layout.minimumSize.height > 200
+        scroll_area.setMinimumHeight(200)
+      else
+        scroll_area.setMinimumHeight(states_layout.minimumSize.height + 5)
+      end
+      scroll_widget.adjustSize
+      states_details
+    end
+
+    # Create the limits details layout
+    def build_limits_details(limits)
+      limits_details = Qt::GroupBox.new("Limits")
+      @limits_layout = Qt::FormLayout.new
+      limits.each do |limits_set_name, limits_settings|
+        if limits_settings[4] && limits_settings[5]
+          label = Qt::Label.new("RL/#{limits_settings[0]} YL/#{limits_settings[1]} YH/#{limits_settings[2]} RH/#{limits_settings[3]} GL/#{limits_settings[4]} GH/#{limits_settings[5]}")
+        else
+          label = Qt::Label.new("RL/#{limits_settings[0]} YL/#{limits_settings[1]} YH/#{limits_settings[2]} RH/#{limits_settings[3]}")
+        end
+        @limits_labels[limits_set_name] = label
+        @limits_layout.addRow("#{limits_set_name}:", label)
+      end
+      limits_details.setLayout(@limits_layout)
+      limits_details
+    end
+
+    def show_nil(object, show_as = 'nil')
+      if object.nil?
+        return show_as
+      else
+        return object
+      end
+    end
+
+    def show_data_type(data_type)
+      case data_type
+      when nil
+        return 'nil'
+      when :INT, :UINT, :FLOAT, :STRING, :BLOCK, :DERIVED
+        return data_type.to_s
+      else
+        return "INVALID (#{data_type})"
+      end
+    end
+
+    def show_endianness(endianness)
+      case endianness
+      when :BIG_ENDIAN
+        return 'BIG_ENDIAN'
+      else
+        return 'LITTLE_ENDIAN'
+      end
+    end
+
+    def show_conversion(object)
+      if object.nil?
+        return 'nil'
+      else
+        return object.to_s
+      end
+    end
+
+    def reject
+      super()
+      @@instances.delete(self)
+      self.dispose
+    end
+
+    def closeEvent(event)
+      super(event)
+      @@instances.delete(self)
+      self.dispose
+    end
+  end
+end

data/lib/cosmos/gui/dialogs/exception_dialog.rb

@@ -0,0 +1,121 @@
+# 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
+
+# This file contains the implementation of the ExceptionDialog class.   This class
+# is used to display an exception window
+
+require 'cosmos'
+require 'cosmos/gui/qt'
+
+module Cosmos
+  # Creates a dialog to display a COSMOS exception to the user. The dialog can
+  # close the application and log the exception. This is the primary dialog to
+  # display when something goes unexpectedly wrong.
+  class ExceptionDialog
+    # @return [Mutex] Mutex to make this dialog single threaded
+    @@mutex = Mutex.new
+
+    # @param parent [Qt::Dialog] Parent of this dialog
+    # @param exception [Exception] Ruby Exception to display details about
+    # @param title [String] Title of the dialog
+    # @param exit_afterwards [Boolean] Whether to completely exit the
+    #   application after displaying the dialog. Useful for fatal exceptions.
+    # @param log_exception [Boolean] Whether to create an exception log file
+    # @param log_file [String] Name of the log file to create
+    def initialize(parent, exception, title = 'COSMOS Exception', exit_afterwards = true, log_exception = true, log_file = nil)
+      return unless @@mutex.try_lock
+
+      unless exception.class == SystemExit || exception.class == Interrupt
+        # ConfigParser::Errors are configuration user errors. We don't want to clutter
+        # up list of real exceptions with user configuration errors.
+        # Same goes for FatalErrors
+        unless exception.class == ConfigParser::Error || exception.class == FatalError
+          log_file = Cosmos.write_exception_file(exception) if log_exception
+        end
+
+        if Qt::CoreApplication.instance
+          msg = Qt::MessageBox.new(parent)
+          msg.setWindowTitle(title)
+          msg.setTextFormat(Qt::RichText)
+          msg.setIcon(Qt::MessageBox::Critical)
+          case exception
+          # ConfigParser::Errors are a special case generated with a known format
+          # by the ConfigParser
+          when ConfigParser::Error
+            # Substitute the html tags '<' and '>' and then replace newlines with html breaks
+            if exception.usage && !exception.usage.empty?
+              usage = "Usage: #{exception.usage.gsub("<", "&#060;").gsub(">", "&#062;").gsub("\n", "<br/>")}<br/><br/>"
+            else
+              usage = ''
+            end
+            if exception.message && !exception.message.empty?
+              message = exception.message.gsub("<", "&#060;").gsub(">", "&#062;").gsub("\n", "<br/>")
+            else
+              message = ''
+            end
+            if exception.keyword && exception.parameters
+              line = exception.keyword + ' ' + exception.parameters.join(' ').gsub("<", "&#060;").gsub(">", "&#062;").gsub("\n", "<br/>") + "<br/><br/>"
+            else
+              line = ''
+            end
+            text = "#{line}#{usage}#{message}"
+            if exception.filename && exception.line_number
+              text = "Error at #{exception.filename}:#{exception.line_number}<br/><br/>#{text}"
+            end
+            if exception.url && !exception.url.empty?
+              text << "<br/><br/>For more information see <a href='#{exception.url}'>#{exception.url}</a>."
+            end
+          # FatalErrors are errors explicitly raised when a known fatal issue
+          # occurs. Since it is a known issue we don't put up the full error
+          # dialog.
+          when FatalError
+            text = "Error: #{exception.message.gsub("\n", "<br/>")}"
+          else
+            file_contents = ""
+            # First read the log_file we wrote out to the logs directory
+            # Change newlines to %0A for Outlook and remove all quotes to avoid breaking the link
+            begin
+              message = exception.message.gsub("\n", "<br/>")
+              file_contents = File.read(log_file).gsub("\n", "%0A").gsub("'", "").gsub("\"", "") if log_file
+            rescue
+            end
+            text = "The following error occurred:<br/>#{message}"
+            text << "<br/><br/>Please contact your local COSMOS expert.<br/><br/>This error has been logged:<br/>#{log_file}<br/><br/> <a href='mailto:rmelton@ball.com;jmthomas@ball.com?subject=COSMOS exception&body=#{file_contents}'>Click here</a> to email this log to the COSMOS developers." if log_file
+          end
+          text << "<br/><br/>NOTE!: The application will exit once you accept or dismiss this dialog!" if exit_afterwards
+          msg.setText(text)
+          if log_file
+            open_button = Qt::PushButton.new("Open Exception Log in Text Editor")
+            open_button.connect(SIGNAL('clicked()')) do
+              Cosmos.open_in_text_editor(log_file)
+              sleep(2)
+            end
+            msg.addButton(open_button, Qt::MessageBox::ResetRole)
+          end
+          close_button = Qt::PushButton.new("Close")
+          msg.addButton(close_button, Qt::MessageBox::ActionRole)
+          msg.raise
+          msg.exec
+          msg.dispose
+        end # if Qt::CoreApplication.instance
+      end #  unless exception.class == SystemExit or exception.class == Interrupt
+      @@mutex.unlock
+      if exit_afterwards
+        Qt::CoreApplication.instance.exit(1) if Qt::CoreApplication.instance
+        exit 1 # incase CoreApplication doesn't exit yet or didn't complete the exit
+      end
+    end # def initialize
+
+    # @return [Boolean] Whether this dialog has already been instantiated
+    def self.dialog_open?
+      @@mutex.locked?
+    end
+  end
+end

data/lib/cosmos/gui/dialogs/exception_list_dialog.rb

@@ -0,0 +1,60 @@
+# 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
+
+# This file contains the implementation of the ExceptionListDialog class.   This class
+# provides a dialog box to show a list of exceptions.
+
+require 'cosmos'
+require 'cosmos/gui/qt'
+require 'cosmos/gui/dialogs/exception_dialog'
+
+module Cosmos
+  # Displays a list of exceptions in a dialog box. Clicking on any of the
+  # exceptions creates a new ExceptionDialog which shows the details.
+  class ExceptionListDialog < Qt::Dialog
+    # @param message [String] Text to display in the dialog
+    # @param exception_list [Array<Exception>] Array of exceptions to display
+    # @param title [String] Dialog title
+    # @param parent [Qt::Widget] Parent for this dialog
+    def initialize(message, exception_list, title = 'COSMOS Exception List', parent = Qt::CoreApplication.instance.activeWindow)
+      super(parent)
+      self.window_title = title
+      layout = Qt::VBoxLayout.new
+      self.layout = layout
+
+      @exception_list = exception_list
+
+      layout.addWidget(Qt::Label.new(message))
+
+      @list = Qt::ListWidget.new
+      @exception_list.each_with_index do |exception, index|
+        string = "#{index + 1}. #{exception.class} : #{exception.message}"
+        Qt::ListWidgetItem.new(string, @list)
+      end
+      layout.addWidget(@list)
+      @list.connect(SIGNAL('itemSelectionChanged ()')) do
+        ExceptionDialog.new(self, @exception_list[@list.currentRow], title, false)
+      end
+
+      ok_button = Qt::PushButton.new('Ok')
+      connect(ok_button, SIGNAL('clicked()'), self, SLOT('accept()'))
+      layout.addWidget(ok_button, 0, Qt::AlignCenter)
+
+      # Constrain the maximum size in case the list is huge
+      setMaximumSize(800, 600)
+      # Ideally we resize to show the entire list
+      resize(@list.width, @list.height)
+
+      self.raise
+      exec()
+      dispose()
+    end
+  end
+end