studium 0.13.1

data/lib/studium/yaml/statistics/statistics.yml

@@ -0,0 +1,69 @@
+# =========================================================================== #
+# === statistics.yml
+#
+# Diese Datei sammelt Daten über die Zahl der Prüfungsfragen und wieviele
+# davon bereits beantwortet wurden. Dies ist für die meisten anderen
+# Anwender relativ irrelevant, daher wird dies auch in der deutschen
+# Sprache festgehalten.
+# =========================================================================== #
+# Am 25.01.2017 wurde erstmals die 500.0 ECTS Punkte Marke gekratzt.
+# =========================================================================== #
+
+# =========================================================================== #
+# Am 01.02.2012 waren es  3.200 Fragen.
+#
+# Am 22.01.2013 waren es  5.989 Fragen, also fast doppelt so viele wie 2012. 
+# Am 01.08.2013 waren es  8.504 Fragen.
+# Am 16.10.2013 waren es  9.440 Fragen.
+# Am 30.11.2013 waren es 10.123 Fragen.
+# Am 14.12.2013 waren es 10.445 Fragen - davon waren  2746 beantwortet (26.29%) [128.5 ECTS]
+#
+# Am 09.02.2014 waren es 11.105 Fragen - davon waren  2899 beantwortet (26.11%)
+# Am 18.03.2014 waren es 11.807 Fragen - davon waren  3288 beantwortet (27.85%)
+# Am 26.04.2014 waren es 12.017 Fragen - davon waren  3671 beantwortet (30.55%)
+#
+# Am 31.05.2014 waren es 12.552 Fragen - davon waren  3695 beantwortet (29.44%)
+# Am 30.08.2014 waren es 13.634 Fragen - davon waren  4051 beantwortet (29.71%)
+# Am 27.11.2014 waren es 14.877 Fragen - davon waren  4431 beantwortet (29.78%)
+# Am 31.12.2014 waren es 15.484 Fragen - davon waren  4846 beantwortet (31.30%) [229.5 ECTS]
+#
+# Am 24.09.2015 waren es 17.507 Fragen - davon waren  5087 beantwortet (29.06%)
+# Am 31.10.2015 waren es 18.214 Fragen - davon waren  5250 beantwortet (28.82%)
+# Am 29.12.2015 waren es 18.903 Fragen - davon waren  5500 beantwortet (29.10%) [351.0 ECTS]
+#
+# Am 08.04.2016 waren es 19.569 Fragen - davon waren  5750 beantwortet (29.38%)
+# Am 25.04.2016 waren es 19.695 Fragen - davon waren  6000 beantwortet (30.46%)
+# Am 31.05.2016 waren es 20.000 Fragen - davon waren  6250 beantwortet (31.20%)
+# Am 13.07.2016 waren es 20.480 Fragen - davon waren  6500 beantwortet (31.74%)
+# Am 19.08.2016 waren es 20.882 Fragen - davon waren  7000 beantwortet (33.52%)
+# Am 20.10.2016 waren es 21.673 Fragen - davon waren  7250 beantwortet (33.45%)
+# Am 22.11.2016 waren es 22.054 Fragen - davon waren  7500 beantwortet (34.01%)
+# Am 01.12.2016 waren es 22.150 Fragen - davon waren  7750 beantwortet (34.99%)
+# Am 25.12.2016 waren es 22.572 Fragen - davon waren  8000 beantwortet (35.44%) [472.5 ECTS]
+#
+# Am 30.01.2017 waren es 23.054 Fragen - davon waren  8250 beantwortet (35.79%)
+# Am 12.02.2017 waren es 23.259 Fragen - davon waren  8500 beantwortet (36.54%)
+# Am 18.03.2017 waren es 23.628 Fragen - davon waren  8750 beantwortet (37.03%)
+# Am 21.09.2017 waren es 25.079 Fragen - davon waren  9000 beantwortet (35.89%) [566.0 ECTS]
+#
+# Am 04.09.2018 waren es 28.692 Fragen - davon waren  9250 beantwortet (32.24%)
+# Am 21.09.2018 waren es 28.975 Fragen - davon waren  8683 beantwortet (29.97%)
+# Am 11.12.2018 waren es 30.517 Fragen - davon waren  9500 beantwortet (31.13%) [677.5 ECTS]
+#
+# Am 07.04.2019 waren es 33.305 Fragen - davon waren  9750 beantwortet (29.27%)
+# Am 16.04.2019 waren es 33.607 Fragen - davon waren 10000 beantwortet (29.76%)
+# Am 16.07.2019 waren es 35.004 Fragen - davon waren 10218 beantwortet (29.19%)
+#
+# Am 02.02.2020 waren es 38.345 Fragen - davon waren 10750 beantwortet (28.03%) [778.5 ECTS]
+# Am 28.06.2020 waren es 40.052 Fragen - davon waren  5000 beantwortet (12.48%) [807.0 ECTS]
+# Am 22.11.2021 waren es 42.019 Fragen - davon waren 10018 beantwortet (23.85%) [834.6 ECTS]
+#
+# Am 31.01.2022 waren es 42.217 Fragen - davon waren 10500 beantwortet (24.87%)
+# Am 27.03.2022 waren es 42.309 Fragen - davon waren 10750 beantwortet (25.41%) [834.6 ECTS]
+# Am 11.04.2022 waren es 42.381 Fragen - davon waren 11000 beantwortet (25.96%)
+# Am 03.06.2022 waren es 42.684 Fragen - davon waren 11200 beantwortet (26.24%)
+# Am 06.06.2022 waren es 42.695 Fragen - davon waren 11250 beantwortet (26.35%)
+# Am 08.06.2022 waren es 42.698 Fragen - davon waren 11300 beantwortet (26.46%)
+# Am 09.09.2022 waren es 43.155 Fragen - davon waren 11500 beantwortet (26.65%)
+#
+# =========================================================================== #

data/lib/studium/yaml/week/01_monday.yml

@@ -0,0 +1,5 @@
+# =========================================================================== #
+# === 2022
+#
+# Am Montag beginnt die Woche. Hier haben wir alle Montag-Termine dabei.
+# =========================================================================== #

data/lib/studium/yaml/week/02_tuesday.yml

@@ -0,0 +1,75 @@
+# =========================================================================== #
+# === (1) 183.579 Technische Grundlagen der Informatik
+# =========================================================================== #
+Vorlesungen sind immer:
+ Di: 10:00-12:00  05.10.2021-18.01.2022  GM 1 Audi. Max.- ARCH-INF  Vorlesung
+  # ^^^ hmmmm. das ist wichtiger als mathematik BOKU AW.
+
+# =========================================================================== #
+# === (2) Uni Wien 301060 UE Praktische Übungen zur Bioinformatik mikrobieller Genome und Metagenome (2022W)
+# =========================================================================== #
+# rf "https://ufind.univie.ac.at/de/course.html?lv=301060&semester=2022W"
+# =========================================================================== #
+GANZ WICHTIG!!!!! Dann gehen aber die Statistik-Übungen an der BOKU nicht.
+Meine Vorausgenehmigung ist genehmigt, somit sollte das hier kein
+Problem sein. \o/
+  Dienstag 04.10.2022 13:15-14:45 Seminarraum 1.4, Biologie Djerassiplatz 1, 1.013, Ebene 1
+  Dienstag 11.10.2022 13:15-14:45 Seminarraum 1.4, Biologie Djerassiplatz 1, 1.013, Ebene 1
+  Dienstag 18.10.2022 13:15-14:45 Seminarraum 1.4, Biologie Djerassiplatz 1, 1.013, Ebene 1
+  Dienstag 25.10.2022 13:15-14:45 Seminarraum 1.4, Biologie Djerassiplatz 1, 1.013, Ebene 1
+  Dienstag 08.11.2022 13:15-14:45 Seminarraum 1.4, Biologie Djerassiplatz 1, 1.013, Ebene 1
+  Dienstag 15.11.2022 13:15-14:45 Seminarraum 1.4, Biologie Djerassiplatz 1, 1.013, Ebene 1
+  Dienstag 22.11.2022 13:15-14:45 Seminarraum 1.4, Biologie Djerassiplatz 1, 1.013, Ebene 1
+  Dienstag 29.11.2022 13:15-14:45 Seminarraum 1.4, Biologie Djerassiplatz 1, 1.013, Ebene 1
+  Dienstag 06.12.2022 13:15-14:45 Seminarraum 1.4, Biologie Djerassiplatz 1, 1.013, Ebene 1
+  Dienstag 13.12.2022 13:15-14:45 Seminarraum 1.4, Biologie Djerassiplatz 1, 1.013, Ebene 1
+  Dienstag 10.01.2022 13:15-14:45 Seminarraum 1.4, Biologie Djerassiplatz 1, 1.013, Ebene 1
+  Dienstag 17.01.2022 13:15-14:45 Seminarraum 1.4, Biologie Djerassiplatz 1, 1.013, Ebene 1
+  Dienstag 24.01.2022 13:15-14:45 Seminarraum 1.4, Biologie Djerassiplatz 1, 1.013, Ebene 1
+  Dienstag 31.01.2022 13:15-14:45 Seminarraum 1.4, Biologie Djerassiplatz 1, 1.013, Ebene 1
+
+
+
+
+
+
+
+# =========================================================================== #
+# === (3) TU Wien Bioorganische Chemie
+# =========================================================================== #
+Dienstag: 16:00-18:00
+^^^ hmm geht das?
+
+# =========================================================================== #
+# === (4) BOKU 914101 Datenanalyse und -management mit R (1SSt UE, WS 2022/23)
+#
+# rf "914101 Datenanalyse und -management mit R"
+# =========================================================================== #
+Di: 13.12.2022, 10:00-11:30  Seminarraum Waldwachstumsforschung (EXNH-DG/27)  Prüfungstermin  fix    Ja
+Di: 11.10.2022, 13:00-14:30  Seminarraum Waldwachstumsforschung (EXNH-DG/27)  Abhaltung  fix
+bis inklusive:
+Di: 06.12.2022 , 13:00-14:30  Seminarraum Waldwachstumsforschung (EXNH-DG/27)  Abhaltung
+# ^^^ das geht aber nit wegen der rattei übung
+
+# =========================================================================== #
+# === 101.275 Einführung in das Programmieren für Technische Mathematik
+#
+# Nit so wichtig: C++ programmieren an der TU Wien
+# =========================================================================== #
+Di.	10:00 - 12:00	11.10.2022 - 24.01.2023
+# ginge auch:
+# aber das hat einen konflikt mit rattei übungen hmm noch überlegen
+# wohl eher nit, da auch technische praxis stattfindet.
+# Di.	10:00 - 12:00	11.10.2022 - 24.01.2023	Sem.R. DB gelb 03 	EPROG Übungsgruppen
+# Di.	10:00 - 16:00	11.10.2022 - 24.01.2023	Sem.R. DC rot 07 	EPROG Übungsgruppen
+# Di.	11:00 - 19:00	11.10.2022 - 24.01.2023	Sem.R. DA grün 04 	EPROG Übungsgruppen
+# Di.	12:00 - 19:00	11.10.2022 - 24.01.2023	Sem.R. DA grün 02 C 	EPROG Übungsgruppen
+# Di.	14:00 - 19:00	11.10.2022 - 24.01.2023	Sem.R. DB gelb 05 A 	EPROG Übungsgruppen
+
+
+
+
+# =========================================================================== #
+# BOKU Mathematik:
+# =========================================================================== #
+Di: 04.10.2022	10:00	11:30	SR 01 / MENH [HS I] (MENH-EG/09)

data/lib/studium/yaml/week/03_wednesday.yml

@@ -0,0 +1,62 @@
+# =========================================================================== #
+# === Mittwoch tag, Mi tag, Mitag
+#
+# Wintersemester 2012.
+# =========================================================================== #
+# Aktuell: 11.10.2022
+# =========================================================================== #
+
+-------------------------------------------------------------------------------
+(1)  
+940301 Structure and analysis of genomes (in Eng.)
+^^^ dies vermutlich jeden mittwoch in der früh.
+09:00-10:30 mal sehen. das hat aber einen konflikt mit
+790395 Infectious diseases and vaccines (in Eng.) (2SSt VS, WS 2022/23)
+hmmmmmmmmm.
+-------------------------------------------------------------------------------
+790044 Sicherheit am Arbeitsplatz (2SSt VU, WS 2022/23)
+
+  rf "790044 Sicherheit am Arbeitsplatz"
+
+Mi: 05.10.2022, 14:30-17:45	MUG3-SR 13 (MUG3-EG/07)
+^^^ bis 30.11.2022, hmmm ... wäre zu überlegen
+
+  Mi: 05.10.2022	14:30	17:45	SR 03 / MUG3 [SR 13] (MUG3-EG/07)	Abhaltung	fix		
+  Mi: 12.10.2022	14:30	17:45	SR 03 / MUG3 [SR 13] (MUG3-EG/07)	Abhaltung	fix		
+  Mi: 19.10.2022	14:30	17:45	SR 03 / MUG3 [SR 13] (MUG3-EG/07)	Abhaltung	fix		
+  Mi: 09.11.2022	14:30	17:45	SR 03 / MUG3 [SR 13] (MUG3-EG/07)	Abhaltung	fix		
+  Mi: 16.11.2022	14:30	17:45	SR 03 / MUG3 [SR 13] (MUG3-EG/07)	Abhaltung	fix		
+  Mi: 23.11.2022	14:30	17:45	SR 03 / MUG3 [SR 13] (MUG3-EG/07)	Abhaltung	fix		
+  Mi: 30.11.2022	14:30	17:45	SR 03 / MUG3 [SR 13] (MUG3-EG/07)	Abhaltung	fix
+	
+-------------------------------------------------------------------------------
+790395 Infectious diseases and vaccines (in Eng.) (2SSt VS, WS 2022/23)
+Mi: 05.10.2022 08:30-10:00	Sem.Raum Mikrobiologie 05/08 (MUG1-05/08)	Abhaltung	fix
+-------------------------------------------------------------------------------
+Modern Bioinformatics:
+Mi 05.10.2022	17:00-18:30	Schulungsraum Linux-Raum (BOKU-IT) (MUG3-EG/32)
+-------------------------------------------------------------------------------
+500055 Bakteriologie für Biomediziner (1SSt VO, WS 2022/23)
+tandardgruppe
+Mi: 	05.10.2022	14:00	15:00	Hörsaal M (HA06X05)	Abhaltung	
+-------------------------------------------------------------------------------
+
+ Gruppe 
+Tag 	
+Datum 
+	
+von 
+	
+bis 
+	
+Ort 
+	Ereignis 	Termintyp 	
+Lerneinheit 
+	
+Vortragende:r 
+	Anmerkung 	ZT
+ 
+Standardgruppe
+Mi
+	12.10.2022	09:00	11:00	Hörsaal D (GA06X49)	Abhaltung	geplant
+	

data/lib/studium/yaml/week/04_thursday.yml

@@ -0,0 +1,14 @@
+# =========================================================================== #
+# === Donnerstag tag, Do tag, Dotag
+#
+# Donnerstag, 06.10.2022
+# =========================================================================== #
+
+# =========================================================================== #
+# === Mikroskopie an Biomolekülen
+# =========================================================================== #
+Mi.	14:00-16:00, 05.10.2022-25.01.2023
+^^^ Übung
+
+16:00 - 18:00, 06.10.2022-26.01.2023
+^^^ Vorlesung

data/lib/studium/yaml/week/05_friday.yml

@@ -0,0 +1,31 @@
+# =========================================================================== #
+# === Freitag tag, Fr tag
+#
+# Lehrveranstaltungen die wichtig sind gehören nach oben platziert.
+#
+# Freitag, 07.10.2022
+# =========================================================================== #
+
+# =========================================================================== #
+# === 362.181 Wissenschaftliches Programmieren in Python
+# =========================================================================== #
+Python programmieren an TU Wien:
+Freitag: 14:00-16:00, von 07.10.2022-18.11.2022
+jeden Freitag
+
+# =========================================================================== #
+# === 851309 Statistics with R (in Eng.) (2SSt VU, WS 2022/23)
+# =========================================================================== #
+Fr: 07.10.2022	11:00	12:30	EXNH-HS 03 (EXNH-01/55)	Abhaltung	fix
+jeden freitag hmmmmm.... hat aber konflikt mit technischen grundlagen
+der informatik. Hmmmm.
+
+# am 07.10 ist Einstufungstest K2 für Java Programmieren an der TU Wien
+
+# =========================================================================== #
+# === 101.275 Einführung in das Programmieren für Technische Mathematik
+#
+# Nit so wichtig: C++ programmieren an der TU Wien, die VO
+# =========================================================================== #
+Fr.	10:00-12:00, 07.10.2022-20.01.2023 # ist aber nur VO, nicht Übung.
+# und Abschlusstest: Fr. 09:00-12:00, 03.02.2023,  Ort: FH 8 Nöbauer HS - MATH, EPROG Test

data/lib/studium/yaml/week/06_saturday.yml

@@ -0,0 +1,16 @@
+# =========================================================================== #
+# === Samstag tag
+#
+# Samstag, 14.10.2017
+# =========================================================================== #
+
+# =========================================================================== #
+# === Einführung in die Chemie an der BOKU am Vormittag
+# =========================================================================== #
+Sa: 07.10.2017
+^^^ hmmm ...
+
+# =========================================================================== #
+# Technische Grundlagen der Informatik. Ist wichtiger als BOKU-Chemie.
+# =========================================================================== #
+Samstag 07.10.2017, 09:50-12:55 Audimax Zentrum für Translationswissenschaft, Gymnasiumstraße 50

data/lib/studium/yaml/week/README.md

@@ -0,0 +1,13 @@
+The .yml files in this directory can be used to indicate at
+which particular day you have certain lectures. That way
+the studium gem can, in principle, calculate a calendar
+as well as different time constraints (such as via
+overlapping courses).
+
+The reason why the files have a leading number, e. g.
+"01_monday.yml" rather than "monday.yml", was purely a
+convenience thing. I wanted the .yml files to be 
+sorted by date, without having to write custom logic,
+so using a leading number made sense. And I like the
+leading "0" too, so this is mostly just a personal
+preference really.

data/lib/studium.rb

@@ -0,0 +1,5 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'studium/requires/require_the_studium_project.rb'

data/studium.gemspec

@@ -0,0 +1,80 @@
+# =========================================================================== #
+# Gemspec for Project Studium.
+# =========================================================================== #
+require 'studium/version/version.rb'
+require 'studium/toplevel_methods/n_questions_available.rb'
+require 'roebe'
+
+Gem::Specification.new { |s|
+
+  s.name    = 'studium'
+  s.version = ::Studium::VERSION
+  s.date    = Time.now.strftime('%Y-%m-%d')
+
+  DESCRIPTION = <<-EOF
+
+This project is called "studium", which is the german word for 
+"studies".
+
+The project attempts to be of help in study-related and 
+exam-related aspects, in particular for universities in
+central europe - although with a focus on the german-speaking
+areas, primarily; courses in english are available as well,
+but the focus is still on central europe at best, not
+elsewhere, out of necessity and proximity reasons alone.
+
+An additional use case is to simply train your knowledge
+about different topics, independent of any university or
+high school.
+
+The studium-project presently contains
+#{Studium.n_questions_in_total?} question-answer entries.
+
+For additional documentation, please consider visiting the
+following link directly:
+
+https://www.rubydoc.info/gems/studium/
+
+EOF
+
+  s.summary     = DESCRIPTION
+  s.description = DESCRIPTION
+
+  # ========================================================================= #
+  # Show this message when a user installs this project.
+  # ========================================================================= #
+  s.post_install_message = <<-EOF
+
+For a more complete documentation, look at the following URL:
+
+  #{Studium::URL_TO_THE_DOCUMENTATION}
+
+Thank you and may ruby be to your benefit.
+
+  EOF
+  
+  s.extra_rdoc_files = %w()
+
+  s.authors     = ['Robert A. Heiler']
+  s.email       = Roebe.email?
+  s.files       = Dir['**/*']
+  s.license     = 'MIT'
+  s.executables = Dir['bin/*'].map { |f| File.basename(f) }
+  s.homepage    = 'https://www.rubydoc.info/gems/studium/'
+
+  s.required_ruby_version     = '>= '+Roebe.third_most_stable_version_of_ruby
+  s.required_rubygems_version = '>= '+Gem::VERSION
+  s.rubygems_version          = '>= '+Gem::VERSION
+
+  # ========================================================================= #
+  # External dependencies for the project:
+  # ========================================================================= #
+  s.add_dependency 'cliner'
+  s.add_dependency 'colours'
+  s.add_dependency 'find_line_in_file'
+  s.add_dependency 'html_tags'
+  s.add_dependency 'opn'
+  s.add_dependency 'prawn'
+  s.add_dependency 'xorg_buffer'
+
+}

data/test/testing_studium.rb

@@ -0,0 +1,244 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'cliner'
+require 'colours/colours_e_autoinclude.rb'
+require 'studium' # Do "include Studium" automatically.
+require 'verbose_truth/autoinclude'
+
+# =========================================================================== #
+# === crimson
+# =========================================================================== #
+def crimson(i)
+  ::Colours.crimson(i)
+end
+
+e 'Welcome to the Studium project.'
+e
+e 'Next, we will run some tests to ensure that the desired functionality'
+e 'is working.'
+e
+e 'We will start with two important constants:'
+e
+e orange('  Studium::PROJECT_BASE_DIRECTORY')
+e
+e 'The value for Studium::PROJECT_BASE_DIRECTORY is:'
+e
+e '  '+sfancy(Studium::PROJECT_BASE_DIRECTORY)
+e
+e orange('Studium::Exams::PROJECT_BASE_DIRECTORY')
+e
+e 'The value for Studium::Exams::PROJECT_BASE_DIRECTORY is:'
+e
+e '  '+sfancy(Studium::Exams::PROJECT_BASE_DIRECTORY)
+e
+cliner
+e
+e 'Next, we will test the value of '+sfancy('Studium::PROJECT_YAML_DIRECTORY')+':'
+e
+e orange('  '+Studium::PROJECT_YAML_DIRECTORY)
+e
+cliner
+e 'So far, so good!'
+e
+e 'Does the Studium project try to make use of colours?'
+e
+e sfancy("  #{VerboseTruth[Studium.use_colours?]}")
+e
+cliner
+e 'Next, we will test some module-methods on the '+
+   slateblue('Studium namespace')+'.'
+e
+cliner
+e 'The log directory is this one here:'+
+  sdir('  '+Studium.determine_log_directory)
+e
+cliner
+e 'How many ECTS points were passed? We can answer this with '\
+  'the method called '+orange('Studium.total_ects_points_passed')
+e
+e '  '+sfancy(Studium.total_ects_points_passed.to_s)+' ECTS points were passed so far.'
+cliner
+e 'The next component that will be tested is the "available exam topics".'
+e 'As this may output a very long list, we will show only 6 exam '\
+  'topics rather than many more.'
+# =========================================================================== #
+# Display the available topics.
+# =========================================================================== #
+cliner {
+  e ::Colours.royalblue('The available exam-topics are '\
+    '(showing only 6):')
+  Studium.display_available_topics(6)
+}
+e
+e 'We also have completed some exams. We will next display the 3 most'
+e 'recent exams that were passed.'
+e
+Studium.names_of_all_solved_exams(3).each {|exam| e "  #{sfancy(exam)}" }
+e
+e 'Alright! Next we will test the functionality of '+
+  orange('Studium.is_this_exam_topic_included?')+'.'
+e
+e 'Is the exam topic `amg` included? '+sfancy(
+  VerboseTruth[Studium.is_this_exam_topic_included?('amg')]
+)
+e
+e 'How many exam topics are available in total? '+
+  sfancy(Studium.n_exam_topics_available?.to_s)
+e
+e 'And how many questions are available? '+
+  sancy(Studium::Exams::Dataset[].size.to_s)
+e
+e 'The version of Studium is:'
+e '  '+crimson(Studium::VERSION.to_s)
+e
+e 'Next, we will test the functionality of `'+
+  orange('Studium.already_solved_this_lva_number?')+'` (LV-ID: 300211).'
+e
+e Studium.already_solved_this_lva_number? '300211'
+e
+e 'Next we will test the method '+orange('Studium.report_how_many_exam_questions_were_already_solved')+'.'
+e
+Studium.report_how_many_exam_questions_were_already_solved
+e
+# =========================================================================== #
+# Next querying how many exam questions were already solved.
+# =========================================================================== #
+cliner {
+  e 'Next querying how many exam questions were already solved:'
+  Studium::Exams.report_how_many_exam_questions_were_already_solved(
+    :default, :gui
+  )
+}
+e
+
+# =========================================================================== #
+# First, instantiate the main dataset.
+# =========================================================================== #
+dataset = Studium::Exams::Dataset[]
+
+# =========================================================================== #
+# Text question-answer parsing so that we can detect bugs more rapidly.
+# =========================================================================== #
+e 'Next testing question-answer parsing:'
+_ = '- Give an extreme example of introns in eukaryotic genes. A: The "pro-alpha-2 collagen" gene; it contains 50 introns. URL: http://www.ncbi.nlm.nih.gov/UniGene/clust.cgi?UGID=704301&TAXID=9606&SEARCH=pro-alpha-2%20collagen'
+pp Exams.question_answer(_)
+
+_ = '- F-Faktor hat n states? Beschreibe sie?. A: Der F-Fakter hat zwei states: den \"Plasmid state\" und den "Integrated state".'
+pp Exams.question_answer(_)
+
+_ = '- In genetics, what do we mean with "5-BrU"? 5-Bromouracil. URL: http://en.wikipedia.org/wiki/5-Bromouracil'
+pp Exams.question_answer(_)
+
+_ = '- Nenne 3 bekannte Vertreter der Süßgräser (Poaceae). A: Alle Getreide wie "Weizen", "Gerste" und "Reis" zählen zu dieser Pflanzengruppe.'
+pp Exams.question_answer(_)
+
+_ = '- Def. Opine! A: Dies sind Kondensationsprodukte aus einer "Aminosäure" und einer "Ketosäure", oder einer "Aminosäure" und einem "Zucker". Mit anderen Worten, die Aminosäure ist immer ein Bestandteil eines Opin; der andere Bestandteil ist entweder eine Ketosäure oder ein Zucker.'
+pp Exams.question_answer(_)
+
+#exit # Debug-exiting here for now.
+cliner
+pp dataset.class
+pp dataset
+
+p Exams.clinicalmicrobiology
+e crimson('This Array has '+Exams.clinicalmicrobiology.size.to_s+' entries.')
+p Exams.technische_chemie
+e crimson('This Array has '+Exams.technische_chemie.size.to_s+' entries.')
+e
+e 'We will next find out the encoding of the first element there:'
+e '  '+crimson(Exams.clinicalmicrobiology.first.encoding.to_s)
+e
+e 'Self-Encoding is:'
+e '  '+crimson(__ENCODING__.to_s)
+e
+# =========================================================================== #
+# Testing the runmodes:
+# =========================================================================== #
+cliner {
+  e ::Colours.slateblue('Testing Exams.runmode?'); e
+  e '  '+crimson(Exams.runmode?)
+  Exams.set_runmode :www
+  e '  '+crimson(Exams.runmode?)
+}; e
+# =========================================================================== #
+# Testing the current exams next:
+# =========================================================================== #
+cliner {
+  e ::Colours.slateblue('The current exams are:'); e
+  pp Exams.current_exams
+}; e
+cliner {
+  e 'Next showing all available topics:'
+  pp Exams.all_topics
+  e 'The encoding of entry [3] is: '+crimson(Exams.all_topics[3].encoding.to_s)
+}
+# =========================================================================== #
+# Testing Studium::Exams::SanitizeTopics next:
+# =========================================================================== #
+cliner {
+  e ::Colours.slateblue('We will next test Exams::SanitizeTopics:'); e
+  pp Studium::Exams::SanitizeTopics['amg1'] # The first entry will be the title, the second one the dataset.
+  e Studium::Exams::SanitizeTopics.sanitize_topic('amg2').first # Grab the title here.
+  e 'We also test whether SanitizeTopics can output something directly via SanitizeTopics.e'
+  Studium::Exams::SanitizeTopics.e 'Hello World!'
+}; e
+# =========================================================================== #
+# Testing whether we include several topics:
+# =========================================================================== #
+cliner {
+  e ::Colours.slateblue('We will next test whether we have '+
+    'several topics, via Exams.include_topic?'); e
+  e 'amg1 included?  '+vt(Studium::Exams.include_topic? 'amg1')
+  e 'cell included?  '+vt(Studium::Exams.include_topic? 'cell')
+  e 'amg2 included?  '+vt(Studium::Exams.include_topic? 'amg2')
+  e 'bech2 included? '+vt(Studium::Exams.include_topic? 'bech2')
+}; e
+pp SanitizedDataset.new 'invalid'
+pp SanitizedDataset.new 'amg1'
+pp SanitizedDataset.new('amg2').debug
+sanitized_dataset = SanitizedDataset.new('agrarökologie')
+pp sanitized_dataset.n_questions?
+# We don't test AskExamQuestion here for now.
+# ask_question = Exams::AskExamQuestion.new 'agraröko'
+# pp ask_question
+# =========================================================================== #
+# We next test ExamQuestionsLine.
+# =========================================================================== #
+cliner {
+  e ::Colours.slateblue('Next testing Exams::ExamQuestionsLine'); e
+  _ = Exams::ExamQuestionsLine.new(:dont_run_yet)
+  _.run
+  _.report
+  e
+  e 'The last question asked was: '+crimson(_.last_question_asked)
+  e
+}; e
+# =========================================================================== #
+# Next testing Exams.include_topic?
+# =========================================================================== #
+cliner {
+  e 'Next testing '+::Colours.royalblue('.include_topic?')+' functionality:'
+  e 'Include `amg`?  '+crimson(vt(Studium::Exams.include_topic? :amg))    # Must give us back: "true"
+  e 'Include `test`? '+crimson(vt(Studium::Exams.include_topic? :test))   # Must give us back: "false"
+  e 'Include `genex`? '+crimson(vt(Studium::Exams.include_topic? :genex)) # Must give us back: "true"
+}; e
+# Next testing whether the disabling of colours works.
+Studium::Exams::AskExamQuestion.new
+cliner {
+  e 'Next, we will test whether disabling of colours actually works or not.'
+  Studium.disable_colours
+}; e
+Studium::Exams::AskExamQuestion.new
+
+dataset = Studium::Exams::Dataset[]
+pp dataset
+p Studium::Exams.clinicalmicrobiology # CLINICAL_MICROBIOLOGY 
+p Studium::Exams.test_question_answer '- Name a way to deal with complex pedigrees in population genetics. A: By making use of the "tabular method".'
+cliner
+# Display the directory to the exam-topics next:
+e 'The directory to the exam topics is at:'
+e
+e "  #{sfancy(Studium.exam_topics?)}"
+e

data/test/testing_studium_base_class.rb

@@ -0,0 +1,17 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'cliner'
+require 'colours/colours_e_autoinclude.rb'
+require 'verbose_truth/autoinclude'
+require 'studium/base/base.rb'
+
+cliner
+e
+e 'This file will test class Studium::Base next.'
+e
+cliner
+e
+base = Studium::Base.new
+pp base.obtain_lectures_from_this_curriculum

data/test/testing_time_component.rb

@@ -0,0 +1,29 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'studium'
+require 'cliner'
+require 'colours/colours_e_autoinclude.rb'
+e
+e 'Now testing the time-component (time-related functionality) of the'
+e sfancy('studium')+' project.'
+e
+
+test_this_time = '2020-11-30 15:00:00 -2000'
+cliner
+e test_this_time
+cliner
+
+string_as_result = Studium.return_dd_mm_yyyy(
+  Time.parse(
+    test_this_time
+  )
+)
+e string_as_result
+cliner
+parsed_time = Time.parse(string_as_result)
+pp parsed_time
+cliner
+pp Studium.normalize_time(parsed_time)
+cliner