gtk_paradise 0.9.120 → 0.11.19

data/lib/gtk_paradise/base_module/change_directory.rb

@@ -1,22 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'gtk_paradise/base_module/change_directory.rb'
-# =========================================================================== #
-module Gtk
-
-module BaseModule
-
-  # ========================================================================= #
-  # === change_directory                                             (cd tag)
-  # ========================================================================= #
-  def change_directory(i)
-    if i.is_a? Array
-      i = i.first
-    end
-    Dir.chdir(i) if File.directory? i # Need to check whether it is a directory.
-  end; alias cd    change_directory # === cd
-       alias chdir change_directory # === chdir
-
-end; end

data/lib/gtk_paradise/base_module/combo_box_and_combo_box_entry.rb

@@ -1,113 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'gtk_paradise/base_module/combo_box_and_combo_box_entry.rb'
-# =========================================================================== #
-module Gtk
-
-module BaseModule
-
-  # ========================================================================= #
-  # === gtk_combo_box_text
-  #
-  # A wrapper-method over Gtk::ComboBoxText, specifically for ruby-gtk3.
-  # ========================================================================= #
-  def gtk_combo_box_text(
-      i = nil
-    )
-    _ = ::Gtk::ComboBoxText.new
-    if i
-      i.each {|entry|
-        _.append_text(entry)
-      }
-    end
-    # ======================================================================= #
-    # === Handle blocks given to this method next
-    # ======================================================================= #
-    if block_given?
-      yielded = yield
-      case yielded
-      # ===================================================================== #
-      # === :first_element_is_active
-      # ===================================================================== #
-      when :first_element_is_active, :first
-        _.set_active(0)
-      end
-    end
-    return _
-  end; alias combo_box_text gtk_combo_box_text # === combo_box_text
-       alias combo_box      gtk_combo_box_text # === combo_box_text
-
-  require 'gtk_paradise/gtk_classes/combo_box.rb'
-  # ========================================================================= #
-  # === gtk_combo_box
-  # ========================================================================= #
-  def gtk_combo_box(
-      array_or_nil = nil,
-      i            = :strings_only
-    )
-    if array_or_nil and 
-       array_or_nil.is_a?(Array) and 
-       array_or_nil.respond_to?(:sort)
-      array_or_nil = array_or_nil.sort
-    end
-    _ = ::Gtk.combo_box(array_or_nil, i)
-    _.set_active(0)
-    return _
-  end
-
-  # ========================================================================= #
-  # === return_combo_box_entry
-  #
-  # This method will return a new instance of Gtk::ComboBoxEntry. However
-  # had, this widget no longer exists in ruby-gtk3, so for ruby-gtk3 we
-  # have to use a slightly different way.
-  # ========================================================================= #
-  def return_combo_box_entry(i)
-    if use_gtk2?
-      combo_box_entry = ::Gtk::ComboBoxEntry.new(true) # true here means "is text only".
-    else
-      combo_box_entry = ::Gtk::ComboBoxText.new
-    end
-    if i.is_a? Hash
-      if i.has_key? :with_these_elements
-        i = i.delete(:with_these_elements)
-      end
-    end
-    i.each { |value|
-      combo_box_entry.append_text(value.to_s)
-    }
-    return combo_box_entry
-  end
-
-  require 'gtk_paradise/gtk_classes/combo_box_entry.rb'
-  # ========================================================================= #
-  # === gtk_combo_box_entry
-  #
-  # Note that ComboBoxEntry no longer exists in GTK3, hence the check inside
-  # of this method.
-  # ========================================================================= #
-  def gtk_combo_box_entry(
-      array_or_nil = nil,
-      i            = :strings_only
-    )
-    if ::Gtk.use_gtk2?
-      _ = ::Gtk::ComboBoxEntry.new
-    else # else assume ruby-gtk3
-      _ = ::Gtk::ComboBoxText.new
-    end
-    if array_or_nil
-      array_or_nil.each {|entry|
-        if _.respond_to? :append_text
-          _.append_text(entry)
-        else
-          _.append(entry)
-        end
-      }
-    end
-    return _
-  end; alias gtk_dropdown_box gtk_combo_box_entry # === gtk_dropdown_box
-       alias combo_box_entry  gtk_combo_box_entry # === combo_box_entry
-
-end; end

data/lib/gtk_paradise/base_module/commandline_arguments.rb

@@ -1,36 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'gtk_paradise/base_module/commandline_arguments.rb'
-# =========================================================================== #
-module Gtk
-
-module BaseModule
-
-  # ========================================================================= #
-  # === set_commandline_arguments
-  # ========================================================================= #
-  def set_commandline_arguments(i)
-    @commandline_arguments = [i].flatten.compact
-  end
-
-  # ========================================================================= #
-  # === commandline_arguments?
-  # ========================================================================= #
-  def commandline_arguments?
-    @commandline_arguments
-  end
-
-  # ========================================================================= #
-  # === first_argument?
-  #
-  # This method can be used to return the first argument from the
-  # ARGV array passed in.
-  # ========================================================================= #
-  def first_argument?
-    @commandline_arguments.first
-  end; alias first_commandline_argument? first_argument? # === first_commandline_argument?
-       alias first?                      first_argument? # === first?
-
-end; end

data/lib/gtk_paradise/base_module/configuration.rb

@@ -1,50 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'gtk_paradise/base_module/configuration.rb'
-# =========================================================================== #
-module Gtk
-
-module BaseModule
-
-  # ========================================================================= #
-  # === configuration?
-  # ========================================================================= #
-  def configuration?
-    @configuration
-  end; alias configfile? configuration? # === configfile?
-
-  # ========================================================================= #
-  # === use_config_file?
-  # ========================================================================= #
-  def use_config_file?
-    @configuration and (@configuration[0] == true)
-  end; alias do_we_use_a_config_file? use_config_file? # === do_we_use_a_config_file?
-
-  # ========================================================================= #
-  # === return_the_title_from_the_config_file
-  #
-  # This method will return the title based on the config-file at hand.
-  # ========================================================================= #
-  def return_the_title_from_the_config_file
-    if use_config_file? # Will return an Array containing three elements.
-      # ======================================================================= #
-      # The second entry will have our desired value.
-      # ======================================================================= #
-      this_file = @configuration[1]+'/'+
-                  File.basename(@configuration[1])+'.config'
-      if File.exist? this_file
-        dataset = File.readlines(this_file).select {|line|
-          line.start_with? 'title:'
-        }
-        return dataset.flatten.first.strip.split(':').last.strip
-      else
-        ''
-      end
-    else
-      ''
-    end
-  end
-
-end; end

data/lib/gtk_paradise/base_module/constants.rb

@@ -1,23 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# This file contains only one constant for the time being.
-# =========================================================================== #
-# require 'gtk_paradise/base_module/constants.rb'
-# include ::Gtk::BaseModule
-# =========================================================================== #
-module Gtk
-
-module BaseModule
-
-  require 'gtk_paradise/project/project.rb'
-
-  # ========================================================================= #
-  # === IMG_DIR
-  #
-  # This constant refers to the gtk-paradise's projects main image directory.
-  # ========================================================================= #
-  IMG_DIR = "#{PROJECT_BASE_DIRECTORY}images/"
-
-end; end

data/lib/gtk_paradise/base_module/debug.rb

@@ -1,127 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'gtk_paradise/base_module/debug.rb'
-# =========================================================================== #
-module Gtk
-
-module BaseModule
-
-  # ========================================================================= #
-  # === return_debug_widget
-  #
-  # This method will return a new instance of the main debug-widget in
-  # use. The idea behind this widget is to allow us to quickly debug
-  # stuff.
-  #
-  # To require the ruby-gtk3 version, try:
-  #
-  #   require 'gtk_paradise/widgets/gtk3/debug_widget/debug_widget.rb'
-  #
-  # ========================================================================= #
-  def return_debug_widget
-    ::Gtk::DebugWidget.new
-  end; alias gtk_debug_widget return_debug_widget # === gtk_debug_widget
-
-  # ========================================================================= #
-  # === debug?
-  #
-  # This query-method tells us whether the gtk-widget at hand is running
-  # in debug-mode or not. By default this is not the case.
-  # ========================================================================= #
-  def debug?
-    if @internal_hash and @internal_hash.has_key?(:debug)
-      @internal_hash[:debug]
-    else
-      false
-    end
-  end; alias debug debug? # === debug
-
-  # ========================================================================= #
-  # === do_enable_debug
-  #
-  # This method can be used to activate debugging. This is not the default,
-  # so you may have to call it explicitely if you need debug-support.
-  # ========================================================================= #
-  def do_enable_debug
-    @internal_hash[:debug] = true
-  end; alias enable_debug do_enable_debug # === enable_debug
-
-  # ========================================================================= #
-  # === show_debug_information                                    (debug tag)
-  #
-  # This method can be used to show debug-information.
-  #
-  # An alias called .debug, as a method, may be used as well.
-  # ========================================================================= #
-  def show_debug_information
-    e
-    e ::Colours.rev+
-      'Showing potentially useful information about the gtk-widget at hand'
-    e ::Colours.rev+
-      'as well as the environment:'
-    e
-    e ::Colours.rev+'  Resolution: '+::Colours.steelblue('max-width:  '+max_width?.to_s)
-    e ::Colours.rev+'  Resolution: '+::Colours.steelblue('max-height: '+max_height?.to_s)
-    e
-    e 'The font name in use is: '+
-      ::Colours.steelblue(::Gtk::Settings.default.gtk_font_name)
-    e
-    e 'If the application makes use of a default .css file, then that file'
-    e 'is assumed to reside at '
-    e
-    e '  '+::Colours.sfancy(
-      project_css_file?
-    )
-    e
-    # ======================================================================= #
-    # Next, if we use a .config file then we will show more information.
-    # ======================================================================= #
-    if do_we_use_a_config_file?
-      _ = configuration?
-      this_file = _[1]+'/'+File.basename(_[1])+'.config'
-      e 'This application '+::Colours.crimson('DOES')+
-        ' make use of a .config file. That file '
-      e 'should be located at: '
-      e
-      e '  '+sfile(this_file)
-      e
-      e
-      e 'We will show information deduced from this file next.'
-      e
-      if File.exist? this_file
-        file_content = File.read(this_file).split("\n").map {|entry|
-          "  #{entry}"
-        }.join("\n")
-        e ::Colours.lightblue(
-            file_content
-          )
-      end
-      e
-      # ===================================================================== #
-      # Also show the CSS rules in use:
-      # ===================================================================== #
-      show_the_CSS_rules_in_use
-      e
-      # ===================================================================== #
-      # Show the user whether a global project.css file is used.
-      # ===================================================================== #
-      global_file_project_css = return_the_path_to_the_file_called_project_css(_[1])
-      e 'Does a global '+sfile('project.css')+' file exist, '\
-        'at location `'+global_file_project_css.to_s+'`? '+
-         sfancy(
-           File.exist?(
-             global_file_project_css
-           ).to_s
-         )
-    else
-      e 'This application does not make use of a .config file.'
-    end
-    # e '  Resolution: width:  '+width.to_s
-    # e '  Resolution: height: '+height.to_s
-    e
-  end; alias debug_widget  show_debug_information # === debug
-       alias debug_widget? show_debug_information # === debug?
-
-end; end

data/lib/gtk_paradise/base_module/draggable.rb

@@ -1,95 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'gtk_paradise/base_module/draggable.rb'
-# =========================================================================== #
-module Gtk
-
-module BaseModule
-
-  # ========================================================================= #
-  # === draggable_top_to_bottom_pane
-  #
-  # Simply pass the two widgets that you wish to have separated into
-  # this method.
-  # ========================================================================= #
-  def draggable_top_to_bottom_pane(
-      widget1 = nil,
-      widget2 = nil
-    )
-    if ::Gtk.use_gtk2?
-      paned = ::Gtk::HPaned.new
-    else
-      paned = ::Gtk::Paned.new(:horizontal)
-    end
-    if widget1 and widget1.is_a?(Array) and (widget1.size > 1)
-      widget2 = widget1.last # This must come first.
-      widget1 = widget1.first
-    end
-    paned.add1(widget1) if widget1
-    paned.add2(widget2) if widget2
-    return paned
-  end; alias up_and_down_pane                          draggable_top_to_bottom_pane # === up_and_down_pane
-       alias draggable_vertical_pane                   draggable_top_to_bottom_pane # === draggable_vertical_pane
-       alias draggable_up_and_down_pane                draggable_top_to_bottom_pane # === draggable_up_and_down_pane
-       alias gtk_pane_top_to_bottom                    draggable_top_to_bottom_pane # === gtk_pane_top_to_bottom
-       alias gtk_draggable_top_to_bottom               draggable_top_to_bottom_pane # === gtk_draggable_top_to_bottom
-       alias gtk_top_to_bottom_pane                    draggable_top_to_bottom_pane # === gtk_top_to_bottom_pane
-       alias gtk_drag_top_to_bottom                    draggable_top_to_bottom_pane # === gtk_drag_top_to_bottom
-       alias gtk_drag_top_to_bottom_pane               draggable_top_to_bottom_pane # === gtk_drag_top_to_bottom_pane
-       alias gtk_hbox_with_horizontal_pane             draggable_top_to_bottom_pane # === gtk_hbox_with_horizontal_pane
-       alias vertical_draggable_pane                   draggable_top_to_bottom_pane # === vertical_draggable_pane
-       alias gtk_vertical_dragger                      draggable_top_to_bottom_pane # === gtk_vertical_dragger
-       alias vertical_dragger                          draggable_top_to_bottom_pane # === vertical_dragger
-       alias vertical_pane                             draggable_top_to_bottom_pane # === vertical_pane
-       alias allow_left_to_right_dragging              draggable_top_to_bottom_pane # === allow_left_to_right_dragging
-       alias drag_via_left_and_right_movement          draggable_top_to_bottom_pane # === allow_left_to_right_dragging
-       alias drag_from_left_to_right                   draggable_top_to_bottom_pane # === drag_from_left_to_right
-       alias drag_it_left_to_right                     draggable_top_to_bottom_pane # === drag_it_left_to_right
-       alias left_to_right_dragger                     draggable_top_to_bottom_pane # === left_to_right_dragger
-       alias draggable_from_left_to_right              draggable_top_to_bottom_pane # === draggable_from_left_to_right
-       alias draggable_from_the_left_to_the_right_side draggable_top_to_bottom_pane # === draggable_from_the_left_to_the_right_side
-       alias draggable_via_left_to_right_movement      draggable_top_to_bottom_pane # === draggable_via_left_to_right_movement
-       alias draggable_from_the_left_to_the_right_side draggable_top_to_bottom_pane # === draggable_from_the_left_to_the_right_side
-       alias draggable_via_left_and_right_movement     draggable_top_to_bottom_pane # === draggable_via_left_and_right_movement
-
-  # ========================================================================= #
-  # === draggable_left_to_right_pane
-  #
-  # This method was added on 21.01.2021.
-  #
-  # The main idea for this method is to return a draggable hbox, but I keep
-  # on mixing up the name with a draggable vbox. Thus, the mental model for
-  # "left to right" is much easier to remember, hence the name. In the
-  # long run I will re-alias onto this method here, but for now it just
-  # is the way it is.
-  # ========================================================================= #
-  def draggable_left_to_right_pane(
-      widget1,
-      widget2
-    )
-    if ::Gtk.use_gtk2?
-      vpaned = ::Gtk::VPaned.new
-    else
-      vpaned = ::Gtk::Paned.new(:vertical)
-    end
-    vpaned.add1(widget1)
-    vpaned.add2(widget2)
-    return vpaned
-  end; alias gtk_left_to_right_dragger                 draggable_left_to_right_pane # === gtk_left_to_right_dragger
-       alias gtk_left_to_right_pane                    draggable_left_to_right_pane # === gtk_left_to_right_pane
-       alias gtk_drag_left_to_right                    draggable_left_to_right_pane # === gtk_drag_left_to_right
-       alias gtk_draggable_left_to_right               draggable_left_to_right_pane # === gtk_draggable_left_to_right
-       alias draggable_left_to_right                   draggable_left_to_right_pane # === draggable_left_to_right
-       alias draggable_horizontal_bar                  draggable_left_to_right_pane # === draggable_horizontal_bar
-       alias add_an_up_and_down_dragger                draggable_left_to_right_pane # === add_an_up_and_down_dragger
-       alias draggable_via_up_and_down_movement        draggable_left_to_right_pane # === draggable_via_up_and_down_movement
-       alias draggable_via_up_and_down_movements       draggable_left_to_right_pane # === draggable_via_up_and_down_movements
-       alias can_be_dragged_up_and_down                draggable_left_to_right_pane # === can_be_dragged_up_and_down
-       alias draggable_up_and_down                     draggable_left_to_right_pane # === draggable_up_and_down
-       alias drag_via_up_and_down_movement             draggable_left_to_right_pane # === draggable_from_the_left_to_the_right_side
-       alias gtk_drag_up_and_down                      draggable_left_to_right_pane # === gtk_drag_up_and_down
-       alias mouse_draggable_via_up_and_down_movement  draggable_left_to_right_pane # === mouse_draggable_via_up_and_down_movement
-
-end; end

data/lib/gtk_paradise/base_module/emoji.rb

@@ -1,107 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# === Gtk::BaseModule
-#
-# This file will contain wrapper-code over emojis, such as "smiley"
-# to refer to the smiley1-emoji.
-# =========================================================================== #
-# require 'gtk_paradise/base_module/emoji.rb'
-# =========================================================================== #
-module Gtk
-
-module BaseModule
-
-  require 'gtk_paradise/emojis/emojis.rb'
-
-  # ========================================================================= #
-  # === emoji
-  #
-  # This convenient method can be used to quickly use a Gtk::Label
-  # instance to add an emoji.
-  #
-  # Usage exmaples:
-  #
-  #   emoji(:pin)
-  #   emoji(:arrow_right)
-  #   emoji_label(:croatia)
-  #
-  # ========================================================================= #
-  def emoji(i = :arrow_right)
-    gtk_label(
-      ::Gtk::Emojis.map_emoji(i)
-    )
-  end; alias emoji_label emoji # === emoji_label
-       alias gtk_emoji   emoji # === gtk_emoji
-
-  # ========================================================================= #
-  # === return_emoji
-  # ========================================================================= #
-  def return_emoji(i)
-    ::Gtk::Emojis.map_emoji(i)
-  end; alias map_emoji return_emoji # === map_emoji
-
-  # ========================================================================= #
-  # === smiley1
-  # ========================================================================= #
-  def smiley1
-    ::Gtk::Emojis::SMILEY_1
-  end
-
-  # ========================================================================= #
-  # === smiley2
-  # ========================================================================= #
-  def smiley2
-    ::Gtk::Emojis::SMILEY_2
-  end
-
-  # ========================================================================= #
-  # === smiley3
-  # ========================================================================= #
-  def smiley3
-    ::Gtk::Emojis::SMILEY_3
-  end
-
-  # ========================================================================= #
-  # === smiley4
-  # ========================================================================= #
-  def smiley4
-    ::Gtk::Emojis::SMILEY_4
-  end
-
-  # ========================================================================= #
-  # === smiley5
-  # ========================================================================= #
-  def smiley5
-    ::Gtk::Emojis::SMILEY_5
-  end
-
-  # ========================================================================= #
-  # === right_arrow_emoji
-  #
-  # This is guaranteed to return the right-arrow emoji. The usual symbol
-  # for the right-arrow emoji is '➡️'.
-  # ========================================================================= #
-  def right_arrow_emoji
-    emoji(:arrow_right)
-  end; alias gtk_label_arrow_right right_arrow_emoji # === gtk_label_arrow_right
-
-  # ========================================================================= #
-  # === left_arrow_emoji
-  # ========================================================================= #
-  def left_arrow_emoji
-    emoji(:arrow_left)
-  end; alias gtk_label_arrow_left left_arrow_emoji # === gtk_label_arrow_left
-
-  # ========================================================================= #
-  # === emoji_image
-  #
-  # This is just a wrapper over gtk_image really; but I think it may
-  # be helpful when designing GUIs, as a simple memory-mapper.
-  # ========================================================================= #
-  def emoji_image(i = :right_arrow)
-    gtk_image(i) # This will handle special symbols properly.
-  end
-
-end; end

data/lib/gtk_paradise/base_module/esystem.rb

@@ -1,22 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'gtk_paradise/base_module/esystem.rb'
-# =========================================================================== #
-module Gtk
-
-module BaseModule
-
-  # ========================================================================= #
-  # === esystem
-  #
-  # This method will first output the argument, then run system() on it.
-  # It is thus a verbose way to run system-commands.
-  # ========================================================================= #
-  def esystem(i)
-    puts i
-    system i
-  end
-
-end; end