roebe 0.5.191 → 0.6.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a131bfe77e783074db388059a14ea1d5037e8d4c17902023575f1c56c33e13dc
-  data.tar.gz: aa0e3baec297cc14136f29f35f9231af91731f7f629702c8dfc3d266e46fadce
+  metadata.gz: dc76d3d2783b28b320e7c0195d99ce9836861f1d1d6d89a7f62e28ea39b218f8
+  data.tar.gz: 1cba6377d6c68cda3f7fa894b562e63b1d66d56a33c6cb8795680e013b647548
 SHA512:
-  metadata.gz: e1d7fc582dc0543e5136d803f8f8b43c5b8b6fbf036fa7c14ba2ec4fb51bd5558f19ab42ba52cf98f67c576499fe3d28e78eecc7c0bab46df08310f8adcbb11e
-  data.tar.gz: 22de8a6e62bb77fab48cad54b76d7b7417e65fa7077eae864605514c906c6f3cbd84581246fbf3ba86336265dc7a038ad0847ecc49fd5ea0f271d5da547de0af
+  metadata.gz: 42941f6cce792a2ca5ad1e9bbba5a02a07100803e6f204e148e0e4f2d19af88b2cb6890bd50d86871cc6c82847a60b82652376779fd3b02011070a053f928b92
+  data.tar.gz: 04a2a8bcfac07ff8b9bd107950205254f220068e8da292c6402d8ae49f6b088521622a85684dd9f0049f0ab6714f29c08cfcbd2498d6efd865971927092c5c9f

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">31.01.2024</span> (dd.mm.yyyy notation), at <span style="color: steelblue; font-weight: bold">00:15:47</span> o'clock.
+This gem was <b>last updated</b> on the <span style="color: darkblue; font-weight: bold">12.03.2024</span> (dd.mm.yyyy notation), at <span style="color: steelblue; font-weight: bold">15:10:41</span> o'clock.
 
 ## Introducing the Roebe project
 
@@ -5752,6 +5752,18 @@ have to install the emoji_paradise gem, via:
 
     gem install emoji_paradise
 
+## Roebe.actions()
+
+Roebe.actions() was added in March 2024. The idea is that for every
+important (major) activity, related to the roebe gem, we bundle
+this through the method Roebe.actions().
+
+This thus constitutes a generic entry point, which in turn can then
+be used towards other entry points of other gems, without needing
+to require any specific .rb file or know the class-names of such
+files, as-is. We thus gain a <b>lot</b> more flexibility that
+way.
+
 ## Useful links, blogs, articles about the Ruby programming language
 
 This subsection contains some links that may possibly be useful to you when
@@ -5840,29 +5852,14 @@ gem owner eventually:
 see
 https://blog.rubygems.org/2022/06/13/making-packages-more-secure.html
 
-Mandatory 2FA will eventually be extended to all rubygems.org developers and
-maintainers. As I can not use 2FA, for reasons I will skip explaining here,
-this means that my projects will eventually be removed, as I no longer
-have any control over my projects hosted on rubygems.org (because I
-can not use 2FA).
-
-At that point, I no longer have any control what is done to my projects
-since whoever is controlling the gems ecosystem took away our control
-here. I am not sure at which point ruby became corporate-controlled -
-that was not the case several years ago, so something has
-changed.
-
-Ruby also only allows 2FA users to participate on the issue tracker these
-days:
-
-  https://bugs.ruby-lang.org/issues/18800
-
-But this has been reverted some months ago, so it is no longer applicable.
-Suffice to say that I do not think that we should only be allowed to
-interact on the world wide web when some 'authority' authenticated us,
-such as via mandatory 2FA, so I hope this won't come back again.
-
-Fighting spam is a noble goal, but when it also means you lock out
-real human people then this is definitely NOT a good situation
-to be had.
+However had, that has been reverted again, so I decided to shorten
+this paragraph. Mandatory 2FA may exclude users who do not have a 
+smartphone device or other means to 'identify'. I do not feel it is
+a fair assumption by others to be made that non-identified people may
+not contribute code, which is why I reject it. Mandatory 2FA would mean
+an end to all my projects on rubygems.org, so let's hope it will never
+happen. (Keep in mind that I refer to mandatory 2FA; I have no qualms
+for people who use 2FA on their own, but this carrot-and-stick strategy
+by those who control the rubygems infrastructure is a very bad one to
+pursue.
 

data/bin/create_my_directories

@@ -2,6 +2,6 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-require 'roebe/classes/create_my_directories.rb'
+require 'roebe/actions/actions.rb'
 
-Roebe::CreateMyDirectories.new(ARGV)
+Roebe.actions(:CreateMyDirectories, ARGV)

data/bin/{ruby_dhcpcd → dhcpcd_wrapper}

@@ -2,6 +2,6 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-require 'roebe/classes/dhcpcd/dhcpcd.rb'
+require 'roebe/classes/dhcpcd/dhcpcd_wrapper.rb'
 
 Roebe.dhcpcd(ARGV)

data/doc/README.gen

@@ -5748,6 +5748,18 @@ have to install the emoji_paradise gem, via:
 
     gem install emoji_paradise
 
+## Roebe.actions()
+
+Roebe.actions() was added in March 2024. The idea is that for every
+important (major) activity, related to the roebe gem, we bundle
+this through the method Roebe.actions().
+
+This thus constitutes a generic entry point, which in turn can then
+be used towards other entry points of other gems, without needing
+to require any specific .rb file or know the class-names of such
+files, as-is. We thus gain a <b>lot</b> more flexibility that
+way.
+
 ## Useful links, blogs, articles about the Ruby programming language
 
 This subsection contains some links that may possibly be useful to you when

data/doc/core/array.md

@@ -1,3 +1,27 @@
+## How can we check whether something is included in an array or not? (inarray, is in array, in_array)
+
+    a = [ "a", "b", "c" ] #
+    a.include?("b") # true
+
+  If you want to do this for an object called x and the array y
+
+    y.member?(x)
+
+## I am used to perl's qw(). How to make this in ruby? Is there a shortcut for creating arrays? (quoted words)
+
+    x = %w(63 362 63632 dog cat)
+
+  The lowercased %w extracts space-separated tokens into array elements.
+
+  The uppercased %W does double-quoted string subtiutions, which is
+  useful if you want to use variables.
+
+  Examples for %W:
+
+    x = %W( one two -#{Time.now}-)
+    x = %W( one #two three #{Time.now} ) # => ["one", "#two", "three", "2024-02-25 02:46:21 +0000"]
+
+
 ## Create an Array with 5 random numbers:
 
     Array.new(5) { rand(10) }
@@ -602,29 +626,6 @@
       (1..5000).select {|i| i % 3 == 0 } # Wählt 3,6,9,12
       etc.. aus
 
-## How can I check whether something is included in 
-      an array or not? (inarray, is in array, in_array)
-      a = [ "a", "b", "c" ] #
-      a.include?("b") # true
-
-    If you want to do this for an object called x and the array y
-
-      y.member?(x)
-
-      frage("I am used to perl's qw(). How to make this in ruby? Is
-      there a shortcut for creating arrays? (quoted words)")+
-      x = %w(63 362 63632 dog cat)
-
-    The lowercased %w extracts space-separated 
-      tokens into array elements.
-
-     The uppercased %W does double-quoted string subtiutions. 
-      Useful if you want to use variables.
-
-    Beispiel für %W:
-
-    x=%W(  one two -#{Time.now}-)
-
 ## Wie suche ich nach einem String in einem Array?','grep
       array = ["one","two","three","four"]
       array.grep("three")

data/doc/core/gem_and_gemspec.md

@@ -373,22 +373,23 @@
       include Gem::Text
       levenshtein_distance 'shevy', 'chevy' # => 1
 
-      # ===================================================================== #
-      # === How to compare two program versions with one another
-      # ===================================================================== #
-## Wie kann ich verschiedene Versionen 
-      miteinander vergleichen?
-      Gem::Version.new('0.4.1') > Gem::Version.new('0.10.1')
 
-      Um den <b>dependency check</b> zu ignorieren (force install) 
-      geht dies hier (bzw <b>gemif</b>):
+## How to compare two program versions with one another
+
+  Use:
 
-      gem install -f lalala
+    Gem::Version.new('0.4.1') > Gem::Version.new('0.10.1')
+
+  Um den <b>dependency check</b> zu ignorieren (force install) 
+  geht dies hier (bzw <b>gemif</b>):
+
+    gem install -f lalala
 
 ## Kann ich es vermeiden, .gemrc zu laden?
-      Ja. Verwende:
 
-      --config-file
+  Yes. Make use of:
+
+    --config-file
 
 ## Wie erhalte ich das Bindir Verzeichnis von Gem?
 

data/doc/core/misc.md

@@ -1,3 +1,26 @@
+## How can we read data from a .rb file without ruby evaluating this data?
+
+  Make use of:
+
+    p DATA.read
+    __END__
+
+  DATA.read liest die Information ein, die nach __END__ geschrieben 
+  ist. Man kann dies sogar verwenden um Configurations-Dateien in 
+  einer .rb Datei zu speichern.
+
+  Die Konstante <b>DATA</b> ist verfügbar sobald die __END__
+  Direktive in einer .rb Datei drinnen steht. Alles was dieser 
+  __END__ Direktive folgt ist dann Inhalt von DATA.
+
+  DATA ist leider nur für $0 verfügbar.
+
+  DATA ist ein File Objekt. Man kann daher auch <b>DATA.pos</b>
+  verwenden.
+
+  Man kann mittels <b>__END__</b> auch direkt YAML Code in
+  ein .rb <b>Skript</b> einfügen.
+
 ## How do we find out how many arguments a method will accept? (alos known as arity)
 
   This is possible via the <b>.arity</b> method.
@@ -1150,26 +1173,6 @@
 
     d.send(:attr=, 99) # macht das selbe wie oben, nur verboser.
 
-## Wie lese ich Daten von einer .rb Datei ohne das Ruby
-      diese Daten interpretiert?','__END__
-    p DATA.read
-    __END__
-
-    DATA.read liest die Information ein, die nach __END__ geschrieben 
-      ist. Man kann dies sogar verwenden um Configurations-Dateien in 
-      einer .rb Datei zu speichern.
-
-      anm('Die Konstante <b>DATA</b> ist verfügbar sobald die __END__ 
-      Direktive in einer .rb Datei drinnen steht. Alles was dieser 
-      __END__ Direktive folgt ist dann Inhalt von DATA.
-      anm('DATA ist leider nur für $0 verfügbar.
-
-      anm('DATA ist ein File Objekt. Man kann daher auch <b>DATA.pos</b>
-      verwenden.
-
-    Man kann mittels <b>__END__</b> auch direkt YAML Code in
-      ein .rb <b>Skript</b> einfügen.
-
 ## Wie erhalte ich das Default External Ruby Encoding via
       Commandline?
       ruby -e 'p Encoding.default_external'

data/doc/statistics/statistics.md

@@ -94,5 +94,6 @@ Total gems (ideally store it at the end of the month):
   Total gems 172,440 (Jul 2022), Total users 169,484 # ← 14.07.2022
   Total gems 174,304 (Dec 2022), Total users 172,523 # ← 04.12.2022
   Total gems 178,865 (Nov 2023), Total users 183,129 # ← 16.11.2023
+  Total gems 179,738 (Feb 2024), Total users 186,502 # ← 02.02.2024
 
 # https://rubygems.org/stats

data/lib/roebe/actions/actions.rb

@@ -0,0 +1,68 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Roebe::Actions
+# =========================================================================== #
+# require 'roebe/actions/actions.rb'
+# dataset = Roebe.actions(:contacts_dataset)
+# Roebe.actions(ARGV)
+# =========================================================================== #
+module Roebe
+
+  require 'roebe/constants/roebe.rb'
+
+  # ========================================================================= #
+  # === Roebe.actions                               (action tag, actions tag)
+  # ========================================================================= #
+  def self.actions(
+      action_that_is_desired = nil,
+      optional_argument1     = ARGV, # This is typically the main input to this method.
+      options_hash           = {},
+      &block
+    )
+    # ======================================================================= #
+    # First this method will handle Arrays:
+    # ======================================================================= #
+    if action_that_is_desired.is_a? Array
+      action_that_is_desired.each {|this_action|
+        Roebe.actions(
+          this_action,
+          optional_argument1,
+          options_hash,
+          &block
+        )
+      }
+    else
+      _ = optional_argument1 # Easier "pointer" here.
+      case action_that_is_desired # (case tag)
+      # ======================================================================= #
+      # === :contacts_dataset
+      #
+      # Usage example:
+      #
+      #   dataset = Roebe.actions(:contacts)
+      #
+      # ======================================================================= #
+      when :contacts_dataset,
+           :ContactsDataset,
+           :contacts
+        require 'yaml'
+        this_file = Roebe.file_contacts
+        return YAML.load_file(this_file)
+      # ======================================================================= #
+      # === :create_my_directories
+      # ======================================================================= #
+      when :create_my_directories,
+           :CreateMyDirectories
+        require 'roebe/classes/create_my_directories.rb'
+        Roebe::CreateMyDirectories.new(_, &block)
+      end
+    end
+  end; self.instance_eval { alias action actions } # === Roebe.action
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  Roebe.actions(ARGV)
+end # roebe_actions

data/lib/roebe/base/misc.rb

@@ -13,6 +13,7 @@ class Base # === Roebe::Base
   require 'roebe/base/env.rb'
   require 'roebe/constants/roebe.rb'
   require 'roebe/constants/file_and_directory_constants.rb'
+  require 'roebe/actions/actions.rb'
 
   # ========================================================================= #
   # Add support for commandline-arguments first:
@@ -53,6 +54,15 @@ class Base # === Roebe::Base
     esystem 'qdbus org.kde.konsole-`pidof -s konsole` /Sessions/4 runCommand "ata"'
   end
 
+  # ========================================================================= #
+  # === actions                                     (actions tag, action tag)
+  # ========================================================================= #
+  def actions(
+      i = nil, &block
+    )
+    Roebe.actions(i, &block)
+  end; alias action actions # === action
+
   require 'roebe/toplevel_methods/images.rb'
   # ========================================================================= #
   # === is_an_image_file?
@@ -127,7 +137,10 @@ class Base # === Roebe::Base
   # This method will only work (and is useful) for RBT-specific support.
   # ========================================================================= #
   def programs_dir?
-    RBT.programs_dir?
+    unless Object.const_defined?(:RBT) and RBT.respond_to?(:programs_dir?)
+      require 'rbt/toplevel_methods/files_and_directories_related_methods.rb'
+      RBT.programs_dir?
+    end
   end
 
   # ========================================================================= #

data/lib/roebe/browser/output_url_then_open_in_browser.rb

@@ -35,6 +35,7 @@ class OutputUrlThenOpenInBrowser < Browser # === Roebe::OutputUrlThenOpenInBrows
   rescue LoadError; end
 
   begin
+    require 'rbt/toplevel_methods/available_programs.rb'
     require 'rbt/misc/map_this_input_to_that_registered_program.rb'
   rescue LoadError; end
 
@@ -95,7 +96,7 @@ class OutputUrlThenOpenInBrowser < Browser # === Roebe::OutputUrlThenOpenInBrows
   # ========================================================================= #
   def try_to_require_the_rbt_url_class
     begin
-      require 'rbt/utility_scripts/url.rb'
+      require 'rbt/cookbooks/url/url.rb'
     rescue LoadError; end
   end
 
@@ -135,7 +136,7 @@ class OutputUrlThenOpenInBrowser < Browser # === Roebe::OutputUrlThenOpenInBrows
         replacement = ::RBT.map_this_input_to_that_registered_program(use_this_as_input)
         opne "No program called #{steelblue(use_this_as_input)} was found."
         opne 'However had, a binary with that name was found,'
-        opne 'belonging to '+royalblue(replacement)+', which will '\
+        opne 'belonging to '+royalblue(replacement)+rev+', which will '\
              'next be used'
         opne 'as input.'
         use_this_as_input = replacement
@@ -143,11 +144,12 @@ class OutputUrlThenOpenInBrowser < Browser # === Roebe::OutputUrlThenOpenInBrows
         possible_replacement = ::RBT.map_this_input_to_that_registered_program(use_this_as_input)
         unless possible_replacement == use_this_as_input
           use_this_as_input = possible_replacement
-          opne 'Will be using the name '+steelblue(use_this_as_input)+' instead.'
+          opne "#{rev}Will be using the name #{steelblue(use_this_as_input)}#{rev} "\
+               "instead."
         end
       end
     end
-    if Object.const_defined?(:RBT) and
+    if Object.const_defined?(:RBT) and RBT.const_defined?(:Cookbooks) and
        RBT::Cookbooks.const_defined?(:Url)
       # ===================================================================== #
       # Simply show the URLs next, via class RBT::Cookbooks::Url
@@ -163,8 +165,8 @@ class OutputUrlThenOpenInBrowser < Browser # === Roebe::OutputUrlThenOpenInBrows
         e 'OpenLastUrl does not appear to be available.'
       end
     else
-      opne 'The class '+steelblue('RBT::Cookbooks::Url')+
-           ' is not available.'
+      opne "#{rev}The class #{steelblue('RBT::Cookbooks::Url')}"\
+           "#{rev} is not available."
     end
   end
 

data/lib/roebe/classes/alltagsgeschichte.rb

@@ -27,7 +27,7 @@ class Alltagsgeschichte < Base # === Roebe::Alltagsgeschichte
   rescue LoadError; end
 
   begin
-    require 'multimedia_paradise/constants/file_constants.rb'
+    require 'multimedia_paradise/constants/constants.rb'
   rescue LoadError; end
 
   begin

data/lib/roebe/classes/at.rb

@@ -24,7 +24,7 @@ class At < ::Roebe::Base # === Roebe::At
 
   begin
     unless Object.const_defined? :MultimediaParadise
-      require 'multimedia_paradise/audio/audio_player/audio_player.rb'
+      require 'multimedia_paradise/actions/actions.rb'
     end
   rescue LoadError; end
 
@@ -268,7 +268,7 @@ class At < ::Roebe::Base # === Roebe::At
     # ======================================================================= #
     # Next delegate to class AudioPlayer.
     # ======================================================================= #
-    MultimediaParadise::AudioPlayer.new(:play_all_songs)
+    MultimediaParadise.action(:AudioPlayer, :play_all_songs)
   end
 
   # ========================================================================= #

data/lib/roebe/classes/auto_rename_file_based_on_its_creation_date.rb

@@ -42,23 +42,35 @@ class AutoRenameFileBasedOnItsCreationDate < Base # === Roebe::AutoRenameFileBas
   end
 
   # ========================================================================= #
-  # === run                                                         (run tag)
+  # === do_work_on_these_files
   # ========================================================================= #
-  def run
-    _ = first_argument?
-    if File.exist? _
-      creation_date = File.ctime(_)
-      creation_date = dd_mm_yyyy(creation_date)
-      new_filename = "#{creation_date}-#{_}" # This will be the new filename.
-      unless File.exist? new_filename
-        opne "Renaming `#{sfile(_)}#{rev}` to #{sfile(new_filename)}#{rev}."
-        rename_file(_, new_filename)
-      end
+  def do_work_on_these_files(i)
+    if i.is_a? Array
+      i.each {|entry|
+        do_work_on_these_files(entry)
+      }
     else
-      opnn; no_file_exists_at(_)
+      if File.exist? i
+        creation_date = File.mtime(i) # It seems as if the mtime is better than ctime here.
+        creation_date = dd_mm_yyyy(creation_date)
+        new_filename = "#{creation_date}-#{i}" # This will be the new filename.
+        unless File.exist? new_filename
+          opne "#{rev}Renaming `#{sfile(i)}#{rev}` to #{sfile(new_filename)}#{rev}."
+          rename_file(i, new_filename)
+        end
+      else
+        opnn; no_file_exists_at(i)
+      end
     end
   end
 
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    do_work_on_these_files(all_arguments?)
+  end
+
   # ========================================================================= #
   # === Roebe::AutoRenameFileBasedOnItsCreationDate[]
   # ========================================================================= #