studium 0.16.9

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

@@ -0,0 +1,1359 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Studium::Exams::MandatoryContinuousAssessment
+#
+# This class allows the user to determine how many exams that are
+# "prüfungsimmanent" were passed already in a given curriculum. That
+# word "mandatory continuous assessment" specifically refers to courses
+# such as a seminar or a practical course that takes e. g. 1-3 weeks
+# of daily, continuous participation.
+#
+# Usage example:
+#
+#   Studium::Exams::MandatoryContinuousAssessment.new(ARGV)
+#
+# =========================================================================== #
+# require 'studium/exams/mandatory_continuous_assessment/mandatory_continuous_assessment.rb'
+# =========================================================================== #
+require 'studium/base/base.rb'
+
+module Studium
+
+module Exams
+
+class MandatoryContinuousAssessment < Studium::Base
+
+  require 'studium/toplevel_methods/sanitized_dataset_from_file_passed_exams_per_month.rb'
+  require 'studium/curricula/n_percent_solved_in_this_curriculum.rb'
+
+  # ========================================================================= #
+  # === N_TOKENS_FOR_THE_SPRINGREEN_SPACER
+  # ========================================================================= #
+  N_TOKENS_FOR_THE_SPRINGREEN_SPACER = 132
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      i           = ARGV,
+      run_already = true
+    )
+    reset
+    set_commandline_arguments(i)
+    case run_already
+    # ======================================================================= #
+    # === :do_not_run_yet
+    # ======================================================================= #
+    when :do_not_run_yet,
+         :dont_run_yet
+      run_already = false
+    end
+    # ======================================================================= #
+    # === Handle blocks given to this class
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      case yielded
+      # ===================================================================== #
+      # === :do_not_report_the_title
+      # ===================================================================== #
+      when :do_not_report_the_title
+        do_not_show_the_title_of_the_curriculum
+      # ===================================================================== #
+      # === :do_not_report_anything
+      # ===================================================================== #
+      when :do_not_report_anything
+        do_not_report_anything
+      end
+    end
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+    infer_the_namespace
+    reset_this_instance
+  end
+
+  # ========================================================================= #
+  # === reset_this_instance
+  # ========================================================================= #
+  def reset_this_instance
+    # ======================================================================= #
+    # === @internal_hash
+    # ======================================================================= #
+    reset_the_internal_hash
+    # ======================================================================= #
+    # === :total_amount_of_mandatory_continuous_assessment_ECTS_points_in_this_curriculum
+    #
+    # The following ivar keeps track of how many ECTS points
+    # are "prüfungsimmanent" in that curriculum.
+    # ======================================================================= #
+    @internal_hash[:total_amount_of_mandatory_continuous_assessment_ECTS_points_in_this_curriculum] = 0
+    # ======================================================================= #
+    # === :dataset
+    # ======================================================================= #
+    @internal_hash[:dataset] = dataset_from_file_lecture_information
+    # ======================================================================= #
+    # === :show_the_title_of_the_curriculum
+    # ======================================================================= #
+    @internal_hash[:show_the_title_of_the_curriculum] = true
+    # ======================================================================= #
+    # === :total_amount_of_ECTS_points_in_the_curriculum
+    # ======================================================================= #
+    @internal_hash[:total_amount_of_ECTS_points_in_the_curriculum] = 180
+    # ======================================================================= #
+    # === :percentage
+    #
+    # This variable stores how much percentage from the ECTS was passed.
+    # ======================================================================= #
+    @internal_hash[:percentage] = 0.0
+    # ======================================================================= #
+    # === :use_spacer_to_separate_a_new_year
+    # ======================================================================= #
+    @internal_hash[:use_spacer_to_separate_a_new_year] = false
+    # ======================================================================= #
+    # === :result
+    #
+    # Store the result of this class in this instance variable.
+    # ======================================================================= #
+    @internal_hash[:result] = nil
+    # ======================================================================= #
+    # === @display_split_line
+    #
+    # The next instance variable may display a colourized line, if set to
+    # true, which will make it easier to visually distinguish between
+    # Bachelor and Master-curricula. I like this so I have set it to
+    # true, but others may want to not use it, hence why I made it a flag.
+    # ======================================================================= #
+    @internal_hash[:display_split_line] = true
+  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
+    @internal_hash[:dataset] =
+      ::Studium.sanitized_dataset_from_file_passed_exams_per_month
+  end
+
+  # ========================================================================= #
+  # === display_split_line?
+  # ========================================================================= #
+  def display_split_line?
+    @internal_hash[:display_split_line]
+  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
+    # ======================================================================= #
+    # === nil
+    # ======================================================================= #
+    when nil
+      be_verbose = 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?[line].nil?
+        opnn; e 'A nil-value was found, for line '+steelblue(line)+'.'
+        opnn; e 'Continuing nonetheless.'
+        #exit
+      else
+        n_ects_points = dataset?[line][:ects]
+        type_of_the_lecture = dataset?[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
+        @internal_hash[:total_amount_of_mandatory_continuous_assessment_ECTS_points_in_this_curriculum] += n_ects_points
+        if be_verbose
+          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
+      end
+    }
+    e if be_verbose
+    do_calculate_the_percentage
+    # ======================================================================= #
+    # Next, report the total amount of ECTS and some more information.
+    # ======================================================================= #
+    if be_verbose
+      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
+
+  # ========================================================================= #
+  # === consider_displaying_the_title_of_the_curriculum
+  # ========================================================================= #
+  def consider_displaying_the_title_of_the_curriculum
+    if show_the_title_of_the_curriculum? and be_verbose?
+      _ = title?
+      if _
+        e sfancy(_)
+        e
+      end
+    end
+  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, the method 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
+
+  # ========================================================================= #
+  # === show_coloured_spacer
+  #
+  # This method will show a little coloured spacer. It can also display
+  # the number of ECTS for that particular curriculum.
+  # ========================================================================= #
+  def show_coloured_spacer(
+      n_times = 112,
+      &block
+    )
+    if be_verbose?
+      result = steelblue('-' * n_times)
+      if block_given?
+        yielded = yield
+        if yielded.is_a? Hash
+          if yielded.has_key? :n_ects
+            n_ects = yielded.delete(:n_ects)
+            result = result.dup if result.frozen?
+            result << slateblue(
+              ("#{n_ects} ECTS").rjust(12)
+            )
+          end
+        end
+      end
+      e result
+    end
+  end
+
+  # ========================================================================= #
+  # === do_not_report_any_findings
+  # ========================================================================= #
+  def do_not_report_any_findings
+    set_be_quiet
+  end; alias do_not_report_anything do_not_report_any_findings # === do_not_report_anything
+
+  # ========================================================================= #
+  # === use_spacer_to_separate_a_new_year?
+  # ========================================================================= #
+  def use_spacer_to_separate_a_new_year?
+    @internal_hash[:use_spacer_to_separate_a_new_year]
+  end
+
+  # ========================================================================= #
+  # === show_the_title_of_the_curriculum?
+  # ========================================================================= #
+  def show_the_title_of_the_curriculum?
+    @internal_hash[:show_the_title_of_the_curriculum]
+  end
+
+  # ========================================================================= #
+  # === do_show_the_title_of_the_curriculum
+  # ========================================================================= #
+  def do_show_the_title_of_the_curriculum
+    @internal_hash[:show_the_title_of_the_curriculum] = true
+  end
+
+  # ========================================================================= #
+  # === do_not_show_the_title_of_the_curriculum
+  # ========================================================================= #
+  def do_not_show_the_title_of_the_curriculum
+    @internal_hash[:show_the_title_of_the_curriculum] = false
+  end
+
+  # ========================================================================= #
+  # === available_curricula?
+  # ========================================================================= #
+  def available_curricula?
+    ARRAY_REGISTERED_CURRICULA
+  end
+
+  # ========================================================================= #
+  # === dataset
+  # ========================================================================= #
+  def dataset?
+    @internal_hash[:dataset]
+  end
+
+  # ========================================================================= #
+  # === title?
+  # ========================================================================= #
+  def title?(i = nil)
+    i = map_input_to_this_curriculum_filename(i)
+    return_title_from_this_curriculum_file(i)+'  '
+  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?
+    display_this_array_including_only_mandatory_continuous_assessment_lectures(
+      array, be_verbose_in_the_subsequent_method_call
+    )
+    e if be_verbose?
+  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 be_verbose?
+        # =================================================================== #
+        # 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]
+        outdated_lecture  = inner_hash[:outdated_lecture]
+        next if outdated_lecture == true
+        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 be_verbose?
+          e slategray(counter.to_s.rjust(2))+'  '+
+            colourized_name_of_the_lecture+' '+
+            colourized_n_ects_points
+        end
+      }
+      e if be_verbose?
+    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 has_a_master_curriculum?(i) # is_a_master_lecture?(i) # ← Changed this in January 2023.
+      unless result.empty?
+        result << '/'
+      end
+      result << 'Master'
+    end
+    return result
+  end
+
+  # ========================================================================= #
+  # === total_amount_of_mandatory_continuous_assessment_ECTS_points_in_this_curriculum?
+  # ========================================================================= #
+  def total_amount_of_mandatory_continuous_assessment_ECTS_points_in_this_curriculum?
+    @internal_hash[:total_amount_of_mandatory_continuous_assessment_ECTS_points_in_this_curriculum]
+  end; alias n_prüfungsimmanente_ECTS?                   total_amount_of_mandatory_continuous_assessment_ECTS_points_in_this_curriculum? # === n_prüfungsimmanente_ECTS?
+       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?
+
+  # ========================================================================= #
+  # === total_amount_of_ects_points_in_the_curriculum
+  # ========================================================================= #
+  def total_amount_of_ects_points_in_the_curriculum?
+    @internal_hash[: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
+       alias total_amount_of_ECTS_points_in_the_curriculum? total_amount_of_ects_points_in_the_curriculum? # === total_amount_of_ECTS_points_in_the_curriculum?
+
+  # ========================================================================= #
+  # === do_assume_180_ects_points
+  # ========================================================================= #
+  def do_assume_180_ects_points
+    @internal_hash[:total_amount_of_ECTS_points_in_the_curriculum] = 180
+  end
+
+  # ========================================================================= #
+  # === do_compare_the_registered_curricula_quickly
+  # ========================================================================= #
+  def do_compare_the_registered_curricula_quickly(
+      i = :show_more_details_but_without_the_title
+    )
+    cliner { :mediumaquamarine }
+    Studium.return_registered_standalone_curricula.each {|this_curriculum|
+      do_determine_the_prüfungsimmanente_ECTS_of_this_curriculum(this_curriculum)
+    }
+    cliner { :mediumaquamarine }
+  end
+
+  # ========================================================================= #
+  # === do_compare_the_registered_curricula
+  #
+  # This method can be used to compare different curricula for their
+  # mandatory ECTS points, in a batch-processive manner.
+  #
+  # To invoke this method from the commandline, do:
+  #
+  #   mandatory --compare
+  #
+  # ========================================================================= #
+  def do_compare_the_registered_curricula(
+      show_details = false
+    )
+    do_not_report_any_findings
+    # ======================================================================= #
+    # Do not use the combined bachelor-master vector curriculum though.
+    # The following method-call ensures that.
+    # ======================================================================= #
+    report_these_curricula = ::Studium.return_registered_standalone_curricula
+    report_these_curricula << :indi1
+    report_these_curricula << :indi2
+    report_these_curricula << :indi3
+    report_these_curricula << :indi4
+    e
+    e "#{rev}  Comparing the number of ECTS points assigned to "\
+      "mandatory-presence"
+    e '  courses in different curricula:'
+    e
+    # ======================================================================= #
+    # Iterate over these curricula next:
+    # ======================================================================= #
+    report_these_curricula.each_with_index {|this_curriculum, index| index += 1
+      # ===================================================================== #
+      # We will next delegate towards class MandatoryContinuousAssessment,
+      # which will tell us how many ECTS points are mandatory.
+      #
+      #   bl MandatoryContinuousAssessment
+      #
+      # ===================================================================== #
+      _ = Studium::Exams::MandatoryContinuousAssessment.new(this_curriculum) { :do_not_report_anything }
+      n_ects_points_that_are_mandatory = _.n_mandatory_ects_points_in_this_curriculum?.to_s.rjust(5)
+      n_ects_points_in_total_in_this_curriculum = _.n_total_ects_points
+      title_of_the_curriculum = _.title?(this_curriculum)
+      if title_of_the_curriculum.nil?
+        # =================================================================== #
+        # Report missing title next:
+        # =================================================================== #
+        e "This curriculum (#{sfancy(this_curriculum)}) has no title."
+        e 'This is currently not allowed. Please correct this error in that .yml file.'
+        exit
+      end
+      if title_of_the_curriculum and title_of_the_curriculum.is_a?(String)
+        title_of_the_curriculum = title_of_the_curriculum.dup if title_of_the_curriculum.frozen?
+        title_of_the_curriculum.strip!
+      end
+      # ===================================================================== #
+      # If the title of the curriculum is too long, chop it down.
+      # ===================================================================== #
+      threshold_value = 55
+      title_of_the_curriculum = ''.dup if title_of_the_curriculum.nil?
+      if title_of_the_curriculum.size > threshold_value
+        title_of_the_curriculum = "#{title_of_the_curriculum[0 .. threshold_value]} [...]"
+      end
+      if title_of_the_curriculum.include? 'Master'
+        if display_split_line?
+          # ================================================================= #
+          # Display a horizontal-line next, coloured in springgreen, as
+          # visual separator:
+          # ================================================================= #
+          e springgreen(
+              '  '+('-' * N_TOKENS_FOR_THE_SPRINGREEN_SPACER)
+            )
+          @internal_hash[:display_split_line] = false # We already displayed it once.
+        end
+      end
+      padded_index = " (#{index}".rjust(4)+') '
+      colourized_and_padded_index = mediumpurple(padded_index)
+      formatted_percentage_value  = _.percentage?.round(2).to_s.ljust(5,'0')
+      # ===================================================================== #
+      # Pad the title of the curriculum a little next:
+      # ===================================================================== #
+      padded_title_of_the_curriculum = title_of_the_curriculum.ljust(threshold_value+7)
+      n_percent_solved = Studium.n_percent_solved_in_this_curriculum(this_curriculum)
+      # ===================================================================== #
+      # We will display the two major individual curricula, about "Vektorsysteme",
+      # in a slightly brighter colour:
+      # ===================================================================== #
+      if padded_title_of_the_curriculum.include? 'Vektor'
+        colourized_and_padded_title_of_the_curriculum = mediumturquoise(padded_title_of_the_curriculum)
+      else
+        colourized_and_padded_title_of_the_curriculum = sfancy(padded_title_of_the_curriculum)
+      end
+      # ===================================================================== #
+      # First comes the index, then the title of the curriculum at hand.
+      # The index is presently colourized in 'mediumpurple'.
+      # ===================================================================== #
+      e colourized_and_padded_index+ # <- First show the colourized and padded index.
+        colourized_and_padded_title_of_the_curriculum+
+        powderblue(n_ects_points_that_are_mandatory)+' ECTS in '+
+        seagreen('mandatory-courses')+' (total ECTS: '+
+        powderblue(n_ects_points_in_total_in_this_curriculum.to_s)+
+        ', '+slateblue(formatted_percentage_value+'%')+' share'+
+        ', '+seagreen(n_percent_solved.round(1).to_s.rjust(4)+'%')+' solved'+
+        ')'
+      # ===================================================================== #
+      # Enter this clause if the user wants to show some more details.
+      # ===================================================================== #
+      case show_details
+      # ===================================================================== #
+      # === :show_more_details_but_without_the_title
+      #
+      # This variant will show more details, that is, every course will be 
+      # shown on a new line each.
+      # ===================================================================== #
+      when :show_more_details_but_without_the_title
+        Studium::Exams::MandatoryContinuousAssessment.new(this_curriculum) { :do_not_report_the_title } 
+      # ===================================================================== #
+      # === :show_details
+      # ===================================================================== #
+      when :show_details,
+           :show_more_details
+        Studium::Exams::MandatoryContinuousAssessment.new(this_curriculum)
+      end 
+    }; e
+  end
+
+  # ========================================================================= #
+  # === do_assume_300_ects_points
+  # ========================================================================= #
+  def do_assume_300_ects_points
+    @internal_hash[: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
+    @internal_hash[:total_amount_of_ECTS_points_in_the_curriculum] = 120
+  end
+
+  # ========================================================================= #
+  # === show_help                                                  (help tag)
+  #
+  # Display the following help-instructions like so from the commandline:
+  #
+  #   mandatory --help
+  #
+  # ========================================================================= #
+  def show_help
+    e
+    e "These options are available for "\
+      "#{orange('class Studium::Exams::MandatoryContinuousAssessment')}:"
+    e
+    eparse '  --all       # show all mandatory continuous assessment '\
+           'lectures that were already completed successfully'
+    eparse '  --available # show the available curricula for '\
+           'use with this class'
+    e
+    e "The other way to use this class is to pass in the "\
+      "#{powderblue('name of a specific curriculum')}."
+    e
+    e 'The class will then figure out how much, in percent and '\
+      'amount of ECTS numbers,'
+    e 'that particular curriculum will have "prüfungsimmanente '\
+      'Lehrveranstaltungen".'
+    e
+    e 'Usage examples:'
+    e
+    e lightseagreen('  mandatory vectorx')+'             '\
+      '# vectorx ist Bachelor und Master kombiniert.'
+    e "#{lightseagreen('  mandatory master-vectorx')}      "\
+      "# Only show the master-lectures here"
+    e lightseagreen('  mandatory --bachelor-genetics')+' '\
+      '# the genetics curriculum at '\
+      'the university of vienna'
+    e
+    e 'To show all curricula, do:'
+    e
+    epowderblue('  --all_curricula')
+    e
+    e 'To show passed exams per (specific) year, do:'
+    e
+    epowderblue('  --2017')
+    epowderblue('  --2016')
+    e
+    e 'To show which mandatory lectures may be upcoming, you '\
+      'can use any of the following:'
+    e
+    e '  mandatory --upcoming'
+    e '  mandatory --todo'
+    e '  mandatory --next'
+    e
+    e 'These will be sorted based on priority; higher priority '\
+      'comes first'
+    e
+    e 'If you want to compare all registered (thus, available) '\
+      'curricula, then use the following command:'
+    e
+    epowderblue('  mandatory --compare')
+    e
+    e 'And if you want more details:'
+    e
+    epowderblue('  mandatory --compare-detail')
+    e
+    e 'To only show master-lectures, try:'
+    e
+    epowderblue('  mandatory --only-master')
+    e
+    e 'If you only want lectures in the winter-semester, use this:'
+    e
+    epowderblue('  mandatory --wintersemester')
+    e
+    e 'To select only courses for summer or winter term, use either of the following:'
+    e
+    epowderblue('  mandatory --summer')
+    epowderblue('  mandatory --winter')
+    e
+  end
+
+  # ========================================================================= #
+  # === filter_for_lectures_at_the_BOKU
+  # ========================================================================= #
+  def filter_for_lectures_at_the_BOKU
+    dataset?.select! {|name_of_the_lecture, hash_inner_dataset|
+      hash_inner_dataset[:university] == 'BOKU'
+    }
+  end
+
+  # ========================================================================= #
+  # === filter_for_lectures_at_the_TU_Vienna
+  # ========================================================================= #
+  def filter_for_lectures_at_the_TU_Vienna
+    dataset?.select! {|name_of_the_lecture, hash_inner_dataset|
+      hash_inner_dataset[:university] == 'TU Vienna'
+    }
+  end
+
+  # ========================================================================= #
+  # === set_result
+  # ========================================================================= #
+  def set_result(i)
+    @internal_hash[:result] = i
+  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
+    set_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
+
+  # ========================================================================= #
+  # === 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)
+    @internal_hash[:total_amount_of_ECTS_points_in_the_curriculum] = i.to_i
+  end
+
+  # ========================================================================= #
+  # === menu                                                       (menu tag)
+  # ========================================================================= #
+  def menu(
+      i = commandline_arguments?
+    )
+    if i.is_a? Array
+      i.each {|entry| menu(entry) }
+    else
+      case i # (case tag)
+      # ===================================================================== #
+      # === mandatory --summer
+      # ===================================================================== #
+      when /^-?-?s(u|o)?mmer$/i
+        filter_for_lectures_during_the_summer
+      # ===================================================================== #
+      # === mandatory --winter
+      # ===================================================================== #
+      when /^-?-?winter$/i
+        filter_for_lectures_during_the_winter
+      # ===================================================================== #
+      # === mandatory --do-compare-the-registered-curricula-quickly
+      #
+      # This entry point was added in December 2022.
+      # ===================================================================== #
+      when /^-?-?do(-|_)?compare(-|_)?the(-|_)?registered(-|_)?curricula(-|_)?quickly$/i
+        do_compare_the_registered_curricula_quickly
+        exit
+      # ===================================================================== #
+      # === mandatory --upcoming
+      # ===================================================================== #  
+      when /^-?-?upcoming$/i,
+           /^-?-?todo$/i,
+           /^-?-?next$/i,
+           /^-?-?show(-|_)?all$/i
+        show_upcoming_mandatory_continuous_assessments { commandline_arguments? }
+        exit
+      # ===================================================================== #
+      # === mandatory --compare
+      # ===================================================================== #
+      when /^-?-?compare$/i
+        do_compare_the_registered_curricula
+        exit
+      # ===================================================================== #
+      # === mandatory --show-all-passed-mandatory-continuous-assessments
+      # ===================================================================== #
+      when /^-?-?show(-|_)?all(-|_)?passed(-|_)?mandatory(-|_)?continuous(-|_)?assessments$/i,
+           /^-?-?all$/i
+        do_show_all_passed_mandatory_continuous_assessments
+      # ===================================================================== #
+      # === mandatory --boku --summer
+      # ===================================================================== #
+      when /^-?-?BOKU$/i
+        filter_for_lectures_at_the_BOKU
+      # ===================================================================== #
+      # === mandatory --tuwien --summer
+      # ===================================================================== #
+      when /^-?-?tuwien$/i,
+           /^-?-?tuvienna$/i
+        filter_for_lectures_at_the_TU_Vienna
+      # ===================================================================== #
+      # === mandatory_assessment --all
+      #
+      # Show all the mandatory continuous assessment lectures that were
+      # passed so far.
+      # ===================================================================== #
+      when /-?-?all$/i,
+           /-?-?everything$/i,
+           /-?-?default$/i
+        @internal_hash[:use_spacer_to_separate_a_new_year] = true
+        :show_all_passed_mandatory_continuous_assessments
+      # ===================================================================== #
+      # === mandatory --only-wintersemester
+      # ===================================================================== #
+      when /^-?-?only(-|_)?wintersemester$/i,
+           /^-?-?wintersemester$/i
+        dataset?.select! {|a,b|
+          semester = obtain(:semester, b, :be_quiet)
+          semester == 'winter'
+        }
+        show_upcoming_mandatory_continuous_assessments(
+          dataset?
+        )
+      # ===================================================================== #
+      # === mandatory_assessment --all_curricula
+      #
+      # Show all the different curricula - at the least those that were
+      # registered in the main Array.
+      # ===================================================================== #
+      when /-?-?all(_|-)?curricula$/i
+        show_all_available_curricula
+      # ===================================================================== #
+      # === mandatory_assignment --2018
+      # ===================================================================== #
+      when /^-?-?(\d{4})$/
+        the_year = $1.to_s.dup
+        do_show_all_passed_mandatory_continuous_assessments_from_this_year(the_year)
+        exit
+      # ===================================================================== #
+      # === mandatory_assessment --available
+      # ===================================================================== #
+      when /-?-?available/
+        e; available_curricula?.each {|entry| e "  - #{sfancy(entry)}" }; e
+      # ===================================================================== #
+      # === mandatory_assessment --help
+      # ===================================================================== #
+      when /help/
+        show_help
+        exit
+      # ===================================================================== #
+      # === mandatory --compare-details
+      #
+      # This variant is different to --compare in that we will get a good
+      # overview of the individual lectures as well.
+      # ===================================================================== #
+      when /^-?-?compare(-|_)?details?$/i,
+           /^-?-?compare(-|_)?stats$/i,
+           /^-?-?details$/i
+        do_compare_the_registered_curricula(
+          :show_more_details_but_without_the_title
+        )
+        exit
+      end
+    end
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    _ = first_argument?
+    menu
+    if _.is_a?(String) and _.include?('# ') # Assume that the user passed in a String with all the lectures here.
+      e if be_verbose?
+      display_this_array_including_only_mandatory_continuous_assessment_lectures(_)
+      e if be_verbose?
+    else
+      # =================================================================== #
+      # Else we will try to find that particular curriculum at hand.
+      # =================================================================== #
+      do_determine_the_prüfungsimmanente_ECTS_of_this_curriculum(_)
+    end
+  end
+
+  # ========================================================================= #
+  # === epowderblue
+  # ========================================================================= #
+  def epowderblue(i)
+    e powderblue(i) if be_verbose?
+  end
+
+  # ========================================================================= #
+  # === set_percentage
+  # ========================================================================= #
+  def set_percentage(i)
+    @internal_hash[:percentage] = i.to_f
+  end
+
+  # ========================================================================= #
+  # === percentage?
+  # ========================================================================= #
+  def percentage?
+    @internal_hash[:percentage]
+  end; alias n_percent? percentage? # === n_percent?
+
+  # ========================================================================= #
+  # === 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.
+    # ======================================================================= #
+    set_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
+
+  # ========================================================================= #
+  # === 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
+      try_to_find_this_curriculum(curriculum, index) { :be_verbose }
+    }
+  end
+
+  # ========================================================================= #
+  # === report_result
+  #
+  # Note that by default, this works on the variable @result. So if you
+  # modify that variable, you are already half-way done. Otherwise, if
+  # you need another dataset, you can pass in another dataset as an
+  # argument to this method.
+  # ========================================================================= #
+  def report_result(
+      _ = result?
+    )
+    if be_verbose?
+      if _
+        total_ects = 0
+        n_ects_in_this_year = 0
+        last_year = Time.now.year
+        e; _.each_with_index {|line, index|
+          # =================================================================== #
+          # A line may look like this:
+          #   21.04.2015 | 2.0 | 2.0 | 1 | UniWien | B | UE | 300632 | 2016S | Übungen zu Grundlagen in der Bioinformatik\n
+          # =================================================================== #
+          index               += 1
+          splitted             = line.split('|').map(&:strip)
+          name                 = splitted.last # The name of the lecture.
+          exam_date            = splitted.first
+          the_year             = exam_date.split('.').last.to_i
+          lecture_type         = splitted[6]
+          n_ects               = splitted[2].to_f # Amount of ECTS points.
+          n_ects_in_this_year += n_ects
+          total_ects          += n_ects
+          padded_name          = name.ljust(90)
+          if @internal_hash[:use_spacer_to_separate_a_new_year] and
+            !(the_year == last_year)
+            # =============================================================== #
+            # Show a little coloured spacer next:
+            # =============================================================== #
+            show_coloured_spacer {{ n_ects: n_ects_in_this_year }}
+            n_ects_in_this_year = 0 # And reset it again.
+            last_year = the_year
+          end
+          # ================================================================= #
+          # Report our findings finally. This begins with a leading
+          # index in orange colour.
+          # ================================================================= #
+          e orange((index.to_s+')').rjust(4))+' '+
+            padded_name+
+            turquoise(' ('+exam_date.to_s+')')+' '+
+            crimson(lecture_type.center(5))+' '+
+            royalblue(n_ects.to_s.rjust(4)+' ECTS')
+        }; e
+        e "In total we completed #{violet(total_ects.to_s)} ECTS "\
+          "points in #{orange(_.size.to_s)} different courses."
+        e
+      end
+    end
+  end; alias report report_result # === report
+
+  # ========================================================================= #
+  # === show_upcoming_mandatory_continuous_assessments
+  #
+  # This method will show upcoming courses that have a mandatory 
+  # assessment/attendance component ("prüfungsimmanente Lehrveranstaltungen").
+  #
+  # To invoke this method from the commandline, do:
+  #
+  #   mandatory --upcoming
+  #
+  # ========================================================================= #
+  def show_upcoming_mandatory_continuous_assessments(
+      use_this_dataset = dataset?
+    )
+    _ = use_this_dataset
+    # ======================================================================= #
+    # First check if the commandline includes "master".
+    # ======================================================================= #
+    joined = commandline?.join(' ')
+    if joined.include?('master') and joined.include?('only')
+      _.select! {|name_of_the_lecture, inner_hash|
+        curricula = obtain(:curricula, inner_hash)
+        has_a_master_lecture?(curricula)
+      }
+    end
+    # ======================================================================= #
+    # Next, select only "prüfungsimmanente" courses that were NOT yet
+    # solved:
+    # ======================================================================= #
+    _.select! {|name_of_the_lecture, inner_hash|
+      lecture_type   = inner_hash[:type]
+      already_solved = inner_hash[:already_solved]
+      case lecture_type
+      when *ARRAY_LECTURE_TYPES_THAT_ARE_MANDATORY_CONTINUOUS_ASSESSMENT
+        keep_or_discard = true
+      else
+        keep_or_discard = false
+      end
+      # ======================================================================= #
+      # Next, ignore the lectures that were already solved.
+      # ======================================================================= #
+      if already_solved
+        keep_or_discard = false
+      end
+      keep_or_discard
+    }
+    # ======================================================================= #
+    # Next, scan for filters. This is a bit hack-ish but for now it works.
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      if yielded.is_a? Array
+        joined = yielded.join(' ').strip
+        # =================================================================== #
+        # === übungen --summer
+        # =================================================================== #
+        if joined.include? '--summer'
+          _.select! {|name_of_the_lecture, inner_hash|
+            inner_hash[:semester].to_s.downcase == 'summer'
+          }
+        end
+        # =================================================================== #
+        # === übungen --winter
+        # =================================================================== #
+        if joined.include? '--winter'
+          _.select! {|name_of_the_lecture, inner_hash|
+            inner_hash[:semester].to_s.downcase == 'winter'
+          }
+        end
+      end
+    end
+    # ======================================================================= #
+    # Ok, we now have the courses that are "prüfungsimmanent" and NOT yet
+    # solved.
+    # ======================================================================= #
+    display_these_lectures_sorted_by_priority(_)
+  end
+
+  # ========================================================================= #
+  # === do_determine_the_prüfungsimmanente_ECTS_of_this_curriculum
+  # ========================================================================= #
+  def do_determine_the_prüfungsimmanente_ECTS_of_this_curriculum(
+      i,
+      optional_index = nil,
+      be_verbose     = be_verbose?
+    )
+    i = i.to_s # To avoid Symbols.
+    dataset = dataset?
+    @internal_hash[:total_amount_of_ECTS_points_in_the_curriculum] = 0
+    curriculum_dataset = fetch_this_curriculum(i) { :be_quiet }
+    @internal_hash[:total_amount_of_mandatory_continuous_assessment_ECTS_points_in_this_curriculum] = 0
+    # ======================================================================= #
+    # === Handle blocks next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      case yielded
+      when :be_verbose
+        be_verbose = true
+      end
+    end
+    if optional_index and be_verbose
+      # ===================================================================== #
+      # Report the curriculum number in this case as well.
+      # ===================================================================== #
+      e
+      e springgreen('Curriculum number: ')+
+        slateblue(optional_index.to_s)+
+        limegreen(" (#{name_of_the_curriculum?})")
+      e
+    end
+    if curriculum_dataset
+      if be_verbose and show_the_title_of_the_curriculum?
+        print steelblue(
+                (
+                  return_title_from_this_curriculum_file(i)+'  '
+                ).ljust(58)
+              )
+      end
+      curriculum_dataset.each {|name_of_the_lecture|
+        pointer = dataset[name_of_the_lecture]
+        if pointer.nil?
+          e tomato('Nil value for ')+
+            steelblue(name_of_the_lecture)
+        else
+          n_ECTS = pointer[:ects]
+          type   = pointer[:type]
+          if is_this_a_prüfungsimmanent_course?(type)
+            @internal_hash[:total_amount_of_mandatory_continuous_assessment_ECTS_points_in_this_curriculum] += n_ECTS
+          end
+          @internal_hash[:total_amount_of_ECTS_points_in_the_curriculum] += n_ECTS
+        end
+      }
+      do_calculate_the_percentage
+      formatted_percentage_value = percentage?.round(2).to_s.ljust(5,'0')
+      n_percent_solved = Studium.n_percent_solved_in_this_curriculum(i)
+      if be_verbose?
+        e "#{lightblue(n_prüfungsimmanente_ECTS?)}"\
+          " #{lightblue('ECTS')} "+
+          moccasin('out of')+
+          " "+
+          royalblue(@internal_hash[:total_amount_of_ECTS_points_in_the_curriculum].to_s.rjust(5))+" "+
+          moccasin('ECTS - ')+
+          (
+            slateblue(formatted_percentage_value+'%')+
+            moccasin(' mandatory-presence share ')+
+            moccasin('and ')+
+            seagreen(
+              n_percent_solved.round(1).to_s.rjust(4)
+            )+
+            moccasin('% solved already.')
+          )
+      end
+    else
+      opne "Could not find anything for the given input `#{steelblue(i)}`."
+    end
+  end; alias try_to_find_this_curriculum do_determine_the_prüfungsimmanente_ECTS_of_this_curriculum # === try_to_find_this_curriculum
+
+  # ========================================================================= #
+  # === 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
+
+  # ========================================================================= #
+  # === filter_for_lectures_during_the_summer
+  #
+  # This method will filter for lectures during summer - in other words,
+  # lectures that are during winter, will specifically be excluded.
+  # ========================================================================= #
+  def filter_for_lectures_during_the_summer(
+      this_semester = 'summer'
+    )
+    dataset?.select! {|name_of_the_lecture, hash_inner_dataset|
+      (hash_inner_dataset[:semester] == this_semester) or
+      (hash_inner_dataset[:semester] == 'both') # Allowed since as of February 2023.
+    }
+  end
+
+  # ========================================================================= #
+  # === filter_for_lectures_during_the_winter
+  #
+  # This method will filter for lectures during winter - in other words,
+  # lectures that are during summer, will specifically be excluded.
+  # ========================================================================= #
+  def filter_for_lectures_during_the_winter(
+      this_semester = 'winter'
+    )
+    dataset?.select! {|name_of_the_lecture, hash_inner_dataset|
+      (hash_inner_dataset[:semester] == this_semester) or
+      (hash_inner_dataset[:semester] == 'both') # Allowed since as of February 2023.
+    }
+  end
+
+  # ========================================================================= #
+  # === Studium::Exams::MandatoryContinuousAssessment[]
+  # ========================================================================= #
+  def self.[](i = ARGV)
+    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. It will
+# be quiet, that is, it will not output anything else BUT
+# that percentage number.
+#
+# In german: "Diese Methode gibt einem den prozentualen Anteil
+# an prüfungsimmanenten Lehrveranstaltungen aus."
+#
+# Invocation examples:
+#
+#   percentage = Studium.percentage_mandatory_continuous_assessment('bachelor-genetic')               # => 36.666666666666664
+#   percentage = Studium.percentage_mandatory_continuous_assessment('bachelor-vektor')                # => 37.22222222222222
+#   percentage = Studium.percentage_mandatory_continuous_assessment('bachelor_agrarwissenschaften')   # => 23.333333333333332
+#   percentage = Studium.percentage_mandatory_continuous_assessment('bachelor_agrarwissenschaften',2) # => 23.33
+#
+# =========================================================================== #
+def self.percentage_mandatory_continuous_assessment(
+    in_this_curriculum,
+    round_to = nil
+  )
+  in_this_curriculum = in_this_curriculum.to_s.sub(/curriculum/,'')
+  _ = Studium::Exams::MandatoryContinuousAssessment.new(in_this_curriculum, :do_not_run_yet)
+  _.be_quiet
+  _.run
+  result = _.percentage?
+  if round_to
+    result = result.round(round_to)
+  end
+  return result
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  Studium::Exams::MandatoryContinuousAssessment.new(ARGV)
+end # rb mandatory* agrar