studium 0.10.1

data/lib/studium/utility_scripts/show_conflicting_lva_lectures/report.rb

@@ -0,0 +1,118 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'studium/utility_scripts/show_conflicting_lva_lectures/report.rb'
+# =========================================================================== #
+module Studium
+
+class ShowConflictingLvaLectures < Base # === Studium::ShowConflictingLvaLectures
+
+  # ========================================================================= #
+  # === report                                                   (report tag)
+  # ========================================================================= #
+  def report(
+      i = main_day?
+    )
+    e # An initial newline to make this prettier.
+    opnn { :no_colon }
+    header_string = (" [Heutiger Tag: #{return_weekday}, #{dd_mm_yyyy}]").
+                    rjust(50)
+    if use_unicode_symbols? and Object.const_defined? :Roebe
+      lindex = header_string.index('[')
+      header_string[lindex, 0] = '|'
+      splitted = header_string.split('|')
+      splitted[0] = crimson(splitted[0]+Roebe.shamrock) # Add a shamrock-unicode icon.
+      splitted[1] = lightseagreen(splitted[1])+
+                    crimson(Roebe.shamrock) # Add the clear-sun weather icon.
+      header_string = lightseagreen(splitted.join)
+
+    else
+      header_string = lightseagreen(header_string)
+    end
+    ee header_string
+    e
+    e
+    if Studium.is_this_day_a_holiday?(i)
+      opnn; e "Note that the day #{sfancy(i)} is a holiday."
+      e
+    end
+    # ======================================================================= #
+    # First, look if there are any "vorbesprechungen", aka
+    # "preliminary meetings". If so, we will show these first.
+    # ======================================================================= #
+    if Studium.is_a_vorbesprechungs_day?(i)
+      do_report_all_preliminary_meetings_on_that_day(i)
+    end
+    # ======================================================================= #
+    # Next, report the exams. The lva-dates will be reported lateron.
+    # ======================================================================= #
+    do_report_the_upcoming_exams(i)
+    lva_dates_on_that_day = main_hash?[:lva_dates]
+    sorted_lectures_on_that_day = []
+    main_day = i
+    unless lva_dates_on_that_day.empty?
+      # ===================================================================== #
+      # === "The following lectures happen on"
+      # ===================================================================== #
+      result = 'The following '.dup
+      if use_unicode_symbols? and Object.const_defined? :Roebe
+        result << lightgreen(Roebe.white_sun_with_rays)+' '
+      end
+      result << colour_for_lectures('lectures')+
+                ' happen on '+orange(main_day)+
+                ' ('+colourize_weekday(translate_dd_mm_yyy_to_weekday(main_day))+
+                ')'+
+                darkslategray(':')
+      e result
+      # ===================================================================== #
+      # Iterate over our lectures next:
+      # ===================================================================== #
+      lva_dates_on_that_day.each {|name_of_the_lecture|
+        pointer   = main_dataset?[name_of_the_lecture]
+        selection = pointer['lva_dates'].select {|line|
+          line.include? i
+        }
+        if selection
+          _ = selection.first
+          _.strip! if _
+          # ================================================================= #
+          # The _ variable is now something like this: "16.04.2018, 18:00-19:30"
+          # ================================================================= #
+          _.delete!(',')
+          _.squeeze!(' ')
+          if _.include? '-'
+            _ = _.split('-').first+':00'
+          end
+          begin
+            sorted_lectures_on_that_day << [
+              name_of_the_lecture, Time.parse(_)
+            ]
+          rescue Exception => error
+            e 'A problem occurred.'
+            pp error
+            pp name_of_the_lecture
+            pp _
+            exit
+          end
+        end
+      }
+      sorted_lectures_on_that_day = sorted_lectures_on_that_day.sort_by {|a,b|
+        b
+      }
+      # ===================================================================== #
+      # === The lectures on that day
+      #
+      # Finally, we will display the lectures that happen on that day.
+      # ===================================================================== #
+      display_these_lectures_on_that_day(
+        sorted_lectures_on_that_day
+      )
+    else
+      e "No lectures were found on the day #{orange(main_day)}"\
+        " (#{sfancy(return_weekday_for(main_day))})."
+    end
+    e
+  end
+
+end; end

data/lib/studium/utility_scripts/show_conflicting_lva_lectures/reset.rb

@@ -0,0 +1,80 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'studium/utility_scripts/show_conflicting_lva_lectures/reset.rb'
+# =========================================================================== #
+module Studium
+
+class ShowConflictingLvaLectures < Base # === Studium::ShowConflictingLvaLectures
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+    reset_internal_dataset
+    # ======================================================================= #
+    # === @namespace
+    # ======================================================================= #
+    @namespace = NAMESPACE
+    # ======================================================================= #
+    # === @commandline_arguments
+    # ======================================================================= #
+    @commandline_arguments = []
+    # ======================================================================= #
+    # === @store_into_this_file
+    # ======================================================================= #
+    @store_into_this_file =
+      "#{log_dir?}last_date_for_conflicting_lva_lectures.md"
+    # ======================================================================= #
+    # === @show_raw_data
+    #
+    # The next instance variable determines whether we will show some
+    # additional debug information or not. By default we will not do
+    # so, hence why it is set to false.
+    # ======================================================================= #
+    @show_raw_data = false
+  end
+
+  # ========================================================================= #
+  # === reset_internal_dataset
+  #
+  # Put variables into this method here only if you really wish to
+  # reset them. Commandline arguments should normally NOT be reset
+  # in this method.
+  # ========================================================================= #
+  def reset_internal_dataset
+    # ======================================================================= #
+    # The @main_hash will store :exams and :lectures as separate entities.
+    # ======================================================================= #
+    @main_hash = {}
+    @main_hash[:exams] = []
+    @main_hash[:lva_dates] = []
+    # ======================================================================= #
+    # === @array_we_have_registered_for_these_exams_on_that_day
+    # ======================================================================= #
+    @array_we_have_registered_for_these_exams_on_that_day = []
+    # ======================================================================= #
+    # === @original_dataset
+    # ======================================================================= #
+    @original_dataset = return_dataset_from_file_lecture_information
+    # ======================================================================= #
+    # === @dataset
+    # ======================================================================= #
+    @dataset = @original_dataset.dup
+    # ======================================================================= #
+    # === @n_ljust
+    # ======================================================================= #
+    @n_ljust = 78
+    # ======================================================================= #
+    # === @left_pad
+    # ======================================================================= #
+    @left_pad = '  ' # This one is displayed when showing indices in this class.
+    # ======================================================================= #
+    # === @hash_these_lectures_have_a_wrong_date
+    # ======================================================================= #
+    @hash_these_lectures_have_a_wrong_date = {}
+  end
+
+end; end

data/lib/studium/utility_scripts/show_conflicting_lva_lectures/run.rb

@@ -0,0 +1,22 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'studium/utility_scripts/show_conflicting_lva_lectures/run.rb'
+# =========================================================================== #
+module Studium
+
+class ShowConflictingLvaLectures < Studium::Base # === Studium::ShowConflictingLvaLectures
+
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run
+    ensure_that_the_log_directory_exists # Make sure that the log dir exists.
+    menu # Pass the commandline arguments into the menu() interface.
+    @use_these_dates.each {|this_date|
+      prepare_dataset_and_then_report_for_this_date(this_date)
+    }
+  end
+
+end; end

data/lib/studium/utility_scripts/show_conflicting_lva_lectures/show_conflicting_lva_lectures.rb

@@ -0,0 +1,651 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Studium::ShowConflictingLvaLectures
+#
+# This class can show conflicting dates for Lva-lectures (and exams to
+# these lectures).
+#
+# As argument you can pass in a string in a date format such as 'dd.mm.yyyy',
+# which is commonly seen in Europe.
+# =========================================================================== #
+# require 'studium/utility_scripts/show_conflicting_lva_lectures/show_conflicting_lva_lectures.rb'
+# Studium::ShowConflictingLvaLectures.new(ARGV)
+# =========================================================================== #
+require 'studium/base/base.rb'
+# =========================================================================== #
+# Require in-class ruby files next:
+# =========================================================================== #
+require 'studium/utility_scripts/show_conflicting_lva_lectures/constants.rb'
+require 'studium/utility_scripts/show_conflicting_lva_lectures/do_report_the_upcoming_exams.rb'
+require 'studium/utility_scripts/show_conflicting_lva_lectures/help.rb'
+require 'studium/utility_scripts/show_conflicting_lva_lectures/initialize.rb'
+require 'studium/utility_scripts/show_conflicting_lva_lectures/menu.rb'
+require 'studium/utility_scripts/show_conflicting_lva_lectures/misc.rb'
+require 'studium/utility_scripts/show_conflicting_lva_lectures/report.rb'
+require 'studium/utility_scripts/show_conflicting_lva_lectures/reset.rb'
+require 'studium/utility_scripts/show_conflicting_lva_lectures/run.rb'
+
+module Studium
+
+class ShowConflictingLvaLectures < Base # === Studium::ShowConflictingLvaLectures
+
+  require 'studium/utility_scripts/holidays.rb'
+  require 'studium/utility_scripts/vorbesprechungen.rb'
+
+  # ========================================================================= #
+  # === dataset?
+  # ========================================================================= #
+  def dataset?
+    @dataset
+  end; alias main_dataset? dataset? # === main_dataset?
+
+  # ========================================================================= #
+  # === main_hash?
+  # ========================================================================= #
+  def main_hash?
+    @main_hash
+  end
+
+  # ========================================================================= #
+  # === input_given?
+  #
+  # This will return the first date.
+  # ========================================================================= #
+  def input_given?
+    @use_these_dates.first
+  end
+
+  # ========================================================================= #
+  # === filter_the_main_dataset
+  # ========================================================================= #
+  def filter_the_main_dataset
+    @dataset.reject! {|name_of_the_lecture, inner_hash|
+      inner_hash.has_key?(:already_solved) and
+      inner_hash[:already_solved] == true 
+    }
+    @dataset.select! {|name_of_the_lecture, inner_hash|
+      inner_hash.has_key?('lva_dates') or
+      inner_hash.has_key?('exams')
+    }
+  end
+
+  # ========================================================================= #
+  # === append_university
+  #
+  # This will properly format and colourize the "university-string", before
+  # returning it. It is to be used to append it to the displayed string.
+  # ========================================================================= #
+  def append_university(i)
+    # Still have to modify these two:
+    #  VetMed
+    case i
+    when 'TU Vienna'
+      i = 'TU'
+    when 'Uni Wien'
+      i = 'UniWien'
+    end
+    i = " #{i.center(8)}"
+    return dodgerblue(i) # Or deepskyblue
+  end
+
+  # ========================================================================= #
+  # === properly_colourize_this_lecture_type
+  #
+  # Lecture types such as SE, UE and so forth, will be displayed in a
+  # slightly brighter colour, to denote that they are more important
+  # than other lecture-types such as VO.
+  # ========================================================================= #
+  def properly_colourize_this_lecture_type(lecture_type)
+    _ = ' ['+lecture_type+'] '
+    if is_prüfungsimmanent?(lecture_type)
+      darkturquoise(_)
+    else
+      steelblue(_)
+    end
+  end
+
+  # ========================================================================= #
+  # === colourize_weekday
+  # ========================================================================= #
+  def colourize_weekday(i)
+    limegreen(i)
+  end
+
+  # ========================================================================= #
+  # === use_this_date?
+  # ========================================================================= #
+  def use_these_dates?
+    @use_these_dates
+  end; alias main_day?        use_these_dates? # === main_day?
+       alias interesting_day? use_these_dates? # === interesting_day?
+       alias use_this_date?   use_these_dates? # === use_this_date?
+       alias use_which_date?  use_these_dates? # === use_which_date?
+
+  # ========================================================================= #
+  # === return_dataset_of_this_lecture
+  # ========================================================================= #
+  def return_dataset_of_this_lecture(i)
+    @dataset[i]
+  end
+
+  # ========================================================================= #
+  # === colour_for_index_strings
+  # ========================================================================= #
+  def colour_for_index_strings(i)
+    powderblue(i)
+  end
+
+  # ========================================================================= #
+  # === colour_for_preliminary_meetings
+  # ========================================================================= #
+  def colour_for_preliminary_meetings(i)
+    rosybrown(i)
+  end
+
+  # ========================================================================= #
+  # === colour_for_exams
+  # ========================================================================= #
+  def colour_for_exams(
+      i,
+      optional_priority                 = nil,
+      optional_registered_for_that_exam = false
+    )
+    if optional_registered_for_that_exam
+      orangered(i)+
+      orangered(" #{left_arrow} [Registered for this exam]")
+    else
+      case optional_priority
+      when 1
+        crimson(i)+
+        crimson(" #{left_arrow} [High Priority Exam]")
+      else
+        springgreen(i)
+      end
+    end
+  end
+
+  # ========================================================================= #
+  # === left_arrow
+  # ========================================================================= #
+  def left_arrow
+    '←'
+  end
+
+  # ========================================================================= #
+  # === do_report_all_preliminary_meetings_on_that_day
+  # ========================================================================= #
+  def do_report_all_preliminary_meetings_on_that_day(i)
+    selection = @original_dataset.select {|a, b|
+      b.has_key?('vorbesprechung') and
+      b['vorbesprechung'].include?(i.to_s)
+    }
+    index = 0
+    if selection.empty?
+    else
+      # ===================================================================== #
+      # === "The following preliminary meetings happen on ... "
+      # ===================================================================== #
+      e 'The following '+colour_for_preliminary_meetings('preliminary meetings')+
+          ' happen on '+orange(i)+
+          ' ('+simp(translate_dd_mm_yyy_to_weekday(i))+').'
+      e
+      selection.each_pair {|name_of_the_lecture, hash| index += 1
+        vorbesprechungs_day = hash['vorbesprechung']
+        colourized_and_padded_index =
+          '   '+colour_for_index_strings(index.to_s+')')
+        e colourized_and_padded_index+' '+
+          sfancy(name_of_the_lecture.ljust(@n_ljust+5))+
+          colour_for_vorbesprechungs_termin(
+            '['+vorbesprechungs_day+']'
+          )
+      }
+    end
+    e
+  end
+
+  # ========================================================================= #
+  # === colour_for_lectures
+  # ========================================================================= #
+  def colour_for_lectures(i)
+    turquoise(i)
+  end; alias colour_for_vorbesprechungs_termin colour_for_lectures # === colour_for_vorbesprechungs_termin
+
+  # ========================================================================= #
+  # === display_these_exams_on_that_day
+  #
+  # This is the method that will report which exams will happen during
+  # the given input-day.
+  # ========================================================================= #
+  def display_these_exams_on_that_day(i)
+    index = 0
+    e
+    i.each {|name_of_the_lecture, date_of_the_lecture| index += 1
+      _ = date_of_the_lecture
+      padded_index = "#{index})".rjust(3)
+      colourized_and_padded_index = powderblue(padded_index)
+      priority         = return_dataset_of_this_lecture(name_of_the_lecture)[:priority]
+      which_university = return_dataset_of_this_lecture(name_of_the_lecture)[:university].to_s
+      registered_for_an_upcoming_exam_at = @dataset[name_of_the_lecture]['registered']
+      if registered_for_an_upcoming_exam_at
+        if registered_for_an_upcoming_exam_at.is_a? Array
+          # ================================================================= #
+          # Note that the array above may have some additional ' '
+          # characters, so we apply .squeeze() on it.
+          #
+          # An example for this is:
+          #
+          #   "Dienstag     12.06.2018, 14:00-16:00, Ort: Foobar"
+          # ================================================================= #
+          registered_for_an_upcoming_exam_at.map! {|entry| entry.squeeze(' ') }
+          registered_for_an_upcoming_exam_at = registered_for_an_upcoming_exam_at.first
+        end
+        registered_for_an_upcoming_exam_at = remove_leading_weeknames(
+          registered_for_an_upcoming_exam_at
+        )
+      end
+      case which_university
+      when 'TU Vienna'
+        which_university = 'TU Wien'
+      end
+      padded_which_university = " #{which_university}".center(10)
+      colourized_and_padded_which_university = plum('['+padded_which_university+'] ')
+      # ===================================================================== #
+      # In the event that priority is 1, we will use slightly different
+      # colours - aka red.
+      # ===================================================================== #
+      are_we_registered_for_that_exam = false
+      if registered_for_an_upcoming_exam_at # to prevent nil-entries
+        # =================================================================== #
+        # The line may be like this:
+        #   "18.06.2018, 14:00-16:00, Ort: Hörsaal 2 UZA 1 Biozentrum 2.249 1.OG"
+        # =================================================================== #
+        splitted = registered_for_an_upcoming_exam_at.split(',')
+        first    = splitted.first
+        if first == input_given?
+          are_we_registered_for_that_exam = true
+        end
+      end
+      return_colourized_entry_for_an_upcoming_exam = colour_for_exams(
+        '['+return_dd_mm_yy_and_time_from(date_of_the_lecture).to_s.rjust(19,'0')+']',
+        priority,
+        are_we_registered_for_that_exam
+      )
+      padded_name_of_the_lecture = name_of_the_lecture.ljust(@n_ljust)
+      # ===================================================================== #
+      # If we are registered for that particular exam then we
+      # will use a slightly brighter colour.
+      # ===================================================================== #
+      if are_we_registered_for_that_exam
+        @array_we_have_registered_for_these_exams_on_that_day << [
+          name_of_the_lecture, date_of_the_lecture
+        ]
+        colourized_and_padded_name_of_the_lecture =
+          cadetblue(padded_name_of_the_lecture)
+      else
+        colourized_and_padded_name_of_the_lecture =
+          cornflowerblue(padded_name_of_the_lecture)
+      end
+      # ===================================================================== #
+      # And finally, report which exams will happen on that day next,
+      # on the commandline.
+      # ===================================================================== #
+      e @left_pad+
+        colourized_and_padded_index+ # The index such as ' 1)'
+        ' '+
+        colourized_and_padded_name_of_the_lecture+ # The name of the lecture.
+        colourized_and_padded_which_university+
+        return_colourized_entry_for_an_upcoming_exam
+    }
+    e
+  end
+
+  # ========================================================================= #
+  # === this_exam_happens_on_that_day?
+  # ========================================================================= #
+  def this_exam_happens_on_that_day?(i)
+    result = false
+    unless @array_we_have_registered_for_these_exams_on_that_day.empty?
+      @array_we_have_registered_for_these_exams_on_that_day.each {|a, b|
+        result = true if a.include? i
+      }
+    end
+    result
+  end
+
+  # ========================================================================= #
+  # === store_this_date_into_a_local_file
+  #
+  # This method will store the date used, aka the dd.mm.yyyy format,
+  # into a local file.
+  # ========================================================================= #
+  def store_this_date_into_a_local_file
+    what = use_which_date?
+    what = what.first if what.is_a? Array
+    into = @store_into_this_file
+    write_what_into(what, into)
+  end
+
+  # ========================================================================= #
+  # === register_this_lecture_having_a_wrong_date
+  # ========================================================================= #
+  def register_this_lecture_having_a_wrong_date(
+      name_of_the_lecture, date
+    )
+    # ======================================================================= #
+    # We will only register the first incorrect lecture; the others will
+    # be ignored. This way the user can fix the flawed dataset.
+    # ======================================================================= #
+    unless @hash_these_lectures_have_a_wrong_date.has_key? name_of_the_lecture.strip
+      @hash_these_lectures_have_a_wrong_date[name_of_the_lecture.strip] = date
+    end
+  end
+
+  # ========================================================================= #
+  # === report_lectures_having_an_outdated_year
+  # ========================================================================= #
+  def report_lectures_having_an_outdated_year
+    unless @hash_these_lectures_have_a_wrong_date.empty?
+      @hash_these_lectures_have_a_wrong_date.each_pair {|name_of_the_lecture, date|
+        e crimson('There may be a wrong date (year) set '\
+          'for the lecture `')+royalblue(name_of_the_lecture)+
+          crimson('`.')
+        pp date
+      }
+    end
+  end
+
+  # ========================================================================= #
+  # === show_lva_dates_of_this_lecture
+  #
+  # This method will report all LVA-dates of the given lecture at hand.
+  # ========================================================================= #
+  def show_lva_dates_of_this_lecture(i)
+    entries = @dataset.select {|name_of_the_lecture, inner_dataset|
+      name_of_the_lecture.include? i
+    }
+    if entries.size > 1
+      e 'More than one entry. Need to decide what to do with that.'
+      e 'Proposing to just return the first entry. Acceptable? '\
+        'Consider later (July 2018)'
+    else
+      name = entries.keys.first
+      e 'Showing all lva-dates of the lecture `'+royalblue(name)+'` next:'
+      hash = entries[name]
+      lva_dates = hash['lva_dates']
+      if lva_dates
+        lva_dates.each {|lva_date|
+          lva_date = remove_weekday_name(lva_date).strip
+          lva_date = extract_dd_mm_yyyy(lva_date)
+          prepare_dataset_and_then_report_for_this_date(lva_date)
+        }
+      else
+        e 'No lva_dates: entry appears to be '\
+          'registered for `'+royalblue(name)+'`.'
+      end
+    end
+    exit
+  end
+
+  # ========================================================================= #
+  # === display_these_lectures_on_that_day
+  #
+  # This method will display the lectures on that given day, along
+  # with some additional information to make it easier to read what
+  # is all happening on that day.
+  # ========================================================================= #
+  def display_these_lectures_on_that_day(i)
+    index = 0
+    # ======================================================================= #
+    # Obtain a reference to the main dataset next:
+    # ======================================================================= #
+    main_dataset = main_dataset?
+    # ======================================================================= #
+    # Merge in all exams that occur on that day:
+    # ======================================================================= #
+    unless @array_we_have_registered_for_these_exams_on_that_day.empty?
+      @array_we_have_registered_for_these_exams_on_that_day.each {|element|
+        # =================================================================== #
+        # We have to re-set the time counter for these elements, as they
+        # may have the wrong timezone-offset, which would mess up our
+        # sorting done at a later point.
+        # =================================================================== #
+        second_element = Studium.normalize_time(
+          element.last
+        )
+        element[-1] = second_element
+        # =================================================================== #
+        # We will add that element onto the dataset, aka i - but before
+        # we do so, we have to remove the old element from our dataset.
+        # =================================================================== #
+        i.reject! {|array|
+          name = array.first
+          first_entry = element.first
+          name == first_entry
+        }
+        i << element
+      }
+    end
+    sorted_by_date = i.sort_by {|name_of_the_lecture, time_entry|
+      Time.parse(time_entry.to_s)
+    }
+    e; sorted_by_date.each {|name_of_the_lecture, date_of_the_lecture| index += 1
+      _ = date_of_the_lecture
+      # Pad the index a bit:
+      padded_index = ("#{index})").rjust(3)
+      if this_exam_happens_on_that_day?(name_of_the_lecture)
+        colourized_and_padded_index = colourize_via_orangered(padded_index)
+      else
+        colourized_and_padded_index = colour_for_index_strings(padded_index)
+      end
+      priority               = main_dataset[name_of_the_lecture][:priority]
+      lecture_type           = main_dataset[name_of_the_lecture][:type] # Can be "VO" or "VO+SE" and so forth.
+      name_of_the_university = main_dataset[name_of_the_lecture][:university]
+      do_we_participate      = main_dataset[name_of_the_lecture][:currently_participating_in_this_course]
+      # ===================================================================== #
+      # We will store everything in the String referenced via the variabled
+      # called "result".
+      # ===================================================================== #
+      result = @left_pad+colourized_and_padded_index               # First show the index
+      if do_we_participate
+        result[1,1] = mediumseagreen('✓') # This icon denotes that we currently participate in this course.
+      end
+      result << properly_colourize_this_lecture_type(lecture_type) # Next the lecture-type such as "VO" or "SE" etc.
+      padding_to_use = @n_ljust
+      if lecture_type.size > 2
+        # =================================================================== #
+        # In this case, use a slightly shorter padding.
+        # =================================================================== #
+        padding_to_use -= (lecture_type.size - 2)
+      end
+      # ===================================================================== #
+      # Make too long names shorter (truncate):
+      # ===================================================================== #
+      chop_off_at_this_offset = @n_ljust - 4
+      if name_of_the_lecture.size > chop_off_at_this_offset
+        name_of_the_lecture = name_of_the_lecture[0 .. (chop_off_at_this_offset - 6)]+' [...]'
+      end
+      padded_name_of_the_lecture = name_of_the_lecture.ljust(padding_to_use)
+      # ===================================================================== #
+      # The normal colour for lectures here is slateblue; but if the
+      # lecture is of high priority, aka priority 1, then a slightly
+      # brighter colour will be used, to also visually denote that
+      # this lecture is more important.
+      # ===================================================================== #
+      if this_exam_happens_on_that_day?(name_of_the_lecture)
+        # =================================================================== #
+        # In this case we will also pad anew:
+        # =================================================================== #
+        result << orangered(
+          (
+            "#{name_of_the_lecture} #{left_arrow} #{return_people_cheering_for_an_exam}"
+          ).ljust(padding_to_use)
+        )
+      else
+        case priority
+        when 1
+          result << mediumpurple(padded_name_of_the_lecture) # Now the name of the lecture.
+        else
+          result << slateblue(padded_name_of_the_lecture)    # Now the name of the lecture.
+        end
+      end
+      result << colour_for_lectures(
+                  '['+return_dd_mm_yy_and_time_from(date_of_the_lecture).to_s.rjust(19,'0')+']'
+                )
+      # ===================================================================== #
+      # Find out whether this exame happens on the day:
+      # ===================================================================== #
+      if this_exam_happens_on_that_day?(name_of_the_lecture)
+        # =================================================================== #
+        # Registered exams will appear in another colour:
+        # =================================================================== #
+        result << skyblue(' [')+return_colourized_people_cheering_for_an_exam+skyblue(']')
+      elsif priority.to_i == 1
+        result << skyblue(' [')+orange('Priorität: '+priority.to_s)+skyblue(']')
+      else
+        result << skyblue(" [Priorität: #{priority}]")
+      end
+      # ===================================================================== #
+      # Next, append the university.
+      # ===================================================================== #
+      result << append_university(name_of_the_university)
+      e result
+    }
+    e
+  end
+
+  # ========================================================================= #
+  # === return_people_cheering_for_an_exam
+  # ========================================================================= #
+  def return_people_cheering_for_an_exam
+    '\\o/ EXAM \\o/'
+  end
+
+  # ========================================================================= #
+  # === return_colourized_people_cheering_for_an_exam
+  # ========================================================================= #
+  def return_colourized_people_cheering_for_an_exam
+    colourized_orangered(
+      return_people_cheering_for_an_exam
+    )
+  end
+
+  # ========================================================================= #
+  # === colourized_orangered
+  # ========================================================================= #
+  def colourized_orangered(i)
+    orangered(i)
+  end; alias colourize_via_orangered colourized_orangered # === colourize_via_orangered
+
+  # ========================================================================= #
+  # === set_use_this_date                                           (set tag)
+  #
+  # This will set the date that we are interested in. If the input is an
+  # Array then we will work on a String. In general, the String should
+  # be in the format dd.mm.yyyy such as '25.02.2018'.
+  # ========================================================================= #
+  def set_use_this_date(
+      i = nil
+    )
+    i = DEFAULT_DATE if i.nil?
+    # ======================================================================= #
+    # === Handle Arrays next
+    # ======================================================================= #
+    if i.is_a?(Array)
+      # ===================================================================== #
+      # First, we will reject all entries that are a weekday, such as
+      # "Freitag". The reason for this behaviour is because we can also
+      # invoke this class here via e. g.:
+      #
+      #   conflict Freitag 25.10.2019
+      #
+      # But we don't care about the weekday name here; the dd.mm.yyyy format
+      # is sufficient. So, let's modify the array.
+      # ===================================================================== #
+      i.reject! {|entry| weekdays?.include?(entry.capitalize) }
+      first = i.first
+      if i.empty?
+        i = return_dd_mm_yyyy
+      elsif first.is_a?(String) and first.include?('-') and (first =~ /\d+/)
+        require 'studium/utility_scripts/expand_time_range.rb'
+        i = Studium.expand_these_lectures(i)
+      elsif first !~ /\d+/ # If it does not have a number but is not empty.
+        case first
+        # =================================================================== #
+        # === default
+        # =================================================================== #
+        when 'default','def'
+          if File.exist? @store_into_this_file
+            opnn; e 'Reading from the file'
+            opnn; e "  `#{sfile(@store_into_this_file)}`."
+            i = File.read(@store_into_this_file).strip
+          else
+            opnn
+            e 'No entry could be found at non-existing '\
+              'file `'+sfile(@store_into_this_file)+'`.'
+          end
+        when *ALPHABET.map(&:upcase)
+          i = A # ← i will now be e. g. 01.10.2018
+          # ================================================================= #
+          # Next, we add the difference to this string.
+          # ================================================================= #
+          n_difference = ALPHABET.index(first.downcase)
+          i = Time.parse(i) + ONE_DAY * n_difference
+          i = dd_mm_yyyy(i)  
+        end
+      end
+    end
+    if i.is_a?(Array) and i.size == 1
+      i = i.first
+    end
+    case i # case tag
+    when *ARRAY_SHORTCUTS_FOR_THE_DAY_AFTER_TOMORROW
+      i = Time.now + ONE_DAY + ONE_DAY
+      i = return_dd_mm_yyyy(i)
+    when *ARRAY_SHORTCUTS_FOR_TOMORROW
+      i = Time.now + ONE_DAY
+      i = return_dd_mm_yyyy(i)
+    end
+    # ======================================================================= #
+    # We require an Array past this point:
+    # ======================================================================= #
+    i = [i].compact unless i.is_a? Array
+    i.flatten!
+    i.map! {|line|
+      line = remove_leading_weekdays(line)
+      case line
+      when *ARRAY_SHORTCUTS_FOR_TOMORROW
+        line = Time.now + ONE_DAY # ← Add one day.
+        line = return_dd_mm_yyyy(line)
+      when 'today','heute'
+        line = return_dd_mm_yyyy(Time.now)
+      end
+      if line.end_with? ','
+        line = line.dup if line.frozen?
+        line.chop!
+      end
+      # ===================================================================== #
+      # Check for a proper date, which is in the format dd.mm.yyyy.
+      # ===================================================================== #
+      if line =~ /^\d{1,2}\.\d{1,2}\.\d{4}$/
+      else
+        if line.count('.') == 1
+          line = line.dup if line.frozen?
+          line << '.'+current_year?
+        end
+      end
+      line
+    }
+    @use_these_dates = i
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  Studium::ShowConflictingLvaLectures.new(ARGV)
+end # conflict 15.04.2018
+    # conflict 20.04.2018 21.04.2018
+    # conflict 19.06.2018
+    # conflict --lva-dates-of=LVA_ID_HERE
+    # conflict --lva-dates-of=301246