studium 0.9.383

data/lib/studium/utility_scripts/publish_my_exams.rb

@@ -0,0 +1,185 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Studium::Exams::PublishMyExams
+#
+# This class will publish all my exams to various remote sites,
+# so that these are available for other people to have a
+# look-at, and so forth.
+#
+# Usage example:
+#   Studium::Exams::PublishMyExams.new
+# =========================================================================== #
+# require 'studium/utility_scripts/publish_my_exams.rb'
+# =========================================================================== #
+require 'studium/requires/base_class_and_common_popular_requires.rb'
+
+module Studium
+
+module Exams
+
+class PublishMyExams < ::Studium::Base # === Studium::PublishMyExams.new
+
+  begin
+    require 'ftp_paradise'
+  rescue LoadError; end # Possibly not everyone needs ftp_paradise.
+
+  # ========================================================================= #
+  # === PublishMyExams::ZEUGNISSE
+  # ========================================================================= #
+  ZEUGNISSE = "#{REMOTE_PERSONAL_WEBSITE_URL}ZEUGNISSE/"
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      i           = nil,
+      run_already = true
+    )
+    reset
+    set_input(i)
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+  end
+
+  # ========================================================================= #
+  # === set_input
+  # ========================================================================= #
+  def set_input(i = '')
+    i = [i].flatten.compact
+    @input = i # This variable must always be an Array.
+  end
+
+  # ========================================================================= #
+  # === input?
+  # ========================================================================= #
+  def input?
+    @input
+  end
+
+  # ========================================================================= #
+  # === PublishMyExams.run
+  # ========================================================================= #
+  def self.run
+    Studium::PublishMyExams[]
+  end
+
+  # ========================================================================= #
+  # === establish_ftp_connection
+  # ========================================================================= #
+  def establish_ftp_connection
+    @_ = FtpParadise.connect to: :shevy
+    @_.set_mode :binary # Now in binary mode.
+    @_.cd 'ZEUGNISSE' # Enter the ZEUGNISSE/ directory.
+  end
+
+  # ========================================================================= #
+  # === upload_the_specified_files
+  # ========================================================================= #
+  def upload_the_specified_files
+    @_.upload @upload_these_files
+  end
+
+  # ========================================================================= #
+  # === set_upload_these_files
+  # ========================================================================= #
+  def set_upload_these_files(*i)
+    i = [i] unless i.is_a? Array
+    i.flatten!
+    @upload_these_files = i
+  end
+
+  # ========================================================================= #
+  # === show_finished_message
+  # ========================================================================= #
+  def show_finished_message
+    e 'All finished.'
+  end
+
+  # ========================================================================= #
+  # === consider_applying_a_filter
+  #
+  # This filter will only allow entries that match to the given input at
+  # hand.
+  # ========================================================================= #
+  def consider_applying_a_filter(input = input?)
+    unless input.empty?
+      # ===================================================================== #
+      # Ok in this case, we will apply the input and select.
+      # ===================================================================== #
+      _ = @upload_these_files
+      _.select! {|entry|
+        entry.include? input.first unless input.first.start_with?('-') # Exception for -- instructions and so forth.
+      } if input # Only select some if a filter is passed.
+      set_upload_these_files(@upload_these_files)
+    end
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    # ======================================================================= #
+    # Establish the FTP connection next.
+    # ======================================================================= #
+    establish_ftp_connection
+    # ======================================================================= #
+    # Next we can define our BOKU Dokumente.
+    # ======================================================================= #
+    boku_dokumente = Dir["#{EXAMS_RESULT}BOKU_WIEN/*.pdf"]
+    # ======================================================================= #
+    # Next the TU Zeugnisse.
+    # ======================================================================= #
+    tu_dokumente = Dir[EXAMS_RESULT+'TU_WIEN/*']
+    # ======================================================================= #
+    # Next the UniWien Sammelzeugnis.
+    # ======================================================================= #
+    uniwien_dokumente = Dir[EXAMS_RESULT+'UNI_WIEN/*']
+    # ======================================================================= #
+    # Next we upload the MedUni Dokumente.
+    # ======================================================================= #
+    meduni = Dir[EXAMS_RESULT+'MEDUNI_WIEN/MeduniWien_Sammelzeugnis*.pdf']
+    # ======================================================================= #
+    # Finally, the exam results.
+    # ======================================================================= #
+    exam_results = EXAMS_RESULT+'AAA_EXAM_RESULTS.pdf'
+    set_upload_these_files(
+      boku_dokumente, tu_dokumente, uniwien_dokumente, meduni,exam_results
+    )
+    consider_applying_a_filter
+    # ======================================================================= #
+    # Now we can batch-upload these documents.
+    # ======================================================================= #
+    upload_the_specified_files
+    show_finished_message
+  end
+
+  # ========================================================================= #
+  # === PublishMyExams[]
+  # ========================================================================= #
+  def self.[](optional_argument = '')
+    PublishMyExams.new
+  end
+
+end; end
+
+# =========================================================================== #
+# === Studium.publish_my_exams
+# =========================================================================== #
+def self.publish_my_exams
+  Studium::Exams::PublishMyExams.new
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  Studium::Exams::PublishMyExams.new(ARGV)
+end # pexam
+    # pexam Sammel

data/lib/studium/utility_scripts/random_curriculum_creator.rb

@@ -0,0 +1,173 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Studium::RandomCurriculumCreator
+#
+# The main purpose of this class is to randomly generate "individual
+# curricula", aka a curriculum that could be studied.
+#
+# This class must be able to generate either a bachelor, or a master
+# curriculum, or a combined bachelor-master curriculum.
+#
+# It has several "input modi", that is, how it will be able to
+# generate these different curricula. This may be extended over
+# time.
+#
+# Usage example:
+#   Studium::RandomCurriculumCreator.new
+# =========================================================================== #
+# require 'studium/utility_scripts/random_curriculum_creator.rb'
+# =========================================================================== #
+require 'studium/base/base.rb'
+
+module Studium
+
+class RandomCurriculumCreator < Base # === Studium::RandomCurriculumCreator.new
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      commandline_arguments = nil,
+      run_already           = true
+    )
+    reset
+    set_commandline_arguments(
+      commandline_arguments
+    )
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+    @namespace = NAMESPACE
+    # ======================================================================= #
+    # Determine how many ECTS points are in this curriculum.
+    # ======================================================================= #
+    @n_ects_points_are_in_this_curriculum = 180
+    @hash_use_these_topics = {}
+    @bachelor_or_master_curriculum = :bachelor
+  end
+
+  # ========================================================================= #
+  # === set_input
+  # ========================================================================= #
+  def set_commandline_arguments(i = '')
+    i = [i].flatten.compact
+    @commandline_arguments = i
+  end
+
+  # ========================================================================= #
+  # === commandline_arguments?
+  # ========================================================================= #
+  def commandline_arguments?
+    @commandline_arguments
+  end
+
+  # ========================================================================= #
+  # === show_header
+  # ========================================================================= #
+  def show_header
+    opnn; e 'This class can generate a random curriculum.'
+    opnn; e 'Different modi are supported.'
+    opnn; e 'We will attempt to achieve '+
+            orange(@n_ects_points_are_in_this_curriculum.to_s+' ECTS')+
+            ' points.'
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    show_header
+    string = '
+    biotechnology:      13%
+    bioinformatics:     12%
+    informatics:         5%
+    genetics:            6%
+    chemistry:           8%
+    bioinformatics:      8%
+    math:                2%
+    statistics:          3%
+    biochemistry:        8%
+    organic_chemistry:   2%
+    plants:              1%
+    '
+    e slateblue(
+        append_ects_to_percentage_values(string)
+      )
+pp @hash_use_these_topics
+pp @bachelor_or_master_curriculum
+e 'TODO:'
+e 'We must now fetch random lectures that belong to either'
+e 'a bachelor curricuulm or master curriculum, in order to satisfy the'
+e 'minimum amount of ECTS necessar'
+values = main_hash?.values
+cliner
+pp values
+cliner
+e 'Total amount of ECTS attributed so far: '+values.sum.to_s
+  end
+
+  # ========================================================================= #
+  # === hash_use_these_topics?
+  # ========================================================================= #
+  def hash_use_these_topics?
+    @hash_use_these_topics
+  end; alias main_hash? hash_use_these_topics? # === main_hash?
+
+  # ========================================================================= #
+  # === n_ects?
+  # ========================================================================= #
+  def n_ects?
+    @n_ects_points_are_in_this_curriculum
+  end
+
+  # ========================================================================= #
+  # === append_ects_to_percentage_values
+  # ========================================================================= #
+  def append_ects_to_percentage_values(i)
+    if i.is_a?(String) and i.include?('%')
+      i = i.dup if i.frozen?
+      i.strip!
+      splitted = i.split(N)
+      splitted.map! {|line|
+        if line.include? '%'
+          percentage_value = line.scan(/\d{1,4}%/).first.to_f
+          percentage_value = ((percentage_value * 100) / n_ects?).round(2)
+          line << ' ( '+percentage_value.to_s+' ECTS points minimum)'
+          topic = line.split(':').first.strip
+          # ================================================================= #
+          # We will add the topic into our main Hash next. We will store how
+          # many ECTS points are part of this curriculum, as a Float.
+          # ================================================================= #
+          @hash_use_these_topics[topic] = percentage_value.to_f.ceil.to_f
+        end
+        line
+      }
+      i = splitted.join(N)
+    end
+    i
+  end
+
+  # ========================================================================= #
+  # === Studium::RandomCurriculumCreator[]
+  # ========================================================================= #
+  def self.[](i = '')
+    self.new(i)
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  Studium::RandomCurriculumCreator.new(ARGV)
+end # random_curriculum_creator

data/lib/studium/utility_scripts/report_outdated_timetable_entries.rb

@@ -0,0 +1,145 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Studium::ReportOutdatedTimetableEntries
+#
+# This class will report which timetable-entries are obsolete.
+#
+# That way obsolete entries can be updated or removed.
+#
+# Usage example:
+#   Studium::ReportOutdatedTimetableEntries.new
+# =========================================================================== #
+# require 'studium/utility_scripts/report_outdated_timetable_entries.rb'
+# =========================================================================== #
+require 'studium/base/base.rb'
+
+module Studium
+
+class ReportOutdatedTimetableEntries < Base # === Studium::ReportOutdatedTimetabeEntries.new
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      run_already = true
+    )
+    reset
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    super()
+    @namespace = NAMESPACE
+    @array_lectures_that_have_an_outdated_entry = []
+    @today = Time.now
+    @dataset = dataset_from_file_lecture_information
+    sanitize_dataset
+  end
+
+  # ========================================================================= #
+  # === sanitize_dataset
+  #
+  # Select only lectures that actually have an exam entry.
+  # ========================================================================= #
+  def sanitize_dataset
+    @dataset.select! {|entry, inner_hash_dataset|
+      exams = inner_hash_dataset['exams']
+      !exams.nil?
+    }
+  end
+
+  # ========================================================================= #
+  # === check_for_outdated_exam_entries
+  # ========================================================================= #
+  def check_for_outdated_exam_entries
+    @dataset.each {|name_of_the_lecture, inner_hash_dataset|
+      exams = inner_hash_dataset['exams']
+      exams.each {|exam_date|
+        exam_date = remove_weekdays(exam_date)
+        if exam_date.include? 'Ort:'
+          exam_date = exam_date[0 .. (exam_date.index('Ort:')-1)]
+        end
+        exam_date.delete!(',')
+        exam_date.strip!
+        original_exam_date = exam_date
+        exam_date = Time.parse(exam_date)
+        if exam_date < @today
+          @array_lectures_that_have_an_outdated_entry << [
+            name_of_the_lecture, original_exam_date
+          ]
+        end
+      }
+    }
+  end
+
+  # ========================================================================= #
+  # === array_lectures_that_have_an_outdated_entry?
+  # ========================================================================= #
+  def array_lectures_that_have_an_outdated_entry?
+    @array_lectures_that_have_an_outdated_entry
+  end
+
+  # ========================================================================= #
+  # === report                                                   (report tag)
+  # ========================================================================= #
+  def report(
+      i = @array_lectures_that_have_an_outdated_entry
+    )
+    if i.empty?
+      opnn; e 'No outdated entries could be found - all are up '\
+              'to date. '+yellow('\o/')
+    else
+      opnn; e 'The following entries are outdated:'
+      e
+      index = 0
+      i.each {|name_of_the_lecture, outdated_entry| index += 1
+        padded_index = index.to_s.rjust(4)+' '
+        colourized_and_padded_index = orange(padded_index)
+        e '  '+
+          colourized_and_padded_index+
+          slateblue(name_of_the_lecture.ljust(75))+
+          royalblue(outdated_entry)
+      }
+      e
+    end
+  end
+
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run
+    check_for_outdated_exam_entries
+    report
+  end
+
+  # ========================================================================= #
+  # === []
+  # ========================================================================= #
+  def self.[](i = '')
+    self.new(i)
+  end
+
+end
+
+# =========================================================================== #
+# === Studium.report_outdated_timetable_entries
+# =========================================================================== #
+def self.report_outdated_timetable_entries(i = ARGV)
+  ::Studium::ReportOutdatedTimetableEntries.new(i)
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  Studium::ReportOutdatedTimetableEntries.new(ARGV)
+end # report_outdated_timetable_entries