studium 0.9.383

data/lib/studium/colours/sfancy.rb

@@ -0,0 +1,38 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module Studium
+
+module Colours # === Studium::Colours
+
+  # ========================================================================= #
+  # === Studium::Colours.sfancy
+  #
+  # To test this method e. g. in IRB, do:
+  #
+  #   puts Studium::Colours.sfancy("yo there")
+  #
+  # ========================================================================= #
+  def self.sfancy(i = '')
+    return ::Colours.sfancy(i) if Colours.use_colours?
+    i
+  end
+
+  # ========================================================================= #
+  # === sfancy
+  # ========================================================================= #
+  def sfancy(i)
+    ::Studium::Colours.sfancy(i)
+  end
+
+end
+
+# =========================================================================== #
+# === Studium.sfancy
+# =========================================================================== #
+def self.sfancy(i)
+  ::Studium::Colours.sfancy(i)
+end
+
+end

data/lib/studium/colours/sfile.rb

@@ -0,0 +1,35 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'studium/colours/sfile.rb'
+# =========================================================================== #
+module Studium
+
+module Colours # === Studium::Colours
+
+  # ========================================================================= #
+  # === Studium::Colours.sfile
+  # ========================================================================= #
+  def self.sfile(i = '')
+    return ::Colours.sfile(i) if Colours.use_colours?
+    return i
+  end
+
+  # ========================================================================= #
+  # === sfile
+  # ========================================================================= #
+  def sfile(i = '')
+    ::Studium::Colours.sfile(i)
+  end
+
+end
+
+# =========================================================================== #
+# === Studium.sfile
+# =========================================================================== #
+def self.sfile(i)
+  ::Studium::Colours.sfile(i)
+end
+
+end

data/lib/studium/colours/simp.rb

@@ -0,0 +1,38 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module Studium
+
+module Colours # === Studium::Colours
+
+  # ========================================================================= #
+  # === Studium::Colours.simp
+  #
+  # To test this method e. g. in IRB, do:
+  #
+  #   puts Studium::Colours.simp("yo there")
+  #
+  # ========================================================================= #
+  def self.simp(i)
+    return ::Colours.simp(i) if Colours.use_colours?
+    i
+  end
+
+  # ========================================================================= #
+  # === simp
+  # ========================================================================= #
+  def simp(i)
+    ::Studium::Colours.simp(i)
+  end
+
+end
+
+# =========================================================================== #
+# === Studium.simp
+# =========================================================================== #
+def self.simp(i)
+  ::Studium::Colours.simp(i)
+end
+
+end

data/lib/studium/commandline/commandline.rb

@@ -0,0 +1,121 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Studium::Commandline
+#
+# This class handles input passed from the commandline, into the executable
+# called bin/studium, which acts as the "central entry point" to this
+# project, if it is related to the commandline. 
+#
+# Usage example:
+#
+#   Studium::Commandline.new(ARGV)
+#
+# =========================================================================== #
+# require 'studium/commandline/commandline.rb'
+# =========================================================================== #
+require 'studium/base/base.rb'
+require 'studium/constants/file_constants.rb'
+require 'studium/commandline/menu.rb'
+require 'studium/toplevel_methods/save_this_delay_between_questions_and_answers.rb'
+require 'studium/toplevel_methods/verbose_truth.rb'
+require 'studium/toplevel_methods/report_how_many_exam_questions_were_already_solved.rb'
+require 'studium/exams/questions_solved_from_day_to_day.rb'
+require 'studium/exams/upload_exam_topics.rb'
+
+module Studium
+
+class Commandline < Base # === Studium::Commandline
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+# ========================================================================= #
+# === return_original_input_as_string
+# ========================================================================= #
+def return_original_input_as_string
+  @input.join(' ').strip
+end
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      i           = nil,
+      run_already = true
+    )
+    reset
+    set_input(i)
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+    # ======================================================================= #
+    # === @namespace
+    # ======================================================================= #
+    @namespace = NAMESPACE
+  end
+
+  # ========================================================================= #
+  # === set_input
+  # ========================================================================= #
+  def set_input(i = '')
+    i = [i] unless i.is_a? Array
+    @input = i
+  end
+
+  # ========================================================================= #
+  # === input?
+  # ========================================================================= #
+  def input?
+    @input
+  end
+
+  # ========================================================================= #
+  # === start_gui_component
+  #
+  # Use this method to start the gui/gtk component of the Studium project.
+  # ========================================================================= # 
+  def start_gui_component
+    unless ::Studium.const_defined? :GUI
+      require 'studium/gui/gtk/simple_widget_question_answer.rb'
+    end
+    Studium::GUI::Gtk::SimpleWidgetQuestionAnswer.run_as_standalone_gtk_window
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    check_the_original_input_against_the_menu(return_original_input_as_string)
+    check_the_input_against_the_menu
+  end
+
+  # ========================================================================= #
+  # === Studium::Commandline[]
+  # ========================================================================= #
+  def self.[](i = '')
+    new(i)
+  end
+
+end
+
+# =========================================================================== #
+# === Studium.parse_commandline
+# =========================================================================== #
+def self.parse_commandline(i = ARGV)
+  ::Studium::Commandline.new(i)
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  Studium::Commandline.new(ARGV)
+end # studium_commandline --help

data/lib/studium/commandline/fast_commandline_options.rb

@@ -0,0 +1,994 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Studium::FastCommandlineOptions
+#
+# The sole purpose of this class is to make use of commandline options
+# that are faster than the older class called Studium::Commandline.
+#
+# In the long run it would be best to re-arrange the code in such a way
+# that ALL of the commandline operations would be fast - but for the
+# time being, we will simply try to make the listed entries fast.
+# =========================================================================== #
+# require 'studium/commandline/fast_commandline_options.rb'
+# =========================================================================== #
+require 'studium/base/minimal_prototype.rb'
+require 'studium/base/src_dir_at_home.rb'
+require 'studium/base/editor.rb'
+require 'studium/constants/file_constants.rb'
+require 'studium/constants/exam_topics.rb'
+require 'studium/commandline/help.rb'
+require 'studium/ects/return_n_ects_from_this_file.rb'
+require 'studium/toplevel_methods/is_on_roebe.rb'
+
+module Studium
+
+class FastCommandlineOptions < Base # === Studium::FastCommandlineOptions
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(i)
+    reset
+    menu(i)
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    super()
+    # ======================================================================= #
+    # === @namespace
+    # ======================================================================= #
+    @namespace = NAMESPACE
+  end
+
+  # ========================================================================= #
+  # === show_percentage_achieved
+  #
+  # Invoke this like so:
+  #
+  #   studium --percentage-achieved
+  #
+  # ========================================================================= #
+  def show_percentage_achieved
+    unless Studium.const_defined? :PercentageAchieved
+      require 'studium/utility_scripts/percentage_achieved.rb'
+    end
+    Studium::PercentageAchieved.new
+  end
+
+  # ========================================================================= #
+  # === show_yearly_average_grades
+  #
+  # Invocation example:
+  #
+  #   studium --yearly-average-grades
+  #
+  # ========================================================================= #
+  def show_yearly_average_grades
+    # ======================================================================= #
+    # Must delegate towards Studium::ExamsPerMonth in this case.
+    # ======================================================================= #
+    require 'studium/exams_per_month/exams_per_month.rb'
+    Studium::ExamsPerMonth.new(:dont_run_yet) { '--yearly-average-grades' }
+  end
+
+  # ========================================================================= #
+  # === eparse
+  #
+  # The colours for this method are defined within the method body.
+  # ========================================================================= #
+  def eparse(i)
+    token = '#'
+    if i.include? token
+      splitted = i.split(token)
+      splitted[-1] = olive(splitted[-1])
+      i = splitted.join(royalblue(token))
+    end
+    e i
+  end
+
+  # ========================================================================= #
+  # === verbose_set_this_dir_to_exam_topics
+  # ========================================================================= #
+  def verbose_set_this_dir_to_exam_topics(match)
+    e 'Now setting to a new directory for the exam topics, at:'
+    e "  #{sdir(match)}"
+    ::Studium.permanenty_set_directory_to_the_exam_topics(match)
+  end
+
+  # ========================================================================= #
+  # === verbose_set_this_new_log_dir
+  # ========================================================================= #
+  def verbose_set_this_new_log_dir(match)
+    e 'Now setting to a new log-directory for the Studium project, at:'
+    e "  #{sdir(match)}"
+    ::Studium.permanenty_set_log_directory_to_this_entry(match)
+  end
+
+  # ========================================================================= #
+  # === return_original_input_as_string
+  # ========================================================================= #
+  def return_original_input_as_string
+    @input.join(' ').strip
+  end
+
+  # ========================================================================= #
+  # === show_best_month
+  #
+  # To invoke this, try:
+  #
+  #   studium --show-best-month
+  #
+  # ========================================================================= #
+  def show_best_month(i = 10)
+    require 'studium/exams_per_month/exams_per_month.rb'
+    _ = Studium::ExamsPerMonth.new(:do_not_run_yet)
+    _.sanitize_dataset
+    _.show_best_months(i)
+  end
+
+  # ========================================================================= #
+  # === show_how_many_exams_were_passed
+  #
+  # This method will tell us how many exams were passed.
+  #
+  # Commandline invocation example:
+  #
+  #   studium --show_how_many_exams_were_passed
+  #
+  # ========================================================================= #
+  def show_how_many_exams_were_passed
+    require 'studium/toplevel_methods/report_how_many_exam_questions_were_already_solved.rb'
+    Studium::Exams.report_how_many_exam_questions_were_already_solved
+  end
+
+  # ========================================================================= #
+  # === start_a_new_exam_day
+  # ========================================================================= #
+  def start_a_new_exam_day
+    require 'studium/log/store_last_question_asked_into_file.rb'
+    Studium::Log::StoreLastQuestionAskedIntoFile.reset_file
+  end
+
+  # ========================================================================= #
+  # === show_n_ects_from_this_file
+  # ========================================================================= #
+  def show_n_ects_from_this_file(i)
+    if File.exist? i
+      e royalblue(
+          Studium.return_n_ects_from_this_file(i).to_s+' ECTS points'
+        )
+    else
+      no_file_exists_at(i)
+    end
+  end
+
+  # ========================================================================= #
+  # === show_passed_ects_in_the_individual_bachelor_and_master_curricula
+  # ========================================================================= #
+  def show_passed_ects_in_the_individual_bachelor_and_master_curricula
+    require 'studium/toplevel_methods/show_passed_ects_in_the_individual_bachelor_and_master_curricula.rb'
+    Studium.show_passed_ects_in_the_individual_bachelor_and_master_curricula
+  end
+
+  # ========================================================================= #
+  # === check_the_lecture_information_file
+  # ========================================================================= #
+  def check_the_lecture_information_file
+    require 'studium/check/check_the_lecture_information_file.rb'
+    Studium.check_the_lecture_information_file
+  end
+
+  # ========================================================================= #
+  # === show_ects_passed_per_university
+  # ========================================================================= #
+  def show_ects_passed_per_university
+    require 'studium/ects/ects_per_university.rb'
+    Studium::EctsPerUniversity.new
+  end
+
+  # ========================================================================= #
+  # === show_the_base_dir
+  # ========================================================================= #
+  def show_the_base_dir
+    e
+    e '  '+sfile(
+      File.expand_path(
+        File.read(FILE_LOG_DIR).chomp
+      )
+    )
+    e
+  end
+
+  # ========================================================================= #
+  # === show_maximum_amount_of_questions_ever_answered
+  # ========================================================================= #
+  def show_maximum_amount_of_questions_ever_answered
+    require 'studium/exams/questions_solved_from_day_to_day.rb'
+    _ = Studium::Exams::QuestionsSolvedFromDayToDay.return_maximum_amount_of_questions_ever_answered
+    opnn; e "The maximum amount of exam-questions ever answered was `"\
+            "#{sfancy(_)}`."
+  end
+
+  # ========================================================================= #
+  # === verbose_update_max_ever
+  # ========================================================================= #
+  def verbose_update_max_ever
+    require 'studium/exams/questions_solved_from_day_to_day.rb'
+    e "#{rev}Now updating the max-ever entry of all exam-questions "\
+      "that were answered."
+    Studium.update_max_ever_exam_questions_answered
+  end
+
+  # ========================================================================= #
+  # === rev
+  # ========================================================================= #
+  def rev
+    ::Colours.rev
+  end
+
+  # ========================================================================= #
+  # === show_where_the_exam_topics_can_be_found
+  # ========================================================================= #
+  def show_where_the_exam_topics_can_be_found
+    e
+    e 'The exam topics can be found here:'
+    e
+    e  "  #{sdir(Studium.exam_topics?)}"
+    e
+  end
+
+  # ========================================================================= #
+  # === show_exam_statistics
+  #
+  # This method will show some exam-statistics, if the file specified at
+  # FILE_STATISTICS can be found. If it is found, the content will be
+  # displayed, but we will also colourize a bit, to make the display easier
+  # to read.
+  #
+  # To invoke this method, do:
+  #
+  #   studium --examstats
+  #
+  # ========================================================================= #
+  def show_exam_statistics
+    require 'studium/toplevel_methods/show_exam_statistics.rb'
+    ::Studium.show_exam_statistics
+  end
+
+  # ========================================================================= #
+  # === open_the_statistics_file
+  # ========================================================================= #
+  def open_the_statistics_file
+    e
+    cmd = "bluefish #{::Studium.file_statistics} &"
+    if ::Studium.is_on_roebe?
+      cmd = "bluefish /home/x/DATA/PROGRAMMING_LANGUAGES/RUBY/src/studium/lib/studium/yaml/statistics.yml &"
+    end
+    e cmd
+    e
+    system cmd
+  end
+
+  # ========================================================================= #
+  # === show_all_exams_at_this_university
+  #
+  # To invoke this method, try:
+  #
+  #   studium --exams-at-the-meduni
+  #
+  # ========================================================================= #
+  def show_all_exams_at_this_university(this_university)
+    require 'studium/utility_scripts/finished_exams_at_this_university.rb'
+    Studium::FinishedExamsAtThisUniversity.new(this_university)
+  end
+
+  # ========================================================================= #
+  # === show_how_many_exam_topics_are_available
+  # ========================================================================= #
+  def show_how_many_exam_topics_are_available
+    require 'studium/toplevel_methods/n_topics_available.rb'
+    e rev+'There are '+simp(Studium::Exams.n_topics_available?.to_s)+' '\
+      'topics available.'
+  end
+
+  # ========================================================================= #
+  # === show_backlog_of_exams
+  # ========================================================================= #
+  def show_backlog_of_exams
+    require 'studium/exams/show_backlog_of_exams.rb'
+    Studium::ShowBacklogOfExams.new
+  end
+
+  # ========================================================================= #
+  # === show_max_exam_questions_answered_per_topic
+  # ========================================================================= #
+  def show_max_exam_questions_answered_per_topic
+    _ = FILE_MAX_STATS
+    dataset = YAML.load_file(_)
+    e
+    dataset.each_pair {|key, value|
+      value = value.to_s.rjust(5)
+      e "  #{lightgreen(key+':').ljust(80)} "\
+        "#{steelblue(value)}"
+    }
+    e
+  end
+
+  # ========================================================================= #
+  # === show_available_topics
+  #
+  # Invocation example:
+  #
+  #   studium --topics?
+  #
+  # ========================================================================= #
+  def show_available_topics
+    require 'studium/toplevel_methods/available_topics.rb'
+    e
+    Studium.available_topics?.sort.each_with_index {|entry, index| index += 1
+      padded_index = ('  '+index.to_s+')').ljust(7)
+      e royalblue(padded_index)+
+        steelblue(entry)
+    }
+    e
+  end
+
+  # ========================================================================= #
+  # === show_passed_lectures_in_a_bachelor_curriculum
+  # ========================================================================= #
+  def show_passed_lectures_in_a_bachelor_curriculum
+    require 'studium/exams_per_month/exams_per_month.rb'
+    Studium::ExamsPerMonth.show_passed_bachelor_lectures
+  end
+
+  # ========================================================================= #
+  # === permanently_disable_colours
+  #
+  # To invoke this method, try:
+  #
+  #   studium --permanently-disable-colours
+  #
+  # ========================================================================= #
+  def permanently_disable_colours
+    opnn; e 'The colours in the Studium namespace will be '\
+            'permanently disabled.'
+    into = ::Studium.yaml_directory?+'use_colours.yml'
+    if File.exist? into
+      opnn; e "Storing into the file #{sfile(into)} next."
+      write_what_into(YAML.dump(false), into)
+    end
+  end
+
+  # ========================================================================= #
+  # === do_show_the_average_grade_of_all_passed_exams
+  # ========================================================================= #
+  def do_show_the_average_grade_of_all_passed_exams
+    require 'studium/toplevel_methods/average_grade.rb'
+    e 'The average grade of all passed exams is '+
+       sfancy(
+         Studium.average_grade(:default, round_to: 2 )
+       )+'.'
+  end
+
+  # ========================================================================= #
+  # === show_passed_ects_per_year
+  # ========================================================================= #
+  def show_passed_ects_per_year
+    require 'studium/utility_scripts/passed_ects_per_year.rb'
+    Studium.passed_ects_per_year
+  end
+
+  # ========================================================================= #
+  # === do_show_the_inscription_dates_at_the_different_universities
+  # ========================================================================= #
+  def do_show_the_inscription_dates_at_the_different_universities
+    _ = YAML.load_file(Studium.project_yaml_dir?+'inscription_dates_of_universities.yml')
+    e
+    _.each_pair {|key, value|
+      if value.is_a? Array
+        value = value.first
+      end
+      university = key.ljust(40)
+      e '  '+
+        royalblue(university)+' '+
+        steelblue(value)
+    }
+    e
+  end
+
+  # ========================================================================= #
+  # === show_passed_lectures_in_a_master_curriculum
+  #
+  # Use this method if you want to see which lectures have been passed
+  # in a master curriculum.
+  #
+  # To invoke this method from the commandline, try:
+  #
+  #   studium --master_curricula
+  #
+  # ========================================================================= #
+  def show_passed_lectures_in_a_master_curriculum
+    require 'studium/exams_per_month/exams_per_month.rb'
+    Studium::ExamsPerMonth.show_passed_master_lectures
+  end
+
+  # ========================================================================= #
+  # === show_timetable
+  #
+  # Invocation example:
+  #
+  #   studium --timetable
+  #
+  # ========================================================================= #
+  def show_timetable
+    require 'studium/requires/require_upcoming_exams.rb'
+    Studium::Exams::UpcomingExams.new
+  end
+
+  require 'studium/toplevel_methods/editor.rb'
+  # ========================================================================= #
+  # === permanently_set_this_editor
+  # ========================================================================= #
+  def permanently_set_this_editor(i)
+    Studium.permanently_set_this_editor(i)
+  end
+
+  # ========================================================================= #
+  # === show_curricula
+  # ========================================================================= #
+  def show_curricula(
+      use_this_file = FILE_CURRICULA
+    )
+    e
+    e 'The available curricula are:'
+    e
+    YAML.load_file(use_this_file).each_pair {|id_of_the_curriculum, inner_array|
+      name_of_the_curriculum = inner_array.first
+      e '  '+
+        orange(id_of_the_curriculum.ljust(8))+' → '+
+        slateblue(name_of_the_curriculum)
+    }
+    e
+  end
+
+  # ========================================================================= #
+  # === menu                                                       (menu tag)
+  # ========================================================================= #
+  def menu(i)
+    if i.is_a? Array
+      i.each {|entry| menu(entry) }
+    else
+      case i # case tag
+      # ===================================================================== #
+      # === studium --curricula
+      # === studium --show-curricula
+      # ===================================================================== #
+      when /^-?-?curricula$/i,
+           /^-?-?show(-|_)?curricula$/i
+        show_curricula
+      # ===================================================================== #
+      # === studium --set-editor=vim
+      # ===================================================================== #
+      when /^-?-?set(-|_)?editor=(.+)$/i
+        permanently_set_this_editor($2.to_s.dup)
+      # ===================================================================== #
+      # === studium --timetable
+      # ===================================================================== #
+      when /^-?-?timetable$/
+        show_timetable
+        exit
+      # ===================================================================== #
+      # === studium --open
+      # ===================================================================== #
+      when /-?-?open$/i
+        open_useful_files_via_the_default_editor
+        exit
+      # ===================================================================== #
+      # === studium --inskriptionsfrist
+      # ===================================================================== #
+      when /^-?-?inskriptionsfrist$/i
+        do_show_the_inscription_dates_at_the_different_universities
+      # ===================================================================== #
+      # === studium --master_curricula
+      # ===================================================================== #
+      when /^-?-?master(-|_)?curricula$/i,
+           /^-?-?master$/i
+        show_passed_lectures_in_a_master_curriculum
+        exit
+      # ===================================================================== #
+      # === studium --average-grade
+      # ===================================================================== #
+      when /^-?-?average(-|_)?grade$/i
+        do_show_the_average_grade_of_all_passed_exams
+      # ===================================================================== #
+      # === studium --passed-ects-per-year
+      # ===================================================================== #
+      when /^-?-?passed(-|_)?ects(-|_)?per(-|_)?year$/i
+        show_passed_ects_per_year
+      # ===================================================================== #
+      # === studium --max-ever
+      # ===================================================================== #
+      when /^-?-?max(-|_)?ever\??$/,
+           /^-?-?max(-|_)?answers\??$/,
+           /^-?-?max(-|_)?stats\??$/,
+           /^-?-?max(-|_)?statistics\??$/,
+           /^-?-?max(-|_)?questions(-|_)?answered\??$/, # studium --max-questions-answered
+           /^-?-?daily$/i
+        show_maximum_amount_of_questions_ever_answered
+        exit
+      # ===================================================================== #
+      # === studium --disable-colours
+      # ===================================================================== #
+      when /^-?-?disable(_|-)?colours$/i,
+           /^-?-?permanently(_|-)?disable(_|-)?colours$/i
+        permanently_disable_colours
+      # ===================================================================== #
+      # === studium --colours?
+      # ===================================================================== #
+      when /-?-?colours\??/
+        e 'Does the Studium project use colours, right now? '+
+          sfancy(Studium.yes_or_no(Studium.use_colours?.to_s))
+      # ===================================================================== #
+      # === studium set-delay=5
+      # ===================================================================== #
+      when /set(_|-)?delay=(.+)/ # studium set-delay=2.6
+        ::Studium.save_this_delay_between_questions_and_answers($2.to_s.dup)
+      # ===================================================================== #
+      # === studium set_log_dir=/Depot/j/
+      # ===================================================================== #
+      when /-?-?set(_|-)?log(_|-)?dir=(.+)/
+        match = $3.to_s.dup
+        verbose_set_this_new_log_dir(match)
+      # ===================================================================== #
+      # === studium --upcoming_exams_at_the_boku
+      # ===================================================================== #
+      when /upcoming_?exams_?at_?the_?boku/
+        show_upcoming_exams_at_the_boku
+      # ===================================================================== #
+      # === studium --last-question?
+      # ===================================================================== #
+      when /^-?-?last(_|-)?question\??$/i
+        require 'studium/constants/last_question_asked.rb'
+        _ = Studium.file_last_question_asked?
+        if File.exist? _
+          e File.read(_)
+        else
+          no_file_exists_at(_)
+        end
+      # ===================================================================== #
+      # === studium --bachelor_curricula
+      # ===================================================================== #
+      when /^-?-?bachelor(-|_)?curricula$/i,
+           /^-?-?bachelor$/i
+        show_passed_lectures_in_a_bachelor_curriculum
+        exit
+      # ===================================================================== #
+      # === studium --topics?
+      # ===================================================================== #
+      when /^-?-?topics\??$/i
+        show_available_topics
+      # ===================================================================== #
+      # === studium --max-per-topic?
+      # ===================================================================== #
+      when /^-?-?max(_|-)?per(_|-)?topic\??$/i,
+           /^-?-?max(_|-)?exams(_|-)?answered(_|-)?per(_|-)?topic\??$/i
+        show_max_exam_questions_answered_per_topic
+      # ===================================================================== #
+      # === studium --examstats
+      # ===================================================================== #
+      when /-?-?exam(_|-)?stats$/,
+           /-?-?exam(_|-)?statistics/,
+           /^-?-?statistics\??$/i,
+           /^-?-?statistik\??$/i,
+           /^-?-?stats$/i
+        require 'studium/toplevel_methods/show_exam_statistics.rb'
+        Studium.show_exam_statistics
+        exit
+      # ===================================================================== #
+      # === studium --n-topics-available?
+      # ===================================================================== #
+      when /^-?-?n(_|-)?topics(_|-)?available\??/,
+           /^-?-?n-?topics\??/
+        show_how_many_exam_topics_are_available
+      # ===================================================================== #
+      # === studium --exam_topics?
+      # ===================================================================== #
+      when /-?-?exam(_|-)?topics\??/
+        show_where_the_exam_topics_can_be_found
+      # ===================================================================== #
+      # === studium --generate-pdf-for=amg1
+      # === studium --pdf-for=pharma
+      # === studium --make-pdf-for=syszoo
+      # ===================================================================== #
+      when /^-?-?generate(-|_)?pdf(-|_)?for=(.+)$/i, # for $3
+           /^-?-?make(-|_)?pdf(-|_)?for=(.+)$/i,     # for $3
+           /^-?-?pdf(-|_)?for=(.+)$/i                # for $2
+        this_topic = $2.to_s.dup
+        this_topic = $3.to_s.dup if $3
+        Studium.create_pdf_file_for_this_exam_topic(this_topic) # bl $RUBY_STUDIUM/pdf/create_pdf_file_for_this_exam_topic.rb
+      # ===================================================================== #
+      # === studium --max?
+      # ===================================================================== #
+      when /-?-?max\??$/,
+           /-?-?show(_|-)?how(_|-)?many(_|-)?exams(_|-)?were(_|-)?passed$/,
+           /^-?-?top$/i # ← This should always be on top of this file here.
+        show_how_many_exams_were_passed
+        exit
+      # ===================================================================== #
+      # === studium --sinatra
+      #
+      # This entry point starts the sinatra-part of the Studium project.
+      # ===================================================================== #
+      when /^-?-?sinatra$/
+        require 'studium/www/sinatra_main_entry.rb'
+        Studium.start_sinatra_interface
+        exit
+      # ===================================================================== #
+      # === studium --backlog-of-exams
+      # ===================================================================== #
+      when /^-?-?backlog(-|_)?of(-|_)?exams$/i
+        show_backlog_of_exams
+      # ===================================================================== #
+      # === studium --log-dir?
+      # ===================================================================== #
+      when /(_|-)?(_|-)?log(_|-)?dir\??/i
+        e
+        e "  #{sfile(FILE_LOG_DIR)}"
+        e
+      # ===================================================================== #
+      # === studium --statistics?
+      # ===================================================================== #
+      when /^-?-?statistics\??$/i,
+           /^-?-?stats\??$/i
+        require 'studium/curricula/determine_curricula/determine_curricula.rb'
+        Studium.determine_curricula
+      # ===================================================================== #
+      # === studium --open-statistics
+      # ===================================================================== #
+      when /^-?-?open(-|_)?the(-|_)?statistics$/,
+           /^-?-?open(-|_)?the(-|_)?statistics(-|_)?file$/,
+           /^-?-?open(-|_)?statistics$/,
+           /^-?-?open(-|_)?stats$/
+        open_the_statistics_file
+        exit
+      # ===================================================================== #
+      # === studium --exams-at-the-meduni
+      # ===================================================================== #
+      when /(-|_)?(-|_)?exams(-|_)?at(-|_)?the(-|_)?(.+)$/
+        this_university = $6.to_s.dup.downcase
+        show_all_exams_at_this_university(this_university)
+      # ===================================================================== #
+      # === studium --update-max-questions
+      #
+      # This will also update the max questions ever.
+      # ===================================================================== #
+      when /^-?-?update(-|_)?max(-|_)?questions$/
+        require 'studium/statistics/report_how_many_exam_questions_were_answered.rb'
+        Studium::Statistics::ReportHowManyExamQuestionsWereAnswered.new
+        exit
+      # ===================================================================== #
+      # === studium --update--max-ever
+      #
+      # This entry point can be used to update various things, but most
+      # importantly, updating the "max-ever query".
+      # ===================================================================== #
+      when /^-?-?update(-|_)?max(-|_)?ever$/,
+           /^-?-?update$/,
+           /^-?-?update(-|_)?statistics$/,
+           /^-?-?record$/,
+           /^-?-?save$/,
+           /^-?-?update(-|_)?examstats$/         # === studium --update-examstats
+        verbose_update_max_ever
+        exit
+      # ===================================================================== #
+      # === studium --solved
+      # ===================================================================== #
+      when /^-?-?solved$/
+        require 'studium/exams/exams.rb'
+        _ = Studium::Exams::Solved.new(ARGV, :dont_run_yet)
+        _.set_commandline
+        _.run
+      # ===================================================================== #
+      # === studium --expand-time-range="15.10. - 2.11.2018,"
+      # === studium --expander="15.10. - 2.11.2018,"
+      # === studium --expander="02.02.2020-02.05.2020"
+      # ===================================================================== #
+      when /^-?-?expand(-|_)?time(-|_)?range=(.+)$/,
+           /^-?-?expander=(.+)$/
+        _ = $1.to_s.dup
+        _ = $3.to_s.dup if $3
+        unless Studium.respond_to? :expand_time_range
+          require 'studium/utility_scripts/expand_time_range.rb'
+        end
+        Studium.expand_time_range(_)
+      # ===================================================================== #
+      # === studium --generate-spreadsheet-for=indi3
+      #
+      # Another example:
+      #
+      #   studium --xls-for=indi3
+      #   xls3
+      #
+      # ===================================================================== #
+      when /^-?-?generate(_|-)?spreadsheet(_|-)?for=(.+)$/i, # === $3
+           /^-?-?xls(_|-)?for=(.+)$/i                        # === $2
+        require 'studium/utility_scripts/generate_spreadsheet.rb'
+        _ = $2.to_s.dup
+        _ = $3.to_s.dup if $3
+        Studium::GenerateSpreadsheet.new(_)
+      # ===================================================================== #
+      # === studium --use-this-curriculum=foo.md
+      # ===================================================================== #
+      when /^-?-?use(_|-)?this(_|-)?curriculum=(.+)$/i
+        require 'studium/lectures/show_lectures_on_the_commandline/show_lectures_on_the_commandline.rb'
+        _ = $3.to_s.dup
+        if File.exist? _
+          object = Studium::ShowLecturesOnTheCommandline.new { :do_not_run_yet }
+          dataset = File.readlines(_).reject {|line|
+            line.start_with?('#') or line.strip.empty?
+          }.map {|entry|
+            if entry.include?('#')
+              entry = entry[0 .. (entry.index('#')-1)]
+            end
+            entry.strip.squeeze(' ')
+          }
+          object.clear_old_dataset
+          object.add_to_the_dataset_without_any_further_checks(dataset)
+          object.sanitize_the_dataset
+          object.uniq_the_dataset
+          object.is_not_an_individual_curriculum
+          object.do_all_actions_after_the_main_dataset_was_read_in
+        else
+          e 'No file exists at '+sfile(_)+'.'
+        end
+      # ===================================================================== #
+      # === studium important_exams.yml
+      # ===================================================================== #
+      when /important(_|-)?exams\.?yml$/
+        target = ruby_src_dir_at_home?+'studium/lib/studium/yaml/important_exams.yml'
+        e sfile(target)
+        open_in_editor(target)
+      # ===================================================================== #
+      # === studium --version?
+      # ===================================================================== #
+      when /^-?-?version\??$/i
+        require 'studium/version/version.rb'
+        e sfancy(
+            Studium.return_version_and_last_update
+          )
+      # ===================================================================== #
+      # === studium --n-entries-in-the-file-lecture-information
+      # === studium --n-lectures
+      # ===================================================================== #
+      when /^-?-?n(_|-)?entries(_|-)?in(_|-)?the(_|-)?file(_|-)?lecture(_|-)?information\??$/i,
+           /^-?-?n(_|-)?entries\??$/i,
+           /^-?-?n(_|-)?lectures\??$/i,
+           /^-?-?n(_|-)?lectures(_|-)?registered$/i,
+           /^-?-?n(_|-)?registered(_|-)?lectures$/i,
+           /^-?-?n(_|-)?registered$/i
+        require 'studium/toplevel_methods/report_n_entries_in_the_file_lecture_information.rb'
+        Studium.report_n_entries_in_the_file_lecture_information
+      # ===================================================================== #
+      # === studium --open-top
+      # ===================================================================== #
+      when /^-?-?open(-|_)?top$/i,
+           /^-?-?open(-|_)?last$/i
+        require 'studium/exams/show_backlog_of_exams.rb'
+        Studium::ShowBacklogOfExams.open_the_main_file
+      # ===================================================================== #
+      # === studium --show-english-lectures
+      # === studium --show-german-lectures
+      # ===================================================================== #
+      when /^-?-?show(_|-)?(english)(_|-)?lectures$/,
+           /^-?-?show(_|-)?(german)(_|-)?lectures$/
+        require 'studium/utility_scripts/show_lectures_fitting_to_this_language.rb'
+        seek_lectures_for_this_language = $2.to_s.dup
+        ShowLecturesFittingToThisLanguage.new(seek_lectures_for_this_language)
+      # ===================================================================== #
+      # === studium --n-ects-from-this-file=ECTS.md
+      # ===================================================================== #
+      when /^-?-?n(-|_)?ects(-|_)?from(-|_)?this(-|_)?file=(.+)$/i, # === $5
+           /^-?-?ects(-|_)?from=(.+)$/i # === $2
+        _ = $2.to_s.dup if $2
+        _ = $5.to_s.dup if $5
+        show_n_ects_from_this_file(_)
+      # ===================================================================== #
+      # === studium --last-questions
+      # ===================================================================== #
+      when /^-?-?last(_|-)?questions$/i
+        require 'studium/log/store_last_question_asked_into_file.rb'
+        _ = Studium::Log::StoreLastQuestionAskedIntoFile.new {
+          :do_not_run_yet
+        }.return_path_to_the_file_all_exam_questions_asked
+        e File.read(_)
+      # ===================================================================== #
+      # === studium --start-a-new-exam-day
+      #
+      # This entry point can be used to "reset" the file that keeps track
+      # of which exams have been used.
+      # ===================================================================== #
+      when /-?-?start(_|-)?a(_|-)?new(_|-)?exam(_|-)?day$/i,
+           /-?-?clear(_|-)?last(_|-)?questions$/i,
+           /^-?-?clear(_|-)?old(_|-)?file$/i,
+           /^-?-?clear(_|-)?file$/i
+        start_a_new_exam_day
+        exit
+      # ===================================================================== #
+      # === studium --base-dir?
+      # ===================================================================== #
+      when /^-?-?base(_|-)?dir\??/,
+           /^-?-?dir\??$/
+        show_the_base_dir
+      # ===================================================================== #
+      # === studium --universities
+      # ===================================================================== #
+      when /^-?-?universities$/i
+        show_ects_passed_per_university
+        exit
+      # ===================================================================== #
+      # === studium --files?
+      # === studium --show-important-files
+      # ===================================================================== #
+      when /^-?-?files\??$/i,
+           /^-?-?show(_|-)?important(_|-)?files\??$/i
+        require 'studium/toplevel_methods/show_important_files.rb'
+        ::Studium.show_important_files
+      # ===================================================================== #
+      # === studium --open-timetable
+      # ===================================================================== #
+      when /-?-?open(-|_)?timetable$/i
+        open_timetable
+        exit
+      # ===================================================================== #
+      # === studium --check-the-lecture-information-file
+      # ===================================================================== #
+      when /-?-?check(-|_)?the(-|_)?lecture(-|_)?information(-|_)?file$/,
+           /-?-?check(-|_)?file(-|_)?information$/
+        check_the_lecture_information_file
+      # ===================================================================== #
+      # === studium --ects-bachelor-master
+      # ===================================================================== #
+      when /^-?-?ects(_|-)?bachelor(_|-)?master$/,
+           /^-?-?bachelor(_|-)?master$/,
+           /^-?-?bm$/ # studium --bm
+        show_passed_ects_in_the_individual_bachelor_and_master_curricula
+      # ===================================================================== #
+      # === studium --best-month
+      # ===================================================================== #
+      when /^-?-?best-month$/,
+           /^-?-?best(_|-)?month(_|-)?stats$/,
+           /^-?-?show(_|-)?best(_|-)?months?$/,
+           /^-?-?best(_|-)?months?$/
+        show_best_month
+        exit
+      # ===================================================================== #
+      # === studium --audio-stats
+      # ===================================================================== #
+      when /^-?-?audio/
+        require 'studium/utility_scripts/audio_stats.rb'
+        Studium.audio_stats?
+      # ===================================================================== #
+      # === studium --yearly-average-grades
+      # ===================================================================== #
+      when /^-?-?yearly(_|-)?average(_|-)?grades$/,
+           /^-?-?grades$/i
+        show_yearly_average_grades
+        exit
+      # ===================================================================== #
+      # === studium --pachieved
+      # ===================================================================== #
+      when /pachieved/,
+           /percentage(-|_)?achieved/
+        show_percentage_achieved
+        exit
+      # ===================================================================== #
+      # === studium --help
+      #
+      # Displaying help to the user must be a fast operation, so it is
+      # stored in the file here.
+      # ===================================================================== #
+      when /help$/i, /-h$/i
+        show_help
+      # ===================================================================== #
+      # === studium --path-to-file-lecture-information
+      # ===================================================================== #
+      when /^-?-?path(-|_)?to(-|_)?file(-|_)?lecture(-|_)?information$/i
+        show_path_to_the_file_lecture_information
+      else
+        # =================================================================== #
+        # Else we will delegate to the larger class.
+        # =================================================================== #
+        require 'studium/commandline/commandline.rb'
+        ::Studium.parse_commandline(ARGV)
+      end
+    end
+  end
+
+  # ========================================================================= #
+  # === show_path_to_the_file_lecture_information
+  # ========================================================================= #
+  def show_path_to_the_file_lecture_information
+    e
+    e sfancy('  '+Studium::FILE_LECTURE_INFORMATION)
+    e
+  end
+
+  # ========================================================================= #
+  # === open_timetable
+  #
+  # To invoke this method, do:
+  #
+  #   studium --open-timetable
+  #
+  # ========================================================================= #
+  def open_timetable
+    _ = FILE_EXAMS_AT_NON_BOKU_UNIVERSITIES
+    OpenInEditor[_] if File.exist? _
+  end
+
+  # ========================================================================= #
+  # === show_upcoming_exams_at_the_boku
+  # ========================================================================= #
+  def show_upcoming_exams_at_the_boku
+    require 'studium/exams/upcoming_exams_at_the_boku/upcoming_exams_at_the_boku.rb'
+    Studium.show_upcoming_exams_at_the_boku
+  end
+
+  require 'studium/exams/cycle.rb'
+  # ========================================================================= #
+  # === show_collage_of_current_exams
+  #
+  # Invoke this method via:
+  #
+  #   studium --collage?
+  #
+  # ========================================================================= #
+  def show_collage_of_current_exams
+    file = Studium::Exams::Cycle.main_file?
+    array = YAML.load_file(file) 
+    opnn; e 'These entries are currently being tested by class'
+    opnn; e "#{slateblue('Studium::Exams::Cycle')}:"
+    e
+    array.each {|this_exam_topic|
+      e "  #{sfancy(this_exam_topic)}"
+    }
+    e
+  end
+
+  # ========================================================================= #
+  # === open_useful_files_via_the_default_editor
+  #
+  # Invoke this method like so:
+  #
+  #   studium --open
+  #
+  # ========================================================================= #
+  def open_useful_files_via_the_default_editor
+    require 'studium/exams_per_month/open.rb'
+    Studium::ExamsPerMonth.open_main_files_in_the_editor
+  end
+
+end
+
+# =========================================================================== #
+# === Studium.fast_parse_commandline
+# =========================================================================== #
+def self.fast_parse_commandline(i = ARGV)
+  Studium::FastCommandlineOptions.new(i)
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  Studium::FastCommandlineOptions.new(ARGV)
+end