gtk_paradise 0.9.120 → 0.11.19

data/lib/gtk_paradise/widgets/gtk3/calculator/calculator.rb

@@ -16,11 +16,6 @@ class Calculator < ::Gtk::Frame # === Gtk::Calculator
   require 'gtk_paradise/requires/require_the_base_module.rb'
   include ::Gtk::BaseModule
 
-  # ========================================================================= #
-  # === NAMESPACE
-  # ========================================================================= #
-  NAMESPACE = inspect
-
   # ========================================================================= #
   # === TITLE
   # ========================================================================= #
@@ -34,7 +29,7 @@ class Calculator < ::Gtk::Frame # === Gtk::Calculator
   # ========================================================================= #
   # === HEIGHT
   # ========================================================================= #
-  HEIGHT = '15% or minimum 150px'
+  HEIGHT = '18% or minimum 180px'
 
   # ========================================================================= #
   # === USE_THIS_FONT
@@ -45,32 +40,38 @@ class Calculator < ::Gtk::Frame # === Gtk::Calculator
   # === HASH_DESIGNATED_KEY_COMBINATIONS
   # ========================================================================= #
   HASH_DESIGNATED_KEY_COMBINATIONS = {
-    'alt+1': 'input_is(1)',
-    'alt+2': 'input_is(2)',
-    'alt+3': 'input_is(3)',
-    'alt+4': 'input_is(4)',
-    'alt+5': 'input_is(5)',
-    'alt+6': 'input_is(6)',
-    'alt+7': 'input_is(7)',
-    'alt+8': 'input_is(8)',
-    'alt+9': 'input_is(9)',
-    'alt+0': 'input_is(0)',
-    '1':     'input_is(1)',
-    '2':     'input_is(2)',
-    '3':     'input_is(3)',
-    '4':     'input_is(4)',
-    '5':     'input_is(5)',
-    '6':     'input_is(6)',
-    '7':     'input_is(7)',
-    '8':     'input_is(8)',
-    '9':     'input_is(9)',
-    '0':     'input_is(0)',
-    'alt++': "input_is('+')",
-    'alt+-': "input_is('-')",
-    'alt+/': "input_is('/')",
-    'alt+*': "input_is('/*')"
+    'ctrl+=': "input_is('=')", # This one currently does not work.
+    'alt+1':  'input_is(1)',
+    'alt+2':  'input_is(2)',
+    'alt+3':  'input_is(3)',
+    'alt+4':  'input_is(4)',
+    'alt+5':  'input_is(5)',
+    'alt+6':  'input_is(6)',
+    'alt+7':  'input_is(7)',
+    'alt+8':  'input_is(8)',
+    'alt+9':  'input_is(9)',
+    'alt+0':  'input_is(0)',
+    '1':      'input_is(1)',
+    '2':      'input_is(2)',
+    '3':      'input_is(3)',
+    '4':      'input_is(4)',
+    '5':      'input_is(5)',
+    '6':      'input_is(6)',
+    '7':      'input_is(7)',
+    '8':      'input_is(8)',
+    '9':      'input_is(9)',
+    '0':      'input_is(0)',
+    'alt++':  "input_is('+')",
+    'alt+-':  "input_is('-')",
+    'alt+/':  "input_is('/')",
+    'alt+*':  "input_is('/*')"
   }
 
+  # ========================================================================= #
+  # === PERCENTAGE_SIGN
+  # ========================================================================= #
+  PERCENTAGE_SIGN = '%'
+
   # ========================================================================= #
   # === initialize
   # ========================================================================= #
@@ -93,23 +94,12 @@ class Calculator < ::Gtk::Frame # === Gtk::Calculator
   # ========================================================================= #
   def reset
     reset_the_internal_variables
+    infer_the_namespace
     # ======================================================================= #
     # === @configuration
     # ======================================================================= #
-    @configuration = [true, __dir__, NAMESPACE]
-    # ======================================================================= #
-    # === @title
-    # ======================================================================= #
-    set_title(TITLE)
-    # ======================================================================= #
-    # === @width
-    # ======================================================================= #
-    set_width(WIDTH)
-    # ======================================================================= #
-    # === @height
-    # ======================================================================= #
-    set_height(HEIGHT)
-    set_use_this_font(USE_THIS_FONT)
+    @configuration = [true, __dir__, namespace?]
+    title_width_height_font(TITLE, WIDTH, HEIGHT, USE_THIS_FONT)
     handle_CSS_rules
     infer_the_size_automatically
   end
@@ -164,6 +154,7 @@ class Calculator < ::Gtk::Frame # === Gtk::Calculator
       _ = Gdk::Keyval.to_name(event.keyval)
       case _
       when '*',
+           'x',
            '/',
            '-',
            '+',
@@ -187,31 +178,31 @@ class Calculator < ::Gtk::Frame # === Gtk::Calculator
     @grid = gtk_grid
     @box.maximal(@grid, 10)
     # ======================================================================= #
-    # All the buttons and the function that will be fired
-    # when they are clicked.
+    # All the buttons and the function that will be fired when they
+    # are clicked.
     # ======================================================================= #
-    button1 = gtk_button('1')
+    button1 = button('1')
     button1.width_height(80,80)
     button1.on_clicked {
       input_is(1)
     }
     @grid.add(button1)
 
-    button2 = gtk_button('2')
+    button2 = button('2')
     button2.width_height(80,80)
     button2.on_clicked {
       input_is(2)
     }
     @grid.attach_next_to(button2, button1, 1, 1, 1)
 
-    button3 = gtk_button('3')
+    button3 = button('3')
     button3.width_height(80,80)
     button3.on_clicked {
       input_is(3)
     }
     @grid.attach_next_to(button3, button2, 1, 1, 1)
 
-    button_plus = gtk_button('+')
+    button_plus = button('+')
     button_plus.width_height(80,80)
     button_plus.on_clicked {
       unless last_char? == button_plus.text?
@@ -220,7 +211,7 @@ class Calculator < ::Gtk::Frame # === Gtk::Calculator
     }
     @grid.attach_next_to(button_plus, button3, 1, 1, 1)
 
-    button_square = gtk_button('sqrt')
+    button_square = button('sqrt')
     button_square.hint = 'This will square the input, e. g. 2 ** 2 aka 2².'
     button_square.width_height(80,80)
     button_square.on_clicked {
@@ -228,28 +219,28 @@ class Calculator < ::Gtk::Frame # === Gtk::Calculator
     }
     @grid.attach_next_to(button_square, button_plus, 1, 1, 1)
 
-    button4 = gtk_button('4')
+    button4 = button('4')
     button4.width_height(80,80)
     button4.on_clicked {
       input_is(4)
     }
     @grid.attach_next_to(button4, button1, 3, 1, 1)
 
-    button5 = gtk_button('5')
+    button5 = button('5')
     button5.width_height(80,80)
     button5.on_clicked {
       input_is(5)
     }
     @grid.attach_next_to(button5, button4, 1, 1, 1)
 
-    button6 = gtk_button('6')
+    button6 = button('6')
     button6.width_height(80,80)
     button6.on_clicked {
       input_is(6)
     }
     @grid.attach_next_to(button6, button5, 1, 1, 1)
 
-    button_minus = gtk_button('-')
+    button_minus = button('-')
     button_minus.width_height(80,80)
     button_minus.on_clicked {
       unless last_char? == button_minus.text?
@@ -258,28 +249,38 @@ class Calculator < ::Gtk::Frame # === Gtk::Calculator
     }
     @grid.attach_next_to(button_minus, button6, 1, 1, 1)
 
-    button7 = gtk_button('7')
+    # ======================================================================= #
+    # === %
+    # ======================================================================= #
+    button_percentage_sign = button(PERCENTAGE_SIGN)
+    button_percentage_sign.width_height(80,80)
+    button_percentage_sign.on_clicked {
+      input_is(button_percentage_sign.text?)
+    }
+    @grid.attach_next_to(button_percentage_sign, button_minus, 1, 1, 1)
+
+    button7 = button('7')
     button7.width_height(80,80)
     button7.on_clicked {
       input_is(7)
     }
     @grid.attach_next_to(button7, button4, 3, 1, 1)
 
-    button8 = gtk_button('8')
+    button8 = button('8')
     button8.width_height(80,80)
     button8.on_clicked {
       input_is(8)
     }
     @grid.attach_next_to(button8, button7, 1, 1, 1)
 
-    button9 = gtk_button('9')
+    button9 = button('9')
     button9.width_height(80,80)
     button9.on_clicked {
       input_is(9)
     }
     @grid.attach_next_to(button9, button8, 1, 1, 1)
 
-    button_multiply = gtk_button('*')
+    button_multiply = button('*')
     button_multiply.width_height(80,80)
     button_multiply.on_clicked {
       unless last_char? == '*'
@@ -288,7 +289,7 @@ class Calculator < ::Gtk::Frame # === Gtk::Calculator
     }
     @grid.attach_next_to(button_multiply, button9, 1, 1, 1)
 
-    button0 = gtk_button('0')
+    button0 = button('0')
     button0.width_height(80,80)
     button0.on_clicked {
       input_is(0)
@@ -298,7 +299,7 @@ class Calculator < ::Gtk::Frame # === Gtk::Calculator
     # ======================================================================= #
     # === button_clear
     # ======================================================================= #
-    button_clear = gtk_button('clear')
+    button_clear = button('_clear')
     button_clear.width_height(80,80)
     button_clear.on_clicked {
       do_clear_the_main_label
@@ -306,17 +307,20 @@ class Calculator < ::Gtk::Frame # === Gtk::Calculator
     button_clear.hint = 'This button will clear the display.'
     @grid.attach_next_to(button_clear, button0, 1, 1, 1)
 
-    button_equal = gtk_button('=')
+    button_equal = button('=')
     button_equal.width_height(80,80)
     button_equal.on_clicked {
       do_evaluate_the_current_text
     }
     @grid.attach_next_to(button_equal, button_clear, 1, 1, 1)
 
-    button_divide = gtk_button('/')
+    button_divide = button('/')
     button_divide.width_height(80,80)
+    button_divide.hint = return_hint_for_the_division_button
     button_divide.on_clicked {
+      # ===================================================================== #
       # We will only allow one '/' to be appended.
+      # ===================================================================== #
       unless last_char? == '/'
         @label_results.append(button_divide.text?)
       end
@@ -349,7 +353,8 @@ class Calculator < ::Gtk::Frame # === Gtk::Calculator
   # ========================================================================= #
   def main_text?
     @label_results.text?
-  end; alias string? main_text? # === string?
+  end; alias string?          main_text? # === string?
+       alias main_entry_text? main_text? # === main_entry_text?
 
   # ========================================================================= #
   # === do_square_the_result
@@ -357,12 +362,16 @@ class Calculator < ::Gtk::Frame # === Gtk::Calculator
   def do_square_the_result(
       i = main_text?
     )
-    result = eval(i)
-    if result.nil?
-      e 'Got a nil-result. Input was: '+i.to_s
-    else
-      result = Math.sqrt(result)
-      set_main_text(result.to_s)
+    begin
+      result = eval(i)
+      if result.nil?
+        e 'Got a nil-result. Input was: '+i.to_s
+      else
+        result = Math.sqrt(result)
+        set_main_text(result.to_s)
+      end
+    rescue Exception => error
+      pp error
     end
   end
 
@@ -401,31 +410,129 @@ class Calculator < ::Gtk::Frame # === Gtk::Calculator
   # ========================================================================= #
   def set_main_text(i)
     @label_results.set_text(i.to_s)
-  end; alias string=      set_main_text # === string=
-       alias update_entry set_main_text # === update_entry
+  end; alias string=                    set_main_text # === string=
+       alias update_entry               set_main_text # === update_entry
+       alias set_this_as_the_new_result set_main_text # === set_this_as_the_new_result
 
   # ========================================================================= #
-  # === input_is
+  # === input_is                                                  (input tag)
   # ========================================================================= #
   def input_is(i = 1)
+    # ======================================================================= #
+    # Next sanitize the names "plus", "minus", "asterisk", and "slash".
+    # ======================================================================= #
     case i
+    # ======================================================================= #
+    # === plus
+    # ======================================================================= #
     when 'plus'
       i = '+'
+    # ======================================================================= #
+    # === minus
+    # ======================================================================= #
     when 'minus'
       i = '-'
-    when 'asterisk'
+    # ======================================================================= #
+    # === asterisk
+    # ======================================================================= #
+    when 'asterisk','x'
       i = '*'
+    # ======================================================================= #
+    # === slash
+    # ======================================================================= #
     when 'slash'
       i = '/'
     end
-    @label_results.append(i.to_s)
+    case i
+    when PERCENTAGE_SIGN
+      do_perform_percentage_evaluation(main_entry_text?)
+    else
+      @label_results.append(i.to_s)
+    end
+    # main_entry?.cursor_is_on_the_right
+  end
+
+  # ========================================================================= #
+  # === main_entry?
+  # ========================================================================= #
+  def main_entry?
+    @label_results
+  end
+
+  # ========================================================================= #
+  # === return_hint_for_the_division_button
+  # ========================================================================= #
+  def return_hint_for_the_division_button
+    "This button can be used to <b>divide</b> two values, such as 6 / 3.\n\n"\
+    "In Unicode this would be the following token: ÷"
+  end
+
+  # ========================================================================= #
+  # === do_perform_percentage_evaluation
+  # ========================================================================= #
+  def do_perform_percentage_evaluation(
+      i = main_entry_text?
+    )
+    use_this_as_the_split_token = i.gsub(/\d/,'')
+    if i.include?(use_this_as_the_split_token)
+      # ===================================================================== #
+      # For instance, "600*15", which should be 90, as 90 is 15% of 600.
+      # ===================================================================== #
+      splitted = i.split(use_this_as_the_split_token)
+      a = splitted.first.to_f
+      percentage_value = splitted.last.to_f
+      case use_this_as_the_split_token
+      # ===================================================================== #
+      # === *
+      # ===================================================================== #
+      when '*'
+        result = (
+          a * percentage_value / 100.0
+        )
+      # ===================================================================== #
+      # === /
+      # ===================================================================== #
+      when '/'
+        result = (
+          a / (percentage_value / 100.0)
+        )
+      # ===================================================================== #
+      # === +
+      # ===================================================================== #
+      when '+' # This is "34+7" which means to calculate at 107.0
+        result = (
+          a * ( (100+percentage_value) / 100.0)
+        )
+      # ===================================================================== #
+      # === -
+      # ===================================================================== #
+      when '-' # This is "79-30" which means the result will be 55.3
+        result = (
+          a * ( (100-percentage_value) / 100.0)
+        )
+      end
+      set_this_as_the_new_result(result)
+    else
+      e 'Can not evaluate the following input: '+tomato(i)
+    end
   end
 
   # ========================================================================= #
   # === run                                                         (run tag)
   # ========================================================================= #
   def run
-    create_skeleton_then_connect_skeleton
+    super()
+    do_style_all_buttons_in_a_uniform_manner
+  end
+
+  # ========================================================================= #
+  # === do_style_all_buttons_in_a_uniform_manner
+  # ========================================================================= #
+  def do_style_all_buttons_in_a_uniform_manner
+    return_all_buttons?.each {|this_button|
+      this_button.remove_background
+      this_button.on_hover(:lightgreen)
+    }
   end
 
   # ========================================================================= #

data/lib/gtk_paradise/widgets/gtk3/checkbox_image/checkbox_image.rb

@@ -16,11 +16,6 @@ class CheckboxImage < ::Gtk::Box # === Gtk::CheckboxImage
   require 'gtk_paradise/requires/require_the_base_module.rb'
   include ::Gtk::BaseModule
 
-  # ========================================================================= #
-  # === NAMESPACE
-  # ========================================================================= #
-  NAMESPACE = inspect
-
   # ========================================================================= #
   # === TITLE
   # ========================================================================= #
@@ -61,10 +56,11 @@ class CheckboxImage < ::Gtk::Box # === Gtk::CheckboxImage
   # ========================================================================= #
   def reset
     reset_the_internal_variables
+    infer_the_namespace
     # ======================================================================= #
     # === @configuration
     # ======================================================================= #
-    @configuration = [true, __dir__, NAMESPACE]
+    @configuration = [true, __dir__, namespace?]
     # ======================================================================= #
     # === @title
     # ======================================================================= #
@@ -78,7 +74,7 @@ class CheckboxImage < ::Gtk::Box # === Gtk::CheckboxImage
     # ======================================================================= #
     set_height(HEIGHT)
     set_use_this_font(USE_THIS_FONT)
-    use_gtk_paradise_project_css_file # or use use_project_css_file 
+    use_gtk_paradise_project_css_file 
     infer_the_size_automatically
   end
 

data/lib/gtk_paradise/widgets/{version_agnostic → gtk3/coloured_button}/coloured_button.rb

@@ -11,22 +11,37 @@
 #   Gtk::ColouredButton.new('_NIHSearch_darkslategray', true)
 #
 # =========================================================================== #
-# require 'gtk_paradise/widgets/version_agnostic/coloured_button.rb'
+# require 'gtk_paradise/gui/gtk3/coloured_button/coloured_button.rb'
 # Gtk::ColouredButton.new('Test_cyan')
 # =========================================================================== #
+require 'gtk_paradise/require_gtk3'
+
 module Gtk
 
-class ColouredButton < ::Gtk::Button # === Gtk::ColouredButton
+class ColouredButton < ::Gtk::Button # === Gtk::ColouredButton 
 
-  require 'gtk_paradise/toplevel_methods/determine_which_gtk_version_is_in_use.rb'
+  require 'gtk_paradise/requires/require_the_base_module.rb'
+  include ::Gtk::BaseModule
 
-  begin
-    require 'colours'
-    include Colours # This should also include HtmlColours.
-  rescue LoadError; end
+  # ========================================================================= #
+  # === TITLE
+  # ========================================================================= #
+  TITLE = 'Coloured button'
+
+  # ========================================================================= #
+  # === WIDTH
+  # ========================================================================= #
+  WIDTH = '25% or minimum 200px'
 
-  require 'gtk_paradise/colours/parse.rb'
-  include ::Gtk::Colours
+  # ========================================================================= #
+  # === HEIGHT
+  # ========================================================================= #
+  HEIGHT = '15% or minimum 100px'
+
+  # ========================================================================= #
+  # === USE_THIS_FONT
+  # ========================================================================= #
+  USE_THIS_FONT = :dejavu_condensed_20
 
   attr_accessor :colour_active
   attr_accessor :colour_normal
@@ -75,6 +90,7 @@ class ColouredButton < ::Gtk::Button # === Gtk::ColouredButton
       colourize                 = true,
       optional_array_with_icons = nil
     )
+    super()
     reset
     case is_a_quit_button
     when :this_is_a_quit_button,
@@ -116,9 +132,56 @@ class ColouredButton < ::Gtk::Button # === Gtk::ColouredButton
   # === reset                                                     (reset tag)
   # ========================================================================= #
   def reset
+    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 
+    infer_the_size_automatically
     @can_be_clicked = true # on default, every button can be clicked
   end
 
+  # ========================================================================= #
+  # === padding?
+  # ========================================================================= #
+  def padding?
+    4
+  end
+
+  # ========================================================================= #
+  # === border_size?
+  # ========================================================================= #
+  def border_size?
+    2
+  end
+
+  # ========================================================================= #
+  # === create_skeleton                            (create tag, skeleton tag)
+  # ========================================================================= #
+  def create_skeleton
+  end
+
+  # ========================================================================= #
+  # === connect_skeleton                                        (connect tag)
+  # ========================================================================= #
+  def connect_skeleton
+    abort_on_exception
+    minimal(gtk_left_aligned_label('Hello world! This is a simple test.'))
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    create_skeleton_then_connect_skeleton
+  end
+
   # ========================================================================= #
   # === set_new_icon
   #
@@ -127,7 +190,7 @@ class ColouredButton < ::Gtk::Button # === Gtk::ColouredButton
   # ========================================================================= #
   def set_new_icon(i)
     if i.is_a? String
-      image = ::Gtk::Image.new(location)
+      image = gtk_image(location)
       image.set_padding(4,0) # left-right axis, top-down axis
       set_image(image)
     elsif i.is_a? Array
@@ -228,21 +291,28 @@ class ColouredButton < ::Gtk::Button # === Gtk::ColouredButton
     @text
   end; alias text text? # === text
 
+  # ========================================================================= #
+  # === Gtk::ColouredButton.run
+  # ========================================================================= #
+  def self.run(
+      i = ARGV
+    )
+    begin
+      require 'colours'
+    rescue LoadError; end
+    require 'gtk_paradise/app/app.rb'
+    coloured_button = Gtk::ColouredButton.new(
+      "_Test_#{::Colours.random_html_colour}"
+    )
+    coloured_button.toggle_focus
+    r = ::Gtk.run
+    r << coloured_button
+    r.automatic_size_then_automatic_title
+    r.top_left_then_run
+  end
+
 end; end
 
 if __FILE__ == $PROGRAM_NAME
-  require 'colours'
-  require 'gtk_paradise/require_gtk3.rb'
-  require 'gtk_paradise/run'
-  r = Gtk.run
-  coloured_button = Gtk::ColouredButton.new(
-    "_Test_#{Colours::HtmlColours.random_colour}"
-  )
-  coloured_button.toggle_focus
-  # puts coloured_button.colour_active
-  # puts coloured_button.colour_normal
-  # puts coloured_button.colour_prelight
-  r << coloured_button
-  r.set_default_size(130, 130) 
-  r.top_left_then_run
+  Gtk::ColouredButton.run
 end # gtkcolouredbutton

data/lib/gtk_paradise/widgets/gtk3/coloured_square/coloured_square.rb

@@ -16,11 +16,6 @@ class ColouredSquare < ::Gtk::Box
   require 'gtk_paradise/requires/require_the_base_module.rb'
   include ::Gtk::BaseModule
 
-  # ========================================================================= #
-  # === NAMESPACE
-  # ========================================================================= #
-  NAMESPACE = inspect
-
   # ========================================================================= #
   # === TITLE
   # ========================================================================= #
@@ -56,10 +51,11 @@ class ColouredSquare < ::Gtk::Box
   # ========================================================================= #
   def reset
     reset_the_internal_variables
+    infer_the_namespace
     # ======================================================================= #
     # === @configuration
     # ======================================================================= #
-    @configuration = [true, __dir__, NAMESPACE]
+    @configuration = [true, __dir__, namespace?]
     # ======================================================================= #
     # === @title
     # ======================================================================= #