studium 0.18.7

data/lib/studium/gui/universal_widgets/exam_trainer/manifest.yml

@@ -0,0 +1,12 @@
+# x = YAML.load_file('manifest.yml')
+buttons:
+ button_ask_the_exam_question:
+  text:         Ask a _Question
+  weight:       :bold
+  use_mnemonic: yes
+  width:        78
+  height:       30
+  colour:       lightblue
+  tooltip:      |
+   Click on this button to ask an exam-question.
+   (Or, use alt+q as shortcut)

data/lib/studium/gui/universal_widgets/expand_time_range/expand_time_range.rb

@@ -0,0 +1,309 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Studium::GUI::UniversalWidgets::ExpandTimeRange
+# =========================================================================== #
+# require 'studium/gui/universal_widgets/expand_time_range/expand_time_range.rb'
+# =========================================================================== #
+require 'universal_widgets/base/base.rb'
+
+module Studium
+
+module GUI
+
+module UniversalWidgets
+
+class ExpandTimeRange < ::UniversalWidgets::Base # === Studium::GUI::UniversalWidgets::ExpandTimeRange
+
+  require 'universal_widgets/base_module/base_module.rb'
+  include ::UniversalWidgets::BaseModule
+  extend  ::UniversalWidgets::BaseModule
+
+  require 'studium/utility_scripts/expand_time_range/expand_time_range.rb'
+
+  # ========================================================================= #
+  # === TITLE
+  # ========================================================================= #
+  TITLE = 'Expand Time Range'
+
+  # ========================================================================= #
+  # === WIDTH
+  # ========================================================================= #
+  WIDTH = '48% or minimum 1860px'
+
+  # ========================================================================= #
+  # === HEIGHT
+  # ========================================================================= #
+  HEIGHT =  '35% or minimum 400px'
+
+  # ========================================================================= #
+  # === DEFAULT_TEXT_FOR_THE_ENTRY
+  # ========================================================================= #
+  DEFAULT_TEXT_FOR_THE_ENTRY = '14.01.'+current_year?.to_s+'-05.02.'+current_year?.to_s
+
+  # ========================================================================= #
+  # === USE_THIS_FONT
+  # ========================================================================= #
+  USE_THIS_FONT = 'Sans 18'
+
+  # ========================================================================= #
+  # === SMALLER_FONT
+  # ========================================================================= #
+  SMALLER_FONT = 'Sans 15'
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      commandline_arguments = nil,
+      run_already           = true
+    )
+    determine_the_GUI_to_be_used(commandline_arguments)
+    reset
+    set_commandline_arguments(
+      commandline_arguments
+    )
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super() if respond_to?(:super)
+    reset_the_shared_module # This can come early.
+    reset_the_base_module
+    reset_the_internal_variables
+    infer_the_namespace
+    Studium.set_runmode :gui # Make it known that we use the gui-runmode in this case.
+    # ======================================================================= #
+    # === @configuration
+    # ======================================================================= #
+    @configuration = [true, __dir__, namespace?]
+    # ======================================================================= #
+    # === Set the title, width, height and the font in use.
+    # ======================================================================= #
+    title_width_height_font(TITLE, WIDTH, HEIGHT, USE_THIS_FONT)
+    infer_the_size_automatically
+    handle_CSS_related_aspects if use_gtk3?
+    # ======================================================================= #
+    # === @internal_hash[:smaller_font]
+    # ======================================================================= #
+    @internal_hash[:smaller_font] = SMALLER_FONT
+  end
+
+  # ========================================================================= #
+  # === reset_the_shared_module
+  # ========================================================================= #
+  def reset_the_shared_module
+  end
+
+  # ========================================================================= #
+  # === handle_CSS_related_aspects                                  (CSS tag)
+  # ========================================================================= #
+  def handle_CSS_related_aspects
+    use_gtk_paradise_project_css_file
+    append_project_css_file
+    add_custom_CSS_rules '
+
+    '
+    do_apply_the_CSS_rules
+  end; alias handle_CSS handle_CSS_related_aspects # === handle_CSS 
+
+  # ========================================================================= #
+  # === create_the_buttons                          (buttons tag, button tag)
+  # ========================================================================= #
+  def create_the_buttons
+    @button_translate_the_time_ranges = create_button('Expand ➡️')
+    @button_translate_the_time_ranges.royalblue
+    @button_translate_the_time_ranges.bblack3 
+    @button_translate_the_time_ranges.hint =
+      ' <b>Click</b> on this button to '\
+      '<b>translate the time-range into individual dates</b> '
+    # ======================================================================= #
+    # Enable the expand-functionality here, from the studium-gem.
+    # ======================================================================= #
+    @button_translate_the_time_ranges.on_clicked {
+      text = Studium.expand_time_range(@entry_time_range.text) { :disable_colours }.result?
+      @text_buffer.set_text(text.to_s)
+    }
+    @button_translate_the_time_ranges.on_right_mouse_button_click {
+      # ===================================================================== #
+      # Right-click event will clear the main textbuffer.
+      # ===================================================================== #
+      do_clear_the_main_textbuffer
+    }
+  end
+
+  # ========================================================================= #
+  # === padding?
+  # ========================================================================= #
+  def padding?
+    2
+  end
+
+  # ========================================================================= #
+  # === border_size?
+  # ========================================================================= #
+  def border_size?
+    2
+  end
+
+  # ========================================================================= #
+  # === create_the_skeleton                        (create tag, skeleton tag)
+  # ========================================================================= #
+  def create_the_skeleton
+    create_the_buttons
+    @text_buffer = create_text_buffer
+    @text_view   = create_text_view(@text_buffer)
+    @scrolled_window = create_scrolled_window(@text_view)
+    @scrolled_window.do_show_the_scrollbars
+    @scrolled_window.set_font(:hack_18)
+    @scrolled_window.set_size_request(800, 500)
+    create_the_entries
+    @label_expand_time_range = create_bold_label('Expand time range: ')
+  end
+
+  # ========================================================================= #
+  # === create_the_entries
+  # ========================================================================= #
+  def create_the_entries
+    @entry_time_range = create_entry(DEFAULT_TEXT_FOR_THE_ENTRY)
+    @entry_time_range.set_size_request(500, 50)
+    @entry_time_range.align_to_the_center
+  end
+
+  # ========================================================================= #
+  # === update_the_tree_view_with_this_curriculum                (update tag)
+  # ========================================================================= #
+  def update_the_tree_view_with_this_curriculum(i)
+    i = i.first.to_s if i.is_a? Array
+    i = i.to_sym
+    @use_this_curriculum = i
+    # ======================================================================= #
+    # Obtain the dataset from the curriculum-file.
+    # ======================================================================= #
+    curriculum_dataset = ::Studium.read_dataset_from_a_curriculum_file(
+      @use_this_curriculum, :remove_comments_and_title
+    )
+    e "Now using the curriculum `#{::Colours.steelblue(i)}`."
+    main_dataset = main_dataset?
+    @list_store.clear
+    n_ECTS_in_total = 0
+    curriculum_dataset.each {|this_entry|
+      this_entry = this_entry.dup if this_entry.frozen?
+      this_entry.squeeze!(' ')
+      e 'Using the pointer for '+::Colours.steelblue(this_entry)+' next.'
+      pointer        = main_dataset[this_entry]
+      if pointer.nil?
+        e 'Faulty entry for '+this_entry+'.'
+        return
+      end
+      n_ects         = pointer[:ects].to_s.rjust(8)
+      n_ECTS_in_total += n_ects.strip.to_f
+      which_semester = pointer[:semester].to_s
+      iter = @list_store.append
+      splitted = this_entry.split(' ')
+      lva_id   = splitted.first
+      raw_name_of_the_lecture = splitted[1 .. -1].join(' ')
+      already_solved = pointer[:already_solved]
+      if already_solved
+        already_solved_or_not = 'Yes'
+      else
+        already_solved_or_not = 'No'
+      end
+      iter.set_value(0, lva_id)
+      iter.set_value(1, raw_name_of_the_lecture)
+      iter.set_value(2, n_ects)
+      iter.set_value(3, which_semester)
+      iter.set_value(4, already_solved_or_not)
+    }
+    @entry_n_ECTS_in_total.set_text(n_ECTS_in_total.to_s)
+  end
+
+  # ========================================================================= #
+  # === do_clear_the_main_textbuffer
+  # ========================================================================= #
+  def do_clear_the_main_textbuffer
+    @text_buffer.clear
+  end
+
+  # ========================================================================= #
+  # === text_buffer?
+  # ========================================================================= #
+  def text_buffer?
+    @text_buffer
+  end
+
+  # ========================================================================= #
+  # === connect_the_skeleton                                    (connect tag)
+  # ========================================================================= #
+  def connect_the_skeleton
+    abort_on_exception
+    
+    outer_vbox = create_vbox
+
+    hbox = create_hbox
+    hbox.minimal(@label_expand_time_range, 2)
+    hbox.minimal(@entry_time_range,        2); @entry_time_range.deselect
+    hbox.minimal(@button_translate_the_time_ranges, 2)
+    hbox.minimal(@scrolled_window, 2)
+
+    outer_vbox.minimal(hbox, 5)
+    outer_vbox.show_all
+    
+    window = create_window_or_runner(nil, width?, height?, title?)
+    window << outer_vbox
+
+    properly_prepare_this_window(window,
+      {
+        title:       title?,
+        font:        font?,
+        width:       width?,
+        height:      height?,
+        padding:     padding?,
+        border_size: border_size?
+      }
+    )
+    window.show_all
+    window.top_left
+    window.enable_quick_exit
+    window.set_default_size(width?, height?)
+    run_main
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    run_super
+  end
+
+  # ========================================================================= #
+  # === Studium::GUI::Gtk::ExpandTimeRange.run
+  # ========================================================================= #
+  def self.run(
+      i = ARGV
+    )
+    require 'gtk_paradise/run'
+    _ = ::Studium::GUI::Gtk::ExpandTimeRange.new(i)
+    r = ::Gtk.run
+    r << _
+    r.automatic_size_then_automatic_title
+    r.show_all
+    r.top_left_then_run
+  end
+
+  # ========================================================================= #
+  # === Studium::GUI::UniversalWidgets::ExpandTimeRange[]
+  # ========================================================================= #
+  def self.[](i = ARGV)
+    new(i)
+  end
+
+end; end; end; end
+
+if __FILE__ == $PROGRAM_NAME
+  Studium::GUI::UniversalWidgets::ExpandTimeRange.new(ARGV)
+end # 

data/lib/studium/gui/universal_widgets/information_about_a_lecture/information_about_a_lecture.rb

@@ -0,0 +1,242 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Studium::GUI::UniversalWidgets::InformationAboutALecture
+# =========================================================================== #
+# require 'studium/gui/universal_widgets/information_about_a_lecture/information_about_a_lecture.rb'
+# =========================================================================== #
+require 'universal_widgets/base/base.rb'
+
+module Studium
+
+module GUI
+
+module UniversalWidgets
+
+class InformationAboutALecture < ::UniversalWidgets::Base # === Studium::GUI::UniversalWidgets::InformationAboutALecture
+
+  require 'universal_widgets/base_module/base_module.rb'
+  include ::UniversalWidgets::BaseModule
+
+  require 'studium/toplevel_methods/toplevel_methods.rb'
+
+  # ========================================================================= #
+  # === TITLE
+  # ========================================================================= #
+  TITLE = 'Information about a lecture module'
+
+  # ========================================================================= #
+  # === WIDTH
+  # ========================================================================= #
+  WIDTH = '35% or minimum 1400px'
+
+  # ========================================================================= #
+  # === HEIGHT
+  # ========================================================================= #
+  HEIGHT =  '35% or minimum 1200px'
+
+  # ========================================================================= #
+  # === USE_THIS_FONT
+  # ========================================================================= #
+  USE_THIS_FONT = :dejavu_condensed_25
+
+  # ========================================================================= #
+  # === SMALLER_FONT
+  # ========================================================================= #
+  SMALLER_FONT = :dejavu_condensed_20
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      commandline_arguments = nil,
+      run_already           = true
+    )
+    # ======================================================================= #
+    # We first have to determine the GUI that is to be used, even before
+    # calling reset(). The reason is that this will also require some
+    # files, such as the Gdk namespace, which may be used by the GUI
+    # related parts for ruby-gtk3, for instance.
+    # ======================================================================= #
+    determine_the_GUI_to_be_used(commandline_arguments)
+    reset
+    set_commandline_arguments(
+      commandline_arguments
+    )
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super() if respond_to?(:super)
+    reset_the_internal_variables
+    reset_the_base_module # This must come after reset_the_internal_variables().
+    infer_the_namespace
+    Studium.set_runmode :gui # Make it known that we use the gui-runmode in this case.
+    # ======================================================================= #
+    # === @configuration
+    # ======================================================================= #
+    @configuration = [true, __dir__, namespace?]
+    # ======================================================================= #
+    # === Set the title; this must come after we delegate to the
+    #     @configuration object
+    # ======================================================================= #
+    set_title(
+      return_the_title_from_the_config_file(true, @configuration)
+    )
+    # ======================================================================= #
+    # === Set the title, width, height and the font in use.
+    # ======================================================================= #
+    title_width_height_font(title?, WIDTH, HEIGHT, USE_THIS_FONT)
+    infer_the_size_automatically
+    # ======================================================================= #
+    # === @internal_hash[:smaller_font]
+    # ======================================================================= #
+    @internal_hash[:smaller_font] = SMALLER_FONT
+    upon_delete_event_quit_the_application
+    handle_CSS_related_aspects if use_gtk3?
+    # ======================================================================= #
+    # === @dataset
+    # ======================================================================= #
+    @dataset = Studium.return_dataset_from_the_file_lecture_information
+  end
+
+  # ========================================================================= #
+  # === handle_CSS_related_aspects                                  (CSS tag)
+  # ========================================================================= #
+  def handle_CSS_related_aspects
+    use_gtk_paradise_project_css_file
+    append_project_css_file
+    add_custom_CSS_rules '
+
+    '
+    do_apply_the_CSS_rules
+  end; alias handle_CSS handle_CSS_related_aspects # === handle_CSS 
+
+  # ========================================================================= #
+  # === do_sync_text_in_the_entry_onto_the_list_store
+  # ========================================================================= #
+  def do_sync_text_in_the_entry_onto_the_list_store
+    # ======================================================================= #
+    # First, obtain the current selection.
+    # ======================================================================= #
+    _ = @combo_box_on_top.active_text
+    if @dataset.has_key? _
+      this_lecture_dataset = @dataset[_]
+      university = this_lecture_dataset[:university].to_s
+      n_ects     = this_lecture_dataset[:ects].to_s
+    else
+      e 'Entry '+_.to_s+' was not found.'
+    end
+    @entry1.set_text('University: '+university)
+    @entry2.set_text('n ECTS: '+n_ects)
+  end
+
+  # ========================================================================= #
+  # === padding?
+  # ========================================================================= #
+  def padding?
+    2
+  end
+
+  # ========================================================================= #
+  # === border_size?
+  # ========================================================================= #
+  def border_size?
+    2
+  end
+
+  # ========================================================================= #
+  # === create_the_skeleton                        (create tag, skeleton tag)
+  # ========================================================================= #
+  def create_the_skeleton
+    _ = @dataset.keys.sort
+    _.map! {|entry|
+      if entry.include?(' ') and (entry.size > 80)
+        entry = entry[0 .. 80]
+      end
+      entry
+    }
+    @entry1 = create_entry
+    @entry2 = create_entry
+    @combo_box_on_top = create_combo_box_text(_)
+    @combo_box_on_top.first_entry_is_active
+    @combo_box_on_top.set_size_request(600, 50)
+    @button_update = create_button('_Update')
+    @button_update.hint = 'Click this button to <b>update '\
+      'the entry</b> below.'
+    @button_update.on_clicked {
+      do_sync_text_in_the_entry_onto_the_list_store
+    }
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    run_super
+  end
+
+  # ========================================================================= #
+  # === Studium::GUI::Gtk::InformationAboutALecture.run
+  # ========================================================================= #
+  def self.run(
+      i = ARGV
+    )
+    require 'gtk_paradise/run'
+    _ = ::Studium::GUI::Gtk::InformationAboutALecture.new(i)
+    r = ::Gtk.run
+    r << _
+    r.automatic_size_then_automatic_title
+    r.show_all
+    r.top_left_then_run
+  end
+
+  # ========================================================================= #
+  # === connect_the_skeleton                                    (connect tag)
+  # ========================================================================= #
+  def connect_the_skeleton
+    abort_on_exception
+
+    outer_vbox = create_vbox
+
+    outer_vbox.minimal(
+      text('<b>'+@dataset.size.to_s+'</b> courses are registered'), 5
+    )
+    outer_vbox.minimal(@combo_box_on_top, 2)
+    outer_vbox.minimal(@button_update, 2)
+    outer_vbox.minimal(@entry1, 2)
+    outer_vbox.minimal(@entry2, 2)
+
+    window = create_window_or_runner(nil, width?, height?, title?)
+    window << outer_vbox
+
+    window.show_all
+    window.top_left
+    window.enable_quick_exit
+    window.set_default_size(width?, height?)
+    do_all_startup_related_actions
+    run_main
+  end
+
+  # ========================================================================= #
+  # === do_all_startup_related_actions
+  # ========================================================================= #
+  def do_all_startup_related_actions
+  end
+
+  # ========================================================================= #
+  # === Studium::GUI::UniversalWidgets::InformationAboutALecture[]
+  # ========================================================================= #
+  def self.[](i = ARGV)
+    new(i)
+  end
+
+end; end; end; end
+
+if __FILE__ == $PROGRAM_NAME
+  Studium::GUI::UniversalWidgets::InformationAboutALecture.new(ARGV)
+end #