Class: Cosmos::ScriptRunner

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 30

def initialize(options)
  # All code before super is executed twice in RubyQt Based classes
  super(options) # MUST BE FIRST
  Cosmos.load_cosmos_icon("script_runner.png")
  setAcceptDrops(true) # Allow dropping in files

  @config_file = options.config_file
  @server_config_file = options.server_config_file

  # Add procedures to search path
  System.paths['PROCEDURES'].each do |path|
    Cosmos.add_to_search_path(path)
  end

  initialize_actions()
  initialize_menus()
  initialize_central_widget()
  complete_initialize()

  # Load icons
  @running_icon = Cosmos.get_icon('running.png')
  @no_icon = Qt::Icon.new

  # Handle configuration
  filename = File.join(::Cosmos::USERPATH, %w(config tools script_runner), @config_file)
  if File.exist?(filename)
    ScriptRunnerConfig.new(filename)
  elsif @config_file != 'script_runner.txt'
    raise "Could not find config file #{filename}"
  end

  @procedure_dir = System.paths['PROCEDURES'][0]
  @debug = false

  # Create the initial tab(s)
  if ARGV.length == 0
    create_tab()
  else
    ARGV.each {|argv_filename| create_tab(argv_filename)}
  end
end

Class Method Details

.run(option_parser = nil, options = nil) ⇒ `Object`

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 902

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 = 750
      options.height = 600
      options.title = "Script Runner : Untitiled"
      options.auto_size = false
      options.config_file = "script_runner.txt"
      options.server_config_file = CmdTlmServer::DEFAULT_CONFIG_FILE

      option_parser.separator "Script Runner Specific Options:"
      option_parser.on("-c", "--config FILE", "Use the specified configuration file") do |arg|
        options.config_file = arg
      end
      option_parser.on("-s", "--server FILE", "Use the specified server configuration file for disconnect mode") do |arg|
        options.server_config_file = arg
      end
    end

    super(option_parser, options)
  end
end

Instance Method Details

#active_script_runner_frame ⇒ `Object`

Returns the script runner frame of the active tab



813
814
815

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 813

def active_script_runner_frame
  @tab_book.currentTab
end

#close_active_tab ⇒ `Object`

Closes the active tab

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 849

def close_active_tab
  if @tab_book.count > 1
    active_script_runner_frame().stop_message_log
    tab_index = @tab_book.currentIndex
    @tab_book.removeTab(tab_index)
    if tab_index >= 1
      @tab_book.setCurrentIndex(tab_index - 1)
    else
      @tab_book.setCurrentIndex(0)
    end
  end
end

#closeEvent(event) ⇒ `Object`

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 626

def closeEvent(event)
  if active_script_runner_frame().prompt_if_running_on_close()
    if prompt_for_save_if_needed_on_close()
      shutdown_cmd_tlm()
      @tab_book.tabs.each_with_index do |tab, index|
        tab.stop_message_log
      end
      super(event)
    else
      event.ignore()
    end
  else
    event.ignore()
  end
end

#context_menu(point) ⇒ `Object`

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 749

def context_menu(point)
  index = 0
  @tab_book.tabBar.count.times do
    break if @tab_book.tabBar.tabRect(index).contains(point)
    index += 1
  end

  return if (index == @tab_book.tabBar.count)

  # Bring the right clicked tab to the front
  @tab_book.setCurrentIndex(index)

  menu = Qt::Menu.new()

  new_action = Qt::Action.new(tr("&New"), self)
  new_action.statusTip = tr("Create a new script")
  new_action.connect(SIGNAL('triggered()')) { file_new() }
  menu.addAction(new_action)

  close_action = Qt::Action.new(tr("&Close"), self)
  close_action.statusTip = tr("Close the script")
  close_action.connect(SIGNAL('triggered()')) { file_close() }
  menu.addAction(close_action)

  save_action = Qt::Action.new(tr("&Save"), self)
  save_action.statusTip = tr("Save the script")
  save_action.connect(SIGNAL('triggered()')) { file_save(false) }
  menu.addAction(save_action)

  save_action = Qt::Action.new(tr("Save &As"), self)
  save_action.statusTip = tr("Save the script as")
  save_action.connect(SIGNAL('triggered()')) { file_save(true) }
  menu.addAction(save_action)

  menu.exec(@tab_book.mapToGlobal(point))
  menu.dispose
end

#create_tab(filename = '') ⇒ `Object`

Creates a new tab

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 818

def create_tab(filename = '')
  if filename.empty?
    tab_item_name = UNTITLED_TAB_TEXT
  else
    tab_item_name = '  ' + File.basename(filename) + '  '
  end

  script_runner_frame = ScriptRunnerFrame.new(self)
  script_runner_frame.toggle_debug(@debug)
  script_runner_frame.setContentsMargins(5,5,5,5)
  connect(script_runner_frame,
          SIGNAL('undoAvailable(bool)'),
          self,
          SLOT('undo_available(bool)'))
  script_runner_frame.run_callback = method(:run_callback)
  script_runner_frame.stop_callback = method(:stop_callback)
  script_runner_frame.set_text_from_file(filename) unless filename.empty?
  script_runner_frame.filename = filename
  # Register a keypress handler so we can Ctrl-Tab our way through the tabs
  script_runner_frame.key_press_callback = method(:handle_script_keypress)
  # Update the title if the frame changes so we can add/remove the asterix
  script_runner_frame.connect(SIGNAL('modificationChanged(bool)')) { update_title() }

  @tab_book.addTab(script_runner_frame, tab_item_name)
  @tab_book.setCurrentIndex(@tab_book.count-1) # index is 0 based
  # Set the focus on the input now that we've added the tab
  script_runner_frame.setFocus
  update_title()
end

#disable_menu_items ⇒ `Object`

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 699

def disable_menu_items
  # Disable File Menu Items
  @file_new.setEnabled(false)
  @file_open.setEnabled(false)
  @file_close.setEnabled(false)
  @file_reload.setEnabled(false)
  @file_save.setEnabled(false)
  @file_save_as.setEnabled(false)
  @file_options.setEnabled(false)

  # Disable Edit Menu Items
  @edit_undo.setEnabled(false)
  @edit_redo.setEnabled(false)
  @edit_cut.setEnabled(false)
  @edit_copy.setEnabled(false)
  @edit_paste.setEnabled(false)
  @edit_select_all.setEnabled(false)
  @edit_comment.setEnabled(false)

  # Disable Script Menu Items
  @script_syntax_all.setEnabled(false)
  @script_syntax_lines.setEnabled(false)
  @script_mnemonic_all.setEnabled(false)
  @script_mnemonic_lines.setEnabled(false)
  @script_execute_lines.setEnabled(false)
  @script_execute_cursor.setEnabled(false)

  # Enable Script Runtime Items
  @script_log_message.setEnabled(true)
  @script_call_stack.setEnabled(true)
end

#dragEnterEvent(event) ⇒ `Object`

Drag files into ScriptRunner support

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 336

def dragEnterEvent(event)
  if event.mimeData.hasUrls
    event.acceptProposedAction();
  end
end

#dragMoveEvent(event) ⇒ `Object`

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 342

def dragMoveEvent(event)
  if event.mimeData.hasUrls
    event.acceptProposedAction();
  end
end

#dropEvent(event) ⇒ `Object`

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 348

def dropEvent(event)
  event.mimeData.urls.each do |url|
    filename = url.toLocalFile
    extension = File.extname(filename).to_s.downcase
    if extension == '.rb' or extension == '.txt'
      file_open(filename)
    end
  end
end

#enable_menu_items ⇒ `Object`

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 667

def enable_menu_items
  # Enable File Menu Items
  @file_new.setEnabled(true)
  @file_open.setEnabled(true)
  @file_close.setEnabled(true)
  @file_reload.setEnabled(true)
  @file_save.setEnabled(true)
  @file_save_as.setEnabled(true)
  @file_options.setEnabled(true)

  # Enable Edit Menu Items
  @edit_undo.setEnabled(true)
  @edit_redo.setEnabled(true)
  @edit_cut.setEnabled(true)
  @edit_copy.setEnabled(true)
  @edit_paste.setEnabled(true)
  @edit_select_all.setEnabled(true)
  @edit_comment.setEnabled(true)

  # Enable Script Menu Items
  @script_syntax_all.setEnabled(true)
  @script_syntax_lines.setEnabled(true)
  @script_mnemonic_all.setEnabled(true)
  @script_mnemonic_lines.setEnabled(true)
  @script_execute_lines.setEnabled(true)
  @script_execute_cursor.setEnabled(true)

  # Disable Script Runtime Items'
  @script_log_message.setEnabled(false)
  @script_call_stack.setEnabled(false)
end

#file_close ⇒ `Object`

File->Close

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 462

def file_close
  if prompt_for_save_if_needed('Save Current Script?')
    if @tab_book.count > 1
      close_active_tab()
    else
      active_script_runner_frame().stop_message_log
      @tab_book.setTabText(0, '  Untitled  ')
      @tab_book.currentTab.clear
    end
    update_title()
  end
end

#file_new ⇒ `Object`

File->New



363
364
365

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 363

def file_new
  create_tab()
end

#file_open(filename = nil) ⇒ `Object`

File->Open

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 368

def file_open(filename = nil)
  if !filename
    filename = Qt::FileDialog.getOpenFileName(self, "Select Script", @procedure_dir)
  end
  unless filename.nil? || filename.empty?
    # If the user opens a file we already have open
    # just set the current tab to that file and return
    @tab_book.tabs.each_with_index do |tab, index|
      if tab.filename == filename
        @tab_book.setCurrentIndex(index)
        @tab_book.currentTab.set_text_from_file(filename)
        @tab_book.currentTab.filename = filename
        return
      end
    end

    if ((@tab_book.count == 1) &&
        @tab_book.currentTab.filename.empty? &&
        !@tab_book.currentTab.modified)
      # Active Tab is an unmodified Untitled so just open the file in it
      @tab_book.currentTab.set_text_from_file(filename)
      @tab_book.currentTab.filename = filename
      @tab_book.setTabText(@tab_book.currentIndex, File.basename(filename))
    else
      create_tab(filename)
    end

    update_title()
    @procedure_dir = File.dirname(filename)
    @procedure_dir << '/' if @procedure_dir[-1..-1] != '/' and @procedure_dir[-1..-1] != '\\'
  end
end

#file_options ⇒ `Object`

File->Options

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 476

def file_options
  dialog = Qt::Dialog.new(self)
  dialog.setWindowTitle('Script Runner Options')
  layout = Qt::VBoxLayout.new

  form = Qt::FormLayout.new
  box = Qt::DoubleSpinBox.new
  box.setRange(0, 60)
  box.setValue(ScriptRunnerFrame.line_delay)
  form.addRow(tr("&Delay between each script line:"), box)
  pause_on_error = Qt::CheckBox.new
  form.addRow(tr("&Pause on error:"), pause_on_error)
  monitor = Qt::CheckBox.new
  form.addRow(tr("&Monitor limits:"), monitor)
  if ScriptRunnerFrame.pause_on_error
    pause_on_error.setCheckState(Qt::Checked)
  else
    pause_on_error.setCheckState(Qt::Unchecked)
  end
  pause_on_red = Qt::CheckBox.new
  form.addRow(tr("Pause on &red limit:"), pause_on_red)
  if ScriptRunnerFrame.monitor_limits
    monitor.setCheckState(Qt::Checked)
    pause_on_red.setCheckState(Qt::Checked) if ScriptRunnerFrame.pause_on_red
  else
    pause_on_red.setEnabled(false)
  end
  monitor.connect(SIGNAL('stateChanged(int)')) do
    if monitor.isChecked()
      pause_on_red.setEnabled(true)
    else
      pause_on_red.setCheckState(Qt::Unchecked)
      pause_on_red.setEnabled(false)
    end
  end
  layout.addLayout(form)

  divider = Qt::Frame.new
  divider.setFrameStyle(Qt::Frame::HLine | Qt::Frame::Raised)
  divider.setLineWidth(1)
  layout.addWidget(divider)

  ok = Qt::PushButton.new('Ok')
  ok.setDefault(true)
  ok.connect(SIGNAL('clicked(bool)')) do
    ScriptRunnerFrame.line_delay = box.value
    ScriptRunnerFrame.pause_on_error = (pause_on_error.checkState == Qt::Checked)
    ScriptRunnerFrame.monitor_limits = (monitor.checkState == Qt::Checked)
    ScriptRunnerFrame.pause_on_red = (pause_on_red.checkState == Qt::Checked)
    dialog.accept
  end
  cancel = Qt::PushButton.new('Cancel')
  cancel.connect(SIGNAL('clicked(bool)')) { dialog.reject }
  button_layout = Qt::HBoxLayout.new
  button_layout.addWidget(ok)
  button_layout.addWidget(cancel)
  layout.addLayout(button_layout)
  dialog.setLayout(layout)
  dialog.exec
  dialog.dispose
end

#file_reload ⇒ `Object`

File->Reload

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 402

def file_reload
  safe_to_continue = true
  if @tab_book.currentTab.modified
    case Qt::MessageBox.question(self, # parent
                                 'Discard Changes?', # title
                                 'Warning: Changes will be lost. Continue?', # text
                                 Qt::MessageBox::Yes | Qt::MessageBox::No, # buttons
                                 Qt::MessageBox::No) # default button
    when Qt::MessageBox::No
      safe_to_continue = false
    end
  end

  if safe_to_continue
    if active_script_runner_frame().filename.empty?
      active_script_runner_frame().set_text('')
    else
      active_script_runner_frame().set_text_from_file(active_script_runner_frame().filename)
    end
    @tab_book.currentTab.modified = false
    update_title()
  end
end

#file_save(save_as = false) ⇒ `Object`

File->Save and File->Save As

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 427

def file_save(save_as = false)
  saved = false
  filename = active_script_runner_frame().filename
  if filename.empty?
    filename = Qt::FileDialog::getSaveFileName(self,         # parent
                                               'Save As...', # caption
                                               @procedure_dir + '/procedure.rb', # dir
                                               'Procedure Files (*.rb)') # filter
  elsif save_as
    filename = Qt::FileDialog::getSaveFileName(self,         # parent
                                               'Save As...', # caption
                                               filename,     # dir
                                               'Procedure Files (*.rb)') # filter
  end
  if not filename.nil? and not filename.empty?
    begin
      @tab_book.currentTab.filename = filename
      @tab_book.currentTab.modified = false
      @tab_book.setTabText(@tab_book.currentIndex, File.basename(filename))
      active_script_runner_frame().filename = filename
      File.open(filename, "w") {|file| file.write(active_script_runner_frame().text)}
      saved = true
      update_title()
      statusBar.showMessage(tr("#{filename} saved"))
      @procedure_dir = File.dirname(filename)
      @procedure_dir << '/' if @procedure_dir[-1..-1] != '/' and @procedure_dir[-1..-1] != '\\'
    rescue => error
      statusBar.showMessage(tr("Error Saving Script : #{error.class} : #{error.message}"))
    end
  end

  return saved
end

#handle_script_keypress(event) ⇒ `Object`

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 736

def handle_script_keypress(event)
  update_title()
  if event.matches(Qt::KeySequence::NextChild)
    index = @tab_book.currentIndex + 1
    index = 0 if index >= @tab_book.count
    @tab_book.setCurrentIndex(index)
  elsif event.matches(Qt::KeySequence::PreviousChild)
    index = @tab_book.currentIndex - 1
    index = @tab_book.count - 1 if index < 0
    @tab_book.setCurrentIndex(index)
  end
end

#handle_tab_change(index) ⇒ `Object`

Handle the user changing tabs



732
733
734

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 732

def handle_tab_change(index)
  update_title()
end

#initialize_actions ⇒ `Object`

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 72

def initialize_actions
  super()

  # File actions
  @file_new = Qt::Action.new(Cosmos.get_icon('file.png'), tr('&New'), self)
  @file_new_keyseq = Qt::KeySequence.new(tr('Ctrl+N'))
  @file_new.shortcut  = @file_new_keyseq
  @file_new.statusTip = tr('Start a new script')
  @file_new.connect(SIGNAL('triggered()')) { file_new() }

  @file_open = Qt::Action.new(Cosmos.get_icon('open.png'), tr('&Open'), self)
  @file_open_keyseq = Qt::KeySequence.new(tr('Ctrl+O'))
  @file_open.shortcut  = @file_open_keyseq
  @file_open.statusTip = tr('Open a script')
  @file_open.connect(SIGNAL('triggered()')) { file_open() }

  @file_close = Qt::Action.new(tr('&Close'), self)
  @file_close_keyseq = Qt::KeySequence.new(tr('Ctrl+W'))
  @file_close.shortcut  = @file_close_keyseq
  @file_close.statusTip = tr('Close the script')
  @file_close.connect(SIGNAL('triggered()')) { file_close() }

  @file_reload = Qt::Action.new(tr('&Reload'), self)
  @file_reload_keyseq = Qt::KeySequence.new(tr('Ctrl+R'))
  @file_reload.shortcut  = @file_reload_keyseq
  @file_reload.statusTip = tr('Reload a script')
  @file_reload.connect(SIGNAL('triggered()')) { file_reload() }

  @file_save = Qt::Action.new(Cosmos.get_icon('save.png'), tr('&Save'), self)
  @file_save_keyseq = Qt::KeySequence.new(tr('Ctrl+S'))
  @file_save.shortcut  = @file_save_keyseq
  @file_save.statusTip = tr('Save the script')
  @file_save.connect(SIGNAL('triggered()')) { file_save(false) }

  @file_save_as = Qt::Action.new(Cosmos.get_icon('save_as.png'), tr('Save &As'), self)
  @file_save_as.statusTip = tr('Save the script')
  @file_save_as.connect(SIGNAL('triggered()')) { file_save(true) }

  @file_options = Qt::Action.new(tr('O&ptions'), self)
  @file_options.statusTip = tr('Application Options')
  @file_options.connect(SIGNAL('triggered()')) { file_options() }

  # Edit actions
  @edit_undo = Qt::Action.new(Cosmos.get_icon('undo.png'), tr('&Undo'), self)
  @edit_undo_keyseq = Qt::KeySequence.new(tr('Ctrl+Z'))
  @edit_undo.shortcut  = @edit_undo_keyseq
  @edit_undo.statusTip = tr('Undo')
  @edit_undo.connect(SIGNAL('triggered()')) { active_script_runner_frame().undo }

  @edit_redo = Qt::Action.new(Cosmos.get_icon('redo.png'), tr('&Redo'), self)
  @edit_redo_keyseq = Qt::KeySequence.new(tr('Ctrl+Y'))
  @edit_redo.shortcut  = @edit_redo_keyseq
  @edit_redo.statusTip = tr('Redo')
  @edit_redo.connect(SIGNAL('triggered()')) { active_script_runner_frame().redo }

  @edit_cut = Qt::Action.new(Cosmos.get_icon('cut.png'), tr('Cu&t'), self)
  @edit_cut_keyseq = Qt::KeySequence.new(tr('Ctrl+X'))
  @edit_cut.shortcut  = @edit_cut_keyseq
  @edit_cut.statusTip = tr('Cut')
  @edit_cut.connect(SIGNAL('triggered()')) { active_script_runner_frame().cut }

  @edit_copy = Qt::Action.new(Cosmos.get_icon('copy.png'), tr('&Copy'), self)
  @edit_copy_keyseq = Qt::KeySequence.new(tr('Ctrl+C'))
  @edit_copy.shortcut  = @edit_copy_keyseq
  @edit_copy.statusTip = tr('Copy')
  @edit_copy.connect(SIGNAL('triggered()')) { active_script_runner_frame().copy }

  @edit_paste = Qt::Action.new(tr('&Paste'), self)
  @edit_paste_keyseq = Qt::KeySequence.new(tr('Ctrl+V'))
  @edit_paste.shortcut  = @edit_paste_keyseq
  @edit_paste.statusTip = tr('Paste')
  @edit_paste.connect(SIGNAL('triggered()')) { active_script_runner_frame().paste }

  @edit_select_all = Qt::Action.new(tr('Select &All'), self)
  @edit_select_all_keyseq = Qt::KeySequence.new(tr('Ctrl+A'))
  @edit_select_all.shortcut  = @edit_select_all_keyseq
  @edit_select_all.statusTip = tr('Select All')
  @edit_select_all.connect(SIGNAL('triggered()')) { active_script_runner_frame().select_all }

  @edit_comment = Qt::Action.new(tr('Comment/Uncomment &Lines'), self)
  @edit_comment_keyseq = Qt::KeySequence.new(tr('Ctrl+K'))
  @edit_comment.shortcut  = @edit_comment_keyseq
  @edit_comment.statusTip = tr('Comment/Uncomment Lines')
  @edit_comment.connect(SIGNAL('triggered()')) { active_script_runner_frame().comment_or_uncomment_lines }

  # Search Actions
  @search_find = Qt::Action.new(Cosmos.get_icon('search.png'), tr('&Find'), self)
  @search_find_keyseq = Qt::KeySequence.new(tr('Ctrl+F'))
  @search_find.shortcut  = @search_find_keyseq
  @search_find.statusTip = tr('Find text')
  @search_find.connect(SIGNAL('triggered()')) do
    FindReplaceDialog.show_find(self)
  end

  @search_find_next = Qt::Action.new(tr('Find &Next'), self)
  @search_find_next_keyseq = Qt::KeySequence.new(tr('F3'))
  @search_find_next.shortcut  = @search_find_next_keyseq
  @search_find_next.statusTip = tr('Find next instance')
  @search_find_next.connect(SIGNAL('triggered()')) do
    FindReplaceDialog.find_next(self)
  end

  @search_find_previous = Qt::Action.new(tr('Find &Previous'), self)
  @search_find_previous_keyseq = Qt::KeySequence.new(tr('Shift+F3'))
  @search_find_previous.shortcut  = @search_find_previous_keyseq
  @search_find_previous.statusTip = tr('Find previous instance')
  @search_find_previous.connect(SIGNAL('triggered()')) do
    FindReplaceDialog.find_previous(self)
  end

  @search_replace = Qt::Action.new(tr('&Replace'), self)
  @search_replace_keyseq = Qt::KeySequence.new(tr('Ctrl+H'))
  @search_replace.shortcut  = @search_replace_keyseq
  @search_replace.statusTip = tr('Replace')
  @search_replace.connect(SIGNAL('triggered()')) do
    FindReplaceDialog.show_replace(self)
  end

  # Script Actions
  @script_syntax_all = Qt::Action.new(tr('&Ruby Syntax Check'), self)
  @script_syntax_all.statusTip = tr('Check ruby syntax of this script')
  @script_syntax_all.connect(SIGNAL('triggered()')) do
    active_script_runner_frame().ruby_syntax_check_text()
  end

  @script_mnemonic_all = Qt::Action.new(tr('&Mnemonic Check'), self)
  @script_mnemonic_all.statusTip = tr('Check mnemonics of this script')
  @script_mnemonic_all.connect(SIGNAL('triggered()')) do
    active_script_runner_frame().mnemonic_check_text(active_script_runner_frame().text)
  end

  @script_execute_lines = Qt::Action.new(tr('&Execute Selected Lines'), self)
  @script_execute_lines.statusTip = tr('Execute selected lines')
  @script_execute_lines.connect(SIGNAL('triggered()')) { active_script_runner_frame().run_selection }

  @script_execute_cursor = Qt::Action.new(tr('E&xecute From Cursor'), self)
  @script_execute_cursor.statusTip = tr('Execute from cursor position')
  @script_execute_cursor.connect(SIGNAL('triggered()')) { active_script_runner_frame().run_from_cursor }

  @script_syntax_lines = Qt::Action.new(tr('Ruby &Syntax Check Selected Lines'), self)
  @script_syntax_lines.statusTip = tr('Check ruby syntax of selected lines')
  @script_syntax_lines.connect(SIGNAL('triggered()')) { active_script_runner_frame().ruby_syntax_check_selection }

  @script_mnemonic_lines = Qt::Action.new(tr('M&nemonic Check Selected Lines'), self)
  @script_mnemonic_lines.statusTip = tr('Check mnemonics of selected lines')
  @script_mnemonic_lines.connect(SIGNAL('triggered()')) { active_script_runner_frame().mnemonic_check_selection }

  @script_audit = Qt::Action.new(tr('&Generate Cmd/Tlm Audit'), self)
  @script_audit.statusTip = tr('Generate audit about commands sent and telemetry checked')
  @script_audit.connect(SIGNAL('triggered()')) { script_audit() }

  @script_instrumented = Qt::Action.new(tr('&View Instrumented Script'), self)
  @script_instrumented.statusTip = tr('View instrumented script')
  @script_instrumented.connect(SIGNAL('triggered()')) { script_view_instrumented() }

  @script_log_message = Qt::Action.new(tr('Log Message to Script Log'), self)
  @script_log_message.statusTip = tr('Log Message to Script Log')
  @script_log_message.connect(SIGNAL('triggered()')) { script_log_message() }
  @script_log_message.setEnabled(false)

  @script_call_stack = Qt::Action.new(tr('Show Call Stack'), self)
  @script_call_stack.statusTip = tr('Show Call Stack')
  @script_call_stack.connect(SIGNAL('triggered()')) { script_call_stack() }
  @script_call_stack.setEnabled(false)

  @script_debug = Qt::Action.new(Cosmos.get_icon('bug.png'), tr('Toggle &Debug'), self)
  @script_debug_keyseq = Qt::KeySequence.new(tr('Ctrl+D'))
  @script_debug.shortcut  = @script_debug_keyseq
  @script_debug.statusTip = tr('Toggle debug capabilities for the script')
  @script_debug.connect(SIGNAL('triggered()')) { script_toggle_debug() }

  @script_disconnect = Qt::Action.new(Cosmos.get_icon('disconnected.png'), tr('&Toggle Disconnect'), self)
  @script_disconnect_keyseq = Qt::KeySequence.new(tr('Ctrl+T'))
  @script_disconnect.shortcut  = @script_disconnect_keyseq
  @script_disconnect.statusTip = tr('Toggle disconnect from the server')
  @script_disconnect.connect(SIGNAL('triggered()')) { script_toggle_disconnect() }
end

#initialize_central_widget ⇒ `Object`

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 313

def initialize_central_widget
  # Create the central widget
  @tab_book = Qt::TabWidget.new
  @tab_book.setMovable(true)
  @tab_book.setContextMenuPolicy(Qt::CustomContextMenu)
  connect(@tab_book,
          SIGNAL('customContextMenuRequested(const QPoint&)'),
          self,
          SLOT('context_menu(const QPoint&)'))
  connect(@tab_book,
          SIGNAL('currentChanged(int)'),
          self,
          SLOT('handle_tab_change(int)'))
  setCentralWidget(@tab_book)

  # Display a blank message to force the statusBar to show
  statusBar.showMessage("")
end

#initialize_menus ⇒ `Object`

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 250

def initialize_menus
  # File Menu
  file_menu = menuBar.addMenu(tr('&File'))
  file_menu.addAction(@file_new)
  file_menu.addAction(@file_open)
  file_menu.addAction(@file_close)
  file_menu.addAction(@file_reload)
  file_menu.addSeparator()
  file_menu.addAction(@file_save)
  file_menu.addAction(@file_save_as)
  file_menu.addSeparator()
  file_menu.addAction(@file_options)
  file_menu.addSeparator()
  file_menu.addAction(@exit_action)

  # Edit Menu
  mode_menu = menuBar.addMenu(tr('&Edit'))
  mode_menu.addAction(@edit_undo)
  mode_menu.addAction(@edit_redo)
  mode_menu.addSeparator()
  mode_menu.addAction(@edit_cut)
  mode_menu.addAction(@edit_copy)
  mode_menu.addAction(@edit_paste)
  mode_menu.addSeparator()
  mode_menu.addAction(@edit_select_all)
  mode_menu.addSeparator()
  mode_menu.addAction(@edit_comment)

  # Search Menu
  view_menu = menuBar.addMenu(tr('&Search'))
  view_menu.addAction(@search_find)
  view_menu.addAction(@search_find_next)
  view_menu.addAction(@search_find_previous)
  view_menu.addAction(@search_replace)

  # Script Menu
  view_menu = menuBar.addMenu(tr('Scrip&t'))
  view_menu.addAction(@script_syntax_all)
  view_menu.addAction(@script_syntax_lines)
  view_menu.addSeparator()
  view_menu.addAction(@script_mnemonic_all)
  view_menu.addAction(@script_mnemonic_lines)
  view_menu.addSeparator()
  view_menu.addAction(@script_execute_lines)
  view_menu.addAction(@script_execute_cursor)
  view_menu.addSeparator()
  view_menu.addAction(@script_audit)
  view_menu.addAction(@script_instrumented)
  view_menu.addSeparator()
  view_menu.addAction(@script_log_message)
  view_menu.addAction(@script_call_stack)
  view_menu.addAction(@script_debug)
  view_menu.addAction(@script_disconnect)

  # Help Menu
  @about_string = "Script Runner allows the user to execute commands "\
    "and take action on telemetry within a saveable script. "\
    "It allows the full power of the Ruby programming language "\
    "while defining several keywords to manipulate commands and telemetry in COSMOS.\n"

  initialize_help_menu()
end

#prompt_for_save_if_needed(message = 'Save?') ⇒ `Object`

Prompts for save if the current tab has been modified

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 863

def prompt_for_save_if_needed(message = 'Save?')
  safe_to_continue = true
  if @tab_book.currentTab.modified
    case Qt::MessageBox.question(
      self,    # parent
      'Save?', # title
      message, # text
      Qt::MessageBox::Yes | Qt::MessageBox::No | Qt::MessageBox::Cancel, # buttons
      Qt::MessageBox::Cancel) # default button
    when Qt::MessageBox::Cancel
      safe_to_continue = false
    when Qt::MessageBox::Yes
      saved = file_save(false)
      if not saved
        safe_to_continue = false
      end
    end
  end
  return safe_to_continue
end

#prompt_for_save_if_needed_on_close ⇒ `Object`

Prompts the user that unsaved changes have been made before they close the app

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 885

def prompt_for_save_if_needed_on_close
  safe_to_continue = true
  @tab_book.tabs.each_with_index do |tab, index|
    if tab.modified
      @tab_book.setCurrentIndex(index)
      if tab.filename.empty?
        message = "Save changes to 'Untitled'?"
      else
        message = "Save changes to '#{tab.filename}'?"
      end
      safe_to_continue = prompt_for_save_if_needed(message)
      #~ break unless safe_to_continue
    end
  end
  return safe_to_continue
end

#run_callback(script_runner_frame = nil) ⇒ `Object`

This method disables things that you shouldn’t do while running

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 643

def run_callback(script_runner_frame = nil)
  if script_runner_frame
    @tab_book.tabs.each_with_index do |tab, index|
      if tab != script_runner_frame
        @tab_book.setTabEnabled(index, false)
      else
        @tab_book.tabBar.setTabIcon(index, @running_icon)
      end
    end
  end
  disable_menu_items()
end

#script_call_stack ⇒ `Object`

Script->Show Call Stack

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 593

def script_call_stack
  trace = active_script_runner_frame().current_backtrace
  ScrollTextDialog.new(self, 'Call Stack', trace.join("\n"))
end

#script_log_message ⇒ `Object`

Script->Log Message to Script Log

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 584

def script_log_message
  message = get_scriptrunner_log_message()
  if message
    active_script_runner_frame().scriptrunner_puts 'User logged: '  + message.to_s
    active_script_runner_frame().handle_output_io
  end
end

#script_set_status(message) ⇒ `Object`

Called by cosmos_script_module by the user calling the status_bar scripting method

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 792

def script_set_status(message)
  Qt.execute_in_main_thread(true) do
    # Check for self.disposed? to work around crash when using SimpleCov
    unless self.disposed?
      status_bar = statusBar()
      status_bar.showMessage(message)
    end
  end
end

#script_toggle_debug ⇒ `Object`

Script->Toggle Debug

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 599

def script_toggle_debug
  @debug = !@debug
  if @tab_book.count > 0
    (0..(@tab_book.count - 1)).each do |index|
      @tab_book.tab(index).toggle_debug(@debug)
    end
  end
end

#script_toggle_disconnect ⇒ `Object`

Script->Toggle Disconnect



609
610
611

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 609

def script_toggle_disconnect
  @server_config_file = active_script_runner_frame().toggle_disconnect(@server_config_file)
end

#script_view_instrumented ⇒ `Object`

Script->View Instrumented

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 545

def script_view_instrumented
  begin
    instrumented_script =
      ScriptRunnerFrame.instrument_script(active_script_runner_frame().text,
                                          active_script_runner_frame().filename,
                                          true)
  rescue StopScript
    return
  end

  # Show Dialog box containing script code
  box = Qt::Dialog.new(self)
  box.setWindowTitle('Instrumented Script')
  text = Qt::PlainTextEdit.new
  text.setWordWrapMode(Qt::TextOption::NoWrap)
  text.setReadOnly(true)
  text.setPlainText(instrumented_script)
  layout = Qt::VBoxLayout.new
  layout.addWidget(text)
  ok = Qt::PushButton.new('OK')
  ok.setDefault(true)
  ok.connect(SIGNAL('clicked(bool)')) { box.accept }
  button_layout = Qt::HBoxLayout.new
  button_layout.addStretch
  button_layout.addWidget(ok)
  button_layout.addStretch
  layout.addLayout(button_layout)
  box.setLayout(layout)
  box.setMinimumWidth([Qt::CoreApplication.instance.desktop.availableGeometry.width,
                      text.document.size.width].min)
  screen_height = Qt::CoreApplication.instance.desktop.availableGeometry.height
  preferred_height = (text.document.size.height * text.fontMetrics.lineSpacing) +
    text.horizontalScrollBar.height + ok.sizeHint.height + (layout.spacing * 5)
  box.setMinimumHeight([screen_height, preferred_height].min)
  box.exec
  box.dispose
end

#search_text ⇒ `Object`

Called by the FindReplaceDialog to get the text to search



618
619
620

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 618

def search_text
  active_script_runner_frame().script
end

#stop_callback(script_runner_frame = nil) ⇒ `Object`

This method reenables things after running

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 657

def stop_callback(script_runner_frame = nil)
  if script_runner_frame
    @tab_book.tabs.each_with_index do |tab, index|
      @tab_book.setTabEnabled(index, true)
      @tab_book.tabBar.setTabIcon(index, @no_icon)
    end
  end
  enable_menu_items()
end

#undo_available(bool) ⇒ `Object`



622
623
624

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 622

def undo_available(bool)
  update_title()
end

#update_title ⇒ `Object`

Updates the title appropriately to show the tabs filename and modified status

# File 'lib/cosmos/tools/script_runner/script_runner.rb', line 803

def update_title
  if @tab_book.currentTab.filename.empty?
    self.setWindowTitle("Script Runner : Untitled")
  else
    self.setWindowTitle("Script Runner : #{@tab_book.currentTab.filename}")
  end
  self.setWindowTitle(self.windowTitle << '*') if @tab_book.currentTab.modified
end

Class: Cosmos::ScriptRunner

Constant Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from ScriptAudit

Methods inherited from QtTool

Constructor Details

#initialize(options) ⇒ ScriptRunner

Class Method Details

.run(option_parser = nil, options = nil) ⇒ Object

Instance Method Details

#active_script_runner_frame ⇒ Object

#close_active_tab ⇒ Object

#closeEvent(event) ⇒ Object

#context_menu(point) ⇒ Object

#create_tab(filename = '') ⇒ Object

#disable_menu_items ⇒ Object

#dragEnterEvent(event) ⇒ Object

#dragMoveEvent(event) ⇒ Object

#dropEvent(event) ⇒ Object

#enable_menu_items ⇒ Object

#file_close ⇒ Object

#file_new ⇒ Object

#file_open(filename = nil) ⇒ Object

#file_options ⇒ Object

#file_reload ⇒ Object

#file_save(save_as = false) ⇒ Object

#handle_script_keypress(event) ⇒ Object

#handle_tab_change(index) ⇒ Object

#initialize_actions ⇒ Object

#initialize_central_widget ⇒ Object

#initialize_menus ⇒ Object

#prompt_for_save_if_needed(message = 'Save?') ⇒ Object

#prompt_for_save_if_needed_on_close ⇒ Object

#run_callback(script_runner_frame = nil) ⇒ Object

#script_call_stack ⇒ Object

#script_log_message ⇒ Object

#script_set_status(message) ⇒ Object

#script_toggle_debug ⇒ Object

#script_toggle_disconnect ⇒ Object

#script_view_instrumented ⇒ Object

#search_text ⇒ Object

#stop_callback(script_runner_frame = nil) ⇒ Object

#undo_available(bool) ⇒ Object

#update_title ⇒ Object

#initialize(options) ⇒ `ScriptRunner`