open 0.1.30 → 0.2.22

data/lib/open/{open.rb → open/open.rb}

@@ -5,15 +5,15 @@
 # === Open::Open
 #
 # This class will simply open a given file. It may also "open" the file
-# in the browser, that is, to use primarily firefox to display the file
-# content as such.
+# in the browser, that is, to use firefox or chrome or thorium to
+# display the file content as such.
 #
 # Usage example:
 #
 #   Open::Open.new(ARGV)
 #
 # =========================================================================== #
-# require 'open/open.rb'
+# require 'open/open/open.rb'
 # Open::Open.new(ARGV)
 # =========================================================================== #
 require 'open/base/base.rb'
@@ -22,13 +22,13 @@ module Open
 
 class Open < ::Open::Base # === Open::Open
 
-  require 'open/in_editor/in_editor.rb'
   require 'open/in_browser/in_browser.rb'
-  require 'open/toplevel_code/toplevel_code.rb'
+  require 'open/in_editor/in_editor.rb'
+  require 'open/toplevel_methods/misc.rb'
 
   begin
     require 'roebe/classes/find_expanded_alias.rb'
-  rescue LoadError; end
+  rescue LoadError => error; puts error; end
 
   # ========================================================================= #
   # === LIBREOFFICE
@@ -41,7 +41,7 @@ class Open < ::Open::Base # === Open::Open
   if ENV['PATH_TO_THE_LIBREOFFICE_EXECUTABLE']
     LIBREOFFICE = ENV['PATH_TO_THE_LIBREOFFICE_EXECUTABLE'].to_s.dup
   else
-    LIBREOFFICE = '/usr/bin/soffice'
+    LIBREOFFICE = '/usr/bin/soffice' # This will be valid for most users of the gem.
   end
 
   # ========================================================================= #
@@ -63,26 +63,6 @@ class Open < ::Open::Base # === Open::Open
   # ========================================================================= #
   USE_THIS_DELAY = 0.65
 
-  # ========================================================================= #
-  # === ARRAY_EXTENSIONS_THAT_CAN_BE_OPENED_IN_THE_EDITOR
-  #
-  # All extensions that can be opened in the editor should be registered
-  # in this constant.
-  #
-  # For example, "h" means ".h" aka a C or C++ header file.
-  # ========================================================================= #
-  ARRAY_EXTENSIONS_THAT_CAN_BE_OPENED_IN_THE_EDITOR = %w(
-    php rb txt yaml yml cgi 
-    md gemspec html csv py
-    conf c sh js log css cr
-    ascii la pl perl json
-    js fasta fa m3u cpp
-    go gff gff3 
-    gen h
-    erb sinatra
-    sql
-  ).sort << '' # The last part is for files like "TODO" which lack an extension.
-
   # ========================================================================= #
   # === ARRAY_LIBREOFFICE_EXTENSIONS
   #
@@ -104,42 +84,18 @@ class Open < ::Open::Base # === Open::Open
     pps
   )
 
-  # ========================================================================= #
-  # === ARRAY_IMAGES
-  #
-  # All file-extensions for images can be registered in this Array.
-  # ========================================================================= #
-  ARRAY_IMAGES = %w(
-    png
-    jpg
-    gif
-    jpeg
-    tiff
-    tif
-    bmp
-  )
-
-  # ========================================================================= #
-  # === ARRAY_VIDEOS
-  # ========================================================================= #
-  ARRAY_VIDEOS = %w(
-    vob
-    avi
-    flv
-    mp3
-    mp4
-  )
-
   # ========================================================================= #
   # === initialize
   # ========================================================================= #
   def initialize(
-      i           = nil,
-      run_already = true,
+      commandline_arguments = ARGV,
+      run_already           = true,
       &block
     )
     reset
-    set_input(i)
+    set_commandline_arguments(
+      commandline_arguments
+    )
     # ======================================================================= #
     # === Handle blocks next
     # ======================================================================= #
@@ -159,7 +115,7 @@ class Open < ::Open::Base # === Open::Open
         # === :open_via_fullscreen
         # =================================================================== #
         if yielded.has_key? :open_via_fullscreen
-          @open_via_fullscreen = yielded.delete(:open_via_fullscreen)
+          @internal_hash[:open_via_fullscreen] = yielded.delete(:open_via_fullscreen)
         end
       end
     end
@@ -173,75 +129,102 @@ class Open < ::Open::Base # === Open::Open
     super()
     infer_the_namespace
     # ======================================================================= #
-    # === @image_editor
+    # === @internal_hash
+    # ======================================================================= #
+    @internal_hash = {}
     # ======================================================================= #
-    @image_editor = 'gimp'
+    # === :open_via_fullscreen
     # ======================================================================= #
-    # === @editor
+    @internal_hash[:open_via_fullscreen] = false
     # ======================================================================= #
-    @editor = use_which_editor?
+    # === :set_the_main_book
     # ======================================================================= #
-    # === @set_the_main_book
+    @internal_hash[:set_the_main_book] = false
     # ======================================================================= #
-    @set_the_main_book = false
+    # === :image_editor_to_use
     # ======================================================================= #
-    # === @open_via_fullscreen
+    @internal_hash[:image_editor_to_use] = 'gimp'
     # ======================================================================= #
-    @open_via_fullscreen = false
+    # === :editor
+    # ======================================================================= #
+    set_editor(use_which_editor?)
+    # ======================================================================= #
+    # === :open_these_elements
+    # ======================================================================= #
+    @internal_hash[:open_these_elements] = []
   end
 
   # ========================================================================= #
   # === set_the_main_book?
   # ========================================================================= #
   def set_the_main_book?
-    @set_the_main_book
+    @internal_hash[:set_the_main_book]
   end
 
   # ========================================================================= #
-  # === set_use_this_editor
+  # === open_in_editor                                  (open tag, open1 tag)
+  #
+  # This method will simply delegate towards class Open::InEditor.
+  #
+  # Take note that Open.in_editor() will already handle delays, so
+  # we do not have to do anything special here.
   # ========================================================================= #
-  def set_use_this_editor(
-      i = use_which_editor?
-    )
-    @editor = i.to_s
-  end
+  def open_in_editor(i)
+    ::Open.in_editor(i)
+  end; alias try_to_open_this_file_in_the_editor open_in_editor # === try_to_open_this_file_in_the_editor
+       alias consider_opening_the_given_input    open_in_editor # === consider_opening_the_given_input
+       alias open_these_files                    open_in_editor # === open_these_files
+       alias do_open_in_editor                   open_in_editor # === do_open_in_editor
 
   # ========================================================================= #
-  # === replace_localhost_with_data
+  # === try_to_require_the_studium_project
   # ========================================================================= #
-  def replace_localhost_with_data(i)
-    if i.include? 'programming'
-      return i.sub('localhost','/home/x/')
-    else
-      return i.sub('localhost','/home/x/data/')
+  def try_to_require_the_studium_project
+    unless Object.const_defined?(:Studium) and
+           Studium.respond_to?(:include_this_exam_topic?)
+      begin # We pull in only the relevant files from the Studium project.
+        require 'studium/constants/constants.rb'
+        require 'studium/toplevel_methods/toplevel_methods.rb'
+      rescue LoadError
+        if is_on_roebe?
+          e 'The two files ('\
+            'studium/constants/constants.rb,'\
+            'studium/toplevel_methods/toplevel_methods.rb '\
+            'forth) from the studium-project could not be loaded.'
+        end
+      end
     end
   end
 
   # ========================================================================= #
-  # === set_input
+  # === show_help                                                  (help tag)
   # ========================================================================= #
-  def set_input(i = ARGV)
-    i = [i] unless i.is_a? Array
-    i.map! {|entry|
-      entry = entry.to_s.dup
-      # ===================================================================== #
-      # Split away at '::' if this is part of that substring.
-      # ===================================================================== #
-      if entry.include? '::'
-        splitted = entry.split('::')
-        entry = splitted.last
-      end
-      if entry.include? '^'
-        entry.delete!('^')
-      end
-      case entry
-      # ===================================================================== #
-      # === open --everything
-      #
-      # This actually refers only to files, so we select for files next.
-      # ===================================================================== #
-      when /^-?-?everything?$/i
-        entry = Dir['**/**'].select {|inner_entry| File.file?(inner_entry) }
+  def show_help
+    opne 'The following options are available:'
+    e
+    ecomment '  SELF                       # Open this .rb file here.'
+    ecomment '  --use-this-browser=firefox # Assign a new browser, in this case firefox.'
+    ecomment '  --browser?                 # '\
+             'Show which browser is the currently assigned one.'
+    ecomment '  --everything               # '\
+             'This will open every file in the current working directory, and '\
+             'all subdirectories.'
+    ecomment '  --important-exam           # '\
+             'Open all important exams. Only useful if the studium gem is '\
+             'also installed.'
+    e
+  end
+
+  # ========================================================================= #
+  # === menu                                                       (menu tag)
+  # ========================================================================= #
+  def menu(
+      i = commandline_arguments?
+    )
+    if i.is_a? Array
+      i.each {|entry| menu(entry) }
+    else
+      case i # (case tag)
       # ===================================================================== #
       # === open --important-exam
       # ===================================================================== #
@@ -249,140 +232,46 @@ class Open < ::Open::Base # === Open::Open
         base_dir = ENV['USERS']
         base_dir = '/home' if base_dir.nil?
         entry = "#{base_dir}/x/programming/ruby/src/studium/lib/studium/yaml/important_exams.yml"
-      end
-      # ===================================================================== #
-      # Get rid of localhost next. This must be handled with more care,
-      # because some files may include the string 'localhost' as part of
-      # their name, such as 'remove_localhost.rb'. In this case, we will
-      # additionally check whether the file exists.
-      # ===================================================================== #
-      if entry.is_a?(String) and entry.include?('localhost')
-        unless File.exist? entry # See the above header for an explanation.
-          entry = replace_localhost_with_data(entry)
-        end
-      end
-      if entry.is_a? String
-        entry.chop! if entry.end_with? '#'  # Don't need trailing '#' tokens.
-        entry.chop! if entry.end_with? ':-' # ← This check must come before the check against ':'. 
-        entry.chop! if entry.end_with? ':'  # Chop off trailing ':' tokens.
-        # ===================================================================== #
-        # Next, we handle input such as:
-        #   'lib/lpc/requires/basic_requires.rb:begin'
-        # This evidently does not end with a ':' character, but it clearly
-        # has a fairly useless ':' component in it. If that is the case,
-        # we will treat this as input that is only valid up towards the
-        # very right ':', anchored on the '.rb:' part.
-        # ===================================================================== #
-        if entry.include? '.rb:'
-          # =================================================================== #
-          # The following code means to find the index at '.rb:' and then add
-          # 2 to it - this should be the correct name of the entry at hand.
-          # =================================================================== #
-          entry = entry[0 .. (entry.index('.rb:')+2)]
-        end
-        if entry.end_with?(',') and !File.exist?(',')
-          entry.chop!
-        elsif entry.end_with?('.') and File.exist?(entry[0..-2])
-          # =================================================================== #
-          # This clause will be entered if we have input something like
-          # "colours.rb." where the user may have wanted to type in
-          # "colours.rb" - and IF the file exists.
-          # =================================================================== #
-          opnn; e "Assuming a superfluous trailing '.', so removing "\
-                  "the last '.' there."
-          entry.chop!
-        end
-      end
-      case entry # Work only on the first entry. (case tag)
+        @internal_hash[:open_these_elements].clear
+        @internal_hash[:open_these_elements] << entry
       # ===================================================================== #
-      # === open ME
+      # === open --everything
+      #
+      # This actually refers only to files, so we select for files next.
       # ===================================================================== #
-      when 'ME',
-           'SELF',
-           'ALL',/
-           ^-?-?this(_|-)?file/
-        open_this_file_here
-        exit
+      when /^-?-?everything?$/i
+        elements = Dir['**/**'].select {|inner_entry| File.file?(inner_entry) }
+        @internal_hash[:open_these_elements].clear
+        @internal_hash[:open_these_elements] << elements
       # ===================================================================== #
       # === open --help
       # ===================================================================== #
       when /^-?-?help$/i,
-           'show_help'
+           /^-?-?show(-|_)?help$/i
         show_help
         exit
-      end unless File.exist?(entry.to_s)
-      entry
-    }
-    @input = i # This must be an Array.
-  end; alias set_input_files set_input # === set_input_files
-
-  # ========================================================================= #
-  # === input?
-  # ========================================================================= #
-  def input?
-    @input
-  end; alias input_file?  input? # === input_file?
-       alias input_files? input? # === input_files?
-
-  # ========================================================================= #
-  # === check_whether_the_user_has_provided_any_input
-  # ========================================================================= #
-  def check_whether_the_user_has_provided_any_input
-    _ = input_files?
-    local_files = Dir['*'].select {|entry| File.file? entry }
-    if _.empty? and !local_files.empty? and (local_files.size == 1)
       # ===================================================================== #
-      # Handle the case where no specific input was given, but only
-      # one file exists in the local directory.
+      # === open --browser?
       # ===================================================================== #
-      set_input_files(local_files.first)
-      _ = input_files?
-    end
-    if _.empty?
-      if is_on_roebe? and !is_bluefish_running?
-        start_bluefish
-      else
-        opnn; e 'Please provide at least one argument - the file '\
-                'you wish to open.'
+      when /^-?-?browser\??$/
+        _ = YAML.load_file(::Open.file_browser?)
+        e "#{rev}The browser currently in use is `#{sfancy(_)}#{rev}`."
+        exit
+      # ===================================================================== #
+      # === open --use-this-browser=firefox
+      # ===================================================================== #
+      when /^-?-?use(-|_)?this(-|_)?browser=(.+)/
+        ::Open.permanently_use_this_browser = $3.to_s.dup
         exit
       end
     end
   end
 
   # ========================================================================= #
-  # === start_bluefish
-  # ========================================================================= #
-  def start_bluefish
-    esystem 'bluefish &'
-  end
-
-  # ========================================================================= #
-  # === is_bluefish_running?
-  # ========================================================================= #
-  def is_bluefish_running?
-    `ps ax | grep bluefish`.split("\n").reject {|entry|
-      entry.include? 'grep'
-    }.size > 0
-  end
-
-  # ========================================================================= #
-  # === consider_padding
-  #
-  # Simply add a surrounding '"' to the given input, so that any resulting
-  # system() call will still work if we have awkward filenames.
-  # ========================================================================= #
-  def consider_padding(i)
-    if i.include?(' ') or i.include?('(')
-      i = '"'+i+'"'
-    end
-    return i
-  end
-
-  # ========================================================================= #
-  # === play_multimedia_file
+  # === editor?
   # ========================================================================= #
-  def play_multimedia_file(i)
-    esystem "#{USE_THIS_MPLAYER_COMMAND} #{i}" # open 
+  def editor?
+    @internal_hash[:editor]
   end
 
   # ========================================================================= #
@@ -392,13 +281,6 @@ class Open < ::Open::Base # === Open::Open
     do_open_in_editor(this_file?+IN_BACKGROUND)
   end
 
-  # ========================================================================= #
-  # === return_this_file_here
-  # ========================================================================= #
-  def return_this_file_here
-    __FILE__
-  end; alias this_file? return_this_file_here # === this_file?
-
   # ========================================================================= #
   # === delay?
   # ========================================================================= #
@@ -407,186 +289,70 @@ class Open < ::Open::Base # === Open::Open
   end
 
   # ========================================================================= #
-  # === find_and_return_last_file
-  # ========================================================================= #
-  def find_and_return_last_file
-    array = Dir['*'].reject {|entry| ! File.file? entry }
-    array.map! {|entry|
-      [entry, File.ctime(entry)]
-    }
-    result = array.sort_by {|entry| entry[1] }.reverse
-    result = result.first[0]
-    return result
-  end
-
-  # ========================================================================= #
-  # === can_be_opened_in_the_editor?
+  # === set_use_this_editor
   # ========================================================================= #
-  def can_be_opened_in_the_editor?(i)
-    _ = File.extname(i).delete('.')
-    ARRAY_EXTENSIONS_THAT_CAN_BE_OPENED_IN_THE_EDITOR.include? i
-  end
+  def set_use_this_editor(
+      i = use_which_editor?
+    )
+    @internal_hash[:editor] = i.to_s
+  end; alias set_editor set_use_this_editor # === set_editor
 
   # ========================================================================= #
-  # === try_to_open_this_file_in_the_editor
+  # === open_in_pdf_viewer                                          (pdf tag)
+  #
+  # This method can be used to open a .pdf file. We will let the project
+  # PdfParadise handle this situation.
+  #
+  # Since as of 19.09.2018 we will keep a log of the opened .pdf files
+  # if we are on roebe. This can then be used to determine which were
+  # the last .pdf files that were read.
   # ========================================================================= #
-  def try_to_open_this_file_in_the_editor(
-      i = input_files?
-    )
+  def open_in_pdf_viewer(i)
+    require 'pdf_paradise' unless Object.const_defined? :PdfParadise
     # ======================================================================= #
-    # === First check whether we have passed an Array
+    # Since as of April 2022 we will use the absolute path to the .pdf
+    # file at hand. The reason for this is because this makes it easier
+    # to know which files are open, and we can store these file paths
+    # into a local file (such as a .yml file), and then use this at a
+    # later time to restore all .pdf files that were open. This thus
+    # constitutes some type of "session management".
     # ======================================================================= #
-    if i.is_a? Array # Array tag
-      if i.size > DELAY_IF_WE_HAVE_MORE_THAN_N_ENTRIES
-        opnn; e 'More than '+simp(DELAY_IF_WE_HAVE_MORE_THAN_N_ENTRIES.to_s)+
-                ' entries given ('+i.size.to_s+'), hence we will use a '\
-                'small delay (of '+sfancy(delay?.to_s)+' seconds).'
-      end
-      i.each {|entry|
-        sleep delay? if i.size > DELAY_IF_WE_HAVE_MORE_THAN_N_ENTRIES # Small delay.
-        try_to_open_this_file_in_the_editor(entry)
-      }
-    else
-      # ===================================================================== #
-      # Get rid of localhost-string parts next.
-      # ===================================================================== #
-      if i.include? 'localhost'
-        i = replace_localhost_with_data(i)
-      end unless File.exist? i
-      # ===================================================================== #
-      # Next, we chop off '?' characters. This is, however had, not good if
-      # this is part of the filename. So we must check if the file exists,
-      # prior to doing this check.
-      # ===================================================================== #
-      unless File.exist? i
-        i = i[0..i.index('?')] if i.include? '?'
-      end
-      # ===================================================================== #
-      # Get rid of '#' in the input, if it exists.
-      # ===================================================================== #
-      i = i[0..i.index('#')] if i.include? '#'
-      case i
-      when 'LAST' # Assign the last file.
-        i = find_and_return_last_file
-      end
-      # ===================================================================== #
-      # Next, act on the extension name.
-      # ===================================================================== #
-      _ = File.extname(i).delete('.').downcase
-      case _ # case tag
-      # ===================================================================== #
-      # === open .pdf files
-      # ===================================================================== #
-      when 'pdf'
-        open_in_pdf_viewer(i)
-      # ===================================================================== #
-      # === epub
-      # ===================================================================== #
-      when 'epub'
-        esystem "okular #{i} &"
-      # ===================================================================== #
-      # === torrent
-      # ===================================================================== #
-      when 'torrent'
-        open_this_torrent_file(i)
-      # ===================================================================== #
-      # === Extensions that can be opened in the editor
-      # ===================================================================== #
-      when *ARRAY_EXTENSIONS_THAT_CAN_BE_OPENED_IN_THE_EDITOR
-        open_in_browser_or_in_editor(i)
-      # ===================================================================== #
-      # === All registered images
-      # ===================================================================== #
-      when *ARRAY_IMAGES
-        open_in_gimp(i)
-      # ===================================================================== #
-      # === All libreoffice extensions
-      # ===================================================================== #
-      when *ARRAY_LIBREOFFICE_EXTENSIONS
-        open_in_office(i)
+    i = File.absolute_path(i)
+    if File.exist? i
+      require 'pdf_paradise/main_pdf/main_pdf.rb'
+      require 'pdf_paradise/set_main_book.rb'
       # ===================================================================== #
-      # === All videos
+      # Only enable the following on my home-system, and only in the
+      # books-subdirectory, and university-subdirectory.
       # ===================================================================== #
-      when *ARRAY_VIDEOS
-        play_multimedia_file(i)
-      else
-        if File.exist? i
-          opnn; e "Not registered extension `#{sfancy(_)}`."
-          opnn; e 'We will attempt to open it anyway though.'
-          open_in_browser_or_in_editor(i)
-        else # else we conclude that the file does not exist.
-          no_file_was_found_at(i)
+      if is_on_roebe? and set_the_main_book?
+        case return_pwd
+        # =================================================================== #
+        # The following checks were explained above. We will also run
+        # rcfiles, and send pidof. 
+        # =================================================================== #
+        when /^#{Regexp.quote('/home/x/books/')}/,
+             /^#{Regexp.quote('/home/x/studium/')}/
+          PdfParadise::SetMainBook.new(i)
+          run_rcfiles_then_run_ata_via_qdbus
         end
       end
+      PdfParadise.main_pdf(i) {{
+        open_via_fullscreen: open_via_fullscreen?
+      }}
+      register_this_pdf_file(i)
+    else
+      this_file_was_not_found(i)
     end
-  end; alias consider_opening_the_given_input try_to_open_this_file_in_the_editor # === consider_opening_the_given_input
-       alias open_in_editor                   try_to_open_this_file_in_the_editor # === open_in_editor
-       alias open_these_files                 try_to_open_this_file_in_the_editor # === open_these_files
-
-  # ========================================================================= #
-  # === open_this_torrent_file
-  # ========================================================================= #
-  def open_this_torrent_file(i)
-    if i.include?("'") and !i.include?('"')
-      i = '"'+i+'"'
-    end
-    _ = "transmission #{i} &"
-    esystem(_)  
   end
 
   # ========================================================================= #
-  # === try_to_find_files_based_on_hyphens_as_part_of_the_input
-  #
-  # This method will try to find files based on '::' input.'
-  # ========================================================================= #
-  def try_to_find_files_based_on_hyphens_as_part_of_the_input(i)
-    if i.include? '::'
-      # ===================================================================== #
-      # In this case, replace '::', after passing it through the
-      # snakecase() method.
-      # ===================================================================== #
-      i = snakecase_and_prepend_first_name_and_lib(i).tr('::','/')+'/'
-    end
-    unless i.start_with?('/home')
-      # ===================================================================== #
-      # We assume that only ruby files follow the '::' layout, for now. (Jun 2017)
-      # ===================================================================== #
-      i.prepend('$RUBY_SRC/')
-    end
-    if i.include? '$'
-      i = convert_global_env(i)
-    end
-    i.squeeze!('/')
-    unless i.end_with?('*')
-      i << '*'
-    end
-    these_files = Dir[i]
-    open_these_files(these_files)
-  end
-
-  # ========================================================================= #
-  # === snakecase_and_prepend_first_name_and_lib
-  #
-  # This combines snakecase() by also prepending the first-name
-  # and "lib/" prefix.
-  # ========================================================================= #
-  def snakecase_and_prepend_first_name_and_lib(i)
-    if i.include? '::'
-      splitted = i.split('::')
-      first_name = splitted.first.downcase
-    end
-    i = snakecase(i)
-    return first_name+'/lib/'+i
-  end
-
-  # ========================================================================= #
-  # === register_this_pdf_file
+  # === register_this_pdf_file
   # ========================================================================= #
   def register_this_pdf_file(what)
     begin
       require 'save_file'
-      require 'roebe/constants/file_constants.rb'
-      require 'roebe/constants/directory_constants.rb'
+      require 'roebe/constants/file_and_directory_constants.rb'
     rescue LoadError; end
     into = Roebe.file_these_pdf_files_were_opened
     old_dataset = nil
@@ -627,36 +393,17 @@ class Open < ::Open::Base # === Open::Open
   end
 
   # ========================================================================= #
-  # === open_in_browser_or_in_editor
-  #
-  # This method was required because sometimes we wish to open in the
-  # browser, and sometimes we wish to open in the editor.
+  # === return_this_file_here
   # ========================================================================= #
-  def open_in_browser_or_in_editor(i)
-    if i.include? '//'
-      i = i.dup if i.frozen?
-      i.squeeze!('/')
-    end
-    # ======================================================================= #
-    # Next, we get the extension name.
-    # ======================================================================= #
-    _ = File.extname(File.basename(i)).delete '.'
-    case _
-    when 'html','php' # Open in both, in this case.
-      do_open_in_editor(i)
-      unless File.zero? i
-        ::Open.in_browser(i) unless _.include? 'php'
-      end
-    else
-      do_open_in_editor(i)
-    end
-  end
+  def return_this_file_here
+    __FILE__
+  end; alias this_file? return_this_file_here # === this_file?
 
   # ========================================================================= #
   # === open_in_gimp
   # ========================================================================= #
   def open_in_gimp(i)
-    esystem "#{@image_editor} #{i}#{IN_BACKGROUND}"
+    esystem "#{@internal_hash[:image_editor_to_use]} #{i}#{IN_BACKGROUND}"
   end
 
   # ========================================================================= #
@@ -676,147 +423,277 @@ class Open < ::Open::Base # === Open::Open
   end
 
   # ========================================================================= #
-  # === try_to_require_the_studium_project
+  # === open_via_fullscreen?
   # ========================================================================= #
-  def try_to_require_the_studium_project
-    unless Object.const_defined?(:Studium) and
-           Studium.respond_to?(:include_this_exam_topic?)
-      begin # We pull in only the relevant files from the Studium project.
-        require 'studium/constants/constants.rb'
-        require 'studium/toplevel_methods/find_exam_topic_and_exam_title.rb'
-        require 'studium/toplevel_methods/is_this_exam_topic_included.rb'
-      rescue LoadError
-        if is_on_roebe?
-          e 'The three files ('\
-            'studium/constants/constants.rb,'\
-            'studium/toplevel_methods/find_exam_topic_and_exam_title.rb and '\
-            'studium/toplevel_methods/is_this_exam_topic_included.rb '\
-            'forth) from the studium-project could not be loaded.'
-        end
+  def open_via_fullscreen?
+    @internal_hash[:open_via_fullscreen]
+  end
+
+  # ========================================================================= #
+  # === joined_and_stripped_commandline_arguments
+  # ========================================================================= #
+  def joined_and_stripped_commandline_arguments
+    _ = commandline_arguments?.map {|entry|
+      if entry.is_a? Symbol
+        entry = ":#{entry}" # Symbols become "fake" symbols here, on purpose.
       end
+      entry
+    }
+    return _.join(' ').strip
+  end
+
+  # ========================================================================= #
+  # === set_open_these_elements
+  # ========================================================================= #
+  def set_open_these_elements(i)
+    @internal_hash[:open_these_elements] = [i].flatten.compact
+  end; alias set_input       set_open_these_elements # === set_input
+       alias set_input_files set_open_these_elements # === set_input_files
+
+  # ========================================================================= #
+  # === play_multimedia_file
+  # ========================================================================= #
+  def play_multimedia_file(i)
+    esystem "#{USE_THIS_MPLAYER_COMMAND} #{i}" # open 
+  end
+
+  # ========================================================================= #
+  # === can_be_opened_in_the_editor?
+  # ========================================================================= #
+  def can_be_opened_in_the_editor?(i)
+    _ = File.extname(i).delete('.')
+    ARRAY_EXTENSIONS_THAT_CAN_BE_OPENED_IN_THE_EDITOR.include?(i)
+  end
+
+  # ========================================================================= #
+  # === find_and_return_last_file
+  #
+  # This method will select all files from the current directory and
+  # add the ctime (into the Array). Then it will simply sort based
+  # the ctime, and return the first entry.
+  # ========================================================================= #
+  def find_and_return_last_file
+    array = Dir['*'].select {|entry| File.file? entry }
+    array.map! {|entry|
+      [entry, File.ctime(entry)]
+    }
+    result = array.sort_by {|entry| entry[1] }.reverse
+    result = result.first[0] # Return the first entry here.
+    return result
+  end
+
+  # ========================================================================= #
+  # === open_this_torrent_file
+  #
+  # This method will properly open a .torrent file - right now hardcoded
+  # towards the "transmission" application.
+  # ========================================================================= #
+  def open_this_torrent_file(i)
+    if i.include?("'") and !i.include?('"')
+      i = '"'+i+'"'
     end
+    _ = "transmission #{i} &"
+    esystem(_)  
+  end
+
+  # ========================================================================= #
+  # === open_these_elements?
+  # ========================================================================= #
+  def open_these_elements?
+    @internal_hash[:open_these_elements]
+  end; alias input_files? open_these_elements? # === input_files?
+       alias input_file?  open_these_elements? # === input_file?
+       alias input?       open_these_elements? # === input?
+
+  # ========================================================================= #
+  # === remove_empty_entries
+  # ========================================================================= #
+  def remove_empty_entries
+    @internal_hash[:open_these_elements].reject! {|entry|
+      entry.nil? or entry.empty?
+    }
   end
 
   # ========================================================================= #
-  # === do_open_in_editor
+  # === snakecase_and_prepend_first_name_and_lib
   #
-  # This method will try to open the file via the specified (main)
-  # editor. Since as of August 2019, this will also be logged into
-  # a local file, if we are on a roebe-system.
+  # This combines snakecase() by also prepending the first-name
+  # and "lib/" prefix.
   # ========================================================================= #
-  def do_open_in_editor(
-      i, use_this_editor = @editor
-    )
-    if i.include? '//'
-      i.squeeze!('/')
+  def snakecase_and_prepend_first_name_and_lib(i)
+    if i.include? '::'
+      splitted = i.split('::')
+      first_name = splitted.first.downcase
     end
-    if Object.const_defined? :Roebe
-      expanded_alias = Roebe::FindExpandedAlias.new(i) { :be_quiet }
-      if expanded_alias.is_included?
-        unless File.exist? i
-          points_at = expanded_alias.points_at?
-          if points_at.include?(';')
-            splitted = points_at.split(';')
-            if File.exist? splitted.first
-              points_at = splitted.first
-            end
-          end
-          opnn; e 'Making use of the aliased-pointer at'
-          opnn; e '  `'+steelblue(points_at)+'`.'
-          i = points_at
-        end
-      end
+    i = snakecase(i)
+    return first_name+'/lib/'+i
+  end
+
+  # ========================================================================= #
+  # === replace_localhost_with_data
+  # ========================================================================= #
+  def replace_localhost_with_data(i)
+    if i.include? 'programming'
+      return i.sub('localhost',HOME_DIRECTORY_OF_USER_X)
+    else
+      return i.sub('localhost',"#{HOME_DIRECTORY_OF_USER_X}data/")
     end
-    i = rds(i) # Get rid of // again, just in case.
-    # ======================================================================= #
-    # Make an exception for .cpp files:
-    # ======================================================================= #
-    if (File.extname(i).delete('.') == 'cpp')
-      if is_on_roebe? and ENV.has_key?('CPP_EDITOR')
-        use_this_editor = ENV['CPP_EDITOR'].to_s.dup
-      else
-        use_this_editor = 'geany' # We use geany for cpp files.
-      end
+  end
+
+  # ========================================================================= #
+  # === try_to_find_files_based_on_hyphens_as_part_of_the_input
+  #
+  # This method will try to find files based on '::' input.'
+  # ========================================================================= #
+  def try_to_find_files_based_on_hyphens_as_part_of_the_input(i)
+    if i.include? '::'
+      # ===================================================================== #
+      # In this case, replace '::', after passing it through the
+      # snakecase() method.
+      # ===================================================================== #
+      i = snakecase_and_prepend_first_name_and_lib(i).tr('::','/')+'/'
     end
-    if i.include?("'") and !i.include?('"')
-      i = '"'+i+'"'
+    unless i.start_with?('/home')
+      # ===================================================================== #
+      # We assume that only ruby files follow the '::' layout, for now. (Jun 2017)
+      # ===================================================================== #
+      i.prepend('$RUBY_SRC/')
     end
-    if i.include? '('
-      i = '"'+i+'"'
+    if i.include? '$'
+      i = convert_global_env(i)
     end
-    _ = "#{use_this_editor} #{i}"
-    esystem(_)
-    if File.file?(i) and Object.const_defined?(:Roebe) and
-       File.directory?(Roebe.log_dir?) and
-       is_on_roebe?
-      into = Roebe.log_dir?+'opened_files.yml'
-      if File.exist? into
-        array = YAML.load_file(into)
-      else
-        array = [into].flatten.compact
-      end
-      what = YAML.dump(array)
-      SaveFile.write_what_into(what, into)
+    i.squeeze!('/')
+    unless i.end_with?('*')
+      i << '*'
     end
+    these_files = Dir[i]
+    open_these_files(these_files)
   end
 
   # ========================================================================= #
-  # === run_rcfiles_then_run_ata_via_qdbus
+  # === is_bluefish_running?
   # ========================================================================= #
-  def run_rcfiles_then_run_ata_via_qdbus
-    require 'rcfiles'
-    Rcfiles.run
-    esystem 'qdbus org.kde.konsole-`pidof -s konsole` /Sessions/2 runCommand "ata"'
-    esystem 'qdbus org.kde.konsole-`pidof -s konsole` /Sessions/3 runCommand "ata"'
-    esystem 'qdbus org.kde.konsole-`pidof -s konsole` /Sessions/4 runCommand "ata"'
+  def is_bluefish_running?
+    `ps ax | grep bluefish`.split("\n").reject {|entry|
+      entry.include? 'grep'
+    }.size > 0
   end
 
   # ========================================================================= #
-  # === open_in_pdf_viewer                                          (pdf tag)
+  # === start_bluefish
   #
-  # This method can be used to open a .pdf file. We will let the project
-  # PdfParadise handle this situation.
+  # This method can be used to start the bluefish-editor.
+  # ========================================================================= #
+  def start_bluefish
+    esystem 'bluefish &'
+  end
+
+  # ========================================================================= #
+  # === check_whether_the_user_has_provided_any_input
+  # ========================================================================= #
+  def check_whether_the_user_has_provided_any_input
+    _ = input_files?
+    local_files = Dir['*'].select {|entry| File.file? entry }
+    if _.empty? and !local_files.empty? and (local_files.size == 1)
+      # ===================================================================== #
+      # Handle the case where no specific input was given, but only
+      # one file exists in the local directory.
+      # ===================================================================== #
+      set_input_files(local_files.first)
+      _ = input_files?
+    end
+    if _.empty?
+      if is_on_roebe? and !is_bluefish_running?
+        opne 'Starting bluefish now, as we are on a roebe-system and'
+        opne 'bluefish is currently not running.'
+        start_bluefish
+      else
+        opne tomato('Please provide at the least one argument - the '\
+             'file you wish to open.')
+        exit
+      end
+    end
+  end
+
+  # ========================================================================= #
+  # === general_open_functionality
   #
-  # Since as of 19.09.2018 we will keep a log of the opened .pdf files
-  # if we are on roebe. This can then be used to determine which were
-  # the last .pdf files that were read.
+  # This method will act based on the extension name of the file usually -
+  # or, if not applicable, it will simply open this in the default,
+  # designated editor.
   # ========================================================================= #
-  def open_in_pdf_viewer(i)
-    require 'pdf_paradise' unless Object.const_defined? :PdfParadise
+  def general_open_functionality(i)
+    extname = File.extname(i).delete('.').downcase
+    case extname # case tag
     # ======================================================================= #
-    # Since as of April 2022 we will use the absolute path to the .pdf
-    # file at hand. The reason for this is because this makes it easier
-    # to know which files are open, and we can store these file paths
-    # into a local file (such as a .yml file), and then use this at a
-    # later time to restore all .pdf files that were open. This thus
-    # constitutes some type of "session management".
+    # === Extensions that can be opened in the editor
     # ======================================================================= #
-    i = File.absolute_path(i)
-    if File.exist? i
-      require 'pdf_paradise/main_pdf/main_pdf.rb'
-      require 'pdf_paradise/set_main_book.rb'
-      # ===================================================================== #
-      # Only enable the following on my home-system, and only in the
-      # books-subdirectory, and university-subdirectory.
-      # ===================================================================== #
-      if is_on_roebe? and set_the_main_book?
-        case return_pwd
-        # =================================================================== #
-        # The following checks were explained above. We will also run
-        # rcfiles, and send pidof. 
-        # =================================================================== #
-        when /^#{Regexp.quote('/home/x/books/')}/,
-             /^#{Regexp.quote('/home/x/studium/')}/
-          PdfParadise::SetMainBook.new(i)
-          run_rcfiles_then_run_ata_via_qdbus
-        end
+    when *ARRAY_EXTENSIONS_THAT_CAN_BE_OPENED_IN_THE_EDITOR
+      open_in_browser_or_in_editor(i)
+    # ======================================================================= #
+    # === torrent
+    # ======================================================================= #
+    when 'torrent'
+      open_this_torrent_file(i)
+    # ======================================================================= #
+    # === All registered images
+    # ======================================================================= #
+    when *ARRAY_IMAGES
+      open_in_gimp(i)
+    # ======================================================================= #
+    # === All libreoffice extensions
+    # ======================================================================= #
+    when *ARRAY_LIBREOFFICE_EXTENSIONS
+      open_in_office(i)
+    # ======================================================================= #
+    # === epub
+    # ======================================================================= #
+    when 'epub'
+      esystem "okular #{i} &"
+    # ======================================================================= #
+    # === open .pdf files
+    # ======================================================================= #
+    when 'pdf'
+      open_in_pdf_viewer(i)
+    # ======================================================================= #
+    # === All videos will enter here
+    # ======================================================================= #
+    when *ARRAY_VIDEOS
+      play_multimedia_file(i)
+    else
+      if File.exist? i
+        opne "#{rev}Not registered extension `#{sfancy(i)}#{rev}`."
+        opne 'We will attempt to open it anyway though.'
+        open_in_browser_or_in_editor(i)
+      else # else we conclude that the file does not exist.
+        no_file_was_found_at(i)
+      end
+    end
+  end; alias try_to_open_this_file_in_the_editor general_open_functionality # === try_to_open_this_file_in_the_editor
+
+  # ========================================================================= #
+  # === open_in_browser_or_in_editor
+  #
+  # This method was required because sometimes we wish to open in the
+  # browser, and sometimes we wish to open in the editor.
+  # ========================================================================= #
+  def open_in_browser_or_in_editor(i)
+    if i.include? '//'
+      i = i.dup if i.frozen?
+      i = rds(i)
+    end
+    # ======================================================================= #
+    # Next, we get the extension name.
+    # ======================================================================= #
+    _ = File.extname(File.basename(i)).delete '.'
+    case _
+    when 'html','php' # Open in both, editor and browser, in this case.
+      do_open_in_editor(i)
+      unless File.zero? i
+        ::Open.in_browser(i) unless _.include? 'php'
       end
-      PdfParadise.main_pdf(i) {{
-        open_via_fullscreen: @open_via_fullscreen
-      }}
-      register_this_pdf_file(i)
     else
-      this_file_was_not_found(i)
+      do_open_in_editor(i)
     end
   end
 
@@ -837,79 +714,135 @@ class Open < ::Open::Base # === Open::Open
   end
 
   # ========================================================================= #
-  # === show_help                                                  (help tag)
+  # === run_rcfiles_then_run_ata_via_qdbus
   # ========================================================================= #
-  def show_help
-    opnn; e 'The following options are available:'
-    e
-    ecomment '  SELF                       # Open this .rb file here.'
-    ecomment '  --use-this-browser=firefox # Assign a new browser, in this case firefox.'
-    ecomment '  --browser?                 # '\
-             'Show which browser is the currently assigned one.'
-    e
+  def run_rcfiles_then_run_ata_via_qdbus
+    require 'rcfiles'
+    Rcfiles.run
+    esystem 'qdbus org.kde.konsole-`pidof -s konsole` /Sessions/2 runCommand "ata"'
+    esystem 'qdbus org.kde.konsole-`pidof -s konsole` /Sessions/3 runCommand "ata"'
+    esystem 'qdbus org.kde.konsole-`pidof -s konsole` /Sessions/4 runCommand "ata"'
   end
 
   # ========================================================================= #
-  # === menu                                                       (menu tag)
+  # === sanitize_the_commandline_arguments
   # ========================================================================= #
-  def menu(
-      i = input?
-    )
-    if i.is_a? Array
-      i.each {|entry| menu(entry) }
-    else
-      case i # (case tag)
+  def sanitize_the_commandline_arguments
+    @commandline_arguments.flatten!
+    @commandline_arguments.map! {|entry|
+      case entry
+      when '*'
+        entry = Dir['*']
+      end
+      entry
+    }
+    @commandline_arguments.flatten!
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    sanitize_the_commandline_arguments
+    # @internal_hash[:open_these_elements] << joined_and_stripped_commandline_arguments
+    @internal_hash[:open_these_elements] << commandline_arguments_without_hyphens
+    remove_empty_entries
+    check_whether_the_user_has_provided_any_input
+    try_to_require_the_studium_project
+    try_to_require_the_beautiful_url_project
+    menu # Now we can pass this into the main menu here.
+    array = [@internal_hash[:open_these_elements]].flatten.compact
+    array.each {|_|
+      _ = _.to_s.dup # Always work on a String-copy past this point.
+      # ===================================================================== #
+      # Check whether the input includes the ':' character - but this may
+      # have two different use cases. The first one is to check for a
+      # shortcut entry; the second will just ignore the part after ':'.
+      # ===================================================================== #
+      if _.start_with? ':'
+        open_in_editor(_)
+        return
+      end
+      if _.include?(':') and
+       !File.exist?(_) and
+        File.exist?(_.split(':').first.to_s)
+        _ = _.split(':').first.to_s
+      end
       # ===================================================================== #
-      # === open --browser?
+      # Next, we handle input such as:
+      #
+      #   'lib/lpc/requires/basic_requires.rb:begin'
+      #
+      # This evidently does not end with a ':' character, but it clearly
+      # has a fairly useless ':' component in it. If that is the case,
+      # we will treat this as input that is only valid up towards the
+      # very right ':', anchored on the '.rb:' part.
       # ===================================================================== #
-      when /^-?-?browser\??$/
-        _ = YAML.load_file(::Open.file_browser?)
-        e 'The browser currently in use is `'+sfancy(_)+'`.'
-        exit
+      if _.include? '.rb:'
+        # =================================================================== #
+        # The following code means to find the index at '.rb:' and then add
+        # 2 to it - this should be the correct name of the entry at hand.
+        # =================================================================== #
+        _ = _[0 .. (_.index('.rb:')+2)]
+      end
+      unless File.exist? _
+        _.chop! if _.end_with? '#'  # Don't need trailing '#' tokens.
+        _.chop! if _.end_with? ':-' # ← This check must come before the check against ':'. 
+        _.chop! if _.end_with? ':'  # Chop off trailing ':' tokens.
+        _.chop! if _.end_with? ';'  # Chop off trailing ':' tokens.
+        _.delete_prefix!('http:') if _.start_with?('http:')
+      end
+      case _
       # ===================================================================== #
-      # === open --use-this-browser=firefox
+      # === open ME
       # ===================================================================== #
-      when /^-?-?use(-|_)?this(-|_)?browser=(.+)/
-        ::Open.permanently_use_this_browser = $3.to_s.dup
+      when 'ME',
+           'SELF',
+           'ALL',/
+           ^-?-?this(_|-)?file/
+        open_this_file_here
         exit
+      end unless File.exist?(_)
+      _.delete!('^') if _.include?('^')
+      if _.end_with?('.') and File.exist?(_[0..-2])
+        # =================================================================== #
+        # This clause will be entered if we have input something like
+        # "colours.rb." where the user may have wanted to type in
+        # "colours.rb" - and IF the file exists.
+        # =================================================================== #
+        opne "Assuming a superfluous trailing '.', so removing "\
+             "the last '.' there."
+        _.chop!
       end
-    end
-  end
-
-  # ========================================================================= #
-  # === try_to_require_the_beautiful_url_project
-  # ========================================================================= #
-  def try_to_require_the_beautiful_url_project
-    unless Object.const_defined? :BeautifulUrl
-      begin
-        require 'roebe/requires/failsafe_require_of_beautiful_url.rb'
-      rescue LoadError; end
-    end
-  end
-
-  # ========================================================================= #
-  # === run_everything
-  # ========================================================================= #
-  def run_everything
-    input_files = input_files?.flatten
-    # ======================================================================= #
-    # Iterate over all input files that were passed to us.
-    # ======================================================================= #
-    input_files.each {|this_file|
       # ===================================================================== #
-      # Check whether the input includes the ':' character:
+      # Split away at '::' if this is part of that substring.
+      # ===================================================================== #
+      if _.include? '::'
+        splitted = _.split('::')
+        _ = splitted.last
+      end
       # ===================================================================== #
-      if this_file.include?(':') and !File.exist?(this_file) and
-        File.exist?(this_file.split(':').first.to_s)
-        this_file = this_file.split(':').first.to_s
+      # === Get rid of localhost-string parts next.
+      #
+      # Get rid of the String "localhost" next. This must be handled with
+      # more care, because some files may include the string 'localhost' as
+      # part of their name, such as 'remove_localhost.rb'. In this case,
+      # we will additionally check whether the file exists.
+      # ===================================================================== #
+      if _.is_a?(String) and _.include?('localhost')
+        unless File.exist? _ # See the above header for an explanation.
+          _ = replace_localhost_with_data(_)
+        end
       end
-      if this_file.start_with?('http:') and !File.exist?(this_file)
-        this_file.delete_prefix!('http:')
+      case _
+      when 'LAST' # Assign the last file.
+        _ = find_and_return_last_file
       end
       # ===================================================================== #
-      # === Query whether the file exists or whether it does not
+      # If the file exists, enter here first - thus, we will query whether
+      # the file exists or whether it does not.
       # ===================================================================== #
-      if File.exist?(this_file) # This is the simplest way - the file exists here.
+      if File.exist? _ # This is the simplest way - the file exists here.
         # =================================================================== #
         # However had, in December 2022 it was noticed that a file such
         # as "curricula.yml" may exist, as well as a directory called
@@ -917,86 +850,91 @@ class Open < ::Open::Base # === Open::Open
         # curricula.yml rather than curricula/. So, what to do in this
         # case? Well - we will do a minimal glob, that is, if a file
         # exists as described above, then we will prioritize this over
-        # the directory name.
+        # the directory name and immediately open it.
         # =================================================================== #
-        if File.directory?(this_file) and !File.file?(this_file) and
-           (Dir[this_file+'*'].size > 0)
-          this_file = Dir[this_file+'.*'].first.to_s # Pick a real file in this case.
+        if File.directory?(_) and !File.file?(_) and
+           (Dir["#{_}*"].size > 0)
+          _ = Dir["#{_}*"].first.to_s # Pick a real file in this case.
         end
-        try_to_open_this_file_in_the_editor(this_file)
-      else # Ok, the file was not instantly found. Run more checks here.
-        possible_matches = Dir[('*'+this_file+'*').squeeze('*')] # ← This may be an empty Array as well.
+        general_open_functionality(_)
+      # ===================================================================== #
+      # === Check whether the input is an exam-question next
+      #
+      # This check should come before we delegate towards FindExpandedAlias.
+      #
+      # Invocation example:
+      #
+      #   open ab2
+      #
+      # ===================================================================== #
+      elsif Object.const_defined?(:Studium) and
+             ::Studium.respond_to?(:include_this_exam_topic?) and
+             ::Studium.respond_to?(:find_corresponding_exam_topic) and
+             ::Studium.include_this_exam_topic?(_) # open ab2
+        _ = ::Studium.find_corresponding_exam_topic(
+          ::Studium.find_corresponding_exam_topic(_),
+          :be_quiet
+        ) # This can be false.
+        if _
+          if is_on_roebe?
+            _ = Studium.my_exam_topics_directory?+File.basename(_)
+          else
+            _ = Studium.exam_topics_directory?+File.basename(_)
+          end
+          open_in_editor(_)
+        end
+      # ===================================================================== #
+      # === Query whether BeautifulUrl includes this file.
+      # ===================================================================== #
+      elsif BeautifulUrl.does_include?(_) # open linux
+        _ = beautiful_url(_)
+        consider_opening_the_given_input(_) # Then try again.
+      # ===================================================================== #
+      # Ok, the following else-clauses handle the situation
+      # that the given input could not be found.
+      # ===================================================================== #
+      elsif _.include? 'project_'
+        do_open_in_editor(_)
+      else
+        possible_matches = Dir[('*'+_+'*').squeeze('*')] # ← This may be an empty Array as well.
         # =================================================================== #
         # Since as of Jan 2018, if the variable possible_matches is NOT
         # empty, we will sort it in a way so that the shorter file names
-        # are on top of the array.
+        # are on top of the array. See the following clause for that.
         # =================================================================== #
         unless possible_matches.empty?
           possible_matches = possible_matches.sort_by {|entry| entry.size }
         end
         # =================================================================== #
-        # === Check whether the input is an exam-question next
-        #
-        # This check should come before we delegate towards FindExpandedAlias.
-        # =================================================================== #
-        if Object.const_defined?(:Studium) and
-           ::Studium.respond_to?(:include_this_exam_topic?) and
-           ::Studium.respond_to?(:find_corresponding_exam_topic) and
-           ::Studium.include_this_exam_topic?(this_file) # open ab2
-          _ = ::Studium.find_corresponding_exam_topic(
-            ::Studium.find_corresponding_exam_topic(this_file),
-            :be_quiet
-          ) # This can be false.
-          if _
-            if is_on_roebe?
-              _ = Studium.my_exam_topics_directory?+File.basename(_)
-            else
-              _ = Studium.exam_topics_directory?+File.basename(_)
-            end
-            open_in_editor(_)
-          end
+        # At the least one entry has been found in the next case.
         # =================================================================== #
-        # === Query whether BeautifulUrl includes this file.
-        # =================================================================== #
-        elsif BeautifulUrl.does_include?(this_file) # open linux
-          _ = beautiful_url(this_file)
-          consider_opening_the_given_input(_) # Then try again.
-        # =================================================================== #
-        # Ok, the following else-clauses handle the situation
-        # that the given input could not be found.
-        # =================================================================== #
-        elsif this_file.include? 'project_'
-          do_open_in_editor(this_file)
-        # =================================================================== #
-        # At the least one entry has been found.
-        # =================================================================== #
-        elsif ((_ = possible_matches).size > 0) # If we can find at least one entry.
-          consider_opening_the_given_input(_.first) # Recursive call.
+        if (possible_matches.size > 0) # If we can find at least one entry.
+          consider_opening_the_given_input(possible_matches.first) # Recursive call here.
         # =================================================================== #
         # Same as above, but both prepend and append a '*' character.
         # =================================================================== #
-        elsif ((_ = possible_matches).size > 0) # If we can find at least one entry.
-          consider_opening_the_given_input(_.first)
+        elsif (possible_matches.size > 0) # If we can find at least one entry.
+          consider_opening_the_given_input(possible_matches.first)
         # =================================================================== #
         # Next, try to pass it through class Roebe::FindExpandedAlias.
         # =================================================================== #
-        elsif File.exist?(_ = Roebe.find_expanded_alias(this_file).to_s)
-          open_in_editor(_)
+        elsif File.exist?(more_matches = Roebe.find_expanded_alias(_).to_s)
+          open_in_editor(more_matches)
         # =================================================================== #
         # Next, try to handle input containing two ':' tokens.
         # =================================================================== #
-        elsif this_file.include?('::')
-          try_to_find_files_based_on_hyphens_as_part_of_the_input(this_file)
+        elsif _.include?('::')
+          try_to_find_files_based_on_hyphens_as_part_of_the_input(_)
         # =================================================================== #
         # Use RUBY_SRC as shortcut on my home system.
         # =================================================================== #
         elsif is_on_roebe? and
-              File.exist?(return_assumed_path_to_ruby_src_lib_of(this_file))
-          use_this_file_instead = return_assumed_path_to_ruby_src_lib_of(this_file)
-          e rev+'Since we are on roebe, we will use another path, aka'
-          e
-          e "  #{steelblue(use_this_file_instead)}"
-          e
+              File.exist?(return_assumed_path_to_ruby_src_lib_of(_))
+          use_this_file_instead = return_assumed_path_to_ruby_src_lib_of(_)
+          opne "#{rev}Since we are on roebe, we will use another path, aka"
+          opne
+          opne "  #{steelblue(use_this_file_instead)}"
+          opne
           open_in_editor(use_this_file_instead)
         # =================================================================== #
         # === Check for aliases next
@@ -1004,30 +942,29 @@ class Open < ::Open::Base # === Open::Open
         # Next, try to find an expanded alias here.
         # =================================================================== #
         elsif Roebe.const_defined?(:FindExpandedAlias) and
-              (::Roebe::FindExpandedAlias[this_file] != this_file)
-          do_open_in_editor(this_file)
+              (::Roebe::FindExpandedAlias[_] != _)
+          do_open_in_editor(_)
         else
-          opnn; e 'No match could be found for `'+sfancy(this_file)+'`.'
+          # ================================================================= #
+          # Alright - the file was not found via the above checks, so we
+          # will simply delegate towards Open.in_browser() next.
+          # ================================================================= #
+          # Or we could notify the user that no entry was found:
+          # opne "No match could be found for `#{sfancy(_)}`."
+          # ================================================================= #
+          ::Open.in_browser(_)
         end
       end
     }
   end
 
-  # ========================================================================= #
-  # === run                                                         (run tag)
-  # ========================================================================= #
-  def run
-    check_whether_the_user_has_provided_any_input
-    try_to_require_the_studium_project
-    try_to_require_the_beautiful_url_project
-    menu
-    run_everything
-  end
-
   # ========================================================================= #
   # === Open::Open[]
   # ========================================================================= #
-  def self.[](i = ARGV, &block)
+  def self.[](
+      i = ARGV,
+      &block
+    )
     new(i, &block) # Always delegate here.
   end
 
@@ -1036,15 +973,20 @@ end
 # =========================================================================== #
 # === Open.open
 # =========================================================================== #
-def self.open(i = ARGV, &block)
+def self.open(
+    i = ARGV, &block
+  )
   ::Open::Open.new(i, &block)
 end; self.instance_eval { alias [] open } # === Open[]
 
 # =========================================================================== #
 # === Open.pdf_viewer?
+#
+# This method can be used to query the pdf-viewer in use.
 # =========================================================================== #
 def self.pdf_viewer?
-  unless (Object.const_defined?(:PdfParadise) and PdfParadise.const_defined?(:MainPdf))
+  unless (Object.const_defined?(:PdfParadise) and
+          PdfParadise.const_defined?(:MainPdf))
     require 'pdf_paradise/main_pdf/main_pdf.rb' 
   end
   return ::PdfParadise.use_which_pdf_viewer?
@@ -1054,4 +996,4 @@ end
 
 if __FILE__ == $PROGRAM_NAME
   Open::Open.new(ARGV)
-end # open
+end # ruby open.rb local_ginger