rbt 0.11.118 → 0.13.42

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

@@ -2,23 +2,30 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-# === RBT::GUI::Gtk::RecipeMaker
+# === RBT::GUI::UniversalWidgets::RecipeMaker
 #
 # This class shall provide a ruby-gtk3 interface to the create-a-cookbook
 # functionality of the RBT project.
+#
+# Usage example:
+#
+#   RBT::GUI::UniversalWidgets::RecipeMaker.new(ARGV)
+#
 # =========================================================================== #
-# require 'rbt/gui/gtk3/recipe_maker/recipe_maker.rb'
-# RBT::GUI::Gtk::RecipeMaker.new(ARGV)
+# require 'rbt/gui/universal_widgets/recipe_maker/recipe_maker.rb'
 # =========================================================================== #
-require 'gtk_paradise/require_gtk3'
+require 'rbt/base/base.rb'
 
 module RBT
 
 module GUI
 
-module Gtk
+module UniversalWidgets
+
+class RecipeMaker < ::RBT::Base # === RBT::GUI::UniversalWidgets::RecipeMaker
 
-class RecipeMaker < ::Gtk::Box # === RBT::GUI::Gtk::RecipeMaker
+  require 'universal_widgets/base_module/base_module.rb'
+  include ::UniversalWidgets::BaseModule
 
   require 'rbt/toplevel_methods/author_name.rb'
   require 'rbt/toplevel_methods/misc.rb'
@@ -26,9 +33,6 @@ class RecipeMaker < ::Gtk::Box # === RBT::GUI::Gtk::RecipeMaker
   require 'rbt/requires/require_the_cookbook_class.rb'
   require 'rbt/utility_scripts/url.rb'
 
-  require 'gtk_paradise/requires/require_the_base_module.rb'
-  include ::Gtk::BaseModule
-
   begin
     require 'cliner/module'
   rescue LoadError; end
@@ -37,6 +41,12 @@ class RecipeMaker < ::Gtk::Box # === RBT::GUI::Gtk::RecipeMaker
     require 'wget'
   rescue LoadError; end
 
+  # ========================================================================= #
+  # === USE_THESE_CSS_RULES
+  # ========================================================================= #
+  USE_THESE_CSS_RULES = '
+  '
+
   # ========================================================================= #
   # === TITLE
   # ========================================================================= #
@@ -45,17 +55,41 @@ class RecipeMaker < ::Gtk::Box # === RBT::GUI::Gtk::RecipeMaker
   # ========================================================================= #
   # === WIDTH
   # ========================================================================= #
-  WIDTH = 1500
+  WIDTH = '82% or minimum 1280px'
 
   # ========================================================================= #
   # === HEIGHT
   # ========================================================================= #
-  HEIGHT = 880
+  HEIGHT = '40% or minimum 300px'
+
+  # ========================================================================= #
+  # === RBT::GUI::Gtk::RecipeMaker.height?
+  # ========================================================================= #
+  def self.height?
+    HEIGHT
+  end
+
+  # ========================================================================= #
+  # === RBT::GUI::Gtk::RecipeMaker.width?
+  # ========================================================================= #
+  def self.width?
+    WIDTH
+  end
 
   # ========================================================================= #
   # === USE_THIS_FONT
   # ========================================================================= #
-  USE_THIS_FONT = :hack_20
+  USE_THIS_FONT = :dejavu_condensed_20 # or :hack_20
+
+  # ========================================================================= #
+  # === LARGER_FONT
+  # ========================================================================= #
+  LARGER_FONT   = :dejavu_condensed_22
+
+  # ========================================================================= #
+  # === SMALLER_FONT
+  # ========================================================================= #
+  SMALLER_FONT  = :dejavu_condensed_18
 
   # ========================================================================= #
   # === GUESS_NAME
@@ -113,17 +147,23 @@ class RecipeMaker < ::Gtk::Box # === RBT::GUI::Gtk::RecipeMaker
 
   # ========================================================================= #
   # === initialize
+  #
+  # The second argument is the text which can be shown on the
+  # compile-button. The default text is 'Compile'. The reason why
+  # this option exists is because we may want to have this widget
+  # 'Install' rather than 'Compile' sometimes.
   # ========================================================================= #
   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_border_width(0)
     set_commandline_arguments(
       commandline_arguments
     )
+    on_delete_event_quit_the_application
     run if run_already
   end
 
@@ -131,258 +171,101 @@ class RecipeMaker < ::Gtk::Box # === RBT::GUI::Gtk::RecipeMaker
   # === 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
 
   # ========================================================================= #
-  # === padding?
-  # ========================================================================= #
-  def padding?
-    4
-  end
-
-  # ========================================================================= #
-  # === border_size?
-  # ========================================================================= #
-  def border_size?
-    0
-  end
-
+  # === favicon?
   # ========================================================================= #
-  # === create_skeleton                                          (create tag)
-  # ========================================================================= #
-  def create_skeleton
-    create_the_buttons
-    create_text_buffer
+  def favicon?
+    :tabble
   end
 
   # ========================================================================= #
-  # === RBT::GUI::Gtk::RecipeMaker.height?
+  # === smaller_font?
   # ========================================================================= #
-  def self.height?
-    HEIGHT
+  def smaller_font?
+    SMALLER_FONT
   end
 
   # ========================================================================= #
-  # === RBT::GUI::Gtk::RecipeMaker.width?
+  # === handle_CSS_rules                                            (CSS tag)
   # ========================================================================= #
-  def self.width?
-    WIDTH
+  def handle_CSS_rules
+    use_gtk_paradise_project_css_file
+    append_project_css_file
+    more_CSS_then_apply_it(USE_THESE_CSS_RULES)
   end
 
   # ========================================================================= #
-  # === create_a_new_gtk_about_dialog
+  # === reset_the_shared_module
   #
-  # This creates our about dialog.
-  # ========================================================================= #
-  def create_a_new_gtk_about_dialog
-    @about_dialog = gtk_about_dialog
-    @about_dialog.artists = [ AUTHOR_NAME ]
-    @about_dialog.authors = [ AUTHOR_NAME ]
-    @about_dialog.comments = 'This Script creates recipe information '\
-      'which will be stored in sources.yaml'
-    @about_dialog.copyright = 'None'
-    @about_dialog.documenters = ['']
-    @about_dialog.license = 'This program is licenced under the same license '\
-      'as Ruby. There is one additional license part - which simply '\
-      'encourages you to send bug reports to '\
-      'me so that I can improve the program. ;-)'
-    @about_dialog.name = 'Ruby::Gtk::ReciperMaker'
-    # @about_dialog.translator_credits = "Here you can insert the credits of the translator.\n"
-    @about_dialog.version = VERSION_RECIPE_MAKER
-    @about_dialog.website = 'https://rubygems.org/gems/rbt'
-    @about_dialog.website_label = 'RBT on rubygems.org'
-    _ = ENV['IMG'].to_s+'/STD/UHR.png'
-    if File.exist? _
-      @about_dialog.logo = GdkPixbuf::Pixbuf.new(file: _)
-    end
-    @about_dialog.popup
-  end
-  
-  # ========================================================================= #
-  # === do_open_a_local_recipe                                     (open tag)
-  # ========================================================================= #
-  def do_open_a_local_recipe
-    create_a_new_file_chooser_dialog(self) {{
-      start_dir:              ::RBT.project_base_directory?+'yaml/cookbooks/',
-      additional_directories: ::RBT.project_base_directory?+'yaml/cookbooks/'
-    }}
-    _ = ::Gtk.main_file?
-    if _ and File.exist?(_)
-      @entry_name_of_the_program.set_text(File.basename(_).delete_suffix('.yml'))
-      do_assign_data_from_this_program
-    end
-  end
-
-  # ========================================================================= #
-  # === connect_skeleton                                        (connect tag)
-  # ========================================================================= #
-  def connect_skeleton
-    abort_on_exception
-    _ = default_top_bar
-    _.title = 'Recipe maker - create a new .yml file, a recipe'
-    _.css_class('pad0px')
-    # ======================================================================= #
-    # === Create the open-file-button
-    # ======================================================================= #
-    @button_open_file = button('Open File')
-    @button_open_file.bblack1
-    @button_open_file.hint = 'Click on this button in order to '\
-                             'select a local .cfdg file to open.'
-    @button_open_file.on_clicked {
-      do_open_a_local_recipe
-    }
-    _.pack_start(@button_open_file)
-    # ======================================================================= #
-    # Add the about-dialog next.
-    # ======================================================================= #
-    button_about_dialog = button('About')
-    button_about_dialog.bblack1
-    button_about_dialog.on_clicked {
-      create_a_new_gtk_about_dialog
-    }
-    _.pack_end(button_about_dialog)
-    minimal(_)
-    hbox_for_the_name_of_the_program = gtk_hbox
-    hbox_for_the_name_of_the_program.minimal(
-      text('Input the name of the program:', 2)
-    )
-    @entry_name_of_the_program = entry('htop')
-    @entry_name_of_the_program.default_entry
-    @entry_name_of_the_program.pad8px
-    @entry_name_of_the_program.on_click_select_everything
-    @entry_name_of_the_program.width_height(250, 50)
-    @entry_name_of_the_program.center
-    # @entry_name_of_the_program.set_completion(
-    #   ARRAY_AVAILABLE_PROGRAMS
-    # ) if @entry_name_of_the_program.respond_to? :set_completion
-    @entry_name_of_the_program.do_focus
-    @entry_name_of_the_program.on_enter {
-      do_assign_data_from_this_program
-    }
-    hbox_for_the_name_of_the_program.minimal(@entry_name_of_the_program, 2)
-    # === button_assign_data_to_the_buffer
-    button_assign_data_to_the_buffer = button('_Assign')
-    button_assign_data_to_the_buffer.hint = 'Click this button in '\
-      'order to assign to the text view below this widget. Note that '\
-      'this will only work if that program is registered in the '\
-      'RBT project.'
-    button_assign_data_to_the_buffer.bblack1
-    button_assign_data_to_the_buffer.on_clicked {
-      do_assign_data_from_this_program(@entry_name_of_the_program.text?)
-    }
-    hbox_for_the_name_of_the_program.minimal(button_assign_data_to_the_buffer, 2)
-    hbox_for_the_name_of_the_program.minimal(@button_clear, 2)
-    hbox_for_the_name_of_the_program.minimal(@button_traditional, 2)
-    hbox_for_the_name_of_the_program.minimal(@button_download, 2)
-    hbox_for_the_name_of_the_program.minimal(@button_save, 2)
-
-    minimal(hbox_for_the_name_of_the_program, 4)
-    minimal(@outermost_vbox, 1)
-  end
-
-  # ========================================================================= #
-  # === main_buffer?
+  # This method can be used for ruby-gtk3 and ruby-libui, among other
+  # toolkits.
   # ========================================================================= #
-  def main_buffer?
-    @text_buffer
+  def reset_the_shared_module
   end
 
   # ========================================================================= #
-  # === colourize_the_buffer
-  #
-  # This method will colourize the buffer at hand.
+  # === padding?
   # ========================================================================= #
-  def colourize_the_buffer
-    _ = @text_buffer.text?
-    @text_buffer.clear
-    iter = @text_buffer.start_iter
-    _.split(N).each { |line|
-      case line
-      when /^ last_update:/i
-        @text_buffer.insert(iter, line+N,tags: ['bold','tomato'])
-      # ===================================================================== #
-      # === name:
-      # ===================================================================== #
-      when /name:$/,
-           /^#{program_name?}:$/
-        @text_buffer.insert(iter, line+N,tags: ['bold','seagreen'])
-      # ===================================================================== #
-      # === program_name
-      # ===================================================================== #
-      when /program_name/
-        @text_buffer.insert(iter, line+N,tags: ['bold','darkblue'])
-      # ===================================================================== #
-      # === description
-      # ===================================================================== #
-      when /description/
-        @text_buffer.insert(iter, line+N,tags: ['bold','darkgreen'])
-      # ===================================================================== #
-      # === required_deps
-      # ===================================================================== #
-      when /required_deps/
-        @text_buffer.insert(iter, line+N,tags: ['bold','slateblue'])
-      # ===================================================================== #
-      # === true
-      # ===================================================================== #
-      when /true/, / t$/
-        line.gsub!(/ true/,'')
-        line.gsub!(/ t$/,'') if line =~ / t$/
-        @text_buffer.insert(iter, line)
-        @text_buffer.insert(iter, ' yes'+N, tags: ['bold','red'])
-      # ===================================================================== #
-      # === false
-      # ===================================================================== #
-      when /false/, / f$/
-        line.gsub!(/ false/,'')
-        line.gsub!(/ f$/,'') if line =~ / f$/
-        @text_buffer.insert(iter, line)
-        @text_buffer.insert(iter, ' no'+N, tags: ['bold','red'])
-      else
-        @text_buffer.insert(iter, line+N)
-      end
-    }
+  def padding?
+    0
   end
 
   # ========================================================================= #
-  # === main_text_view?
+  # === border_size?
   # ========================================================================= #
-  def main_text_view?
-    @text_view
+  def border_size?
+    2
   end
 
+  require 'rbt/toplevel_methods/save_file.rb'
   # ========================================================================= #
-  # === run                                                         (run tag)
-  # ========================================================================= #
-  def run
-    super()
-    do_process_the_commandline_arguments
-    cd(RBT.log_directory) # Must navigate to a "safe directory".
-    Thread.new {
-      sleep 0.1
-      do_assign_data_from_this_program
-    }
+  # === do_save_the_buffer                                        (save tag)
+  # ========================================================================= # 
+  def do_save_the_buffer(
+      what = main_buffer?.text.to_s
+    )
+    into = RBT.log_directory?+
+           main_entry?.text.to_s+'.yml'
+    e "Saving into `#{into}`."
+    RBT.write_what_into(what, into)
+    return into
   end
 
   # ========================================================================= #
-  # === do_process_the_commandline_arguments
-  #
-  # For now the first argument given is assumed to be a program.
+  # === do_assign_data_from_this_program
   # ========================================================================= #
-  def do_process_the_commandline_arguments
-    _ = commandline_arguments?
-    if _ and !_.empty?
-      set_handle_this_program(_.first)
+  def do_assign_data_from_this_program(
+      this_program = @entry_name_of_the_program.text?
+    )
+    # ======================================================================= #
+    # We have to check whether the program is included in RBT or
+    # whether it is not.
+    # ======================================================================= #
+    if ::RBT.is_this_program_included?(this_program)
+      mass_append(return_hash_from_sanitize_cookbook(this_program))
+    else
+      e "The program `#{this_program}` is not included."
     end
-  end
+  end; alias update_the_main_buffer do_assign_data_from_this_program # === update_the_main_buffer
 
   # ========================================================================= #
   # === main_entry?
@@ -521,12 +404,273 @@ class RecipeMaker < ::Gtk::Box # === RBT::GUI::Gtk::RecipeMaker
   # This will, by default, append via a newline. See the second argument
   # to this method.
   # ========================================================================= #
-  def append(i, append_this_string = "\n")
+  def append(
+      i,
+      append_this_string = "\n"
+    )
     @text_buffer.append(
       "#{i}#{append_this_string}"
     )
   end
 
+  # ========================================================================= #
+  # === do_process_the_commandline_arguments
+  #
+  # For now the first argument given is assumed to be a program.
+  # ========================================================================= #
+  def do_process_the_commandline_arguments
+    _ = commandline_arguments?
+    if _ and !_.empty?
+      set_handle_this_program(_.first)
+    end
+  end
+
+  # ========================================================================= #
+  # === main_buffer?
+  # ========================================================================= #
+  def main_buffer?
+    @text_buffer
+  end
+
+  # ========================================================================= #
+  # === colourize_the_buffer
+  #
+  # This method will colourize the buffer at hand.
+  # ========================================================================= #
+  def colourize_the_buffer
+    _ = @text_buffer.text?
+    @text_buffer.clear
+    iter = @text_buffer.start_iter
+    _.split(N).each { |line|
+      case line
+      when /^ last_update:/i
+        @text_buffer.insert(iter, line+N,tags: ['bold','tomato'])
+      # ===================================================================== #
+      # === name:
+      # ===================================================================== #
+      when /name:$/,
+           /^#{program_name?}:$/
+        @text_buffer.insert(iter, line+N,tags: ['bold','seagreen'])
+      # ===================================================================== #
+      # === program_name
+      # ===================================================================== #
+      when /program_name/
+        @text_buffer.insert(iter, line+N,tags: ['bold','darkblue'])
+      # ===================================================================== #
+      # === description
+      # ===================================================================== #
+      when /description/
+        @text_buffer.insert(iter, line+N,tags: ['bold','darkgreen'])
+      # ===================================================================== #
+      # === required_deps
+      # ===================================================================== #
+      when /required_deps/
+        @text_buffer.insert(iter, line+N,tags: ['bold','slateblue'])
+      # ===================================================================== #
+      # === true
+      # ===================================================================== #
+      when /true/, / t$/
+        line.gsub!(/ true/,'')
+        line.gsub!(/ t$/,'') if line =~ / t$/
+        @text_buffer.insert(iter, line)
+        @text_buffer.insert(iter, ' yes'+N, tags: ['bold','red'])
+      # ===================================================================== #
+      # === false
+      # ===================================================================== #
+      when /false/, / f$/
+        line.gsub!(/ false/,'')
+        line.gsub!(/ f$/,'') if line =~ / f$/
+        @text_buffer.insert(iter, line)
+        @text_buffer.insert(iter, ' no'+N, tags: ['bold','red'])
+      else
+        @text_buffer.insert(iter, line+N)
+      end
+    }
+  end
+
+  # ========================================================================= #
+  # === main_text_view?
+  # ========================================================================= #
+  def main_text_view?
+    @text_view
+  end
+
+  # ========================================================================= #
+  # === create_the_skeleton                        (create tag, skeleton tag)
+  # ========================================================================= #
+  def create_the_skeleton
+    create_the_buttons
+    create_the_text_buffer
+  end
+
+  # ========================================================================= #
+  # === create_a_new_about_dialog
+  #
+  # This creates our about dialog.
+  # ========================================================================= #
+  def create_a_new_about_dialog
+    @about_dialog = gtk_about_dialog
+    @about_dialog.artists = [ AUTHOR_NAME ]
+    @about_dialog.authors = [ AUTHOR_NAME ]
+    @about_dialog.comments = 'This Script creates recipe information '\
+      'which will be stored in sources.yaml'
+    @about_dialog.copyright = 'None'
+    @about_dialog.documenters = ['']
+    @about_dialog.license = 'This program is licenced under the same license '\
+      'as Ruby. There is one additional license part - which simply '\
+      'encourages you to send bug reports to '\
+      'me so that I can improve the program. ;-)'
+    @about_dialog.name = 'Ruby::Gtk::ReciperMaker'
+    # @about_dialog.translator_credits = "Here you can insert the credits of the translator.\n"
+    @about_dialog.version = VERSION_RECIPE_MAKER
+    @about_dialog.website = 'https://rubygems.org/gems/rbt'
+    @about_dialog.website_label = 'RBT on rubygems.org'
+    _ = ENV['IMG'].to_s+'/STD/UHR.png'
+    if File.exist? _
+      @about_dialog.logo = GdkPixbuf::Pixbuf.new(file: _)
+    end
+    @about_dialog.popup
+  end
+  
+  # ========================================================================= #
+  # === do_open_a_local_recipe                                     (open tag)
+  # ========================================================================= #
+  def do_open_a_local_recipe
+    create_a_new_file_chooser_dialog(self) {{
+      start_dir:              ::RBT.project_base_directory?+'yaml/cookbooks/',
+      additional_directories: ::RBT.project_base_directory?+'yaml/cookbooks/'
+    }}
+    _ = ::Gtk.main_file?
+    if _ and File.exist?(_)
+      @entry_name_of_the_program.set_text(File.basename(_).delete_suffix('.yml'))
+      do_assign_data_from_this_program
+    end
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    run_super
+  end
+
+  # ========================================================================= #
+  # === connect_the_skeleton                                    (connect tag)
+  # ========================================================================= #
+  def connect_the_skeleton
+    abort_on_exception
+
+    outer_vbox = create_vbox # A new vbox.
+
+    _ = default_top_bar
+    _.title = 'Recipe maker - create a new .yml file, a recipe'
+    _.css_class('pad0px')
+    # ======================================================================= #
+    # === Create the open-file-button
+    # ======================================================================= #
+    @button_open_file = create_button('Open File')
+    @button_open_file.bblack1
+    @button_open_file.hint = 'Click on this button in order to '\
+                             'select a local .cfdg file to open.'
+    @button_open_file.on_clicked {
+      do_open_a_local_recipe
+    }
+    _.pack_start(@button_open_file)
+    # ======================================================================= #
+    # Add the about-dialog next.
+    # ======================================================================= #
+    button_about_dialog = button('About')
+    button_about_dialog.bblack1
+    button_about_dialog.on_clicked {
+      create_a_new_about_dialog
+    }
+    _.pack_end(button_about_dialog)
+    outer_vbox.minimal(_)
+    hbox_for_the_name_of_the_program = create_hbox
+    hbox_for_the_name_of_the_program.minimal(
+      text('Input the name of the program:', 2)
+    )
+    @entry_name_of_the_program = entry('htop')
+    @entry_name_of_the_program.default_entry
+    @entry_name_of_the_program.pad8px
+    @entry_name_of_the_program.on_click_select_everything
+    @entry_name_of_the_program.width_height(250, 50)
+    @entry_name_of_the_program.center
+    # @entry_name_of_the_program.set_completion(
+    #   ARRAY_AVAILABLE_PROGRAMS
+    # ) if @entry_name_of_the_program.respond_to? :set_completion
+    @entry_name_of_the_program.do_focus
+    @entry_name_of_the_program.on_enter {
+      do_assign_data_from_this_program
+    }
+    hbox_for_the_name_of_the_program.minimal(@entry_name_of_the_program, 2)
+    # === button_assign_data_to_the_buffer
+    button_assign_data_to_the_buffer = button('_Assign')
+    button_assign_data_to_the_buffer.hint = 'Click this button in '\
+      'order to assign to the text view below this widget. Note that '\
+      'this will only work if that program is registered in the '\
+      'RBT project.'
+    button_assign_data_to_the_buffer.bblack1
+    button_assign_data_to_the_buffer.on_clicked {
+      do_assign_data_from_this_program(@entry_name_of_the_program.text?)
+    }
+    hbox_for_the_name_of_the_program.minimal(button_assign_data_to_the_buffer, 2)
+    hbox_for_the_name_of_the_program.minimal(@button_clear, 2)
+    hbox_for_the_name_of_the_program.minimal(@button_traditional, 2)
+    hbox_for_the_name_of_the_program.minimal(@button_download, 2)
+    hbox_for_the_name_of_the_program.minimal(@button_save, 2)
+
+    outer_vbox.minimal(hbox_for_the_name_of_the_program, 4)
+    outer_vbox.minimal(@outermost_vbox, 1)
+
+    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
+
+  # ========================================================================= #
+  # === create_the_text_buffer
+  #
+  # This method will create the textedit stuff.
+  # ========================================================================= #
+  def create_the_text_buffer
+    @outermost_vbox = create_vbox
+    @text_buffer = create_text_buffer
+    if use_gtk3?
+      require 'gtk_paradise/toplevel_methods/tokenizer_and_text_buffer_tags.rb'
+      @text_buffer = ::Gtk::TextBufferTags.create_default_tags(@text_buffer)
+    end
+    @text_view = create_text_view(@text_buffer)
+    # @text_view.it_can_not_be_edited
+    @text_view.use_this_font = USE_THIS_MONOSPACED_FONT
+    hbox = create_hbox
+    _ = return_widget_with_line_numbers {{ n_lines: 40 }}
+    _.use_this_font = USE_THIS_MONOSPACED_FONT
+    hbox.minimal(_)
+    hbox.maximal(@text_view)
+
+    another_scrolled_window = create_scrolled_window(hbox) { :always }
+    another_scrolled_window.set_policy(:never, :always)
+    another_scrolled_window.bblack3
+    another_scrolled_window.width_height(720, 520)
+    another_scrolled_window.pad5px
+    @outermost_vbox.minimal(another_scrolled_window, 1)
+  end
+
   # ========================================================================= #
   # === mass_append
   #
@@ -583,62 +727,17 @@ class RecipeMaker < ::Gtk::Box # === RBT::GUI::Gtk::RecipeMaker
   end
 
   # ========================================================================= #
-  # === create_text_buffer
-  #
-  # This method will create the textedit stuff.
-  # ========================================================================= #
-  def create_text_buffer
-    @outermost_vbox = gtk_vbox
-    @text_buffer = gtk_text_buffer
-    @text_buffer = ::Gtk::TextBufferTags.create_default_tags(@text_buffer)
-    @text_view = gtk_text_view(@text_buffer)
-    # @text_view.it_can_not_be_edited
-    @text_view.use_this_font = USE_THIS_MONOSPACED_FONT
-    hbox = gtk_hbox
-    _ = return_widget_with_line_numbers {{ n_lines: 40 }}
-    _.use_this_font = USE_THIS_MONOSPACED_FONT
-    hbox.minimal(_)
-    hbox.maximal(@text_view)
-
-    another_scrolled_window = gtk_scrolled_window(hbox) { :always }
-    another_scrolled_window.set_policy(:never, :always)
-    another_scrolled_window.bblack3
-    another_scrolled_window.width_height(720, 520)
-    another_scrolled_window.css_class('pad5px')
-    @outermost_vbox.minimal(another_scrolled_window, 1)
-  end
-
-  require 'rbt/toplevel_methods/save_file.rb'
+  # === do_all_startup_related_actions
   # ========================================================================= #
-  # === do_save_the_buffer                                        (save tag)
-  # ========================================================================= # 
-  def do_save_the_buffer(
-      what = main_buffer?.text.to_s
-    )
-    into = RBT.log_directory?+
-           main_entry?.text.to_s+'.yml'
-    e "Saving into `#{into}`."
-    RBT.write_what_into(what, into)
-    return into
+  def do_all_startup_related_actions
+    do_process_the_commandline_arguments
+    cd(RBT.log_directory) # Must navigate to a "safe directory".
+    Thread.new {
+      sleep 0.1
+      do_assign_data_from_this_program
+    }
   end
 
-  # ========================================================================= #
-  # === do_assign_data_from_this_program
-  # ========================================================================= #
-  def do_assign_data_from_this_program(
-      this_program = @entry_name_of_the_program.text?
-    )
-    # ======================================================================= #
-    # We have to check whether the program is included in RBT or
-    # whether it is not.
-    # ======================================================================= #
-    if ::RBT.is_this_program_included?(this_program)
-      mass_append(return_hash_from_sanitize_cookbook(this_program))
-    else
-      e "The program `#{this_program}` is not included."
-    end
-  end; alias update_the_main_buffer do_assign_data_from_this_program # === update_the_main_buffer
-
   # ========================================================================= #
   # === RBT::GUI::Gtk::RecipeMaker.run
   # ========================================================================= #
@@ -648,16 +747,26 @@ class RecipeMaker < ::Gtk::Box # === RBT::GUI::Gtk::RecipeMaker
     require 'gtk_paradise/run'
     _ = ::RBT::GUI::Gtk::RecipeMaker.new(i)
     r = ::Gtk.run
+    _.set_parent_widget(r) # Must come before we enable the key-combinations.
     r << _
-    r.automatic_size
-    r.automatic_title
+    r.add_shortcut(1,  'focus_on_entry', :alt)
+    r.add_shortcut(:a, 'focus_on_entry', :alt)
+    r.automatic_size_then_automatic_title
     r.enable_quick_exit
-    r.resizable = true # <- This line was added due to a possible prior .maximize action.
-    r.start_in_the_middle
+    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::RecipeMaker.start_gui_application
+
+  # ========================================================================= #
+  # === RBT::GUI::UniversalWidgets::RecipeMaker[]
+  # ========================================================================= #
+  def self.[](i = ARGV)
+    new(i)
   end
 
 end; end; end; end
 
 if __FILE__ == $PROGRAM_NAME
-  RBT::GUI::Gtk::RecipeMaker.run
-end
+  RBT::GUI::UniversalWidgets::RecipeMaker.new(ARGV)
+end # gui_rbt