roebe 0.5.120 → 0.5.121

data/lib/roebe/gui/libui/shell/shell.rb

@@ -0,0 +1,107 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Roebe::GUI::LibUI::Shell
+# =========================================================================== #
+module Roebe
+
+module GUI
+
+module LibUI
+
+class Shell # === LibuiParadise::GUI::LibUI::Shell
+
+  alias e puts
+
+  require 'libui_paradise'
+  include LibuiParadise::Extensions
+
+  # require 'bioroebe/gui/shared_code/levensthein_distance/levensthein_distance_module.rb'
+  # include Bioroebe::GUI::LevenstheinDistanceModule
+
+  # ========================================================================= #
+  # === TITLE
+  # ========================================================================= #
+  TITLE = 'A prototype for LibUI'
+
+  # ========================================================================= #
+  # === WIDTH
+  # ========================================================================= #
+  WIDTH = 600
+
+  # ========================================================================= #
+  # === HEIGHT
+  # ========================================================================= #
+  HEIGHT = 480
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      run_already = true
+    )
+    reset
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    title_width_height(TITLE, WIDTH, HEIGHT)
+  end
+
+  # ========================================================================= #
+  # === create_skeleton                            (create tag, skeleton tag)
+  # ========================================================================= #
+  def create_skeleton
+    # ======================================================================= #
+    # === @window
+    # ======================================================================= #
+    @window = ui_padded_main_window(title?, width?, height?, 0)
+  end
+
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run
+    create_skeleton_then_connect_skeleton
+    outer_vbox = padded_vbox
+    # ======================================================================= #
+    # First add the two buttons on top:
+    # ======================================================================= #
+    hbox_on_top = padded_hbox
+    button_refresh = ui_button('Refresh')
+    button_refresh.on_clicked {
+      e 'TODO: Refresh this...'
+    }
+    button_quit = quit_button
+    hbox_on_top.maximal(button_refresh)
+    hbox_on_top.maximal(button_quit)
+    outer_vbox.minimal(hbox_on_top)
+    outer_vbox.add_hsep
+
+    grid = ui_padded_grid
+    grid.ui_grid_append(text('Left'),  0, 0, 1, 1, 0, 0.5, 1, 0)
+    grid.ui_grid_append(text('Right'), 1, 0, 1, 1, 0, 0.5, 1, 0)
+
+    3.times.each {|index| index += 1
+      # ===================================================================== #
+      # left, top, xspan, yspan, hexpand, halign, vexpand, valign
+      #  0,    0,    2,     1,      0,      0,       1,      0
+      # ===================================================================== #
+      grid.ui_grid_append(text(index.to_s), 0, 1+index, 1, 1, 1, 1, 1, 1)
+      label_exam_topic = text(entry.to_s)
+      grid.ui_grid_append(label_exam_topic, 1, 1+index, 1, 1, 1, 1, 1, 1)
+    }
+    outer_vbox.maximal(grid)
+    @window.add(outer_vbox)
+    @window.intelligent_exit
+  end
+
+end; end; end; end
+
+if __FILE__ == $PROGRAM_NAME
+  Roebe::GUI::LibUI::Shell.new  
+end

data/lib/roebe/gui/shared_code/shell/shell_module.rb

@@ -1,601 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# === Roebe::GUI::Gtk::ShellModule
-#
-# This specialized widgets tries to leverage the power of the
-# Roebe::Shell in a graphical manner.
-# =========================================================================== #
-# require 'roebe/gui/shared_code/shell/shell_module.rb'
-# include Roebe::GUI::Gtk::ShellModule
-# =========================================================================== #
-require 'roebe/gui/shared_code/shell/constants.rb'
-require 'roebe/gui/shared_code/shell/connect_skeleton.rb'
-
-module Roebe
-
-module GUI
-
-module Gtk
-
-module ShellModule
-
-  require 'gtk_paradise/requires/require_the_base_module.rb'
-  include ::Gtk::BaseModule
-
-  require 'gtk_paradise/widgets/gtk3/button_xorg_buffer/button_xorg_buffer.rb'
-
-  # ========================================================================= #
-  # === Gtk::Shell.width?
-  # ========================================================================= #
-  def self.width?
-    WIDTH
-  end
-
-  # ========================================================================= #
-  # === Gtk::Shell.height?
-  # ========================================================================= #
-  def self.height?
-    HEIGHT
-  end
-
-  # ========================================================================= #
-  # === initialize
-  # ========================================================================= #
-  def initialize(
-      commandline_arguments = ARGV,
-      run_already           = true
-    )
-    super()
-    set_commandline_arguments(
-      commandline_arguments.reject {|entry| entry.start_with?('--') }
-    )
-    reset
-    set_title(TITLE) if respond_to? :set_title
-    label.set_markup(
-      %Q(<span weight="ultrabold" size="large" foreground="darkblue"> #{TITLE} </span>),
-      true
-    )
-    on_delete_event_quit_the_application
-    run if run_already
-  end
-
-  # ========================================================================= #
-  # === reset                                                     (reset tag)
-  # ========================================================================= #
-  def reset
-    reset_the_internal_variables
-    # ======================================================================= #
-    # === @configuration
-    # ======================================================================= #
-    @configuration = [true, __dir__, NAMESPACE]
-    # ======================================================================= #
-    # === @title
-    # ======================================================================= #
-    title_width_height_font(TITLE, WIDTH, HEIGHT, USE_THIS_FONT)
-    # ======================================================================= #
-    # === @can_we_left_mouse_button_click
-    # ======================================================================= #
-    @can_we_left_mouse_button_click = true
-    append_project_css_file
-    infer_the_size_automatically
-  end
-
-  # ======================================================================== #
-  # ==== add_status_message
-  #
-  # This method will simply add the status message to the statusbar.
-  # ======================================================================== #
-  def add_status_message(i)
-    case i
-    # ======================================================================= #
-    # === :clear
-    #
-    # This will simply empty the status-bar.
-    # ======================================================================= #
-    when :clear
-      i = EMPTY_STRING
-    # ======================================================================= #
-    # === :found_nothing
-    # ======================================================================= #
-    when :found_nothing
-      i = INPUT_WAS_NOT_FOUND
-    end
-    @statusbar.push(@statusbar_context_id, i)
-    # @statusbar.modify_foreground :crimson
-    # ^^^ this does not work, unfortunately. May have to revisit
-    # this at a later time.
-  end
-
-  # ======================================================================== #
-  # === evaluate_this_input_via_the_shell
-  #
-  # This method can be used to "send" input to the Roebe::Shell,
-  # without depending on the main loop {}.
-  #
-  # It will also modify the textview-widget on the bottom.
-  # ======================================================================== #
-  def evaluate_this_input_via_the_shell(
-      i = @entry_for_user_input.text
-    )
-    begin
-      @roebe_shell.evaluate_this_input(i)
-      set_content_for_the_textview_widget(last_result?)
-    rescue Exception => error
-      pp error
-    end
-  end
-
-  # ======================================================================== #
-  # === do_require_the_roebe_shell
-  # ======================================================================== #
-  def do_require_the_roebe_shell
-    require 'roebe/requires/require_the_roebe_shell.rb'
-  end
-
-  # ======================================================================== #
-  # === instantiate_the_roebe_shell
-  #
-  # This method will instantiate a new Roebe::Shell. Currently,
-  # Roebe::Shell embedded in ruby-gtk will not use readline nor
-  # colours.
-  # ======================================================================== #
-  def instantiate_the_roebe_shell
-    @roebe_shell = ::Roebe::Shell.new { :do_not_enter_the_main_loop }
-    @roebe_shell.do_not_use_readline
-    @roebe_shell.disable_colours # For now we will disable them.
-  end
-
-  # ======================================================================== #
-  # === set_content_for_the_textview_widget
-  # ======================================================================== #
-  def set_content_for_the_textview_widget(
-      i = last_result?
-    )
-    i = ::Colours.remove_escape_sequences(i.dup).to_s
-    @text_buffer.set_text(i)
-  end; alias update_the_textview_widget_with_this_content set_content_for_the_textview_widget # === update_the_textview_widget_with_this_content
-
-  # ========================================================================= #
-  # === create_the_text_buffer_and_the_text_view
-  # ========================================================================= #
-  def create_the_text_buffer_and_the_text_view
-    @text_buffer = gtk_text_buffer
-    @text_view = gtk_text_view(@text_buffer)
-    @text_view.set_editable(true)
-    @text_view.visible_cursor
-  end
-
-  # ======================================================================== #
-  # === last_result?
-  # ======================================================================== #
-  def last_result?
-    @roebe_shell.last_result?
-  end
-
-  # ======================================================================== #
-  # === roebe_shell?
-  # ======================================================================== #
-  def roebe_shell?
-    @roebe_shell
-  end
-
-  # ========================================================================= #
-  # === focus_on_the_user_input_gtk_entry
-  # ========================================================================= #
-  def focus_on_the_user_input_gtk_entry
-    @entry_for_user_input.do_focus
-  end
-
-  # ======================================================================== #
-  # === padding?
-  # ======================================================================== #
-  def padding?
-    10
-  end
-
-  # ========================================================================= #
-  # === border_size?
-  # ========================================================================= #
-  def border_size?
-    2
-  end
-
-  # ======================================================================== #
-  # === create_the_bottom_widget
-  # ======================================================================== #
-  def create_the_bottom_widget
-    @bottom_widget = gtk_vbox
-  end
-
-  # ========================================================================= #
-  # === focus_on_the_bottom_widget
-  # ========================================================================= #
-  def focus_on_the_bottom_widget
-    @text_view.do_focus
-  end
-
-  # ======================================================================== #
-  # === create_then_return_statusbar                            (status tag)
-  # ======================================================================== #
-  def create_then_return_statusbar
-    @statusbar = gtk_statusbar
-    if @statusbar.respond_to? :has_resize_grip= 
-      @statusbar.has_resize_grip = true
-    end
-    @statusbar_context_id = @statusbar.get_context_id('statusbar_gtk_shell')
-    return @statusbar
-  end
-
-  # ======================================================================== #
-  # === deselect_and_select_relevant_widgets
-  # ======================================================================== #
-  def deselect_and_select_relevant_widgets
-    Thread.new {
-      sleep 0.05
-      @label_title.deselect
-      @entry_for_user_input.do_focus
-    }
-  end
-
-  # ========================================================================= #
-  # === create_skeleton
-  # ========================================================================= #
-  def create_skeleton
-    create_the_directory_content_widget
-    create_the_top_widget
-    create_the_bottom_widget
-    create_gtk_entries
-    create_the_text_buffer_and_the_text_view # Must come before create_scrolled_window().
-    create_scrolled_window
-    create_the_eventbox
-    create_the_button_xorg_buffer
-    create_the_combo_box
-    create_the_modified_scrolled_window
-    instantiate_a_flexible_vte
-  end
-
-  # ========================================================================= #
-  # === create_the_combo_box
-  # ========================================================================= #
-  def create_the_combo_box
-    # ======================================================================= #
-    # Create a combo-box next.
-    # ======================================================================= #
-    array = []
-    begin
-      require 'case_parser'
-      array << CaseParser.parse(
-        '$RUBY_SRC/roebe/lib/roebe/shell/core/menu.rb'
-      )
-      array.flatten!
-      array.reject! {|entry| entry.to_s.empty? }
-    rescue LoadError; end
-    @combo_box_with_useful_commands_from_the_case_when_menu = return_combo_box_entry(array)
-    @combo_box_with_useful_commands_from_the_case_when_menu.set_font(:hack_18)
-    @combo_box_with_useful_commands_from_the_case_when_menu.focus_on_the_first_element
-    @combo_box_with_useful_commands_from_the_case_when_menu.on_changed {
-      if @combo_box_with_useful_commands_from_the_case_when_menu.active_iter
-        @entry_for_user_input.set_text(
-          @combo_box_with_useful_commands_from_the_case_when_menu.active_text+' '
-        )
-      end
-    }
-  end
-
-  # ========================================================================= #
-  # === create_the_button_xorg_buffer
-  # ========================================================================= #
-  def create_the_button_xorg_buffer
-    # ======================================================================= #
-    # Create the assign-to-xorg button next:
-    # ======================================================================= #
-    @button_xorg_buffer = ::Gtk::ButtonXorgBuffer.new(@text_buffer) { :split }
-  end
-
-  # ========================================================================= #
-  # === create_the_eventbox
-  # ========================================================================= #
-  def create_the_eventbox
-    label_current_working_directory = gtk_bold_label('Current working directory → ')
-    @eventbox_label_current_working_directory = gtk_eventbox(
-      label_current_working_directory
-    )
-    # ======================================================================= #
-    # === Handle left-mouse-button click events
-    #
-    # Let the eventbox respond to left-mouse-click, and then update the
-    # widget that displays the current working directory.
-    #
-    # We will, however had, add a 3 seconds delay after such a click
-    # event.
-    # ======================================================================= #
-    @eventbox_label_current_working_directory.signal_connect(:event) { |widget, event|
-      if use_gtk2?
-        case event.event_type
-        when Gdk::Event::BUTTON_PRESS
-          update_the_current_working_directory
-        end
-      else
-        case event.event_type
-        when Gdk::EventType::BUTTON_PRESS
-          update_the_current_working_directory
-        end
-      end
-    }
-  end
-
-  # ========================================================================= #
-  # === create_the_top_widget
-  # ========================================================================= #
-  def create_the_top_widget
-    @top_widget = gtk_vbox
-  end
-
-  # ========================================================================= #
-  # === create_scrolled_window
-  #
-  # This is the buffer that contains all output from the roebe-shell.
-  # ========================================================================= #
-  def create_scrolled_window
-    @scrolled_window_containing_the_text_view = gtk_scrolled_window(@text_view) { :always }
-    @scrolled_window_containing_the_text_view.set_size_request(500, 500)
-  end
-
-  # ========================================================================= #
-  # === return_the_bottom_widget_finally
-  # ========================================================================= #
-  def return_the_bottom_widget_finally
-    return @bottom_widget
-  end
-
-  # ========================================================================= #
-  # === create_the_modified_scrolled_window
-  # ========================================================================= #
-  def create_the_modified_scrolled_window
-    # ======================================================================= #
-    # The tiny-vbox is on the right side.
-    # ======================================================================= #
-    tiny_vbox = gtk_vbox
-    tiny_vbox.minimal(@button_xorg_buffer)
-    tiny_vbox.minimal(@combo_box_with_useful_commands_from_the_case_when_menu)
-
-    @drag_top_to_bottom_pane = gtk_drag_top_to_bottom_pane(
-      @scrolled_window_containing_the_text_view,
-      tiny_vbox
-    )
-    @drag_top_to_bottom_pane.position = 1280
-  end
-
-  # ========================================================================= #
-  # === update_the_current_working_directory
-  #
-  # This method will merely modify the working-directory Gtk::Entry.
-  # ========================================================================= #
-  def update_the_current_working_directory(
-      use_this_directory = return_pwd
-    )
-    @entry_showing_the_current_working_directory.set_text(
-      use_this_directory
-    )
-    @directory_content_widget.set_pwd(use_this_directory)
-  end
-
-  # ========================================================================= #
-  # === set_pwd
-  # ========================================================================= #
-  def set_pwd(
-      i = @entry_showing_the_current_working_directory.text
-    )
-    evaluate_this_input_via_the_shell(i)
-    _ = roebe_shell?.return_pwd.to_s # Must come after the ^^^ above.
-    @entry_showing_the_current_working_directory.set_text(_)
-    update_the_textview_widget_with_this_content(_)
-  end
-
-  # ======================================================================== #
-  # === return_title
-  #
-  # This main header will also make use of "header1".
-  # ======================================================================== #
-  def return_title
-    _ = gtk_label("☘️ #{TITLE} ☘️") # The old symbol was the fruit-emoji, aka '🌹'.
-    return _
-  end
-
-  # ======================================================================== #
-  # === create_the_title_label
-  # ======================================================================== #
-  def create_the_title_label
-    @label_title = return_title
-    @label_title.set_name('header3')
-    @label_title.make_selectable
-  end
-
-  require 'gtk_paradise/widgets/gtk3/flexible_vte/flexible_vte.rb'
-  # ======================================================================== #
-  # === instantiate_a_flexible_vte
-  # ======================================================================== #
-  def instantiate_a_flexible_vte
-    # ====================================================================== #
-    # === @vte
-    # ====================================================================== #
-    # @vte = ::Gtk::FlexibleVte.new {{ n_tabs: 3 }}
-  end
-
-  # ======================================================================== #
-  # === run                                                        (run tag)
-  # ======================================================================== #
-  def run
-    do_require_the_roebe_shell
-    instantiate_the_roebe_shell
-    create_skeleton_then_connect_skeleton
-    show_all
-    deselect_and_select_relevant_widgets
-  end
-
-  # ======================================================================== #
-  # === report_return_date
-  # ======================================================================== #
-  def report_return_date
-    main_entry?.set_text(__method__.to_s)
-    do_click_the_main_button
-  end
-
-  # ======================================================================== #
-  # === show_path_in_use
-  # ======================================================================== #
-  def show_path_in_use
-    set_text_in_the_main_entry_then_click_the_main_button(__method__.to_s)
-  end
-
-  # ======================================================================== #
-  # === set_text_in_the_main_entry_then_click_the_main_button
-  # ======================================================================== #
-  def set_text_in_the_main_entry_then_click_the_main_button(i)
-    main_entry?.set_text(i.to_s)
-    do_click_the_main_button
-  end
-
-  # ======================================================================== #
-  # === main_entry?
-  # ======================================================================== #
-  def main_entry?
-    @entry_for_user_input
-  end
-
-  # ======================================================================== #
-  # === do_evaluate_the_main_entry
-  # ======================================================================== #
-  def do_evaluate_the_main_entry
-    evaluate_this_input_via_the_shell(@entry_for_user_input.text)
-    update_the_current_working_directory
-    if roebe_shell?.menu_found_no_match?
-      add_status_message(:found_nothing)
-    else
-      add_status_message(:clear)
-    end
-  end; alias do_click_the_main_button do_evaluate_the_main_entry # === do_click_the_main_button
-
-  # ========================================================================= #
-  # === create_the_directory_content_widget
-  # ========================================================================= #
-  def create_the_directory_content_widget
-    # ======================================================================= #
-    # The directory-content-widget comes next.
-    # ======================================================================= #
-    @directory_content_widget = directory_content_widget
-    @directory_content_widget.bblack2
-  end
-
-  # ========================================================================= #
-  # === Roebe::GUI::Gtk::ShellModule.run
-  #
-  # This is the variant that can be "run" directly.
-  # ========================================================================= #
-  def self.run
-    require 'gtk_paradise/run'
-    _ = ::Roebe::GUI::Gtk::Shell.new
-    r = ::Gtk.run
-    r << _
-    @accel_group = ::Gtk::AccelGroup.new
-    # ======================================================================= #
-    # === Alt+1
-    #
-    # Alt+1 will focus on the gtk-entry, the main user input.
-    # ======================================================================= #
-    if ::Gtk.use_gtk2?
-      use_this_key = Gdk::Keyval::GDK_1
-    else
-      use_this_key = Gdk::Keyval::KEY_1
-    end
-    @accel_group.alt_key(use_this_key) {
-      _.focus_on_the_user_input_gtk_entry
-    }
-    # ======================================================================= #
-    # === Alt+2
-    # ======================================================================= #
-    if ::Gtk.use_gtk2?
-      use_this_key = Gdk::Keyval::GDK_2
-    else
-      use_this_key = Gdk::Keyval::KEY_2
-    end
-    @accel_group.alt_key(use_this_key) {
-      _.focus_on_the_bottom_widget
-    }
-    r.add_accel_group(@accel_group)
-    _.set_parent_widget(r) # Must designate the parent-widget first.
-    # ====================================================================== #
-    # Enable additional key-combinations next:
-    # ====================================================================== #
-    _.enable_these_key_combinations(
-      ::Roebe::GUI::Gtk::ShellModule::HASH_DESIGNATED_KEY_COMBINATIONS
-    )
-    r.automatic_title
-    r.automatic_size
-    r.set_background :white
-    r.top_left_then_run
-  end
-
-  # ========================================================================= #
-  # === create_gtk_entries                           (entry tag, entries tag)
-  # ========================================================================= #
-  def create_gtk_entries
-    # ======================================================================= #
-    # === User input entry
-    #
-    # First we will create the gtk-entry that contains the user input.
-    # ======================================================================= #
-    @entry_for_user_input = gtk_entry
-    @entry_for_user_input.set_activates_default(true)
-    @entry_for_user_input.fancy_tooltips = 'Input your <b>commands</b> here.'
-    @entry_for_user_input.do_focus
-    @entry_for_user_input.css_class('BG_gainsboro')
-    @entry_for_user_input.bblack1
-    @entry_for_user_input.border(
-      PADDING_TO_USE_FOR_THE_USER_INPUT,
-      PADDING_TO_USE_FOR_THE_USER_INPUT,
-      PADDING_TO_USE_FOR_THE_USER_INPUT,
-      PADDING_TO_USE_FOR_THE_USER_INPUT
-    ) # ^^^ A smallish "border" is visually nicer, in my opinion.
-    unless @commandline_arguments.empty?
-      # ===================================================================== #
-      # Assign the commandline arguments to the input-box next:
-      # ===================================================================== #
-      @entry_for_user_input.set_text(
-        @commandline_arguments.join(' ').strip
-      )
-      if is_on_roebe?
-        @entry_for_user_input.signal_emit(:activate)
-      end
-    end 
-    @entry_for_user_input.signal_connect(:activate) { |widget|
-      do_evaluate_the_main_entry
-    }
-    # ======================================================================= #
-    # === @entry_showing_the_current_working_directory
-    #
-    # Next comes the entry that will show the current working directory.
-    # ======================================================================= #
-    @entry_showing_the_current_working_directory = gtk_entry
-    @entry_showing_the_current_working_directory.bblack1
-    @entry_showing_the_current_working_directory.very_light_yellowish_background
-    @entry_showing_the_current_working_directory.on_key_press_event { |widget, event|
-      # ===================================================================== #
-      # Handle the "enter" key next, as well as the "return" key.
-      # ===================================================================== #
-      _ = Gdk::Keyval.to_name(event.keyval)
-      case _
-      when 'Return','KP_Enter'
-        set_pwd(
-          @entry_showing_the_current_working_directory.text
-        )
-        update_the_current_working_directory
-      # else
-      #   pp _
-      end
-    }
-  end
-
-end; end; end; end