studium 0.13.1

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, for a specific lecture.
+#
+# Another method exists, in the file called "ects_from_lectures.rb", but
+# that other file only obtains the amount of ECTS points from already
+# passed lectures. So the method here is more flexible, more recent 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'
+# =========================================================================== #
+module Studium
+
+  require 'studium/constants/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'
+
+  # ========================================================================= #
+  # === 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 instead,
+  # then any partial substring will be used. Thus, :partial allows
+  # for slightly more flexibility here.
+  # ========================================================================= #
+  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 ' '.
+      _ = Studium.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
+      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|
+          # The next step is probably not important anymore, so disabled it
+          # as of 17.10.2020.
+          # 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", '270009'
+    # 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,46 @@
+#!/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'
+# =========================================================================== #
+module Studium
+
+  require 'studium/toplevel_methods/main_dataset.rb'
+  require 'studium/toplevel_methods/return_sanitized_dataset_from_the_file_lecture_information.rb'
+
+  # ========================================================================= #
+  # === 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
+    # ======================================================================= #
+    # Next, select the lectures that were already solved.
+    # ======================================================================= #
+    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
+  alias e puts
+  hash = Studium.return_hash_of_already_solved_lectures
+  e '-'*80
+  pp hash
+  e '-'*80
+  pp hash.size # We just return the size here, as a test.  
+end # studiumreturnhashofalreadysolvedlectures

data/lib/studium/toplevel_methods/return_last_exam_question.rb

@@ -0,0 +1,34 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'studium/toplevel_methods/return_last_exam_question.rb'
+# =========================================================================== #
+module Studium
+
+  require 'studium/toplevel_methods/word_wrap.rb'
+  # ========================================================================= #
+  # === Studium.return_last_exam_question
+  # ========================================================================= #
+  def self.return_last_exam_question
+    _ = ENV['HOME'].to_s+'/Studium/last_question_asked.md'
+    if File.exist? _
+      dataset = File.readlines(_)
+      last_entry = dataset.last.to_s.strip
+      if last_entry.include? '|'
+        last_entry = last_entry.split('|').first.to_s.strip
+      end
+      last_entry = last_entry.
+                   gsub(/<one>/,'').gsub(/<\/one>/,'').
+                   gsub(/<two>/,'').gsub(/<\/two>/,'').
+                   gsub(/<three>/,'').gsub(/<\/three>/,'').
+                   gsub(/<four>/,'').gsub(/<\/four>/,'').
+                   gsub(/<five>/,'').gsub(/<\/five>/,'')
+      last_entry = Studium.word_wrap(last_entry, 40)
+      return last_entry
+    else
+      ''
+    end
+  end
+
+end

data/lib/studium/toplevel_methods/return_local_path_of_this_pwdstud.rb

@@ -0,0 +1,60 @@
+#!/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/requires/require_yaml.rb'
+  require 'studium/constants/constants.rb'
+  require 'studium/toplevel_methods/methods_related_to_files.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? _
+      dataset = YAML.load_file(_)
+      #key  = ensure_main_encoding("pwdstud#{i}")
+      path = dataset[i].sub(/^cd /,'').strip
+      path << '/' unless path.end_with? '/' # Require a trailing '/' character.
+      return path
+    end
+    nil
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  if ARGV.empty?
+    e Studium.return_local_path_of_this_pwdstud 1
+    e Studium.return_local_path_of_this_pwdstud 2
+    e Studium.return_local_path_of_this_pwdstud 3
+  else
+    e Studium.return_local_path_of_this_pwdstud(ARGV)  
+  end
+end # rb return_local_path_of_this_pwdstud.rb

data/lib/studium/toplevel_methods/return_lva_number_of_this_lecture.rb

@@ -0,0 +1,72 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'studium/toplevel_methods/return_lva_number_of_this_lecture.rb'
+# =========================================================================== #
+module Studium
+
+  require 'studium/constants/constants.rb'
+
+  # ========================================================================= #
+  # === 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 toplevel-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
+    )
+    require 'studium/utility_scripts/lva_nummer.rb'
+    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"

data/lib/studium/toplevel_methods/return_n_percent_solved_from_this_topic.rb

@@ -0,0 +1,90 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'studium/toplevel_methods/return_n_percent_solved_from_this_topic.rb'
+# Studium.n_percent_questions_answered_of_this_topic?
+# Studium.return_n_percent_solved_from_this_topic
+# =========================================================================== #
+module Studium
+
+module Exams # === Studium::Exams
+
+  require 'studium/toplevel_methods/find_exam_topic_and_exam_title.rb'
+  require 'studium/statistics/report_how_many_exam_questions_were_answered.rb'
+
+  # ========================================================================= #
+  # === Studium::Exams.return_n_percent_solved_from_this_topic
+  #
+  # This method will return a number, which denotes how much percent of
+  # that topic, already contains a proper answer.
+  #
+  # So for example, if this method returns 75, then this means that we
+  # have already solved 75% of that given topic at hand.
+  #
+  # The first (mandatory) argument to this method should be the topic
+  # you are looking for, such as 'amg1'.
+  #
+  # Obviously, if this topic does not exist, then the method here can
+  # not work properly.
+  #
+  # Usage examples:
+  #
+  #   Studium::Exams.return_n_percent_solved_from_this_topic('phys')
+  #   Studium::Exams.return_n_percent_solved_from_this_topic('amg1')
+  #
+  # ========================================================================= #
+  def self.return_n_percent_solved_from_this_topic(
+      this_topic
+    )
+    i = this_topic.to_s.dup
+    i.downcase!
+    i.delete!(' ') if i.include? ' '
+    i = ::Studium.find_corresponding_exam_topic(i)
+    percentage = 0 # Use a default value.
+    # ======================================================================= #
+    # Next, we have to tap into the Statistics class.
+    # ======================================================================= #
+    statistics = Studium::Statistics::ReportHowManyExamQuestionsWereAnswered.new { :be_quiet }.hash?
+    if i.respond_to?(:to_sym)
+      statistics = statistics[i.to_sym]
+      percentage = statistics[:percentage_of_questions_answered]
+    else
+      if i.is_a?(String) or i.is_a?(Symbol)
+        puts 'Possible problem, so debugging stuff.'
+        puts 'The variable this_topic was: '+this_topic.to_s
+        puts 'The modified variable is:    '+i.to_s
+      end
+    end
+    return percentage
+  end
+
+end
+
+# =========================================================================== #
+# === Studium.return_n_percent_solved_from_this_topic
+#
+# Usage examples:
+#
+#   Studium.return_n_percent_solved_from_this_topic('amg1') # => 66.0
+#   Studium.return_n_percent_solved_from_this_topic('aa')   # => 100.0
+#
+# =========================================================================== #
+def self.return_n_percent_solved_from_this_topic(
+    this_topic = 'amg'
+  )
+  ::Studium::Exams.return_n_percent_solved_from_this_topic(this_topic)
+end; self.instance_eval { alias n_percent_questions_answered_of_this_topic? return_n_percent_solved_from_this_topic } # === Studium.n_percent_questions_answered_of_this_topic?
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  if ARGV.empty?
+    p Studium.return_n_percent_solved_from_this_topic # Deaults to amg.
+  else
+    p Studium.return_n_percent_solved_from_this_topic(ARGV.first)
+  end
+end # npercentsolvedfromthistopic amg
+    # npercentsolvedfromthistopic bem1
+    # npercentsolvedfromthistopic bem2
+    # npercentsolvedfromthistopic aa

data/lib/studium/toplevel_methods/return_n_questions_were_answered_for_this_topic.rb

@@ -0,0 +1,60 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'studium/toplevel_methods/return_n_questions_were_answered_for_this_topic.rb'
+# Studium.return_n_questions_were_answered_for_this_topic
+# =========================================================================== #
+module Studium
+
+module Exams
+
+  require 'studium/toplevel_methods/report.rb'
+
+  # ========================================================================= #
+  # === Studium::Exams.return_n_questions_were_answered_for_this_topic
+  #
+  # This method will return a number, which indicates how many questions
+  # were already answered for a given topic at hand.
+  # ========================================================================= #
+  def self.return_n_questions_were_answered_for_this_topic(
+      this_topic
+    )
+    if this_topic.is_a? Array
+      this_topic = this_topic.first
+    end
+    n_answers = ::Studium::Exams.return_n_questions_in_this_topic(
+      this_topic, :also_return_n_answers
+    )
+    n_answers = n_answers.last # This will obtain the correct number.
+    return n_answers
+  end; self.instance_eval {
+    alias return_n_questions_answered_in_this_topic return_n_questions_were_answered_for_this_topic
+  } # === Studium::Exams.return_n_questions_answered_in_this_topic
+
+end
+
+# =========================================================================== #
+# === Studium.return_string_how_many_exam_questions_are_already_answered
+# =========================================================================== #
+def self.return_string_how_many_exam_questions_are_already_answered
+  ::Studium.return_n_questions_were_answered.to_s+
+  ' / '+
+  ::Studium.return_n_questions_exist.to_s+
+  +' exam-questions are already answered. ('+
+  ::Studium.n_percent_of_the_exam_questions_are_answered_already?.to_s+
+  '% solved)'
+end
+
+# =========================================================================== #
+# === Studium.return_n_questions_were_answered_for_this_topic
+# =========================================================================== #
+def self.return_n_questions_were_answered_for_this_topic(i)
+  ::Studium::Exams.return_n_questions_were_answered_for_this_topic(i)
+end; self.instance_eval { alias n_answers_available_in_this_topic return_n_questions_were_answered_for_this_topic } # === Studium.n_answers_available_in_this_topic
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  puts Studium::Exams.return_n_questions_were_answered_for_this_topic(ARGV)
+end # rb return_n_questions_were_answered*.rb organische_chemie_2

data/lib/studium/toplevel_methods/return_proper_university_image.rb

@@ -0,0 +1,86 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'studium/toplevel_methods/return_proper_university_image.rb'
+# Studium.return_image
+# =========================================================================== #
+module Studium
+
+  require 'studium/constants/image_constants.rb'
+  require 'studium/utility_scripts/show_lectures_on_the_commandline/html.rb'
+
+  # ========================================================================= #
+  # === Studium.return_proper_university_image                     (logo tag)
+  #
+  # Note that this method has an alias called Studium.return_image(). That
+  # alias may be simpler to use, but it can not be ensured that this alias
+  # will be retained as-is; it may change at a later point in the future,
+  # or it may not change. Either way, the longer method here is the more
+  # "stable" name - it will probably be kept for the remainder of this
+  # project's lifecycle.
+  # ========================================================================= #
+  def self.return_proper_university_image(i)
+    case i
+    # ======================================================================= #
+    # === completed
+    #
+    # This image denotes whether a lecture or a module has been completed.
+    # ======================================================================= #
+    when :completed
+      ::Studium::ShowLecturesOnTheCommandline::IMAGE_FOR_THE_COMPLETED_MODULE
+    # ======================================================================= #
+    # === Uni Wien
+    # ======================================================================= #
+    when 'Uni Wien',
+         :uniwien
+      UNIVERSITY_OF_VIENNA_LOGO_IMAGE
+    # ======================================================================= #
+    # === :step
+    # ======================================================================= #
+    when :step,
+         :steop_picture
+      STEOP_PICTURE
+    # ======================================================================= #
+    # === Meduni
+    # ======================================================================= #
+    when 'Meduni',
+         :meduni
+      MEDUNI_LOGO_IMAGE
+    # ======================================================================= #
+    # === Uni Graz
+    # ======================================================================= #
+    when 'Uni Graz',
+         :unigraz
+      UNIVERSITY_OF_GRAZ_LOGO_IMAGE
+    # ======================================================================= #
+    # === TU Vienna
+    # ======================================================================= #
+    when 'TU Vienna',
+         :tuvienna
+      TU_VIENNA_LOGO_IMAGE
+    # ======================================================================= #
+    # === BOKU
+    # ======================================================================= #
+    when 'BOKU',
+         :boku
+      BOKU_VIENNA_LOGO_IMAGE
+    # ======================================================================= #
+    # === Vetmed
+    # ======================================================================= #
+    when 'Vetmed',
+         :vetmed
+      VETMED_LOGO_IMAGE
+    else # else report that this university is not registered.
+      "| Unidentified university: #{i} ← please register it"
+    end
+  end; self.instance_eval { alias return_image return_proper_university_image } # === Studium.return_image
+       self.instance_eval { alias image        return_proper_university_image } # === Studium.image
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e Studium.return_proper_university_image(:uniwien)
+  e Studium.return_proper_university_image(:completed)  
+end