studium 0.9.383

data/lib/studium/toplevel_methods/return_ects_from_this_lecture_stored_in_the_file_lecture_information.rb

@@ -0,0 +1,194 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# The file here obtains the amount of ECTS points stored in the file
+# lecture_information.yml.
+#
+# Another method exists, in the file called "ects_from_lectures.rb", but
+# that file only obtains the amount of ECTS points from already passed
+# lectures. So the method here is more flexible and should ideally be
+# used in the future.
+#
+# In the long run, it will probably become the default method if one wants
+# to obtain the amount of ECTS from a given lecture, but for now, we will
+# also retain the old way.
+# =========================================================================== #
+# require 'studium/toplevel_methods/return_ects_from_this_lecture_stored_in_the_file_lecture_information.rb'
+# =========================================================================== #
+require 'studium/constants/file_constants.rb'
+require 'studium/requires/require_encoding.rb'
+require 'studium/toplevel_methods/e.rb'
+require 'studium/toplevel_methods/main_dataset.rb'
+require 'studium/toplevel_methods/return_sanitized_dataset_from_the_file_lecture_information.rb'
+
+module Studium
+
+  # ========================================================================= #
+  # === Studium.return_ects_from_this_lecture_stored_in_the_file_lecture_information
+  #
+  # The first input argument should be the name of the lecture at hand,
+  # such as "Programmierpraktikum".
+  #
+  # The second argument is optional, and can be used to specify the
+  # lecture-id precisely (the LVA id number). If specified then the
+  # method will require a hard match to the given lecture.
+  #
+  # The second argument can be either :exact or :partial, with :exact
+  # being the default. It means that the right name has to be used
+  # in order to return the full dataset; if :partial is used, then
+  # any partial substring will be used.
+  # ========================================================================= #
+  def self.return_ects_from_this_lecture_stored_in_the_file_lecture_information(
+      name_of_the_lecture,
+      optional_id_of_the_lecture = nil,
+      partial_or_exact_match     = :exact
+    )
+    case optional_id_of_the_lecture
+    when :default
+      optional_id_of_the_lecture = nil # This is the default value.
+    end
+    if name_of_the_lecture.is_a? Array
+      n_ects_points = name_of_the_lecture.map {|entry|
+        # =================================================================== #
+        # In this case, do a recursive-calling operation.
+        # =================================================================== #
+        return_ects_from_this_lecture_stored_in_the_file_lecture_information(
+          entry,
+          optional_id_of_the_lecture,
+          partial_or_exact_match 
+        )
+      }
+      if n_ects_points.is_a? Array
+        n_ects_points = n_ects_points.sum
+      end
+      n_ects_points
+    else
+      n_ects_points = 0 # <- Default value.
+      if name_of_the_lecture.end_with? ','
+        name_of_the_lecture = name_of_the_lecture.dup if name_of_the_lecture.frozen?
+        name_of_the_lecture.chop!
+      end
+      name_of_the_lecture = name_of_the_lecture.dup if name_of_the_lecture.frozen?
+      name_of_the_lecture.squeeze!(' ') # We don't need more than one ' '.
+      _ = FILE_LECTURE_INFORMATION
+      if ::Studium.main_dataset?
+        dataset = ::Studium.main_dataset?
+      else
+        if File.exist? _
+          dataset = Studium.return_sanitized_dataset_from_the_file_lecture_information
+        else
+          e 'No file called '+sfile(_)+' exists. Exiting now.'
+          exit
+        end
+      end
+      dataset_from_lecture_aliases = ensure_main_encoding(
+        YAML.load_file(FILE_LECTURE_ALIASES)
+      )
+      pointer_to_dataset = dataset_from_lecture_aliases[name_of_the_lecture]
+      if optional_id_of_the_lecture and pointer_to_dataset
+        if pointer_to_dataset.has_key?(:new_lva_id) and
+           (pointer_to_dataset[:old_lva_id] == optional_id_of_the_lecture)
+          # ================================================================= #
+          # We must re-write to the new LVA id because the file called
+          # "lecture_information.yml" will only store up-to-date entries.
+          # ================================================================= #
+          optional_id_of_the_lecture = pointer_to_dataset[:new_lva_id]
+        end
+      end
+      # ===================================================================== #
+      # We will next try to find a corresponding match - but obviously,
+      # no such match may exist, so we need to include this possibility
+      # in the following checks as well.
+      # ===================================================================== #
+      if optional_id_of_the_lecture
+        optional_id_of_the_lecture = Studium.ensure_main_encoding(optional_id_of_the_lecture)
+      end
+      if optional_id_of_the_lecture
+        possible_matches = dataset.select {|key, value|
+          key = Studium.ensure_main_encoding(key)
+          # ================================================================= #
+          # Next, we must anchor this key to one of the lecture. We have to
+          # distinguish between empty LVA-IDs and non-empty variants.
+          # ================================================================= #
+          if optional_id_of_the_lecture.empty?
+            key =~ /^#{Regexp.quote(name_of_the_lecture)}$/
+          else
+            key =~ /^#{optional_id_of_the_lecture} #{Regexp.quote(name_of_the_lecture)}$/
+          end
+        }
+      else # Ok, no LVA-ID was provided, so we have to try to find a match nonetheless.
+        possible_matches = dataset.select {|key, value|
+          # ================================================================= #
+          # Next, Regexp.quote() may start with a ' ' or not.
+          # If it starts with a ' ' then a few lectures may not
+          # be found, such as the lecture:
+          #   "Modul BIOINF01b Basiswissen Informatik f�r die Bioinformatik":
+          # ================================================================= #
+          this_string = Regexp.quote("#{name_of_the_lecture}")
+          key =~ /#{this_string}$/ # Anchor it to a regex.
+        }
+        if possible_matches.empty?
+          # ================================================================= #
+          # In this case, we will try again with the first character
+          # being upcased.
+          # ================================================================= #
+          name_of_the_lecture = name_of_the_lecture.dup if name_of_the_lecture.frozen?
+          name_of_the_lecture[0,1] = name_of_the_lecture[0,1].upcase
+          possible_matches = dataset.select {|key, value|
+            this_string = Regexp.quote(" #{name_of_the_lecture}")
+            key =~ /#{this_string}$/ # Anchor it to a regex.
+          }
+        end
+        if possible_matches.empty? and
+           (partial_or_exact_match == :partial)
+          # ================================================================= #
+          # Next, we can still try a partial match.
+          # ================================================================= #
+          possible_keys = dataset.keys.select {|key, value|
+            regexp = / #{name_of_the_lecture}/i
+            key =~ regexp
+          }
+          possible_matches = dataset.select {|key, value|
+            possible_keys.include? key
+          }
+        end
+      end
+      unless possible_matches.empty?
+        # =================================================================== #
+        # Ok, we found a match then.
+        # =================================================================== #
+        ects_points_of_this_lecture = possible_matches.values.first[:ects]
+        n_ects_points += ects_points_of_this_lecture
+      end
+      return n_ects_points
+    end
+  end; self.instance_eval {
+    alias return_n_ects_points_from_this_lecture                              return_ects_from_this_lecture_stored_in_the_file_lecture_information
+    alias return_n_ects_of_this_lecture_based_on_the_file_lecture_information return_ects_from_this_lecture_stored_in_the_file_lecture_information
+  } # === Studium.return_n_ects_points_from_this_lecture
+    # === Studium.return_n_ects_of_this_lecture_based_on_the_file_lecture_information
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  if ARGV.size > 1
+    pp Studium.return_ects_from_this_lecture_stored_in_the_file_lecture_information(
+      ARGV[0],ARGV[1], :partial
+    )
+  else
+    pp Studium.return_ects_from_this_lecture_stored_in_the_file_lecture_information(
+      ARGV,
+      :default,
+      :partial
+    )
+  end
+end # lvaects "Allgemeine und molekulare Mikrobiologie II"
+    # lvaects "Allgemeine und molekulare Mikrobiologie II", '301211'
+    # lvaects "(Biochemie) Biologische Chemie I"
+    # lvaects "(Biochemie) Biologische Chemie I", '270005'
+    # lvaects "(Biochemie) Biologische Chemie I", '270006'
+    # lvaects Programmierpraktikum
+    # lvaects programmierpraktikum
+    # lvaects programmierpra
+    # lvaects "Modul BIOINF01b Basiswissen Informatik f�r die Bioinformatik"

data/lib/studium/toplevel_methods/return_hash_of_already_solved_lectures.rb

@@ -0,0 +1,38 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# The purpose of this class is to return a Hash of all lectures that were
+# already sovled.
+# =========================================================================== #
+# require 'studium/toplevel_methods/return_hash_of_already_solved_lectures.rb'
+# =========================================================================== #
+require 'studium/toplevel_methods/main_dataset.rb'
+require 'studium/toplevel_methods/return_sanitized_dataset_from_the_file_lecture_information.rb'
+
+module Studium
+
+  # ========================================================================= #
+  # === Studium.return_hash_of_already_solved_lectures
+  #
+  # This method will return a Hash of all lectures that have already
+  # been solved.
+  # ========================================================================= #
+  def self.return_hash_of_already_solved_lectures
+    if ::Studium.main_dataset?
+      dataset = ::Studium.main_dataset? # In this case, re-use the main dataset.
+    else # else load up a new dataset
+      dataset = ::Studium.return_sanitized_dataset_from_the_file_lecture_information
+    end
+    dataset.select! {|name_of_the_lecture, inner_dataset|
+      already_solved = inner_dataset[:already_solved]
+      already_solved == true
+    }
+    return dataset
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  pp Studium.return_hash_of_already_solved_lectures.size  
+end

data/lib/studium/toplevel_methods/return_local_path_of_this_pwdstud.rb

@@ -0,0 +1,61 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'studium/toplevel_methods/return_local_path_of_this_pwdstud.rb'
+# =========================================================================== #
+module Studium
+
+  require 'studium/requires/require_encoding.rb'
+  require 'studium/constants/roebe.rb'
+  require 'studium/toplevel_methods/file_cd_aliases.rb'
+
+  # ========================================================================= #
+  # === Studium.return_local_path_of_this_pwdstud
+  #
+  # The first argument to this method should be a number, usually a
+  # small one, starting from 1. This will then be expanded into an
+  # entry such as "pwdstud1" or "pwdstud4" and so forth.
+  #
+  # These are then checked against a file that is supposed to include
+  # these keys. If all works well then the path to a local directory
+  # will be returned.
+  #
+  # The method will also ensure that a trailing '/' character is to
+  # be returned, if a match is found.
+  #
+  # Usage examples:
+  #
+  #   Studium.return_local_path_of_this_pwdstud 1 # => "/home/x/STUDIUM/UNI_WIEN/321025_Einf�hrung_in_pharmazeutisches_Imaging_B13/"
+  #   Studium.return_local_path_of_this_pwdstud 3 # => "/home/x/STUDIUM/BOKU_WIEN/803302_Methods_in_ultrastructure_research_in_Eng/"
+  #
+  # ========================================================================= #
+  def self.return_local_path_of_this_pwdstud(
+      i = 1
+    )
+    _ = FILE_CD_ALIASES
+    i = i.first if i.is_a? Array
+    if File.exist? _
+      begin
+        require 'studium/requires/require_the_proper_yaml_engine.rb'
+      rescue LoadError; end
+      dataset = YAML.load_file(_)
+      key  = ensure_main_encoding("pwdstud#{i}")
+      path = ensure_main_encoding(dataset[key]).sub(/^cd /,'').strip
+      path << '/' unless path.end_with? '/' # Require a trailing '/' character.
+      return path
+    end
+    nil
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  if ARGV.empty?
+    puts Studium.return_local_path_of_this_pwdstud 1
+    puts Studium.return_local_path_of_this_pwdstud 2
+    puts Studium.return_local_path_of_this_pwdstud 3
+  else
+    puts Studium.return_local_path_of_this_pwdstud(ARGV)  
+  end
+end

data/lib/studium/toplevel_methods/return_location_to_this_exam_topic.rb

@@ -0,0 +1,28 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This file can be used to return the location to an exam topic.
+# =========================================================================== #
+# require 'studium/toplevel_methods/return_location_to_this_exam_topic.rb'
+# =========================================================================== #
+require 'studium/constants/exam_topics.rb'
+require 'studium/toplevel_methods/find_corresponding_exam_topic.rb'
+
+module Studium
+
+  # ========================================================================= #
+  # === Studium.return_location_to_this_exam_topic
+  # ========================================================================= #
+  def self.return_location_to_this_exam_topic(i)
+    i = i.first if i.is_a? Array
+    i = ::Studium.find_corresponding_exam_topic(i.to_s)
+    return "#{::Studium.exam_topics?}#{i}"
+  end; self.instance_eval { alias return_location_to_this_exam return_location_to_this_exam_topic } # === Studium.return_location_to_this_exam_topic
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  puts Studium.return_location_to_this_exam_topic(ARGV)
+end # return_location_to_this_exam_topic
+    # return_location_to_this_exam_topic yeast

data/lib/studium/toplevel_methods/return_lva_number_of_this_curriculum.rb

@@ -0,0 +1,74 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'studium/toplevel_methods/return_lva_number_of_this_curriculum.rb'
+# =========================================================================== #
+require 'studium/toplevel_methods/e.rb'
+require 'studium/constants/file_constants.rb'
+require 'studium/requires/require_encoding.rb'
+require 'studium/colours/colours.rb'
+
+module Studium
+
+  # ========================================================================= #
+  # === Studium.return_lva_number_of_this_curriculum
+  #
+  # This method will return the LVA number of a particular curriculum.
+  #
+  # Pass in the name of the curriculum.
+  #
+  # Invocation example:
+  #   Studium.return_lva_number_of_this_curriculum 'Lebensmittel- und Biotechnologie'
+  # ========================================================================= #
+  def self.return_lva_number_of_this_curriculum(i)
+    # ======================================================================= #
+    # First, sanitize strings if they include at the least two newlines:
+    # ======================================================================= #
+    if i.is_a?(String) and i.count("\n") > 1
+      i = i.split("\n").flatten
+    end
+    dataset = YAML.load_file(FILE_CURRICULA)
+    reverse_dataset = dataset.invert # Must get rid of two strings.
+    _ = {}
+    reverse_dataset.each_pair {|key, value|
+      key = Studium.ensure_main_encoding(key)
+      value = Studium.ensure_main_encoding(value)
+      # ===================================================================== #
+      # Get rid of two words from the key.
+      # ===================================================================== #
+      _[key.sub(/Bachelorcurriculum /,'').sub(/Mastercurriculum /,'')] = value
+    }
+    reverse_dataset = _ # Re-assign it to our dataset.
+    if i.is_a? Array
+      i.each {|entry| return_lva_number_of_this_curriculum(entry) }
+    else
+      # ===================================================================== #
+      # Next, we must find the corresponding entries in the curriculum.yml
+      # file. This file is not distributed with the studium project,
+      # since it is only useful for my own dataset.
+      #
+      # The file curricula.yml file comes bundled with the studium gem
+      # since as of February 2018. The format is a hash having
+      # key-value entries:
+      #
+      #   (1) first the number of the curriculum
+      #   (2) the full and complete name of the curriculum, at hand
+      #
+      # ===================================================================== #
+      if reverse_dataset.has_key? i
+        e 'The curriculum '+Studium::Colours.simp(i)+' corresponds '\
+          'to the number `'+
+          Studium::Colours.sfancy(reverse_dataset[i])+'`.'
+      else
+        e 'The curriculum for '+Studium::Colours.sfancy(i)+' does not appear to be registered.'
+        e '  '+Studium::Colours.sfile(FILE_CURRICULA)
+      end
+    end
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  Studium.return_lva_number_of_this_curriculum(ARGV)
+end # return_lva_number_of_this_curriculum 'Lebensmittel- und Biotechnologie'

data/lib/studium/toplevel_methods/return_lva_number_of_this_lecture.rb

@@ -0,0 +1,486 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Studium::LvaNummer
+#
+# This class will return and display, on the commandline, the particular
+# LVA number of a given lecture.
+# =========================================================================== #
+# require 'studium/toplevel_methods/return_lva_number_of_this_lecture.rb'
+# =========================================================================== #
+require 'studium/base/prototype.rb'
+require 'studium/requires/common_popular_requires.rb'
+require 'studium/toplevel_methods/has_this_lecture_been_already_passed_but_the_id_was_changed_lateron.rb'
+require 'studium/toplevel_methods/url.rb' # Has Studium.sanitize_url().
+require 'socket'
+
+begin
+  require 'xorg_buffer'
+rescue LoadError; end
+
+module Studium # === Studium
+
+class LvaNummer < Base # === Studium::LvaNummer
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === MAIN_POSITION_IN_THE_ARRAY
+  #
+  # This constant should refer to the position of the .csv file that
+  # keeps our lecture ID.
+  # ========================================================================= #
+  MAIN_POSITION_IN_THE_ARRAY = 7
+
+  # ========================================================================= #
+  # === initialize
+  #
+  # Note that the first argument may also be a Hash.
+  # ========================================================================= #
+  def initialize(
+      commandline_arguments = ARGV,
+      run_already           = true
+    )
+    reset
+    set_find_this_lecture(commandline_arguments)
+    if block_given?
+      yielded = yield
+      case yielded
+      when :do_not_modify_the_xorg_buffer
+        @do_modify_the_xorg_buffer = false
+      end
+    end
+    case run_already
+    when :do_not_run_yet
+      run_already = false
+    end
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    super()
+    @namespace = NAMESPACE
+    # ======================================================================= #
+    # Obtain the dataset holding all the passed exams per month.
+    # ======================================================================= #
+    @dataset = File.readlines(
+      FILE_PASSED_EXAMS_PER_MONTH,
+      :encoding => main_encoding?
+    )
+    @do_modify_the_xorg_buffer = true
+    @do_report_results = true
+    @lva_number = 0 # Store the LVA Number here.
+    sanitize_dataset
+  end
+
+  # ========================================================================= #
+  # === set_find_this_lecture
+  # ========================================================================= #
+  def set_find_this_lecture(i)
+    i = i.join(' ').strip if i.is_a? Array
+    # ======================================================================= #
+    # Need to protect against frozen strings.
+    # ======================================================================= #
+    i = i.dup if i.frozen?
+    unless i.encoding.to_s.include? USE_THIS_ENCODING
+      i = i.force_encoding(USE_THIS_ENCODING)
+    end    
+    i.strip!
+    # ======================================================================= #
+    # The following constant is defined in studium/constants/constants.rb.
+    # ======================================================================= #
+    if HASH_PASSED_LECTURES_THAT_WERE_LATERON_CHANGED.values.include?(i)
+      # ===================================================================== #
+      # "Re-wire" to the real name of the lecture.
+      # ===================================================================== #
+      lva_id = HASH_PASSED_LECTURES_THAT_WERE_LATERON_CHANGED.invert[i] # Now we have the LV-id.
+      lva_id = HASH_PASSED_LECTURES_THAT_WERE_LATERON_CHANGED_LV_ID_ALIASES[lva_id]
+      i = HASH_PASSED_LECTURES_THAT_WERE_LATERON_CHANGED_ALIAS_NAME[lva_id]
+    end
+    @find_this_lecture = i
+  end
+
+  # ========================================================================= #
+  # === find_this_lecture?
+  # ========================================================================= #
+  def find_this_lecture?
+    @find_this_lecture
+  end; alias input? find_this_lecture? # === input?
+
+  # ========================================================================= #
+  # === set_lva_number
+  # ========================================================================= #
+  def set_lva_number(i)
+    @lva_number = i.to_s.strip # Is always a String.
+  end
+
+  # ========================================================================= #
+  # === lva_number?
+  # ========================================================================= #
+  def lva_number?
+    @lva_number
+  end; alias lva_number lva_number? # === lva_number
+       alias id?        lva_number? # === id?
+
+  # ========================================================================= #
+  # === do_not_report_results
+  # ========================================================================= #
+  def do_not_report_results
+    @do_report_results = false
+  end; alias do_not_report_the_results do_not_report_results # === do_not_report_the_results
+
+  # ========================================================================= #
+  # === Studium::LvaNummer[]
+  # ========================================================================= #
+  def self.[](i)
+    new(i)
+  end
+
+  # ========================================================================= #
+  # === set_results
+  # ========================================================================= #
+  def set_results(i)
+    @results = i
+  end
+
+  # ========================================================================= #
+  # === try_to_modify_the_xorg_buffer
+  # ========================================================================= #
+  def try_to_modify_the_xorg_buffer(i)
+    if Object.const_defined? :XorgBuffer
+      XorgBuffer[i]
+    end
+  end
+
+  # ========================================================================= #
+  # === return_all_numbers_as_array
+  # ========================================================================= #
+  def return_all_numbers_as_array
+    @results.map {|entry|
+      entry.split('|').first.strip
+    }
+  end
+
+  # ========================================================================= #
+  # === get_rid_of_the_dataset
+  #
+  # Get rid of @dataset again.
+  # ========================================================================= #
+  def get_rid_of_the_dataset
+    remove_instance_variable(:@dataset)
+  end
+
+  # ========================================================================= #
+  # === try_to_find_matches
+  #
+  # This method will try to find any matches.
+  # ========================================================================= #
+  def try_to_find_matches
+    _ = @dataset #.join(N) # Need to re-add the "\n" here.
+    # ======================================================================= #
+    # Next, we need to use a proper regex to find the correct entry.
+    # This is a critical step - if our regex finds invalid input, we would
+    # propagate this faulty input, hence why the regex needs to be very
+    # accurate.
+    # ======================================================================= #
+    use_this_input = input?
+    if use_this_input
+      unless use_this_input.encoding.to_s.include? USE_THIS_ENCODING
+        use_this_input = ensure_main_encoding(use_this_input)
+      end
+    end
+    # ======================================================================= #
+    # For the following regex, see here:
+    #   http://rubular.com/r/2xNaE5FXPe
+    # use_this_regex = /#{Regexp.quote(use_this_input)}\s*$/
+    # ======================================================================= #
+    use_this_regex = /(\| #{Regexp.quote(use_this_input)}$)/
+    scanned = _.select {|line|
+      line =~ use_this_regex
+    }
+    # ======================================================================= #
+    # Note that the variable _ may look like this:
+    #   "20.09.2013 | 1.0 |  2.0 | 4 | UniWien |  B/M | VO |   300150   | 2013S | Chromosomenbiologie und Cytogenetik"
+    #   "25.11.1997|2.0|xxx|4|UniWien|D|VO|300053|1997W|Physik für Biologinnen und Biologen und LA-BU"
+    # ======================================================================= #
+    # ======================================================================= #
+    # We need to keep in mind that the lecture is not registered in the
+    # "already passed exams" part yet. In this case, the variable scanned
+    # will be empty, which is a case we will handle next.
+    # ======================================================================= #
+    if scanned.empty?
+      # ===================================================================== #
+      # Ok. How do we proceed from here? Well, we have a few options.
+      #
+      # A simple one is to make use of the file called 'lecture_information.yml'
+      #
+      # This should ideally have our lecture registered.
+      #
+      # In the event that it ahs not, we will try to obtain the information
+      # from a remote URL. For this we will use the project BeautifulUrl -
+      # but keep in mind that BeautifulUrl must have registered that page
+      # prior before it could be found.
+      #
+      # Also, keep in mind that we can not get rid of '(' and ')', because
+      # some lectures may mandate this as part of their name.
+      # ===================================================================== #
+      keys_only = YAML.load_file(FILE_LECTURE_INFORMATION).keys
+      hash = {}
+      keys_only.each {|line|
+        line = ensure_main_encoding(line)
+        index = line.index(' ')
+        key = line[0,index]
+        value = line[index+1 .. -1]
+        hash[key] = value
+      }
+      _ = input?.delete(' ') # .delete('()') # Easier to get the input without any ' ' in it and without ( or ) either.
+      url = Studium.sanitize_url(_) # So that we do not depend on Studium::Base.
+      if hash.has_value?(input?)
+        this_lva_number = hash.key(input?)
+        set_lva_number(this_lva_number)
+        if @do_report_results
+          e lva_number?
+          try_to_modify_the_xorg_buffer(lva_number?) if @do_modify_the_xorg_buffer
+        end
+      elsif url.is_a? Array
+        target_url = url.first
+        # =================================================================== #
+        # Assign a default lecture_id value next.
+        # =================================================================== #
+        lecture_id = '000000' # Use a default, just in case.
+        # =================================================================== #
+        # Intercept nil values first.
+        # =================================================================== #
+        if target_url.nil?
+          e 'Found a nil value for target_url, on '+sfancy(_)+'.'
+          e 'Please fix this issue.'
+        elsif target_url.include? 'ufind.'
+          use_this_regex = # See: http://rubular.com/r/LsdAmVnOT1
+            /ufind.univie.ac.at\/de\/course.html\?lv=(\d{4,6})&semester=20\d\d/
+          target_url =~ use_this_regex
+          lecture_id = $1.to_s.dup
+        else
+          # ================================================================= #
+          # Get the content of the remote page. we assume this to be a
+          # BOKU lecture if we enter here.
+          # ================================================================= #
+          # ================================================================= #
+          # We must handle possible errors, as the URL may be non-existent,
+          # for instance.
+          # ================================================================= #
+          begin
+            remote_page_content = open(target_url)
+            remote_page_content = remote_page_content.read.delete(N) # Easier to work without newlines.
+            # =============================================================== #
+            # Next, find the proper match via a regex. For BOKU lectures
+            # this is the "Nummer" entry.
+            # =============================================================== #
+            use_this_regex = # See: http://rubular.com/r/07S71aEYEt
+              /class="Mask ">Nummer<\/label><\/td><td colspan="0" class=" MaskRenderer top"><table class=" MaskSpacing"><tr><td class=" MaskRenderer"><span class="bold ">(\d{1,6})<\/span>/
+            # =============================================================== #
+            # We need to grab the lecture_id next.
+            # =============================================================== #
+            if remote_page_content.include? 'Nummer</label>'
+              remote_page_content =~ use_this_regex
+              lecture_id = $1.to_s.dup
+            end
+          rescue OpenURI::HTTPError => error
+            opnn; e 'An error happened which will be shown next ('+
+                     swarn('OpenURI::HTTPError')+')'
+            pp error
+            opnn; e 'This means that a remote website is probably unavailable. '\
+                    '(target_url was: '+simp(target_url)+')'
+            opnn; e 'If this is for a lecture at the BOKU, then this usually '
+            opnn; e 'means that some maintenance work is currently ongoing.'
+            opnn; e 'We will thus exit for now as we can not access '\
+                    'the remote information anyway.'
+            exit
+          rescue SocketError => error # This here requires: require 'socket'
+            opnn; e 'An error happened:'
+            pp error
+            lecture_id = '0'
+          rescue Errno::ENOENT
+            lecture_id = '0'
+          rescue Net::OpenTimeout
+            opnn; e 'A Net::OpenTimeout was encountered. Your internet '\
+                    'connection may not be working or the remote site '\
+                    'may have a problem.'
+            lecture_id = 'Net::OpenTimeout'
+          rescue Interrupt
+            opnn; e 'Exiting upon user request.'
+            exit
+          rescue Exception => error
+            opnn; e 'Another error for the URL '+sfancy(target_url)+': '
+            pp error
+          end
+        end
+        set_lva_number(lecture_id) # Also keep a reference to the LVA number at hand.
+        report_results([lecture_id+'|'+target_url]) if @do_report_results
+      end
+    else # else still register the LVA number.
+      if lva_number?.to_s.empty? or
+        (lva_number?.to_s == '0')
+        first = scanned.first
+        _ = first.split('|')[MAIN_POSITION_IN_THE_ARRAY] # Obtain the LVA number here, position 8.
+        set_lva_number(_)
+      end
+    end
+    set_results(scanned)
+  end
+
+  # ========================================================================= #
+  # === report_results
+  #
+  # The input to this method will have results IF we already passed that
+  # particular exam.
+  #
+  # IF we have not yet passed that exam, the input may look like this:
+  #
+  #   ["931103|https://online.boku.ac.at/BOKUonline/wbLv.wbShowLVDetail?pStpSpNr=277659"] 
+  #
+  # Unfortunately, some exams may have already been passed, but may now have
+  # another id, so ideally we also need a way to determine the LVA-ID number
+  # in these cases.
+  #
+  # An alternative is to register the passed exams in a file called
+  # lecture_information.yml.
+  # ========================================================================= #
+  def report_results(
+      use_these_results = @results
+    )
+    if use_these_results.empty?
+      # opnn; e 'This lecture ('+sfancy(input?.to_s)+') is not registered/known.'
+    else
+      use_these_results.each {|line| # <- Assume an Array here.
+        # =================================================================== #
+        # For now we will always assume that the dataset given to this
+        # method will contain a '|' token. Do not forget that.
+        # =================================================================== #
+        splitted = line.split('|').map(&:strip)
+        lva_number = splitted[MAIN_POSITION_IN_THE_ARRAY] # Is at position number 7.
+        e lva_number if @do_report_results # This line is the "reporting" part. :)
+        try_to_modify_the_xorg_buffer(lva_number) if @do_modify_the_xorg_buffer
+      }
+    end
+  end
+
+  # ========================================================================= #
+  # === sanitize_dataset
+  # ========================================================================= #
+  def sanitize_dataset
+    @dataset.reject! {|entry| entry.strip.empty? }
+    @dataset.reject! {|entry| entry.strip.start_with? '#'}
+    # ======================================================================= #
+    # Some exams, in particular at the University of Vienna, are equivalent
+    # to other exams. For example, "Physik für Biologinnen und Biologen
+    # und LA-BU" has been imputed for "B-BIO 4 Biologische Physik (BIO 3)".
+    # Or the lecture "300006 VO Allgemeine und Molekulare Genetik Teil II"
+    # which is equivalent to "300132 VO Allgemeine und Molekulare Genetik
+    # II".
+    # This explains why some entries ought to be "corrected".
+    # The code that follows will do this.
+    # ======================================================================= #
+    split_token_to_use = '|'
+    @dataset.map! {|line|
+      line.chomp!
+      splitted = line.split(split_token_to_use).map(&:strip)
+      name_of_the_lecture = splitted.last
+      id_of_the_lecture   = splitted[7]
+      # ===================================================================== #
+      # The following method is defined in:
+      #   studium/toplevel_methods/has_this_lecture_been_already_passed_but_the_id_was_changed_lateron.rb
+      # ===================================================================== #
+      if ::Studium.has_this_lecture_been_already_passed_but_the_id_was_changed_lateron?(
+          id_of_the_lecture, name_of_the_lecture
+        )
+        # =================================================================== #
+        # In this case, since the ID has already been changed,
+        # re-write the dataset.
+        # =================================================================== #
+        id_of_the_lecture   = HASH_PASSED_LECTURES_THAT_WERE_LATERON_CHANGED_LV_ID_ALIASES[id_of_the_lecture]
+        name_of_the_lecture = HASH_PASSED_LECTURES_THAT_WERE_LATERON_CHANGED_ALIAS_NAME[id_of_the_lecture]
+        splitted[-1] = name_of_the_lecture
+        splitted[7]  = id_of_the_lecture
+        line = splitted.join(split_token_to_use)
+      end
+      line
+    }
+  end
+
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run
+    try_to_find_matches
+    get_rid_of_the_dataset
+    report_results if @do_report_results
+  end
+
+end
+
+  # ========================================================================= #
+  # === Studium.return_lva_number_of_this_lecture
+  #
+  # Easier access-method to find out the LVA number of a given lecture.
+  #
+  # It is recommended to use this method rather than instantiate a new
+  # instance of class Studium::LvaNummer on your own.
+  #
+  # Usage example:
+  #   Studium.return_lva_number_of_this_lecture("Chromosomenbiologie und Cytogenetik") # => "300150"
+  # ========================================================================= #
+  def self.return_lva_number_of_this_lecture(
+      this_lecture
+    )
+    if this_lecture.is_a? Array
+      if this_lecture.first.count(N) > 3
+        this_lecture = this_lecture.first.split(N).flatten
+      end
+      result = this_lecture.map {|entry|
+        return_lva_number_of_this_lecture(entry)
+      }
+      if block_given? and
+         yield == :also_output_the_result_if_the_user_did_input_a_long_string
+        this_lecture.each {|lecture|
+          e return_lva_number_of_this_lecture(lecture).to_s+' '+
+             lecture
+        }
+        return
+      end 
+      return result
+    else
+      lva_nummer = ::Studium::LvaNummer.new(
+        this_lecture, :do_not_run_yet
+      ) { :do_not_modify_the_xorg_buffer }
+      lva_nummer.do_not_report_the_results
+      lva_nummer.run
+      return lva_nummer.lva_number?
+    end
+  end; self.instance_eval { alias return_lvid_from_this_lecture return_lva_number_of_this_lecture } # === Studium.return_lvid_from_this_lecture
+       self.instance_eval { alias return_id_of_this_lecture     return_lva_number_of_this_lecture } # === Studium.return_id_of_this_lecture
+       self.instance_eval { alias return_lv_id_number           return_lva_number_of_this_lecture } # === Studium.return_lv_id_number
+       self.instance_eval { alias return_id                     return_lva_number_of_this_lecture } # === Studium.return_id
+       self.instance_eval { alias return_lva_id_of_this_lecture return_lva_number_of_this_lecture } # === Studium.return_lva_id_of_this_lecture
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  require 'colours/e/autoinclude'
+  Studium.return_lva_number_of_this_lecture(ARGV) { :also_output_the_result_if_the_user_did_input_a_long_string }
+end # lvanum Umweltethik
+    # lvanum "Technologie tierischer Lebensmittel"
+    # lvanum "Allgemeine und Molekulare Mikrobiologie Teil I"
+    # lvanum "Chromosomenbiologie und Cytogenetik"
+    # lvanum "Biotechnologie 2"
+    # lvanum "Biologische Physik I"
+    # lvanum "Gemüse- und Zierpflanzenbau"
+    # lvanum "Biochemie"
+    # lvanum "Antibody Engineering (in Eng.)"
+    # lvanum "Grundlagen des Programmierens für MB, WIMB und VT"