studium 0.9.383

data/lib/studium/exams_per_month/run.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module Studium
+
+class ExamsPerMonth < Base # === Studium::ExamsPerMonth.new
+
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run
+    sanitize_dataset
+    check_against_menu
+    report if @shall_we_report
+  end
+
+end; end

data/lib/studium/exams_per_month/sanitize.rb

@@ -0,0 +1,129 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'studium/exams_per_month/sanitize.rb'
+# =========================================================================== #
+require 'studium/base/base.rb'
+
+module Studium
+
+class ExamsPerMonth < Base # === Studium::ExamsPerMonth
+
+  # ========================================================================= #
+  # === sanitize_dataset
+  #
+  # Purpose of this method is to give us a sorted hash with the specific
+  # entries. In order for this to work, simply pass in your dataset into
+  # this method. By default, we will use the dataset? object, which
+  # is essentially just the @dataset instance variable.
+  #
+  # The initial dataset should have 6 entries, thus 5 occurrences of '|'.
+  #
+  # Example for such a dataset/line:
+  #
+  #   "06.07.2018 | 1.0 | 1.0 | 1 | UniWien | M | VO | 270073 | 2018S | Nukleinsäureanalytik-Genomics"
+  #
+  # ========================================================================= #
+  def sanitize_dataset(
+      i                 = dataset?,
+      modify_time_entry = true
+    )
+    @n_ects_points_belonging_to_mandatory_presence_courses = 0 # Reset it here.
+    case modify_time_entry
+    when :leave_time_entry_alone
+      modify_time_entry = false
+    end
+    # ======================================================================= #
+    # Re-assign the @dataset here.
+    # ======================================================================= #
+    @dataset = i.map {|entry|
+      if entry.is_a? Array
+        splitted = entry
+      else
+        # =================================================================== #
+        # Ensure that the encoding is proper here.
+        # =================================================================== #
+        encoding_to_use = ::Studium.encoding?
+        unless entry.encoding.to_s.include? encoding_to_use
+          entry = entry.force_encoding(encoding_to_use)
+        end
+        splitted = entry.split(' | ') # .reverse
+      end
+      if splitted.size <= 2 # Assume this to be an invalid entry.
+        splitted = nil
+      else
+        # =================================================================== #
+        # Modify the time-entry which is the first entry.
+        # We don't need the day, only the specific month. But this is not
+        # always wanted, so we also must honour an option passed into this
+        # method.
+        # =================================================================== #
+        if modify_time_entry
+          formatted_time = splitted[0].split('.')[1..-1].join('.') # This entry is now something such as "10.2001"
+          splitted[0] = formatted_time
+        end
+        # =================================================================== #
+        # === Compare only specific years
+        #
+        # If the user wants to compare only specific years, we enter
+        # the next section.
+        # =================================================================== #
+        if @compare_these_numbers and formatted_time
+          the_year = formatted_time.split('.').last.to_i
+          unless @compare_these_numbers.include? the_year
+            splitted = nil
+          end
+        end
+      end
+      splitted
+    }
+    @dataset.compact! # Weed out nil-values.
+    @n_exams_passed = 0
+    # ======================================================================= #
+    # Next we populate our hash, which is used to report stuff.
+    #
+    # We will store the amount of hours passed, the amount of ECTS points
+    # that were achieved, and count up for the amount of exams that were
+    # passed.
+    # ======================================================================= #
+    @dataset.each {|entry|
+      entry.map!(&:strip)
+      month_and_year   = entry[0]                # Month and Year is the first entry. 
+      n_hours          = entry[1].to_f           # n hours is the second entry.
+      n_ects_points    = entry[2].to_f           # n ects points is the third entry.
+      # ===================================================================== #
+      # The grade is a bit problematic. It has to be kept as an Array.
+      # ===================================================================== #
+      grade            = entry[3]                # The grade, the fourth entry. Can be 1,2,3,4,5 or '+'.
+      university       = entry[4].strip.downcase # The university at fifth position.
+      _curriculum_type = entry[5].strip          # The curriculum type such as Bachelor or Master. Currently not used here.
+      lecture_type     = entry[6].strip          # The lecture type such as VO, UE, VU, SE.
+      if is_a_prüfungsimmanent_course?(lecture_type)
+        @n_ects_points_belonging_to_mandatory_presence_courses += n_ects_points
+      end
+      @n_exams_passed += 1
+      # ===================================================================== #
+      # === Put the dataset into the @hash instance variable next
+      # ===================================================================== #
+      if @hash.has_key? month_and_year
+        # =================================================================== #
+        # In this case, add it because we already did initialize it.
+        # =================================================================== #
+        new_n_hours       = @hash[month_and_year][0]+n_hours
+        new_n_ects_points = @hash[month_and_year][1]+n_ects_points
+        array_grade       = @hash[month_and_year][2] << grade
+        @hash[month_and_year] = [
+          new_n_hours, new_n_ects_points, array_grade, university, @n_exams_passed
+        ]
+      else # Else simply append it, as it is a new month.
+        @n_exams_passed  = 0 # And reset it here again.
+        @n_exams_passed += 1 # Must be at least one.
+        @hash[month_and_year] = [
+          n_hours, n_ects_points, [grade], university, @n_exams_passed
+        ]
+      end
+    }
+  end
+
+end; end

data/lib/studium/exams_per_month/show_and_report.rb

@@ -0,0 +1,1278 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'studium/exams_per_month/show_and_report.rb'
+# =========================================================================== #
+require 'studium/ects/n_ects_points_in_mandatory_presence_courses.rb'
+require 'studium/ects/ects_per_university.rb'
+
+module Studium
+
+class ExamsPerMonth < Base # === Studium::ExamsPerMonth.new
+
+  # ========================================================================= #
+  # === calculate_the_average_amount_per_passed_exam
+  # ========================================================================= #
+  def calculate_the_average_amount_per_passed_exam
+    ects_per_exams_passed = # This is: total ects / n_exams
+    (
+      @n_ects_points_in_total.to_f / @n_exams_in_total_passed.to_f
+    ).round(2)
+    return ects_per_exams_passed
+  end
+
+  # ========================================================================= #
+  # === show_half_split_exams_per_year
+  #
+  # This method can be used to show how many exams were passed, per
+  # year, in each half of that year.
+  #
+  # Invocation example:
+  #   emo --half-split
+  # ========================================================================= #
+  def show_half_split_exams_per_year
+    array_early_months = %w( 1 2 3 4 5 6 ).map(&:to_i)
+    array_late_months  = %w( 7 8 9 10 11 12 ).map(&:to_i)
+    hash = {}
+    raw_dataset?.each {|this_line|
+      splitted = this_line.strip.split('|').map(&:strip)
+      first_element = splitted.first # e. g. '25.11.1997'
+      n_ects = splitted[2].to_f
+      year  = first_element.split('.').last
+      hash[year] = {
+        :early_months => 0,
+        :late_months  => 0
+      } unless hash.has_key? year
+      month = first_element.split('.')[1].to_i
+      if array_early_months.include? month
+        hash[year][:early_months] += n_ects
+      elsif array_late_months.include? month
+        hash[year][:late_months] += n_ects
+      end
+    }
+    # ======================================================================= #
+    # Next, we will display that Hash, but only if we have any ECTS
+    # points to report..
+    # ======================================================================= #
+    hash.each_pair {|year, value|
+      n_ljust = 28
+      first_half_ects_points  = value[:early_months].to_f
+      second_half_ects_points = value[:late_months].to_f
+      unless ( (first_half_ects_points == 0) and (second_half_ects_points == 0) )
+        e slateblue(year+':')
+        e
+        if first_half_ects_points > 0
+          e ('  Start of the year '+year+': ').ljust(n_ljust)+
+            orange(first_half_ects_points.to_s.rjust(4)+' ECTS points')
+        end
+        if second_half_ects_points > 0
+          e ('  End   of the year '+year+':').ljust(n_ljust)+
+            orange(second_half_ects_points.to_s.rjust(4)+' ECTS points')
+        end
+        e
+      end
+    }
+  end
+
+  # ========================================================================= #
+  # === do_show_only_this_year_here
+  #
+  # Use this method if you only want to show a specific year, such as
+  # 2013 or 2017 and so forth.
+  # ========================================================================= #
+  def do_show_only_this_year_here(i)
+    @show_only_this_year = i # This variable may also contain a '-' character.
+    # ======================================================================= #
+    # Next, select only these entries from the dataset that have
+    # a matching year entry.
+    # ======================================================================= #
+    _ = dataset?.select {|entry| # === emo --year=1997-2009
+      the_year = entry.first.strip.split('.').last.to_s
+      is_it_included = false
+      is_it_included = true if @show_only_this_year == the_year
+      # =================================================================== #
+      # === Range input
+      #
+      # First, handle '-' input given.
+      # =================================================================== #
+      if @show_only_this_year.include? '-'
+        # ================================================================= #
+        # Then we turn it into a range, in order to look whether the
+        # year is within that given Range.
+        # ================================================================= #
+        range = Range.new(*@show_only_this_year.split('-').map(&:to_i))
+        if range.include? the_year.to_i # Since we work with numbers past this point.
+          is_it_included = true
+        end
+      end
+      is_it_included
+    }
+    reset_main_hash # Empty @hash again.
+    sanitize_dataset(_, :leave_time_entry_alone)
+  end
+
+  # ========================================================================= #
+  # === show_only_exams_at_the_vetmed_uni
+  #
+  # Invoke this method like so:
+  #   emo --vetmed
+  # ========================================================================= #
+  def show_only_exams_at_the_vetmed_uni
+    opnn; e 'Showing all exams passed at the Vetmed Uni.'
+    _ = dataset?.select {|entry|
+      name_of_university = entry[4]
+      (name_of_university.strip.downcase == 'vetmed')
+    }
+    reset_main_hash
+    sanitize_dataset(_, :leave_time_entry_alone)
+  end
+
+  # ========================================================================= #
+  # === show_numbered_exams
+  #
+  # This method will output the passed exams.
+  #
+  # To output this method, try this:
+  #   emo --show-numbered-exams
+  #   emo --reversed-nl
+  # ========================================================================= #
+  def show_numbered_exams(normal_or_reversed = :normal)
+    dataset = File.readlines(csv_file?).reject {|entry|
+      entry.start_with? '#'
+    }.reject {|entry|
+      entry.to_s.strip.empty?
+    }
+    size_of_the_dataset = dataset.size
+    e; dataset.each_with_index {|line, index|
+      index += 1
+      if normal_or_reversed == :reversed
+        index = (size_of_the_dataset - index)+1
+      end
+      e '  '+orange(index.to_s.rjust(4))+') '+simp(line.chomp)
+    }; e
+  end
+
+  # ========================================================================= #
+  # === show_only_exams_at_the_uniwien
+  #
+  # Invoke this method like so:
+  #   emo --uniwien
+  # ========================================================================= #
+  def show_only_exams_at_the_uniwien
+    opnn; e 'Showing all exams passed at the UniWien.'
+    _ = dataset?.select {|entry|
+      name_of_university = entry[4]
+      (name_of_university.strip.downcase == 'uniwien')
+    }
+    reset_main_hash
+    sanitize_dataset(_, :leave_time_entry_alone)
+  end
+
+  # ========================================================================= #
+  # === show_only_exams_at_the_meduni
+  #
+  # Invoke this method like so:
+  #   emo --meduni
+  # ========================================================================= #
+  def show_only_exams_at_the_meduni
+    opnn; e 'Showing all exams passed at the MedUni Wien.'
+    _ = dataset?.select {|entry|
+      name_of_university = entry[4]
+      (name_of_university.strip.downcase == 'meduni')
+    }
+    reset_main_hash
+    sanitize_dataset(_, :leave_time_entry_alone)
+  end
+
+  # ========================================================================= #
+  # === show_all_exams_from_this_month
+  #
+  # Use this method to show all exams from a given month only.
+  #
+  # We also support english names for the months, since as of April 2017.
+  #
+  # Usage example:
+  #   emo --januar
+  # ========================================================================= #
+  def show_all_exams_from_this_month(i = 'januar')
+    i.delete!('-') if i.include? '-'
+    i.downcase!
+    # ======================================================================= #
+    # Next, sanitize the month.
+    # ======================================================================= #
+    case i # case tag
+    when 'januar','january'
+      i = '01'
+    when 'februar','february',/feb/
+      i = '02'
+    when 'märz','march'
+      i = '03'
+    when 'april'
+      i = '04'
+    when 'mai','may'
+      i = '05'
+    when 'juni','june'
+      i = '06'
+    when 'juli','july'
+      i = '07'
+    when 'august'
+      i = '08'
+    when 'september'
+      i = '09'
+    when 'oktober','october'
+      i = '10'
+    when 'november'
+      i = '11'
+    when 'dezember','december'
+      i = '12'
+    end
+    _ = dataset?.select {|inner_array|
+      month_and_year = inner_array.first
+      splitted = month_and_year.split('.')
+      month = splitted.first
+      month == i 
+    }
+    reset_main_hash
+    sanitize_dataset(_, :leave_time_entry_alone)
+  end
+
+  # ========================================================================= #
+  # === show_only_practical_courses_that_were_passed_already
+  #
+  # Use this method if you wish to show only practical courses that
+  # were passed already.
+  #
+  # The currently acknowledged practical courses include UE, PR and LU.
+  #
+  # Invocation example:
+  #   emo --übungen
+  # ========================================================================= #
+  def show_only_practical_courses_that_were_passed_already
+    @show_average_ects_passed_per_exam = false # This method won't report average amount of ECTS per exam.
+    _ = dataset?
+    _.select! {|entry|
+      type_of_lecture = entry[6].strip
+      type_of_lecture.include?('UE') or
+      type_of_lecture.include?('PR') or
+      type_of_lecture.include?('LU')
+    }
+    reset_main_hash
+    sanitize_dataset(_, :leave_time_entry_alone)
+    report_main_hash
+  end
+
+  # ========================================================================= #
+  # === show_exam_ects_points_passed_per_semester
+  # ========================================================================= #
+  def show_exam_ects_points_passed_per_semester
+    # ======================================================================= #
+    # First, we need a way to group months into "sommersemester" or
+    # "wintersemester.
+    # ======================================================================= #
+    hash = {}
+    _ = dataset?
+    opnn; e 'We will next show how many exams were passed in a given semester.'
+    # ======================================================================= #
+    # Each entry in the dataset looks like this:
+    #   ["10.2001", "3.0"," xxx","4", "UniWien", "  D ", "  898249  ","Allgemeine Biologie III"],
+    #                SWS   ECTS
+    # And it is already sorted.
+    # ======================================================================= #      
+    _.each {|inner_array|
+      _n_wochenstunden = inner_array[1]
+      n_ects_points    = inner_array[2]
+      _name_of_the_lecture = inner_array.last
+      month_year = inner_array.first
+      year = month_year.dup
+      if month_year.include? '.'
+        splitted   = month_year.split('.')
+        month_year = splitted.first
+        year       = splitted.last.to_i
+      end
+      sommersemester_or_wintersemester = is_this_sommersemester_or_wintersemester?(
+        month_year
+      )
+      # ======================================================================= #
+      # Note that the Wintersemester may be from the last year, so we
+      # may have to deduct 1. This will be the case only for January
+      # and February though. 
+      # ======================================================================= #
+      month_as_number = month_year.split('.').first.to_i 
+      if (sommersemester_or_wintersemester == 'WS') and
+         [1,2].include?(month_as_number)
+         year -= 1
+      end
+      # ======================================================================= #
+      # Every time a toggle from SS to WS happens, we populate it into
+      # another Hash. Note that we only care for when the exam was
+      # officially registered and simply count this as a "sommersemester"
+      # or "wintersemester" lecture.
+      # ======================================================================= #
+      hash_key_to_use = sommersemester_or_wintersemester+' '+year.to_s
+      if hash.has_key? hash_key_to_use # Then add to it.
+        hash[hash_key_to_use] = hash[hash_key_to_use]+n_ects_points.to_f
+      else
+        hash[hash_key_to_use] = n_ects_points.to_f
+      end
+    }
+    e 'We have determined these ECTS points per semester:'; e
+    hash.each_pair {|semester_and_year, n_ects_points|
+      e '  '+simp(semester_and_year.ljust(8))+' '+
+        sfancy(((n_ects_points.to_s.rjust(4))+' ECTS').rjust(8))
+    }
+    e; e 'Total ECTS points: '+simp(hash.values.sum.to_s)
+  end
+
+  # ========================================================================= #
+  # === show_only_exams_before_this_date
+  #
+  # The argument to this method should be the starting time, the day at
+  # which you wish to keep track of exams made BEFORE this date.
+  #
+  # To invoke this method, do:
+  #   emo "before 10.01.2011"
+  # ========================================================================= #
+  def show_only_exams_before_this_date(this_date)
+    unless this_date.include? '.'
+      this_date.prepend('01.01.') # In this case, we assume this to mean the first January.
+    end
+    opnn; e 'Showing only passed exams before the date '+simp(this_date.to_s)+'.'
+    # ======================================================================= #
+    # Convert a String into a time object.
+    # ======================================================================= #
+    this_date = Time.parse(this_date) if this_date.is_a? String
+    a = this_date # Shorter to type. :)
+    _ = dataset?
+    new_array_with_matches = []
+    _.each {|entry|
+      date = Time.parse('01.'+entry.first.strip) # Must insert date here.
+      b = date
+      if a > b
+        new_array_with_matches << entry
+      end
+    }
+    reset_main_hash
+    sanitize_dataset(new_array_with_matches, :leave_time_entry_alone)
+  end
+
+  # ========================================================================= #
+  # === show_only_bachelor_exams
+  #
+  # Use this method to show only exams relevant for the Bachelor.
+  #
+  # Invocation example:
+  #   emo --show-only-bachelor
+  # ========================================================================= #
+  def show_only_bachelor_exams
+    opnn; e 'Showing only Bachelor exams.'
+    _ = dataset?.select {|entry|
+      curriculum_type = entry[5].strip # The sixth entry is the bachelor/master distinction.
+      curriculum_type.include? 'B'
+    }
+    reset_main_hash
+    sanitize_dataset(_, :leave_time_entry_alone)
+  end
+
+  # ========================================================================= #
+  # === show_only_master_lectures
+  #
+  # This method is tasked to show only master lectures. For this purpose,
+  # we define a lecture to be a "master" lecture if it is part of at the
+  # least one master-curriculum. With this definition, a lecture that
+  # is registered in both a bachelor and a master curriculum, will
+  # satisfy this defintion and thus be listed.
+  #
+  # We will take the file passed_exams_per_month.csv for this.
+  #
+  # That file will have entries such as:
+  #
+  #   28.11.2016 | 3.0 | 6.0 | 1 | UniWien |   M  |   330011   | Zell- und Molekularbiologie
+  #
+  # So we can pick field number 6. If that field has an upcased 'M' then
+  # it qualifies.
+  #
+  # To invoke this method from the commandline, do:
+  #   emo --show-only-master-lectures
+  # ========================================================================= #
+  def show_only_master_lectures
+    _ = @dataset.select {|array|
+      bachelor_or_master_curriculum = array[5].strip
+      bachelor_or_master_curriculum.include? 'M'
+    }
+    total_ects_points = 0
+    e
+    _.each_with_index {|lecture_data, index|
+      index += 1
+      n_ects = lecture_data[2]
+      total_ects_points += n_ects.to_f
+      name_of_the_lecture = lecture_data.last
+      leistung_erbracht_am = lecture_data.first
+      which_university = mediumturquoise(lecture_data[4])
+      show_number_then_name_of_the_lecture_then_n_ECTS_points_then_leistung_erbracht_then_which_university(
+        index, name_of_the_lecture, n_ects, leistung_erbracht_am, which_university
+      )
+    }
+    report_total_amount_of_ects_points(total_ects_points, :master)
+  end
+
+  # ========================================================================= #
+  # === show_only_bachelor_lectures
+  #
+  # As the variant for master lectures, just for bachelor lectures.
+  #
+  # To invoke it, do:
+  #   emo --show-only-bachelor-lectures
+  # ========================================================================= #
+  def show_only_bachelor_lectures
+    _ = @dataset.select {|array|
+      bachelor_or_master_curriculum = array[5].strip
+      bachelor_or_master_curriculum.include? 'B'
+    }
+    total_ects_points = 0
+    e
+    _.each_with_index {|lecture_data, index|
+      index += 1
+      n_ects = lecture_data[2]
+      total_ects_points += n_ects.to_f
+      name_of_the_lecture = lecture_data.last
+      leistung_erbracht_am = lecture_data.first
+      which_university = mediumturquoise(lecture_data[4])
+      show_number_then_name_of_the_lecture_then_n_ECTS_points_then_leistung_erbracht_then_which_university(
+        index, name_of_the_lecture, n_ects, leistung_erbracht_am, which_university
+      )
+    }
+    report_total_amount_of_ects_points(total_ects_points, :bachelor)
+  end
+
+  # ========================================================================= #
+  # === report_total_amount_of_ects_points
+  # ========================================================================= #
+  def report_total_amount_of_ects_points(
+      total_ects_points,
+      bachelor_or_master = :bachelor,
+      ljust_to_use       = 41 # Reason for this value is so that it aligns.
+    )
+    bachelor_or_master = bachelor_or_master.to_s.capitalize # Capitalization is nicer.
+    e
+    e 'Total ECTS points from '+bachelor_or_master+' lectures: '.
+      ljust(ljust_to_use)+
+      slateblue(total_ects_points.to_s+' ECTS')
+    e
+  end
+
+  # ========================================================================= #
+  # === show_number_then_name_of_the_lecture_then_n_ECTS_points_then_leistung_erbracht_then_which_university
+  #
+  # This long compound method is only used from within the following two
+  # methods:
+  #
+  #   show_only_bachelor_lectures
+  #   show_only_master_lectures
+  #
+  # ========================================================================= #
+  def show_number_then_name_of_the_lecture_then_n_ECTS_points_then_leistung_erbracht_then_which_university(
+      index, name_of_the_lecture, n_ects, leistung_erbracht_am, which_university
+    )
+    e lightgreen((index.to_s+')').rjust(6))+' '+
+      orange(name_of_the_lecture.ljust(74))+' '+
+      slateblue(n_ects.to_s+' ECTS')+crimson(
+        ' '+leistung_erbracht_am.to_s
+      )+' '+which_university
+  end
+
+  # ========================================================================= #
+  # === show_only_exams_past_this_date
+  #
+  # The argument to this method should be the starting time, the day at
+  # which you wish to keep track of exams made afterwards.
+  #
+  # To invoke this method, do:
+  #   emo "since 10.02.2014"
+  # ========================================================================= #
+  def show_only_exams_past_this_date(this_date)
+    unless this_date.include? '.'
+      this_date.prepend('01.01.') # In this case, we assume this to mean the first January.
+    end
+    # ======================================================================= #
+    # The variable this_date will be something like "18.08.2013".
+    # ======================================================================= #
+    opnn; e 'Showing only passed exams past the date '+simp(this_date.to_s)+'.'
+    # ======================================================================= #
+    # Convert a String into a time object.
+    # ======================================================================= #
+    this_date = Time.parse(this_date) if this_date.is_a? String
+    a = this_date # Shorter to type. :)
+    _ = dataset?
+    new_array_with_matches = []
+    _.each {|entry|
+      # ======================================================================= #
+      # We simply assume the first day of the given month next.
+      # ======================================================================= #
+      first = '01.'+entry.first.strip
+      date = Time.parse(first) # Must insert date here.
+      b = date
+      if a < b
+        new_array_with_matches << entry # Only add entries that are relevant.
+      end
+    }
+    reset_main_hash # Reset for a clean state again.
+    sanitize_dataset(new_array_with_matches, :leave_time_entry_alone)
+  end
+
+  # ========================================================================= #
+  # === show_only_exams_at_the_tu
+  #
+  # Show only exams at the TU.
+  # ========================================================================= #
+  def show_only_exams_at_the_tu
+    opnn; e 'Showing all exams passed at the TU.'
+    _ = dataset?.select {|entry|
+      name_of_university = entry[4]
+      (name_of_university.strip.downcase.start_with? 'tu')
+    }
+    reset_main_hash
+    sanitize_dataset(_, :leave_time_entry_alone)
+  end
+
+  # ========================================================================= #
+  # === do_show_the_grades_statistics
+  #
+  # Show all grade statistics.
+  #
+  # Invocation example:
+  #   emo --grades
+  # ========================================================================= #
+  def do_show_the_grades_statistics
+    _ = dataset?
+    # ======================================================================= #
+    # The dataset will have entries such as:
+    #   ["05.1998","2.0"," xxx","4","UniWien","  D ","  854623  ","1998W","Biologische Physik II (Physik für Biologen II)"]
+    # So for our purpose, we are only interested in entry at position
+    # 2, 3 and 4.
+    # ======================================================================= #
+    hash_containing_the_relevant_entries = {}
+    # ======================================================================= #
+    # The following data structures are of interest:
+    #   - How many exams were passed for this grade
+    #   - The total amount of ECTS points passed
+    #   - The total amount of hours passed
+    # ======================================================================= #
+    hash_containing_the_relevant_entries[1] = [0,0,0]
+    hash_containing_the_relevant_entries[2] = [0,0,0]
+    hash_containing_the_relevant_entries[3] = [0,0,0]
+    hash_containing_the_relevant_entries[4] = [0,0,0]
+    # ======================================================================= #
+    # Iterate over the dataset.
+    # ======================================================================= #
+    _.each {|line|
+      this_grade    = line[3].to_i
+      if this_grade == 0
+        # pp 'DEBUG'; pp line # For entries that have a '+' evaluation rather.
+      else
+        n_ects_points = line[1].to_f
+        n_hours       = line[2].to_f
+        array = hash_containing_the_relevant_entries[this_grade]
+        array[0] += 1
+        array[1] += n_ects_points # For ECTS points.
+        array[2] += n_hours       # For Semesterwochenstunden.
+        hash_containing_the_relevant_entries[this_grade] = array
+      end
+    }
+    e
+    e lightgreen('The grades that were passed successfully, are as follows:')
+    e
+    average_grade = 0
+    average_grade_weighted_by_ects_points = 0
+    n_total_exams = hash_containing_the_relevant_entries.values.map {|array|
+      array.first
+    }.sum 
+    hash_containing_the_relevant_entries.each_pair {|grade, array_dataset|
+      n_exams_passed = array_dataset.first
+      total_n_ects_points = array_dataset[1]
+      total_n_hours = array_dataset.last
+      n_percent = (n_exams_passed.to_i * 100 / n_total_exams).round(3).to_s
+      e "For the grade #{simp(grade)}   #{crimson(n_exams_passed.to_s)} "\
+        "exams were passed successfully. (#{crimson(n_percent.to_s+'%')})"
+      e "  n ECTS points: #{mediumorchid(total_n_ects_points.to_s.rjust(5))}"
+      e "  n hours:       #{mediumpurple(total_n_hours.to_s.rjust(5))}"
+      e 
+    }
+    hash = hash_containing_the_relevant_entries
+    average_grade = (1 * hash[1][0]+
+                     2 * hash[2][0]+
+                     3 * hash[3][0]+
+                     4 * hash[4][0])
+    total_n_ects_points = hash[1][1].to_f+
+                          hash[2][1].to_f+
+                          hash[3][1].to_f+
+                          hash[4][1].to_f
+    average_grade_weighted_by_ects_points = (
+      1 * hash[1][1].to_f+
+      2 * hash[2][1].to_f+
+      3 * hash[3][1].to_f+
+      4 * hash[4][1].to_f
+    )
+    average_grade_weighted_by_ects_points = 
+      average_grade_weighted_by_ects_points.to_f / total_n_ects_points.to_f # Gesamtzahl an ECTS
+    average_grade = average_grade.to_f / (
+      hash[1][0]+
+      hash[2][0]+
+      hash[3][0]+
+      hash[4][0]
+    ) # Have to divide it by the amount of exams.
+    average_grade = average_grade.round(2)
+    # ======================================================================= #
+    # Next, show some statistics.
+    # ======================================================================= #
+    e 'This means that the average grade is: '+
+       slateblue(average_grade.to_s)
+    e 'And the average grade, weighted per single (1.0) ECTS point, is: '+
+      lightblue(average_grade_weighted_by_ects_points.round(2).to_s)
+    e
+  end
+
+  # ========================================================================= #
+  # === show_how_many_exams_we_have_passed_in_this_curriculum
+  #
+  # This method will show how many exams we have already passed for
+  # a given curriculum xyz.
+  #
+  # To invoke this, do:
+  #
+  #   emo --agrarwissenschaften
+  #
+  # ========================================================================= #
+  def show_how_many_exams_we_have_passed_in_this_curriculum(i)
+    require 'studium/lectures/show_lectures_on_the_commandline/show_lectures_on_the_commandline.rb'
+    i = i.to_s.delete('_')
+    _ = ::Studium::ShowLecturesOnTheCommandline.new(
+      i, :do_not_run_yet
+    )
+    _.do_not_report_anything
+    _.iterate_over_the_lectures
+    _.report_how_many_exams_have_been_passed_already
+  end
+
+  # ========================================================================= #
+  # === show_ects_passed_per_university
+  # ========================================================================= #
+  def show_ects_passed_per_university
+    Studium::EctsPerUniversity.new
+  end
+
+  # ========================================================================= #
+  # === set_n_exams_in_total_passed
+  # ========================================================================= #
+  def set_n_exams_in_total_passed(i)
+    @n_exams_in_total_passed = i.to_f
+  end
+
+  # ========================================================================= #
+  # === set_n_ects_points_in_total
+  # ========================================================================= #
+  def set_n_ects_points_in_total(i)
+    @n_ects_points_in_total = i.to_f
+  end
+
+  # ========================================================================= #
+  # === determine_n_ects_points_in_total
+  #
+  # The main Hash will look like this:
+  #
+  #   {"07.2018"=>[9.0, 14.0, ["+", "4", "1", "1"], "uniwien", 4]
+  #
+  # The relevant ECTS entries are in the value part, at the second
+  # position, so [1].
+  # ========================================================================= #
+  def determine_n_ects_points_in_total
+    n_ects_points = @hash.values.map {|entry| entry[1] }.sum
+    set_n_ects_points_in_total(n_ects_points)
+  end
+
+  # ========================================================================= #
+  # === determine_n_exams_in_total_were_passed
+  # ========================================================================= #
+  def determine_n_exams_in_total_were_passed
+    n_exams = @hash.values.map {|entry| entry.last }.sum
+    set_n_exams_in_total_passed(n_exams)
+  end
+
+  # ========================================================================= #
+  # === show_the_years_in_a_short_table_overview
+  #
+  # To invoke this method, do:
+  #   emo --years
+  # ========================================================================= #
+  def show_the_years_in_a_short_table_overview
+    total_ects = 0
+    _ = dataset? # Prepare the dataset a bit.
+    _.map! {|inner_array|
+      n_ects_points = inner_array[2] # Grab the amount of ECTS of this exam.
+      [inner_array[0].split('.').last, n_ects_points]
+    }
+    # ======================================================================= #
+    # Determine the current year automatically.
+    # ======================================================================= #
+    current_year = Date.today.year # 2017
+    total_ects_points_in_that_year = 0
+    e
+    e steelblue('Year')+
+      sfancy('      n ECTS points')
+    show_colourized_line
+    _.each {|year, n_ects_points|
+      year = year.to_i
+      n_ects_points = n_ects_points.to_f
+      total_ects += n_ects_points
+      if current_year == year
+        total_ects_points_in_that_year += n_ects_points
+      else
+        e ' '+
+          steelblue(( (current_year.to_s+': ') ).ljust(15))+
+          sfancy(total_ects_points_in_that_year.to_s.rjust(5)+' ECTS points')
+        total_ects_points_in_that_year = 0
+        current_year = year
+        total_ects_points_in_that_year += n_ects_points
+      end
+    }
+    show_colourized_line
+    e (' ' * 16)+sfancy(total_ects.to_s+' ECTS points')
+    e
+  end
+
+  # ========================================================================= #
+  # === show_colourized_line
+  # ========================================================================= #
+  def show_colourized_line(n_times = 34)
+    e simp('-' * n_times)
+  end
+
+  # ========================================================================= #
+  # === show_best_months
+  #
+  # This method will show the best months, sorted. Best comes first.
+  #
+  # Invocation example:
+  #
+  #   emo --show-best-months
+  #
+  # ========================================================================= #
+  def show_best_months(
+      do_show_n_months = @show_n_best_months
+    )
+    opnn; e 'Showing the '+slateblue(do_show_n_months.to_s)+' best '\
+            'months next, sorted by n ECTS points passed:'
+    e
+    hash_month_statistics = {}
+    _ = @hash.sort_by {|key, inner_array|
+      n_ECTS_points = inner_array[1].to_f
+      n_ECTS_points
+    }.reverse
+    # ======================================================================= #
+    # Next we must determine the sub-array which we will display.
+    # ======================================================================= #
+    array_to_display = []
+    _.each {|month, inner_array|
+      array_to_display << [ month, inner_array[1].to_f ]
+    }
+    # ======================================================================= #
+    # How many months to analyze will be determined next:
+    # ======================================================================= #
+    array_to_display = array_to_display[0..(do_show_n_months - 1)]
+    # ======================================================================= #
+    # Now we have our dataset - array_to_display keeps track of it.
+    # ======================================================================= #
+    exam_number_n = 0 # <- Keep track of which exam is in use.
+    array_to_display.each {|month, n_ECTS_points_passed|
+      # ===================================================================== #
+      # The dataset may look like this:
+      #
+      #   [["01.2017", 41.0],
+      #    ["06.2015", 35.0],
+      #
+      # ===================================================================== #
+      exam_number_n += 1
+      left_pad = ((exam_number_n.to_s+')').rjust(5)).ljust(6)
+      # ======================================================================= #
+      # Report this to the user:
+      # ======================================================================= #
+      rounded_n_ECTS_points_passed = n_ECTS_points_passed.to_s.to_f.round(1)
+      e yellow(left_pad)+'In the month '+
+        sfancy(month)+', '+
+        violet(rounded_n_ECTS_points_passed.to_s.rjust(4))+
+        ' ECTS points were completed.'
+      # ======================================================================= #
+      # Also add to the hash that keeps track about the month-statistics.
+      # ======================================================================= #
+      this_month = month.split('.').first.to_i # <- Example input: "01.2017"
+      this_month = Studium::MONTH_NUMBER_TO_MONTH_NAME[this_month]
+      hash = {
+        :n_ects            => n_ECTS_points_passed,
+        :n_times_mentioned => 1
+      }
+      if hash_month_statistics.has_key? this_month
+        hash_month_statistics[this_month][:n_ects] += n_ECTS_points_passed
+        hash_month_statistics[this_month][:n_times_mentioned] += 1
+      else
+        hash_month_statistics[this_month] = hash
+      end
+    }
+    e
+    # ======================================================================= #
+    # Next, we will also show some month statistics.
+    # ======================================================================= #
+    colourized_n_best_months = orange(do_show_n_months)
+    opnn; e "The best #{colourized_n_best_months} (top) months "\
+            "seem to be the following ones:"
+    e
+    _ = hash_month_statistics
+    # ======================================================================= #
+    # The variable name_of_the_month keeps track of the month at hand,
+    # e. g. "January" or "March".
+    # ======================================================================= #
+    _ = _.sort_by {|name_of_the_month, hash_containing_n_ects_and_n_times_mentioned|
+      n_ects = hash_containing_n_ects_and_n_times_mentioned[:n_ects]
+      n_ects
+    }.reverse
+    counter = 0
+    # ======================================================================= #
+    # Now we have the entry properly sorted. We will display only up to
+    # n times specified as above (e. g. 8 times right now).
+    # ======================================================================= #
+    _.each {|name_of_the_month, hash_containing_n_ects_and_n_times_mentioned|
+      next if counter > 7 # <- Sync it with the above value of 8.
+      n_ects = hash_containing_n_ects_and_n_times_mentioned[:n_ects]
+      n_times_mentioned = hash_containing_n_ects_and_n_times_mentioned[:n_times_mentioned]
+      counter += 1
+      e '  '+
+        sfancy((name_of_the_month+':').ljust(12))+
+        orange(n_times_mentioned.to_s.rjust(2))+ # <- n_times mentioned
+        olivedrab(' (ECTS in total: ')+
+        colourize_ects_points(n_ects.to_s.rjust(5))+
+        olivedrab('; average ECTS in that month: ')+
+        colourize_ects_points(
+          (n_ects.to_f / n_times_mentioned.to_i).round(1).to_s.rjust(4)
+        )+
+        olivedrab(')')
+    }
+    e
+  end
+
+  # ========================================================================= #
+  # === show_total_summary_for_year_hours_ects_n_exams
+  #
+  # This method will show the total summary for a given year.
+  # ========================================================================= #
+  def show_total_summary_for_year_hours_ects_n_exams(
+      last_year,
+      total_n_hours_passed_in_this_year,
+      total_n_ects_passed_in_this_year,
+      total_n_exams_passed_in_this_year,
+      optional_average_grade_per_exam = nil # The average grade per exam in a given year. Optional entr.y
+    )
+    if @show_only_this_year and
+       @show_only_this_year.include?('-') and
+       @show_only_this_year.split('-').last.to_i < last_year
+      # This is the case here when we show a range.
+    elsif @show_only_this_year and
+         (@show_only_this_year != last_year)
+    else
+      e # And a newline too.
+      result = 'Total Summary in '+sfancy(last_year.to_s)+': '+
+        # Add n_hours next.
+        colourize_hours(
+          total_n_hours_passed_in_this_year.to_s.rjust(4)
+        )+' '
+      # ======================================================================= #
+      # Add n_ECTS next.
+      # ======================================================================= #
+      if show_ects_points?
+        result << colourize_ects(
+            total_n_ects_passed_in_this_year.to_f.to_s.rjust(5)+
+            ' ECTS passed'
+          )
+      end
+      # ======================================================================= #
+      # We will use papayawhip here instead.
+      # ======================================================================= #
+      result << colourize_n_exams('  (n exams passed that year: '+
+                  total_n_exams_passed_in_this_year.to_s.rjust(3)+')',
+                  :mediumseagreen
+                )
+      e result
+      if @show_yearly_average_grades and optional_average_grade_per_exam
+        if block_given?
+          yielded = yield
+          if yielded.is_a? Hash
+            if yielded.has_key? :exclude_n_exams_from_the_grade_list
+              total_n_exams_passed_in_this_year -= yielded[:exclude_n_exams_from_the_grade_list].to_i
+            end
+          end
+        end
+        _ = (
+          optional_average_grade_per_exam.to_f / total_n_exams_passed_in_this_year.to_f
+        ).round(2)
+        _ = _.to_s.ljust(4,'0')
+        e 'The average grade of the exams passed in this year is: '+
+           sfancy(_)
+      end
+    end
+  end
+
+  # ========================================================================= #
+  # === show_only_exams_at_the_boku
+  #
+  # Show only exams at the BOKU.
+  # ========================================================================= #
+  def show_only_exams_at_the_boku
+    opnn; e 'Showing all exams passed at the BOKU.'
+    _ = dataset?.select {|entry|
+      name_of_university = entry[4]
+      (name_of_university.strip.downcase == 'boku')
+    }
+    reset_main_hash
+    sanitize_dataset(_, :leave_time_entry_alone) 
+  end
+
+  # ========================================================================= #
+  # === show_n_exams_passed_per_month                            (report tag)
+  #
+  # This is the main report-method for this class.
+  #
+  # Make sure that the input to this method is correct.
+  # ========================================================================= #
+  def show_n_exams_passed_per_month(
+      i = @hash
+    )
+    month   = 0
+    year    = 0
+    n_hours = 0
+    n_ECTS  = 0
+    grade   = 0
+    # ======================================================================= #
+    # We must initialize some variables here.
+    # ======================================================================= #
+    n_exams_passed_in_this_month        = 0 
+    total_n_ects_passed_in_this_year    = 0
+    total_n_hours_passed_in_this_year   = 0
+    total_n_exams_passed_in_this_year   = 0
+    total_grade_count_in_this_year      = 0
+    exclude_n_exams_from_the_grade_list = 0
+
+    last_year = LAST_YEAR # Will point to the current year actually.
+    this_year = Time.now.year.to_i
+    # ======================================================================= #
+    # Check whether we shall only show certain grades.
+    # ======================================================================= #
+    if @show_only_grade_for
+      opnn; e "We will only show grades that are equal to "\
+              "#{simp(@show_only_grade_for.to_s)}."
+    end
+    e
+    opnn; e 'We will show how many hours / ECTS we passed per '\
+            'given month and then year.'
+    e
+    spacer
+    # ======================================================================= #
+    # Header:
+    # ======================================================================= #
+    if @show_only_this_year and
+       @show_only_this_year.include?('-') and
+       @show_only_this_year.split('-').last.to_i < last_year
+      # ===================================================================== #
+      # In this case, do not show the last year.
+      # ===================================================================== #
+    elsif @show_only_this_year and
+         (@show_only_this_year != last_year) and
+         (this_year != last_year)
+      # ===================================================================== #
+      # In this case we will also not show the last year.
+      # ===================================================================== #
+    else # This here is the main clause - most conditions lead to this case.
+      output_colourized_year_and_colourized_hours(last_year)
+    end
+    # ======================================================================= #
+    # We iterate through our hash. Each entry processed through .each
+    # is the dataset for a whole month.
+    #
+    # The entries are:
+    #
+    #   - On the left side, the month.year entry.
+    #
+    #   - On the right side, an Array with n hours, n ects points,
+    #     the grade, n exams passed and the university .
+    # ======================================================================= #
+    i.each {|month_year, n_hours_n_ECTS_grade_university_n_exams_passed|
+      month, year = month_year.split('.').map(&:to_i)
+      # ===================================================================== #
+      # First we deconstruct the information stored in our Array:
+      #   n_hours | n_ECTS | grade | university | n_exams_passed
+      # ===================================================================== #
+      n_hours, n_ECTS, grade, _university, n_exams_passed_in_this_month =
+        n_hours_n_ECTS_grade_university_n_exams_passed
+      # ===================================================================== #
+      # Currently, the grade is not output as it is not so important. It
+      # can, however had, be used for showing the average grade per year.
+      # ===================================================================== #
+      # Next, the case will be handled when we only show exams that have a
+      # specific grade.
+      # ===================================================================== #
+      if @show_only_grade_for
+        next unless grade == @show_only_grade_for
+      end
+      # ===================================================================== #
+      # Switch to another year in that event.
+      # ===================================================================== #
+      if year != last_year
+        # =================================================================== #
+        # Show the total summary per given year. The last entry showing the
+        # average grade is optional.
+        # =================================================================== #
+        show_total_summary_for_year_hours_ects_n_exams(
+          last_year, total_n_hours_passed_in_this_year,
+          total_n_ects_passed_in_this_year,
+          total_n_exams_passed_in_this_year,
+          total_grade_count_in_this_year
+        ) {{ exclude_n_exams_from_the_grade_list: exclude_n_exams_from_the_grade_list }}
+        # =================================================================== #
+        # Reset various variables next, in order to prepare for the dataset
+        # from a new year.
+        # =================================================================== #
+        total_n_ects_passed_in_this_year    = 0
+        total_n_hours_passed_in_this_year   = 0
+        total_n_exams_passed_in_this_year   = 0
+        total_grade_count_in_this_year      = 0
+        exclude_n_exams_from_the_grade_list = 0
+        # =================================================================== #
+        # Show the spacer after the summary.
+        # =================================================================== #
+        spacer unless @show_only_this_year and (@show_only_this_year != last_year)
+        # =================================================================== #
+        # Red year.
+        # =================================================================== #
+        output_colourized_year_and_colourized_hours(year)
+        # =================================================================== #
+        # New year starts here. We will display end-of-year stuff,
+        # before resetting other counters.
+        # =================================================================== #
+        last_year = year
+      end
+      total_n_hours_passed_in_this_year += n_hours
+      @n_hours_passed_in_total          += n_hours
+      total_n_ects_passed_in_this_year  += n_ECTS
+      @n_ects_points_in_total           += n_ECTS
+      total_n_exams_passed_in_this_year += n_exams_passed_in_this_month
+      @n_exams_in_total_passed          += n_exams_passed_in_this_month.to_i
+      # ===================================================================== #
+      # Before we can add to the total grade count in this year, we must
+      # first ensure that the input is not a '+', since this would mean
+      # passing an exam without getting a grade such as 1, 2, 3, 4 or 5.
+      #
+      # Note that grade is an Array.
+      # ===================================================================== #
+      if grade.include? '+'
+        exclude_n_exams_from_the_grade_list += grade.count('+')
+        grade.reject! {|entry| entry == '+' }
+      end
+      # ===================================================================== #
+      # Next, we can push it into the variable total_grade_count_in_this_year
+      # ===================================================================== #
+      add_this_number = grade.map(&:to_i).sum
+      total_grade_count_in_this_year += add_this_number
+      # ===================================================================== #
+      # We can always display the dataset for the given month.
+      # ===================================================================== #
+      report_month_year_hours_ects_n_exams_passed_in_this_month(
+        month, year, n_hours, n_ECTS, n_exams_passed_in_this_month
+      )
+    }
+    # ======================================================================= #
+    # Must display it one more time, for the last year:
+    # ======================================================================= #
+    show_total_summary_for_year_hours_ects_n_exams(
+      last_year,
+      total_n_hours_passed_in_this_year,
+      total_n_ects_passed_in_this_year,
+      total_n_exams_passed_in_this_year,
+      total_grade_count_in_this_year
+    ) {{ exclude_n_exams_from_the_grade_list: exclude_n_exams_from_the_grade_list }}
+    # ======================================================================= #
+    # Last but not least, we also say how many exams we have passed
+    # in total, and how many ECTS points these are.
+    # ======================================================================= #
+    e
+    ljust_it_n_times = :default
+    report_how_many_exams_were_passed_in_total(@n_exams_in_total_passed, ljust_it_n_times)
+    if show_ects_points? # We here will also assume that the user wants to show the amount of hours as well.
+      # ===================================================================== #
+      # Hours, total ects and ects-per-passed-exam:
+      # ===================================================================== #
+      ects_per_exams_passed = # This is: total ects / n_exams
+        (
+          @n_ects_points_in_total.to_f / @n_exams_in_total_passed.to_f
+        ).round(2)
+      report_how_many_hours_were_passed_in_total(
+        @n_hours_passed_in_total, ljust_it_n_times
+      )
+      report_how_many_ects_points_have_been_gathered_so_far
+      report_how_many_of_these_ects_points_required_mandatory_presence(
+        @n_ects_points_belonging_to_mandatory_presence_courses
+      )
+      if @show_average_ects_passed_per_exam
+        report_the_average_amount_of_ects_per_passed_exam(
+          ects_per_exams_passed, ljust_it_n_times
+        )
+      end
+      report_the_average_grade(ljust_it_n_times)
+    end
+  end; alias report_main_hash show_n_exams_passed_per_month # === report_main_hash
+       alias report           show_n_exams_passed_per_month # === report
+
+  # ========================================================================= #
+  # === report_how_many_of_these_ects_points_required_mandatory_presence
+  #
+  # Report how many ECTS points have been passed that required a
+  # mandatory presence (aka "prüfungsimmanent" in german).
+  # ========================================================================= #
+  def report_how_many_of_these_ects_points_required_mandatory_presence(
+      n_ects_points_in_mandatory_presence_courses =
+        Studium.n_ects_points_in_mandatory_presence_courses,
+      n_ljust = 77
+    )
+    if n_ljust == :default
+      n_ljust = 77
+    end
+    n_total_ects = @n_ects_points_in_total.to_f
+    percentage_value = (
+      n_ects_points_in_mandatory_presence_courses.to_f * 100
+    ) / n_total_ects
+    rounded_percentage_value = percentage_value.round(2)
+    e (
+        "Of these, #{slategray('n ECTS points')} are \"prüfungsimmanent\": "
+      ).ljust(n_ljust)+
+      sfancy(
+        n_ects_points_in_mandatory_presence_courses.to_s.rjust(5)
+      )+
+      orange(' ('+rounded_percentage_value.to_s+'%)')
+  end
+
+  # ========================================================================= #
+  # === report_the_average_grade
+  # ========================================================================= #
+  def report_the_average_grade(
+      n_ljust = 76,
+      n_rjust =  4
+    )
+    if n_ljust == :default
+      n_ljust = 76
+    end
+    e "The #{slategray('average grade')} for these exams is: ".ljust(n_ljust+3)+
+      sfancy(
+        average_grade.to_s.rjust(n_rjust)
+      )
+  end
+
+  # ========================================================================= #
+  # === report_how_many_ects_points_have_been_gathered_so_far
+  # ========================================================================= #
+  def report_how_many_ects_points_have_been_gathered_so_far(
+      n_ljust = 52
+    )
+    e "In total, #{slategray('n ECTS points')} have been "\
+      "gathered so far: ".ljust(n_ljust)+
+      "#{sfancy(@n_ects_points_in_total.to_s)}"
+  end
+
+  # ========================================================================= #
+  # === report_the_average_amount_of_ects_per_passed_exam
+  # ========================================================================= #
+  def report_the_average_amount_of_ects_per_passed_exam(
+      ects_per_exams_passed = calculate_the_average_amount_per_passed_exam,
+      ljust_n_times         = 76,
+      rjust_n_times         = 12
+    )
+    if ljust_n_times == :default
+      ljust_n_times = 76
+    end
+    left_padded_side = "On average, the "\
+                       "#{slategray('ECTS per passed exam')} "\
+                       "are: ".ljust(ljust_n_times)
+    e left_padded_side+
+       sfancy(
+         (ects_per_exams_passed.to_s+' ECTS').rjust(rjust_n_times)
+       )
+  end
+
+  # ========================================================================= #
+  # === show_the_summary
+  #
+  # To use this method from the commandline, do:
+  #
+  #   emo --summary
+  #
+  # ========================================================================= #
+  def show_the_summary
+    determine_n_ects_points_in_total
+    determine_n_exams_in_total_were_passed
+    determine_n_hours_were_passed_in_total # <- How many hours were passed in total.
+    # ======================================================================= #
+    # Next report our findings:
+    # ======================================================================= #
+    report_how_many_exams_were_passed_in_total(@n_exams_in_total_passed)
+    report_how_many_hours_were_passed_in_total
+    report_how_many_ects_points_have_been_gathered_so_far
+    if @show_average_ects_passed_per_exam
+      report_the_average_amount_of_ects_per_passed_exam
+    end
+    report_the_average_grade
+  end; alias show_only_the_summary show_the_summary # === show_only_the_summary
+
+  # ========================================================================= #
+  # === determine_n_hours_were_passed_in_total
+  # ========================================================================= #
+  def determine_n_hours_were_passed_in_total
+    i = @hash.values.map {|entry| entry[0].to_f }.sum.to_f
+    @n_hours_passed_in_total = i
+  end
+
+  # ========================================================================= #
+  # === report_how_many_exams_were_passed_in_total
+  # ========================================================================= #
+  def report_how_many_exams_were_passed_in_total(
+      i             = @n_exams_in_total_passed,
+      ljust_n_times = 76,
+      n_rjust       =  4
+    )
+    if ljust_n_times == :default
+      ljust_n_times = 76
+    end
+    e (
+        "In total, #{slategray('n exams')} have been passed:"
+      ).ljust(ljust_n_times)+
+      sfancy(i.to_s.rjust(n_rjust))
+  end
+
+  # ========================================================================= #
+  # === report_how_many_hours_were_passed_in_total
+  #
+  # This method will report how many hours were passed in total.
+  # ========================================================================= #
+  def report_how_many_hours_were_passed_in_total(
+      i       = @n_hours_passed_in_total,
+      n_ljust = 76,
+      n_rjust =  6
+    )
+    if n_ljust == :default
+      n_ljust = 76
+    end
+    left_side_string = "In total, #{slategray('n hours')} were completed: ".ljust(n_ljust)
+    # ======================================================================= #
+    # Since as of 04.03.2020 the result is rounded, since otherwise the
+    # display may include parts such as "00001", which we don't want here.
+    # ======================================================================= #
+    i = i.round(1) if i.is_a? Float
+    e left_side_string+
+       sfancy(i.to_s.rjust(n_rjust))
+  end
+
+end; end