studium 0.10.1

data/lib/studium/gui/gtk2/vbox.rb

@@ -0,0 +1,748 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Studium::GUI::Gtk::VBox
+#
+# We need to have a main widget, and then display it, and after a delay,
+# we display the answer.
+#
+# If we are right, we can press the solved button.
+# =========================================================================== #
+# require 'studium/gui/gtk2/vbox.rb'
+# =========================================================================== #
+begin
+  require 'gtk_paradise'
+rescue LoadError
+  puts 'The gem called gtk_paradise is not available. Please '\
+       'consider installing it. (from vbox.rb)'
+end
+begin
+  require 'colours'
+rescue LoadError; end
+require 'studium/constants/constants.rb'
+require 'studium/gui/gtk2/module_methods.rb'
+require 'studium/exams/ask_exam_question/ask_exam_question.rb'
+require 'studium/toplevel_methods/find_corresponding_exam_title.rb'
+require 'studium/toplevel_methods/available_topics.rb'
+begin
+  require 'cyberweb/foundation/umlauts.rb' # This here is optional.
+rescue LoadError; end
+
+require 'gtk_paradise/base_module/base_module.rb'
+
+module Studium
+
+module GUI
+
+class Gtk
+
+class VBox < ::Gtk::VBox # === Studium::GUI::Gtk::VBox
+
+  include Colours
+  include ::Gtk::BaseModule
+
+  # ========================================================================= #
+  # === LIGHTGREY
+  # ========================================================================= #
+  LIGHTGREY  = Gdk::Color.parse('lightgrey')
+
+  # ========================================================================= #
+  # === POWDERBLUE
+  # ========================================================================= #
+  POWDERBLUE = Gdk::Color.parse('powderblue')
+  STEELBLUE  = Gdk::Color.parse('steelblue')
+    HIGHLIGHT_COLOUR = STEELBLUE # Alias.
+
+  # ========================================================================= #
+  # === DATASET
+  # ========================================================================= #
+  DATASET = ::Studium::Statistics
+
+  # ========================================================================= #
+  # === USE_THIS_TOPIC
+  #
+  # This denotes the default topic to be used.
+  #
+  # To query the default topic, do:
+  #   qa --default-topic?
+  # ========================================================================= #
+  _ = Studium.log_dir?+'use_this_exam_topic.yml'
+  if File.exist? _
+    USE_THIS_TOPIC = YAML.load_file(_)
+  else
+    USE_THIS_TOPIC = 'biotech1' # Else use a default topic.
+  end
+
+  # ========================================================================= #
+  # === LEFT_INDENT
+  # ========================================================================= #
+  LEFT_INDENT = 6
+
+  # ========================================================================= #
+  # === BORDER_WIDTH
+  # ========================================================================= #
+  BORDER_WIDTH = 2
+
+  # ========================================================================= #
+  # === SLEEP_FOR_N_SECONDS_BEFORE_REVEALING_THE_ANSWER
+  # ========================================================================= #
+  SLEEP_FOR_N_SECONDS_BEFORE_REVEALING_THE_ANSWER = 4
+
+  # ========================================================================= #
+  # === ENABLE_STATUS_BAR_NOTIFICATION
+  # ========================================================================= #
+  ENABLE_STATUS_BAR_NOTIFICATION = true
+
+  # ========================================================================= #
+  # === APPEND_PERCENTAGE
+  # ========================================================================= #
+  APPEND_PERCENTAGE = false
+
+  # ========================================================================= #
+  # === initialize
+  #
+  # First argument should be Studium::GUI::Gtk::Frame. It will become
+  # the @parent widget then.
+  # ========================================================================= #
+  def initialize(
+      optional_parent = nil,
+      run_already     = true
+    )
+    super()
+    reset # First, reset everything.
+    set_parent(optional_parent) if optional_parent
+    add_text_view
+    add_scrolled_window
+    add_buttons
+    show_all
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === answer?
+  # ========================================================================= #
+  def answer?
+    @answer
+  end
+
+  # ========================================================================= #
+  # === use_default_font
+  # ========================================================================= #
+  def use_default_font
+    ::Studium::GUI::Gtk.do_use_main_font
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    use_default_font
+    @parent = nil
+    @text_buffer = gtk_text_buffer
+    @accel_group = gtk_accel_group
+    fetch_new_question # Initialize the questions here.
+  end
+
+  # ========================================================================= #
+  # === return_status_bar_notification
+  # ========================================================================= #
+  def return_status_bar_notification
+    @status_bar = gtk_statusbar
+    @status_bar.has_resize_grip = true
+    @status_bar_context_id = @status_bar.get_context_id('Exams')
+    return @status_bar
+  end
+
+  # ========================================================================= #
+  # === n_questions_in_total?
+  # ========================================================================= #
+  def n_questions_in_total?
+    @n_questions_in_total
+  end
+
+  # ========================================================================= #
+  # === set_topic
+  # ========================================================================= #
+  def set_topic(i)
+    @topic = i # Simply assign to the @topic variable.
+  end
+
+  # ========================================================================= #
+  # === set_topic_for_button_reveal_the_answer
+  # ========================================================================= #
+  def set_topic_for_button_reveal_the_answer(
+      i = '_Reveal the answer'
+    )
+    @button_reveal_the_answer.label = i
+    @button_reveal_the_answer.use_underline = true
+  end
+
+  # ========================================================================= #
+  # === hide_the_answer
+  # ========================================================================= #
+  def hide_the_answer
+    _ = question?
+    @text_buffer.set_text _
+  end
+
+  # ========================================================================= #
+  # === reveal_or_hide_the_answer
+  # ========================================================================= #
+  def reveal_or_hide_the_answer
+    if @text_buffer.text.size > question?.size+1
+      hide_the_answer
+      set_topic_for_button_reveal_the_answer '_Reveal the answer'
+    else
+      reveal_the_answer
+      set_topic_for_button_reveal_the_answer '_Hide the answer'
+    end
+  end
+
+  # ========================================================================= #
+  # === on_roebe?
+  # ========================================================================= #
+  def on_roebe?
+    ENV['IS_ROEBE'] == '1'
+  end
+
+  # ========================================================================= #
+  # === set_parent
+  # ========================================================================= #
+  def set_parent(i)
+    @parent = i
+  end
+
+  # ========================================================================= #
+  # === parent?
+  # ========================================================================= #
+  def parent?
+    @parent
+  end
+
+  # ========================================================================= #
+  # === reveal_the_answer
+  # ========================================================================= #
+  def reveal_the_answer
+    _ = question?+N+answer?
+    @text_buffer.set_text _
+  end
+
+  # ========================================================================= #
+  # === add_status_icon
+  # ========================================================================= #
+  def add_status_icon
+    title           = Studium::GUI::Gtk.title? #
+    icon_name       = ::Gtk::Stock::DIALOG_INFO
+    tooltip         = Studium::GUI::Gtk.title?
+    pixbuf_location = Studium::GUI::Gtk.favicon?
+    @status_icon = ::Gtk.create_status_icon(
+      title, icon_name, tooltip, pixbuf_location
+    )
+    # ======================================================================= #
+    # Next, we add a small popup-window to the status icon.
+    # ======================================================================= #
+    info = ::Gtk.image_menu_item_info
+    quit = ::Gtk::ImageMenuItem.new(::Gtk::Stock::QUIT) # quit button.
+    quit.signal_connect(:activate){ gtk_main_quit }
+    menu = ::Gtk::Menu.new # Here comes the Gtk Menu.
+    menu.append(::Gtk::SeparatorMenuItem.new)
+    menu.append(info)
+    menu.append(::Gtk::SeparatorMenuItem.new)
+    menu.append(quit)
+    menu.show_all
+    # Show menu on right click.
+    @status_icon.signal_connect(:popup_menu) {|tray, button, time|
+      menu.popup(nil, nil, button, time)
+    }
+  end
+
+  # ========================================================================= #
+  # === accel_group?
+  # ========================================================================= #
+  def accel_group?
+    @accel_group
+  end; alias accel_group accel_group? # === accel_group
+
+  # ========================================================================= #
+  # === add_scrolled_window
+  # ========================================================================= #
+  def add_scrolled_window
+    @scrolled_window = gtk_scrolled_window
+    @scrolled_window.add_with_viewport(@text_view)
+    @scrolled_window.set_policy(::Gtk::POLICY_NEVER, ::Gtk::POLICY_ALWAYS)
+    add(@scrolled_window)
+  end
+
+  # ========================================================================= #
+  # === title?
+  # ========================================================================= #
+  def title?
+    ::Studium::GUI::Gtk.title?
+  end
+
+  # ========================================================================= #
+  # === change_header_for_first_tab
+  #
+  # Use this to change the header for the first tab.
+  # ========================================================================= #
+  def change_header_for_first_tab(new_title = '')
+    label = ::Gtk::Label.new.set_markup(
+      %Q(<span weight="bold">#{new_title}</span>)
+    )
+    if @parent
+      @parent.notebook.set_tab_label(@parent.child, label)
+    end
+  end; alias title_first_tab change_header_for_first_tab # === title_first_tab
+
+  # ========================================================================= #
+  # === question?
+  # ========================================================================= #
+  def question?
+    @question
+  end
+
+  # ========================================================================= #
+  # === set_question
+  # ========================================================================= #
+  def set_question(i)
+    i.delete!(N) if i.include? N
+    @question = i
+  end
+
+  # ========================================================================= #
+  # === add_buttons                                 (buttons tag, button tag)
+  # ========================================================================= #
+  def add_buttons
+    # ======================================================================= #
+    # First, the button that can be pressed to obtain a new question from
+    # the exam pool.
+    # ======================================================================= #
+    @button_new_question = gtk_button('_New Question')
+    @button_new_question.border_width = BORDER_WIDTH
+    @button_new_question.signal_connect(:clicked) {
+      do_click_button_ask_a_new_question
+    }
+    @button_new_question.modify_bg(::Gtk::StateType::PRELIGHT, HIGHLIGHT_COLOUR)
+    @button_new_question.modify_bg(::Gtk::StateType::NORMAL,   POWDERBLUE)
+    # ======================================================================= #
+    # Add a tooltip to this button:
+    # ======================================================================= #
+    hint = 'Press this button to ask a new question (Shortcut: Alt+1)'
+    @button_new_question.tooltip(hint)
+    # ======================================================================= #
+    # alt+1 asks a new question. (alt1)
+    # ======================================================================= #
+    @accel_group.connect( Gdk::Keyval::GDK_1, Gdk::Window::MOD1_MASK, ::Gtk::ACCEL_VISIBLE) {
+      do_click_button_ask_a_new_question
+    }
+    @button_reveal_the_answer = gtk_button
+    set_topic_for_button_reveal_the_answer('_Reveal the answer')
+    @button_reveal_the_answer.border_width = BORDER_WIDTH
+    @button_reveal_the_answer.signal_connect(:clicked) {
+      reveal_or_hide_the_answer
+    }
+    @button_reveal_the_answer.modify_bg(::Gtk::StateType::PRELIGHT, HIGHLIGHT_COLOUR)
+    @button_reveal_the_answer.modify_bg(::Gtk::StateType::NORMAL,   POWDERBLUE)
+    # ======================================================================= #
+    # Add a tooltip to this button:
+    # ======================================================================= #
+    hint = 'Press this button to show the answer to the question (Shortcut: Alt+2)'
+    @button_reveal_the_answer.tooltip(hint)
+    # ======================================================================= #
+    # alt+2 reveals the answer. (alt2)
+    # ======================================================================= #
+    @accel_group.connect( Gdk::Keyval::GDK_2, Gdk::Window::MOD1_MASK, ::Gtk::ACCEL_VISIBLE) {
+      @button_reveal_the_answer.signal_emit :clicked
+    }
+    # ======================================================================= #
+    # === The Solved button and the Random Question button
+    #
+    # This button shares its widget-space with the random-question button.
+    #
+    # button_solved = Gtk::Button.new('solved')
+    # ======================================================================= #
+    @hbox_for_button_solved = gtk_hbox
+    @button_solved = gtk_button('_Solved')
+    @button_random_question = gtk_button('_Random Question')
+    @button_random_question.background_colours(POWDERBLUE, HIGHLIGHT_COLOUR)
+    @button_random_question.signal_connect(:clicked) {
+      do_click_button_ask_a_new_question(:random_topic)
+    }
+    # ======================================================================= #
+    # alt+3 asks a random question. (alt3)
+    # ======================================================================= #
+    @accel_group.connect(Gdk::Keyval::GDK_3, Gdk::Window::MOD1_MASK, ::Gtk::ACCEL_VISIBLE) {
+      @button_random_question.signal_emit :clicked
+    }
+    @hbox_for_button_solved << @button_solved
+    @hbox_for_button_solved << @button_random_question
+    @button_solved.border_width = BORDER_WIDTH
+    @button_solved.signal_connect(:clicked) {
+      mark_question_as_solved
+      update_how_many_questions_are_available
+    }
+    @button_solved.background_colours(POWDERBLUE, HIGHLIGHT_COLOUR)
+    @button_solved.tooltip(
+      'Press this button to set the "solved tag" to this question'
+    )
+    # ======================================================================= #
+    # alt+4 sets to solved the answer. (alt4)
+    # ======================================================================= #
+    @accel_group.connect(Gdk::Keyval::GDK_4, Gdk::Window::MOD1_MASK, ::Gtk::ACCEL_VISIBLE) {
+      @button_solved.signal_emit :clicked
+    }
+    @text_buffer.set_text question?
+    # ======================================================================= #
+    # The spin button comes next. This spin button will contain the
+    # different titles for the respective topic, such as "Basic Chemistry".
+    # Since as of 21.02.2016 we may also display the percentage there.
+    # ======================================================================= #
+    @button_spin = gtk_combo_box_entry(true) # (spin tag)
+    @sanitized_topics = Studium.available_topics?
+    # ======================================================================= #
+    # === Append the Percentage
+    #
+    # Append the percentage next. Unfortunately, this breaks a bit of the
+    # other functionality, so we may have to rethink this - and perhaps
+    # re-enable it at a later time.
+    # ======================================================================= #
+    @sanitized_topics.map! {|entry|
+      percentage_value = Studium::Exams.dataset[entry.to_sym]
+      entry << ' ('+percentage_value.to_s+'%)'
+      entry
+    } if APPEND_PERCENTAGE
+    # ======================================================================= #
+    # === Append the title to the spin-button next
+    # ======================================================================= #
+    @sanitized_topics.each { |val|
+      @button_spin.append_text(val)
+    }
+    # ======================================================================= #
+    # Next, we select the active tab.
+    #
+    # In order to do this, we will refer to the above Array called array,
+    # and try to obtain the position.
+    # ======================================================================= #
+    find_this_topic = USE_THIS_TOPIC # This is the default topic to use.
+    # ======================================================================= #
+    # This topic must be sanitized though:
+    # ======================================================================= #
+    find_this_topic = sanitize_topic(find_this_topic)
+    index = @sanitized_topics.index(find_this_topic)
+    if index.nil?
+      find_this_topic = Exams::SanitizeTopics.sanitize_topic(find_this_topic).first
+      index = @sanitized_topics.index(find_this_topic)
+    end
+    if index
+      @button_spin.active = index
+    else # Else we default to some other entry.
+      @button_spin.active = 40
+    end
+    # ======================================================================= #
+    # Next, the check button.
+    # ======================================================================= #
+    @button_check = ::Gtk::CheckButton.new(
+      'Ask questions from this topic only', false
+    )
+    @button_check.set_active(true)
+    name_tip = 'If this check button is selected, then we will ask only '+
+      'questions pertaining to the topic at hand (the entry to the left '+
+      'side of this check button).'
+    @button_check.tooltip(name_tip)
+    # ======================================================================= #
+    # Next, add the quit-botton.
+    # ======================================================================= #
+    @button_quit = gtk_button(::Gtk::Stock::QUIT)
+    @button_quit.signal_connect_after(:clicked) { ::Gtk.main_quit }
+    # ======================================================================= #
+    # Next, the VBox will have three buttons.
+    # ======================================================================= #
+    vbox = ::Gtk::VBox.new
+    vbox.pack_start(@button_new_question,      false, true, 0)
+    vbox.pack_start(@button_reveal_the_answer, false, true, 0)
+    # ======================================================================= #
+    # === Add the @button_solved hbox
+    # ======================================================================= #
+    vbox.pack_start(@hbox_for_button_solved,            false, true, 0)
+    # ======================================================================= #
+    # And the quit-button will come next.
+    # ======================================================================= #
+    hbox_for_four_buttons = ::Gtk::HBox.new
+    hbox_for_four_buttons.add(vbox)
+    hbox_for_four_buttons.pack_start(@button_quit, false, false, 0)
+    pack_start(hbox_for_four_buttons,                      false, true, 0)
+    # ======================================================================= #
+    # The next box contains the spin-button to the left, and the
+    # check-button to the right.
+    # ======================================================================= #
+    hbox = gtk_hbox
+    hbox.pack_start(@button_spin,  true,  true, 0)
+    hbox.pack_start(@button_check, false, true, 0)
+    pack_start(hbox,               false, true, 0)
+    @entry_search_for_proper_topic = ::Gtk.entry ''
+    @entry_search_for_proper_topic.signal_connect(:button_press_event) { |widget, event|
+      @entry_search_for_proper_topic.set_focus(true)
+      @entry_search_for_proper_topic.select_region(0, -1)
+    }
+    add_entry_search_for_proper_topic_and_button_on_the_right_side
+  end
+
+  # ========================================================================= #
+  # === topic?
+  # ========================================================================= #
+  def topic?
+    @topic
+  end
+
+  # ========================================================================= #
+  # === change_header_for_second_tab
+  # ========================================================================= #
+  def change_header_for_second_tab
+    if on_roebe? # Feedback some debug information to us in this case.
+      e 'Debug information:'
+      e '  '+('n questions in total: ').ljust(26)+sfancy(@n_questions_in_total)
+      e '  '+('n questions are answered: ').ljust(26)+sfancy(@n_questions_answered)
+    end if false # Disabled as of Mar 2016. Unsure if we still need it so it could be removed.
+    if parent? # The following method will be called on the Frame widget.
+      parent?.set_n_exam_questions(
+        @n_questions_in_total,
+        @n_questions_answered
+      )
+    end
+  end; alias update_how_many_questions_are_available change_header_for_second_tab # === update_how_many_questions_are_available
+
+  # ========================================================================= #
+  # === button_set_proper_topic?
+  # ========================================================================= #
+  def button_set_proper_topic?
+    @button_set_proper_topic
+  end
+
+  # ========================================================================= #
+  # === show_the_question
+  # ========================================================================= #
+  def show_the_question
+    @text_buffer.set_text question?
+  end
+
+  # ========================================================================= #
+  # === add_text_view
+  #
+  # Add the main TextView widget that will hold our TextBuffer buffer.
+  # ========================================================================= #
+  def add_text_view
+    @text_view = ::Gtk::TextView.new(@text_buffer)
+    @text_view.set_editable(true)
+    @text_view.left_margin  = 2
+    @text_view.right_margin = 2
+    @text_view.indent = LEFT_INDENT
+  end
+
+  # ========================================================================= #
+  # === obtain_currently_selected_topic
+  #
+  # We obtain the topic in short form.
+  # ========================================================================= #
+  def obtain_currently_selected_topic
+    result = @button_spin.active_text.to_s.downcase.delete('_')
+    result
+  end
+
+  # ========================================================================= #
+  # === add_entry_search_for_proper_topic_and_button_on_the_right_side
+  # ========================================================================= #
+  def add_entry_search_for_proper_topic_and_button_on_the_right_side
+    hbox = gtk_hbox
+    hbox.pack_start(@entry_search_for_proper_topic, true, true, 0)
+    @entry_search_for_proper_topic.signal_connect(:key_press_event) { |w, event|
+      if ::Gtk.enter_key?(event)
+        @button_set_proper_topic.signal_emit(:clicked)
+      end
+    }
+    # ======================================================================= #
+    # Next the button on the right hand side. The purpose of this button
+    # is to set the proper topic.
+    # ======================================================================= #
+    @button_set_proper_topic = gtk_button('Set proper topic')
+    @button_set_proper_topic.signal_connect(:clicked) {
+      do_set_the_proper_topic
+      # ===================================================================== #
+      # Also trigger the new-question button next.
+      # ===================================================================== #
+      @button_new_question.signal_emit(:clicked)
+    }
+    @button_set_proper_topic.tooltip('Press this button to set a new topic')
+    hbox.pack_start(@button_set_proper_topic, false, true,0)
+    pack_start(hbox, false, true, 0)
+  end
+
+  # ========================================================================= #
+  # === do_set_the_proper_topic
+  #
+  # Here we will pick the value from the left-field and use that
+  # to search.
+  # ========================================================================= #
+  def do_set_the_proper_topic(
+      text = @entry_search_for_proper_topic.text
+    )
+    text = text.to_s.downcase
+    text  = Studium.expand(text)
+    index = @sanitized_topics.index(text)
+    if index # Must have found a specific result.
+      @button_spin.active = index
+    end
+  end
+
+  # ========================================================================= #
+  # === mark_question_as_solved
+  # ========================================================================= #
+  def mark_question_as_solved
+    e 'Setting the question `'+question?.chomp.to_s+'` to '+
+      'solved (The encoding was: '+
+      simp(question?.chomp.to_s.encoding.to_s)+').'
+    # ======================================================================= #
+    # Tap into class Solved next.
+    # ======================================================================= #
+    Exams::Solved[] # (solved tag)
+  end
+
+  # ========================================================================= #
+  # === set_answer
+  # ========================================================================= #
+  def set_answer(i)
+    @answer = i
+  end
+
+  # ========================================================================= #
+  # === check_status_of_check_button
+  #
+  # This will either return the currently selected topic, or it will
+  # use the Symbol :random_topic, so that we can fetch a random topic.
+  # ========================================================================= #
+  def check_status_of_check_button
+    if @button_check.active?
+      obtain_currently_selected_topic 
+    else # else we fetch a random topic.
+      :random_topic
+    end
+  end
+
+  # ========================================================================= #
+  # === sanitize_topic
+  # ========================================================================= #
+  def sanitize_topic(i)
+    return ::Studium.find_corresponding_exam_title(i)
+  end
+
+  # ========================================================================= #
+  # === do_click_button_ask_a_new_question
+  #
+  # This method collects what we will do when we ask a new question.
+  #
+  # This is the prominent button called "New Question".
+  # ========================================================================= #
+  def do_click_button_ask_a_new_question(i = check_status_of_check_button)
+    fetch_new_question(i)
+    change_header_for_first_tab(topic?)
+    change_header_for_second_tab
+    set_topic_for_button_reveal_the_answer '_Reveal the answer'
+    # ======================================================================= #
+    # Next, we check if the parent widget has selected the check
+    # button to be true. If this is the case, then we will reveal
+    # the answer after a delay of 6 seconds.
+    # ======================================================================= #
+    if parent?.check_button_reveal_answer_after_a_delay?.active? # Means checkbutton is active.
+      Thread.new {
+        sleep SLEEP_FOR_N_SECONDS_BEFORE_REVEALING_THE_ANSWER
+        reveal_the_answer
+      }
+    end
+    if ENABLE_STATUS_BAR_NOTIFICATION
+      @status_bar.push(@status_bar_context_id, 'Thema: '+topic?)
+    end 
+  end; alias click_main_button do_click_button_ask_a_new_question # === click_main_button
+
+  # ========================================================================= #
+  # === obtain_random_topic
+  # ========================================================================= #
+  def obtain_random_topic
+    Studium::Exams.random_topic
+  end
+
+  # ========================================================================= #
+  # === fetch_new_question
+  #
+  # Use this method to fetch a question.
+  #
+  # Either we fetch a random topic, which is the default.
+  #
+  # Or we fetch the entry that is given to us via the spinbutton entry.
+  # ========================================================================= #
+  def fetch_new_question(i = :random_topic)
+    case i
+    when :random_topic
+      i = ::Studium.available_topics_as_short_names.sample
+    end
+    i = i.to_s unless i.is_a? String
+    unless i.encoding.to_s == USE_THIS_ENCODING
+      i = i.force_encoding(Studium.encoding?)
+    end
+    @n_questions_in_total = DATASET[i.to_sym][:n_total_questions]
+    @n_questions_answered = DATASET[i.to_sym][:n_questions_answered]
+    # ======================================================================= #
+    # Next, we need to determine the question, the answer, and the
+    # topic at hand. The topic is easy so we start with it.
+    # ======================================================================= #
+    topic = ::Studium.beautiful_topic(i)
+    set_topic(topic)
+    # ======================================================================= #
+    # Now, we must determine the question and the answer.
+    # ======================================================================= #
+    dataset = File.readlines(DIRECTORY_EXAM_TOPICS+File.basename(i))
+    dataset = ::Studium.filter_away_invalid_questions(dataset)
+    dataset.reject! {|entry| entry.end_with?('[]'+N) }
+    line = dataset.sample
+    question_answer = Exams.question_answer(line)
+    set_question(question_answer.question?)
+    set_answer(question_answer.answer?)
+    show_the_question # The question will be shown in a GTK widget here.
+  end
+
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run
+    # ======================================================================= #
+    # Whether to enable status-bar notifications or whether we don't.
+    # ======================================================================= #
+    if ENABLE_STATUS_BAR_NOTIFICATION
+      pack_start(return_status_bar_notification, false, false, 0)
+    end
+    add_status_icon
+  end
+
+end
+
+# =========================================================================== #
+# === Studium::GUI::Gtk.vbox
+#
+# Easier instantiation method.
+# =========================================================================== #
+def self.vbox
+  ::Studium::GUI::Gtk::VBox.new # What a scope monster this is! :D
+end
+
+end; end; end
+
+if __FILE__ == $PROGRAM_NAME
+  # ========================================================================= #
+  # Standalone-Testing follows next.
+  # ========================================================================= #
+  require 'gtk_paradise/run.rb'
+  r = Gtk.run(1240, 1240, nil, 'yo', 5)
+  r.add(Studium::GUI::Gtk.vbox)
+  r.top_left
+  r.show
+  r.run
+end