roebe 0.5.120 → 0.5.121

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa1a2f0cdbbff340235dc00434f2470dee67f52285ca32fc4e8f80e06826335d
-  data.tar.gz: 3de92297fc2dd02993c2905e806d397c825d25c3f19bd5026c8667be36faf49c
+  metadata.gz: 06eccabbcf87691cec4f6540daf190127813031321ad2bc006e66a6d8ccf26eb
+  data.tar.gz: 692fa127104bfe204b2ff1c5916f9618085d7f37a95da5405b23087378903ae0
 SHA512:
-  metadata.gz: 32a290966aa80fa9d3a8f39d4ccec6ba824d534554aa57d918f5b8c8c02eb23d6c3ee515560a6da307aa9c7d097eb766a508942e064bd7cde636f2f11a6dafa5
-  data.tar.gz: 6946944801715cdf3f5a61c1ed94eb26fbd9a31f08312085f04e56d32424b0e7ab8b0b907fc62e053baeefe3dd4a0475a22efe82ca420f7f904ff6a2f4b32807
+  metadata.gz: ffe2702e58ab5b4abdb18fe1dd1976b50d517df4428842ce50ba44a3a42585d3258be5412f272759a70e21a97b728744a99c2b3b3eea0bb0960586329e259880
+  data.tar.gz: 690f734508cb703306a36a637cd1c6187d7f88f137117061481e1499961c144678503493e821dc35333ace4198cffee38c067e32a91ac41035dfab40254cde8b

data/README.md

@@ -2,7 +2,7 @@
 [![forthebadge](https://forthebadge.com/images/badges/made-with-ruby.svg)](https://www.ruby-lang.org/en/)
 [![Gem Version](https://badge.fury.io/rb/roebe.svg)](https://badge.fury.io/rb/roebe)
 
-This gem was <b>last updated</b> on the <span style="color: darkblue; font-weight: bold">30.07.2022</span> (dd.mm.yyyy notation), at <span style="color: steelblue; font-weight: bold">14:15:13</span> o'clock.
+This gem was <b>last updated</b> on the <span style="color: darkblue; font-weight: bold">06.08.2022</span> (dd.mm.yyyy notation), at <span style="color: steelblue; font-weight: bold">00:07:22</span> o'clock.
 
 ## Introducing the Roebe project
 
@@ -1425,39 +1425,6 @@ Eventually I may auto-generate the UUID entry as well, but for now
 I only wanted to remove the old code from **Roebe::FstabAppender**
 really.
 
-## GUIs: Graphical User Interfaces
-
-The roebe gem comes with a few GUI bindings. These are mostly just small
-things, for demo-purposes.
-
-Traditionally I have been using ruby-gtk, but since as of 2021 I am also
-using **libui**. Expect more libui-centric widgets to be added over the coming
-years.
-
-To keep track which widgets were ported already the following small table
-may be useful but it may become outdated eventually:
-
-    (1) show_ten_aliases.rb          # Just show the next ten exam topics; evidently only useful on my home system really
-    (2) wlan_interface.rb            # This is about 80% complete; the combo-box is missing so far and the middle-buttons.
-    (3) interactive_caesar_cipher.rb # This is mostly complete; could need some minor improvements but for now it's fine.
-    (4) show_aliases                 # This is mostly complete, about 98%. Perhaps a few minor tweaks but for now it's fine.
-
-Since as of **September 2021 I** am experimenting with the project called
-**simple_widgets**. The idea behind this project is to make it
-possible to use different GUI toolkits. As to whether this will be used
-for the whole code base remains to be seen.
-
-For now the first widget has been ported onto SimpleWidgets. Invoke this
-from the commandline via:
-
-    roebe --caesar-gtk    # for the gtk variant
-    roebe --caesar-libui  # for the libui variant
-
-You need ruby-gtk3 and ruby-libui for this, so install these first.
-
-We there use the same code base, but can support both ruby-gtk as
-well as ruby-libui at the same time. \o/
-
 ## class Roebe::SymlinkFilesFromThatDirectoryToTheCurrentDirectory.new
 
 First, before explaining what this class do, let's see how to use
@@ -2396,6 +2363,22 @@ may benefit from this class, but I realised that not a single
 other project ever made use of that code - so, better to get
 rid of "dead" code instead.
 
+### The gtk-shell interface
+
+There is a GUI for the shell, in <b>ruby-gtk3</b>. It is not
+the prettiest thing in the world, but I wanted to be able to
+use a GUI for the shell.
+
+The following picture shows how this may look (in <b>August
+2022</b>):
+
+<img src="https://i.imgur.com/Vb0pySJ.png" style="margin: 1em">
+
+This may not be extremely pretty, but for now getting the
+functionality to work without any bugs is the most important
+objective. At a later this may be improved upon, visually
+as well.
+
 ## class Roebe::Configuration::Configuration
 
 This class used to be a separate project (a standalone gem),
@@ -2505,6 +2488,46 @@ so far:
  Roebe::TakeScreenshot     |   TakeScreenshot.java           |  80%
  Roebe::ShowPrimeNumbers   |   ShowPrimeNumbers.java         |  10%
 
+## GUIs: Graphical User Interfaces
+
+The <b>roebe</b> gem comes with a few GUI bindings. These are mostly just
+small things, for demo-purposes. For reasons of simplicity I consider
+www-specific code to be a GUI as well, such as any interface through
+the sinatra gem.
+
+Traditionally I have been using ruby-gtk, but since as of 2021 I am also
+using **libui**. Expect more libui-centric widgets to be added over the
+coming years.
+
+To keep track which widgets were ported already the following small table
+may be useful but it may become outdated eventually:
+
+    (1) show_ten_aliases.rb          # Just show the next ten exam topics; evidently only useful on my home system really
+    (2) wlan_interface.rb            # This is about 80% complete; the combo-box is missing so far and the middle-buttons.
+    (3) interactive_caesar_cipher.rb # This is mostly complete; could need some minor improvements but for now it's fine.
+    (4) show_aliases                 # This is mostly complete, about 98%. Perhaps a few minor tweaks but for now it's fine.
+
+Since as of **September 2021 I** am experimenting with the project called
+**simple_widgets**. The idea behind this project is to make it
+possible to use different GUI toolkits. As to whether this will be used
+for the whole code base remains to be seen.
+
+For now the first widget has been ported onto SimpleWidgets. Invoke this
+from the commandline via:
+
+    roebe --caesar-gtk    # for the gtk variant
+    roebe --caesar-libui  # for the libui variant
+
+You need ruby-gtk3 and ruby-libui for this, so install these first.
+
+We there use the same code base, but can support both ruby-gtk as
+well as ruby-libui at the same time. \o/
+
+Since as of <b>August 2022</b> the ruby-gtk2 bindings have been
+mildly deprecated. They may remain as part of the roebe gem,
+but it is unlikely that any new ruby-gtk2 code is added. ruby-gtk3
+is better than ruby-gtk2 at this point in time.
+
 
 ## Contact information and mandatory 2FA coming up in 2022
 

data/doc/README.gen

@@ -1422,39 +1422,6 @@ Eventually I may auto-generate the UUID entry as well, but for now
 I only wanted to remove the old code from **Roebe::FstabAppender**
 really.
 
-## GUIs: Graphical User Interfaces
-
-The roebe gem comes with a few GUI bindings. These are mostly just small
-things, for demo-purposes.
-
-Traditionally I have been using ruby-gtk, but since as of 2021 I am also
-using **libui**. Expect more libui-centric widgets to be added over the coming
-years.
-
-To keep track which widgets were ported already the following small table
-may be useful but it may become outdated eventually:
-
-    (1) show_ten_aliases.rb          # Just show the next ten exam topics; evidently only useful on my home system really
-    (2) wlan_interface.rb            # This is about 80% complete; the combo-box is missing so far and the middle-buttons.
-    (3) interactive_caesar_cipher.rb # This is mostly complete; could need some minor improvements but for now it's fine.
-    (4) show_aliases                 # This is mostly complete, about 98%. Perhaps a few minor tweaks but for now it's fine.
-
-Since as of **September 2021 I** am experimenting with the project called
-**simple_widgets**. The idea behind this project is to make it
-possible to use different GUI toolkits. As to whether this will be used
-for the whole code base remains to be seen.
-
-For now the first widget has been ported onto SimpleWidgets. Invoke this
-from the commandline via:
-
-    roebe --caesar-gtk    # for the gtk variant
-    roebe --caesar-libui  # for the libui variant
-
-You need ruby-gtk3 and ruby-libui for this, so install these first.
-
-We there use the same code base, but can support both ruby-gtk as
-well as ruby-libui at the same time. \o/
-
 ## class Roebe::SymlinkFilesFromThatDirectoryToTheCurrentDirectory.new
 
 First, before explaining what this class do, let's see how to use
@@ -2393,6 +2360,22 @@ may benefit from this class, but I realised that not a single
 other project ever made use of that code - so, better to get
 rid of "dead" code instead.
 
+### The gtk-shell interface
+
+There is a GUI for the shell, in <b>ruby-gtk3</b>. It is not
+the prettiest thing in the world, but I wanted to be able to
+use a GUI for the shell.
+
+The following picture shows how this may look (in <b>August
+2022</b>):
+
+<img src="https://i.imgur.com/Vb0pySJ.png" style="margin: 1em">
+
+This may not be extremely pretty, but for now getting the
+functionality to work without any bugs is the most important
+objective. At a later this may be improved upon, visually
+as well.
+
 ## class Roebe::Configuration::Configuration
 
 This class used to be a separate project (a standalone gem),
@@ -2502,4 +2485,44 @@ so far:
  Roebe::TakeScreenshot     |   TakeScreenshot.java           |  80%
  Roebe::ShowPrimeNumbers   |   ShowPrimeNumbers.java         |  10%
 
+## GUIs: Graphical User Interfaces
+
+The <b>roebe</b> gem comes with a few GUI bindings. These are mostly just
+small things, for demo-purposes. For reasons of simplicity I consider
+www-specific code to be a GUI as well, such as any interface through
+the sinatra gem.
+
+Traditionally I have been using ruby-gtk, but since as of 2021 I am also
+using **libui**. Expect more libui-centric widgets to be added over the
+coming years.
+
+To keep track which widgets were ported already the following small table
+may be useful but it may become outdated eventually:
+
+    (1) show_ten_aliases.rb          # Just show the next ten exam topics; evidently only useful on my home system really
+    (2) wlan_interface.rb            # This is about 80% complete; the combo-box is missing so far and the middle-buttons.
+    (3) interactive_caesar_cipher.rb # This is mostly complete; could need some minor improvements but for now it's fine.
+    (4) show_aliases                 # This is mostly complete, about 98%. Perhaps a few minor tweaks but for now it's fine.
+
+Since as of **September 2021 I** am experimenting with the project called
+**simple_widgets**. The idea behind this project is to make it
+possible to use different GUI toolkits. As to whether this will be used
+for the whole code base remains to be seen.
+
+For now the first widget has been ported onto SimpleWidgets. Invoke this
+from the commandline via:
+
+    roebe --caesar-gtk    # for the gtk variant
+    roebe --caesar-libui  # for the libui variant
+
+You need ruby-gtk3 and ruby-libui for this, so install these first.
+
+We there use the same code base, but can support both ruby-gtk as
+well as ruby-libui at the same time. \o/
+
+Since as of <b>August 2022</b> the ruby-gtk2 bindings have been
+mildly deprecated. They may remain as part of the roebe gem,
+but it is unlikely that any new ruby-gtk2 code is added. ruby-gtk3
+is better than ruby-gtk2 at this point in time.
+
 ADD_CONTACT_INFORMATION

data/doc/add_ons_for_ruby/fxruby.md

@@ -0,0 +1,14 @@
+## How to require and include Fox
+
+  require 'fox16'
+  include Fox
+
+  # Or alternatively
+
+  require 'fox14'
+  include Fox
+
+## How to instantiate a new main application
+
+  main_application = Fox::FXApp.new
+  main_window = Fox::FXMainWindow.new(main_application, "This Is A Title")

data/doc/add_ons_for_ruby/prawn.md

@@ -0,0 +1,12 @@
+## Use a particular font size:
+
+  Prawn::Document.generate("example.pdf") do
+    font "Times-Roman"
+    draw_text "Hello World", at: [200,720], size: 32
+  end
+
+## Generate a .pdf file with a specific page size:
+
+  pdf = Prawn::Document.new(page_size: "A4",
+          page_layout: :landscape
+        )

data/doc/sinatra_tutorial/sinatra_tutorial.rb

@@ -1,3 +1,4 @@
+# http://localhost/programming/ruby/src/roebe/doc/sinatra_tutorial/sinatra_tutorial.cgi
 english('Sinatra Tutorial') {
 autoextend
 ruby_favicon
@@ -41,7 +42,7 @@ doc('mar0px pad0px s0_8em') {
   # ========================================================================= # 
   sinatra_header 'Requiring sinatra','BO marb1px'
   p_default {
-    fragebr 'How do we require sinatra?'
+    frage 'How do we require sinatra?'
     cmd "  require 'sinatra'"
   }
   # ========================================================================= #
@@ -73,10 +74,10 @@ doc('mar0px pad0px s0_8em') {
     cmd2 "    'Hello, world!'"
     cmd  "  end"
     br
-    anm 'Note that the method <b style="color:tomato">get()</b> is just
-    about the most important method as far as sinatra is concerned.
+    anm 'Note that the method <b class="BOLD" style="color: royalblue">get()</b> is
+    just about the most important method as far as sinatra is concerned.
     Another fairly commonly used route are <b>post()</b> routes.'
-    br
+    brbr
     e 'Routes will be processed in linear order, from top to bottom.
     This means that the last defined route is the one that will be
     in effect. More information about this can be seen
@@ -291,22 +292,6 @@ doc('mar0px pad0px s0_8em') {
     cmd  'expires 3600, :public, :must_revalidate'
   }
   # ========================================================================= #
-  # === How can we obtain all parameters via splat in sinatra? (splat tag, all tag)
-  # ========================================================================= # 
-  sinatra_header 'How can we obtain all parameters via splat in sinatra?',
-  'BO marb1px'
-  p_default {
-    cmd  "get('/more/*') {"
-    cmd2 '  params[:splat]'
-    cmd  '}'
-    br
-    e 'All parts of the URL past <b>/more/</b> will be made
-    available in <b>:splat</b> of params[], as shown above.'
-    br
-    e 'To <b>obtain the full route</b> you can use
-    <b>request.path_info</b>.'
-  }
-  # ========================================================================= #
   # === How do we use DELETE in sinatra?
   # ========================================================================= # 
   sinatra_header 'How do we use DELETE in sinatra?','BO marb1px'
@@ -348,8 +333,8 @@ doc('mar0px pad0px s0_8em') {
     anm 'As the example shows the ? is set before the name of the
     variable. This then means that these arguments are all optional.'
     br
-    e 'In other words: optional parameters will be enclosed
-    via ? ?.'
+    e 'In other words: <b>optional parameters will be enclosed
+    via ? ?</b>.'
   }
   # ========================================================================= #
   # === How do we skip a route within a method?
@@ -886,6 +871,51 @@ doc('mar0px pad0px s0_8em') {
     cmd '  register Sinatra::Prawn # Use the correct name, of course.'
   }
   # ========================================================================= #
+  # === How can we obtain all parameters via splat in sinatra? (splat tag, all tag)
+  # ========================================================================= # 
+  sinatra_header 'How can we obtain all parameters via splat in sinatra?',
+                 'BO marb1px'
+  p_default {
+    cmd  "get('/more/*') {"
+    cmd2 '  params[:splat]'
+    cmd  '}'
+    br
+    e 'All parts of the URL past <b>/more/</b> will be made
+    available in <b>:splat</b> of params[], as shown above.'
+    br
+    e 'To <b>obtain the full route</b> you can use
+    <b>request.path_info</b>.'
+  }
+  # ========================================================================= #
+  # === How to use a form-tag in sinatra?
+  # ========================================================================= # 
+  sinatra_header 'How to use a form-tag in sinatra?',
+                 'BO marb1px'
+  p_default {
+    e 'The method attribute tells the form what kind of request should be
+    fired to the server when the submit button is clicked.'
+    br
+    e 'The POST request is typically used, because we "post" data
+    to the server.'
+    br
+    e 'The action attribute tells the form what specific route the
+    post request should be sent to.'
+    br
+    e 'Thus, a form may look like this:'
+    br
+    cmd htmlescape('<form method="POST" action="/food">')
+    cmd htmlescape('<p>Your Name:          <input type="text" /></p>')
+    cmd htmlescape('<p>Your Favorite Food: <input type="text" /></p>')
+    cmd htmlescape('<input type="submit" />')
+    cmd htmlescape('</form>')
+    br
+    e 'Then you can handle the parameters via:'
+    br
+    cmd  'what = params'
+    cmd  "if what.is_a?(Hash) and what.has_key?('textarea_for_form1')"
+    cmd2 "  what = what['textarea_for_form1']"
+  }
+  # ========================================================================= #
   # === Links to sinatra-related websites
   # ========================================================================= #
   h2 'Links to sinatra-related websites'

data/lib/roebe/base/colours.rb

@@ -39,16 +39,6 @@ class Base
     @use_colours = false
   end
 
-  # ========================================================================= #
-  # === rev                                                         (rev tag)
-  # ========================================================================= #
-  def rev(
-      use_colours = @use_colours
-    )
-    return COLOURS.rev if use_colours
-    return ''
-  end
-
   # ========================================================================= #
   # === powderblue
   # ========================================================================= #
@@ -177,15 +167,7 @@ class Base
   # ========================================================================= #
   def mediumpurple(i = '')
     return COLOURS.mediumpurple(i) if @use_colours
-    i
-  end
-
-  # ========================================================================= #
-  # === mediumseagreen
-  # ========================================================================= #
-  def mediumseagreen(i = '')
-    return COLOURS.mediumseagreen(i) if @use_colours
-    i
+    return i
   end
 
   # ========================================================================= #
@@ -193,7 +175,7 @@ class Base
   # ========================================================================= #
   def darkcyan(i = '')
     return COLOURS.darkcyan(i) if @use_colours
-    i
+    return i
   end
 
   # ========================================================================= #
@@ -201,7 +183,7 @@ class Base
   # ========================================================================= #
   def lime(i = '')
     return COLOURS.lime(i) if @use_colours
-    i
+    return i
   end
 
   # ========================================================================= #
@@ -260,14 +242,6 @@ class Base
     i
   end
 
-  # ========================================================================= #
-  # === steelblue
-  # ========================================================================= #
-  def steelblue(i = '')
-    return COLOURS.steelblue(i) if @use_colours
-    i
-  end
-
   # ========================================================================= #
   # === red
   # ========================================================================= #
@@ -276,14 +250,6 @@ class Base
     i
   end
 
-  # ========================================================================= #
-  # === orchid
-  # ========================================================================= #
-  def orchid(i = '')
-    return COLOURS.orchid(i) if @use_colours
-    i
-  end
-
   # ========================================================================= #
   # === mediumorchid
   # ========================================================================= #
@@ -484,35 +450,46 @@ class Base
   end
 
   # ========================================================================= #
-  # === pink
+  # === sandybrown
   # ========================================================================= #
-  def pink(
+  def sandybrown(
       i           = '',
-      use_colours = @use_colours
+      use_colours = use_colours?
     )
-    return COLOURS.pink(i) if use_colours
+    return COLOURS.sandybrown(i) if use_colours
     return i
   end
 
   # ========================================================================= #
-  # === sandybrown
+  # === lightblue
   # ========================================================================= #
-  def sandybrown(
+  def lightblue(
       i           = '',
-      use_colours = @use_colours
+      use_colours = use_colours?
     )
-    return COLOURS.sandybrown(i) if use_colours
+    return COLOURS.lightblue(i) if use_colours
     return i
   end
 
   # ========================================================================= #
-  # === lightblue
+  # === pink
   # ========================================================================= #
-  def lightblue(
+  def pink(
       i           = '',
-      use_colours = @use_colours
+      use_colours = use_colours?
     )
-    return COLOURS.lightblue(i) if use_colours
+    return COLOURS.pink(i) if use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === mediumseagreen
+  # ========================================================================= #
+  def mediumseagreen(
+      i            = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.mediumseagreen(i) if use_colours
     return i
   end
 
@@ -521,10 +498,42 @@ class Base
   # ========================================================================= #
   def yellow(
       i           = '',
-      use_colours = @use_colours
+      use_colours = use_colours?
     )
     return COLOURS.yellow(i) if use_colours
     return i
   end; alias yel yellow # === yel
 
+  # ========================================================================= #
+  # === steelblue
+  # ========================================================================= #
+  def steelblue(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.steelblue(i) if use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === rev                                                         (rev tag)
+  # ========================================================================= #
+  def rev(
+      use_colours = use_colours?
+    )
+    return COLOURS.rev if use_colours
+    return ''
+  end
+
+  # ========================================================================= #
+  # === orchid
+  # ========================================================================= #
+  def orchid(
+      i           = '',
+      use_colours = use_colours?
+    )
+    return COLOURS.orchid(i) if use_colours
+    return i
+  end
+
 end; end

data/lib/roebe/classes/create_file_skeleton/generate_ruby_string.rb

@@ -76,6 +76,7 @@ class CreateFileSkeleton < Roebe::Base
     _ '    # === @namespace'
     _ '    # ======================================================================= #'
     _ '    @namespace = NAMESPACE'
+    _ '    # infer_the_namespace'
     _ '  end'
     # ======================================================================= #
     # Add the method called set_commandline_arguments() next:

data/lib/roebe/classes/current_monitor_resolution.rb

@@ -42,17 +42,24 @@ class CurrentMonitorResolution < Base # === Roebe::CurrentMonitorResolution
   end
 
   # ========================================================================= #
-  # === run                                                         (run tag)
+  # === raw_system_command_for_xrandr
   # ========================================================================= #
-  def run
-    run_the_xrandr_system_command
+  def raw_system_command_for_xrandr
+    `xrandr`
   end
 
   # ========================================================================= #
   # === run_the_xrandr_system_command
   # ========================================================================= #
   def run_the_xrandr_system_command
-    @result = `xrandr`
+    @result = raw_system_command_for_xrandr
+    sanitize_the_result
+  end
+
+  # ========================================================================= #
+  # === sanitize_result
+  # ========================================================================= #
+  def sanitize_the_result
     splitted = @result.split("\n")
     selection = splitted.select {|line| line.include? '*+' }
     if selection.is_a? Array
@@ -60,15 +67,26 @@ class CurrentMonitorResolution < Base # === Roebe::CurrentMonitorResolution
     end
     selection.strip!
     @result = selection
-    report_the_result
   end
 
   # ========================================================================= #
   # === report_the_result
   # ========================================================================= #
   def report_the_result(i = @result)
-    e steelblue(i)
-  end; alias report report_the_result # === report
+    opnn; e lightblue('The currentmonitor resolution is: ')
+    e
+    e "  #{simp(i)}"
+    e
+  end; alias report                        report_the_result # === report
+       alias report_the_monitor_resolution report_the_result # === report_the_monitor_resolution
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    run_the_xrandr_system_command
+    report_the_result
+  end
 
   # ========================================================================= #
   # === Roebe::CurrentMonitorResolution[]
@@ -79,11 +97,11 @@ class CurrentMonitorResolution < Base # === Roebe::CurrentMonitorResolution
   #
   # ========================================================================= #
   def self.[](i = '31.03.2018')
-    new(i, :be_silent)
+    new(i)
   end
 
 end; end
 
 if __FILE__ == $PROGRAM_NAME
   Roebe::CurrentMonitorResolution.new(ARGV)
-end # currentmonitorresolution
+end # monitorresolution

data/lib/roebe/classes/do_install.rb

@@ -21,11 +21,6 @@ module Roebe
 
 class DoInstall < ::Roebe::Base # === Roebe::DoInstall
 
-  # ========================================================================= #
-  # === NAMESPACE
-  # ========================================================================= #
-  NAMESPACE = inspect
-
   # ========================================================================= #
   # === PERL_MAKEFILE
   # ========================================================================= #
@@ -53,10 +48,7 @@ class DoInstall < ::Roebe::Base # === Roebe::DoInstall
   # ========================================================================= #
   def reset
     super()
-    # ======================================================================= #
-    # === @namespace
-    # ======================================================================= #
-    @namespace = NAMESPACE
+    infer_the_namespace
   end
 
   # ========================================================================= #