studium 0.13.1

data/lib/studium/exams/exams_per_month/exams_per_month.rb

@@ -0,0 +1,2438 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Studium::ExamsPerMonth
+#
+# This class will display how many exams I have passed per given month.
+#
+# Usage example:
+#
+#   Studium::ExamsPerMonth.new
+#
+# =========================================================================== #
+# require 'studium/exams_per_month/exams_per_month.rb' 
+# =========================================================================== #
+require 'studium/base/base.rb'
+
+module Studium
+
+class ExamsPerMonth < Base # === Studium::ExamsPerMonth 
+
+  require 'studium/toplevel_methods/regexes.rb'
+
+  # ======================================================================= #
+  # === TITLE
+  # ======================================================================= #
+  TITLE = 'Exams per Month'
+
+  # ======================================================================= #
+  # === LAST_YEAR
+  # ======================================================================= #
+  LAST_YEAR = Time.now.year
+
+  # ======================================================================= #
+  # === SHOW_N_BEST_MONTHS
+  #
+  # Determine how many "best months" to show, by default.
+  # ======================================================================= #
+  SHOW_N_BEST_MONTHS = 30
+
+  # ======================================================================= #
+  # === ARRAY_REGISTERED_MONTHS
+  #
+  # The months are stored in both the german and the english language.
+  # ======================================================================= #
+  ARRAY_REGISTERED_MONTHS = %w( 
+    januar
+    februar
+    feb
+    märz
+    april
+    mai
+    juni
+    juli
+    august
+    september
+    oktober
+    november
+    dezember
+
+    january
+    february
+    march
+    april
+    may
+    june
+    july
+    october
+    december
+  )
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      commandline_arguments = nil,
+      run_already           = true
+    )
+    reset
+    case commandline_arguments
+    when :dont_run_yet,
+         :do_not_run_yet
+      run_already = false
+    else
+      set_input(commandline_arguments)
+    end
+    # ======================================================================= #
+    # === Handle blocks next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      case yielded
+      # ===================================================================== #
+      # === --yearly-average-grades
+      # ===================================================================== #
+      when /^-?-?yearly(-|_)?average(-|_)?grades$/
+        sanitize_dataset
+        do_show_yearly_average_grades
+        report
+      end
+    end
+    try_to_require_the_open_gem
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === use_colours?
+  # ========================================================================= #
+  def use_colours?
+    @use_colours
+  end
+
+  # ========================================================================= #
+  # === colour_for_hours
+  #
+  # Mediumorchid is the colour for hours.
+  # ========================================================================= #
+  def colour_for_hours(i)
+    return mediumorchid(i) if @use_colours # Delegate into mediumorchid() here in this file.
+    return i
+  end; alias colourize_hours colour_for_hours # === colourize_hours
+
+  # ========================================================================= #
+  # === colourize_year
+  # ========================================================================= #
+  def colourize_year(i)
+    return swarn(i) if @use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === colourize_month_year
+  #
+  # This method will colourize strings such as '04.2017'.
+  #
+  # The current colour used here is 'goldenrod'.
+  # ========================================================================= #
+  def colourize_month_year(i)
+    return goldenrod(i) if @use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === colourize_ects_points
+  #
+  # No need to check inside this method for konsole support because
+  # we already do so before that.
+  # ========================================================================= #
+  def colourize_ects_points(i)
+    return dodgerblue(i) if @use_colours
+    return i
+  end; alias colourize_ects colourize_ects_points # === colourize_ects
+       alias colour_ects    colourize_ects_points # === colour_ects
+
+  # ========================================================================= #
+  # === colourize_n_exams
+  #
+  # Combound method to allow different colours.
+  # ========================================================================= #
+  def colourize_n_exams(
+      i,
+      use_this_colour = :lightslategray
+    )
+    if use_colours?
+      case use_this_colour # case tag
+      when :lightslategray # This is the default; we will use lightslategray. 
+        i = lightslategray(i)
+      when :oldlace
+        i = oldlace(i)
+      when :mediumseagreen
+        i = mediumseagreen(i)
+      when :papayawhip
+        i = papayawhip(i)
+      end
+    end
+    return i
+  end
+
+  # ========================================================================= #
+  # === obtain_dataset
+  #
+  # The default value for the first argument is FILE_PASSED_EXAMS_PER_MONTH,
+  # which is represented by the method called main_file?.
+  # ========================================================================= #
+  def obtain_dataset(
+      use_this_file = main_file?
+    )
+    set_dataset(
+      raw_dataset?(use_this_file)
+    )
+  end
+
+  # ========================================================================= #
+  # === dataset?
+  # ========================================================================= #
+  def dataset?
+    @dataset
+  end
+
+  # ========================================================================= #
+  # === use_only_master_lectures
+  # ========================================================================= #
+  def use_only_master_lectures
+    set_dataset(
+      dataset?.select {|entry| entry[5].include? 'M' }
+    )
+    reset_main_hash
+    sanitize_dataset(dataset?)
+  end
+
+  # ========================================================================= #
+  # === set_dataset
+  # ========================================================================= #
+  def set_dataset(i)
+    @dataset = i
+  end
+
+  # ========================================================================= #
+  # === raw_dataset?
+  #
+  # This method will return an Array. The Array came from the file
+  # 'passed_exams_per_month.csv'.
+  # ========================================================================= #
+  def raw_dataset?(
+      use_this_file = main_file?
+    )
+    readlines_from_this_input_file(use_this_file).reject! {|entry|
+      entry.start_with? '#'
+    }.map(&:chomp).reject(&:empty?)
+  end
+
+  # ========================================================================= #
+  # === draw_image_with_gruff
+  #
+  # If we wish to draw an image with gruff then we use this method here.
+  # ========================================================================= #
+  def draw_image_with_gruff
+    begin
+      require 'gruff'
+    rescue LoadError; end
+    opnn; e 'Startup of class '+sfancy(self.class.name)+'.'
+    @g = Gruff::Line.new(800)
+    @g.theme_keynote
+    @g.title_font_size = 25
+    @g.title = title?
+    @g.labels = {
+       1 => '25.10.2005',
+      #10 => '13.11.2006',
+      11 => '08.04.2014',
+      20 => Time.now.strftime('%d.%m.%Y') 
+    }
+    @g.data('Amount of exams per month',
+      [
+        274,340,851,1114,1168,1195,1230,
+        1245,1270,1315,1352,2524,2621],
+        'slateblue')
+    @g.minimum_value = 1
+    # Finally, write down the results.
+    store_result
+    open_result_in_gimp
+  end
+
+  # ========================================================================= #
+  # === store_where?
+  # ========================================================================= #
+  def store_where?
+    @store_where
+  end
+
+  # ========================================================================= #
+  # === set_store_where
+  # ========================================================================= #
+  def set_store_where(i)
+    @store_where = i
+  end
+
+  # ========================================================================= #
+  # === store_result
+  # ========================================================================= #
+  def store_result
+    set_store_where '/SOURCE_FILES.png'
+    opnn; e "We will store at `#{sfile(store_where?)}`."
+    @g.write(store_where?)
+  end
+
+  # ========================================================================= #
+  # === title?
+  # ========================================================================= #
+  def title?
+    TITLE
+  end
+
+  # ========================================================================= #
+  # === input?
+  # ========================================================================= #
+  def input?
+    @input
+  end
+
+  # ========================================================================= #
+  # === set_last_year
+  # ========================================================================= #
+  def set_last_year(i = current_year?)
+    @last_year = i
+  end
+
+  # ========================================================================= #
+  # === last_year?
+  # ========================================================================= #
+  def last_year?
+    @last_year
+  end; alias last_year last_year? # === last_year
+
+  # ========================================================================= #
+  # === current_year?
+  # ========================================================================= #
+  def current_year?
+    @current_year
+  end; alias current_year current_year? # === current_year
+
+  # ========================================================================= #
+  # === n_exams_passed?
+  # ========================================================================= #
+  def n_exams_passed?(for_this_year = @current_year)
+    @n_exams_passed
+  end
+
+  # ========================================================================= #
+  # === set_current_year
+  #
+  # This must be an Integer.
+  # ========================================================================= #
+  def set_current_year(
+      i = Time.now.strftime('%Y').to_i
+    )
+    i = i.to_i
+    @current_year = i
+  end
+
+  # ========================================================================= #
+  # === set_input
+  #
+  # The input can be an Array such as ["2013", "2015"], in which case we
+  # will only output certain numbers matching these criteria.
+  # ========================================================================= #
+  def set_input(i = nil)
+    if i.is_a? Array
+      unless i.empty? # We don't care about empty Arrays.
+        # ===================================================================== #
+        # === Determine whether our given input consists of only numbers.
+        # ===================================================================== #
+        only_numbers = i.all? {|number|
+          number.to_s =~ /^\d+$/ # Only numbers.
+        }
+        # ===================================================================== #
+        # If we compare only some numbers, we will check here.
+        # That is the whole point of the above check.
+        # ===================================================================== #
+        if only_numbers
+          @compare_these_numbers = i.map(&:to_i)
+        end
+      end
+      i = i.join(' ').strip
+    end
+    @input = i
+  end
+
+  # ========================================================================= #
+  # === do_show_only_grade_for
+  # ========================================================================= #  
+  def do_show_only_grade_for(
+      i = nil
+    )
+    i = i.to_i if i
+    @show_only_grade_for = i
+  end
+
+  # ========================================================================= #
+  # === do_show_yearly_average_grades
+  # ========================================================================= #
+  def do_show_yearly_average_grades
+    @show_yearly_average_grades = true
+  end
+
+  # ========================================================================= #
+  # === show_ects_points?
+  # ========================================================================= #
+  def show_ects_points?
+    @show_ects_points
+  end
+
+  # ========================================================================= #
+  # === do_show_ects_points
+  # ========================================================================= #
+  def do_show_ects_points
+    @show_ects_points = true # If true then we will show the ECTS points as well.
+  end
+
+  # ========================================================================= #
+  # === output_the_csv_file
+  #
+  # We will either use Cat[], if it is available, or just File.read().
+  # ========================================================================= #
+  def output_the_csv_file
+    e File.read(csv_file?)
+  end
+
+  # ========================================================================= #
+  # === is_this_sommersemester_or_wintersemester?
+  #
+  # This method will return SS or WS, as String.
+  #
+  # The following months are Sommersemester (SS):
+  #
+  #   März, April, Mai, Juni, Juli, August, September (3-9)
+  #
+  # The following months are Wintersemester (WS):
+  #
+  #   Oktober, November, Dezember, Jänner, Februar (10-2)
+  # ========================================================================= #
+  def is_this_sommersemester_or_wintersemester?(i)
+    return_this_string = '' # Default zero.
+    case i.to_i # Need to have an Integer at this point.
+    when 3..9
+      return_this_string = 'SS'
+    when 10,11,12,1,2 # Has to be that way.
+      return_this_string = 'WS'
+    end
+    return return_this_string
+  end
+
+  # ========================================================================= #
+  # === output_colourized_year_and_colourized_hours
+  # ========================================================================= #
+  def output_colourized_year_and_colourized_hours(year)
+    unless @compare_these_numbers and !@compare_these_numbers.include?(year)
+      e colourize_year(year.to_s) # <- This will usually be red.
+      e "                        "\
+        "#{colourize_hours('n hours')}"
+    end
+  end
+
+  # ========================================================================= #
+  # === report_month_year_hours_ects_n_exams_passed_in_this_month
+  # ========================================================================= #
+  def report_month_year_hours_ects_n_exams_passed_in_this_month(
+      month, year, n_hours, n_ECTS, n_exams_passed_in_this_month
+    )
+    result = (
+      colourize_month_year(month.to_s.rjust(2,'0')+'.'+year.to_s)+
+      ':'+(' ' * 13)+ # <- Add n_hours next.
+      colourize_hours(n_hours.to_s.rjust(6))+' '
+    ).dup
+    # ======================================================================= #
+    # Conditionally add n_ECTS next.
+    # ======================================================================= #
+    if show_ects_points?
+      result << colourize_ects('('+n_ECTS.to_f.to_s.rjust(4)+' ECTS points)')
+    end
+    result << colourize_n_exams(' (n exams passed that month: '+
+              n_exams_passed_in_this_month.to_s.rjust(2)+')')
+    e result
+  end
+
+  # ========================================================================= #
+  # === show_help                                                  (help tag)
+  #
+  # To invoke this method, do:
+  #
+  #   emo --help
+  #
+  # ========================================================================= #
+  def show_help
+    left_indent = (' ' * 26)+'# ' # For proper paragraph-indenting.
+    opnn; e 'Currently these options are supported:'
+    e
+    e '  input numbers only to compare years, such as: '
+    e
+    e "        #{sfancy('emo 2013 2015')}"
+    e
+    e '  --disable-colours       # Do not use colours'
+    e '  --gruff                 # draw an image with gruff'
+    e '  --nl                    # show a numbered listing of the '\
+      'passed exams, starting from 1 (== most recent exam)'
+    e '  --only-bachelor         # show only Bachelor exams'
+    e '  --open                  # open the .csv file in the editor'
+    e '  --show                  # show / output the .csv file on '\
+      'the terminal'
+    e '  --semesters             # show the amount of ECTS points passed '\
+      'per (full) semester'
+    e "  --übungen               # show only practical courses that were "\
+      "passed (#{sfancy('--practical')} is an alias to this)"
+    e '  --grades                # show a distribution of my grades (1,2,3,4)'
+    e '  --grade={1,2,3,4,5]     # show only grades that qualify for this'
+    e '  --yearly-average-grades # show the yearly average grades'
+    e '  --year=(dddd)           # show only this specific year, such '\
+      'as "year=2016"; year=1996-2013 is also'
+    e left_indent+'supported; you can also omit --"year" such as '\
+      'in: emo --2005'
+    e '  --master                # show only entries registered in '\
+      'a master curriculum'
+    e '  --boku                  # show only exams at this given '\
+      'university; also works with TU, UniWien etc'
+    e '  --summary               # show only the summary over the '\
+      'exam-dataset'
+    e '  --only-master-lectures  # show only lectures that are part '\
+      'of a (at the least one) master-curriculum.'
+    e '  --show-best-months      # This will show the best 10-'+
+      SHOW_N_BEST_MONTHS.to_s+' months '\
+      'or so, in regards to'
+    e left_indent+'n ECTS points accumulated'
+    e '  --years                 # show only the amount of ECTS '\
+      'passed per year'
+    e '  --month                 # show the month, such as "emo --february"'
+    e '  "since 18.01.2013"      # show only exams past this '\
+      'specified date (in the mandatory format dd.mm.yyyy)'
+    e '  "before 18.01.2013"     # show only exams before this '\
+      'specified date (in the mandatory format dd.mm.yyyy)'
+    e
+    e 'The next options show how many exams were passed already '\
+      'in a given curriculum:'
+    e
+    e '  emo --agrarwissenschaften'
+    e '  emo --lmbt' 
+    e
+  end
+
+  # ========================================================================= #
+  # === menu                                                       (menu tag)
+  # ========================================================================= #
+  def menu(
+      i = input?
+    )
+    case i # case tag
+    # ======================================================================= #
+    # === emo --open
+    # ======================================================================= #
+    when /^-?-?OPEN$/i
+      open_the_main_files_in_the_editor
+      exit
+    # ======================================================================= #
+    # === emo --universities
+    #
+    # This entry point can be used to compare the different universities,
+    # in regards to solved ECTS.
+    # ======================================================================= #
+    when /^-?-?universities$/i,
+         /^-?-?unis$/i
+      show_ects_passed_per_university
+      exit
+    # ======================================================================= #
+    # === emo --boku
+    # ======================================================================= #
+    when /^-?-?boku$/,'BOKU'
+      show_only_exams_at_the_boku
+    # ======================================================================= #
+    # === emo "since 18.08.2013"
+    # ======================================================================= #
+    when /^-?-?since (\d{1,4}\.?\d{0,2}\.?\d{0,4})$/, # See: http://rubular.com/r/JMqr7aw3fs
+         /^-?-?after (\d{1,4}\.?\d{0,2}\.?\d{0,4})$/  # Or:  emo "after 01.10.2018"
+      show_only_exams_past_this_date($1.to_s.dup)
+    # ======================================================================= #
+    # === emo --best-month-stats
+    # ======================================================================= #
+    when /^-?-?best(_|-)?month(_|-)?stats$/,
+         /^-?-?show(_|-)?best(_|-)?months?$/,
+         /^-?-?best(_|-)?months?$/
+      show_best_months
+      exit
+    # ======================================================================= #
+    # === emo --master
+    # ======================================================================= #
+    when /^-?-?master$/
+      @hash.clear
+      use_only_master_lectures
+    # ======================================================================= #
+    # === emo --years
+    # ======================================================================= #
+    when /^-?-?years$/,
+         /^-?-?table/,
+         /^-?-?short$/
+      show_the_years_in_a_short_table_overview
+      exit
+    # ======================================================================= #
+    # === emo --summary
+    # ======================================================================= #
+    when /^-?-?summary$/i
+      e; show_only_the_summary; e
+      exit
+    # ======================================================================= #
+    # === emo --half-split
+    # ======================================================================= #
+    when /--half-split/
+      show_half_split_exams_per_year
+      exit
+    # ======================================================================= #
+    # === emo --nl
+    # ======================================================================= #
+    when /nl/,
+         /^-?-?show(_|-)?numbered(_|-)?exams$/, # Simplified. emo --show-numbered-exams
+         /^-?-?show(_|-)?passed(_|-)?lectures$/i
+      show_numbered_exams
+      exit
+    # ======================================================================= #
+    # === emo --only-bachelor-lectures
+    # ======================================================================= #
+    when /^-?-?only(_|-)?bachelor$/,
+         /^-?-?only(_|-)?bachelor(_|-)?lectures$/,
+         /^-?-?only(_|-)?bachelorcurricula$/,
+         /^-?-?show(_|-)?only(_|-)?bachelor(_|-)?lectures$/,
+         /^-?-?show(_|-)?bachelor(_|-)?lectures$/
+      show_only_bachelor_lectures
+      exit
+    # ======================================================================= #
+    # === emo --only-master-lectures
+    # ======================================================================= #
+    when /^-?-?only(_|-)?master$/,
+         /^-?-?only(_|-)?master(_|-)?lectures$/,
+         /^-?-?only(_|-)?mastercurricula$/,
+         /^-?-?show(_|-)?only(_|-)?master(_|-)?lectures$/,
+         /^-?-?show(_|-)?master(_|-)?lectures$/
+      show_only_master_lectures
+      exit
+    # ======================================================================= #
+    # === emo --nocol
+    # ======================================================================= #
+    when /-?-?disable-?colours/,
+         /-?-?nocolours/,
+         /-?-?dcolours/,
+         /-?-?nocol/
+      disable_colours
+      show_n_exams_passed_per_month
+    # ======================================================================= #
+    # === emo --yearly-average-grades
+    # ======================================================================= #
+    when /^-?-?yearly(_|-)?average(_|-)?grades$/,
+         /^-?-?yearly(_|-)?grades$/
+      do_show_yearly_average_grades
+    # ======================================================================= #
+    # === emo --grades
+    # ======================================================================= #
+    when /-?-?grades/
+      do_show_the_grades_statistics
+      exit
+    # ======================================================================= #
+    # === emo --grade=4
+    # ======================================================================= #
+    when /--grade=(\d+)/
+      do_show_only_grade_for($1.to_s.dup)
+      show_n_exams_passed_per_month
+    # ======================================================================= #
+    # === emo --TU
+    # ======================================================================= #
+    when /-?-?TU$/,
+         /-?-?tu$/,
+         /-?-?tuwien/
+      show_only_exams_at_the_tu
+    # ======================================================================= #
+    # === emo "before 18.08.2013"
+    # ======================================================================= #
+    when /-?-?before (\d{1,4}\.?\d{0,2}\.?\d{0,4})/, # Sync this with the regex including "since".
+         /-?-?until (\d{1,4}\.?\d{0,2}\.?\d{0,4})/
+      show_only_exams_before_this_date($1.to_s.dup)
+    # ======================================================================= #
+    # === emo --year=2016
+    # ======================================================================= #
+    when /-?-?year=(\d+-?\d*)/,
+         /-?-?(\d{4})/,
+         /-?-?(\d{4}-?\d*)/ # See: http://rubular.com/r/JzUhbWSzKx
+      do_show_only_this_year_here($1.to_s.dup)
+    # ======================================================================= #
+    # === emo --uniwien
+    # ======================================================================= #
+    when /-?-?uniwien/,'--uniw',/-?-?wien/,'UNIWIEN','WIEN',
+         /-?-?vienna/
+      show_only_exams_at_the_uniwien
+    # ======================================================================= #
+    # === emo --meduni
+    # ======================================================================= #
+    when /-?-?meduni$/,'--medu','--med','MEDUNI','MED','meduniwien',
+         'meduni'
+      show_only_exams_at_the_meduni
+    # ======================================================================= #
+    # === emo --vetmed
+    # ======================================================================= #
+    when /-?-?vetmed/,'--vet','VET','VETMED'
+      show_only_exams_at_the_vetmed_uni
+    # ======================================================================= #
+    # === emo --only-bachelor
+    # ======================================================================= #
+    when /-?-?only-?bachelor/ # Simplified. Should work for now.
+      show_only_bachelor_exams
+    # ======================================================================= #
+    # === emo --individuell_bachelor
+    # ======================================================================= #
+    when /-?-?(individuell(_|-| )?bachelor)/
+      show_how_many_exams_we_have_passed_in_this_curriculum($1.to_s.dup)
+      exit
+    # ======================================================================= #
+    # === emo --übungen
+    # ======================================================================= #
+    when /-?-?übungen/,
+         /--practical/
+      show_only_practical_courses_that_were_passed_already
+    # ======================================================================= #
+    # === emo --semesters
+    # ======================================================================= #
+    when /-?-?semesters\??/
+      show_exam_ects_points_passed_per_semester
+      exit
+    # ======================================================================= #
+    # === emo --reversed-nl
+    # ======================================================================= #
+    when /-?-?reversed?-?nl/
+      show_numbered_exams(:reversed)
+      exit
+    # ======================================================================= #
+    # === emo --master-lmbt
+    # ======================================================================= #
+    when /-?-?(master-?lmbt)/
+      show_how_many_exams_we_have_passed_in_this_curriculum($1.to_s.dup)
+      exit
+    # ======================================================================= #
+    # === emo --lmbt
+    # ======================================================================= #
+    when /-?-?(lmbt)/,/-?-?(lbt)/
+      show_how_many_exams_we_have_passed_in_this_curriculum($1.to_s.dup)
+      exit
+    # ======================================================================= #
+    # === emo --agrarwissenschaften
+    # ======================================================================= #
+    when /-?-?(agrarwissenschaften)/,/-?-?(AW)/
+      show_how_many_exams_we_have_passed_in_this_curriculum($1.to_s.dup)
+      exit
+    # ======================================================================= #
+    # === emo --show
+    # ======================================================================= #
+    when '--show','--output'
+      output_the_csv_file
+      exit
+    # ======================================================================= #
+    # === emo --help
+    # ======================================================================= #
+    when 'HELP',/^-?-?help$/
+      show_help
+      exit
+    # ======================================================================= #
+    # === emo --gruff
+    # ======================================================================= #
+    when 'gruff','--gruff','image'
+      draw_image_with_gruff # We could also create an image with gruff.
+    else # Else use the default here. (else tag)
+      # ===================================================================== #
+      # === emo /Agrarökolog/
+      # ===================================================================== #
+      if i and i.is_a?(String) and i.start_with?('/') and
+        (i.count('/') > 1) # <-- To check for pseudo-regexes here.
+        use_this_regexp = Regexp.new(i.delete('/'), Regexp::IGNORECASE)
+        Studium.try_to_report_exams_that_match_to_this_regexp(use_this_regexp)
+        exit
+      # ===================================================================== #
+      # === emo --januar
+      # ===================================================================== #
+      elsif i and ARRAY_REGISTERED_MONTHS.include?(i.delete('-').downcase)
+        show_all_exams_from_this_month(i.downcase)
+        exit
+      else # In the past, we used to report here, but since as of May 2017,
+           # we will actually default to the "report" method being called
+           # from within run().
+        # show_n_exams_passed_per_month
+      end
+    end
+  end; alias check_against_menu menu # === check_against_menu
+
+  # ========================================================================= #
+  # === file_lecture_information?
+  #
+  # On Roebe, we will use the file in the home system.
+  # ========================================================================= #
+  def file_lecture_information?(
+      _ = Studium.file_lecture_information
+    )
+    if is_on_roebe?
+      # ===================================================================== #
+      # On roebe we have to modify this a little bit:
+      # ===================================================================== #
+      _ = "#{RUBY_STUDIUM_HOME_DIR}yaml/"\
+          "lecture_information/#{File.basename(_)}"
+    end
+    return _
+  end
+
+  # ========================================================================= #
+  # === main_file?
+  # ========================================================================= #
+  def main_file?
+    self.class.main_file?
+  end
+
+  # ========================================================================= #
+  # === menu_file?
+  # ========================================================================= #
+  def menu_file?
+    self.class.menu_file?
+  end
+
+  # ========================================================================= #
+  # === open_the_curricula_assigned_exams_file_in_the_editor
+  # ========================================================================= #
+  def open_the_curricula_assigned_exams_file_in_the_editor
+    _ = Studium::ExamsPerMonth.curricula_assigned_exams_file?
+    Open.in_editor(_) if File.exist? _
+  end
+
+  # ========================================================================= #
+  # === open_the_main_file_in_the_editor
+  # ========================================================================= #
+  def open_the_main_file_in_the_editor
+    Open.in_editor(main_file?)
+  end
+
+  # ========================================================================= #
+  # === open_the_menu_file_in_the_editor
+  # ========================================================================= #
+  def open_the_menu_file_in_the_editor
+    Open.in_editor(menu_file?)
+  end
+
+  # ========================================================================= #
+  # === open_the_file_lecture_information_in_the_editor
+  # ========================================================================= #
+  def open_the_file_lecture_information_in_the_editor(
+      i = file_lecture_information?
+    )
+    Open.in_editor(i)
+  end
+
+  # ========================================================================= #
+  # === Studium::ExamsPerMonth.open_main_files_in_the_editor
+  #
+  # In the past file_theme_of_exams? was part of the Array defined
+  # below, but as of 26.03.2019 I decided that this file is no
+  # longer useful to me - it will eventually be phased out.
+  #
+  # Invocation example to use this method from the commandline:
+  #
+  #   studium --open
+  #
+  # ========================================================================= #
+  def self.open_main_files_in_the_editor
+    array_open_these_files = [
+      main_file?,
+      curricula_assigned_exams_file?
+    ]
+    unless Object.const_defined? :Open
+      begin
+        require 'open'
+      rescue LoadError; end
+    end
+    array_open_these_files.each {|file|
+      Open.in_editor(file)
+    }
+  end
+
+  # ========================================================================= #
+  # === open_result_in_gimp
+  #
+  # This method is, quite obviously, for image-files.
+  # ========================================================================= #
+  def open_result_in_gimp
+    esystem "gimp #{store_where?} &"
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super() # Initialize the instance variables of the parent-class reset() method.
+    do_show_ects_points
+    infer_the_namespace
+    # ======================================================================= #
+    # === @shall_we_report
+    # ======================================================================= #
+    @shall_we_report         = true # Whether to output anything or not.
+    # ======================================================================= #
+    # === @show_only_grade_for
+    # ======================================================================= #
+    @show_only_grade_for     = nil  # Set the initial state.
+    # ======================================================================= #
+    # === @total_grade
+    # ======================================================================= #
+    @total_grade             = 0
+    # ======================================================================= #
+    # === @n_exams_in_total_passed
+    # ======================================================================= #
+    @n_exams_in_total_passed = 0
+    # ======================================================================= #
+    # === @n_ects_points_belonging_to_mandatory_presence_courses
+    #
+    # The next variable keeps track over how many ECTS points belong to
+    # a "prüfungsimmanente" lecture, aka one requiring mandatory presence.
+    # ======================================================================= #
+    @n_ects_points_belonging_to_mandatory_presence_courses = 0
+    # ======================================================================= #
+    # === @total_ects_points
+    # ======================================================================= #
+    @total_ects_points       = 0 # The total amount of ECTS points per given month.
+    # ======================================================================= #
+    # === @n_ects_points
+    # ======================================================================= #
+    @n_ects_points           = 0 # How many ECTS points this exam has.
+    # ======================================================================= #
+    # === @n_ects_points_in_total
+    # ======================================================================= #
+    @n_ects_points_in_total  = 0 # The total amount of ECTS points altogether.
+    # ======================================================================= #
+    # === @n_hours_passed_in_total
+    # ======================================================================= #
+    @n_hours_passed_in_total = 0 # How many hours of exams did we pass.
+    # ======================================================================= #
+    # === @compare_these_numbers
+    # ======================================================================= #
+    @compare_these_numbers   = nil
+    # ======================================================================= #
+    # === @show_only_this_year
+    # ======================================================================= #
+    @show_only_this_year     = nil
+    # ======================================================================= #
+    # === @use_colours
+    # ======================================================================= #
+    @use_colours             = true # Whether to use colours or not.
+    # ======================================================================= #
+    # === @show_average_ects_passed_per_exam
+    # ======================================================================= #
+    @show_average_ects_passed_per_exam = true
+    # ======================================================================= #
+    # === @show_yearly_average_grades
+    # ======================================================================= #
+    @show_yearly_average_grades = false
+    # ======================================================================= #
+    # === @show_n_best_months
+    # ======================================================================= #
+    @show_n_best_months = SHOW_N_BEST_MONTHS
+    # ======================================================================= #
+    # === @dataset_from_the_file_lecture_information
+    # ======================================================================= #
+    @dataset_from_the_file_lecture_information =
+      return_dataset_from_the_file_lecture_information
+    set_current_year(Time.now.strftime('%Y').to_i)
+    set_last_year
+    reset_main_hash
+    obtain_dataset # This will set the @dataset variable.
+  end
+
+  # ========================================================================= #
+  # === reset_main_hash
+  # ========================================================================= #
+  def reset_main_hash
+    @hash = {}
+    @hash.default = []
+  end
+
+  # ========================================================================= #
+  # === reset_n_hours
+  # ========================================================================= #
+  def reset_n_hours
+    @n_hours_passed_in_total = 0
+  end; alias reset_hours reset_n_hours # === reset_hours
+
+  # ========================================================================= #
+  # === reset_ects_points
+  # ========================================================================= #
+  def reset_ects_points
+    @n_ects_points = 0
+  end; alias reset_ects reset_ects_points # === reset_ects
+
+  # ========================================================================= #
+  # === 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
+    # ======================================================================= #
+    # === :leave_time_entry_alone
+    # ======================================================================= #
+    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
+
+  require 'studium/ects/n_ects_points_in_mandatory_presence_courses.rb'
+  require 'studium/ects/ects_per_university.rb'
+
+  # ========================================================================= #
+  # === 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|
+      next unless this_line.include? '|'
+      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/utility_scripts/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
+
+  # ========================================================================= #
+  # === 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
+
+  # ========================================================================= #
+  # === show_ects_passed_per_university
+  # ========================================================================= #
+  def show_ects_passed_per_university
+    Studium::EctsPerUniversity.new { :sort_by_highest_first }
+  end
+
+  # ========================================================================= #
+  # === open_the_main_files_in_the_editor                          (open tag)
+  #
+  # This method bundles together some other open-related methods. It
+  # should ideally come last in this file here, so that it can be
+  # updated at a later time if my use case has changed.
+  # ========================================================================= #
+  def open_the_main_files_in_the_editor
+    open_the_main_file_in_the_editor
+    open_the_file_lecture_information_in_the_editor
+    # open_the_menu_file_in_the_editor # Not sure if we need this.
+  end
+
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run
+    sanitize_dataset
+    check_against_menu
+    report if @shall_we_report
+  end
+
+  # ========================================================================= #
+  # === Studium::ExamsPerMonth.show_passed_master_lectures
+  # ========================================================================= #
+  def self.show_passed_master_lectures
+    Studium::ExamsPerMonth.new('--show_only_master_lectures')
+  end
+
+  # ========================================================================= #
+  # === Studium::ExamsPerMonth.show_passed_bachelor_lectures
+  # ========================================================================= #
+  def self.show_passed_bachelor_lectures
+    Studium::ExamsPerMonth.new('--show_only_bachelor_lectures')
+  end
+
+  # ========================================================================= #
+  # === Studium::ExamsPerMonth.curricula_assigned_exams_file?
+  # ========================================================================= #
+  def self.curricula_assigned_exams_file?
+    FILE_CURRICULA_ASSIGNED_EXAMS
+  end
+
+  # ========================================================================= #
+  # === Studium::ExamsPerMonth.menu_file?
+  # ========================================================================= #
+  def self.menu_file?
+    MENU_FILE
+  end
+
+  # ========================================================================= #
+  # === ExamsPerMonth.main_file?
+  # ========================================================================= #
+  def self.main_file?
+    FILE_PASSED_EXAMS_PER_MONTH # This is passed_exams_per_month.csv.
+  end
+
+end
+
+# =========================================================================== #
+# === Studium.exams_per_month
+#
+# Easier module-method to instantiate a new ExamsPerMonth object.
+# =========================================================================== #
+def self.exams_per_month2
+  ::Studium::ExamsPerMonth.new
+end; self.instance_eval { alias exams? exams_per_month2 } # === Studium.exams?
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  Studium::ExamsPerMonth.new(ARGV)
+end # examspermonth