studium 0.10.1

data/lib/studium/exams/mandatory_continuous_assessment/mandatory_continuous_assessment.rb

@@ -0,0 +1,1115 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Studium::Exams::MandatoryContinuousAssessment
+#
+# This class allows us to determine how many exams that are "prüfungsimmanent"
+# were passed already. That word means "mandatory continuous assessment"
+# which usually means a seminar or a practical course that takes e. g.
+# 1-3 weeks of daily participation.
+#
+# Usage example:
+#
+#   Studium::Exams::MandatoryContinuousAssessment.new(ARGV)
+#
+# =========================================================================== #
+# require 'studium/exams/mandatory_continuous_assessment/mandatory_continuous_assessment.rb'
+# =========================================================================== #
+require 'studium/base/base.rb'
+# =========================================================================== #
+# Next, require the sub-project internal .rb files.
+# =========================================================================== #
+require 'studium/exams/mandatory_continuous_assessment/compare.rb'
+require 'studium/exams/mandatory_continuous_assessment/constants.rb'
+require 'studium/exams/mandatory_continuous_assessment/help.rb'
+require 'studium/exams/mandatory_continuous_assessment/initialize.rb'
+require 'studium/exams/mandatory_continuous_assessment/menu.rb'
+require 'studium/exams/mandatory_continuous_assessment/misc.rb'
+require 'studium/exams/mandatory_continuous_assessment/reset.rb'
+require 'studium/exams/mandatory_continuous_assessment/run.rb'
+require 'studium/exams/mandatory_continuous_assessment/set_title_of_the_curriculum.rb'
+require 'studium/exams/mandatory_continuous_assessment/show_and_report.rb'
+
+module Studium
+
+module Exams
+
+class MandatoryContinuousAssessment < Studium::Base # === Studium::Exams::MandatoryContinuousAssessment
+
+  require 'studium/toplevel_methods/sanitized_dataset_from_file_passed_exams_per_month.rb'
+
+  # ========================================================================= #
+  # === set_input
+  # ========================================================================= #
+  def set_input(
+      i = ''
+    )
+    if i.is_a? Array # Intercept Arrays here.
+      if i.empty?
+        i << '--all' # This is the default value since as of May 2017.
+      end
+    end
+    if i.is_a? Array
+      i = menu(i)
+      i = i.join(' ').strip
+    end
+    i = i.to_s.dup
+    @input = i
+  end
+
+  # ========================================================================= #
+  # === return_entries_that_are_of_mandatory_continuous_assessment_type
+  #
+  # The input to this method is assumed to come from a file, but you
+  # can also load up a String. In that case, we will split on newlines.
+  # ========================================================================= #
+  def return_entries_that_are_of_mandatory_continuous_assessment_type(i)
+    if i.is_a? String
+      i = i.split(N) # Split on newlines.
+    end
+    i.flatten! if i.is_a? Array
+    i.reject! {|line|
+      line.strip.start_with?('#') or
+      line.strip.empty?
+    }
+    i.map!(&:strip)
+    i.select! {|line|
+      line.strip!
+      # ===================================================================== #
+      # We need to be careful here, because the line may either end with e.
+      # g. "VO", or it may end with "VO, BOKU WIEN". The latter would then
+      # cause the follow-up code to fail, so we have to filter way such
+      # parts first.
+      # ===================================================================== #
+      if line.end_with? 'BOKU'
+        line.sub!(/BOKU$/,'')
+        line.strip!
+      end
+      if line.end_with?('WIEN') or line.end_with?('Wien')
+        # =================================================================== #
+        # First remove "WIEN" at the end of the line, then strip on the line.
+        # =================================================================== #
+        line.sub!(/WIEN$/,'')
+        line.sub!(/Wien$/,'') if line.end_with? 'Wien'
+        line.strip!
+        line.sub!(/Uni$/,'')   if line.end_with? 'Uni'
+        line.strip!
+        # =================================================================== #
+        # Still have TU, BOKU, VETMED and MEDUNI
+        # =================================================================== #
+        line.sub!(/BOKU$/,'')   if line.end_with? 'BOKU'
+        line.sub!(/TU$/,'')     if line.end_with? 'TU'
+        line.sub!(/VETMED$/,'') if line.end_with? 'VETMED'
+        line.sub!(/MEDUNI$/,'') if line.include?  'MEDUNI' # Must come before "UNI".
+        line.sub!(/UNI$/,'')    if line.end_with? 'UNI'
+        line.strip!
+      end
+      line.chop! if line.end_with? ','
+      last_two_characters = line[-2,2]
+      ARRAY_LECTURE_TYPES_THAT_ARE_MANDATORY_CONTINUOUS_ASSESSMENT.include? last_two_characters
+    }
+    return i
+  end
+
+  # ========================================================================= #
+  # === original_commandline?
+  # ========================================================================= #
+  def original_commandline?
+    @original_commandline
+  end; alias commandline?           original_commandline? # === commandline?
+       alias commandline_arguments? original_commandline? # === commandline_arguments?
+
+  # ========================================================================= #
+  # === total_amount_of_ects_points_in_the_curriculum
+  # ========================================================================= #
+  def total_amount_of_ects_points_in_the_curriculum?
+    @total_amount_of_ECTS_points_in_the_curriculum
+  end; alias n_total_ects_points total_amount_of_ects_points_in_the_curriculum? # === n_total_ects_points
+
+  # ========================================================================= #
+  # === input?
+  # ========================================================================= #
+  def input?
+    @input
+  end
+
+  # ========================================================================= #
+  # === set_percentage
+  # ========================================================================= #
+  def set_percentage(i)
+    @percentage = i.to_f
+  end
+
+  # ========================================================================= #
+  # === epowderblue
+  # ========================================================================= #
+  def epowderblue(i)
+    e powderblue(i) if @do_report_the_findings
+  end
+
+  # ========================================================================= #
+  # === obtain_default_dataset
+  #
+  # Simply assign the default dataset, from the file with the passed
+  # exams, to the instance variable @dataset.
+  # ========================================================================= #
+  def obtain_default_dataset
+    @dataset = ::Studium.sanitized_dataset_from_file_passed_exams_per_month
+  end
+
+  # ========================================================================= #
+  # === try_to_find_this_curriculum
+  #
+  # The second argument to this method will also show the curriculum
+  # number (and the name of the curriculum).
+  # ========================================================================= #
+  def try_to_find_this_curriculum(
+      i, optional_index = nil
+    )
+    if optional_index and @do_report_the_findings
+      # ===================================================================== #
+      # Report the curriculum number in this case.
+      # ===================================================================== #
+      e
+      e springgreen('Curriculum number: ')+
+        slateblue(optional_index.to_s)+
+        limegreen(" (#{name_of_the_curriculum?})")
+      e
+    end
+    be_verbose = be_verbose?
+    if block_given?
+      yielded = yield
+      case yielded
+      when :be_verbose
+        be_verbose = true
+      end
+    end
+    # ======================================================================= #
+    # In the following when-entries, it may be better to hardcode the
+    # path via a symbol such as :bachelor_mikrobiologie, since the
+    # given input may be so disparate.
+    # ======================================================================= #
+    case i.delete('-') # case tag
+    # ======================================================================= #
+    # === bachelor_biologische_informatik
+    # ======================================================================= #
+    when /^-?-?bachelor(-|_)?biologische(-|_)?informatik$/i,
+         /^-?-?indi3$/i
+      array = readlines(location_of(:bachelor_biologische_informatik)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === bachelor_bioinformatik_und_molekulare_biotechnologie
+    # ======================================================================= #
+    when /^-?-?bachelor(-|_)?bioinformatik(-|_)?und(-|_)?molekulare(-|_)?biotechnologie$/i
+      array = readlines(location_of(:bachelor_bioinformatik_und_molekulare_biotechnologie)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === bachelor_dummy_curriculum
+    # ======================================================================= #
+    when /^-?-?bachelor(-|_)?dummy(-|_)?curriculum$/i,
+         /^-?-?dummy$/i
+      array = readlines(location_of(:bachelor_dummy_curriculum)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === mandatory vector_bachelor
+    #
+    # Show only the 180.0 ECTS Bachelor of the vector-curriculum.
+    # ======================================================================= #
+    when '4',
+         /^vector_?bachelor/,
+         /bachelor_?vector/,
+         /^-?-?bachelor(-|_)?vectorx$/,
+         /^-?-?bachelor_?vektor$/i,
+         'bachelorvektorx',
+         /^-?-?bachelor$/i, # Default entry point.
+         'vectors',
+         'vectorx',
+         'vektorx',
+         'vektor',
+         /^-?-?bvektor$/i
+      array = readlines(location_of(:bachelor_vektoren)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === bachelor_informatik
+    # ======================================================================= #
+    when /^bachelor(_|-)?informatik$/i
+      do_assume_180_ects_points
+      array = readlines(location_of(:bachelor_informatik)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      set_title :bachelor_informatik
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === bachelor_technische_chemie
+    # ======================================================================= #
+    when /^bachelor(_|-)?technische(_|-)?chemie$/i
+      do_assume_180_ects_points
+      array = readlines(location_of(:bachelor_technische_chemie)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      set_title :bachelor_technische_chemie
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === mandatory master_vectorx
+    #
+    # This is for the master vector-curriculum, 120.0 ECTS.
+    # ======================================================================= #
+    when '1','vector','masterindividuell', # This is for 120.0 ECTS points.
+         'vectormaster','mastervector',
+         'mastervektorx','master',
+         /^master(_|-)?vectorx$/,
+         /^master(_|-)?vektor$/i,
+         /^master(_|-)vector$/,
+         /^mastervektoren$/
+      do_assume_120_ects_points
+      array = # readlines(location_of(:bachelor_vektoren))+
+              readlines(location_of(:master_vektoren)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === bachelor_molekularbiologie_curriculum
+    # ======================================================================= #
+    when /^bachelor(_|-)?molekularbiologie$/i,
+         /^bachelor(_|-)?molekularbiologie(_|-)?curriculum$/i,
+         /^bachelor(_|-)?molekularbiologie(_|-)?graz$/i
+      do_assume_180_ects_points
+      array = readlines(location_of(:bachelor_molekularbiologie_curriculum)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      set_title :bachelor_molekularbiologie_curriculum
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === bachelor_nutrition_science
+    # ======================================================================= #
+    when /^bachelor(_|-)?nutrition(_|-)?science$/i,
+         '5','ern','ernährungswissenschaften'
+      do_assume_180_ects_points
+      array = readlines(location_of(:bachelor_nutrition_science)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      set_title :bachelor_nutrition_science
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === bachelor_pharmazie
+    # ======================================================================= #
+    when /^bachelor(_|-)?pharmazie$/i
+      do_assume_180_ects_points
+      array = readlines(location_of(:bachelor_pharmazie)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      set_title :bachelor_pharmazie
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === mandatory master_biologische_chemie
+    # ======================================================================= #
+    when /^master(_|-)?pharmazie(_|-)?curriculum$/i,
+         /^master(_|-)?pharmazie$/i,
+         /^mpharmazie$/
+      do_assume_120_ects_points
+      array = readlines(location_of(:master_pharmazie)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      set_title :master_pharmazie
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === mandatory bachelor_chemie
+    # ======================================================================= #
+    when '7','chemie',
+         /^bachelor_?chemie/,
+         /^bachelor_?chemistry/
+      do_assume_180_ects_points
+      array = readlines(location_of(:bachelor_chemistry)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === mandatory master_biologische_chemie
+    # ======================================================================= #
+    when /^master(_|-)?biologische(_|-)?chemie$/i,
+         /^biologische(_|-)?chemie$/i
+      do_assume_120_ects_points
+      array = readlines(location_of(:master_biologische_chemie)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      set_title :master_biologische_chemie
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === master_genetik_und_entwicklungsbiologie
+    # ======================================================================= #
+    when /^master(-|_)?genetik(-|_)?und(-|_)?entwicklungsbiologie$/
+      do_assume_120_ects_points
+      array = readlines(location_of(:master_genetik_und_entwicklungsbiologie)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      set_title :master_genetik_und_entwicklungsbiologie
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === mandatory bachelor_mikrobiologie
+    # ======================================================================= #
+    when /^bachelor(_|-)?mikrobiologie$/i,
+         /^bachelor(_|-)?microbiology$/i
+      do_assume_180_ects_points
+      array = readlines(location_of(:bachelor_mikrobiologie)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === mandatory master_bioinformatik
+    # ======================================================================= #
+    when /^master(-|_)?bioinformatik$/,
+         /^master(-|_)?bioinformatics$/
+      do_assume_120_ects_points
+      array = readlines(location_of(:master_bioinformatik)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      set_title :master_bioinformatik
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === bachelor_medizinische_informatik
+    # ======================================================================= #
+    when /^-?-?bachelor(-|_)?medizinische(-|_)?informatik/
+      do_assume_180_ects_points
+      set_title :bachelor_medizinische_informatik
+      array = readlines(location_of(i)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === mandatory master_biotech
+    # ======================================================================= #
+    when /^master(-|_)?biotech$/,
+         /^master(-|_)?lmbt$/
+      do_assume_120_ects_points
+      array = readlines(location_of(:master_lmbt)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      set_title :master_biotech
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === bachelor_botanik
+    # ======================================================================= #
+    when /^bachelor(_|-)?botanik$/i
+      do_assume_180_ects_points
+      set_title :bachelor_botanik
+      array = readlines(location_of(i.to_sym)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === bachelor_molekulare_biologie
+    # ======================================================================= #
+    when /^bachelor(_|-)?molekulare(_|-)?biologie$/i,
+         /^bachelor(_|-)?molbio$/i
+      do_assume_180_ects_points
+      array = readlines(location_of(:bachelor_molbio)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === bachelor_agrarwissenschaften
+    # ======================================================================= #
+    when /^bachelor(_|-)?agrarwissenschaften$/i
+      do_assume_180_ects_points
+      array = readlines(location_of(i.to_sym)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === master_tu_vienna_biotechnology
+    # ======================================================================= #
+    when /^master(-|_)?tu(-|_)?vienna(-|_)?biotechnology$/
+      do_assume_120_ects_points
+      array = readlines(location_of(i.to_sym)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      set_title :master_tu_vienna_biotechnology
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === mandatory bachelor_lmbt
+    # ======================================================================= #
+    when '11',
+         /^bachelor(_|-)?lmbt/,
+         'lmbt',
+         'lbt'
+      do_assume_180_ects_points
+      array = readlines(location_of(:bachelor_lmbt)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === mandatory bachelor_genetics
+    # ======================================================================= #
+    when '6','genetics','genetik',/bachelor_?genetics?/,'genetic',
+         /^bachelor(-|_)?genetics$/,
+         /bachelor_?genetik/
+      array = readlines(
+        return_file_for_this_curriculum(
+          :bachelor_biologie_mikrobiologie_und_genetik
+        )
+      )+readlines(location_of(:bachelor_biologie_basisblock)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      set_title 'Bachelorcurriculum Genetik'
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === mandatory bachelor_master_vektoren
+    #
+    # This is only the full 300.0 ECTS curriculum.
+    # ======================================================================= #
+    when /bachelor_?master_?vektoren/i,
+         /bachelor_?master_?vectorx/i,
+         /bachelor_?master_?vector/i
+      do_assume_300_points
+      array = (readlines(location_of(:bachelor_vektoren)).flatten+
+               readlines(location_of(:master_vektoren)).flatten).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === mandatory master_molbio
+    #
+    # The molbio master at the university of vienna, for 120.0 ECTS points.
+    # ======================================================================= #
+    when '2',
+         /^-?-?master(_|-)?molbio/,
+         /^-?-?molbio(_|-)?master/,
+         'molbio' # mandatory --molbio_master
+      do_assume_120_ects_points
+      array = readlines(location_of(:master_molbio)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === mandatory bachelormasterimmuno
+    #
+    # This is the combination of the Biology basis building block, then
+    # the genetic building block, and then the master immuno.
+    # ======================================================================= #
+    when /bachelor_?master_?immuno/
+      do_assume_300_ects_points
+      array = readlines(location_of(:bachelor_biologie_basisblock))+
+              readlines(location_of(:bachelor_genetik))+
+              readlines(location_of(:master_immuno)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === mandatory master_immuno
+    # ======================================================================= #
+    when '3',
+         /-?-?master_?immuno/,
+         /-?-?immuno_?master/, # mandatory --immuno_master
+         'immuno'
+      do_assume_120_ects_points
+      array = readlines(location_of(:master_immuno)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    # ======================================================================= #
+    # === mandatory tuvienna_biotechmaster
+    # ======================================================================= #
+    when '10',/tu_?vienna_?biotech_?master/
+      do_assume_120_ects_points
+      array = readlines(location_of(:master_tuvienna_biotechnology)).flatten
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(array)
+      padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(array, be_verbose)
+    else
+      unless i.include? '--'
+        opnn; e 'Unregistered input in the file '\
+                'mandatory_continuous_assessment.rb: '+
+                sfancy(i)+' (class: '+i.class.to_s+')'
+      end
+    end
+  end
+
+  # ========================================================================= #
+  # === display_these_lectures_sorted_by_priority
+  #
+  # Do note that we will actually sort in two ways in this method:
+  #
+  #   - First, by priority, which can have values from 1 up to 5
+  #   - Second, by the amount of ECTS points. Lectures that have
+  #     more ECTS points will be displayed first.
+  #
+  # ========================================================================= #
+  def display_these_lectures_sorted_by_priority(
+      i, priority_to_use = [5,4,3,2,1]
+    )
+    if priority_to_use.is_a? Array
+      priority_to_use.each {|entry|
+        # =================================================================== #
+        # Call this method recursively.
+        # =================================================================== #
+        display_these_lectures_sorted_by_priority(i, entry)
+      }
+    else
+      if @do_report_the_findings
+        # =================================================================== #
+        # Show a little header, to notify the user which Priority-setting
+        # is currently shown.
+        # =================================================================== #
+        smiley_face = ''
+        if use_unicode_symbols? and Object.const_defined?(:Roebe)
+          smiley_face = lightseagreen(Roebe.smiley_face)
+        end
+        e sfancy("Priority #{priority_to_use.to_s}: #{smiley_face}")
+        e
+      end
+      matching_priority = i.select {|a, b| b[:priority] == priority_to_use }
+      counter = 0
+      sorted_by_n_ECTS_points_of_matching_priority = matching_priority.sort_by {|a, b|
+        b[:ects]
+      }.reverse
+      sorted_by_n_ECTS_points_of_matching_priority.each {|name, inner_hash| counter += 1
+        name = name.first if name.is_a? Array
+        n_ects_points     = inner_hash[:ects]
+        university        = inner_hash[:university]
+        lecture_type      = inner_hash[:type]
+        summer_or_winter  = inner_hash[:semester]
+        curricula_entries = obtain(:curricula_entries, inner_hash)
+        currently_participating_in_this_course = inner_hash[:currently_participating_in_this_course]
+        if currently_participating_in_this_course
+          # ================================================================= #
+          # Lectures that we are presently doing in the current semester
+          # will be shown in skyblue rather than slateblue.
+          # ================================================================= #
+          colourized_name_of_the_lecture = skyblue(name)
+        else
+          colourized_name_of_the_lecture = slateblue(name)
+        end
+        # =================================================================== #
+        # Colourize the ECTS points, in seagreen and lightseeagreen.
+        # Also show the lecture type and the university.
+        # =================================================================== #
+        colourized_n_ects_points = seagreen('(n ECTS: '+n_ects_points.to_s+', ')+
+                                   lightseagreen(lecture_type)+ # <- Display the lecture type here.
+                                   seagreen(', ')
+        unless summer_or_winter.nil?
+          colourized_summer_or_winter = mediumseagreen(summer_or_winter.to_s)
+          colourized_n_ects_points << colourized_summer_or_winter+
+                                      seagreen(', ')
+        end
+        colourized_n_ects_points << olivedrab(university)
+        colourized_n_ects_points << seagreen(', ')
+        colourized_n_ects_points << crimson(bachelor_or_master(curricula_entries))
+        # =================================================================== #
+        # Add the closing ')' next.
+        # =================================================================== #
+        colourized_n_ects_points << seagreen(')')
+        if @do_report_the_findings
+          e slategray(counter.to_s.rjust(2))+'  '+
+            colourized_name_of_the_lecture+' '+
+            colourized_n_ects_points
+        end
+      }
+      e if @do_report_the_findings
+    end
+  end
+
+  # ========================================================================= #
+  # === bachelor_or_master
+  #
+  # This method will return a String, either "Bachelor" or "Master" or
+  # "Bachelor/Master".
+  # ========================================================================= #
+  def bachelor_or_master(i)
+    result = ''.dup
+    if is_a_bachelor_lecture?(i)
+      result << 'Bachelor'
+    end
+    if is_a_master_lecture?(i)
+      unless result.empty?
+        result << '/'
+      end
+      result << 'Master'
+    end
+    return result
+  end
+
+  # ========================================================================= #
+  # === available_curricula?
+  # ========================================================================= #
+  def available_curricula?
+    ARRAY_REGISTERED_CURRICULA
+  end
+
+  # ========================================================================= #
+  # === display_this_array_including_only_mandatory_continuous_assessment_lectures
+  #
+  # The input to this method will be an Array of mandatory continuous
+  # assessment lectures.
+  # ========================================================================= #
+  def display_this_array_including_only_mandatory_continuous_assessment_lectures(
+      array, be_verbose = be_verbose?
+    )
+    case be_verbose
+    when nil
+      be_verbose = be_verbose?
+    when :be_verbose
+      be_verbose = true
+    end
+    consider_displaying_the_title_of_the_curriculum
+    # ======================================================================= #
+    # Sometimes the input may be a String. In this case, split it up.
+    # ======================================================================= #
+    if array.is_a? String
+      array = return_entries_that_are_of_mandatory_continuous_assessment_type(
+        array.split(N)
+      )
+    end
+    # ======================================================================= #
+    # Next we can display the result.
+    # ======================================================================= #
+    sorted_array = array.map {|line|
+      line.delete('"')
+    }.sort
+    sorted_array.each {|line|
+      # ===================================================================== #
+      # Up to 05.11.2019 this code used to read in the content of a file,
+      # but since that day we will instead obtain the information from
+      # the file called "lecture_information.yml" instead. A useful
+      # side-effect of this is that this approach should be faster than
+      # using regexes.
+      # ===================================================================== #
+      line.strip!
+      if line.include? '#'
+        line = line[0 .. (line.index('#')-1)]
+        line.strip!
+      end
+      line.squeeze!(' ')
+      if @dataset_from_the_file_lecture_information[line].nil?
+        e 'A nil-value was found, for line '+steelblue(line)+'.'
+        e 'Exiting now.'
+        exit
+      end
+      n_ects_points = @dataset_from_the_file_lecture_information[line][:ects]
+      type_of_the_lecture = @dataset_from_the_file_lecture_information[line][:type]
+      # ===================================================================== #
+      # Instantly ensure that we have a valid amount of ECTS points.
+      # ===================================================================== #
+      if n_ects_points == 0.0
+        opnn; e swarn('We encountered a problem, a 0.0 ECTS lecture, at: ')+
+                lightgreen(line)
+      end
+      # ===================================================================== #
+      # Left-pad the lecture ID.
+      # ===================================================================== #
+      if line.include? ' '
+        splitted = line.split(' ')
+        splitted[0] = splitted[0].ljust(7)
+        name = splitted.join(' ')
+      end
+      @total_amount_of_mandatory_continuous_assessment_ECTS_points_in_this_curriculum += n_ects_points
+      if be_verbose and @do_report_the_findings
+        e '  '+orange(
+            name.ljust(93)
+          )+' '+mediumpurple(
+            n_ects_points.to_s.rjust(4)
+          )+' ECTS points '+
+          seagreen(type_of_the_lecture.to_s.rjust(4)) # <- Last part is type of the lecture.
+      end
+    }
+    e if be_verbose and @do_report_the_findings
+    do_calculate_the_percentage
+    # ======================================================================= #
+    # Next, report the total amount of ECTS and some more information.
+    # ======================================================================= #
+    if be_verbose and @do_report_the_findings
+      e 'Total amount of ECTS points: '+
+         crimson(@total_amount_of_mandatory_continuous_assessment_ECTS_points_in_this_curriculum.to_s)+
+         lightblue(' (== ')+seagreen(n_percent?.round(2).to_s+'%')+
+         lightblue(' of '+@total_amount_of_ECTS_points_in_the_curriculum.to_s+
+         ' ECTS points in total)')
+    end
+  end
+
+  # ========================================================================= #
+  # === do_calculate_the_percentage
+  #
+  # This method will calculate the percentage of ects points in
+  # courses with mandatory-attendance. 
+  # ========================================================================= #
+  def do_calculate_the_percentage(
+      n_ects_in_mandatory_courses           = @total_amount_of_mandatory_continuous_assessment_ECTS_points_in_this_curriculum,
+      n_total_ects_points_in_the_curriculum = @total_amount_of_ECTS_points_in_the_curriculum
+    )
+    n_percent = (
+      n_ects_in_mandatory_courses.to_f * 100
+    ) / n_total_ects_points_in_the_curriculum
+    # ======================================================================= #
+    # Note that this method will also set the percentage.
+    # ======================================================================= #
+    set_percentage(n_percent) # Set the percentage here as well.
+  end
+
+  # ========================================================================= #
+  # === show_all_available_curricula
+  #
+  # This is a powerhorse method - it will simply show all curricula and
+  # the respective "prüfungsimmanente Lehrveranstaltungen" in these
+  # curricula.
+  #
+  # Invocation example:
+  #
+  #   mandatory --all_curricula
+  #
+  # ========================================================================= #
+  def show_all_available_curricula
+    do_not_be_verbose
+    _ = available_curricula?
+    _.each_with_index {|curriculum, index| index += 1
+      reset_this_instance
+      set_input(curriculum)
+      set_title(curriculum.to_sym)
+      try_to_find_this_curriculum(curriculum, index) { :be_verbose }
+    }
+  end
+
+  # ========================================================================= #
+  # === do_not_report_any_findings
+  # ========================================================================= #
+  def do_not_report_any_findings
+    @do_report_the_findings = false
+  end; alias do_not_report_anything do_not_report_any_findings # === do_not_report_anything
+
+  # ========================================================================= #
+  # === percentage?
+  # ========================================================================= #
+  def percentage?
+    @percentage
+  end; alias n_percent? percentage? # === n_percent?
+
+  # ========================================================================= #
+  # === consider_displaying_the_title_of_the_curriculum
+  # ========================================================================= #
+  def consider_displaying_the_title_of_the_curriculum
+    if @show_the_title_of_the_curriculum
+      if @do_report_the_findings
+        _ = title?
+        if _
+          e sfancy(_)
+          e
+        end if be_verbose?
+      end
+    end
+  end
+
+  # ========================================================================= #
+  # === do_assume_180_ects_points
+  # ========================================================================= #
+  def do_assume_180_ects_points
+    @total_amount_of_ECTS_points_in_the_curriculum = 180
+  end
+
+  # ========================================================================= #
+  # === do_assume_300_ects_points
+  # ========================================================================= #
+  def do_assume_300_ects_points
+    @total_amount_of_ECTS_points_in_the_curriculum = 300
+  end; alias do_assume_300_points do_assume_300_ects_points # === do_assume_300_points
+
+  # ========================================================================= #
+  # === do_assume_120_ects_points
+  # ========================================================================= #
+  def do_assume_120_ects_points
+    @total_amount_of_ECTS_points_in_the_curriculum = 120
+  end
+
+  # ========================================================================= #
+  # === n_ects_points
+  #
+  # This method can be used to directly set the amount of
+  # ECTS points in the given curriculum.
+  # ========================================================================= #
+  def n_ects_points(i = 120)
+    @total_amount_of_ECTS_points_in_the_curriculum = i.to_i
+  end
+
+  # ========================================================================= #
+  # === set_original_commandline
+  # ========================================================================= #
+  def set_original_commandline(i)
+    @original_commandline = [i].flatten.compact
+  end
+
+  # ========================================================================= #
+  # === do_show_all_passed_mandatory_continuous_assessments_from_this_year
+  #
+  # The input argument denotes the year. If the exam was passed in that
+  # year, then it will be shown.
+  #
+  # Invocation example:
+  #   mandatory --2017
+  # ========================================================================= #
+  def do_show_all_passed_mandatory_continuous_assessments_from_this_year(the_year)
+    obtain_default_dataset
+    @result = @dataset.select {|line|
+      splitted = line.split('|').map(&:strip)
+      year = splitted.first.strip.split('.').last
+      lecture_type = splitted[6] # <- This is the right entry.
+      ARRAY_LECTURE_TYPES_THAT_ARE_MANDATORY_CONTINUOUS_ASSESSMENT.include?(lecture_type) &&
+      (the_year == year) # Make the year-check here. 
+    }
+    report_result # Report it as we assigned the result above.
+  end
+
+  # ========================================================================= #
+  # === location_of                                         (location_of tag)
+  #
+  # Return the location of the curriculum locally, based on symbol
+  # "shortcuts" such as :bachelor_vektoren.
+  # ========================================================================= #
+  def location_of(
+      i                     = :bachelor_vektoren,
+      also_assign_new_title = true
+    )
+    case i # case tag
+    # ======================================================================= #
+    # The Bachelorcurriculum "Biologische Informatik"
+    # ======================================================================= #
+    when :bachelor_biologische_informatik,
+         :indi3
+      set_title(i) if also_assign_new_title
+      i = return_file_for_this_curriculum(i)
+    # ======================================================================= #
+    # The Bachelorcurriculum "Bachelorcurriculum (Bio)Informatik und
+    #                         molekulare Biotechnologie, unter
+    #                         Berücksichtigung medizinisch-immunologischer
+    #                         Aspekte"
+    # ======================================================================= #
+    when :bachelor_bioinformatik_und_molekulare_biotechnologie
+      set_title(i) if also_assign_new_title
+      i = return_file_for_this_curriculum(i)
+    # ======================================================================= #
+    # The Bachelorcurriculum "Ernährungswissenschaften" at the Uni-Vienna.
+    # ======================================================================= #
+    when :bachelor_nutrition_science
+      set_title(i) if also_assign_new_title
+      i = return_file_for_this_curriculum(i)
+    # ======================================================================= #
+    # This is the general dummy curriculum. It can be used to quickly
+    # test a new curriculum quickly.
+    # ======================================================================= #
+    when :bachelor_dummy_curriculum
+      set_title(i) if also_assign_new_title
+      i = return_file_for_this_curriculum(i)
+    # ======================================================================= #
+    # The Bachelorcurriculum "Molekularbiologie" at the Uni-Graz.
+    # ======================================================================= #
+    when :bachelor_molekularbiologie,
+         :bachelor_molekularbiologie_curriculum,
+         :bachelor_molekularbiologie_graz
+      set_title(i) if also_assign_new_title
+      i = return_file_for_this_curriculum(i)
+    # ======================================================================= #
+    # The Bachelorcurriculum "Pharmazie" at the University of Vienna.
+    # ======================================================================= #
+    when :bachelor_pharmazie
+      set_title(i) if also_assign_new_title
+      i = return_file_for_this_curriculum(i)
+    # ======================================================================= #
+    # The Mastercurriculum "Pharmazie" at the University of Vienna.
+    # ======================================================================= #
+    when :master_pharmazie
+      set_title(i) if also_assign_new_title
+      i = return_file_for_this_curriculum(i)
+    # ======================================================================= #
+    # The bachelor curriculum chemistry at the University of Vienna.
+    # ======================================================================= #
+    when :bachelor_chemistry, # mandatory --bachelor_chemistry
+         :bachelor_chemie
+      set_title(i) if also_assign_new_title
+      i = return_file_for_this_curriculum(i)
+    # ======================================================================= #
+    # The bachelor-curriculum Technische Chemie
+    # ======================================================================= #
+    when :bachelor_technische_chemie
+      set_title(i) if also_assign_new_title
+      i = return_file_for_this_curriculum(i)
+    # ======================================================================= #
+    # The individual bachelor mikrobiologie curriculum
+    # ======================================================================= #
+    when :bachelor_mikrobiologie
+      set_title(i) if also_assign_new_title
+      i = return_file_for_this_curriculum(i)
+    # ======================================================================= #
+    # The individual master vector curriculum at the University of Vienna.
+    # ======================================================================= #
+    when :master_vektoren
+      set_title(i) if also_assign_new_title
+      i = return_file_for_this_curriculum(i)
+    # ======================================================================= #
+    # The master genetik und entwicklungsbiologie.
+    # ======================================================================= #
+    when :master_genetik_und_entwicklungsbiologie
+      set_title(i) if also_assign_new_title
+      i = return_file_for_this_curriculum(i)
+    # ======================================================================= #
+    # The master biotechnology curriculum at the TU Vienna.
+    # ======================================================================= #
+    when :master_tuvienna_biotechnology,
+         :master_tu_vienna_biotechnology
+      set_title(i) if also_assign_new_title
+      i = return_file_for_this_curriculum(i)
+    # ======================================================================= #
+    # This is the bachelorcurriculum at the TU Vienna, Medizinische Informatik.
+    # ======================================================================= #
+    when :bachelor_medizinische_informatik
+      set_title(i) if also_assign_new_title
+      i = return_file_for_this_curriculum(i)
+    # ======================================================================= #
+    # This is the bachelor-curriculum molbio at the University of Vienna.
+    # ======================================================================= #
+    when :bachelor_molekulare_biologie,
+         :bachelor_molbio
+      set_title(i) if also_assign_new_title
+      i = return_file_for_this_curriculum(i)
+    # ======================================================================= #
+    # This is the BOKU Bachelor Agrarwissenschaften curriculum.
+    # ======================================================================= #
+    when :bachelor_agrarwissenschaften
+      set_title(i) if also_assign_new_title
+      i = return_file_for_this_curriculum(i)
+    # ======================================================================= #
+    # The individual bachelor vector curriculum at the University of Vienna.
+    # ======================================================================= #
+    when :bachelor_vektoren
+      set_title(i) if also_assign_new_title
+      i = return_file_for_this_curriculum(i)
+    # ======================================================================= #
+    # The bachelor LMBT curriculum at the BOKU Vienna.
+    # ======================================================================= #
+    when :bachelor_lmbt,
+         :lmbt
+      set_title(i) if also_assign_new_title
+      i = return_file_for_this_curriculum(i)
+    # ======================================================================= #
+    # === :master_lmbt
+    # ======================================================================= #
+    when :master_lmbt
+      set_title(i) if also_assign_new_title
+    # ======================================================================= #
+    # The master Immunbiology at the University of Vienna.
+    # ======================================================================= #
+    when :master_immuno
+      set_title(i) if also_assign_new_title
+      i = return_file_for_this_curriculum(i)
+    # ======================================================================= #
+    # :master_molbio
+    # ======================================================================= #
+    when :master_molbio
+      set_title(i) if also_assign_new_title
+      i = FILE_MASTER_MOLBIO
+    # ======================================================================= #
+    # :bachelor_biologie_basisblock
+    # ======================================================================= #
+    when :bachelor_biologie_basisblock
+      set_title(i) if also_assign_new_title
+      i = FILE_BACHELOR_BIOLOGIE_BASISBLOCK
+    # ======================================================================= #
+    # :bachelor_genetik
+    # ======================================================================= #
+    when :bachelor_genetik
+      set_title(i) if also_assign_new_title
+      i = FILE_BACHELOR_GENETIK
+    # ======================================================================= #
+    # :bachelor_ernährungswissenschaften
+    # ======================================================================= #
+    when :bachelor_ernährungswissenschaften
+      set_title(i) if also_assign_new_title
+      i = FILE_BACHELOR_ERNÄHRUNGSWISSENSCHAFTEN
+    end
+    return i
+  end
+
+  # ========================================================================= #
+  # === readlines
+  #
+  # Just a shorter method towards File.readlines().
+  # ========================================================================= #
+  def readlines(i)
+    result = []
+    if i.is_a? Symbol
+      i = return_file_for_this_curriculum(i)
+    end
+    unless i.is_a? Array
+      i = [i]
+    end
+    i.each {|entry|
+      if File.exist? entry.to_s
+        result << File.readlines(entry)
+      else
+        opnn; e 'No file exists at `'+
+                sfile(entry.to_s)+
+                '`. (in the method readlines())' # This line shall always be output.
+        exit
+      end
+    }
+    result.flatten!
+    return result
+  end
+
+  # ========================================================================= #
+  # === do_show_all_passed_mandatory_continuous_assessments
+  #
+  # This method will show all "prüfungsimmanente" Lehrveranstaltungen.
+  # ========================================================================= #
+  def do_show_all_passed_mandatory_continuous_assessments
+    obtain_default_dataset
+    # ======================================================================= #
+    # Next, grab all entries that are "prüfungsimmanent". These are those
+    # types that are part of the array-constant, so, UE, PS, SE, LU and
+    # so forth. These all have mandatory continuous assessment parts.
+    # ======================================================================= #
+    @result = @dataset.select {|line|
+      splitted = line.split('|').map(&:strip)
+      lecture_type = splitted[6] # <- This is the right entry.
+      is_included = ARRAY_LECTURE_TYPES_THAT_ARE_MANDATORY_CONTINUOUS_ASSESSMENT.include? lecture_type
+      is_included
+    }
+    report_result # Report it as we assigned the result above.
+  end
+
+  # ========================================================================= #
+  # === padded_display_this_array_including_only_mandatory_continuous_assessment_lectures
+  # ========================================================================= #
+  def padded_display_this_array_including_only_mandatory_continuous_assessment_lectures(
+      array, be_verbose_in_the_subsequent_method_call = nil
+    )
+    e if be_verbose? and @do_report_the_findings
+    display_this_array_including_only_mandatory_continuous_assessment_lectures(
+      array, be_verbose_in_the_subsequent_method_call
+    )
+    e if be_verbose? and @do_report_the_findings
+  end
+
+  # ========================================================================= #
+  # === total_amount_of_mandatory_continuous_assessment_ects_points_in_this_curriculum?
+  # ========================================================================= #
+  def total_amount_of_mandatory_continuous_assessment_ects_points_in_this_curriculum?
+    @total_amount_of_mandatory_continuous_assessment_ECTS_points_in_this_curriculum
+  end; alias n_mandatory_ects_points_in_this_curriculum? total_amount_of_mandatory_continuous_assessment_ects_points_in_this_curriculum? # === n_mandatory_ects_points_in_this_curriculum?
+       alias n_mandatory_ects_points_in_this_curriculum  total_amount_of_mandatory_continuous_assessment_ects_points_in_this_curriculum? # === n_mandatory_ects_points_in_this_curriculum?
+
+  # ========================================================================= #
+  # === title_of_the_curriculum?
+  # ========================================================================= #
+  def title_of_the_curriculum?
+    @title_of_the_curriculum
+  end; alias title?                  title_of_the_curriculum? # === title?
+       alias name_of_the_curriculum? title_of_the_curriculum? # === name_of_the_curriculum?
+
+  # ========================================================================= #
+  # === Studium::Exams::MandatoryContinuousAssessment[]
+  # ========================================================================= #
+  def self.[](i = '')
+    new(i)
+  end
+
+end; end
+
+# =========================================================================== #
+# === Studium.percentage_mandatory_continues_assessment
+#
+# This method will simply return the percentage of the mandatory,
+# continuous assessment practical courses, as a Float.
+#
+# In german: "Diese Methode gibt einem den prozentualen Anteil
+# an prüfungsimmanenten Lehrveranstaltungen aus."
+#
+# Invocation examples:
+#
+#   percentage = Studium.percentage_mandatory_continues_assessment('bachelor-genetic') # => 36.666666666666664
+#   percentage = Studium.percentage_mandatory_continues_assessment('bachelor-vektor')  # => 37.22222222222222
+#
+# =========================================================================== #
+def self.percentage_mandatory_continues_assessment(in_this_curriculum)
+  _ = Studium::Exams::MandatoryContinuousAssessment.new(in_this_curriculum, :do_not_run_yet)
+  _.be_quiet
+  _.run
+  _.percentage?
+end
+
+end