studium 0.10.1

data/lib/studium/exams/show_themes/reset.rb

@@ -0,0 +1,64 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'studium/exams/show_themes/reset.rb'
+# =========================================================================== #
+module Studium
+
+module Exams
+
+class ShowThemes < Base # === Studium::Exams::ShowThemes
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+    # ======================================================================= #
+    # === @namespace
+    # ======================================================================= #
+    @namespace = NAMESPACE
+    # ======================================================================= #
+    # === @left_padding_to_use
+    # ======================================================================= #
+    @left_padding_to_use = ' '
+    # ======================================================================= #
+    # === @allowed_themes_for_exams
+    # ======================================================================= #
+    _ = Studium.file_allowed_themes_for_exams
+    # ======================================================================= #
+    # We need to sanitize this a little bit.
+    # ======================================================================= #
+    @allowed_themes_for_exams = YAML.load_file(_).map {|line|
+      line.tr(' ','_')
+    }
+    # ======================================================================= #
+    # === @dataset_from_file_lecture_information
+    # ======================================================================= #
+    @dataset_from_file_lecture_information = return_dataset_from_file_lecture_information
+    # ======================================================================= #
+    # === @dataset
+    #
+    # This variable will contain our actual dataset that is ready for
+    # display.
+    # ======================================================================= #
+    @dataset = nil
+    # ======================================================================= #
+    # === @sort_how
+    #
+    # How to sort the dataset by default.
+    #
+    # A value of nil means that this class will not do any special
+    # sorting whatsoever.
+    # ======================================================================= #
+    @sort_how = :alphabetically
+    # ======================================================================= #
+    # === @average_grade
+    #
+    # This variable will keep track of the average grade.
+    # ======================================================================= #
+    @average_grade = []
+  end
+
+end; end; end

data/lib/studium/exams/show_themes/show_themes.rb

@@ -0,0 +1,27 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Studium::Exams::ShowThemes
+#
+# This class can show exam-themes, that is, lectures that belong to a 
+# particular theme.
+#
+# Usage example:
+#
+#   Studium::Exams::ShowThemes.new(ARGV)
+#
+# =========================================================================== #
+# require 'studium/exams/show_themes/show_themes.rb'
+# Studium::Exams::ShowThemes.new(ARGV)
+# =========================================================================== #
+require 'studium/base/base.rb'
+require 'studium/exams/show_themes/constants.rb'
+require 'studium/exams/show_themes/menu.rb'
+require 'studium/exams/show_themes/misc.rb'
+require 'studium/exams/show_themes/reset.rb'
+
+if __FILE__ == $PROGRAM_NAME
+  # Studium::Exams::ShowThemes.new(ARGV)
+  Studium.report_passed_exams_fitting_to_this_theme(ARGV)
+end # showthemes biochemistry

data/lib/studium/exams/show_upcoming_exams/consider_autogenerating_exam_aliases.rb

@@ -0,0 +1,170 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'studium/exams/show_upcoming_exams/consider_autogenerating_exam_aliases.rb'
+# =========================================================================== #
+module Studium
+
+class ShowUpcomingExams < Studium::Base # === Studium::ShowUpcomingExams
+
+  # ========================================================================= #
+  # === consider_autogenerating_exam_aliases
+  #
+  # This method will autogenerate the proper cd_aliases entries.
+  #
+  # It will only do so if these three conditions are met:
+  #
+  #   (1) the target system is a "roebe-system"
+  #   (2) a new entry has been added or removed in the file
+  #       'lecture_information.yml'
+  #   (3) a file exists as specified by the constant
+  #       FILE_ALL_REGISTERED_UPCOMING_EXAMS
+  #
+  # ========================================================================= #
+  def consider_autogenerating_exam_aliases(
+      use_this_file = FILE_ALL_REGISTERED_UPCOMING_EXAMS
+    )
+    if is_on_roebe? # Only do so on roebe-systems.
+      # ===================================================================== #
+      # Next we have to determine whether the file 'lecture_information.yml'
+      # has any different entry. If so, the cd_aliases entries will be
+      # autogenerated.
+      # ===================================================================== #
+      if File.exist? use_this_file
+        existing_dataset = YAML.load_file(use_this_file)
+        # =================================================================== #
+        # This may be in the wrong encoding, so we have to sanitize the
+        # Encoding.
+        # =================================================================== #
+        existing_dataset = ensure_main_encoding(existing_dataset)
+        # =================================================================== #
+        # Next compare this to the dataset from the file
+        # 'lecture_information.yml'. We have to load up the
+        # original dataset again because the one available
+        # from the method reset(), may have been altered
+        # lateron.
+        # =================================================================== #
+        _ = ::Studium.return_sanitized_dataset_from_the_file_lecture_information.select {|a, b|
+          b.has_key?('registered') or
+          b.has_key?('not_yet_registered')
+        }
+        array = _.map {|name_of_the_lecture, inner_hash|
+          if inner_hash.has_key? 'registered'
+            entry = inner_hash['registered']
+          elsif inner_hash.has_key? 'not_yet_registered'
+            entry = inner_hash['not_yet_registered']
+          end
+          entry = entry.first
+          entry
+        }
+        # =================================================================== #
+        # Finally, compare the two Arrays:
+        # =================================================================== #
+        if (array == existing_dataset)
+          # ================================================================= #
+          # In this case, we pass through, as it is the very same dataset.
+          # ================================================================= #
+        else
+          # ================================================================= #
+          # Else we must update the cd-aliases.
+          # ================================================================= #
+          update_the_cd_aliases_with_new_exam_entries
+        end 
+      end
+    end
+  end
+
+  # ========================================================================= #
+  # === update_the_cd_aliases_with_new_exam_entries
+  #
+  # This will do a semi-silent update.
+  # ========================================================================= #
+  def update_the_cd_aliases_with_new_exam_entries
+    opnn; e "Updating the #{gold('cd-aliases')} next - this "\
+            "may take a few seconds."
+    create_the_auto_stud_aliases(:do_not_exit, :be_quiet)
+    system 'history -c'
+  end
+
+  # ========================================================================= #
+  # === create_the_auto_stud_aliases
+  #
+  # To invoke this class, do:
+  #
+  #   show_upcoming_exams --autostud
+  #
+  # ========================================================================= #
+  def create_the_auto_stud_aliases(
+      shall_we_exit = true,
+      be_verbose    = true
+    )
+    case be_verbose
+    when :be_quiet
+      be_verbose = false
+    end
+    case shall_we_exit
+    when :do_not_exit
+      shall_we_exit = false
+    end
+    base_dir = ROEBE_STUDIUM_DIR.dup
+    index = 0
+    @dataset.each {|name_of_the_lecture, inner_hash| index += 1
+      name_of_the_lecture = name_of_the_lecture.tr(' ','_')
+      # ===================================================================== #
+      # Sanitize the name of the lecture:
+      # ===================================================================== #
+      name_of_the_lecture.delete!(':/(),') # Get rid of ':','/','(',')', ','.
+      if name_of_the_lecture.end_with? '.'
+        name_of_the_lecture.chop!
+      end
+      if name_of_the_lecture.include? '_-_'
+        name_of_the_lecture.gsub!(/_-_/,'_')
+      end
+      if name_of_the_lecture.include? '_+_' # Replace '_+_' with '_'
+        name_of_the_lecture.gsub!(/_\+_/,'_')
+      end
+      if name_of_the_lecture.include? '__'
+        name_of_the_lecture.squeeze!('_')
+      end
+      university = inner_hash[:university].dup
+      # ===================================================================== #
+      # Note that the entries matched in the following variable will be
+      # upcased lateron anyway.
+      # ===================================================================== #
+      case university
+      when /^vetmed$/i
+        university = 'VETMED_UNI'
+      when 'tu_vienna','TU_VIENNA','TU Vienna'
+        university = 'TU_WIEN'
+      when 'meduni','MEDUNI','Meduni',
+           'boku','BOKU'
+        university << '_WIEN'
+      end
+      target_dir = base_dir+university.upcase.tr(' ','_')+'/'.dup
+      target_dir << name_of_the_lecture
+      pwdstud_name = "pwdstud#{index}:"
+      if be_verbose
+        opnn; e 'Settting alias '+
+                simp(pwdstud_name.to_s.rjust(10))+
+                ' pointing to the directory '+
+                sdir(target_dir)
+      end
+      # ===================================================================== #
+      # Delegate towards Studium.set_this_cd_alias_to() next,
+      # in the file "studium/toplevel_methods/set_this_cd_alias_to.rb".
+      # ===================================================================== #
+      set_this_cd_alias_to(
+        pwdstud_name,
+        target_dir,
+        :be_quiet # But be quiet there.
+      )
+      begin
+        require 'rcfiles'
+        Rcfiles.generate_files(:cd_aliases) {{ be_verbose: @be_verbose }}
+      rescue LoadError; end
+    }
+    exit if shall_we_exit
+  end
+
+end; end

data/lib/studium/exams/show_upcoming_exams/constants.rb

@@ -0,0 +1,82 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'studium/exams/show_upcoming_exams/constants.rb'
+# =========================================================================== #
+module Studium
+
+class ShowUpcomingExams < Studium::Base # === Studium::ShowUpcomingExams.new
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === REGEX_TO_EXTRACT_DATE_AND_TIME_FROM_AN_UPCOMING_EXAM
+  # ========================================================================= #
+  REGEX_TO_EXTRACT_DATE_AND_TIME_FROM_AN_UPCOMING_EXAM = # See: http://rubular.com/r/6VxRmS5FKc
+      /(\d{1,2}\.\d{1,2}\.\d{4},?\s*\d{1,2}:\d{1,2}-\d{1,2}:\d{1,2})/
+
+  # ========================================================================= #
+  # === SHOW_LEADING_LVA_ID_NUMBER
+  #
+  # If the following constant is set to true, then we will also display
+  # the leading LVA-ID number.
+  #
+  # If it is false, that LVA-ID number will NOT be shown.
+  #
+  # The numbers make the display a bit uglier, but it may be more useful
+  # for the user if that user wants to use the LVA at hand via the
+  # browser.
+  # ========================================================================= #
+  SHOW_LEADING_LVA_ID_NUMBER = true
+
+  # ========================================================================= #
+  # === TRY_TO_SHOW_PRIORITIES_FOR_THE_LECTURES
+  #
+  # The following constant will also attempt to show the priorities of
+  # a given lecture at hand.
+  #
+  # This depends on the priority value having been set in the file
+  # called "lecture_information.yml".
+  #
+  # If, however had, such a file exists, and the following constant is
+  # set to true, then this class will show the priority of the lecture.
+  # Lower number means higher priority, and the colours picked will reflect
+  # this priority loosely - the lower the priority, the brighter the
+  # colour.
+  #
+  # The reasoning behind this is that brighter colours should be easier to
+  # notice by the human eyes, and hence may signal a higher "importance".
+  #
+  # The whole idea behind this constant is to visualize more easily on
+  # the commandline which upcoming exams are more important than others.
+  # ========================================================================= #
+  TRY_TO_SHOW_PRIORITIES_FOR_THE_LECTURES = true
+
+  # ========================================================================= #
+  # === USE_OPN
+  # ========================================================================= #
+  USE_OPN = true
+
+  # ========================================================================= #
+  # === DISPLAY_HORIZONTAL_BAR_TO_INDICATE_A_NEW_MONTH
+  #
+  # If this constant is set to true, then a horizontal bar will be shown
+  # when a new month begins.
+  # ========================================================================= #
+  DISPLAY_HORIZONTAL_BAR_TO_INDICATE_A_NEW_MONTH = true
+
+  # ========================================================================= #
+  # === SEPARATOR_TOKEN_TO_USE
+  # ========================================================================= #
+  SEPARATOR_TOKEN_TO_USE = '|'
+
+  # ========================================================================= #
+  # === SHOW_TOTAL_ECTS_POINTS_PASSED
+  # ========================================================================= #
+  SHOW_TOTAL_ECTS_POINTS_PASSED = true
+
+end; end

data/lib/studium/exams/show_upcoming_exams/help.rb

@@ -0,0 +1,33 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'studium/exams/show_upcoming_exams/help.rb'
+# =========================================================================== #
+module Studium
+
+class ShowUpcomingExams < Studium::Base
+
+  # ========================================================================= #
+  # === show_help                                                  (help tag)
+  #
+  # Invoke this method via:
+  #
+  #   show_upcoming_exams --help
+  #
+  # ========================================================================= #
+  def show_help
+    help_string = <<-EOF
+
+Input a number n, which means to show n upcoming exams.
+
+Other documented help options are:
+
+  --autostud # automatically set the proper
+             # cd-alias for all upcoming exams
+
+EOF
+    e help_string
+  end
+
+end; end

data/lib/studium/exams/show_upcoming_exams/initialize.rb

@@ -0,0 +1,71 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module Studium
+
+class ShowUpcomingExams < Studium::Base
+
+  # ========================================================================= #
+  # === initialize
+  #
+  # The first argument will keep track of the commandline-input.
+  #
+  # The input to this method should also handle blocks given, such as:
+  #
+  #   Studium::ShowUpcomingExams.new { :disable_colours }
+  #
+  # ========================================================================= #
+  def initialize(
+      i           = nil,
+      run_already = true
+    )
+    reset
+    case i
+    when :be_silent,
+         :do_not_report_anything
+      be_silent
+      i = nil
+      @report_result = false
+    end
+    set_input(i)
+    # ======================================================================= #
+    # === Handle blocks next
+    #
+    # Next handle blocks given to the initializer:
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      if yielded.is_a? Hash
+        if yielded.has_key? :show_n_upcoming_exams
+          set_show_n_upcoming_exams(
+            yielded.delete(:show_n_upcoming_exams)
+          )
+        elsif yielded.has_key? :show_n_exams
+          set_show_n_upcoming_exams(
+            yielded.fetch(:show_n_exams)
+          )
+        end
+      else
+        case yielded # case tag
+        when :disable_colours,
+             :no_colours
+          no_colours
+        end
+      end
+    end
+    if i.is_a? Symbol
+      case i
+      when :do_not_report_anything
+        do_not_report_anything
+      end
+    end
+    case run_already
+    when :dont_run_yet,
+         :do_not_run_yet
+      run_already = false
+    end
+    run if run_already
+  end
+
+end; end