studium 0.9.383

data/doc/TODO_FOR_STUDIUM_GEM.md

@@ -0,0 +1,119 @@
+--------------------------------------------------------------------------------
+(1) - Add a Web component interface so that we can ask the questions
+      via a .cgi file as well.
+^^^
+--------------------------------------------------------------------------------
+(2) theme of exams ... eventuell. Yup langsam entfernen. Aber das hat
+keine riesige Priorität.
+
+    bl /home/x/studium/YAML/theme_of_exams.yml
+
+
+^^^ eliminieren und in lecture_information integrieren, dann
+   uploaden.
+
+in file_lecture integrieren... dann hätten wir auch alle
+alten... na das geht nicht, wir müssen wohl
+duplikate verwenden. aber mach das dennoch damit wir
+mal all die information haben.
+also mal die alten prüfungen durcharbeiten... beginnend
+mit 2009 oder so.
+
+^^^
+nach dem rewrite noch doku hinfzuügen
+dann das gane hochladen.
+^^^ doku fehlt noch tja..
+--------------------------------------------------------------------------------
+- We need to automatically register for a specific exam at a specific
+  date, without being forced to manually do so.
+--------------------------------------------------------------------------------
+In www/*cgi, we need a dropdown box, and also a way to select between
+different curricula, for display - and pretty the output too, since
+some things are broken.
+
+^^^^^^ hmm
+should perhaps rewrite the studium project......
+after rewriting the cyberweb project. :P
+
+--------------------------------------------------------------
+- We need an easier way to find out when a question has been
+  asked happened.
+
+  Add some way for the studium gem to see which answers were
+  asked during the last run or something like that... hmm some
+  log file or so...
+
+   and then document it too.
+   perhaps just make some log that logs into a file.
+Stored as a hash in a yaml file.
+
+  Studium::Log::StoreLastQuestionAskedIntoFile
+  ^^^ That log now exists, but what is still missing is a
+  way to easily check whether a question was already asked
+  or not. Perhaps we need a second "solved" alias that also
+  checks whether the question has already been asked or not
+  today.
+--------------------------------------------------------------------------------
+- Extend the gtk-GUI component:
+
+  -> Add a search box where we can select a topic such as:
+     "evo" ENTER
+     -> will jump to the right entry.
+
+  This can possibly be implemented via Gtk::EntryCompletion.
+
+--------------------------------------------------------------------------------
+(3) - We need a way to toggle the state of an exam.
+
+"qa misc ALL_SOLVED" # this will tag the string ' []' to each line
+
+qa misc ALL_SOLVED
+
+------------------------------------------------------------------------------
+(5)
+
+in the studium gem,
+
+we could create new gtk3-bindings for some parts
+
+hmmm
+
+display everything in a single app with tabs or so
+
+with individual widgets
+
+^^^ yeah \o/
+
+------------------------------------------------------
+
+
+lvaexpander 19.12.2019-04.01.2020
+
+
+
+Traceback (most recent call last):
+        12: from /home/x/DATA/PROGRAMMING_LANGUAGES/RUBY/src/studium/lib/studium/utility_scripts/expand_time_range.rb:375:in `<main>'
+        11: from /home/x/DATA/PROGRAMMING_LANGUAGES/RUBY/src/studium/lib/studium/utility_scripts/expand_time_range.rb:375:in `new'
+        10: from /home/x/DATA/PROGRAMMING_LANGUAGES/RUBY/src/studium/lib/studium/utility_scripts/expand_time_range.rb:50:in `initialize'
+         9: from /home/x/DATA/PROGRAMMING_LANGUAGES/RUBY/src/studium/lib/studium/utility_scripts/expand_time_range.rb:341:in `run'
+         8: from /home/x/DATA/PROGRAMMING_LANGUAGES/RUBY/src/studium/lib/studium/utility_scripts/expand_time_range.rb:312:in `expand_and_show_the_dates_in_between'
+         7: from /home/x/DATA/PROGRAMMING_LANGUAGES/RUBY/src/studium/lib/studium/utility_scripts/expand_time_range.rb:292:in `return_array_of_days_between_this_start_and_this_end_range'
+         6: from /home/x/DATA/PROGRAMMING_LANGUAGES/RUBY/src/studium/lib/studium/utility_scripts/expand_time_range.rb:302:in `remove_weekends_from_this_array'
+         5: from /home/x/DATA/PROGRAMMING_LANGUAGES/RUBY/src/studium/lib/studium/utility_scripts/expand_time_range.rb:302:in `reject'
+         4: from /home/x/DATA/PROGRAMMING_LANGUAGES/RUBY/src/studium/lib/studium/utility_scripts/expand_time_range.rb:303:in `block in remove_weekends_from_this_array'
+         3: from /home/Programs/Ruby/2.6.5/lib/ruby/site_ruby/2.6.0/studium/base/time.rb:254:in `weekday?'
+         2: from /home/Programs/Ruby/2.6.5/lib/ruby/2.6.0/time.rb:375:in `parse'
+         1: from /home/Programs/Ruby/2.6.5/lib/ruby/2.6.0/time.rb:266:in `make_time'
+/home/Programs/Ruby/2.6.5/lib/ruby/2.6.0/time.rb:266:in `local': mon out of range (ArgumentError)
+
+^^^ fix this
+
+--------------------------------------------------------------------------------
+
+theme_of_exams.yml
+
+^^^ this is deprecated - should be removed in the long run.
+
+- Im sinatra-interface: add  class Studium::Exams::UpcomingExams
+  wir sollten eine toplevel-methode ^^^ da machen. dann ist
+  das displayen auch einfacher.

data/doc/deprecated.md

@@ -0,0 +1,18 @@
+This file lists some classes that can be considered semi-deprecated.
+
+At some later point in the future they may be removed; or rewritten.
+
+(1) Studium::ShowLecturesOfThisCurriculumAsTable
+
+This depended on hardcoded local files (e. g. descriptions to 
+lectures stored in .md files).
+
+As the studium project no longer uses this, the class was no longer
+doing its old job.
+
+A partial replacement has been written to at the least show the
+descriptions of lectures belonging to a particular curriculum.
+
+The name of that class is:
+
+    Studium::ShowDescriptionsOfLecturesBelongingToThisModule

data/doc/documentation_for_the_file_lecture_information.md

@@ -0,0 +1,259 @@
+This file contains information about the format used in the file
+called "lecture_information.yml".
+
+Ideally you should store ONLY lectures that are:
+
+  (a) important to you
+  (b) difficult to obtain in an automated manner
+
+The format of the file must be like this:
+
+  lecture_id name of the lecture
+
+Available entries are:
+
+  !ruby/symbol ects: 2.0
+  !ruby/symbol university: BOKU
+  !ruby/symbol language: english
+  !ruby/symbol type: VO
+  !ruby/symbol semester: summer
+  !ruby/symbol grade: 2
+
+Grade is the grade of the passed lecture, e. g. 1 or 2 or 3 or 4 or 5.
+
+type: can be of VO, VU, UE, PR, SE, VO+SE right now.
+
+The entry "!ruby/symbol currently_participating_in_this_course"
+is false by default. If true then we are currently participating
+in this course. This may then be colourized a bit more intently
+by some classes of the studium-gem. Other than that it is not
+a hugely important entry, but if you are presently attending a
+given lecture, it is recommended to toggle this entry to true.
+
+Next follows a line for this that can be used for copy/pasting,
+if you are participating in this course:
+
+  !ruby/symbol currently_participating_in_this_course: true
+
+The entry "!ruby/symbol semester:" can be of the following three
+values:
+
+  winter
+  summer
+  both
+
+This means that a lecture is either offered during the winter-course
+only, during the summer-course only, or in both terms.
+
+---------------------------------------------------------------------
+
+The entry 'registered_for_an_upcoming_exam_at:' can be used to
+denote an upcoming exams. If you wish to take an exam at a specific
+date, but haven't yet registered for it, you can use the entry
+called 'not_yet_registered_for_an_upcoming_exam_at' instead, and
+lateron change it to 'registered_for_an_upcoming_exam_at' when
+you have registered indeed.
+
+---------------------------------------------------------------------
+
+The optional symbol-entry !ruby/symbol exam_registration_at:
+determines at which point one can register for a given exam.
+This allows us to plan ahead at which point we can register.
+
+An example how this looks like will be shown next:
+
+  !ruby/symbol exam_registration_at:
+   - "02.08.2019, 08:00"
+
+---------------------------------------------------------------------
+
+The entry 'vorbesprechung' is to be used to denote at which time
+preliminary meetings are to be held for the given lecture at hand.
+This is sometimes necessary in order to partake in a practical
+course that allows only a limited number of students to
+participate.
+
+The entry curricula should be kept within single quotes aka
+'' rather than "". This has no particular reason other than
+enforcing the same quote-style.
+
+The symbol called priority_points can be used to denote which
+lectures are especially important in a curriculum. This can
+then be used to automatically determine which lectures should
+be integrated into a individual curriculum. Presently, the
+maximum amount of points that can be used here is 1000 - only
+one lecture may have this value. Then comes 999, 998 and so
+forth. ( !ruby/symbol priority_points: 1000 )
+
+The array at 'lecturers' denotes which lecturers hold this given
+lecture. This may change from semester to semester, and thus is
+quite volatile; I recommend to not pay too much attention to it
+and to not become too dependent on the information.
+
+The entry !ruby/symbol is_a_steop_lecture: true means that the given
+lecture is a STEOP lecture - part of a STEOP phase. By default, all
+lectures have false at this setting.
+
+The entry !ruby/symbol outdated_lecture: true means that the lecture
+is no longer offered by the given university. In other words, it can
+no longer be used for an individual curriculum.
+
+The entry "!ruby/symbol description: |", without the quotes, can be
+used to describe the lecture at hand. This may happen in any
+language. For example, I use german for lectures that are held
+in german in universities of austria.
+
+The entry "lva_dates" denotes the dates of these lectures, e. g.
+when this lecture is being held.
+
+The entry "!ruby/symbol module:", an Array, denotes to which modules
+this entry belongs to. This can be useful for automatically inferring
+which lectures belong to which module. A longer name is useful here,
+as the chance to conflict with modules listed in different curricula
+but named the same, is lessened. If there is more than one entry
+listed here then this means that this may belong to more than one
+curriculum. In this case we will favour the first entry, IF we have
+to favour any entry at all that is. Note that the entry
+"!ruby/symbol individual_curriculum_module:" is like the entry
+"!ruby/symbol module:" except that it is only valid for my
+individual curriculum.
+
+The entry "!ruby/symbol depends_on_these_modules:" denotes on
+which other modules this module depends. The similar entry called
+"!ruby/symbol individual_curriculum_depends_on_these_modules:"
+is valid for lectures that are part of an individual curriculum.
+I needed to use separate entries here so that we can still keep
+track of "official" curricula with their module-system.
+
+The entry "!ruby/symbol description_in_english: |" is guaranteed to
+be an english representation of the content of said lecture. It is
+especially useful if you wish to describe your curriculum to an
+audience that understands the english language rather than the
+german language.
+
+The entry !ruby/symbol homepage: should point to the most important
+URL of this lecture - the homepage. This will also be used to
+autogenerate a .rb file that holds a menu pointing to these remote
+URLs, via a case/when menu interface (and regexes inside that).
+This allows us to programmatically open these remote URLs from
+shorter input.
+
+The entry !ruby/symbol moodle: can be used to point to the course's
+online resources, which typically makes use of the moodle software.
+
+Since as of July 2019, the exam-type can be specified. Valid specifications
+right now include written, oral, and single choice or multiple choice for
+this setting. The entry that governs this is called
+!ruby/symbol exam_format. 5 different formats can be used here.
+
+Examples:
+
+    !ruby/symbol exam_format: single_choice
+    !ruby/symbol exam_format: multiple_choice
+    !ruby/symbol exam_format: oral
+    !ruby/symbol exam_format: written
+    !ruby/symbol exam_format: continuous_presence
+
+The entry:
+
+ !ruby/symbol sws: 3.0
+
+refers to "Semesterwochenstunden". This is the number of hours per
+week of this course, per semester. So a value of 3.0 means that the
+students have to invest 3 hours per week into the lecture directly,
+e. g. via participation on-site. (The number of ECTS required for
+a given course is a more useful indicator, though.)
+
+The entry:
+
+  !ruby/symbol sws:  2.0
+
+refers to "Semesterwochendstunden", aka hours taught per given week,
+where students may attend to the course and learn something new
+(hopefully). It is vaguely related to the ects: entry, but not as
+important anymore in my opinion.
+
+---------------------------------------------------------------------
+
+The entry:
+
+  !ruby/symbol boku_three_pillars: 40/50/10
+
+is important only at the BOKU, since the BOKU makes use of a 
+"three pillars" concept.
+
+---------------------------------------------------------------------
+
+The entry:
+
+  !ruby/symbol url_to_exam_questions: https://www.univie.ac.at/stv-biologie/forum/viewtopic.php?f=120&t=17017
+
+can be used to provide an URL to some exam questions for a given
+lecture; usually compiled by the students. This may also include
+old (outdated) exam questions, so keep this in mind.
+
+---------------------------------------------------------------------
+
+The entry:
+
+  !ruby/symbol wiki: https://vowi.fsinf.at/wiki/TU_Wien:Betriebssysteme_VO_%28Puschner%29
+
+can be used to provide an URL to the wiki of a course; typically
+this refers to a wiki maintained and operated by the students,
+but it may also refer to any wiki in general.
+
+---------------------------------------------------------------------
+
+The entry:
+
+  !ruby/symbol university:
+
+has these valid possibilities: BOKU, TU Vienna.
+
+---------------------------------------------------------------------
+
+The entry:
+
+  !ruby/symbol url_to_exam_registration: https://online.boku.ac.at/BOKUonline/wbExamOffer.wbExamsOfCourse?pCourseNr=288193
+
+can be used to register a direct URL to the exam registration.
+That way the user can quickly open that URL and register for
+such an exam.
+
+---------------------------------------------------------------------
+
+The entry:
+
+  !ruby/symbol url_to_videos: https://www.youtube.com/channel/UCSTgIH6RlNWn_FCN5TpSRgw/
+
+can be used to denote the URL to some videos associated with a lecture.
+That way the user can quickly watch important videos.
+
+Currently this is limited (or encouraged to limit) to only one entry,
+but in the future this may have to become an Array, to allow multiple
+video entries instead.
+
+---------------------------------------------------------------------
+
+The entry:
+
+  !ruby/symbol is_an_elective_course: true
+
+refers to an elective course, a "Wahlfach". The default value here is
+false.
+
+The reason why this was added was so that a script can calculate how
+many elective courses are part of a given individual curriculum at
+hand. I am not sure if this is really necessary, but in the worst
+case it simply is additional information, so no real harm done when
+it is used.
+
+---------------------------------------------------------------------
+
+The entry:
+
+  !ruby/symbol zoom_link: https://bokuvienna.zoom.us/j/215409204
+
+can be used to specify a specific zoom link to a lecture. This
+will not work for all lectures, naturally, but simply can be
+used as providing additional information.

data/doc/elegant_colours.md

@@ -0,0 +1,20 @@
+For exam questions and the corresponding answers, I consider the
+following foreground colours to be elegant on a black background:
+
+For questions:
+
+- teal
+- lightseagreen
+- lime
+- peru
+
+For answers:
+
+- steelblue
+- mediumturquoise
+- mediumseagreen
+- springgreen (for true emphasis)
+
+This file here just collects potentially useful colours in such
+a scenario, in the event that I may wish to modify the colours
+that are used - or add to this list.

data/lib/studium.rb

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

data/lib/studium/autoinclude.rb

@@ -0,0 +1,7 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'studium'
+
+include Studium

data/lib/studium/base/base.rb

@@ -0,0 +1,108 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Studium::Base
+#
+# This is the base class for classes that are part of the Studium namespace.
+#
+# Not every class needs it though, so it is recommended to only make use
+# of it if you need some "commonly shared functionality".
+#
+# Classes that belong to the Studium::Exams namespace should subclass
+# from this class here.
+# =========================================================================== #
+# To require this base class, do:
+#
+#   require 'studium/exams/base.rb'
+#
+# Then, to subclass from it, do:
+#
+#   < Studium::Base
+#
+# In a shorter variant combining the two lines above, do this:
+#
+#   require 'studium/base/base.rb'; < ::Studium::Base
+#
+# =========================================================================== #
+require 'studium/requires/common_popular_requires.rb'
+# =========================================================================== #
+# Pull in the constants next. The file constants.rb will also pull in the
+# encodings, via the file "studium/constants/encoding.rb".
+# =========================================================================== #
+# require 'studium/constants/constants.rb'
+require 'studium/constants/image_constants.rb'
+require 'studium/constants/week.rb'
+require 'studium/constants/www_constants.rb'
+# =========================================================================== #
+# Next, studium/base/ related code will be loaded up.
+# =========================================================================== #
+require 'studium/base/cliner.rb'
+require 'studium/base/constants.rb'
+require 'studium/base/curriculum.rb'
+require 'studium/base/directory_to_the_exam_topics.rb'
+require 'studium/base/editor.rb'
+require 'studium/base/esystem.rb'
+require 'studium/base/misc.rb'
+require 'studium/base/obtain.rb'
+require 'studium/base/prototype.rb'
+require 'studium/base/readlines.rb'
+require 'studium/base/run.rb'
+require 'studium/base/src_dir_at_home.rb'
+require 'studium/base/unicode.rb'
+require 'studium/base/word_wrap.rb'
+# =========================================================================== #
+# Next, pull in the module_methods that are useful to be had.
+# =========================================================================== #
+require 'studium/toplevel_methods/already_solved_this_lva_number.rb'
+require 'studium/toplevel_methods/available_topics.rb'
+require 'studium/toplevel_methods/average_grade.rb'
+require 'studium/toplevel_methods/datum.rb'
+require 'studium/toplevel_methods/does_this_course_require_mandatory_presence.rb'
+require 'studium/toplevel_methods/file_cd_aliases.rb'
+require 'studium/toplevel_methods/file_read_with_proper_encoding.rb'
+require 'studium/toplevel_methods/find_corresponding_exam_title.rb'
+require 'studium/toplevel_methods/find_corresponding_exam_topic.rb'
+require 'studium/toplevel_methods/frozen.rb'
+require 'studium/toplevel_methods/has_this_lecture_been_already_passed_but_the_id_was_changed_lateron.rb'
+require 'studium/toplevel_methods/is_on_roebe.rb'
+require 'studium/toplevel_methods/module_methods.rb'
+require 'studium/toplevel_methods/report_nquestions_of.rb'
+require 'studium/toplevel_methods/report_how_many_exam_questions_were_already_solved.rb'
+require 'studium/toplevel_methods/return_all_exams_on_this_day.rb'
+require 'studium/toplevel_methods/return_directory_for.rb'
+require 'studium/toplevel_methods/return_local_path_of_this_pwdstud.rb'
+require 'studium/toplevel_methods/return_n_questions_were_answered_for_this_topic.rb'
+require 'studium/toplevel_methods/return_sanitized_dataset_from_the_file_lecture_information.rb'
+require 'studium/toplevel_methods/sanitized_dataset_from_file_passed_exams_per_month.rb'
+require 'studium/toplevel_methods/save_file.rb'
+require 'studium/toplevel_methods/set_this_cd_alias_to.rb'
+require 'studium/toplevel_methods/spacer.rb'
+require 'studium/toplevel_methods/total_ects_points_passed.rb'
+require 'studium/toplevel_methods/url.rb'
+require 'studium/toplevel_methods/verbose_truth.rb'
+# =========================================================================== #
+# The next line is experimental as of Apr 2018 - at a later time,
+# the comment here may be removed, but for now, we will keep it.
+# =========================================================================== #
+require 'studium/toplevel_methods/find_corresponding_exam_topic.rb'
+
+module Studium
+
+class Base # === Studium::Base
+
+  begin
+    require 'roebe/classes/kde/kde_konsole/kde_konsole.rb'
+  rescue LoadError; end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  base = Studium::Base.new
+  p base.web_liner
+  puts 'Do we have konsole support? '+
+        VerboseTruth[base.konsole_support?.to_s]
+  p base.weekday?
+  p base.today?
+  p base.select_lectures_with_this_key(:exam_registration_at)
+end