rbt 0.11.118 → 0.13.42

data/lib/rbt/gui/{gtk3 → universal_widgets}/notebook/notebook.rb

@@ -2,27 +2,31 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-# === RBT::GUI::Gtk::Notebook
+# === RBT::GUI::UniversalWidgets::Notebook
+#
+# Usage example:
+#
+#   RBT::GUI::UniversalWidgets::Notebook.new(ARGV)
+#
 # =========================================================================== #
-# require 'rbt/gui/gtk3/notebook/notebook.rb'
-# RBT::GUI::Gtk::Notebook.run
+# require 'rbt/gui/universal_widgets/installed_programs/installed_programs.rb'
 # =========================================================================== #
-require 'gtk_paradise/require_gtk3'
+require 'rbt/base/base.rb'
 
 module RBT
 
 module GUI
 
-module Gtk
+module UniversalWidgets
 
-class Notebook < ::Gtk::Box
+class Notebook < ::RBT::Base # === RBT::GUI::UniversalWidgets::Notebook
+
+  require 'universal_widgets/base_module/base_module.rb'
+  include ::UniversalWidgets::BaseModule
 
   require 'rbt/requires/require_the_installer_class.rb'
   require 'rbt/toplevel_methods/infer_build_system.rb'
-  require 'rbt/gui/gtk3/compile_program/compile_program.rb'
-  require 'rbt/gui/gtk3/notebook/connect_skeleton.rb'
-
-  include ::Gtk::BaseModule
+  require 'rbt/gui/universal_widgets/compile_program/compile_program.rb'
 
   # ========================================================================= #
   # === HASH_DESIGNATED_KEY_COMBINATIONS
@@ -35,6 +39,12 @@ class Notebook < ::Gtk::Box
     'alt+5': 'focus_on_this_tab(4)'
   }
 
+  # ========================================================================= #
+  # === USE_THESE_CSS_RULES
+  # ========================================================================= #
+  USE_THESE_CSS_RULES = '
+  '
+
   # ========================================================================= #
   # === TITLE
   # ========================================================================= #
@@ -43,30 +53,47 @@ class Notebook < ::Gtk::Box
   # ========================================================================= #
   # === WIDTH
   # ========================================================================= #
-  WIDTH = 1200
+  WIDTH = '82% or minimum 1280px'
 
   # ========================================================================= #
   # === HEIGHT
   # ========================================================================= #
-  HEIGHT = 500
+  HEIGHT = '40% or minimum 800px'
 
   # ========================================================================= #
   # === USE_THIS_FONT
   # ========================================================================= #
   USE_THIS_FONT = :dejavu_condensed_19
 
+  # ========================================================================= #
+  # === LARGER_FONT
+  # ========================================================================= #
+  LARGER_FONT   = :dejavu_condensed_22
+
+  # ========================================================================= #
+  # === 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
+      commandline_arguments       = ARGV,
+      run_already                 = true
     )
-    super(:vertical)
+    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
     run if run_already
   end
 
@@ -74,15 +101,55 @@ class Notebook < ::Gtk::Box
   # === 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)
-    use_gtk_paradise_project_css_file  
+    if use_gtk3?
+      handle_CSS_rules
+    end
     infer_the_size_automatically
+  end
+
+  # ========================================================================= #
+  # === favicon?
+  # ========================================================================= #
+  def favicon?
+    :tabble
+  end
+
+  # ========================================================================= #
+  # === smaller_font?
+  # ========================================================================= #
+  def smaller_font?
+    SMALLER_FONT
+  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
     # ======================================================================= #
     # === @array_available_programs
     # ======================================================================= #
@@ -106,6 +173,25 @@ class Notebook < ::Gtk::Box
     0
   end
 
+  require 'rbt/toplevel_methods/report_total_size_of_all_archives.rb'
+  # ========================================================================= #
+  # === do_update_stuff
+  # ========================================================================= #
+  def do_update_stuff
+    total_size = RBT.return_total_size_of_all_archives
+    _n_kilobytes = total_size  / 1024.0
+    _n_megabytes = _n_kilobytes / 1024.0
+    n_gigabytes  = _n_megabytes / 1024.0
+    
+    @label_total_size_of_all_archives.set_text(
+      'All local archives amount to a total size of <b>'+
+      n_gigabytes.round(3).to_s+
+      ' GB</b>.'
+    )
+    @label_total_size_of_all_archives.do_markify
+    @label_total_size_of_all_archives.left_align
+  end
+
   # ========================================================================= #
   # === focus_on_this_tab
   # ========================================================================= #
@@ -114,68 +200,33 @@ class Notebook < ::Gtk::Box
   end
 
   # ========================================================================= #
-  # === create_skeleton                                          (create tag)
+  # === return_widget_containing_package_related_components
+  #
+  # This is the widget for dealing with packages (creating or
+  # installing packages).
   # ========================================================================= #
-  def create_skeleton
-    # ======================================================================= #
-    # === @notebook
-    # ======================================================================= #
-    @notebook = notebook
-    @notebook.allow_scrolling
+  def return_widget_containing_package_related_components
+    vbox = create_vbox
+    vbox.set_border_width(2)
+    vbox.add(create_radio_button)
+    vbox.add(create_radio_button)
+    vbox.add(create_text('This is incomplete.'))
+    return vbox
   end
 
+  require 'rbt/toplevel_methods/available_programs.rb'
   # ========================================================================= #
-  # === return_widget_containing_compile_related_components
+  # === return_the_combo_box_containing_all_available_programs
   # ========================================================================= #
-  def return_widget_containing_compile_related_components
-    vbox = gtk_vbox
-    vbox.set_border_width(2)
-
-    hbox1 = gtk_hbox
-    hbox1 << text('Compile this program')
-    @entry_compile_this_program = entry('php') # Or: gtk_entry_completion(@array_available_programs)
-    @entry_compile_this_program.on_click_select_everything
-    @entry_compile_this_program.bblack1
-    @entry_compile_this_program.on_enter {
-      do_compile_this_program(@entry_compile_this_program.text?)
-    }
-    hbox1.maximal(@entry_compile_this_program, 1)
-    hbox1.maximal(return_the_combo_box_containing_all_available_programs, 1)
-    vbox.minimal(hbox1)
-
-    hbox2 = hbox
-    hbox2 << text('Program path:')
-    @entry_program_path = entry
-    @entry_program_path.bblack1
-    @entry_program_path.disallow_changes
-    hbox2.maximal(@entry_program_path, 1)
-    vbox.minimal(hbox2, 1)
-
-    hbox3 = hbox
-    hbox3 << text('Prefix to use:')
-    @entry_prefix_to_use = entry('/usr/')
-    @entry_prefix_to_use.bblack1
-    hbox3.maximal(@entry_prefix_to_use, 1)
-    vbox.minimal(hbox3, 1)
-
-    hbox4 = hbox
-    hbox4 << text('Inferred build type:')
-    @entry_inferred_build_type = gtk_entry
-    @entry_inferred_build_type.bblack1
-    hbox4.maximal(@entry_inferred_build_type, 1)
-    vbox.minimal(hbox4, 1)
-
-    @compile_button = button('Compile the program')
-    @compile_button.bblack1
-    @compile_button.hint = 'Click this button to '\
-      'compile the program.'
-    @compile_button.on_clicked {
-      do_compile_the_program
+  def return_the_combo_box_containing_all_available_programs
+    array = @array_available_programs
+    _ = create_combo_box_text(array[0 ... 751]) { :first_element_is_active }
+    _.use_this_font = :hack_15
+    _.on_changed {
+      set_compile_this_program(_.active_text?.to_s)
     }
-    vbox.minimal(@compile_button, 1)
-    @text_status = gtk_text
-    vbox.minimal(@text_status, 1)
-    return vbox
+    _.bblack1
+    return _
   end
 
   # ========================================================================= #
@@ -230,12 +281,12 @@ class Notebook < ::Gtk::Box
   # === return_widget_containing_statistical_information
   # ========================================================================= #
   def return_widget_containing_statistical_information
-    vbox = gtk_vbox
+    vbox = create_vbox
     vbox.set_border_width(2)
     @label_total_size_of_all_archives = label
     @label_total_size_of_all_archives.make_selectable
 
-    label_n_programs_are_registered = gtk_markified_text(
+    label_n_programs_are_registered = markified_text(
       "There are a total of <b>#{RBT.available_programs?.size}</b> "\
       "programs available in the RBT project."
     )
@@ -247,63 +298,135 @@ class Notebook < ::Gtk::Box
   end
 
   # ========================================================================= #
-  # === return_widget_containing_package_related_components
-  #
-  # This is the widget for dealing with packages (creating or
-  # installing packages).
+  # === return_widget_containing_compile_related_components
   # ========================================================================= #
-  def return_widget_containing_package_related_components
-    vbox = gtk_vbox
+  def return_widget_containing_compile_related_components
+    vbox = create_vbox
     vbox.set_border_width(2)
-    vbox.add(gtk_radio_button)
-    vbox.add(gtk_radio_button)
-    vbox.add(gtk_text('This is incomplete.'))
+
+    hbox1 = create_hbox
+    hbox1 << text('Compile this program')
+    @entry_compile_this_program = entry('php') # Or: gtk_entry_completion(@array_available_programs)
+    @entry_compile_this_program.on_click_select_everything
+    @entry_compile_this_program.bblack1
+    @entry_compile_this_program.on_enter {
+      do_compile_this_program(@entry_compile_this_program.text?)
+    }
+    hbox1.maximal(@entry_compile_this_program, 1)
+    hbox1.maximal(return_the_combo_box_containing_all_available_programs, 1)
+    vbox.minimal(hbox1)
+
+    hbox2 = createhbox
+    hbox2 << text('Program path:')
+    @entry_program_path = createentry
+    @entry_program_path.bblack1
+    @entry_program_path.disallow_changes
+    hbox2.maximal(@entry_program_path, 1)
+    vbox.minimal(hbox2, 1)
+
+    hbox3 = createhbox
+    hbox3 << text('Prefix to use:')
+    @entry_prefix_to_use = createentry('/usr/')
+    @entry_prefix_to_use.bblack1
+    hbox3.maximal(@entry_prefix_to_use, 1)
+    vbox.minimal(hbox3, 1)
+
+    hbox4 = hbox
+    hbox4 << text('Inferred build type:')
+    @entry_inferred_build_type = create_entry
+    @entry_inferred_build_type.bblack1
+    hbox4.maximal(@entry_inferred_build_type, 1)
+    vbox.minimal(hbox4, 1)
+
+    @compile_button = button('Compile the program')
+    @compile_button.bblack1
+    @compile_button.hint = 'Click this button to '\
+      'compile the program.'
+    @compile_button.on_clicked {
+      do_compile_the_program
+    }
+    vbox.minimal(@compile_button, 1)
+    @text_status = create_text
+    vbox.minimal(@text_status, 1)
     return vbox
   end
 
-  require 'rbt/toplevel_methods/available_programs.rb'
   # ========================================================================= #
-  # === return_the_combo_box_containing_all_available_programs
+  # === create_the_skeleton                        (create tag, skeleton tag)
   # ========================================================================= #
-  def return_the_combo_box_containing_all_available_programs
-    array = @array_available_programs
-    _ = gtk_combo_box_text(array[0 ... 751]) { :first_element_is_active }
-    _.use_this_font = :hack_15
-    _.on_changed {
-      set_compile_this_program(_.active_text?.to_s)
-    }
-    _.bblack1
-    return _
+  def create_the_skeleton
+    # ======================================================================= #
+    # === @notebook
+    # ======================================================================= #
+    @notebook = create_notebook
+    @notebook.allow_scrolling
   end
 
-  require 'rbt/toplevel_methods/report_total_size_of_all_archives.rb'
   # ========================================================================= #
-  # === do_update_stuff
+  # === run                                                         (run tag)
   # ========================================================================= #
-  def do_update_stuff
-    total_size = RBT.return_total_size_of_all_archives
-    _n_kilobytes = total_size  / 1024.0
-    _n_megabytes = _n_kilobytes / 1024.0
-    n_gigabytes = _n_megabytes / 1024.0
-    
-    @label_total_size_of_all_archives.set_text(
-      'All local archives amount to a total size of <b>'+
-      n_gigabytes.round(3).to_s+
-      ' GB</b>.'
-    )
-    @label_total_size_of_all_archives.do_markify
-    @label_total_size_of_all_archives.left_align
+  def run
+    run_super
   end
 
   # ========================================================================= #
-  # === run                                                         (run tag)
+  # === connect_the_skeleton                                    (connect tag)
   # ========================================================================= #
-  def run
-    create_skeleton_then_connect_skeleton
-    Thread.new {
-      sleep 0.5
-      do_update_stuff
-    }
+  def connect_the_skeleton
+    abort_on_exception
+
+    outer_vbox = create_vbox # A new vbox.
+
+    @notebook = create_notebook(:useful_defaults)
+    @notebook.append_this_widget(
+      return_widget_containing_compile_related_components,
+      'Compile a program'
+    )
+    @notebook.append_this_widget(
+      RBT::GUI::Gtk::CompileProgram.new,
+      'Compile a program (advanced widget)'
+    )
+    @notebook.append_this_widget(
+      return_widget_containing_package_related_components,
+      'Create or install packages'
+    )
+    @notebook.append_this_widget(
+      return_widget_containing_recipe_related_components,
+      'Create a new recipe'
+    )
+    # ======================================================================= #
+    # The VTE does not work very well. We may have to
+    # find a solution to this; perhaps just a custom
+    # non-vte shell or something.
+    #
+    #   @notebook.append_this_widget(
+    #     return_widget_containing_vte,
+    #     'VTE'
+    #   )
+    # ======================================================================= #
+    @notebook.append_this_widget(
+      return_widget_containing_statistical_information,
+      'Statistics'
+    )
+    outer_vbox.add(@notebook)
+
+    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
 
   # ========================================================================= #
@@ -311,7 +434,7 @@ class Notebook < ::Gtk::Box
   # ========================================================================= #
   def return_widget_containing_recipe_related_components
     require 'rbt/gui/gtk3/recipe_maker/recipe_maker.rb'
-    vbox = gtk_vbox
+    vbox = create_vbox
     vbox.set_border_width(2)
     vbox.maximal(RBT::GUI::Gtk::RecipeMaker.new, 1)
     return vbox
@@ -325,6 +448,16 @@ class Notebook < ::Gtk::Box
     return ::Gtk::FlexibleVte.new {{ n_tabs: 3 }}
   end
 
+  # ========================================================================= #
+  # === do_all_startup_related_actions
+  # ========================================================================= #
+  def do_all_startup_related_actions
+    Thread.new {
+      sleep 0.3
+      do_update_stuff
+    }
+  end
+
   # ========================================================================= #
   # === RBT::GUI::Gtk::Notebook.run
   # ========================================================================= #
@@ -337,13 +470,22 @@ class Notebook < ::Gtk::Box
     r << _
     _.set_parent_widget(r)
     _.enable_these_key_combinations(HASH_DESIGNATED_KEY_COMBINATIONS)
-    r.automatic_size
-    r.automatic_title
+    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 } # === RBT::GUI::Gtk::Notebook.start_gui_application
+
+  # ========================================================================= #
+  # === RBT::GUI::UniversalWidgets::Notebook[]
+  # ========================================================================= #
+  def self.[](i = ARGV)
+    new(i)
   end
 
 end; end; end; end
 
 if __FILE__ == $PROGRAM_NAME
-  RBT::GUI::Gtk::Notebook.run
-end
+  RBT::GUI::UniversalWidgets::Notebook.new(ARGV)
+end # gui_rbt