gtk_paradise 0.9.120 → 0.11.19

data/lib/gtk_paradise/widgets/shared_code/notebook_tab_with_icon/notebook_tab_with_icon_module.rb

@@ -1,297 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# === Gtk::NotebookTabWithIconModule
-#
-# This module represents a widget that can be put into notebooks, which
-# have a little icon, typically on their left side on top.
-#
-# How to create a new instance of class Gtk::NotebookTabWithIcon,
-# specifically?
-#
-# First, create your Gtk::Notebook in the usual way, like so:
-#
-#   @notebook = Gtk::Notebook.new
-#
-# or:
-#
-#   @notebook = gtk_notebook
-#
-# Now, to add a page with an icon to your notebook tab, simply do this:
-#
-#   @notebook.append_page_menu( Gtk::Label.new('SomeWidget'), ::Gtk::NotebookTabWithIcon.new )
-#
-# Or:
-#
-#   @notebook.append_page_menu( gtk_label('SomeWidget'), gtk_notebook_tab_with_icon)
-#
-# As example, you can pick among the following to do a tab:
-#
-#   Gtk::NotebookTabWithIcon.new # picks default
-#   Gtk::NotebookTabWithIcon.new('rand')
-#   Gtk::NotebookTabWithIcon.new('some/path/file.png')
-#
-# =========================================================================== #
-# require 'gtk_paradise/widgets/shared_code/notebook_tab_with_icon/notebook_tab_with_icon_module.rb'
-# include ::Gtk::NotebookTabWithIconModule
-# =========================================================================== #
-module Gtk
-
-module NotebookTabWithIconModule
-
-  require 'gtk_paradise/requires/require_the_base_module.rb'
-  include ::Gtk::BaseModule
-
-  # ========================================================================= #
-  # === NAMESPACE
-  # ========================================================================= #
-  NAMESPACE = inspect
-
-  # ========================================================================= #
-  # === TITLE
-  # ========================================================================= #
-  TITLE = 'NotebookTabWithIcon'
-
-  # ========================================================================= #
-  # === WIDTH
-  # ========================================================================= #
-  WIDTH =  300
-
-  # ========================================================================= #
-  # === HEIGHT
-  # ========================================================================= #
-  HEIGHT = 120
-
-  # ========================================================================= #
-  # === initialize
-  #
-  # Four input-arguments can be provided. Their meaning is:
-  #
-  #   (1) location_of_the_image # The location to the image that you wish to use.
-  #   (2) label_title  # The title of the label, appearing next to the image
-  #   (3) text_colour  # The colour of the label
-  #   (4) can_focus    # whether the user can select (focus) on it
-  #
-  # ========================================================================= #
-  def initialize(
-      location_of_the_image = :small_shield,
-      label_title  = '',
-      text_colour  = 'black',
-      can_focus    = false,
-      run_already = true
-    )
-    super(:horizontal)
-    reset
-    @label_title = label_title
-    @text_colour = text_colour
-    set_location_of_the_image(
-      location_of_the_image
-    )
-    run if run_already
-  end
-
-  # ========================================================================= #
-  # === reset                                                     (reset tag)
-  # ========================================================================= #
-  def reset
-    reset_the_internal_variables
-    # ======================================================================= #
-    # === @configuration
-    # ======================================================================= #
-    @configuration = [true, __dir__, NAMESPACE]
-    # ======================================================================= #
-    # === @title
-    # ======================================================================= #
-    @title  = TITLE
-    # ======================================================================= #
-    # === @width
-    # ======================================================================= #
-    set_width(WIDTH)
-    # ======================================================================= #
-    # === @height
-    # ======================================================================= #
-    set_height(HEIGHT)
-    # ======================================================================= #
-    # === @image
-    # ======================================================================= #
-    @image = nil
-    set_use_this_font(:dejavu_condensed_22)
-    use_gtk_paradise_project_css_file
-    infer_the_size_automatically
-  end
-
-  # ========================================================================= #
-  # === update_icon
-  #
-  # With this you can update the icon. It will always point to @location_of_the_image
-  # ========================================================================= #
-  def update_icon(i = @location_of_the_image)
-    if use_gtk2?
-      @image.set(i)
-    else
-      if File.exist? i
-        @image.set_file(i)
-      else
-        puts "No file exists at `#{i}`."
-      end
-    end
-  end
-
-  # ========================================================================= #
-  # === padding?
-  # ========================================================================= #
-  def padding?
-    2
-  end
-
-  # ========================================================================= #
-  # === border_size?
-  # ========================================================================= #
-  def border_size?
-    2
-  end
-
-  # ========================================================================= #
-  # === create_skeleton                                          (create tag)
-  # ========================================================================= #
-  def create_skeleton
-    create_image
-  end
-
-  # ========================================================================= #
-  # === set_tab_pos
-  # ========================================================================= #
-  def set_tab_pos(i)
-    super(i)
-  end
-
-  # ========================================================================= #
-  # === create_image
-  #
-  # This will assign to the variable called @image.
-  # ========================================================================= #
-  def create_image
-    @image = gtk_image
-    @image.set_padding(3, 1)
-  end
-
-  # ========================================================================= #
-  # === change_location_of_the_image_and_icon
-  # ========================================================================= #
-  def change_location_of_the_image_and_icon(
-      i = @location_of_the_image
-    )
-    change_location_of_the_image(i)
-    change_icon(i)
-  end
-
-  # ========================================================================= #
-  # === set_location_of_the_image
-  # ========================================================================= #
-  def set_location_of_the_image(i = :default)
-    case i
-    # ======================================================================= #
-    # === :tabble
-    # ======================================================================= #
-    when :tabble,
-         :default
-      i = '/home/x/DATA/images/PC/OS/LINUX/TABBLE.png'
-    # ======================================================================= #
-    # === small_shield
-    # ======================================================================= #
-    when :small_shield
-      i = project_base_directory?+'images/misc/small_shield.png'
-    end
-    @location_of_the_image = i # gi $MY_USERS/x/DATA/IMG/RPG/STD/SMALL_SHIELD.png
-  end
-
-  # ========================================================================= #
-  # === change_location_of_the_image
-  #
-  # With this you can manipulate @location_of_the_image
-  # ========================================================================= #
-  def change_location_of_the_image(
-      this_location = @location_of_the_image
-    )
-    img = '/home/x/DATA/images/'
-    case this_location.to_s
-    when 'rand','r'
-      # cd $RUBY_GTK/GAM/MINESWEEPER/images/symbols/
-      img_base = ENV['RUBY_GTK'].to_s+'/games/MINESWEEPER/images/symbols/'
-      case rand(7)
-      when 0 then set_location_of_the_image(img_base+'bang.png')
-      when 1 then set_location_of_the_image(img_base+'flag.png')
-      when 2 then set_location_of_the_image(img_base+'flag-question.png')
-      when 3 then set_location_of_the_image(img_base+'mine.png')
-      when 4 then set_location_of_the_image('/home/x/DATA/images/STD/TELEFON.png')
-      when 5 then change_location_of_the_image('bopen')
-      when 6 then change_location_of_the_image('bclose')
-      end
-    # ======================================================================= #
-    # === shield
-    #
-    # shield icon
-    # ======================================================================= #
-    when 'shield',
-         's'
-      set_location_of_the_image(project_base_directory?+'images/misc/small_shield.png')
-    # ======================================================================= #
-    # === alert
-    #
-    # Ausrufungszeichen
-    # ======================================================================= #
-    when 'alert',
-         'ausrufungszeichen'
-      set_location_of_the_image(img+'/STD/AUSRUFUNGSZEICHEN.png')
-    # ======================================================================= #
-    # === book_open
-    # ======================================================================= #
-    when 'book_open',
-         'bopen'
-      set_location_of_the_image(img+'/STD/BOOK_OPENED.png')
-    # ======================================================================= #
-    # === book_close
-    # ======================================================================= #
-    when 'book_close',
-         'bclose'
-      set_location_of_the_image(img+'/STD/BOOK_CLOSED.png')
-    end
-  end
-
-  # ========================================================================= #
-  # === connect_skeleton                                        (connect tag)
-  # ========================================================================= #
-  def connect_skeleton
-    abort_on_exception
-    minimal(@image, 0)
-    minimal(modify_label(@label_title, @text_colour), 0)
-  end
-
-  # ========================================================================= #
-  # === run                                                         (run tag)
-  # ========================================================================= #
-  def run
-    create_skeleton_then_connect_skeleton
-    change_location_of_the_image
-    update_icon
-    self.can_focus = false
-    show_all
-  end
-
-  # ========================================================================= #
-  # === Gtk::NotebookTabWithIconModule.run
-  # ========================================================================= #
-  def self.run(
-      i = ARGV
-    )
-    require 'gtk_paradise/run'
-    _ = ::Gtk::NotebookTabWithIcon.new(:tabble, 'Here is the original label.')
-    r = ::Gtk.run
-    r.title = 'Some random title here.'
-    r << _
-    r.set_size_request(_.width?, _.height?)
-    r.top_left_then_run
-  end
-
-end; end

data/lib/gtk_paradise/widgets/shared_code/ping_widget/ping_widget_module.rb

@@ -1,326 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# === Gtk::PingWidgetModule
-# =========================================================================== #
-# require 'gtk_paradise/widgets/shared_code/ping_widget/ping_widget_module.rb'
-# include ::Gtk::PingWidgetModule
-# =========================================================================== #
-module Gtk
-
-module PingWidgetModule
-
-  require 'gtk_paradise/requires/require_the_base_module.rb'
-  include ::Gtk::BaseModule
-
-  # ========================================================================= #
-  # === NAMESPACE
-  # ========================================================================= #
-  NAMESPACE = inspect
-
-  # ========================================================================= #
-  # === TITLE
-  # ========================================================================= #
-  TITLE = 'Ping'
-
-  # ========================================================================= #
-  # === WIDTH
-  # ========================================================================= #
-  WIDTH = '60% or minimum 400px'
-
-  # ========================================================================= #
-  # === HEIGHT
-  # ========================================================================= #
-  HEIGHT = '40% or minimum 300px'
-
-  begin
-    require 'net/ping'
-  rescue LoadError; end
-
-  begin
-    require 'verbose_truth'
-  rescue LoadError; end
-
-  # ========================================================================= #
-  # === USE_THIS_FONT
-  # ========================================================================= #
-  USE_THIS_FONT = :dejavu_condensed_21
-
-  # ========================================================================= #
-  # === USE_THIS_SMALLER_FONT
-  # ========================================================================= #
-  USE_THIS_SMALLER_FONT = :dejavu_condensed_19
-
-  # ========================================================================= #
-  # === initialize
-  # ========================================================================= #
-  def initialize(
-      commandline_arguments = ARGV,
-      run_already           = true
-    )
-    super(:vertical)
-    reset
-    set_commandline_arguments(
-      commandline_arguments
-    )
-    run if run_already
-  end
-
-  # ========================================================================= #
-  # === reset                                                     (reset tag)
-  # ========================================================================= #
-  def reset
-    reset_the_internal_variables
-    # ======================================================================= #
-    # === @configuration
-    # ======================================================================= #
-    @configuration = [true, "#{__dir__}/", NAMESPACE]
-    # ======================================================================= #
-    # === @title
-    # ======================================================================= #
-    set_title(TITLE)
-    # ======================================================================= #
-    # === @width
-    # ======================================================================= #
-    set_width(WIDTH)
-    # ======================================================================= #
-    # === @height
-    # ======================================================================= #
-    set_height(HEIGHT)
-    set_use_this_font(USE_THIS_FONT)
-    handle_CSS_rules
-    infer_the_size_automatically
-  end
-
-  # ========================================================================= #
-  # === padding?
-  # ========================================================================= #
-  def padding?
-    4
-  end
-
-  # ========================================================================= #
-  # === border_size?
-  # ========================================================================= #
-  def border_size?
-    2
-  end
-
-  # ========================================================================= #
-  # === create_the_buttons                          (buttons tag, button tag)
-  # ========================================================================= #
-  def create_the_buttons
-    # ======================================================================= #
-    # === @button_do_the_ping_action
-    # ======================================================================= #
-    @button_do_the_ping_action = button('_Ping')
-    @button_do_the_ping_action.bblack2
-    @button_do_the_ping_action.on_clicked {
-      do_the_ping_action
-    }
-    # ======================================================================= #
-    # === @button_open_in_the_browser
-    # ======================================================================= #
-    @button_open_in_the_browser = button('_Open in the browser')
-    @button_open_in_the_browser.bblack2
-    @button_open_in_the_browser.hint = 'This button will attempt '\
-      'to open the assigned entry in the browser.'
-    @button_open_in_the_browser.on_clicked {
-      do_open_in_the_browser
-    }
-  end
-
-  # ========================================================================= #
-  # === create_entries                               (entries tag, entry tag)
-  # ========================================================================= #
-  def create_entries
-    # ======================================================================= #
-    # === @entry_use_this_URL
-    # ======================================================================= #
-    @entry_use_this_URL = gtk_entry
-    @entry_use_this_URL.bblack2
-    @entry_use_this_URL.yellow_background
-    @entry_use_this_URL.on_click_select_everything
-    @entry_use_this_URL.on_enter { do_the_ping_action }
-    @entry_use_this_URL.width_height(600, 50)
-    @entry_use_this_URL.hint =
-      "Input a remote URL here, which will be the URL that we wish "\
-      "to check, via a ping-event.\n\n"+
-      "Additional information will then be shown in the area below "\
-      "this entry.\n"
-    if @entry_use_this_URL.respond_to? :shadow_hint=
-      # ===================================================================== #
-      # This here works only on ruby-gtk3.
-      # ===================================================================== #
-      @entry_use_this_URL.shadow_hint = 'Input a remote URL here.'
-    end
-  end
-
-  # ========================================================================= #
-  # === create_the_labels
-  # ========================================================================= #
-  def create_the_labels
-    # ======================================================================= #
-    # === @label_for_the_connection_status
-    # ======================================================================= #
-    @label_for_the_connection_status = gtk_label
-    @label_for_the_connection_status.make_selectable
-    @label_for_the_connection_status.use_this_font = USE_THIS_SMALLER_FONT
-  end
-
-  # ========================================================================= #
-  # === connect_skeleton                                        (connect tag)
-  # ========================================================================= #
-  def connect_skeleton
-    abort_on_exception
-    create_the_labels
-    create_entries
-    hbox = gtk_hbox
-    image = image_network_cellular_connected_symbolic_symbolic
-    hbox.minimal(image, 10)
-    @spinner = return_inactive_spinner
-    hbox.minimal(@spinner, 10)
-    label = gtk_left_aligned_label('Address')
-    hbox.minimal(label, 10)
-    hbox.minimal(@entry_use_this_URL,         8)
-    hbox.minimal(@button_do_the_ping_action,  8)
-    hbox.minimal(@button_open_in_the_browser, 8)
-    minimal(hbox, 1)
-    hbox2 = gtk_hbox
-    hbox2.minimal(@label_for_the_connection_status, 15)
-    minimal(hbox2, 8)
-  end
-
-  # ========================================================================= #
-  # === remote_URL?
-  # ========================================================================= #
-  def remote_URL?
-    @entry_use_this_URL.text?.to_s
-  end
-
-  # ========================================================================= #
-  # === create_skeleton                                          (create tag)
-  # ========================================================================= #
-  def create_skeleton
-    create_the_buttons
-  end
-
-  # ========================================================================= #
-  # === is_it_up?
-  # ========================================================================= #
-  def is_it_up?(host)
-    if Object.const_defined? :Net
-      check = Net::Ping::External.new(host)
-      return check.ping?
-    else
-      _ = popup_over_this_widget(
-        @entry_use_this_URL,
-        "Net::Ping::External is unavailable. "\
-        "Has the <b>net-ping gem</b> been installed?\n\n"\
-        "Consider installing it via:\n\n  <b>gem install net-ping</b>\n\n"\
-        "Alternatively click the button below, which will "\
-        "try to invoke that command.\n"
-      )
-      vbox = gtk_vbox
-      button_gem_install_net_ping = button('gem install net-ping')
-      button_gem_install_net_ping.on_clicked {
-        esystem button_gem_install_net_ping.text?
-        try_to_require_net_ping
-      }
-      vbox.add(button_gem_install_net_ping)
-      vbox.show_all
-      _.children.first.add(vbox)
-      _.margin = 6
-      _.bblack3
-      _.pad10px
-      _.use_this_font = :hack_18
-      _.popup
-    end
-  end
-
-  # ========================================================================= #
-  # === try_to_require_net_ping
-  # ========================================================================= #
-  def try_to_require_net_ping
-    begin
-      require 'net/ping'
-    rescue LoadError; end
-  end
-
-  # ========================================================================= #
-  # === handle_CSS_rules
-  # ========================================================================= #
-  def handle_CSS_rules
-    use_gtk_paradise_project_css_file
-  end
-
-  # ========================================================================= #
-  # === do_the_ping_action
-  # ========================================================================= #
-  def do_the_ping_action(
-      use_this_url = remote_URL?
-    )
-    @spinner.start_spinning
-    Thread.new {
-      up_or_down = is_it_up?(use_this_url)
-      _ = 'Is a connection available to <b>'+
-          remote_URL?+'</b>? <span weight="bold" color="darkblue">'+
-          VerboseTruth[up_or_down].to_s+
-          '</span>'.dup
-      _ << return_string_for_remote_address(remote_URL?)
-      _ = 'Please assign a remote host in the input area above.' if use_this_url.empty?
-      @label_for_the_connection_status.set_text(_)
-      @label_for_the_connection_status.do_markify
-      @spinner.stop_spinning
-    }
-  end
-
-  # ========================================================================= #
-  # === return_string_for_remote_address
-  # ========================================================================= #
-  def return_string_for_remote_address(
-      use_this_URL = remote_URL?
-    )
-    _ = ''.dup
-    result = `host -t a #{use_this_URL}`
-    if result.include? ' '
-      the_IP_is = result.split(' ').last.to_s
-      _ << " The remote IP associated with this URL\n"\
-           "is <b>#{the_IP_is}</b>."
-    end
-    return _
-  end
-
-  # ========================================================================= #
-  # === do_open_in_the_browser                                     (open tag)
-  # ========================================================================= #
-  def do_open_in_the_browser(
-      use_this_url = @entry_use_this_URL.text?
-    )
-    require 'open'
-    Open.in_browser(use_this_url)
-  end
-
-  # ========================================================================= #
-  # === run                                                         (run tag)
-  # ========================================================================= #
-  def run
-    create_skeleton_then_connect_skeleton
-  end
-
-  # ========================================================================= #
-  # === Gtk::PingWidgetModule.run
-  # ========================================================================= #
-  def self.run(
-      i = ARGV
-    )
-    require 'gtk_paradise/run'
-    _ = ::Gtk::PingWidget.new(i)
-    r = ::Gtk.run
-    r << _
-    r.automatic_size_then_automatic_title
-    r.top_left_then_run
-  end
-
-end; end

data/lib/gtk_paradise/widgets/version_agnostic/button_with_border.rb

@@ -1,63 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# === Gtk::ButtonWithBorder
-#
-# This button has to display a coloured border around itself. It also 
-# has to work on both ruby-gtk2 and ruby-gtk3.
-#
-# Essentially the "base" is that of a gtk-frame.
-# =========================================================================== #
-# require 'gtk_paradise/widgets/version_agnostic/button_with_border.rb'
-# =========================================================================== #
-module Gtk
-
-class ButtonWithBorder < ::Gtk::Frame
-
-  # ========================================================================= #
-  # === initialize
-  # ========================================================================= #
-  def initialize(
-      run_already = true
-    )
-    super()
-    set_border_colour
-    run if run_already
-  end
-
-  # ========================================================================= #
-  # === run
-  # ========================================================================= #
-  def run
-    if respond_to? :modify_background
-      modify_background(:normal, @border_colour)
-      set_shadow_type(::Gtk::SHADOW_IN)
-    else
-      override_background_colour(:normal, @border_colour)
-      set_shadow_type(:in)
-    end
-  end
-
-  # ========================================================================= #
-  # === set_border_colour
-  #
-  # Designate the colour of the border to use via this method. By default
-  # this will be in the colour "steelblue".
-  # ========================================================================= #
-  def set_border_colour(i = :steelblue)
-    @border_colour = i.to_sym
-  end; alias set_border_color set_border_colour # === set_border_color
-       alias border_colour=   set_border_colour # === border_colour=
-       alias border_color=    set_border_colour # === border_color=
-
-end; end
-
-if __FILE__ == $PROGRAM_NAME
-  require 'gtk3'
-  _ = Gtk::ButtonWithBorder.new
-  window = Gtk::Window.new
-  window.add(_)
-  window.show_all
-  Gtk.main
-end