studium 0.16.9

data/lib/studium/commandline/commandline.rb

@@ -0,0 +1,1839 @@
+#!/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 the
+# Studium project, if it is related to the commandline. 
+#
+# Usage example:
+#
+#   Studium::Commandline.new(ARGV)
+#
+# =========================================================================== #
+# require 'studium/commandline/commandline.rb'
+# =========================================================================== #
+require 'studium/base/base.rb'
+
+module Studium
+
+class Commandline < Base # === Studium::Commandline
+
+  require 'studium/logging/log_directory.rb'
+  require 'studium/toplevel_methods/report.rb'
+  require 'studium/utility_scripts/pdf/create_pdf_file_for_this_exam_topic.rb'
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      i           = ARGV,
+      run_already = true
+    )
+    reset
+    set_commandline_arguments(i)
+    parse_commandline_arguments_as_a_full_string
+    run if run_already
+  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/questions_solved_from_day_to_day.rb'
+    _ = Studium::Exams::QuestionsSolvedFromDayToDay.return_maximum_amount_of_questions_ever_answered
+    opne "The maximum amount of exam-questions ever answered was `"\
+         "#{sfancy(_)}`."
+    if Studium.is_on_roebe?
+      # ===================================================================== #
+      # Next show the "We already solved xyz questions" line:
+      # ===================================================================== #
+      require 'studium/toplevel_methods/report.rb'
+      Studium::Exams.report_how_many_exam_questions_were_already_solved
+    end
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+    infer_the_namespace
+    try_to_require_the_open_gem
+  end
+
+  # ========================================================================= #
+  # === menu                                                       (menu tag)
+  # ========================================================================= #
+  def menu(
+      i = commandline_arguments?
+    )
+    if i.is_a? Array
+      i.each {|entry| menu(entry) }
+    else
+      case i # case tag
+      # ===================================================================== #
+      # === studium --max-ever
+      # ===================================================================== #
+      when /^-?-?max(-|_| )?ever\??$/,
+           /^-?-?max(-|_| )?answers\??$/,
+           /^-?-?max(-|_| )?stats\??$/,
+           /^-?-?max(-|_| )?statistics\??$/,
+           /^-?-?max(-|_| )?questions(-|_| )?answered\??$/, # studium --max-questions-answered
+           /^-?-?daily$/i,
+           /^-?-?daily(-|_| )?changes\??$/
+        show_maximum_amount_of_questions_ever_answered
+        exit
+      # ===================================================================== #
+      # === studium --all-undone
+      #
+      # This entry point will mark all exam question as "undone", aka
+      # reset the whole exam-question dataset. Only invoke this if
+      # you really need this.
+      # ===================================================================== #
+      when /-?-?all(_|-)?undone$/i
+        mark_all_exam_question_answers_as_undone
+        exit
+      # ===================================================================== #
+      # === studium --start-a-new-exam-day
+      #
+      # This entry point can be used to "reset" the file that keeps track
+      # of which exams have been answered today.
+      # ===================================================================== #
+      when /-?-?start(_|-)?a(_|-)?new(_|-)?exam(_|-)?day$/i,
+           /-?-?clear(_|-)?last(_|-)?questions$/i,
+           /^-?-?clear(_|-)?old(_|-)?file$/i,
+           /^-?-?clear(_|-)?file$/i,
+           /^-?-?new(_|-)?day$/i
+        start_a_new_exam_day
+        exit
+      # ===================================================================== #
+      # === studium --ects-per-university
+      # ===================================================================== #
+      when /^-?-?ects(-|_| )?per(-|_| )?university$/i,
+           /^-?-?overviews(-|_| )?at(-|_| )?universities$/i,
+           /^-?-?per(-|_| )?university$/i,
+           /^-?-?per(-|_| )?uni$/i,
+           /^-?-?universities$/i, # === studium --universities
+           /^-?-?show(_|-)?ects(_|-)?passed(_|-)?per(_|-)?university$/i
+        show_ects_passed_per_university
+        exit
+      # ===================================================================== #
+      # === studium --average-grade
+      # ===================================================================== #
+      when /^-?-?average(-|_| )?grade$/i
+        do_show_the_average_grade_of_all_passed_exams
+      # ===================================================================== #
+      # === 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$/i,
+           /^-?-?update$/i,
+           /^-?-?update(-|_| )?statistics$/i,
+           /^-?-?record$/i,
+           /^-?-?save$/i,
+           /^-?-?update(-|_| )?examstats$/i         # === studium --update-examstats
+        verbose_update_max_ever
+        exit
+      # ===================================================================== #
+      # === studium --max-per-topic?
+      #
+      # This entry point will show how many questions were answered
+      # per given topic in a "maximum" manner, e. g. how many
+      # questions were answered ever, overall.
+      # ===================================================================== #
+      when /^-?-?max(_|-)?per(_|-)?topics?\??$/i,
+           /^-?-?max(_|-)?exams(_|-)?answered(_|-)?per(_|-)?topic\??$/i,
+           /^-?-?max(_|-)?each$/i,
+           /^-?-?max(_|-)?ever(_|-)?per(_|-)?topic$/i,
+           /^-?-?max(_|-)?per(_|-)?question$/i # === studium --max-per-question
+        show_max_exam_questions_answered_per_topic
+      # ===================================================================== #
+      # === studium --last-questions
+      # ===================================================================== #
+      when /^-?-?last(_|-)?questions?$/i
+        require 'studium/logging/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(_)
+        e
+        e "The file that was used was: #{sfile(_)}"
+        e
+      # ===================================================================== #
+      # === studium --examstats
+      # ===================================================================== #
+      when /-?-?exam(_|-)?stats$/,
+           /-?-?exam(_|-)?statistics/,
+           /^-?-?statistics\??$/i,
+           /^-?-?statistik\??$/i,
+           /^-?-?stats$/i
+        require 'studium/statistics/show_exam_statistics.rb'
+        Studium.show_exam_statistics
+        if Studium.is_on_roebe?
+          Studium::Exams.report_how_many_exam_questions_were_already_solved
+        end
+        exit
+      # ===================================================================== #
+      # === studium --mega-pdf
+      #
+      # This entry point will create one huge .pdf file, consisting of
+      # ALL exam topics.
+      # ===================================================================== #
+      when /^-?-?mega(-|_| )?pdf$/i,
+           /^-?-?monster(-|_| )?pdf$/i,
+           /^-?-?monster(-|_| )$/i,
+           /^-?-?fat(-|_| )?pdf$/i
+        ::Studium.create_pdf_file_for_this_exam_topic(:all_topics)
+      # ===================================================================== #
+      # === 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
+           /^-?-?pdf=(.+)$/i                             # for $1
+        this_topic = $1.to_s.dup if $1
+        this_topic = $2.to_s.dup if $2
+        this_topic = $3.to_s.dup if $3
+        ::Studium.create_pdf_file_for_this_exam_topic(this_topic)
+      # ===================================================================== #
+      # === studium --sinatra
+      #
+      # This entry point starts the sinatra-part of the Studium project.
+      # ===================================================================== #
+      when /^-?-?sinatra$/
+        start_the_sinatra_interface
+        exit
+      # ===================================================================== #
+      # === Show all courses that belong to a particular curriculum ID
+      #
+      # This entry point allows us to show all courses that belong to
+      # a specific curriculum ID.
+      #
+      # Usage examples:
+      #
+      #   studium --all-courses-that-belong-to=255
+      #   studium --all-courses-that-belong-to=033255
+      #
+      # ===================================================================== #
+      when /^-?-?all(-|_| )?courses(-|_| )?that(-|_| )?belong(-|_| )?to=(.+)$/i
+        curriculum_id = $5.to_s.dup
+        require 'studium/curricula/show_lectures_of_this_curriculum_id/show_lectures_of_this_curriculum_id.rb'
+        Studium::ShowLecturesOfThisCurriculumId.new(curriculum_id)
+      # ===================================================================== #
+      # === studium --show-mixed-courses
+      #
+      # This entry point allows the user to see only courses that are
+      # part of a Bachelor as well as a Master curriculum.
+      #
+      # Usage example:
+      #
+      #   studium --show-mixed-courses
+      #
+      # ===================================================================== #
+      when /^-?-?show(_|-)?mixed(_|-)?courses$/i
+        require 'studium/utility_scripts/show_mixed_bachelor_master_courses/show_mixed_bachelor_master_courses.rb'
+        Studium::ShowMixedBachelorMasterCourses.new
+      # ===================================================================== #
+      # === studium --available-themes
+      #
+      # This entry point can be used by the user to show which themes
+      # are available (aka registered). For instance, it answers the
+      # question such as "which courses contain the theme genetics?".
+      #
+      # Usage example:
+      #
+      #   studium --available-themes
+      #
+      # ===================================================================== #
+      when /^-?-?available(_|-)?themes$/i,
+           /^-?-?available(_|-)?topics$/i
+        show_the_available_themes
+      # ===================================================================== #
+      # === 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/generate_spreadsheet.rb'
+        _ = $2.to_s.dup
+        _ = $3.to_s.dup if $3
+        Studium::GenerateSpreadsheet.new(_)
+      # ===================================================================== #
+      # === studium --passed-exams?
+      # ===================================================================== #
+      when /^-?-?passed(-|_| )?exams\??$/i,
+           /^-?-?all(-|_| )?passed(-|_| )?exams\??$/i,
+           /^-?-?return(-|_| )?passed(-|_| )?exams\??$/i,
+           /^-?-?total(-|_| )?ECTS\??$/i
+        show_passed_exams
+      # ===================================================================== #
+      # === studium --current-studyset?
+      # ===================================================================== #
+      when /^-?-?current(-|_| )?studyset\??$/i
+        show_the_current_studyset
+      # ===================================================================== #
+      # === studium --create-database
+      #
+      # Create a new SQL database.
+      # ===================================================================== #
+      when /^-?-?create(_|-)?database$/i,
+           /^-?-?database$/i,
+           /^-?-?sql$/i
+        Dir.chdir(Studium.log_directory?) if File.directory?(Studium.log_directory?)
+        require 'studium/utility_scripts/create_database/create_database.rb'
+        Studium::CreateDatabase.new
+        # =================================================================== #
+        # And then read it in:
+        # =================================================================== #
+        if File.exist? 'INSERT_INTO_STATEMENTS.sql'
+          File.delete('exam_questions.db') if File.exist? 'exam_questions.db'
+          esystem 'sqlite3 exam_questions.db < INSERT_INTO_STATEMENTS.sql'
+        else
+          e 'No file exists called '+sfile(INSERT_INTO_STATEMENTS.sql)+'.'
+        end
+      # ===================================================================== #
+      # === studium --log-dir?
+      # ===================================================================== #
+      when /(_|-)?(_|-)?log(_|-)?dir\??/i
+        e
+        e "  #{sfile(Studium.log_directory?)}"
+        e
+      # ===================================================================== #
+      # === studium --libui
+      # ===================================================================== #
+      when /-?-?libui$/i
+        require 'studium/gui/libui/ask_exam_question/ask_exam_question.rb'
+        Studium::GUI::Libui::AskExamQuestion.new
+        exit
+      # ===================================================================== #
+      # === studium --gtk3
+      # ===================================================================== #
+      when /-?-?gtk3?$/i,
+           /-?-?gui$/i
+        require 'studium/gui/gtk3/exam_question_widget/exam_question_widget.rb'
+        Studium::GUI::Gtk::ExamQuestionWidget.run(ARGV)
+        exit
+      # ===================================================================== #
+      # === studium --create-executable
+      # ===================================================================== #
+      when /-?-?create(_|-)?executable$/i,
+           /-?-?executable$/i
+        create_an_executable_on_windows
+        exit
+      # ===================================================================== #
+      # === studium --open-statistics
+      #
+      # This entry point allows the user to open the statistics file. It
+      # is mostly catered to my use case, though - thus of limited use
+      # to other users of this gem.
+      # ===================================================================== #
+      when /^-?-?open(-|_| )?the(-|_| )?statistics$/,
+           /^-?-?open(-|_| )?the(-|_| )?statistics(-|_| )?file$/,
+           /^-?-?open(-|_| )?statistics$/,
+           /^-?-?open(-|_| )?stats$/
+        open_the_statistics_file
+        exit
+      # ===================================================================== #
+      # === 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,
+           /^-?-?n(_|-)?courses$/i
+        Studium.report_n_entries_in_the_file_lecture_information
+      # ===================================================================== #
+      # === 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 --solved-topics?
+      # ===================================================================== #
+      when /^-?-?solved(_|-)?topics\??$/
+        require 'studium/toplevel_methods/return_n_percent_solved_from_this_topic.rb'
+        e 'The solved exam-topics are as follows:'
+        e
+        ::Studium.available_topics_as_short_names.each {|this_topic|
+          case ::Studium.return_n_percent_solved_from_this_topic(this_topic)
+          when 100.0
+            puts 'The topic '+this_topic+' has been solved.'
+          end
+        }
+        e
+        exit
+      # ===================================================================== #
+      # === studium --solved
+      # ===================================================================== #
+      when /^-?-?solved$/
+        require_class_exams_solved.rb
+        _ = Studium::Exams::Solved.new(ARGV, :dont_run_yet)
+        _.set_commandline
+        _.run
+      # ===================================================================== #
+      # === studium --nsolved
+      # ===================================================================== #
+      when /^-?-?nsolved$/
+        report_how_many_exam_questions_were_already_solved
+      # ===================================================================== #
+      # === studium "--solved? 300143"
+      # === studium "--already_solved_this_id 300143"
+      # ===================================================================== #
+      when /-?-?solved\?? (\d+)/,
+           /-?-?already(_|-)?solved(_|-)?this(_|-)?id (\d+)/
+        the_lva_number = $1.to_s.dup
+        the_lva_number = $4.to_s.dup if $4
+        yes_or_no = Studium.yes_or_no(
+          Studium.already_solved_this_lva_number?(the_lva_number).to_s
+        )
+        e 'Did we solve this lecture (ID: '+simp(the_lva_number)+') yet? '+
+          sfancy(yes_or_no)
+      # ===================================================================== #
+      # === studium --mandatory
+      # ===================================================================== #
+      when /^-?-?mandatory$/i
+        show_upcoming_mandatory_presence_courses
+        exit
+      # ===================================================================== #
+      # === studium --create_a_clean_lecture_information_file
+      # ===================================================================== #
+      when /^-?-?create(-|_| )?a(-|_| )?clean(-|_| )?lecture(-|_| )?information(-|_| )?file$/i
+        Studium.create_a_clean_lecture_information_file
+        exit
+      # ===================================================================== #
+      # === studium --upload-exam-questions
+      # ===================================================================== #
+      when /-?-?upload(_|-)?exam(_|-)?questions/,
+           /-?-?upload(_|-)?exams/,
+           /-?-?uexams/
+        Studium.upload_exam_questions { :be_verbose }
+      # ===================================================================== #
+      # === studium --compare
+      # ===================================================================== #
+      when /^-?-?compare$/
+        curriculum_comparer
+      # ===================================================================== #
+      # === studium --download-exam-dataset
+      # ===================================================================== #
+      when /^-?-?download(_|-)?exam(_|-)?dataset$/i,
+           /^-?-?download(_|-)?dataset$/i
+        ::Studium.download_exam_dataset
+      # ===================================================================== #
+      # === studium --use-this-colour-for-exam-answers=slateblue
+      # ===================================================================== #
+      when /^-?-?use(-|_| )?this(-|_| )?colour(-|_| )?for(-|_| )?exam(-|_| )?answers=(.+)/i,
+           /^-?-?use(-|_| )?this(-|_| )?colour(-|_| )?for(-|_| )?answers=(.+)/i,
+           /^-?-?colour(-|_| )?for(-|_| )?answers=(.+)/i
+        _ = $3
+        _ = $5 if $5
+        _ = $6 if $6
+        ::Studium::Colours.use_this_colour_for_exam_answers(_.to_s.dup)
+      # ===================================================================== #
+      # === studium --lectures-on-this-day=05.05.2018
+      # ===================================================================== #
+      when /^-?-?lectures(_|-)?on(_|-)?this(_|-)?day(_|-)?=(.+)$/,
+           /^(\d{2}.\d{2}.\d{4})$/
+        require 'studium/curricula/determine_curricula/determine_curricula.rb'
+        first_match_to_the_regex = $1.to_s.dup
+        i = $5.to_s.dup
+        if first_match_to_the_regex =~ /^\d+/
+          i = first_match_to_the_regex
+        end
+        Studium.show_lectures_on_this_day(i)
+      # ===================================================================== #
+      # === set_directory_to_the_exam_topics
+      #
+      # Usage example:
+      #
+      #   studium --set-directory-to-the-exam-topics=/Depot/j/EXAM_TOPICS/
+      #
+      # ===================================================================== #
+      when /set(_|-)?directory(_|-)?to(_|-)?the(_|-)?exam(_|-)?topics=(.+)/
+        match = $6.to_s.dup
+        verbose_set_this_dir_to_exam_topics(match)
+      # ===================================================================== #
+      # === set_dir
+      # ===================================================================== #
+      when /set(_|-)?dir=(.+)/
+        match = $2.to_s.dup
+        verbose_set_this_dir_to_exam_topics(match)
+      # ===================================================================== #
+      # === studium --lectures_without_exam_entry
+      # ===================================================================== #
+      when /^-?-?lectures(_|-)?without(_|-)?exam(_|-)?entry$/i
+        lectures_without_exam_entry
+      # ===================================================================== #
+      # === studium --use-this-colour-for-exam-questions=slateblue
+      # ===================================================================== #
+      when /^-?-?use(-|_| )?this(-|_| )?colour(-|_| )?for(-|_| )?exam(-|_| )?questions=(.+)/i,
+           /^-?-?use(-|_| )?this(-|_| )?colour(-|_| )?for(-|_| )?questions=(.+)/i,
+           /^-?-?colour(-|_| )?for(-|_| )?questions=(.+)/i
+        _ = $3
+        _ = $5 if $5
+        _ = $6 if $6
+        ::Studium::Colours.use_this_colour_for_exam_questions(_.to_s.dup)
+      # ===================================================================== #
+      # === studium --merge
+      # ===================================================================== #
+      when /^-?-?merge$/i
+        copy_lecture_information_file_to_default_location
+      # ===================================================================== #
+      # === studium --open-upcoming-exams
+      # ===================================================================== #
+      when /^-?-?open(-|_| )?upcoming(-|_| )?exams$/i,
+           /^-?-?open(-|_| )?important$/i
+        open_relevant_files
+      # ===================================================================== #
+      # === studium --open-important-exams
+      # ===================================================================== #
+      when /^-?-?open(-|_| )?important(-|_| )?exams$/i,
+           /^-?-?important(-|_| )?exams$/i,
+           /^-?-?important$/i,
+           /^-?-?priorities$/i,
+           /^-?-?priority$/i,
+           /^-?-?open(-|_| )?important(-|_| )?lectures$/i # === studium --open-important-lectures
+        verbose_open_important_exams
+      # ===================================================================== #
+      # === studium --create-an-archive-of-the-exam-questions
+      # ===================================================================== #
+      when /^-?-?create(-|_| )?an(-|_| )?archive(-|_| )?of(-|_| )?the(-|_| )?exam(-|_| )?questions$/i,
+           /^-?-?create(-|_| )?exam(-|_| )?topics(-|_| )?archive$/i
+        create_an_archive_of_the_exam_questions
+      # ===================================================================== #
+      # === studium --upcoming-important-exams
+      # ===================================================================== #
+      when /-?-?upcoming(-|_| )?important(-|_| )?exams/,
+           /-?-?upcoming(-|_| )?exams/
+        upcoming_important_exams
+      # ===================================================================== #
+      # === studium --end
+      # ===================================================================== #
+      when /^-?-?end$/i,
+           /^-?-?end(-|_| )?difference$/i
+        report_the_difference_to_the_start_time
+      # ===================================================================== #
+      # === studium --upload_pdf
+      # ===================================================================== #
+      when /^-?-?upload(-|_| )?pdf$/i
+        upload_pdf
+      # ===================================================================== #
+      # === studium --vim
+      # ===================================================================== #
+      when /^-?-?vim$/i
+        permanently_set_this_editor(:vim)
+      # ===================================================================== #
+      # === 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 --show-lva-dates-of-this-lecture="Primatologie"
+      # ===================================================================== #
+      when /^-?-?show(_|-)?lva(_|-)?dates(_|-)?of(_|-)?this(_|-)?lecture=(.+)/i
+        this_theme = $6.to_s.dup.delete('"')
+        show_lva_dates_of_this_lecture(this_theme)
+      # ===================================================================== #
+      # === studium --colours?
+      # ===================================================================== #
+      when /-?-?colours\??/
+        e ::Colours.rev+
+          'Does the Studium project use colours, right now? '+
+          sfancy(Studium.yes_or_no(Studium.use_colours?.to_s))
+      # ===================================================================== #
+      # === studium --add-a-new-question
+      # ===================================================================== #
+      when /^-?-?add(-|_| )?a(-|_| )?new(-|_| )?question$/i
+        add_new_exam_question
+      # ===================================================================== #
+      # === 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 --last-question?
+      # ===================================================================== #
+      when /^-?-?last(_|-)?question\??$/i
+        _ = Studium.file_last_question_asked?
+        if File.exist? _
+          e File.read(_)
+        else
+          no_file_exists_at(_)
+        end
+      # ===================================================================== #
+      # === 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 --collage?
+      # ===================================================================== #
+      when /-?-?collage\??$/
+        show_collage_of_current_exams
+        exit
+      # ===================================================================== #
+      # === studium --master=vektorx
+      # ===================================================================== #
+      when /^-?-?master(=|-)(.+)$/
+        require 'studium/utility_scripts/show_lectures_on_the_commandline/show_lectures_on_the_commandline.rb'
+        this_curriculum = "master-#{$2.to_s.dup}"
+        Studium::ShowLecturesOnTheCommandline.new(this_curriculum)
+      # ===================================================================== #
+      # === studium --lectures-from-this-curriculum=geodäsie
+      # ===================================================================== #
+      when /^-?-?lectures(-|_| )?from(-|_| )?this(-|_| )?curriculum=(.+)$/i
+        require 'studium/curricula/show_lectures_of_this_curriculum_id/show_lectures_of_this_curriculum_id.rb'
+        Studium::ShowLecturesOfThisCurriculumId.new($4.to_s.dup)
+      # ===================================================================== #
+      # === studium --pristine
+      # ===================================================================== #
+      when /^-?-?pristine$/,
+           /^-?-?new(_|-)?lecture(_|-)?information$/
+        pristine
+      # ===================================================================== #
+      # === studium --passed-exams=chemistry
+      # ===================================================================== #
+      when /^-?-?passed(_|-)?exams=(.+)/i,
+           /^-?-?report(_|-)?passed(_|-)?exams(_|-)?fitting(_|-)?to(_|-)?this(_|-)?theme=(.+)/i
+        this_theme = $2.to_s.dup
+        this_theme = $7.to_s.dup if $7
+        report_passed_exams_fitting_to_this_theme(this_theme)
+      # ===================================================================== #
+      # === studium --outdated
+      # ===================================================================== #
+      when /^-?-?outdated$/
+        show_outdated_lva_dates
+      # ===================================================================== #
+      # === studium --upload-archive-of-the-exam-questions
+      # ===================================================================== #
+      when /^-?-?upload(-|_| )?archive(-|_| )?of(-|_| )?the(-|_| )?exam(-|_| )?questions$/,
+           /^-?-?upload(-|_| )?exam(-|_| )?archive$/,
+           /^-?-?upload(-|_| )?exam(-|_| )?topics$/
+        upload_archive_of_the_exam_questions
+      # ===================================================================== #
+      # === studium --encoding=utf
+      # === studium --encoding=iso1
+      # ===================================================================== #
+      when /^-?-?encoding=(.+)$/i
+        Studium.use_this_new_encoding($1.to_s.dup)
+        exit
+      # ===================================================================== #
+      # === studium --use-this-curriculum=foo.md
+      # ===================================================================== #
+      when /^-?-?use(_|-)?this(_|-)?curriculum=(.+)$/i
+        require 'studium/utility_scripts/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 --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 --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 --exam_topics?
+      # ===================================================================== #
+      when /-?-?exam(_|-)?topics\??/
+        show_where_the_exam_topics_can_be_found
+      # ===================================================================== #
+      # === studium --statistics?
+      # ===================================================================== #
+      when /^-?-?statistics\??$/i,
+           /^-?-?stats\??$/i
+        require 'studium/curricula/determine_curricula/determine_curricula.rb'
+        Studium.determine_curricula
+      # ===================================================================== #
+      # === studium --n-topics-available?
+      # ===================================================================== #
+      when /^-?-?n(_|-)?topics(_|-)?available\??/,
+           /^-?-?n-?topics\??/
+        show_how_many_exam_topics_are_available
+      # ===================================================================== #
+      # === studium --topics?
+      # ===================================================================== #
+      when /^-?-?topics\??$/i
+        show_available_topics
+      # ===================================================================== #
+      # === studium --path-to-file-lecture-information
+      # ===================================================================== #
+      when /^-?-?path(-|_| )?to(-|_| )?file(-|_| )?lecture(-|_| )?information$/i
+        show_path_to_the_file_lecture_information
+      # ===================================================================== #
+      # === studium --open-timetable
+      # ===================================================================== #
+      when /-?-?open(-|_| )?timetable$/i
+        open_timetable
+        exit
+      # ===================================================================== #
+      # === studium --upcoming_exams_at_the_boku
+      # ===================================================================== #
+      when /upcoming_?exams_?at_?the_?boku/
+        show_upcoming_exams_at_the_boku
+      # ===================================================================== #
+      # === studium --show_collage_of_current_exams
+      # ===================================================================== #
+      when /^-?-?show(_|-)?collage(_|-)?of(_|-)?current(_|-)?exams$/i
+        show_collage_of_current_exams
+      # ===================================================================== #
+      # === studium --open
+      # ===================================================================== #
+      when /^-?-?open$/i
+        open_useful_files_via_the_default_editor
+        exit
+      # ===================================================================== #
+      # === studium --base-dir?
+      # ===================================================================== #
+      when /^-?-?base(_|-)?dir\??/,
+           /^-?-?dir\??$/
+        show_the_base_dir
+      # ===================================================================== #
+      # === studium --ects-bachelor-master
+      # ===================================================================== #
+      when /^-?-?ects(_|-)?bachelor(_|-)?master$/,
+           /^-?-?bachelor(_|-)?master$/,
+           /^-?-?bm$/ # studium --bm
+        show_passed_ects_in_the_individual_bachelor_and_master_curricula
+      # ===================================================================== #
+      # === studium --check-the-lecture-information-file
+      # ===================================================================== #
+      when /-?-?check(-|_| )?the(-|_| )?lecture(-|_| )?information(-|_| )?file$/,
+           /-?-?check(-|_| )?file(-|_| )?information$/
+        check_the_lecture_information_file
+      # ===================================================================== #
+      # === 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 --best-month
+      # ===================================================================== #
+      when /^-?-?best-month$/,
+           /^-?-?best(_|-)?month(_|-)?stats$/,
+           /^-?-?show(_|-)?best(_|-)?months?$/,
+           /^-?-?best(_|-)?months?$/
+        show_best_month
+        exit
+      # ===================================================================== #
+      # === 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 --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 --audio-stats
+      # ===================================================================== #
+      when /^-?-?audio/
+        require 'studium/utility_scripts/audio_stats.rb'
+        Studium.audio_stats?
+      # ===================================================================== #
+      # === studium --backlog-of-exams
+      # ===================================================================== #
+      when /^-?-?backlog(-|_| )?of(-|_| )?exams$/i
+        show_backlog_of_exams
+      # ===================================================================== #
+      # === studium --bachelor_curricula
+      # ===================================================================== #
+      when /^-?-?bachelor(-|_| )?curricula$/i,
+           /^-?-?bachelor$/i
+        show_passed_lectures_in_a_bachelor_curriculum
+        exit
+      # ===================================================================== #
+      # === studium --disable-colours
+      # ===================================================================== #
+      when /^-?-?disable(_|-)?colours$/i,
+           /^-?-?permanently(_|-)?disable(_|-)?colours$/i
+        permanently_disable_colours
+      # ===================================================================== #
+      # === studium --passed-ects-per-year
+      # ===================================================================== #
+      when /^-?-?passed(-|_| )?ects(-|_| )?per(-|_| )?year$/i
+        show_passed_ects_per_year
+      # ===================================================================== #
+      # === 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 --timetable
+      # ===================================================================== #
+      when /^-?-?timetable$/
+        show_timetable
+        exit
+      # ===================================================================== #
+      # === studium --set-editor=vim
+      # ===================================================================== #
+      when /^-?-?set(-|_| )?editor=(.+)$/i
+        permanently_set_this_editor($2.to_s.dup)
+      # ===================================================================== #
+      # === studium --start
+      # ===================================================================== #
+      when /^-?-?start$/i
+        note_down_the_start_time_and_how_many_exams_have_been_already_solved
+      # ===================================================================== #
+      # === studium --curricula
+      # === studium --show-curricula
+      # ===================================================================== #
+      when /^-?-?curricula$/i,
+           /^-?-?show(-|_| )?curricula$/i
+        show_curricula
+      # ===================================================================== #
+      # === studium --bachelor=vektorx
+      # ===================================================================== #
+      when /^-?-?bachelor(=|-)(.+)$/
+        require 'studium/utility_scripts/show_lectures_on_the_commandline/show_lectures_on_the_commandline.rb'
+        this_curriculum = "bachelor-#{$2.to_s.dup}"
+        Studium::ShowLecturesOnTheCommandline.new(this_curriculum)
+      # ===================================================================== #
+      # === studium --questions-per-year
+      # ===================================================================== #
+      when /^-?-?questions(_|-)?per(_|-)?year$/
+        show_questions_per_year
+      # ===================================================================== #
+      # === studium --passed-ects
+      # ===================================================================== #
+      when /^-?-?passed(_|-)?ects\??$/i,
+           /^-?-?overview$/i,
+           /^-?-?performance$/i # studium --performance
+        show_passed_credits_per_curriculum
+      # ===================================================================== #
+      # === studium --yearly-average-grades
+      # ===================================================================== #
+      when /^-?-?yearly(_|-)?average(_|-)?grades$/,
+           /^-?-?grades$/i
+        show_yearly_average_grades
+        exit
+      # ===================================================================== #
+      # === studium --editor?
+      # ===================================================================== #
+      when /^-?-?editor\??$/i
+        e sfancy(Studium.editor?) 
+      # ===================================================================== #
+      # === studium --delay?
+      # ===================================================================== #
+      when /^-?-?delay\?/ # Query the delay in use.
+        require 'studium/toplevel_methods/read_delay_between_questions_from_file.rb'
+        e rev+
+          'The delay is '+lightgreen(
+            Studium::Exams.read_delay_from_file.to_s
+          )+
+          ' seconds between individual question-answer sessions.'
+      else # else tag
+        # =================================================================== #
+        # === Handle Pseudo-Regexes                               (regex tag)
+        #
+        # Handle pseudo-regexes next. These are strings that start
+        # and end with a '/' character.
+        # =================================================================== #
+        if i.start_with?('/') and i.end_with?('/')
+          e "A pseudo-regex was discovered (#{sfancy(i)}). We "\
+            "will next query for any"
+          e 'exam matching to that regex.'
+          e
+          use_this_regexp = Regexp.new(i.delete('/'), Regexp::IGNORECASE) # <- is case-insensitive.
+          Studium.try_to_report_exams_that_match_to_this_regexp(use_this_regexp) { :also_show_the_grade }
+        # =================================================================== #
+        # === Handle lecture types
+        #
+        # This entry point will handle input such as the following:
+        #
+        #   studium --VO
+        #   studium VO+SE
+        #
+        # =================================================================== #
+        elsif ARRAY_LECTURE_TYPES_THAT_ARE_MANDATORY_CONTINUOUS_ASSESSMENT.include?(i.delete('-')) or
+              (i.delete('-') == 'VO')
+          Studium.report_all_lectures_matching_this_lecture_type(i.delete('-'))
+        # =================================================================== #
+        # === Handle --flags next
+        # =================================================================== #
+        elsif i.include?('--')
+          e "#{rev}Unrecognized commandline instruction: "+
+            steelblue(i)
+        end
+      end
+    end
+  end
+
+  # ========================================================================= #
+  # === show_help                                                  (help tag)
+  #
+  # We will first build up an Array, then sort it, then display it.
+  # That way we can just add to that Array without having to worry
+  # about whether it is sorted or not.
+  #
+  # Invocation example:
+  #
+  #   studium --show-help
+  #
+  # ========================================================================= #
+  def show_help
+    array = []
+    array << '  --exam-topics?                                           # feedback '\
+             'the location to the exam-topics in use'
+    array << '  --log-dir?                                               # feedback '\
+             'the log directory in use'
+    array << '  --n-topics?                                              # feedback '\
+             'how many topics are available'
+    array << '  --show_how_many_exams_were_passed                        # feedback '\
+             'how many exams were already passed'
+    array << '  --set-directory-to-the-exam-topics=/Depot/j/EXAM_TOPICS/ # set a '\
+             'specific directory target'
+    array << '  --best-months                                            # show '\
+             'the best month, that is, most ECTS points solved in any given month'
+    array << '  --set-dir=/dir                                           # shorter '\
+             'variant of the above; an alias'
+    array << '  --lectures-from-this-curriculum=217                      # use '\
+             'a specific curriculum number (as ID)'
+    array << '  --set-editor=vim                                         # set '\
+             'to use the editor called vim (or any other one of your choice)'
+    array << '  --show-curricula                                         # show '\
+             'all registered curricula'
+    array << '  --master-curricula                                       # show '\
+             'all lectures passed in a given master curriculum'
+    array << '  --upload-exam-questions                                  # uploads '\
+             'the exam questions'
+    array << '  --expand="15.10-22.10.2018"                              # expand '\
+             'the time range for this range'
+    array << '  --encoding=utf                                           # use '\
+             'this encoding for the Studium namespace'
+    array << '  --outdated                                               # show '\
+             'outdated lva- and exam-dates of registered lectures'
+    array << '  --show-mixed-courses                                     # show '\
+             'only courses that are part of a Bachelor as well as '\
+             'a Master curriculum'
+    array << '  --collage?                                               # show '\
+             'which exams we are currently training'
+    array << '  --n-ects-from-this-file=ECTS.md                          # display '\
+             'how many ECTS points are in that file'
+    array << '  --ects-bachelor-master?                                  # show '\
+             'how many bachelor/master ECTS points were passed so far'
+    array << '  --passed-exams?                                          # show '\
+             'which exams were already completed successfully'
+    array << '  --start                                                  # note '\
+             'down the start time + how many exams were solved at this point'
+    array << '  --pristine                                               # this '\
+             'will create a new file called '+
+             'lecture_information.yml'+
+             ', without any already solved exams'
+    array << '  --colours?                                               # show '\
+             'whether we will use colours or whether we will not'
+    array << '  --passed-ects                                            # show '\
+             'how many ECTS were passed in the registered curricula'
+    array << '  --passed-exams=chemistry                                 # show '\
+             'passed exams belonging to the given theme (in this '\
+             'case, lectures related to chemistry)'
+    array << '  --available-themes                                       # show '\
+             'all registered (and thus available) themes of different lectures'
+    array << '  --statistics                                             # show '\
+             'some general statistics of this project'
+    array << '  --check-the-lecture-information-file                     # check '\
+             'whether all entries are correct, in the file called '+
+             sfile('lecture_information.yml')
+    array << '  --lectures-on-this-day=05.05.2018                        # show '\
+             'which lectures are on the given day'
+    array << '  --disable-colours                                        # this '\
+             'entry point allows you to permanently disable colours'
+    array << '  --solved?                                                # show '\
+             'whether whether that particular lecture ID was already solved or '\
+             'whether it was not'
+    array << '  --set-log-dir=/foo/bar/                                  # specify '\
+             'another log directory'
+    array << '  --exams-at-the-meduni                                    # show '\
+             'all exams at the meduni'
+    array << '  --n-entries-in-the-file-lecture-information?             # report '\
+             'how many courses are registered in the file '+
+             sfile('lecture_information.yml')
+    array << '  --max?                                                   # show '\
+             'how many exams were already passed'
+    array << '  --download-exam-dataset                                  # download '\
+             'the exam dataset from a remote website'
+    array << '  --gui                                                    # start '\
+             'the GUI component of the Studium project'
+    array << '  --timetable                                              # show '\
+             'upcoming possible exams, via a timetable'
+    array << '  --max-ever                                               # show '\
+             'the maximum amount of exam-questions ever answered'
+    array << '  --audio-stats                                            # show '\
+             'all locally available audio files in the study-directory'
+    array << '  --yearly-average-grades                                  # show '\
+             'the yearly average grades'
+    array << '  --percentage-achieved                                    # show '\
+             'how much percent of a given curriculum we have already passed'
+    array << '  --questions-per-year                                     # show '\
+             'how many questions were added per year'
+    array << '  --exams-at-the-uniwien                                   # show '\
+             'all exams at the uniwien (university of vienna)'
+    array << '  --open                                                   # open '\
+             'relevant study-specific files in the (default) editor'
+    array << '  /name_of_exams/                                          # regex '\
+             'search for an exam with that name'
+    array << '  --upcoming_exams_at_the_boku                             # show '\
+             'all upcoming exams at the BOKU. (This will also generate a .html page.)'
+    array << '  --upcoming-important-exams                               # show '\
+             'all upcoming exams in general. (This will also generate a .html page.)'
+    array << '  --examstats                                              # show '\
+             'the exam statistics, that is, how many exams you passed'
+    array << '  --use-this-colour-for-exam-questions=slateblue           # set '\
+             'to use this colour for exam-questions'
+    array << '  --use-this-colour-for-exam-answers=slateblue             # set '\
+             'to use this colour for exam-answers'
+    array << '  --set-delay=5                                            # set '\
+             'the delay between answering a question to n seconds, in this case 5'
+    array << '  --delay?                                                 # query '\
+             'the current delay in use'
+    array << '  --files?                                                 # show '\
+             'where some of the important files may be kept'
+    array << '  last-exams 15                                            # show '\
+             'the last 15 passed exams'
+    array << '  --update-max-questions                                   # update '\
+             'how many questions were asked'
+    array << '  --mandatory                                              # show '\
+             'upcoming mandatory courses in the next some days (40 days usually)'
+    e
+    e "#{rev}The following #{steelblue(array.size.to_s)} options "\
+      "are available and documented for #{royalblue('bin/studium')}:"
+    e
+    e
+    # ======================================================================= #
+    # The above ^^^ can be added in any random order; the next line will
+    # sort this anyway.
+    # ======================================================================= #
+    array.sort.each {|entry| eparse entry }
+    e
+  end
+
+  # ========================================================================= #
+  # === show_the_available_themes
+  #
+  # Invoke this method from the commandline via:
+  #
+  #   studium --available-themes
+  #
+  # ========================================================================= #
+  def show_the_available_themes
+    file = ::Studium.file_allowed_themes_for_courses
+    if File.exist? file
+      dataset = YAML.load_file(file)
+      dataset.each {|entry| e steelblue(entry) }
+    end
+  end
+
+  # ========================================================================= #
+  # === start_a_new_exam_day
+  # ========================================================================= #
+  def start_a_new_exam_day
+    require 'studium/logging/store_last_question_asked_into_file.rb'
+    Studium::Log::StoreLastQuestionAskedIntoFile.reset_file
+  end
+
+  # ========================================================================= #
+  # === create_an_executable_on_windows
+  #
+  # To invoke this method do:
+  #
+  #   studium --create-executable
+  #
+  # ========================================================================= #
+  def create_an_executable_on_windows(
+      on_this_file = 
+        '/home/x/programming/ruby/src/studium/lib/studium/gui/libui/ask_exam_question.rb',
+      name_of_the_output_exe = 'ask_exam_question.exe'
+    )
+    _ = 'ocra '+on_this_file+' '\
+        '--dll ruby_builtin_dlls/libssp-0.dll '\
+        '--dll ruby_builtin_dlls/libgmp-10.dll '\
+        '--dll ruby_builtin_dlls/libffi-7.dll '\
+        '--gem-all=fiddle '\
+        '--output '+name_of_the_output_exe
+    esystem _
+  end
+
+  # ========================================================================= #
+  # === show_upcoming_mandatory_presence_courses
+  # ========================================================================= #
+  def show_upcoming_mandatory_presence_courses
+    require 'studium/utility_scripts/upcoming_mandatory_presence_courses/upcoming_mandatory_presence_courses.rb'
+    Studium::UpcomingMandatoryPresenceCourses.new(ARGV)
+  end
+
+  # ========================================================================= #
+  # === curriculum_comparer
+  # ========================================================================= #
+  def curriculum_comparer
+    Studium::CurriculumComparer.new
+  end
+
+  # ========================================================================= #
+  # === pristine
+  # ========================================================================= #
+  def pristine
+    Studium.pristine
+  end
+
+  # ========================================================================= #
+  # === report_passed_exams_fitting_to_this_theme
+  # ========================================================================= #
+  def report_passed_exams_fitting_to_this_theme(this_theme)
+    require 'studium/exams/show_themes/misc.rb'
+    Studium.report_passed_exams_fitting_to_this_theme(this_theme)
+  end
+
+  # ========================================================================= #
+  # === show_outdated_lva_dates
+  # ========================================================================= #
+  def show_outdated_lva_dates
+    require 'studium/utility_scripts/show_outdated_lva_dates.rb'
+    Studium.show_outdated_lva_dates
+  end
+
+  # ========================================================================= #
+  # === start_gui_component
+  #
+  # Use this method to start the gui/gtk component of the Studium project.
+  #
+  # Invocation example:
+  #
+  #   studium --gui
+  #
+  # ========================================================================= # 
+  def start_gui_component
+    unless ::Studium.const_defined? :GUI
+      require 'studium/gui/gtk2/simple_widget_question_answer.rb'
+    end
+    Studium::GUI::Gtk::SimpleWidgetQuestionAnswer.run_as_standalone_gtk_window
+  end
+
+  # ========================================================================= #
+  # === upload_archive_of_the_exam_questions
+  # ========================================================================= #
+  def upload_archive_of_the_exam_questions
+    Studium.upload_archive_of_the_exam_questions
+  end
+
+  # ========================================================================= #
+  # === lectures_without_exam_entry
+  # ========================================================================= #
+  def lectures_without_exam_entry
+    require 'studium/exams/lectures_without_exam_entry.rb'
+    ::Studium::Exams::LecturesWithoutExamEntry.new
+  end
+
+  # ========================================================================= #
+  # === report_how_many_exam_questions_were_already_solved
+  # ========================================================================= #
+  def report_how_many_exam_questions_were_already_solved
+    require 'studium/toplevel_methods/report.rb'
+    Studium::Exams.report_how_many_exam_questions_were_already_solved
+  end
+
+  require 'studium/toplevel_methods/methods_related_to_files_and_directories.rb'
+  # ========================================================================= #
+  # === copy_lecture_information_file_to_default_location
+  # ========================================================================= #
+  def copy_lecture_information_file_to_default_location
+    Studium.copy_lecture_information_file_to_default_location
+  end
+
+  # ========================================================================= #
+  # === open_relevant_files
+  # ========================================================================= #
+  def open_relevant_files
+    Studium::Exams::UpcomingImportantExams.open_relevant_files
+  end
+
+  # ========================================================================= #
+  # === verbose_open_important_exams
+  # ========================================================================= #
+  def verbose_open_important_exams
+    require 'studium/exams/upcoming_exams/upcoming_exams.rb'
+    opne "Now opening the #{slateblue('important-exams')} "\
+         "file in the editor." 
+    ::Studium.open_important_exams
+  end
+
+  # ========================================================================= #
+  # === create_an_archive_of_the_exam_questions
+  # ========================================================================= #
+  def create_an_archive_of_the_exam_questions
+    Studium.create_an_archive_of_the_exam_questions
+  end
+
+  require 'studium/toplevel_methods/editor.rb'
+  # ========================================================================= #
+  # === permanently_set_this_editor
+  # ========================================================================= #
+  def permanently_set_this_editor(i = :vim)
+    Studium.permanently_set_this_editor(i)
+  end
+
+  # ========================================================================= #
+  # === upcoming_important_exams
+  #
+  # This class seems to no longer exist as of October 2020.
+  # ========================================================================= #
+  def upcoming_important_exams
+    Studium::Exams::UpcomingImportantExams.new
+  end
+
+  # ========================================================================= #
+  # === report_the_difference_to_the_start_time
+  # ========================================================================= #
+  def report_the_difference_to_the_start_time
+    Studium.report_the_difference_to_the_start_time
+  end
+
+
+  # ========================================================================= #
+  # === add_new_exam_question
+  # ========================================================================= #
+  def add_new_exam_question
+    require 'studium/exams/add_exam_question.rb'
+    Studium::Exams::AddExamQuestion.new
+  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
+
+  # ========================================================================= #
+  # === 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/statistics/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 $RUBY_SRC/studium/lib/studium/yaml/statistics.yml &"
+    end
+    e cmd
+    e
+    system cmd
+  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_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_average_grade_of_all_passed_exams
+  # ========================================================================= #
+  def do_show_the_average_grade_of_all_passed_exams
+    require 'studium/exams/average_grade/average_grade.rb'
+    e 'The average grade of all passed exams is '+
+       sfancy(
+         Studium.average_grade(:default, round_to: 2 )
+       )+'.'
+  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_lva_dates_of_this_lecture
+  # ========================================================================= #
+  def show_lva_dates_of_this_lecture(this_theme)
+    Studium.show_lva_dates_of_this_lecture(this_theme)
+  end
+
+  # ========================================================================= #
+  # === parse_commandline_arguments_as_a_full_string
+  #
+  # This method will act on the whole ARGV, as a String rather than
+  # an Array.
+  # ========================================================================= #
+  def parse_commandline_arguments_as_a_full_string
+    _ = return_commandline_arguments_as_string
+    case _
+    # ======================================================================= #
+    # === studium lastexams 10
+    # ======================================================================= #
+    when /-?-?last-?exams (\d+)/
+      _ = $1.to_s.dup.to_i
+      require 'studium/exams/last_exams/last_exams.rb'
+      Studium.show_n_last_exams(_) # Show the last n exams that were passed.
+      exit
+    end
+  end
+
+  # ========================================================================= #
+  # === show_curricula
+  # ========================================================================= #
+  def show_curricula(
+      use_this_file = Studium.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
+
+  # ========================================================================= #
+  # === 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/exams_per_month/exams_per_month.rb'
+    Studium::ExamsPerMonth.new(:dont_run_yet) { '--yearly-average-grades' }
+  end
+
+  # ========================================================================= #
+  # === show_passed_credits_per_curriculum
+  #
+  # Invocation example:
+  #
+  #   studium --passed-ects
+  #
+  # ========================================================================= #
+  def show_passed_credits_per_curriculum
+    require 'studium/ects/show_passed_credits_per_curriculum.rb'
+    Studium.show_passed_credits_per_curriculum
+  end
+
+  # ========================================================================= #
+  # === verbose_update_max_ever
+  # ========================================================================= #
+  def verbose_update_max_ever
+    require 'studium/exams/questions_solved_from_day_to_day/questions_solved_from_day_to_day.rb'
+    e "#{rev}Now updating the max-ever entry of all exam-questions "\
+      "that were answered."
+    e 'This will be stored in the file at '+
+      sfile(FILE_DAILY_QUESTIONS_SOLVED)
+    Studium.update_max_ever_exam_questions_answered
+  end
+
+  # ========================================================================= #
+  # === show_the_current_studyset
+  # ========================================================================= #
+  def show_the_current_studyset
+    _ = FILE_FOR_EXAM_QUESTIONS
+    if File.exist? _
+      this_exam_topic = YAML.load_file(_).strip
+      e 'The current exam-topic, taken from the file '
+      e sfile(_)
+      e 'is `'+sfile(File.basename(this_exam_topic))+'`.'
+    else
+      e 'No file exists at `'+sfile(_)+'`.'
+    end
+  end
+
+  # ========================================================================= #
+  # === show_passed_exams
+  # ========================================================================= #
+  def show_passed_exams
+    ::Studium.show_passed_exams
+  end
+
+  # ========================================================================= #
+  # === upload_pdf
+  # ========================================================================= #
+  def upload_pdf
+    Studium.upload_pdf
+  end
+
+  # ========================================================================= #
+  # === permanently_disable_colours
+  #
+  # To invoke this method, try:
+  #
+  #   studium --permanently-disable-colours
+  #
+  # ========================================================================= #
+  def permanently_disable_colours
+    opne 'The colours in the Studium namespace will be '\
+         'permanently disabled.'
+    into = "#{Studium.yaml_directory?}use_colours.yml"
+    if File.exist? into
+      opne "Storing into the file #{sfile(into)} next."
+      write_what_into(YAML.dump(false), into)
+    end
+  end
+
+  # ========================================================================= #
+  # === show_questions_per_year
+  # ========================================================================= #
+  def show_questions_per_year
+    require 'studium/exams/new_questions_per_year.rb'
+    Studium.show_questions_per_year
+  end
+
+  # ========================================================================= #
+  # === show_ects_passed_per_university
+  # ========================================================================= #
+  def show_ects_passed_per_university
+    require 'studium/ects/ects_per_university/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(Studium.file_log_directory).chomp
+      )
+    )
+    e
+  end
+
+  # ========================================================================= #
+  # === show_max_exam_questions_answered_per_topic
+  # ========================================================================= #
+  def show_max_exam_questions_answered_per_topic(
+      file_max_stats = Studium.file_max_stats
+    )
+    dataset = YAML.load_file(file_max_stats)
+    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_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
+    Open.in_editor(_) 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
+
+  # ========================================================================= #
+  # === show_collage_of_current_exams
+  #
+  # Invoke this method via:
+  #
+  #   studium --collage?
+  #
+  # ========================================================================= #
+  def show_collage_of_current_exams
+    require 'studium/exams/cycle.rb'
+    file = Studium::Exams::Cycle.main_file?
+    array = YAML.load_file(file) 
+    opne 'These entries are currently being tested by class'
+    opne "#{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/exams_per_month/open.rb'
+    Studium::ExamsPerMonth.open_main_files_in_the_editor
+  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_and_sanitize/check_the_lecture_information_file.rb'
+    Studium.check_the_lecture_information_file
+  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_best_month
+  #
+  # To invoke this, try:
+  #
+  #   studium --show-best-month
+  #
+  # ========================================================================= #
+  def show_best_month(i = 10)
+    require 'studium/exams/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.rb'
+    Studium::Exams.report_how_many_exam_questions_were_already_solved
+  end
+
+  # ========================================================================= #
+  # === show_backlog_of_exams
+  # ========================================================================= #
+  def show_backlog_of_exams
+    require 'studium/exams/show_backlog_of_exams.rb'
+    Studium::ShowBacklogOfExams.new
+  end
+
+  require 'studium/ects/return_n_ects_from_this_file.rb'
+  # ========================================================================= #
+  # === 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
+
+  # ========================================================================= #
+  # === start_the_sinatra_interface
+  # ========================================================================= #
+  def start_the_sinatra_interface
+    require 'studium/www/sinatra/app.rb'
+    Studium.start_sinatra_interface
+  end
+
+  # ========================================================================= #
+  # === show_passed_lectures_in_a_bachelor_curriculum
+  # ========================================================================= #
+  def show_passed_lectures_in_a_bachelor_curriculum
+    require 'studium/exams/exams_per_month/exams_per_month.rb'
+    Studium::ExamsPerMonth.show_passed_bachelor_lectures
+  end
+
+  # ========================================================================= #
+  # === note_down_the_start_time_and_how_many_exams_have_been_already_solved
+  # ========================================================================= #
+  def note_down_the_start_time_and_how_many_exams_have_been_already_solved
+    require 'studium/toplevel_methods/note_down_the_start_time_and_how_many_exams_have_been_already_solved.rb'
+    Studium.note_down_the_start_time_and_how_many_exams_have_been_already_solved
+  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/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
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    menu
+  end
+
+  # ========================================================================= #
+  # === mark_all_exam_question_answers_as_undone
+  # ========================================================================= #
+  def mark_all_exam_question_answers_as_undone
+    require 'studium/exams/unsolve_all_questions_from_this_topic.rb'
+    opne 'Now marking all exam-question-answers as undone.'
+    available_topics?.each {|this_topic|
+      Studium.unsolve_all_questions_from_this_topic(this_topic)
+    }
+  end
+
+  # ========================================================================= #
+  # === Studium::Commandline[]
+  # ========================================================================= #
+  def self.[](i = ARGV)
+    new(i)
+  end
+
+end
+
+# =========================================================================== #
+# === Studium.parse_commandline
+# =========================================================================== #
+def self.parse_commandline(i = ARGV)
+  Studium::Commandline.new(i)
+end; self.instance_eval { alias fast_parse_commandline parse_commandline } # === Studium.fast_parse_commandline
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  Studium::Commandline.new(ARGV)
+end # studiumcommandline --help