backup_paradise 1.3.5

data/lib/backup_paradise/gui/universal_widgets/simple_backup_widget/simple_backup_widget.rb

@@ -0,0 +1,921 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === BackupParadise::GUI::UniversalWidgets::SimpleBackupWidget
+#
+# This is a simple gtk3-widget that can be used to quickly back up data
+# to an external USB device (or a second harddisc).
+#
+# Usage example:
+#
+#   BackupParadise::GUI::UniversalWidgets::SimpleBackupWidget.new(ARGV)
+#
+# =========================================================================== #
+# require 'backup_paradise/gui/universal_widgets/simple_backup_widget/simple_backup_widget.rb'
+# =========================================================================== #
+require 'backup_paradise/base/base.rb'
+
+module BackupParadise
+
+module GUI
+
+module UniversalWidgets
+
+class SimpleBackupWidget < ::BackupParadise::Base # === BackupParadise::GUI::UniversalWidgets::SimpleBackupWidget
+
+  require 'universal_widgets/base_module/base_module.rb'
+  include ::UniversalWidgets::BaseModule
+
+  # ========================================================================= #
+  # The old ruby-gtk2 code had this:
+  # begin
+  #   require 'gtk_paradise/classes/gtk2/information_about_the_harddisc.rb'
+  # rescue LoadError; end
+  # ========================================================================= #
+
+  begin
+    require 'open'
+  rescue LoadError; end
+
+  begin
+    require 'mountpoints'
+  rescue LoadError; end
+
+  # ========================================================================= #
+  # Add backup-paradise related .rb files next:
+  # ========================================================================= #
+  require 'backup_paradise/project/project.rb'
+  require 'backup_paradise/utility_scripts/backup/backup.rb'
+  require 'backup_paradise/actions/backup.rb'
+  require 'backup_paradise/windows/windows.rb'
+
+  # ========================================================================= #
+  # === ARRAY_PREDEFINED_DEVICES
+  # ========================================================================= #
+  ARRAY_PREDEFINED_DEVICES = [
+    ENV['USB1'], 
+    ENV['USB2'], 
+    ENV['USB3'], 
+    ENV['USB4'],
+    ENV['USB5'],
+    ENV['FESTPLATTE1']
+  ]
+
+  # ========================================================================= #
+  # === USE_THESE_CSS_RULES
+  # ========================================================================= #
+  USE_THESE_CSS_RULES = '
+  
+.dotted_steelblue_border {
+  border: 2px dotted steelblue;
+}
+
+.the_backup_button {
+  border: 3px dotted royalblue;
+  padding: 8px;
+  margin: 4px;
+  color: darkgreen;
+  font-weight: bold;
+}
+
+.the_backup_button:hover {
+  color: forestgreen;
+  font-weight: bold;
+}
+
+.the_backup_button_for_ingrid {
+  border: 2px dotted royalblue;
+  padding: 5px;
+  margin: 2px;
+  color: royalblue;
+  font-weight: bold;
+}
+
+.the_backup_button_for_ingrid_button:hover {
+  color: steelblue;
+  font-weight: bold;
+}
+
+  '
+
+  # ========================================================================= #
+  # === TITLE
+  # ========================================================================= #
+  TITLE = '💾 Simple Backup Widget 💾'
+
+  # ========================================================================= #
+  # === WIDTH
+  # ========================================================================= #
+  WIDTH = '82% or minimum 1280px'
+
+  # ========================================================================= #
+  # === HEIGHT
+  # ========================================================================= #
+  HEIGHT = '30% or minimum 400px'
+
+  # ========================================================================= #
+  # === USE_THIS_FONT
+  # ========================================================================= #
+  USE_THIS_FONT = :dejavu_condensed_19
+
+  # ========================================================================= #
+  # === LARGER_FONT
+  # ========================================================================= #
+  LARGER_FONT = :dejavu_condensed_21
+
+  # ========================================================================= #
+  # === SMALLER_FONT
+  # ========================================================================= #
+  SMALLER_FONT  = :dejavu_condensed_18
+
+  # ========================================================================= #
+  # === USE_THIS_MONOSPACED_FONT
+  # ========================================================================= #
+  USE_THIS_MONOSPACED_FONT = :hack_16
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      commandline_arguments       = ARGV,
+      run_already                 = true
+    )
+    super(:vertical) if use_gtk3?
+    determine_the_GUI_to_be_used(commandline_arguments) # This must come first, even before reset().
+    reset
+    set_commandline_arguments(
+      commandline_arguments
+    )
+    on_delete_event_quit_the_application
+    # self.label_widget.set_markup %Q(
+    #   <span size="larger" weight="bold">💾 Backup Script</span>
+    # )
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super() if respond_to?(:super)
+    reset_the_shared_module # This can come early.
+    reset_the_base_module
+    reset_the_internal_variables
+    infer_the_namespace
+    # ======================================================================= #
+    # === @configuration
+    # ======================================================================= #
+    @configuration = [true, __dir__, namespace?]
+    # ======================================================================= #
+    # === Set the title, width, height and the font in use.
+    # ======================================================================= #
+    title_width_height_font(TITLE, WIDTH, HEIGHT, USE_THIS_FONT)
+    if use_gtk3?
+      handle_CSS_rules
+    end
+    infer_the_size_automatically
+    # ======================================================================= #
+    # === @object_rbackup
+    # ======================================================================= #
+    # @object_rbackup  = BackupParadise::Backup.new(nil, :do_not_run_yet)
+    # ======================================================================= #
+    # === @object_hdd_info
+    # ======================================================================= #
+    # @object_hdd_info = ::Gtk::InformationAboutTheHarddisc.new
+  end
+
+  # ========================================================================= #
+  # === favicon?
+  # ========================================================================= #
+  def favicon?
+    :tabble
+  end
+
+  # ========================================================================= #
+  # === smaller_font?
+  # ========================================================================= #
+  def smaller_font?
+    SMALLER_FONT
+  end
+
+  # ========================================================================= #
+  # === update_fdisk
+  #
+  # Use this if you wanna get new fdisk information.
+  #
+  # Or use this:
+  #
+  #   `fdisk -l`.gsub!(%r[^(!?/dev).*\n], '')
+  #
+  # ========================================================================= #
+  def update_fdisk
+    return `fdisk -l`.split("\n").delete_if { |line| line !~ /^\/dev/ }.join("\n")
+  end
+
+  # ========================================================================= #
+  # === handle_CSS_rules                                            (CSS tag)
+  # ========================================================================= #
+  def handle_CSS_rules
+    use_gtk_paradise_project_css_file
+    append_project_css_file
+    more_CSS_then_apply_it(USE_THESE_CSS_RULES)
+  end
+
+  # ========================================================================= #
+  # === reset_the_shared_module
+  #
+  # This method can be used for ruby-gtk3 and ruby-libui, among other
+  # toolkits.
+  # ========================================================================= #
+  def reset_the_shared_module
+    # ======================================================================= #
+    # === @file_chooser_dialog
+    # ======================================================================= #
+    @file_chooser_dialog = nil
+    # ======================================================================= #
+    # === @dataset_from_the_config_file
+    # ======================================================================= #
+    @dataset_from_the_config_file = nil
+    if File.exist? BackupParadise.file_config?
+      @dataset_from_the_config_file = YAML.load_file(BackupParadise.file_config?)
+    end
+  end
+
+  # ========================================================================= #
+  # === padding?
+  # ========================================================================= #
+  def padding?
+    0
+  end
+
+  # ========================================================================= #
+  # === border_size?
+  # ========================================================================= #
+  def border_size?
+    0
+  end
+
+  # ========================================================================= #
+  # === create_the_backup_audio_button
+  # ========================================================================= #
+  def create_the_backup_audio_button
+    # ======================================================================= #
+    # === @button_backup_audio
+    # ======================================================================= #
+    @button_backup_audio = button('Backup Audio')
+    @button_backup_audio.hint = 'This button is ad-hoc code to quickly '\
+      'copy all local songs on my home layout. You can modify this '\
+      'by modifying the config.yml file and changing the entry called '\
+      '<b>local_audio_directory</b>.'
+    @button_backup_audio.on_clicked {
+      # ===================================================================== #
+      # First, if the config-dataset exists, sync the combo-box entry.
+      # ===================================================================== #
+      if @dataset_from_the_config_file
+        local_audio_directory = @dataset_from_the_config_file['local_audio_directory'].to_s
+        entry_left?.set_text(
+          local_audio_directory
+        )
+      end
+      do_backup_my_songs
+    }
+  end
+
+  # ========================================================================= #
+  # === create_the_backup_button
+  # ========================================================================= #
+  def create_the_backup_button
+    # ======================================================================= #
+    # === @button_backup
+    # ======================================================================= #
+    @button_backup = button('_Backup the data', self, :use_mnemonics) {
+      :do_backup_the_data
+    }
+    @button_backup.clear_background
+    @button_backup.on_hover(:lightblue)
+    @button_backup.pad8px
+    @button_backup.css_class('the_backup_button')
+    @button_backup.set_size_request(16, 25)
+    @button_backup.set_border_width(2)
+    @button_backup.hint =
+      "Click this button to <b>backup your data</b>. This works for both "\
+      "directories, as well as individual files and special instructions. "\
+      "Special instructions are indicated via a leading : character on "\
+      "the top-left hand side.\n\n"\
+      "Make sure that the USB device(s) are properly connected before "\
+      "clicking any button, though."
+  end
+
+  # ========================================================================= #
+  # === do_backup_the_data
+  # ========================================================================= #
+  def do_backup_the_data(
+      from = from?,
+      to   = to?
+    )
+    @label_showing_results.set_text(
+      'Command that will be run: '+"\n\n"+
+      '  <b>cp -rv '+from+' '+to+"</b>\n"
+    )
+    @label_showing_results.do_markify
+    Thread.new {
+      e 'Backing up the data next, from `'+
+         sfile(from)+'` to `'+sfile(to)+'`.'
+      copy_from_to(from, to)
+    }
+  end
+
+  # ========================================================================= #
+  # === backup_ingrid_directory
+  #
+  # This is a method for a custom-backup. Other users won't need to use
+  # this method.
+  # ========================================================================= #
+  def backup_ingrid_directory
+    BackupParadise::Windows.backup_ingrid_directory
+  end; alias do_backup_for_ingrid backup_ingrid_directory # === do_backup_for_ingrid
+
+  # ========================================================================= #
+  # === return_backup_complete_message
+  # ========================================================================= #
+  def return_backup_complete_message
+    'Backup complete! Time finish at: '+time_now?
+  end
+
+  # ========================================================================= #
+  # === run_file_chooser_dialog
+  # ========================================================================= #
+  def run_file_chooser_dialog(
+      _ = @file_chooser_dialog
+    )
+    if _ and (_.run == ::Gtk::ResponseType::ACCEPT)
+      filename = _.filename
+      e "filename = #{filename}"
+      e "uri = #{_.uri}"
+      entry_left?.set_text(filename)
+      @file_chooser_dialog.destroy
+    end
+  end
+
+  # ========================================================================= #
+  # === create_file_chooser_dialog_widget
+  # ========================================================================= #
+  def create_file_chooser_dialog_widget
+    @file_chooser_dialog = ::Gtk::FileChooserDialog.new(
+      self: self,
+      title: 'Choose a file or directory',
+      action: ::Gtk::FileChooserAction::OPEN,                                 
+      buttons: [[::Gtk::Stock::OPEN, ::Gtk::ResponseType::ACCEPT],
+       [::Gtk::Stock::CANCEL, ::Gtk::ResponseType::CANCEL]]
+    )
+    # ======================================================================= #
+    # === /home/Temp
+    # ======================================================================= #
+    if File.directory? '/home/Temp/'
+      @file_chooser_dialog.add_shortcut_folder('/home/Temp/')
+    end
+    # ======================================================================= #
+    # === /home/x/Temp
+    # ======================================================================= #
+    if File.directory? '/home/x/Temp/'
+      @file_chooser_dialog.add_shortcut_folder('/home/x/Temp/')
+    end
+    # ======================================================================= #
+    # === /home/x/data/
+    # ======================================================================= #
+    if File.directory? HOME_DIRECTORY_OF_THE_USER_X+'data/'
+      @file_chooser_dialog.add_shortcut_folder(HOME_DIRECTORY_OF_THE_USER_X+'data/')
+    end
+    # ======================================================================= #
+    # Add the audio-directory shortcut, defined in the yaml file.
+    # ======================================================================= #
+    if @dataset_from_the_config_file and
+       @dataset_from_the_config_file.has_key?('local_audio_directory')
+      @file_chooser_dialog.add_shortcut_folder(
+        @dataset_from_the_config_file['local_audio_directory'].to_s
+      )
+    end
+    @file_chooser_dialog.add_shortcut_folder('/Ingrid')
+    @file_chooser_dialog.current_folder = Dir.pwd
+    @file_chooser_dialog.do_show_hidden_files
+    # @file_chooser_dialog.destroy
+  end
+
+  # ========================================================================= #
+  # === copy_this_file
+  # ========================================================================= #
+  def copy_this_file(from, b)
+    ::BackupParadise.copy_this_file(from, b)
+  end
+
+  # ========================================================================= #
+  # === larger_font?
+  # ========================================================================= #
+  def larger_font?
+    LARGER_FONT
+  end
+
+  # ========================================================================= #
+  # === do_transfer_a_single_file
+  # ========================================================================= #
+  def do_transfer_a_single_file(
+      _      = entry_left?.text?.strip,
+      target = onto?
+    )
+    target = target.dup if target.frozen?
+    target << File.basename(_)
+
+    if _.empty?
+      e 'Please supply a file to transfer.'
+    else
+      e "Now trying to copy #{_} to #{target}."
+      Thread.new {
+        copy_this_file(_, target)
+        pop_up_this_text_over_that_widget(return_backup_complete_message, @button_backup)
+      }
+    end
+  end
+
+  # ========================================================================= #
+  # === main_target?
+  #
+  # This method will "return" our main target.
+  # ========================================================================= #
+  def main_target?
+    @backup_to_this_target.text?
+  end
+
+  # ========================================================================= #
+  # === do_backup_my_songs
+  # ========================================================================= #
+  def do_backup_my_songs(
+      to =
+        ("#{onto?}#{File.basename(entry_left?.text?)}/").squeeze('/')
+    )
+    to.squeeze!('/')
+    Thread.new {
+      BackupParadise.simple_backup(
+        entry_left?.text?, to
+      )
+      pop_up_this_text_over_that_widget(
+        return_backup_complete_message,
+        @button_backup_audio 
+      )
+    }
+  end
+
+  # ========================================================================= #
+  # === time_now?
+  # ========================================================================= #
+  def time_now?
+    return ::Time.now.strftime('%d.%m.%Y, %H:%M:%S')
+  end
+
+  # ========================================================================= #
+  # === entry1?
+  # ========================================================================= #
+  def entry1?
+    @entry1_for_the_backup_from_value
+  end; alias entry_left? entry1? # === entry_left?
+
+  # ========================================================================= #
+  # === create_the_entries                                      (entries tag)
+  # ========================================================================= #
+  def create_the_entries
+    # ======================================================================= #
+    # === @entry1_for_the_backup_from_value
+    # ======================================================================= #
+    @entry1_for_the_backup_from_value = entry
+    @entry1_for_the_backup_from_value.pad4px
+    @entry1_for_the_backup_from_value.bblack1
+    @entry1_for_the_backup_from_value.very_light_yellow_background
+    # ======================================================================= #
+    # === @entry2_for_the_backup_onto_value
+    # ======================================================================= #
+    @entry2_for_the_backup_onto_value = entry
+    @entry2_for_the_backup_onto_value.pad4px
+    @entry2_for_the_backup_onto_value.bblack1
+    @entry2_for_the_backup_onto_value.very_light_yellow_background
+    @entry2_for_the_backup_onto_value.width_height(250, 50)
+  end
+
+  # ========================================================================= #
+  # === from?
+  #
+  # This method has to keep in mind that Strings such as ":ingrid" are
+  # used. This indicates a symbol which has to be treated in a special
+  # manner.
+  #
+  # Furthermore, only directories will have a '/' appended; files must
+  # not have a '/' appended.
+  # ========================================================================= #
+  def from?(
+      i = @entry1_for_the_backup_from_value.text?
+    )
+    if i.is_a?(String) and i.start_with?(':')
+      case i.delete(':').to_sym
+      # ===================================================================== #
+      # === :ingrid
+      # ===================================================================== #
+      when :ingrid
+        i = 'C/ingrid/'
+      end
+    end
+    if i.is_a?(String) and i.frozen?
+      i = i.dup
+    end
+    i.squeeze!('/')
+    if File.directory?(i) and !i.end_with?('/')
+      i << '/' 
+    end
+    return i
+  end
+
+  # ========================================================================= #
+  # === copy_from_to
+  #
+  # This is the method that can be used for backing up the data.
+  # ========================================================================= #
+  def copy_from_to(
+      from = from?,
+      to   = onto?
+    )
+    unless File.directory? from
+      e "#{sfile(from)} should be a directory."
+    end
+    if from == 'C/ingrid/'
+      # ====================================================================== #
+      # The first entry is a special case, applying to only one particular
+      # situation on Windows. It is retained here on an ad-hoc basis,
+      # but it may be better to move this into another location.
+      # ====================================================================== #
+      BackupParadise::Windows.backup_ingrid_directory
+    elsif File.file?(from)
+      # ====================================================================== #
+      # Backup files here.
+      # ====================================================================== #
+      do_transfer_a_single_file
+    else
+      # ====================================================================== #
+      # Backup directories here.
+      # ====================================================================== #
+      if from.is_a?(String) and from.start_with?(':')
+        case from.delete(':').to_sym
+        # ===================================================================== #
+        # === :everything
+        #
+        # This will default to the registered action stored in the
+        # config.yml file.
+        # ===================================================================== #
+        when :everything
+          if @dataset_from_the_config_file
+            i = @dataset_from_the_config_file['backup_these_directories']
+            BackupParadise::Actions.backup {{
+              backup_these_directories: i,
+              where_to:                 to
+            }}
+          else
+            e 'No file called config.yml was found. Defaulting to the'
+            e 'current working directory thus.'
+            i = File.absolute_path("#{Dir.pwd}/")
+          end
+        end
+      else
+        begin
+          Thread.new {
+            @spinner.is_active # go_and_spin_now
+            FileUtils.cp_r(from, to)
+            pop_up_this_text_over_that_widget(
+              return_backup_complete_message, @button_backup
+            )
+            @spinner.stop_spinning
+          }
+        rescue Exception => error
+          pp error
+        end
+      end
+    end
+  end
+
+  # ========================================================================= #
+  # === backup_audio_button?
+  # ========================================================================= #
+  def backup_audio_button?
+    @button_backup_audio
+  end
+
+  # ========================================================================= #
+  # === backup_ingrid_button?
+  # ========================================================================= #
+  def backup_ingrid_button?
+    @button_ingrid
+  end
+
+  # ========================================================================= #
+  # === backup_button?
+  # ========================================================================= #
+  def backup_button?
+    @button_backup
+  end
+
+  # ========================================================================= #
+  # === create_the_file_chooser_button
+  # ========================================================================= #
+  def create_the_file_chooser_button
+    # ======================================================================= #
+    # === @button_choose_file
+    # ======================================================================= #
+    @button_choose_file = button('Choose file')
+    @button_choose_file.on_clicked {
+      create_file_chooser_dialog_widget
+      run_file_chooser_dialog
+    }
+  end
+
+  # ========================================================================= #
+  # === choose_file_button?
+  # ========================================================================= #
+  def choose_file_button?
+    @button_choose_file
+  end
+
+  # ========================================================================= #
+  # === create_the_label_showing_results
+  # ========================================================================= #
+  def create_the_label_showing_results
+    @label_showing_results = label
+  end
+
+  # ========================================================================= #
+  # === create_the_buttons                          (buttons tag, button tag)
+  # ========================================================================= #
+  def create_the_buttons
+    create_the_file_chooser_button
+    create_the_backup_button
+    create_the_backup_audio_button
+    create_the_ingrid_button if is_on_roebe?
+  end
+
+  # ========================================================================= #
+  # === onto
+  # ========================================================================= #
+  def onto?
+    return "#{@entry2_for_the_backup_onto_value.text?}/".squeeze('/')
+  end; alias to? onto? # === to?
+
+  # ========================================================================= #
+  # === create_the_grid                                            (grid tag)
+  # ========================================================================= #
+  def create_the_grid
+    # ======================================================================= #
+    # === @grid
+    # ======================================================================= #
+    @grid = default_grid
+    @grid.pad10px
+    @grid.css_class('dotted_steelblue_border')
+    @grid.set_size_request(100, 50)
+    @grid.row_spacing  = 5
+    @grid.line_spacing = 5
+    label_backup_from = text('Backup from:')
+    label_backup_from.make_bold
+    label_backup_from.hint = 'Input which directory '\
+                             'you wish to back up. Use the combo-box entry '\
+                             'below this widget, or the entry below '\
+                             'that combo-box.'
+    @grid.left(label_backup_from)
+
+    label_backup_onto = text('Backup onto:')
+    label_backup_onto.make_bold
+    label_backup_onto.hint = 'Input the target device onto which we will '\
+                             'copy the data onto.'
+    @grid.right(label_backup_onto)
+
+    # ======================================================================= #
+    # Next we will add the two main combo-boxes.
+    # ======================================================================= #
+    @grid.left(@combo_box_backup_from)
+    @grid.right(@combo_box_backup_onto)
+    @grid.left(@entry1_for_the_backup_from_value)
+    @grid.right(@entry2_for_the_backup_onto_value)
+  end
+
+  # ========================================================================= #
+  # === create_the_combo_boxes                                    (combo tag)
+  # ========================================================================= #
+  def create_the_combo_boxes
+    # ======================================================================= #
+    # === @combo_box_backup_from
+    #
+    # This is the combo-box that keeps the core entries, such as
+    # "/home/x/songs" and so forth.
+    # ======================================================================= #
+    @combo_box_backup_from = combo_box
+    @combo_box_backup_from.bblack1
+    @combo_box_backup_from.set_border_width(2)
+    # ======================================================================= #
+    # Next we will populate the combo-box with proper entries:
+    # ======================================================================= #
+    _ = BackupParadise.backup_these_directories?.map {|entry| "#{entry}/".squeeze('/') }
+    _.prepend(':everything')
+    _.prepend(':ingrid') if is_on_roebe?
+    @combo_box_backup_from.populate(_)
+    @combo_box_backup_from.the_first_entry_is_active
+    @combo_box_backup_from.hint =
+      ':everything means to backup the default action, as-is. If you '\
+      'need a more fine-tuned level of control then simply backup only '\
+      'some directories, or use the entry to the right side of this '\
+      'combo box to backup only individual directories or files.'
+    # ======================================================================= #
+    # === @combo_box_backup_onto
+    # ======================================================================= #
+    @combo_box_backup_onto = combo_box
+    @combo_box_backup_onto.bblack1
+    @combo_box_backup_onto.set_border_width(2)
+    scan_for_mountpoints_then_update_the_appropriate_combo_box
+  end
+
+  # ========================================================================= #
+  # === sync_the_combo_box_values_onto_the_entries_below
+  # ========================================================================= #
+  def sync_the_combo_box_values_onto_the_entries_below
+    _ = @combo_box_backup_from.text?.to_s
+    entry1?.set_text(_)
+    sync_the_second_entry
+  end
+
+  # ========================================================================= #
+  # === sync_the_second_entry
+  # ========================================================================= #
+  def sync_the_second_entry
+    entry2?.set_text(
+      @combo_box_backup_onto.text?.to_s
+    )
+  end
+
+  # ========================================================================= #
+  # === entry2?
+  # ========================================================================= #
+  def entry2?
+    @entry2_for_the_backup_onto_value
+  end
+
+  # ========================================================================= #
+  # === do_handle_the_proper_syncing_when_the_combo_box_entries_are_changed
+  # ========================================================================= #
+  def do_handle_the_proper_syncing_when_the_combo_box_entries_are_changed
+    # ======================================================================= #
+    # Sync any change made in the combo box onto the associated entry.
+    # ======================================================================= #
+    sync_connect(@combo_box_backup_from, entry1?)
+    sync_connect(@combo_box_backup_onto, entry2?)
+  end
+
+  # ========================================================================= #
+  # === scan_for_mountpoints_then_update_the_appropriate_combo_box
+  # ========================================================================= #
+  def scan_for_mountpoints_then_update_the_appropriate_combo_box
+    if Object.const_defined? :Mountpoints
+      @combo_box_backup_onto.clear_old_datapoints
+      @combo_box_backup_onto.populate(Mountpoints[])
+      @combo_box_backup_onto.the_first_entry_is_active
+      sync_the_second_entry
+    end
+  end
+
+  # ========================================================================= #
+  # === create_the_skeleton                        (create tag, skeleton tag)
+  # ========================================================================= #
+  def create_the_skeleton
+    create_the_label_showing_results
+    create_the_buttons
+    create_the_entries
+    create_the_combo_boxes
+    create_the_grid
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    run_super
+  end
+
+  # ========================================================================= #
+  # === BackupParadise::GUI::Gtk::SimpleBackupWidget.run
+  # ========================================================================= #
+  def self.run(
+      i = ARGV
+    )
+    require 'gtk_paradise/run'
+    _ = ::BackupParadise::GUI::Gtk::SimpleBackupWidget.new(i)
+    r = ::Gtk.run
+    r << _
+    _.set_parent_widget(r)
+    r.automatic_size_then_automatic_title
+    r.enable_quick_exit
+    r.set_background :white
+    r.is_resizable # <- This line was added due to a possible prior .maximize action.
+    r.top_left_then_run
+  end; self.instance_eval { alias start_gui_application run } # === BackupParadise::GUI::Gtk::SimpleBackupWidget.start_gui_application
+
+  # ========================================================================= #
+  # === BackupParadise::GUI::UniversalWidgets::SimpleBackupWidget[]
+  # ========================================================================= #
+  def self.[](i = ARGV)
+    new(i)
+  end
+
+  # ========================================================================= #
+  # === connect_the_skeleton                                    (connect tag)
+  # ========================================================================= #
+  def connect_the_skeleton
+    abort_on_exception
+
+    outer_vbox = create_vbox # A new vbox.
+
+    header_bar = return_default_header_bar { :with_close_button_and_inferred_title }
+    header_bar.spacing = 10
+    header_bar.add_left(@button_choose_file)
+    header_bar.add_left(@button_backup_audio)
+    @spinner = default_spinner
+    @spinner.is_inactive
+    header_bar.add_right(@spinner)
+    button = icon_theme_image('daytime-sunset-symbolic.symbolic')
+    button.hint = 'Click this icon to show which devices are mounted and '\
+                  'update the combo-box showing all mounted devices.'
+    button.on_clicked {
+      scan_for_mountpoints_then_update_the_appropriate_combo_box
+    }
+    header_bar.add_left(button)
+    outer_vbox.minimal(header_bar,           1)
+    outer_vbox.minimal(horizontal_separator, 1)
+    outer_vbox.minimal(@grid,                1)
+    outer_vbox.minimal(horizontal_separator, 1)
+    hbox = create_hbox
+    _ = BackupParadise.project_base_directory?+'images/right_arrow.png'
+    if File.exist? _
+      hbox.minimal(image(_), 5)
+    end
+    hbox.maximal(@button_backup)
+    outer_vbox.minimal(hbox)
+    outer_vbox.minimal(horizontal_separator)
+    if is_on_roebe?
+      outer_vbox.minimal(@button_ingrid)
+      outer_vbox.minimal(horizontal_separator)
+    end
+    outer_vbox.minimal(@label_showing_results)
+    outer_vbox.minimal(horizontal_separator)
+
+    window = create_window_or_runner
+    window << outer_vbox
+
+    properly_prepare_this_window(window,
+      {
+        title:       title?,
+        font:        font?,
+        width:       width?,
+        height:      height?,
+        padding:     padding?,
+        border_size: border_size?
+      }
+    )
+    window.show_all
+    window.top_left
+    do_all_startup_related_actions
+    run_main
+  end
+
+  # ========================================================================= #
+  # === do_all_startup_related_actions
+  # ========================================================================= #
+  def do_all_startup_related_actions
+    sync_the_combo_box_values_onto_the_entries_below
+    do_handle_the_proper_syncing_when_the_combo_box_entries_are_changed
+  end
+
+  # ========================================================================= #
+  # === create_the_ingrid_button
+  # ========================================================================= #
+  def create_the_ingrid_button
+    # ======================================================================= #
+    # === @button_ingrid
+    # ======================================================================= #
+    @button_ingrid = button('Backup _ingrid', self, :use_mnemonics) {
+      :do_backup_for_ingrid
+    }
+    @button_ingrid.clear_background
+    @button_ingrid.css_class('the_backup_button_for_ingrid')
+    @button_backup.on_hover(:lightblue)
+    @button_ingrid.pad8px
+    @button_ingrid.set_size_request(16, 25)
+    @button_ingrid.set_border_width(2)
+    @button_ingrid.hint = 'This will backup c:\ingrid to '\
+      'the appropriate external USB device.'
+  end
+
+end; end; end; end
+
+if __FILE__ == $PROGRAM_NAME
+  BackupParadise::GUI::UniversalWidgets::SimpleBackupWidget.new(ARGV)
+end # backupwidget