bioroebe 0.12.24 → 0.13.31

data/lib/bioroebe/gui/{gtk3 → universal_widgets}/controller/controller.rb

@@ -2,35 +2,39 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-# === Bioroebe::GUI::Gtk::Controller
+# === Bioroebe::GUI::UniversalWidgets::Controller
+#
+# Usage example:
+#
+#   Bioroebe::GUI::UniversalWidgets::Controller.new(ARGV)
+#
 # =========================================================================== #
-# require 'bioroebe/gui/gtk3/controller/controller.rb'
-# Bioroebe::GUI::Gtk::Controller.run
+# require 'bioroebe/gui/universal_widgets/controller/controller.rb'
 # =========================================================================== #
-require 'gtk_paradise/require_gtk3'
+require 'universal_widgets/base/base.rb'
 
 module Bioroebe
 
 module GUI
 
-module Gtk
+module UniversalWidgets
 
-class Controller < ::Gtk::Box # === Bioroebe::GUI::Gtk::Controller 
+class Controller < ::UniversalWidgets::Base # === Bioroebe::GUI::UniversalWidgets::Controller
 
-  require 'bioroebe/project/project.rb'
-  require 'bioroebe/toplevel_methods/to_camelcase.rb'
+  require 'bioroebe/base/commandline_application/commandline_arguments.rb'
+  include ::Bioroebe::CommandlineArguments
 
-  require 'gtk_paradise/requires/require_the_base_module.rb'
-  include ::Gtk::BaseModule
+  require 'bioroebe/constants/GUIs.rb'
+  include Bioroebe::GUI
 
-  # ========================================================================= #
-  # === NAMESPACE
-  # ========================================================================= #
-  NAMESPACE = inspect
+  require 'bioroebe/toplevel_methods/toplevel_methods.rb'
+  require 'bioroebe/project/project.rb'
 
   # ========================================================================= #
   # === TITLE
   #
+  # Specify which title to use for this small widget.
+  #
   # The old title before the rewrite in February 2022 was this
   # String:
   #
@@ -42,22 +46,31 @@ class Controller < ::Gtk::Box # === Bioroebe::GUI::Gtk::Controller
   # ========================================================================= #
   # === WIDTH
   # ========================================================================= #
-  WIDTH = '25% or minimum 200px'
+  WIDTH = '65% or 600px minimum'
 
   # ========================================================================= #
   # === HEIGHT
   # ========================================================================= #
-  HEIGHT = '15% or minimum 100px'
+  HEIGHT = '55% or 400px minimum'
 
   # ========================================================================= #
-  # === USE_THIS_FONT
+  # === MONOSPACED_FONT
+  #
+  # When this font is changed, don't forget to also change the font
+  # at SMALLER_FONT.
   # ========================================================================= #
-  USE_THIS_FONT = :dejavu_condensed_20
+  MONOSPACED_FONT = :hack_20
+    USE_THIS_FONT = MONOSPACED_FONT
 
   # ========================================================================= #
   # === SMALLER_FONT
   # ========================================================================= #
-  SMALLER_FONT = :dejavu_condensed_16
+  SMALLER_FONT = :hack_16
+
+  # ========================================================================= #
+  # === USE_THIS_SLIGHTLY_SMALLER_FONT
+  # ========================================================================= #
+  USE_THIS_SLIGHTLY_SMALLER_FONT = :hack_16
 
   # ========================================================================= #
   # === HASH_DESIGNATED_KEY_COMBINATIONS
@@ -79,10 +92,10 @@ class Controller < ::Gtk::Box # === Bioroebe::GUI::Gtk::Controller
   # === initialize
   # ========================================================================= #
   def initialize(
-      commandline_arguments = ARGV,
+      commandline_arguments = nil,
       run_already           = true
     )
-    super(:vertical)
+    determine_the_GUI_to_be_used(commandline_arguments)
     reset
     set_commandline_arguments(
       commandline_arguments
@@ -94,36 +107,25 @@ class Controller < ::Gtk::Box # === Bioroebe::GUI::Gtk::Controller
   # === reset                                                     (reset tag)
   # ========================================================================= #
   def reset
-    batch_require_all_relevant_gtk3_files
+    super() if respond_to?(:super)
     reset_the_internal_variables
+    reset_the_base_module # This must come after reset_the_internal_variables().
+    infer_the_namespace
     # ======================================================================= #
     # === @configuration
     # ======================================================================= #
-    @configuration = [true, __dir__, NAMESPACE]
+    @configuration = [true, __dir__, namespace?]
     # ======================================================================= #
     # === Set the title, width, height and the font in use.
     # ======================================================================= #
     title_width_height_font(TITLE, WIDTH, HEIGHT, USE_THIS_FONT)
-    do_handle_all_CSS_related_aspects 
-    infer_the_size_automatically
+    handle_CSS if use_gtk3?
     # ======================================================================= #
     # === @nucleotide_analyser
     # ======================================================================= #
     @nucleotide_analyser = NucleotideAnalyser.new
   end
 
-  # ========================================================================= #
-  # === do_handle_all_CSS_related_aspects
-  # ========================================================================= #
-  def do_handle_all_CSS_related_aspects
-    use_gtk_paradise_project_css_file
-    append_project_CSS_file
-    more_CSS 'notebook header {
-      color: green;
-      border: 2px dotted royalblue;
-    }'
-  end
-
   # ========================================================================= #
   # === padding?
   # ========================================================================= #
@@ -139,42 +141,82 @@ class Controller < ::Gtk::Box # === Bioroebe::GUI::Gtk::Controller
   end
 
   # ========================================================================= #
-  # === create_skeleton                            (create tag, skeleton tag)
+  # === main_font?
   # ========================================================================= #
-  def create_skeleton
+  def main_font?
+    USE_THIS_FONT
+  end
+
+  # ========================================================================= #
+  # === slightly_smaller_font?
+  # ========================================================================= #
+  def slightly_smaller_font?
+    USE_THIS_SLIGHTLY_SMALLER_FONT
+  end
+
+  # ========================================================================= #
+  # === handle_CSS_rules                                   (CSS tag, css tag)
+  # ========================================================================= #
+  def handle_CSS_rules
+    use_gtk_paradise_project_css_file
+    append_project_css_file
+    add_these_custom_CSS_rules '
+notebook header {
+      color: green;
+      border: 2px dotted royalblue;
+    }
+    '
+    apply_the_CSS_rules
+  end; alias handle_CSS handle_CSS_rules # === handle_CSS
+
+  # ========================================================================= #
+  # === create_the_skeleton                        (create tag, skeleton tag)
+  # ========================================================================= #
+  def create_the_skeleton
     create_the_header_bar
     create_the_notebook
   end
 
   # ========================================================================= #
-  # === create_the_notebook                                    (notebook tag)
+  # === set_aminoacid_sequence
   # ========================================================================= #
-  def create_the_notebook
+  def set_aminoacid_sequence(i)
+    i = i.to_s
+    @aminoacid_sequence = i
+    @aminoacid_composition.set_main_input_sequence_and_evaluate_it(i)
+    @protein_to_DNA.set_aminoacid_sequence(i)
+    if @protein_to_DNA.respond_to? :do_determine_the_DNA_sequence
+      @protein_to_DNA.do_determine_the_DNA_sequence
+    end
     # ======================================================================= #
-    # === @notebook
+    # Also update the nucleotide-analyser next:
     # ======================================================================= #
-    @notebook = gtk_notebook
-    @notebook.enable_popup = true
-    @notebook.use_this_font(smaller_font?)
-    @notebook.set_border_width(5)
-    @notebook.do_show_border
-    @notebook.pad8px
-    @notebook.bblack1
-    @notebook.is_scrollable
-    @notebook.position_on_top
+    @nucleotide_analyser.set_dna_sequence(
+      main_dna_sequence?.delete(' ')
+    )
   end
 
   # ========================================================================= #
-  # === create_the_header_bar                           (header tag, top tag)
+  # === main_dna_sequence?
   # ========================================================================= #
-  def create_the_header_bar
-    # ======================================================================= #
-    # === @header_bar
-    # ======================================================================= #
-    @header_bar = default_header_bar
-    @header_bar.pad8px
-    _ = selectable_text(' 🐟  Controller  🐟 ')
-    @header_bar.central_element(_)
+  def main_dna_sequence?
+    @dna_to_aminoacid_widget.dna_sequence?
+  end; alias main_DNA_sequence? main_dna_sequence? # === main_DNA_sequence?
+
+  # ========================================================================= #
+  # === focus_on_tab
+  # ========================================================================= #
+  def focus_on_tab(
+      number = 1
+    )
+    @notebook.focus_on_tab(number.to_i - 1)
+  end; alias key_pressed focus_on_tab # === key_pressed
+
+  # ========================================================================= #
+  # === smaller_font?
+  # ========================================================================= #
+  def smaller_font?
+    SMALLER_FONT
   end
 
   # ========================================================================= #
@@ -228,10 +270,49 @@ class Controller < ::Gtk::Box # === Bioroebe::GUI::Gtk::Controller
   end
 
   # ========================================================================= #
-  # === connect_skeleton                                        (connect tag)
+  # === create_the_header_bar                           (header tag, top tag)
   # ========================================================================= #
-  def connect_skeleton
+  def create_the_header_bar
+    # ======================================================================= #
+    # === @header_bar
+    # ======================================================================= #
+    @header_bar = default_header_bar
+    @header_bar.pad8px
+    _ = selectable_text(' 🐟  Controller  🐟 ')
+    @header_bar.central_element(_)
+  end
+
+  # ========================================================================= #
+  # === create_the_notebook                                    (notebook tag)
+  # ========================================================================= #
+  def create_the_notebook
+    # ======================================================================= #
+    # === @notebook
+    # ======================================================================= #
+    @notebook = create_notebook
+    @notebook.enable_popup = true
+    @notebook.use_this_font(smaller_font?)
+    @notebook.set_border_width(5)
+    @notebook.do_show_border
+    @notebook.pad8px
+    @notebook.bblack1
+    @notebook.is_scrollable
+    @notebook.position_on_top
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    run_super
+  end
+
+  # ========================================================================= #
+  # === connect_the_skeleton                      (connect tag, skeleton tag)
+  # ========================================================================= #
+  def connect_the_skeleton
     abort_on_exception
+
     # ========================================================================= #
     # === DnaToAminoacidWidget
     # ========================================================================= #
@@ -335,30 +416,28 @@ class Controller < ::Gtk::Box # === Bioroebe::GUI::Gtk::Controller
     # now we will not.
     # ======================================================================= #
     draggable_one = draggable_via_up_and_down_movement(header_bar?, @notebook)
-    maximal(draggable_one)
-  end
-
-  # ========================================================================= #
-  # === focus_on_tab
-  # ========================================================================= #
-  def focus_on_tab(
-      number = 1
-    )
-    @notebook.focus_on_tab(number.to_i - 1)
-  end; alias key_pressed focus_on_tab # === key_pressed
 
-  # ========================================================================= #
-  # === smaller_font?
-  # ========================================================================= #
-  def smaller_font?
-    SMALLER_FONT
+    window = runner_widget(nil, width?, height?, title?)
+    window << draggable_one
+
+    ::UniversalWidgets.set_main_window(window)
+    upon_delete_event_quit_the_application
+    
+    window.use_this_font = font?
+    window.show_all
+    window.set_size_request(width?, height?)
+    window.set_default_size(width?, height?)
+    window.set_padding(padding?)
+    window.set_border_size(border_size?)
+    window.top_left
+    run_main
   end
 
   # ========================================================================= #
-  # === run                                                         (run tag)
+  # === Bioroebe::GUI::UniversalWidgets::Controller[]
   # ========================================================================= #
-  def run
-    super()
+  def self.[](i = ARGV)
+    new(i)
   end
 
   # ========================================================================= #
@@ -367,45 +446,17 @@ class Controller < ::Gtk::Box # === Bioroebe::GUI::Gtk::Controller
   def self.run(
       i = ARGV
     )
-    require 'gtk_paradise/app/app.rb'
-    _ = ::Bioroebe::GUI::Gtk::Controller.new(i)
-    r = ::Gtk.run
-    r << _
+    _ = ::Bioroebe::GUI::Gtk::Controller.new(i) 
+    r = ::Gtk.runner_factory(_)
+    r.background_colour :white
     r.add_accel_group(@accel_group = ::Gtk::AccelGroup.new)
     _.set_parent_widget(r)
     _.enable_these_key_combinations(
-      HASH_DESIGNATED_KEY_COMBINATIONS
+      _::HASH_DESIGNATED_KEY_COMBINATIONS
     )
-    r.enable_quick_exit
-    r.maximize
-    r.automatic_top_left_then_run
-  end
-
-  # ========================================================================= #
-  # === set_aminoacid_sequence
-  # ========================================================================= #
-  def set_aminoacid_sequence(i)
-    i = i.to_s
-    @aminoacid_sequence = i
-    @aminoacid_composition.set_main_input_sequence_and_evaluate_it(i)
-    @protein_to_DNA.set_aminoacid_sequence(i)
-    if @protein_to_DNA.respond_to? :do_determine_the_DNA_sequence
-      @protein_to_DNA.do_determine_the_DNA_sequence
-    end
-    # ======================================================================= #
-    # Also update the nucleotide-analyser next:
-    # ======================================================================= #
-    @nucleotide_analyser.set_dna_sequence(
-      main_dna_sequence?.delete(' ')
-    )
-  end
-
-  # ========================================================================= #
-  # === main_dna_sequence?
-  # ========================================================================= #
-  def main_dna_sequence?
-    @dna_to_aminoacid_widget.dna_sequence?
-  end; alias main_DNA_sequence? main_dna_sequence? # === main_DNA_sequence?
+    return r
+  end; self.instance_eval { alias run_gtk3_widget       run } # === Bioroebe::GUI::Gtk::Controller.run_gtk3_widget
+       self.instance_eval { alias start_gui_application run } # === Bioroebe::GUI::Gtk::Controller.start_gui_application
 
 end; end; end
 
@@ -419,5 +470,6 @@ end
 end
 
 if __FILE__ == $PROGRAM_NAME
-  Bioroebe.run_gtk_controller
-end
+  Bioroebe::GUI::UniversalWidgets::Controller.new(ARGV)
+  # or: Bioroebe.run_gtk_controller
+end # gtkRestrictionEnzymes