studium 0.9.383

data/lib/studium/utility_scripts/mandatory_lectures_in_this_month.rb

@@ -0,0 +1,310 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Studium::MandatoryLecturesInThisMonth
+#
+# This class can be used to display which mandatory lectures are done
+# on a per-month basis.
+#
+# Usage example:
+#   Studium::MandatoryLecturesInThisMonth.new
+# =========================================================================== #
+# require 'studium/utility_scripts/mandatory_lectures_in_this_month.rb'
+# =========================================================================== #
+require 'studium/base/base.rb'
+
+module Studium
+
+class MandatoryLecturesInThisMonth < ::Studium::Base # === Studium::MandatoryLecturesInThisMonth.new
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === AVAILABLE_MONTHS
+  # ========================================================================= #
+  AVAILABLE_MONTHS = Date::MONTHNAMES
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      i           = nil,
+      run_already = true
+    )
+    reset
+    set_show_mandatory_courses_in_this_month(i)
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+    # ======================================================================= #
+    # The following variable is important so that we know whether
+    # we shall check against the current year, or the next year.
+    # This depends on the input passed to the method
+    # set_show_mandatory_courses_in_this_month() ultimately.
+    # ======================================================================= #
+    @check_against_this_year = Time.now.year
+    if ::Studium.main_dataset?
+      @dataset = ::Studium.main_dataset?
+    else
+      @dataset = return_dataset_from_file_lecture_information
+    end
+  end
+
+  # ========================================================================= #
+  # === set_show_mandatory_courses_in_this_month
+  #
+  # Note that we will store the month as a number.
+  # ========================================================================= #
+  def set_show_mandatory_courses_in_this_month(i = '')
+    i = i.join(' ').strip if i.is_a? Array # We want a String past this point here.
+    i = i.to_s # First a String, to check for month-names.
+    if MONTH_NAME_ALIASES_GERMAN_TO_ENGLISH.has_key? i.capitalize
+      i = MONTH_NAME_ALIASES_GERMAN_TO_ENGLISH[i.capitalize]
+    end
+    if MONTH_NAME_TO_MONTH_NUMBER.has_key? i.capitalize
+      # ===================================================================== #
+      # If the key is found in that number, we will use its value.
+      # ===================================================================== #
+      i = MONTH_NAME_TO_MONTH_NUMBER[i.capitalize]
+    end
+    i = i.to_i
+    @show_mandatory_courses_in_this_month = i
+    # ======================================================================= #
+    # Whenever the month has been assigned, we also need to consider
+    # updating the variable called @check_against_this_year.
+    # The logic for this is simple - if the number is below the current
+    # month, then we will add +1 to @check_against_this_year. 
+    # ======================================================================= #
+    if i < Time.now.month
+      @check_against_this_year += 1
+    end
+  end
+
+  # ========================================================================= #
+  # === show_mandatory_courses_in_this_month?
+  # ========================================================================= #
+  def show_mandatory_courses_in_this_month?
+    @show_mandatory_courses_in_this_month
+  end; alias searching_for_which_month? show_mandatory_courses_in_this_month? # === searching_for_which_month?
+
+  # ========================================================================= #
+  # === opnn
+  # ========================================================================= #
+  def opnn
+    super(NAMESPACE)
+  end
+
+  # ========================================================================= #
+  # === which_month?
+  #
+  # This method must return the name of a month.
+  # ========================================================================= #
+  def which_month?
+    AVAILABLE_MONTHS[@show_mandatory_courses_in_this_month]
+  end
+
+  # ========================================================================= #
+  # === determine_which_courses_are_run_in_this_month
+  # ========================================================================= #
+  def determine_which_courses_are_run_in_this_month
+    searching_for_this_month = searching_for_which_month?
+    searching_for_this_year  = searching_for_which_year?
+    _ = @dataset
+    # ======================================================================= #
+    # We must determine next which entries are in the month at hand.
+    # ======================================================================= #
+    _.select! {|name_of_the_lecture, inner_dataset|
+      lva_dates = inner_dataset['lva_dates']
+      if lva_dates
+        only_the_month = lva_dates.map {|entry|
+          entry = remove_weeknames(entry).strip
+          # ================================================================= #
+          # Invalidate entries that do not use the target year.
+          # ================================================================= #
+          unless entry.include? searching_for_this_year.to_s
+            entry = nil
+          end
+          if entry
+            if entry.include? ','
+              entry = entry.split(',').first
+            end
+            if entry.include? '.'
+              entry = entry.split('.')[1].to_i # This selects the month-entry. 
+            end
+          end
+          entry
+        }
+        only_the_month.compact!
+        only_the_month.include? searching_for_this_month
+      else
+        e swarn('No lva entry for `')+
+          slateblue(name_of_the_lecture)+
+          swarn('`.')
+      end
+    }
+    # ======================================================================= #
+    # Sort by priority first.
+    # ======================================================================= #
+    _ = _.sort_by {|a, b| priority = b[:priority]
+      priority # Sort by priority first.
+    }
+    @dataset = _
+    e
+    e 'The following lectures are in the month '+orange(which_month?.to_s)+':'
+    e
+    report(@dataset)
+  end
+
+  # ========================================================================= #
+  # === report                                                   (report tag)
+  #
+  # This is the general reporting-method of this class. Arrays and Hashes
+  # may be treated somewhat differently.
+  # ========================================================================= #
+  def report(
+      i = @dataset
+    )
+    result = ''.dup
+    if i.is_a? Hash
+      i.each_pair {|a, b|
+        result << '  '+powderblue(a)+N
+      }
+    elsif i.is_a? Array
+      counter = 0
+      i.each {|name_of_the_lecture, b| counter += 1
+        result << '  '+royalblue((counter.to_s+')').ljust(4))+
+                  powderblue(name_of_the_lecture)
+        lva_dates    = b['lva_dates']
+        lecture_type = obtain(:type, b)
+        if lva_dates.is_a? Array
+          lva_dates.map! {|inner_line|
+            inner_line.strip.delete(',')
+          }
+        end
+        if b.is_a?(Hash) and b.has_key?(:priority)
+          # ================================================================= #
+          # In this case append the priority. And the amount of ECTS too.
+          # ================================================================= #
+          result << +seagreen(
+            ' (Priority: '+b[:priority].to_s
+          )
+          if b.has_key?(:ects)
+            result << seagreen('; ')
+            result << mediumorchid(b[:ects].to_s+' ECTS')
+          end
+          result << "; Type: #{lecture_type}"
+          result << seagreen(')')
+        end
+        result << N
+        this_month = @show_mandatory_courses_in_this_month
+        unless lva_dates.empty?
+          result << N # A prettier newline before we will display the rest.
+        end
+        # =================================================================== #
+        # Next, also show the lectures in this month.
+        # =================================================================== #
+        lva_dates.each {|lva_date|
+          # ================================================================= #
+          # Only add it if it is the proper month.
+          # ================================================================= #
+          splitted = lva_date.split('.')
+          month = splitted[1].to_i
+          if month == this_month
+            weekday = return_weekday_from_this_input(lva_date, :use_german).ljust(10)
+            result << skyblue('    ')+
+                      mediumseagreen(weekday)+
+                      skyblue(' '+lva_date+N)
+          end
+        }
+        result << N # A prettier newline before we will display the rest.
+      }
+    end
+    result << N
+    e result
+  end
+
+  # ========================================================================= #
+  # === check_against_this_year?
+  # ========================================================================= #
+  def check_against_this_year?
+    @check_against_this_year
+  end; alias check_for_which_year?     check_against_this_year? # === check_for_which_year?
+       alias searching_for_which_year? check_against_this_year? # === check_against_this_year?
+
+  # ========================================================================= #
+  # === select_only_unfinished_mandatory_presence_courses_with_a_lva_dates_entry
+  #
+  # We will select only the following courses:
+  #
+  #   (1) Those that are "prüfungsimmanent", aka require "mandatory presence"
+  #   (2) Those that have NOT yet been solved
+  #   (3) Those that DO have a lva_dates entry.
+  #
+  # ========================================================================= #
+  def select_only_unfinished_mandatory_presence_courses_with_a_lva_dates_entry
+    @dataset.select! {|a, inner_dataset|
+      lecture_type = inner_dataset[:type]
+      already_solved = inner_dataset[:already_solved]
+      has_lva_dates_entry = inner_dataset.has_key?('lva_dates')
+      is_prüfungsimmanent?(lecture_type) and
+      (!already_solved) and
+      has_lva_dates_entry
+    }
+  end
+
+  # ========================================================================= #
+  # === show_introduction_header
+  # ========================================================================= #
+  def show_introduction_header
+    opnn { :no_colon }
+    e
+    e
+    e 'All lectures that offer a date on '\
+      'the month '+teal(which_month?.to_s)+
+      ' will be shown next.'
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    show_introduction_header
+    # ======================================================================= #
+    # First, we will select mandatory-presence courses.
+    # ======================================================================= #
+    select_only_unfinished_mandatory_presence_courses_with_a_lva_dates_entry
+    determine_which_courses_are_run_in_this_month
+  end
+
+  # ========================================================================= #
+  # === []
+  # ========================================================================= #
+  def self.[](i = '')
+    self.new(i)
+  end
+
+end
+
+# =========================================================================== #
+# === Studium.mandatory_lectures_in_this_month
+# =========================================================================== #
+def self.mandatory_lectures_in_this_month(i)
+  Studium::MandatoryLecturesInThisMonth.new(i)
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  Studium::MandatoryLecturesInThisMonth.new(ARGV)
+end # mandatory_lectures_in_this_month November
+    # mandatory_lectures_in_this_month März
+    # mandatory_lectures_in_this_month 10

data/lib/studium/utility_scripts/name_of_this_lva_id.rb

@@ -0,0 +1,117 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Studium::NameOfThisLvaId
+#
+# This class will simply return the name of the lecture at hand. If there
+# is more than one candidate, all results will be shown to the user.
+#
+# Usage example:
+#   Studium::NameOfThisLvaId.new
+# =========================================================================== #
+# require 'name_of_this_lva_id.rb'
+# =========================================================================== #
+require 'studium/base/base.rb'
+
+module Studium
+
+class NameOfThisLvaId < ::Studium::Base # === Studium::NameOfThisLvaId.new
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      i           = nil,
+      run_already = true
+    )
+    reset
+    set_input(i)
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+    @matches = nil # <- We will store our results here.
+    @dataset = dataset_from_file_lecture_information
+  end
+
+  # ========================================================================= #
+  # === set_input
+  # ========================================================================= #
+  def set_input(i = '')
+    i = i.first if i.is_a? Array
+    i = i.to_s.dup
+    @input = i
+  end
+
+  # ========================================================================= #
+  # === input?
+  # ========================================================================= #
+  def input?
+    @input
+  end
+
+  # ========================================================================= #
+  # === try_to_find_matches
+  # ========================================================================= #
+  def try_to_find_matches
+    search_for_this_lva_id = @input
+    @matches = @dataset.select {|a, b|
+      a.start_with?(search_for_this_lva_id)
+    }
+  end
+
+  # ========================================================================= #
+  # === report
+  # ========================================================================= #
+  def report(
+      i = @matches
+    )
+    if i
+      lva_id = @input
+      e
+      @matches.each {|name_of_the_lecture, b|
+        e '  '+royalblue(
+          name_of_the_lecture.sub(/#{lva_id}/,'')
+        )
+      }
+      e
+    else
+      e 'No matches were found for `'+simp(@input)+'`.'
+    end
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    try_to_find_matches
+    report
+  end
+
+  # ========================================================================= #
+  # === []
+  # ========================================================================= #
+  def self.[](i = '')
+    self.new(i)
+  end
+
+end
+
+# =========================================================================== #
+# === Studium.name_of_this_lva_id
+# =========================================================================== #
+def self.name_of_this_lva_id(i)
+  ::Studium::NameOfThisLvaId.new(i)
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  Studium::NameOfThisLvaId.new(ARGV)
+end # name_of_this_lva_id 269004
+    # name_of_this_lva_id 269020

data/lib/studium/utility_scripts/new_stud.rb

@@ -0,0 +1,320 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Studium::NewStud
+#
+# The purpose of this class is to properly set a new Studium-Focus point.
+#
+# The default way how this works is by invoking this script in the
+# directory that you wish to make the new default. We will then read
+# in the dataset from cd_aliases.yml, find the line that has the
+# target slot set, replace that line with the new content, and then
+# store that as a new file.
+#
+# Usage example:
+#
+#   Studium::NewStud.new(ARGV)
+#
+# =========================================================================== #
+# require 'studium/utility_scripts/new_stud.rb'
+# =========================================================================== #
+require 'studium/requires/base_class_and_common_popular_requires.rb'
+
+module Studium
+
+class NewStud < Studium::Base # === Studium::NewStud.new
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === FILE_LOCATION_CD_ALIASES
+  # ========================================================================= #
+  FILE_LOCATION_CD_ALIASES  = FILE_CD_ALIASES
+
+  # ========================================================================= #
+  # Next come the ~16 keywords we can scan for.
+  # ========================================================================= #
+  FIND_THIS_LINE                              = 'pwdstud1:'
+  FIND_THIS_SECONDARY_LINE                    = 'pwdstud2:'
+  FIND_THIS_TERTIARY_LINE                     = 'pwdstud3:'
+  FIND_THIS_QUATERNARY_LINE                   = 'pwdstud4:'
+  FIND_THIS_QUINTARY_LINE                     = 'pwdstud5:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_SIX         = 'pwdstud6:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_SEVEN       = 'pwdstud7:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_EIGHT       = 'pwdstud8:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_NINE        = 'pwdstud9:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_TEN         = 'pwdstud10:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_ELEVEN      = 'pwdstud11:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_TWELVE      = 'pwdstud12:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_THIRTEEN    = 'pwdstud13:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_FOURTEEN    = 'pwdstud14:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_FIFTEEN     = 'pwdstud15:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_SIXTEEN     = 'pwdstud16:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_SEVENTEEN   = 'pwdstud17:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_EIGHTEEN    = 'pwdstud18:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_NINETEEN    = 'pwdstud19:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_TWENTY      = 'pwdstud20:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_TWENTYONE   = 'pwdstud21:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_TWENTYTWO   = 'pwdstud22:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_TWENTYTHREE = 'pwdstud23:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_TWENTYFOUR  = 'pwdstud24:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_TWENTYFIVE  = 'pwdstud25:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_TWENTYSIX   = 'pwdstud26:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_TWENTYSEVEN = 'pwdstud27:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_TWENTYEIGHT = 'pwdstud28:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_TWENTYNINE  = 'pwdstud29:'
+  FIND_THIS_LINE_FOR_ENTRY_NUMBER_THIRTY      = 'pwdstud30:'
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      use_this_as_the_base_directory = Dir.pwd,
+      run_already                    = true
+    )
+    reset
+    set_base_dir(
+      use_this_as_the_base_directory
+    ) # Defaults to the currently working directory.
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    super()
+    @namespace = NAMESPACE
+    @array_all_matches = []
+    # ======================================================================= #
+    # The next variable can be used to toggle simulation-mode. If the
+    # variable @simulate_only is true, then no file-changes will be made.
+    # ======================================================================= #
+    @simulate_only = false
+    # ======================================================================= #
+    # The following instance variable will keep track which line was
+    # modified.
+    # ======================================================================= #
+    @this_line_was_modified = nil
+    set_find_this_line
+    load_cd_aliases
+  end
+
+  # ========================================================================= #
+  # === find_this_line?
+  # ========================================================================= #
+  def find_this_line?
+    @find_this_line
+  end
+
+  # ========================================================================= #
+  # === load_cd_aliases
+  # ========================================================================= #
+  def load_cd_aliases
+    _ = FILE_LOCATION_CD_ALIASES
+    if File.exist? _
+      # ===================================================================== #
+      # @data will contain the content of the cd_aliases.yml file.
+      # ===================================================================== #
+      @data = File.readlines(_, :encoding => USE_THIS_ENCODING)
+    else
+      ewarn "The file does not exist at `#{sfile(_)}`."
+    end
+  end
+
+  # ========================================================================= #
+  # === set_find_this_line
+  #
+  # The list goes like this:
+  #   primary, secondary, tertiary, quaternary, quinary,
+  #   senary, septenary, octonary, nonary, and denary.
+  # ========================================================================= #
+  def set_find_this_line(
+      i = FIND_THIS_LINE
+    )
+    i = i.to_s # We require a String here.
+    case i # case tag
+    when 'secondary', '2'
+      i = FIND_THIS_SECONDARY_LINE
+    when 'tertiary', '3'
+      i = FIND_THIS_TERTIARY_LINE
+    when 'quaternary', '4'
+      i = FIND_THIS_QUATERNARY_LINE
+    when 'quintary', '5'
+      i = FIND_THIS_QUINTARY_LINE
+    when '6'
+      i = FIND_THIS_LINE_FOR_ENTRY_NUMBER_SIX
+    when '7'
+      i = FIND_THIS_LINE_FOR_ENTRY_NUMBER_SEVEN
+    when '8'
+      i = FIND_THIS_LINE_FOR_ENTRY_NUMBER_EIGHT
+    when '9'
+      i = FIND_THIS_LINE_FOR_ENTRY_NUMBER_NINE
+    when '10'
+      i = FIND_THIS_LINE_FOR_ENTRY_NUMBER_TEN
+    when '11'
+      i = FIND_THIS_LINE_FOR_ENTRY_NUMBER_ELEVEN
+    when '12'
+      i = FIND_THIS_LINE_FOR_ENTRY_NUMBER_TWELVE
+    when '13'
+      i = FIND_THIS_LINE_FOR_ENTRY_NUMBER_THIRTEEN
+    when '14'
+      i = FIND_THIS_LINE_FOR_ENTRY_NUMBER_FOURTEEN
+    when '15'
+      i = FIND_THIS_LINE_FOR_ENTRY_NUMBER_FIFTEEN
+    when '16'
+      i = FIND_THIS_LINE_FOR_ENTRY_NUMBER_SIXTEEN
+    when '17'
+      i = FIND_THIS_LINE_FOR_ENTRY_NUMBER_SEVENTEEN
+    when '18'
+      i = FIND_THIS_LINE_FOR_ENTRY_NUMBER_EIGHTEEN
+    when '19'
+      i = FIND_THIS_LINE_FOR_ENTRY_NUMBER_NINETEEN
+    when '20'
+      i = FIND_THIS_LINE_FOR_ENTRY_NUMBER_TWENTY
+    when '21'
+      i = FIND_THIS_LINE_FOR_ENTRY_NUMBER_TWENTYONE
+    when '22'
+      i = FIND_THIS_LINE_FOR_ENTRY_NUMBER_TWENTYTWO
+    when '23'
+      i = FIND_THIS_LINE_FOR_ENTRY_NUMBER_TWENTYTHREE
+    when '24'
+      i = FIND_THIS_LINE_FOR_ENTRY_NUMBER_TWENTYFOUR
+    when '25'
+      i = FIND_THIS_LINE_FOR_ENTRY_NUMBER_TWENTYFIVE
+    when '26'
+      i = FIND_THIS_LINE_FOR_ENTRY_NUMBER_TWENTYSIX
+    end
+    @find_this_line = i
+  end; alias set_entry set_find_this_line # === set_entry
+
+  # ========================================================================= #
+  # === opnn
+  # ========================================================================= #
+  def self.opnn
+    Opn.opn(namespace: NAMESPACE)
+  end
+
+  # ========================================================================= #
+  # === Studium::NewStud[]
+  #
+  # Simplified accessor towards secondary, tertiary and quaternary.
+  #
+  # Pass in a number (or a String representing a number) to this method.
+  # ========================================================================= #
+  def self.[](i = 'pwdstud1')
+    i = i.to_i
+    _ = self.new(:default_directory, false) # Instantiate it here.
+    case i
+    when 1, 2
+      _.set_entry :secondary
+    when 3
+      _.set_entry :tertiary
+    when 4
+      _.set_entry :quaternary
+    when 5
+      _.set_entry :quintary
+    when 6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,
+         21,22,23,24,25
+      _.set_entry(i)
+    else
+      opnn; e swarn('Not found entry `'+i.to_s+'`.')
+    end
+    _.run
+  end
+
+  # ========================================================================= #
+  # === set_base_dir
+  #
+  # Set the target directory that will become our new main directory.
+  # ========================================================================= #
+  def set_base_dir(i = Dir.pwd)
+    i = i.to_s.dup
+    case i
+    when 'default_directory','default',''
+      i = Dir.pwd
+    end
+    @base_dir = i
+  end
+
+  # ========================================================================= #
+  # === find_potential_match
+  # ========================================================================= #
+  def find_potential_match
+    @data.each_with_index {|line, index|
+      # ===================================================================== #
+      # We scan for what value is stored in @find_this_line next.
+      # ===================================================================== #
+      if line.include? @find_this_line # Could be a match
+        @array_all_matches << [line, index] if line[/^#{@find_this_line}/]
+      end
+    }
+    # ======================================================================= #
+    # For now, we pick only the first element.
+    # ======================================================================= #
+    match = @array_all_matches.first
+    unless match.empty?
+      splitted = match[0].split(':')
+      # Next get the padding:
+      padding = splitted[1][/\A */]
+      # ===================================================================== #
+      # Note that for the following line to work, the variable @base_dir
+      # must have been properly set before.
+      # ===================================================================== #
+      splitted[1] = padding+'cd '+@base_dir+N # +'; pwd'+N # We no longer append .pwd
+      new_line = splitted.join(':') # The modified line.
+      @data[match[1]] = new_line
+      @this_line_was_modified = new_line
+      save_new_dataset
+    else
+      e 'We did not find any match.'
+    end
+  end
+  
+  # ========================================================================= #
+  # === save_new_dataset
+  #
+  # This method will save the complete dataset into the "cd_aliases.yml"
+  # file.
+  # ========================================================================= #
+  def save_new_dataset(what = @data)
+    into = FILE_LOCATION_CD_ALIASES
+    opnn; e "Storing into `#{sfile(into)}`."
+    opnn; e " (The dataset that was stored was:)"
+    e
+    e "    #{slateblue(@this_line_was_modified)})"
+    e
+    unless @simulate_only
+      write_what_into(what, into)
+    end
+  end
+
+  # ========================================================================= #
+  # === generate_rc_files
+  # ========================================================================= #
+  def generate_rc_files
+    begin
+      require 'generate_rc_file' unless Object.const_defined? :GenerateRcFile
+    rescue LoadError; end
+    unless @simulate_only
+      GenerateRcFile.new(:cd_aliases) # We only need the cd_aliases, not the other aliases.
+    end
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    find_potential_match
+    generate_rc_files # Generate a new cd_aliases.rc file here.
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  Studium::NewStud.new(ARGV.first)
+end # newstud