Class: Studium::Commandline

Inherits:

Base

• Object
• Base
• Studium::Commandline

Defined in:

lib/studium/commandline/commandline.rb

Overview

Studium::Commandline

Constant Summary

Constants inherited from Base

Base::COMMON_YEAR_DAYS_IN_MONTH, Base::LEFT_PADDING, Base::NAMESPACE, Base::N_CHARACTERS_PER_LINE

Constants included from Colours

Studium::Colours::COLOURS

Class Method Summary

• .[](i = ARGV) ⇒ Object

  # === Studium::Commandline[] ========================================================================= #.

Instance Method Summary

• #add_new_exam_question ⇒ Object

  # === add_new_exam_question ========================================================================= #.

• #check_the_lecture_information_file ⇒ Object

  # === check_the_lecture_information_file ========================================================================= #.

• #copy_lecture_information_file_to_default_location ⇒ Object

  # === copy_lecture_information_file_to_default_location ========================================================================= #.

• #create_an_archive_of_the_exam_questions ⇒ Object

  # === create_an_archive_of_the_exam_questions ========================================================================= #.

• #create_an_executable_on_windows(on_this_file = '/home/x/programming/ruby/src/studium/lib/studium/gui/libui/ask_exam_question.rb', name_of_the_output_exe = 'ask_exam_question.exe') ⇒ Object

  # === create_an_executable_on_windows.

• #curriculum_comparer ⇒ Object

  # === curriculum_comparer ========================================================================= #.

• #do_show_the_average_grade_of_all_passed_exams ⇒ Object

  # === do_show_the_average_grade_of_all_passed_exams ========================================================================= #.

• #do_show_the_inscription_dates_at_the_different_universities ⇒ Object

  # === do_show_the_inscription_dates_at_the_different_universities ========================================================================= #.

• #initialize(i = ARGV, run_already = true) ⇒ Commandline constructor

  # === initialize ========================================================================= #.

• #lectures_without_exam_entry ⇒ Object

  # === lectures_without_exam_entry ========================================================================= #.

• #mark_all_exam_question_answers_as_undone ⇒ Object

  # === mark_all_exam_question_answers_as_undone ========================================================================= #.

• #menu(i = commandline_arguments? ) ⇒ Object

  # === menu (menu tag) ========================================================================= #.

• #note_down_the_start_time_and_how_many_exams_have_been_already_solved ⇒ Object

  # === note_down_the_start_time_and_how_many_exams_have_been_already_solved ========================================================================= #.

• #open_relevant_files ⇒ Object

  # === open_relevant_files ========================================================================= #.

• #open_the_statistics_file ⇒ Object

  # === open_the_statistics_file ========================================================================= #.

• #open_timetable ⇒ Object

  # === open_timetable.

• #open_useful_files_via_the_default_editor ⇒ Object

  # === open_useful_files_via_the_default_editor.

• #parse_commandline_arguments_as_a_full_string ⇒ Object

  # === parse_commandline_arguments_as_a_full_string.

• #permanently_disable_colours ⇒ Object

  # === permanently_disable_colours.

• #permanently_set_this_editor(i = :vim) ⇒ Object

  # === permanently_set_this_editor ========================================================================= #.

• #pristine ⇒ Object

  # === pristine ========================================================================= #.

• #report_how_many_exam_questions_were_already_solved ⇒ Object

  # === report_how_many_exam_questions_were_already_solved ========================================================================= #.

• #report_passed_exams_fitting_to_this_theme(this_theme) ⇒ Object

  # === report_passed_exams_fitting_to_this_theme ========================================================================= #.

• #report_the_difference_to_the_start_time ⇒ Object

  # === report_the_difference_to_the_start_time ========================================================================= #.

• #reset ⇒ Object

  # === reset (reset tag) ========================================================================= #.

• #run ⇒ Object

  # === run (run tag) ========================================================================= #.

• #show_all_exams_at_this_university(this_university) ⇒ Object

  # === show_all_exams_at_this_university.

• #show_available_topics ⇒ Object

  # === show_available_topics.

• #show_backlog_of_exams ⇒ Object

  # === show_backlog_of_exams ========================================================================= #.

• #show_best_month(i = 10) ⇒ Object

  # === show_best_month.

• #show_collage_of_current_exams ⇒ Object

  # === show_collage_of_current_exams.

• #show_curricula(use_this_file = Studium.file_curricula) ⇒ Object

  # === show_curricula ========================================================================= #.

• #show_ects_passed_per_university ⇒ Object

  # === show_ects_passed_per_university ========================================================================= #.

• #show_exam_statistics ⇒ Object

  # === show_exam_statistics.

• #show_help ⇒ Object

  # === show_help (help tag).

• #show_how_many_exam_topics_are_available ⇒ Object

  # === show_how_many_exam_topics_are_available ========================================================================= #.

• #show_how_many_exams_were_passed ⇒ Object

  # === show_how_many_exams_were_passed.

• #show_lva_dates_of_this_lecture(this_theme) ⇒ Object

  # === show_lva_dates_of_this_lecture ========================================================================= #.

• #show_max_exam_questions_answered_per_topic(file_max_stats = Studium.file_max_stats) ⇒ Object

  # === show_max_exam_questions_answered_per_topic ========================================================================= #.

• #show_maximum_amount_of_questions_ever_answered ⇒ Object

  # === show_maximum_amount_of_questions_ever_answered ========================================================================= #.

• #show_n_ects_from_this_file(i) ⇒ Object

  # === show_n_ects_from_this_file ========================================================================= #.

• #show_outdated_lva_dates ⇒ Object

  # === show_outdated_lva_dates ========================================================================= #.

• #show_passed_credits_per_curriculum ⇒ Object

  # === show_passed_credits_per_curriculum.

• #show_passed_ects_in_the_individual_bachelor_and_master_curricula ⇒ Object

  # === show_passed_ects_in_the_individual_bachelor_and_master_curricula ========================================================================= #.

• #show_passed_ects_per_year ⇒ Object

  # === show_passed_ects_per_year ========================================================================= #.

• #show_passed_exams ⇒ Object

  # === show_passed_exams ========================================================================= #.

• #show_passed_lectures_in_a_bachelor_curriculum ⇒ Object

  # === show_passed_lectures_in_a_bachelor_curriculum ========================================================================= #.

• #show_passed_lectures_in_a_master_curriculum ⇒ Object

  # === show_passed_lectures_in_a_master_curriculum.

• #show_path_to_the_file_lecture_information ⇒ Object

  # === show_path_to_the_file_lecture_information ========================================================================= #.

• #show_questions_per_year ⇒ Object

  # === show_questions_per_year ========================================================================= #.

• #show_the_available_themes ⇒ Object

  # === show_the_available_themes.

• #show_the_base_dir ⇒ Object

  # === show_the_base_dir ========================================================================= #.

• #show_the_current_studyset ⇒ Object

  # === show_the_current_studyset ========================================================================= #.

• #show_timetable ⇒ Object

  # === show_timetable.

• #show_upcoming_exams_at_the_boku ⇒ Object

  # === show_upcoming_exams_at_the_boku ========================================================================= #.

• #show_upcoming_mandatory_presence_courses ⇒ Object

  # === show_upcoming_mandatory_presence_courses ========================================================================= #.

• #show_where_the_exam_topics_can_be_found ⇒ Object

  # === show_where_the_exam_topics_can_be_found ========================================================================= #.

• #show_yearly_average_grades ⇒ Object

  # === show_yearly_average_grades.

• #start_a_new_exam_day ⇒ Object

  # === start_a_new_exam_day ========================================================================= #.

• #start_gui_component ⇒ Object

  # === start_gui_component.

• #start_the_sinatra_interface ⇒ Object

  # === start_the_sinatra_interface ========================================================================= #.

• #upcoming_important_exams ⇒ Object

  # === upcoming_important_exams.

• #upload_archive_of_the_exam_questions ⇒ Object

  # === upload_archive_of_the_exam_questions ========================================================================= #.

• #upload_pdf ⇒ Object

  # === upload_pdf ========================================================================= #.

• #verbose_open_important_exams ⇒ Object

  # === verbose_open_important_exams ========================================================================= #.

• #verbose_set_this_dir_to_exam_topics(match) ⇒ Object

  # === verbose_set_this_dir_to_exam_topics ========================================================================= #.

• #verbose_set_this_new_log_dir(match) ⇒ Object

  # === verbose_set_this_new_log_dir ========================================================================= #.

• #verbose_update_max_ever ⇒ Object

  # === verbose_update_max_ever ========================================================================= #.

Methods inherited from Base

#add_proper_year_entry_to_this_line, #already_solved_this_lva_number?, #append_what_into, #available_topics_as_short_name, #average_grade, #bachelor_master_or_diploma, #be_silent, #be_verbose?, #beautiful_url, #change_directory, #cheering_person, #chmod, #cliner, #colour_for_ects_points, #colourize_percentage, #convert_this_array_of_lectures_into_the_full_dataset, #copy, #course_filter, #cpruby, #create_directory, #create_file, #csv_file?, #current_month?, #current_semester?, #dataset?, #datum?, #day_month_year, #debug?, #delete_file, #directory_of_the_exam_topics?, #directory_to_my_exam_topics, #directory_to_the_exam_topics?, #disable_colours, #disable_colours_globally, #do_not_be_verbose, #do_not_use_opn, #do_these_curricula_include_both_a_bachelor_and_a_master_curriculum?, #does_this_line_include_a_german_weekday?, #does_this_line_include_a_html_colour?, #does_this_line_include_an_english_weekday?, #does_this_line_start_with_a_german_weekday?, #e, #ecomment, #editor?, #ee, #egrey, #enable_colours, #enable_colours_globally, #enable_debug, #encoding?, #english_to_german_weekday, #ensure_that_a_base_directory_exists_for_this_file, #ensure_that_the_log_directory_exists, #eparse, #esystem, #etomato, #exit_program, #extract_dd_mm_yyyy, #fetch_this_curriculum, #file_important_exams?, #file_lecture_information?, #file_passed_exams_per_month, #file_read_with_proper_encoding, #filter_away_already_answered_questions, #filter_away_invalid_questions, #filter_for_all_passed_exams, #find_corresponding_exam_topic, #from_curriculum_id_to_university, #german_date_notation, #german_weekday?, #german_weekdays?, #german_weekend_for?, #german_yes_or_no, #has_a_bachelor_and_a_master_curriculum?, #has_a_bachelor_curriculum?, #has_a_master_curriculum?, #has_lva_dates_registered?, #has_this_exam_topic_been_solved?, #has_year_entry?, #hh_mm_ss_dd_mm_yyyy, #horizontal_bar?, #html_log_directory?, #infer_the_namespace, #initialize_the_internal_hash, #internal_hash?, #is_a_master_lecture?, #is_a_registered_curriculum?, #is_a_weekday?, #is_connected_to_the_www?, #is_german_weekday?, #is_on_roebe?, #is_prüfungsimmanent?, #is_this_a_registered_exam_topic?, #is_this_a_valid_html_colour?, #is_this_day_today?, #is_this_lecture_a_practical_course?, #konsole_support?, #last_file?, #lectures_from_indi1, #lectures_from_indi2, #lectures_from_indi3, #lectures_from_indi4, #lectures_from_the_bachelor_genetik_curriculum, #lectures_from_the_individual_vektor_curricula, #left_arrow?, #load_yaml_dataset, #map_input_to_this_curriculum_filename, #move_file, #n_days_difference_from_today_to_this_day, #n_seconds_to_n_days, #namespace?, #no_ext_name, #no_file_exists_at, #number_to_month, #obtain, #obtain_lectures_from_this_curriculum, #open_in_browser, #open_in_editor, #opne, #opnerev, #opnn, #padded_current_month?, #parse_dd_mm_yyyy, #parse_this_line_for_date_entry, #path_to_exam_topic?, #project_yaml_directory?, #rds, #read_dataset_from_a_curriculum_file, #read_in_exam_dataset_from_this_file, #read_this_file_with_default_encoding, #readlines_from_this_input_file, #register_sigint, #remove_empty_strings, #remove_escape_sequences, #remove_internal_comments, #remove_leading_comments, #remove_leading_weekday_names_from, #remove_newlines, #remove_tags_from_this_input, #rename_kde_konsole_tab, #rename_konsole_tab?, #replace_all_html_colours_in_this, #replace_bold_token_with_default_colour, #replace_italic_token_with_default_colour, #replace_italic_token_with_this_colour, #replace_regular_numbers_with_unicode_numbers, #replace_underline_token_with_default_colour, #replace_underline_token_with_this_colour, #require_open_uri, #reset_the_internal_state, #return_all_bachelor_lectures, #return_all_exams_on_this_day, #return_all_numbers_from, #return_all_registered_curricula, #return_all_steop_lectures, #return_current_year, #return_dataset_for_this_topic, #return_dataset_from_this_curriculum_file, #return_dd_mm_yy_and_time_from, #return_directory_for, #return_ects_points_from_these_lectures, #return_either_grey_or_the_custom_colour_for_answers, #return_either_grey_or_the_custom_colour_for_questions, #return_file_for_this_curriculum, #return_german_name_for_this_english_month, #return_german_weekday_of?, #return_hh_mm_ss_from, #return_hour_from_this, #return_lectures_from_bachelor_vektor_curriculum, #return_lectures_with_at_the_least_one_upcoming_exam, #return_local_path_of_this_pwdstud, #return_lva_number_of_this_lecture, #return_month_fitting_to_this_input, #return_n_days_until_monday, #return_n_days_until_sunday, #return_n_exam_questions_in, #return_n_questions_were_answered_for_this_topic, #return_name_of_the_weekday, #return_name_of_this_curriculum, #return_name_of_this_curriculum_based_on_its_id_number, #return_opnn, #return_passed_courses, #return_pwd, #return_random_curriculum, #return_sanitized_dataset_from_the_file_lecture_information, #return_solved_lectures, #return_steop_lectures, #return_the_remote_homepage_url, #return_this_line_has_n_characters_as_html_colour_tags, #return_title_from_this_curriculum_file, #right_arrow?, #rinstall2, #roebe_exam_directory?, #roebe_path_to_file_lecture_information?, #ruby_src_dir_at_home?, #sanitize_this_topic, #sanitize_url, #select_for_prüfungsimmanente_LVs, #select_lectures_with_this_key, #set_be_verbose, #set_this_cd_alias_to, #set_xorg_buffer, #sfancy, #shall_we_make_use_of_unicode_symbols?, #show_todays_date, #silently_open_in_browser, #simp, #sort_these_lecture_names_by_time, #spacer, #studium_log_dir?, #this_month_has_n_days?, #total_ects_points_passed, #translate_dd_mm_yyyy_to_weekday, #try_to_require_html_templates, #try_to_require_the_open_gem, #try_to_require_the_rcfiles, #try_to_require_the_verbose_truth_gem, #turn_this_array_into_the_full_dataset, #unicode_blocks_line, #use_colours?, #use_opn?, #vertical_bar?, #web_liner, #weekday?, #weekdays?, #word_wrap, #write_what_into, #www_connection_is_unavailable, #yaml_dir?, #yellowrev, #yes_or_no

Methods included from RunmodeModule

#commandline?, #runmode?, #set_commandline_mode, #set_runmode, #set_www_mode, #www_mode?

Methods included from CommandlineArgumentsModule

#commandline_arguments?, #commandline_arguments_joined, #commandline_arguments_with_hyphens?, #commandline_arguments_without_leading_hyphens?, #first_argument?, #first_non_hyphen_argument?, #reset_the_commandline_arguments, #set_commandline_arguments, #set_first_argument

Methods included from HtmlColoursModule

#aquamarine, #blanchedalmond, #brown, #cadetblue, #chocolate, #coral, #cornflowerblue, #crimson, #cyan, #darkblue, #darkcyan, #darkgoldenrod, #darkgreen, #darkkhaki, #darkolivegreen, #darkorange, #darkred, #darkseagreen, #darkslateblue, #darkslategray, #darkturquoise, #deepskyblue, #firebrick, #forestgreen, #gold, #goldenrod, #green, #grey, #indianred, #khaki, #lavender, #lawngreen, #lightblue, #lightcoral, #lightgreen, #lightred, #lightseagreen, #lightskyblue, #lightslategray, #lightslategrey, #lime, #limegreen, #mediumaquamarine, #mediumblue, #mediumpurple, #mediumseagreen, #mediumslateblue, #mediumspringgreen, #mediumturquoise, #mediumvioletred, #mintcream, #moccasin, #oldlace, #olive, #olivedrab, #orange, #orangered, #orchid, #palegoldenrod, #palegreen, #paleturquoise, #palevioletred, #peru, #plum, #powderblue, #red, #rosybrown, #royalblue, #saddlebrown, #salmon, #sandybrown, #seagreen, #sienna, #silver, #skyblue, #slateblue, #slategray, #springgreen, #steelblue, #tan, #teal, #thistle, #tomato, #turquoise, #violet, #whitesmoke, #yellow, #yellowgreen

Methods included from Colours

#bold_blue, #bold_red, #bold_yellow, cadetblue, #cadetblue, #chartreuse, #coral, coral, #cornflowerblue, cornflowerblue, crimson, #cyan, cyan, darkgoldenrod, #darkgoldenrod, #darkgray, darkgreen, darkolivegreen, darkseagreen, #darkslateblue, darkslateblue, #darkslategray, darkslategray, #darkturquoise, darkturquoise, #deepskyblue, deepskyblue, default_colour, #dimgray, disable_colours, #dodgerblue, e, #efancy, enable_colours, #erev, #ewarn, #forestgreen, forestgreen, gold, #goldenrod, goldenrod, #grey, grey, indianred, #indianred, khaki, #khaki, lawngreen, #lawngreen, lightblue, lightgreen, lightsalmon, #lightseagreen, lightseagreen, lightskyblue, #lightskyblue, #lightslategray, lightslategray, #lightsteelblue, lime, #lime, limegreen, #limegreen, #mediumaquamarine, mediumaquamarine, #mediumorchid, #mediumpurple, mediumpurple, #mediumseagreen, mediumseagreen, #mediumslateblue, mediumslateblue, #mediumspringgreen, mediumspringgreen, #mediumturquoise, mediumturquoise, #oldlace, olive, #olive, olivedrab, #olivedrab, orange, orangered, #orchid, orchid, palegreen, #palegreen, paleturquoise, #paleturquoise, palevioletred, #papayawhip, peru, #peru, plum, #plum, #powderblue, powderblue, rev, #rev?, royalblue, saddlebrown, #saddlebrown, #sandybrown, sandybrown, sdir, #sdir, seagreen, #seagreen, sfancy, #sfancy, sfile, #sfile, #simp, simp, #skyblue, skyblue, slateblue, #slategray, slategray, springgreen, #springgreen, #steelblue, steelblue, #swarn, swarn, #tan, tan, teal, #teal, #tomato, tomato, turquoise, use_colours?, use_this_colour_for_exam_answers, use_this_colour_for_exam_questions, #yellow, yellowgreen, #yellowgreen

Constructor Details

#initialize(i = ARGV, run_already = true) ⇒ Commandline

#

initialize

#

# File 'lib/studium/commandline/commandline.rb', line 29

def initialize(
    i           = ARGV,
    run_already = true
  )
  reset
  set_commandline_arguments(i)
  parse_commandline_arguments_as_a_full_string
  run if run_already
end

Class Method Details

.[](i = ARGV) ⇒ Object

#

Studium::Commandline[]

#

# File 'lib/studium/commandline/commandline.rb', line 1831

def self.[](i = ARGV)
  new(i)
end

Instance Method Details

#add_new_exam_question ⇒ Object

#

add_new_exam_question

#

# File 'lib/studium/commandline/commandline.rb', line 1303

def add_new_exam_question
  require 'studium/exams/add_exam_question.rb'
  Studium::Exams::AddExamQuestion.new
end

#check_the_lecture_information_file ⇒ Object

#

check_the_lecture_information_file

#

# File 'lib/studium/commandline/commandline.rb', line 1687

def check_the_lecture_information_file
  require 'studium/check_and_sanitize/check_the_lecture_information_file.rb'
  Studium.check_the_lecture_information_file
end

#copy_lecture_information_file_to_default_location ⇒ Object

#

copy_lecture_information_file_to_default_location

#

# File 'lib/studium/commandline/commandline.rb', line 1248

def copy_lecture_information_file_to_default_location
  Studium.copy_lecture_information_file_to_default_location
end

#create_an_archive_of_the_exam_questions ⇒ Object

#

create_an_archive_of_the_exam_questions

#

# File 'lib/studium/commandline/commandline.rb', line 1272

def create_an_archive_of_the_exam_questions
  Studium.create_an_archive_of_the_exam_questions
end

#create_an_executable_on_windows(on_this_file = '/home/x/programming/ruby/src/studium/lib/studium/gui/libui/ask_exam_question.rb', name_of_the_output_exe = 'ask_exam_question.exe') ⇒ Object

#

create_an_executable_on_windows

To invoke this method do:

studium --create-executable

#

# File 'lib/studium/commandline/commandline.rb', line 1153

def create_an_executable_on_windows(
    on_this_file = 
      '/home/x/programming/ruby/src/studium/lib/studium/gui/libui/ask_exam_question.rb',
    name_of_the_output_exe = 'ask_exam_question.exe'
  )
  _ = 'ocra '+on_this_file+' '\
      '--dll ruby_builtin_dlls/libssp-0.dll '\
      '--dll ruby_builtin_dlls/libgmp-10.dll '\
      '--dll ruby_builtin_dlls/libffi-7.dll '\
      '--gem-all=fiddle '\
      '--output '+name_of_the_output_exe
  esystem _
end

#curriculum_comparer ⇒ Object

#

curriculum_comparer

#

# File 'lib/studium/commandline/commandline.rb', line 1178

def curriculum_comparer
  Studium::CurriculumComparer.new
end

#do_show_the_average_grade_of_all_passed_exams ⇒ Object

#

do_show_the_average_grade_of_all_passed_exams

#

# File 'lib/studium/commandline/commandline.rb', line 1389

def do_show_the_average_grade_of_all_passed_exams
  require 'studium/exams/average_grade/average_grade.rb'
  e 'The average grade of all passed exams is '+
     sfancy(
       Studium.average_grade(:default, round_to: 2 )
     )+'.'
end

#do_show_the_inscription_dates_at_the_different_universities ⇒ Object

#

do_show_the_inscription_dates_at_the_different_universities

#

# File 'lib/studium/commandline/commandline.rb', line 1400

def do_show_the_inscription_dates_at_the_different_universities
  _ = YAML.load_file(Studium.project_yaml_dir?+'inscription_dates_of_universities.yml')
  e
  _.each_pair {|key, value|
    if value.is_a? Array
      value = value.first
    end
    university = key.ljust(40)
    e "  "\
      "#{royalblue(university)} "\
      "#{steelblue(value)}"
  }
  e
end

#lectures_without_exam_entry ⇒ Object

#

lectures_without_exam_entry

#

# File 'lib/studium/commandline/commandline.rb', line 1232

def lectures_without_exam_entry
  require 'studium/exams/lectures_without_exam_entry.rb'
  ::Studium::Exams::LecturesWithoutExamEntry.new
end

#mark_all_exam_question_answers_as_undone ⇒ Object

#

mark_all_exam_question_answers_as_undone

#

# File 'lib/studium/commandline/commandline.rb', line 1820

def mark_all_exam_question_answers_as_undone
  require 'studium/exams/unsolve_all_questions_from_this_topic.rb'
  opne 'Now marking all exam-question-answers as undone.'
  available_topics?.each {|this_topic|
    Studium.unsolve_all_questions_from_this_topic(this_topic)
  }
end

#menu(i = commandline_arguments? ) ⇒ Object

#

menu (menu tag)

#

# File 'lib/studium/commandline/commandline.rb', line 68

def menu(
    i = commandline_arguments?
  )
  if i.is_a? Array
    i.each {|entry| menu(entry) }
  else
    case i # case tag
    # ===================================================================== #
    # === studium --mega-pdf
    #
    # This entry point will create one huge .pdf file, consisting of
    # ALL exam topics.
    # ===================================================================== #
    when /^-?-?mega(-|_| )?pdf$/i,
         /^-?-?monster(-|_| )?pdf$/i,
         /^-?-?monster(-|_| )$/i,
         /^-?-?fat(-|_| )?pdf$/i,
         /^-?-?big(-|_| )?pdf$/i
      ::Studium.create_pdf_file_for_this_exam_topic(:all_topics)
    # ===================================================================== #
    # === studium --jruby1
    #
    # Invocation example:
    #
    #   jruby studium --jruby1
    #   jruby studium --jruby
    #
    # ===================================================================== #
    when /^-?-?jruby1?$/
      require 'studium/gui/jruby/exam_trainer/exam_trainer.rb'
      Studium::GUI::Jruby::ExamTrainer.new(ARGV)
    # ===================================================================== #
    # === studium --max-ever
    # ===================================================================== #
    when /^-?-?max(-|_| )?ever\??$/,
         /^-?-?max(-|_| )?answers\??$/,
         /^-?-?max(-|_| )?stats\??$/,
         /^-?-?max(-|_| )?statistics\??$/,
         /^-?-?max(-|_| )?questions(-|_| )?answered\??$/, # studium --max-questions-answered
         /^-?-?daily$/i,
         /^-?-?daily(-|_| )?changes\??$/
      show_maximum_amount_of_questions_ever_answered
      exit
    # ===================================================================== #
    # === studium --all-undone
    #
    # This entry point will mark all exam question as "undone", aka
    # reset the whole exam-question dataset. Only invoke this if
    # you really need this.
    # ===================================================================== #
    when /-?-?all(_|-)?undone$/i
      mark_all_exam_question_answers_as_undone
      exit
    # ===================================================================== #
    # === studium --start-a-new-exam-day
    #
    # This entry point can be used to "reset" the file that keeps track
    # of which exams have been answered today.
    # ===================================================================== #
    when /-?-?start(_|-)?a(_|-)?new(_|-)?exam(_|-)?day$/i,
         /-?-?clear(_|-)?last(_|-)?questions$/i,
         /^-?-?clear(_|-)?old(_|-)?file$/i,
         /^-?-?clear(_|-)?file$/i,
         /^-?-?new(_|-)?day$/i
      start_a_new_exam_day
      exit
    # ===================================================================== #
    # === studium --ects-per-university
    # ===================================================================== #
    when /^-?-?ects(-|_| )?per(-|_| )?university$/i,
         /^-?-?overviews(-|_| )?at(-|_| )?universities$/i,
         /^-?-?per(-|_| )?university$/i,
         /^-?-?per(-|_| )?uni$/i,
         /^-?-?universities$/i, # === studium --universities
         /^-?-?show(_|-)?ects(_|-)?passed(_|-)?per(_|-)?university$/i
      show_ects_passed_per_university
      exit
    # ===================================================================== #
    # === studium --average-grade
    # ===================================================================== #
    when /^-?-?average(-|_| )?grade$/i
      do_show_the_average_grade_of_all_passed_exams
    # ===================================================================== #
    # === studium --update-max-ever
    #
    # This entry point can be used to update various things, but most
    # importantly, updating the "max-ever query".
    # ===================================================================== #
    when /^-?-?update(-|_| )?max(-|_| )?ever$/i,
         /^-?-?update$/i,
         /^-?-?update(-|_| )?statistics$/i,
         /^-?-?record$/i,
         /^-?-?save$/i,
         /^-?-?update(-|_| )?examstats$/i         # === studium --update-examstats
      verbose_update_max_ever
      exit
    # ===================================================================== #
    # === studium --max-per-topic?
    #
    # This entry point will show how many questions were answered
    # per given topic in a "maximum" manner, e. g. how many
    # questions were answered ever, overall.
    # ===================================================================== #
    when /^-?-?max(_|-)?per(_|-)?topics?\??$/i,
         /^-?-?max(_|-)?exams(_|-)?answered(_|-)?per(_|-)?topic\??$/i,
         /^-?-?max(_|-)?each$/i,
         /^-?-?max(_|-)?ever(_|-)?per(_|-)?topic$/i,
         /^-?-?max(_|-)?per(_|-)?question$/i # === studium --max-per-question
      show_max_exam_questions_answered_per_topic
    # ===================================================================== #
    # === studium --last-questions
    # ===================================================================== #
    when /^-?-?last(_|-)?questions?$/i
      require 'studium/logging/store_last_question_asked_into_file.rb'
      _ = Studium::Log::StoreLastQuestionAskedIntoFile.new {
        :do_not_run_yet
      }.return_path_to_the_file_all_exam_questions_asked
      e File.read(_)
      e
      e "The file that was used was: #{sfile(_)}"
      e
    # ===================================================================== #
    # === studium --examstats
    # ===================================================================== #
    when /-?-?exam(_|-)?stats$/,
         /-?-?exam(_|-)?statistics/,
         /^-?-?statistics\??$/i,
         /^-?-?statistik\??$/i,
         /^-?-?stats$/i
      require 'studium/statistics/show_exam_statistics.rb'
      Studium.show_exam_statistics
      if Studium.is_on_roebe?
        Studium::Exams.report_how_many_exam_questions_were_already_solved
      end
      exit
    # ===================================================================== #
    # === studium --generate-pdf-for=amg1
    # === studium --pdf-for=pharma
    # === studium --make-pdf-for=syszoo
    # ===================================================================== #
    when /^-?-?generate(-|_| )?pdf(-|_| )?for=(.+)$/i, # for $3
         /^-?-?make(-|_| )?pdf(-|_| )?for=(.+)$/i,     # for $3
         /^-?-?pdf(-|_| )?for-?=(.+)$/i,               # for $2
         /^-?-?pdf=(.+)$/i                             # for $1
      this_topic = $1.to_s.dup if $1
      this_topic = $2.to_s.dup if $2
      this_topic = $3.to_s.dup if $3
      ::Studium.create_pdf_file_for_this_exam_topic(this_topic)
    # ===================================================================== #
    # === studium --sinatra
    #
    # This entry point starts the sinatra-part of the Studium project.
    # ===================================================================== #
    when /^-?-?sinatra$/
      start_the_sinatra_interface
      exit
    # ===================================================================== #
    # === Show all courses that belong to a particular curriculum ID
    #
    # This entry point allows us to show all courses that belong to
    # a specific curriculum ID.
    #
    # Usage examples:
    #
    #   studium --all-courses-that-belong-to=255
    #   studium --all-courses-that-belong-to=033255
    #
    # ===================================================================== #
    when /^-?-?all(-|_| )?courses(-|_| )?that(-|_| )?belong(-|_| )?to=(.+)$/i
      curriculum_id = $5.to_s.dup
      require 'studium/curricula/show_lectures_of_this_curriculum_id/show_lectures_of_this_curriculum_id.rb'
      Studium::ShowLecturesOfThisCurriculumId.new(curriculum_id)
    # ===================================================================== #
    # === studium --show-mixed-courses
    #
    # This entry point allows the user to see only courses that are
    # part of a Bachelor as well as a Master curriculum.
    #
    # Usage example:
    #
    #   studium --show-mixed-courses
    #
    # ===================================================================== #
    when /^-?-?show(_|-)?mixed(_|-)?courses$/i
      require 'studium/utility_scripts/show_mixed_bachelor_master_courses/show_mixed_bachelor_master_courses.rb'
      Studium::ShowMixedBachelorMasterCourses.new
    # ===================================================================== #
    # === studium --available-themes
    #
    # This entry point can be used by the user to show which themes
    # are available (aka registered). For instance, it answers the
    # question such as "which courses contain the theme genetics?".
    #
    # Usage example:
    #
    #   studium --available-themes
    #
    # ===================================================================== #
    when /^-?-?available(_|-)?themes$/i,
         /^-?-?available(_|-)?topics$/i
      show_the_available_themes
    # ===================================================================== #
    # === studium --generate-spreadsheet-for=indi3
    #
    # Another example:
    #
    #   studium --xls-for=indi3
    #   xls3
    #
    # ===================================================================== #
    when /^-?-?generate(_|-)?spreadsheet(_|-)?for=(.+)$/i, # === $3
         /^-?-?xls(_|-)?for=(.+)$/i                        # === $2
      require 'studium/utility_scripts/generate_spreadsheet/generate_spreadsheet.rb'
      _ = $2.to_s.dup
      _ = $3.to_s.dup if $3
      Studium::GenerateSpreadsheet.new(_)
    # ===================================================================== #
    # === studium --passed-exams?
    # ===================================================================== #
    when /^-?-?passed(-|_| )?exams\??$/i,
         /^-?-?all(-|_| )?passed(-|_| )?exams\??$/i,
         /^-?-?return(-|_| )?passed(-|_| )?exams\??$/i,
         /^-?-?total(-|_| )?ECTS\??$/i
      show_passed_exams
    # ===================================================================== #
    # === studium --current-studyset?
    # ===================================================================== #
    when /^-?-?current(-|_| )?studyset\??$/i
      show_the_current_studyset
    # ===================================================================== #
    # === studium --create-database
    #
    # Create a new SQL database.
    # ===================================================================== #
    when /^-?-?create(_|-)?database$/i,
         /^-?-?database$/i,
         /^-?-?sql$/i
      Dir.chdir(Studium.log_directory?) if File.directory?(Studium.log_directory?)
      require 'studium/utility_scripts/create_database/create_database.rb'
      Studium::CreateDatabase.new
      # =================================================================== #
      # And then read it in:
      # =================================================================== #
      if File.exist? 'INSERT_INTO_STATEMENTS.sql'
        File.delete('exam_questions.db') if File.exist? 'exam_questions.db'
        esystem 'sqlite3 exam_questions.db < INSERT_INTO_STATEMENTS.sql'
      else
        e 'No file exists called '+sfile(INSERT_INTO_STATEMENTS.sql)+'.'
      end
    # ===================================================================== #
    # === studium --log-dir?
    # ===================================================================== #
    when /(_|-)?(_|-)?log(_|-)?dir\??/i
      e
      e "  #{sfile(Studium.log_directory?)}"
      e
    # ===================================================================== #
    # === studium --libui
    # ===================================================================== #
    when /-?-?libui$/i
      require 'studium/gui/libui/ask_exam_question/ask_exam_question.rb'
      Studium::GUI::Libui::AskExamQuestion.new
      exit
    # ===================================================================== #
    # === studium --gtk3
    # ===================================================================== #
    when /-?-?gtk3?$/i,
         /-?-?gui$/i
      require 'studium/gui/gtk3/exam_question_widget/exam_question_widget.rb'
      Studium::GUI::Gtk::ExamQuestionWidget.run(ARGV)
      exit
    # ===================================================================== #
    # === studium --create-executable
    # ===================================================================== #
    when /-?-?create(_|-)?executable$/i,
         /-?-?executable$/i
      create_an_executable_on_windows
      exit
    # ===================================================================== #
    # === studium --open-statistics
    #
    # This entry point allows the user to open the statistics file. It
    # is mostly catered to my use case, though - thus of limited use
    # to other users of this gem.
    # ===================================================================== #
    when /^-?-?open(-|_| )?the(-|_| )?statistics$/,
         /^-?-?open(-|_| )?the(-|_| )?statistics(-|_| )?file$/,
         /^-?-?open(-|_| )?statistics$/,
         /^-?-?open(-|_| )?stats$/
      open_the_statistics_file
      exit
    # ===================================================================== #
    # === studium --n-entries-in-the-file-lecture-information
    # === studium --n-lectures
    # ===================================================================== #
    when /^-?-?n(_|-)?entries(_|-)?in(_|-)?the(_|-)?file(_|-)?lecture(_|-)?information\??$/i,
         /^-?-?n(_|-)?entries\??$/i,
         /^-?-?n(_|-)?lectures\??$/i,
         /^-?-?n(_|-)?lectures(_|-)?registered$/i,
         /^-?-?n(_|-)?registered(_|-)?lectures$/i,
         /^-?-?n(_|-)?registered$/i,
         /^-?-?n(_|-)?courses$/i
      Studium.report_n_entries_in_the_file_lecture_information
    # ===================================================================== #
    # === studium --update-max-questions
    #
    # This will also update the max questions ever.
    # ===================================================================== #
    when /^-?-?update(-|_| )?max(-|_| )?questions$/
      require 'studium/statistics/report_how_many_exam_questions_were_answered.rb'
      Studium::Statistics::ReportHowManyExamQuestionsWereAnswered.new
      exit
    # ===================================================================== #
    # === studium --solved-topics?
    # ===================================================================== #
    when /^-?-?solved(_|-)?topics\??$/
      require 'studium/toplevel_methods/toplevel_methods.rb'
      e 'The solved exam-topics are as follows:'
      e
      ::Studium.available_topics_as_short_names.each {|this_topic|
        case ::Studium.return_n_percent_solved_from_this_topic(this_topic)
        when 100.0
          puts 'The topic '+this_topic+' has been solved.'
        end
      }
      e
      exit
    # ===================================================================== #
    # === studium --solved
    # ===================================================================== #
    when /^-?-?solved$/
      require_class_exams_solved.rb
      _ = Studium::Exams::Solved.new(ARGV, :dont_run_yet)
      _.set_commandline
      _.run
    # ===================================================================== #
    # === studium --nsolved
    # ===================================================================== #
    when /^-?-?nsolved$/
      report_how_many_exam_questions_were_already_solved
    # ===================================================================== #
    # === studium "--solved? 300143"
    # === studium "--already_solved_this_id 300143"
    # ===================================================================== #
    when /-?-?solved\?? (\d+)/,
         /-?-?already(_|-)?solved(_|-)?this(_|-)?id (\d+)/
      the_lva_number = $1.to_s.dup
      the_lva_number = $4.to_s.dup if $4
      yes_or_no = Studium.yes_or_no(
        Studium.already_solved_this_lva_number?(the_lva_number).to_s
      )
      e 'Did we solve this lecture (ID: '+simp(the_lva_number)+') yet? '+
        sfancy(yes_or_no)
    # ===================================================================== #
    # === studium --mandatory
    # ===================================================================== #
    when /^-?-?mandatory$/i
      show_upcoming_mandatory_presence_courses
      exit
    # ===================================================================== #
    # === studium --create_a_clean_lecture_information_file
    # ===================================================================== #
    when /^-?-?create(-|_| )?a(-|_| )?clean(-|_| )?lecture(-|_| )?information(-|_| )?file$/i
      Studium.create_a_clean_lecture_information_file
      exit
    # ===================================================================== #
    # === studium --upload-exam-questions
    # ===================================================================== #
    when /-?-?upload(_|-)?exam(_|-)?questions/,
         /-?-?upload(_|-)?exams/,
         /-?-?uexams/
      Studium.upload_exam_questions { :be_verbose }
    # ===================================================================== #
    # === studium --compare
    # ===================================================================== #
    when /^-?-?compare$/
      curriculum_comparer
    # ===================================================================== #
    # === studium --download-exam-dataset
    # ===================================================================== #
    when /^-?-?download(_|-)?exam(_|-)?dataset$/i,
         /^-?-?download(_|-)?dataset$/i
      ::Studium.download_exam_dataset
    # ===================================================================== #
    # === studium --use-this-colour-for-exam-answers=slateblue
    # ===================================================================== #
    when /^-?-?use(-|_| )?this(-|_| )?colour(-|_| )?for(-|_| )?exam(-|_| )?answers=(.+)/i,
         /^-?-?use(-|_| )?this(-|_| )?colour(-|_| )?for(-|_| )?answers=(.+)/i,
         /^-?-?colour(-|_| )?for(-|_| )?answers=(.+)/i
      _ = $3
      _ = $5 if $5
      _ = $6 if $6
      ::Studium::Colours.use_this_colour_for_exam_answers(_.to_s.dup)
    # ===================================================================== #
    # === studium --lectures-on-this-day=05.05.2018
    # ===================================================================== #
    when /^-?-?lectures(_|-)?on(_|-)?this(_|-)?day(_|-)?=(.+)$/,
         /^(\d{2}.\d{2}.\d{4})$/
      require 'studium/curricula/determine_curricula/determine_curricula.rb'
      first_match_to_the_regex = $1.to_s.dup
      i = $5.to_s.dup
      if first_match_to_the_regex =~ /^\d+/
        i = first_match_to_the_regex
      end
      Studium.show_lectures_on_this_day(i)
    # ===================================================================== #
    # === set_directory_to_the_exam_topics
    #
    # Usage example:
    #
    #   studium --set-directory-to-the-exam-topics=/Depot/j/EXAM_TOPICS/
    #
    # ===================================================================== #
    when /set(_|-)?directory(_|-)?to(_|-)?the(_|-)?exam(_|-)?topics=(.+)/
      match = $6.to_s.dup
      verbose_set_this_dir_to_exam_topics(match)
    # ===================================================================== #
    # === set_dir
    # ===================================================================== #
    when /set(_|-)?dir=(.+)/
      match = $2.to_s.dup
      verbose_set_this_dir_to_exam_topics(match)
    # ===================================================================== #
    # === studium --lectures_without_exam_entry
    # ===================================================================== #
    when /^-?-?lectures(_|-)?without(_|-)?exam(_|-)?entry$/i
      lectures_without_exam_entry
    # ===================================================================== #
    # === studium --use-this-colour-for-exam-questions=slateblue
    # ===================================================================== #
    when /^-?-?use(-|_| )?this(-|_| )?colour(-|_| )?for(-|_| )?exam(-|_| )?questions=(.+)/i,
         /^-?-?use(-|_| )?this(-|_| )?colour(-|_| )?for(-|_| )?questions=(.+)/i,
         /^-?-?colour(-|_| )?for(-|_| )?questions=(.+)/i
      _ = $3
      _ = $5 if $5
      _ = $6 if $6
      ::Studium::Colours.use_this_colour_for_exam_questions(_.to_s.dup)
    # ===================================================================== #
    # === studium --merge
    # ===================================================================== #
    when /^-?-?merge$/i
      copy_lecture_information_file_to_default_location
    # ===================================================================== #
    # === studium --open-upcoming-exams
    # ===================================================================== #
    when /^-?-?open(-|_| )?upcoming(-|_| )?exams$/i,
         /^-?-?open(-|_| )?important$/i
      open_relevant_files
    # ===================================================================== #
    # === studium --open-important-exams
    # ===================================================================== #
    when /^-?-?open(-|_| )?important(-|_| )?exams$/i,
         /^-?-?important(-|_| )?exams$/i,
         /^-?-?important$/i,
         /^-?-?priorities$/i,
         /^-?-?priority$/i,
         /^-?-?open(-|_| )?important(-|_| )?lectures$/i # === studium --open-important-lectures
      verbose_open_important_exams
    # ===================================================================== #
    # === studium --create-an-archive-of-the-exam-questions
    # ===================================================================== #
    when /^-?-?create(-|_| )?an(-|_| )?archive(-|_| )?of(-|_| )?the(-|_| )?exam(-|_| )?questions$/i,
         /^-?-?create(-|_| )?exam(-|_| )?topics(-|_| )?archive$/i
      create_an_archive_of_the_exam_questions
    # ===================================================================== #
    # === studium --upcoming-important-exams
    # ===================================================================== #
    when /-?-?upcoming(-|_| )?important(-|_| )?exams/,
         /-?-?upcoming(-|_| )?exams/
      upcoming_important_exams
    # ===================================================================== #
    # === studium --end
    # ===================================================================== #
    when /^-?-?end$/i,
         /^-?-?end(-|_| )?difference$/i
      report_the_difference_to_the_start_time
    # ===================================================================== #
    # === studium --upload_pdf
    # ===================================================================== #
    when /^-?-?upload(-|_| )?pdf$/i
      upload_pdf
    # ===================================================================== #
    # === studium --vim
    # ===================================================================== #
    when /^-?-?vim$/i
      permanently_set_this_editor(:vim)
    # ===================================================================== #
    # === studium --help
    #
    # Displaying help to the user must be a fast operation, so it is
    # stored in the file here.
    # ===================================================================== #
    when /help$/i,
         /-h$/i
      show_help
    # ===================================================================== #
    # === studium --show-lva-dates-of-this-lecture="Primatologie"
    # ===================================================================== #
    when /^-?-?show(_|-)?lva(_|-)?dates(_|-)?of(_|-)?this(_|-)?lecture=(.+)/i
      this_theme = $6.to_s.dup.delete('"')
      show_lva_dates_of_this_lecture(this_theme)
    # ===================================================================== #
    # === studium --colours?
    # ===================================================================== #
    when /-?-?colours\??/
      e ::Colours.rev+
        'Does the Studium project use colours, right now? '+
        sfancy(Studium.yes_or_no(Studium.use_colours?.to_s))
    # ===================================================================== #
    # === studium --add-a-new-question
    # ===================================================================== #
    when /^-?-?add(-|_| )?a(-|_| )?new(-|_| )?question$/i
      add_new_exam_question
    # ===================================================================== #
    # === studium set-delay=5
    # ===================================================================== #
    when /set(_|-)?delay=(.+)/ # studium set-delay=2.6
      ::Studium.save_this_delay_between_questions_and_answers($2.to_s.dup)
    # ===================================================================== #
    # === studium set_log_dir=/Depot/j/
    # ===================================================================== #
    when /-?-?set(_|-)?log(_|-)?dir=(.+)/
      match = $3.to_s.dup
      verbose_set_this_new_log_dir(match)
    # ===================================================================== #
    # === studium --last-question?
    # ===================================================================== #
    when /^-?-?last(_|-)?question\??$/i
      _ = Studium.file_last_question_asked?
      if File.exist? _
        e File.read(_)
      else
        no_file_exists_at(_)
      end
    # ===================================================================== #
    # === studium --expand-time-range="15.10. - 2.11.2018,"
    # === studium --expander="15.10. - 2.11.2018,"
    # === studium --expander="02.02.2020-02.05.2020"
    # ===================================================================== #
    when /^-?-?expand(-|_| )?time(-|_| )?range=(.+)$/,
         /^-?-?expander=(.+)$/
      _ = $1.to_s.dup
      _ = $3.to_s.dup if $3
      unless Studium.respond_to? :expand_time_range
        require 'studium/utility_scripts/expand_time_range/expand_time_range.rb'
      end
      Studium.expand_time_range(_)
    # ===================================================================== #
    # === studium --collage?
    # ===================================================================== #
    when /-?-?collage\??$/
      show_collage_of_current_exams
      exit
    # ===================================================================== #
    # === studium --master=vektorx
    # ===================================================================== #
    when /^-?-?master(=|-)(.+)$/
      require 'studium/utility_scripts/show_lectures_on_the_commandline/show_lectures_on_the_commandline.rb'
      this_curriculum = "master-#{$2.to_s.dup}"
      Studium::ShowLecturesOnTheCommandline.new(this_curriculum)
    # ===================================================================== #
    # === studium --lectures-from-this-curriculum=geodäsie
    # ===================================================================== #
    when /^-?-?lectures(-|_| )?from(-|_| )?this(-|_| )?curriculum=(.+)$/i
      require 'studium/curricula/show_lectures_of_this_curriculum_id/show_lectures_of_this_curriculum_id.rb'
      Studium::ShowLecturesOfThisCurriculumId.new($4.to_s.dup)
    # ===================================================================== #
    # === studium --pristine
    # ===================================================================== #
    when /^-?-?pristine$/,
         /^-?-?new(_|-)?lecture(_|-)?information$/
      pristine
    # ===================================================================== #
    # === studium --passed-exams=chemistry
    # ===================================================================== #
    when /^-?-?passed(_|-)?exams=(.+)/i,
         /^-?-?report(_|-)?passed(_|-)?exams(_|-)?fitting(_|-)?to(_|-)?this(_|-)?theme=(.+)/i
      this_theme = $2.to_s.dup
      this_theme = $7.to_s.dup if $7
      report_passed_exams_fitting_to_this_theme(this_theme)
    # ===================================================================== #
    # === studium --outdated
    # ===================================================================== #
    when /^-?-?outdated$/
      show_outdated_lva_dates
    # ===================================================================== #
    # === studium --upload-archive-of-the-exam-questions
    # ===================================================================== #
    when /^-?-?upload(-|_| )?archive(-|_| )?of(-|_| )?the(-|_| )?exam(-|_| )?questions$/,
         /^-?-?upload(-|_| )?exam(-|_| )?archive$/,
         /^-?-?upload(-|_| )?exam(-|_| )?topics$/
      upload_archive_of_the_exam_questions
    # ===================================================================== #
    # === studium --encoding=utf
    # === studium --encoding=iso1
    # ===================================================================== #
    when /^-?-?encoding=(.+)$/i
      Studium.use_this_new_encoding($1.to_s.dup)
      exit
    # ===================================================================== #
    # === studium --use-this-curriculum=foo.md
    # ===================================================================== #
    when /^-?-?use(_|-)?this(_|-)?curriculum=(.+)$/i
      require 'studium/utility_scripts/show_lectures_on_the_commandline/show_lectures_on_the_commandline.rb'
      _ = $3.to_s.dup
      if File.exist? _
        object = Studium::ShowLecturesOnTheCommandline.new { :do_not_run_yet }
        dataset = File.readlines(_).reject {|line|
          line.start_with?('#') or line.strip.empty?
        }.map {|entry|
          if entry.include?('#')
            entry = entry[0 .. (entry.index('#')-1)]
          end
          entry.strip.squeeze(' ')
        }
        object.clear_old_dataset
        object.add_to_the_dataset_without_any_further_checks(dataset)
        object.sanitize_the_dataset
        object.uniq_the_dataset
        object.is_not_an_individual_curriculum
        object.do_all_actions_after_the_main_dataset_was_read_in
      else
        e 'No file exists at '+sfile(_)+'.'
      end
    # ===================================================================== #
    # === studium important_exams.yml
    # ===================================================================== #
    when /important(_|-)?exams\.?yml$/
      target = ruby_src_dir_at_home?+'studium/lib/studium/yaml/important_exams.yml'
      e sfile(target)
      open_in_editor(target)
    # ===================================================================== #
    # === studium --version?
    # ===================================================================== #
    when /^-?-?version\??$/i
      require 'studium/version/version.rb'
      e sfancy(
          Studium.return_version_and_last_update
        )
    # ===================================================================== #
    # === studium --open-top
    # ===================================================================== #
    when /^-?-?open(-|_| )?top$/i,
         /^-?-?open(-|_| )?last$/i
      require 'studium/exams/show_backlog_of_exams.rb'
      Studium::ShowBacklogOfExams.open_the_main_file
    # ===================================================================== #
    # === studium --show-english-lectures
    # === studium --show-german-lectures
    # ===================================================================== #
    when /^-?-?show(_|-)?(english)(_|-)?lectures$/,
         /^-?-?show(_|-)?(german)(_|-)?lectures$/
      require 'studium/utility_scripts/show_lectures_fitting_to_this_language.rb'
      seek_lectures_for_this_language = $2.to_s.dup
      ShowLecturesFittingToThisLanguage.new(seek_lectures_for_this_language)
    # ===================================================================== #
    # === studium --files?
    # === studium --show-important-files
    # ===================================================================== #
    when /^-?-?files\??$/i,
         /^-?-?show(_|-)?important(_|-)?files\??$/i
      require 'studium/toplevel_methods/show_important_files.rb'
      ::Studium.show_important_files
    # ===================================================================== #
    # === studium --exam_topics?
    # ===================================================================== #
    when /-?-?exam(_|-)?topics\??/
      show_where_the_exam_topics_can_be_found
    # ===================================================================== #
    # === studium --statistics?
    # ===================================================================== #
    when /^-?-?statistics\??$/i,
         /^-?-?stats\??$/i
      require 'studium/curricula/determine_curricula/determine_curricula.rb'
      Studium.determine_curricula
    # ===================================================================== #
    # === studium --n-topics-available?
    # ===================================================================== #
    when /^-?-?n(_|-)?topics(_|-)?available\??/,
         /^-?-?n-?topics\??/
      show_how_many_exam_topics_are_available
    # ===================================================================== #
    # === studium --topics?
    # ===================================================================== #
    when /^-?-?topics\??$/i
      show_available_topics
    # ===================================================================== #
    # === studium --path-to-file-lecture-information
    # ===================================================================== #
    when /^-?-?path(-|_| )?to(-|_| )?file(-|_| )?lecture(-|_| )?information$/i
      show_path_to_the_file_lecture_information
    # ===================================================================== #
    # === studium --open-timetable
    # ===================================================================== #
    when /-?-?open(-|_| )?timetable$/i
      open_timetable
      exit
    # ===================================================================== #
    # === studium --upcoming_exams_at_the_boku
    # ===================================================================== #
    when /upcoming_?exams_?at_?the_?boku/
      show_upcoming_exams_at_the_boku
    # ===================================================================== #
    # === studium --show_collage_of_current_exams
    # ===================================================================== #
    when /^-?-?show(_|-)?collage(_|-)?of(_|-)?current(_|-)?exams$/i
      show_collage_of_current_exams
    # ===================================================================== #
    # === studium --open
    # ===================================================================== #
    when /^-?-?open$/i
      open_useful_files_via_the_default_editor
      exit
    # ===================================================================== #
    # === studium --base-dir?
    # ===================================================================== #
    when /^-?-?base(_|-)?dir\??/,
         /^-?-?dir\??$/
      show_the_base_dir
    # ===================================================================== #
    # === studium --ects-bachelor-master
    # ===================================================================== #
    when /^-?-?ects(_|-)?bachelor(_|-)?master$/,
         /^-?-?bachelor(_|-)?master$/,
         /^-?-?bm$/ # studium --bm
      show_passed_ects_in_the_individual_bachelor_and_master_curricula
    # ===================================================================== #
    # === studium --check-the-lecture-information-file
    # ===================================================================== #
    when /-?-?check(-|_| )?the(-|_| )?lecture(-|_| )?information(-|_| )?file$/,
         /-?-?check(-|_| )?file(-|_| )?information$/
      check_the_lecture_information_file
    # ===================================================================== #
    # === studium --exams-at-the-meduni
    # ===================================================================== #
    when /(-|_| )?(-|_| )?exams(-|_| )?at(-|_| )?the(-|_| )?(.+)$/
      this_university = $6.to_s.dup.downcase
      show_all_exams_at_this_university(this_university)
    # ===================================================================== #
    # === studium --best-month
    # ===================================================================== #
    when /^-?-?best-month$/,
         /^-?-?best(_|-)?month(_|-)?stats$/,
         /^-?-?show(_|-)?best(_|-)?months?$/,
         /^-?-?best(_|-)?months?$/
      show_best_month
      exit
    # ===================================================================== #
    # === studium --max?
    # ===================================================================== #
    when /-?-?max\??$/,
         /-?-?show(_|-)?how(_|-)?many(_|-)?exams(_|-)?were(_|-)?passed$/,
         /^-?-?top$/i # ← This should always be on top of this file here.
      show_how_many_exams_were_passed
      exit
    # ===================================================================== #
    # === studium --n-ects-from-this-file=ECTS.md
    # ===================================================================== #
    when /^-?-?n(-|_| )?ects(-|_| )?from(-|_| )?this(-|_| )?file=(.+)$/i, # === $5
         /^-?-?ects(-|_| )?from=(.+)$/i # === $2
      _ = $2.to_s.dup if $2
      _ = $5.to_s.dup if $5
      show_n_ects_from_this_file(_)
    # ===================================================================== #
    # === studium --audio-stats
    # ===================================================================== #
    when /^-?-?audio/
      require 'studium/utility_scripts/audio_stats.rb'
      Studium.audio_stats?
    # ===================================================================== #
    # === studium --backlog-of-exams
    # ===================================================================== #
    when /^-?-?backlog(-|_| )?of(-|_| )?exams$/i
      show_backlog_of_exams
    # ===================================================================== #
    # === studium --bachelor_curricula
    # ===================================================================== #
    when /^-?-?bachelor(-|_| )?curricula$/i,
         /^-?-?bachelor$/i
      show_passed_lectures_in_a_bachelor_curriculum
      exit
    # ===================================================================== #
    # === studium --disable-colours
    # ===================================================================== #
    when /^-?-?disable(_|-)?colours$/i,
         /^-?-?permanently(_|-)?disable(_|-)?colours$/i
      permanently_disable_colours
    # ===================================================================== #
    # === studium --passed-ects-per-year
    # ===================================================================== #
    when /^-?-?passed(-|_| )?ects(-|_| )?per(-|_| )?year$/i
      show_passed_ects_per_year
    # ===================================================================== #
    # === studium --inskriptionsfrist
    # ===================================================================== #
    when /^-?-?inskriptionsfrist$/i
      do_show_the_inscription_dates_at_the_different_universities
    # ===================================================================== #
    # === studium --master_curricula
    # ===================================================================== #
    when /^-?-?master(-|_| )?curricula$/i,
         /^-?-?master$/i
      show_passed_lectures_in_a_master_curriculum
      exit
    # ===================================================================== #
    # === studium --timetable
    # ===================================================================== #
    when /^-?-?timetable$/
      show_timetable
      exit
    # ===================================================================== #
    # === studium --set-editor=vim
    # ===================================================================== #
    when /^-?-?set(-|_| )?editor=(.+)$/i
      permanently_set_this_editor($2.to_s.dup)
    # ===================================================================== #
    # === studium --start
    # ===================================================================== #
    when /^-?-?start$/i
      note_down_the_start_time_and_how_many_exams_have_been_already_solved
    # ===================================================================== #
    # === studium --curricula
    # === studium --show-curricula
    # ===================================================================== #
    when /^-?-?curricula$/i,
         /^-?-?show(-|_| )?curricula$/i
      show_curricula
    # ===================================================================== #
    # === studium --bachelor=vektorx
    # ===================================================================== #
    when /^-?-?bachelor(=|-)(.+)$/
      require 'studium/utility_scripts/show_lectures_on_the_commandline/show_lectures_on_the_commandline.rb'
      this_curriculum = "bachelor-#{$2.to_s.dup}"
      Studium::ShowLecturesOnTheCommandline.new(this_curriculum)
    # ===================================================================== #
    # === studium --questions-per-year
    # ===================================================================== #
    when /^-?-?questions(_|-)?per(_|-)?year$/
      show_questions_per_year
    # ===================================================================== #
    # === studium --passed-ects
    # ===================================================================== #
    when /^-?-?passed(_|-)?ects\??$/i,
         /^-?-?overview$/i,
         /^-?-?performance$/i # studium --performance
      show_passed_credits_per_curriculum
    # ===================================================================== #
    # === studium --yearly-average-grades
    # ===================================================================== #
    when /^-?-?yearly(_|-)?average(_|-)?grades$/,
         /^-?-?grades$/i
      show_yearly_average_grades
      exit
    # ===================================================================== #
    # === studium --editor?
    # ===================================================================== #
    when /^-?-?editor\??$/i
      e sfancy(Studium.editor?) 
    # ===================================================================== #
    # === studium --delay?
    # ===================================================================== #
    when /^-?-?delay\?/ # Query the delay in use.
      require 'studium/toplevel_methods/read_delay_between_questions_from_file.rb'
      e rev+
        'The delay is '+lightgreen(
          Studium::Exams.read_delay_from_file.to_s
        )+
        ' seconds between individual question-answer sessions.'
    else # else tag
      # =================================================================== #
      # === Handle Pseudo-Regexes                               (regex tag)
      #
      # Handle pseudo-regexes next. These are strings that start
      # and end with a '/' character.
      # =================================================================== #
      if i.start_with?('/') and i.end_with?('/')
        e "A pseudo-regex was discovered (#{sfancy(i)}). We "\
          "will next query for any"
        e 'exam matching to that regex.'
        e
        use_this_regexp = Regexp.new(i.delete('/'), Regexp::IGNORECASE) # <- is case-insensitive.
        Studium.try_to_report_exams_that_match_to_this_regexp(use_this_regexp) { :also_show_the_grade }
      # =================================================================== #
      # === Handle lecture types
      #
      # This entry point will handle input such as the following:
      #
      #   studium --VO
      #   studium VO+SE
      #
      # =================================================================== #
      elsif ARRAY_LECTURE_TYPES_THAT_ARE_MANDATORY_CONTINUOUS_ASSESSMENT.include?(i.delete('-')) or
            (i.delete('-') == 'VO')
        Studium.report_all_lectures_matching_this_lecture_type(i.delete('-'))
      # =================================================================== #
      # === Handle --flags next
      # =================================================================== #
      elsif i.include?('--')
        e "#{rev}Unrecognized commandline instruction: "+
          steelblue(i)
      end
    end
  end
end

#note_down_the_start_time_and_how_many_exams_have_been_already_solved ⇒ Object

#

note_down_the_start_time_and_how_many_exams_have_been_already_solved

#

# File 'lib/studium/commandline/commandline.rb', line 1776

def note_down_the_start_time_and_how_many_exams_have_been_already_solved
  require 'studium/toplevel_methods/note_down_the_start_time_and_how_many_exams_have_been_already_solved.rb'
  Studium.note_down_the_start_time_and_how_many_exams_have_been_already_solved
end

#open_relevant_files ⇒ Object

#

open_relevant_files

#

# File 'lib/studium/commandline/commandline.rb', line 1255

def open_relevant_files
  Studium::Exams::UpcomingImportantExams.open_relevant_files
end

#open_the_statistics_file ⇒ Object

#

open_the_statistics_file

#

# File 'lib/studium/commandline/commandline.rb', line 1358

def open_the_statistics_file
  e
  cmd = "bluefish #{Studium.file_statistics} &"
  if Studium.is_on_roebe?
    cmd = "bluefish $RUBY_SRC/studium/lib/studium/yaml/statistics.yml &"
  end
  e cmd
  e
  system cmd
end

#open_timetable ⇒ Object

#

open_timetable

To invoke this method, do:

studium --open-timetable

#

# File 'lib/studium/commandline/commandline.rb', line 1629

def open_timetable
  _ = FILE_EXAMS_AT_NON_BOKU_UNIVERSITIES
  Open.in_editor(_) if File.exist? _
end

#open_useful_files_via_the_default_editor ⇒ Object

#

open_useful_files_via_the_default_editor

Invoke this method like so:

studium --open

#

# File 'lib/studium/commandline/commandline.rb', line 1671

def open_useful_files_via_the_default_editor
  require 'studium/exams/exams_per_month/open.rb'
  Studium::ExamsPerMonth.open_main_files_in_the_editor
end

#parse_commandline_arguments_as_a_full_string ⇒ Object

#

parse_commandline_arguments_as_a_full_string

This method will act on the whole ARGV, as a String rather than an Array.

#

# File 'lib/studium/commandline/commandline.rb', line 1428

def parse_commandline_arguments_as_a_full_string
  _ = return_commandline_arguments_as_string
  case _
  # ======================================================================= #
  # === studium lastexams 10
  # ======================================================================= #
  when /-?-?last-?exams (\d+)/
    _ = $1.to_s.dup.to_i
    require 'studium/exams/last_exams/last_exams.rb'
    Studium.show_n_last_exams(_) # Show the last n exams that were passed.
    exit
  end
end

#permanently_disable_colours ⇒ Object

#

permanently_disable_colours

To invoke this method, try:

studium --permanently-disable-colours

#

# File 'lib/studium/commandline/commandline.rb', line 1538

def permanently_disable_colours
  opne 'The colours in the Studium namespace will be '\
       'permanently disabled.'
  into = "#{Studium.yaml_directory?}use_colours.yml"
  if File.exist? into
    opne "Storing into the file #{sfile(into)} next."
    write_what_into(YAML.dump(false), into)
  end
end

#permanently_set_this_editor(i = :vim) ⇒ Object

#

permanently_set_this_editor

#

# File 'lib/studium/commandline/commandline.rb', line 1279

def permanently_set_this_editor(i = :vim)
  Studium.permanently_set_this_editor(i)
end

#pristine ⇒ Object

#

pristine

#

# File 'lib/studium/commandline/commandline.rb', line 1185

def pristine
  Studium.pristine
end

#report_how_many_exam_questions_were_already_solved ⇒ Object

#

report_how_many_exam_questions_were_already_solved

#

# File 'lib/studium/commandline/commandline.rb', line 1240

def report_how_many_exam_questions_were_already_solved
  require 'studium/toplevel_methods/toplevel_methods.rb'
  Studium::Exams.report_how_many_exam_questions_were_already_solved
end

#report_passed_exams_fitting_to_this_theme(this_theme) ⇒ Object

#

report_passed_exams_fitting_to_this_theme

#

# File 'lib/studium/commandline/commandline.rb', line 1192

def report_passed_exams_fitting_to_this_theme(this_theme)
  require 'studium/exams/show_themes/misc.rb'
  Studium.report_passed_exams_fitting_to_this_theme(this_theme)
end

#report_the_difference_to_the_start_time ⇒ Object

#

report_the_difference_to_the_start_time

#

# File 'lib/studium/commandline/commandline.rb', line 1295

def report_the_difference_to_the_start_time
  Studium.report_the_difference_to_the_start_time
end

#reset ⇒ Object

#

reset (reset tag)

#

# File 'lib/studium/commandline/commandline.rb', line 59

def reset
  super()
  infer_the_namespace
  try_to_require_the_open_gem
end

#run ⇒ Object

#

run (run tag)

#

# File 'lib/studium/commandline/commandline.rb', line 1813

def run
  menu
end

#show_all_exams_at_this_university(this_university) ⇒ Object

#

show_all_exams_at_this_university

To invoke this method, try:

studium --exams-at-the-meduni

#

# File 'lib/studium/commandline/commandline.rb', line 1700

def show_all_exams_at_this_university(this_university)
  require 'studium/utility_scripts/finished_exams_at_this_university.rb'
  Studium::FinishedExamsAtThisUniversity.new(this_university)
end

#show_available_topics ⇒ Object

#

show_available_topics

Invocation example:

studium --topics?

#

# File 'lib/studium/commandline/commandline.rb', line 1601

def show_available_topics
  require 'studium/toplevel_methods/toplevel_methods.rb'
  e
  Studium.available_topics?.sort.each_with_index {|entry, index| index += 1
    padded_index = ('  '+index.to_s+')').ljust(7)
    e royalblue(padded_index)+
      steelblue(entry)
  }
  e
end

#show_backlog_of_exams ⇒ Object

#

show_backlog_of_exams

#

# File 'lib/studium/commandline/commandline.rb', line 1738

def show_backlog_of_exams
  require 'studium/exams/show_backlog_of_exams.rb'
  Studium::ShowBacklogOfExams.new
end

#show_best_month(i = 10) ⇒ Object

#

show_best_month

To invoke this, try:

studium --show-best-month

#

# File 'lib/studium/commandline/commandline.rb', line 1713

def show_best_month(i = 10)
  require 'studium/exams/exams_per_month/exams_per_month.rb'
  _ = Studium::ExamsPerMonth.new(:do_not_run_yet)
  _.sanitize_dataset
  _.show_best_months(i)
end

#show_collage_of_current_exams ⇒ Object

#

show_collage_of_current_exams

Invoke this method via:

studium --collage?

#

# File 'lib/studium/commandline/commandline.rb', line 1650

def show_collage_of_current_exams
  require 'studium/exams/cycle.rb'
  file = Studium::Exams::Cycle.main_file?
  array = YAML.load_file(file) 
  opne 'These entries are currently being tested by class'
  opne "#{slateblue('Studium::Exams::Cycle')}:"
  e
  array.each {|this_exam_topic|
    e "  #{sfancy(this_exam_topic)}"
  }
  e
end

#show_curricula(use_this_file = Studium.file_curricula) ⇒ Object

#

show_curricula

#

# File 'lib/studium/commandline/commandline.rb', line 1445

def show_curricula(
    use_this_file = Studium.file_curricula
  )
  e
  e 'The available curricula are:'
  e
  YAML.load_file(use_this_file).each_pair {|id_of_the_curriculum, inner_array|
    name_of_the_curriculum = inner_array.first
    e '  '+
      orange(id_of_the_curriculum.ljust(8))+' → '+
      slateblue(name_of_the_curriculum)
  }
  e
end

#show_ects_passed_per_university ⇒ Object

#

show_ects_passed_per_university

#

# File 'lib/studium/commandline/commandline.rb', line 1559

def show_ects_passed_per_university
  require 'studium/ects/ects_per_university/ects_per_university.rb'
  Studium::EctsPerUniversity.new
end

#show_exam_statistics ⇒ Object

#

show_exam_statistics

This method will show some exam-statistics, if the file specified at FILE_STATISTICS can be found. If it is found, the content will be displayed, but we will also colourize a bit, to make the display easier to read.

To invoke this method, do:

studium --examstats

#

# File 'lib/studium/commandline/commandline.rb', line 1350

def show_exam_statistics
  require 'studium/statistics/show_exam_statistics.rb'
  Studium.show_exam_statistics
end

#show_help ⇒ Object

#

show_help (help tag)

We will first build up an Array, then sort it, then display it. That way we can just add to that Array without having to worry about whether it is sorted or not.

Invocation example:

studium --show-help

#

# File 'lib/studium/commandline/commandline.rb', line 985

def show_help
  array = []
  array << '  --exam-topics?                                           # feedback '\
           'the location to the exam-topics in use'
  array << '  --log-dir?                                               # feedback '\
           'the log directory in use'
  array << '  --n-topics?                                              # feedback '\
           'how many topics are available'
  array << '  --show_how_many_exams_were_passed                        # feedback '\
           'how many exams were already passed'
  array << '  --set-directory-to-the-exam-topics=/Depot/j/EXAM_TOPICS/ # set a '\
           'specific directory target'
  array << '  --best-months                                            # show '\
           'the best month, that is, most ECTS points solved in any given month'
  array << '  --set-dir=/dir                                           # shorter '\
           'variant of the above; an alias'
  array << '  --lectures-from-this-curriculum=217                      # use '\
           'a specific curriculum number (as ID)'
  array << '  --set-editor=vim                                         # set '\
           'to use the editor called vim (or any other one of your choice)'
  array << '  --show-curricula                                         # show '\
           'all registered curricula'
  array << '  --master-curricula                                       # show '\
           'all lectures passed in a given master curriculum'
  array << '  --upload-exam-questions                                  # uploads '\
           'the exam questions'
  array << '  --expand="15.10-22.10.2018"                              # expand '\
           'the time range for this range'
  array << '  --encoding=utf                                           # use '\
           'this encoding for the Studium namespace'
  array << '  --outdated                                               # show '\
           'outdated lva- and exam-dates of registered lectures'
  array << '  --show-mixed-courses                                     # show '\
           'only courses that are part of a Bachelor as well as '\
           'a Master curriculum'
  array << '  --collage?                                               # show '\
           'which exams we are currently training'
  array << '  --n-ects-from-this-file=ECTS.md                          # display '\
           'how many ECTS points are in that file'
  array << '  --ects-bachelor-master?                                  # show '\
           'how many bachelor/master ECTS points were passed so far'
  array << '  --passed-exams?                                          # show '\
           'which exams were already completed successfully'
  array << '  --start                                                  # note '\
           'down the start time + how many exams were solved at this point'
  array << '  --pristine                                               # this '\
           'will create a new file called '+
           'lecture_information.yml'+
           ', without any already solved exams'
  array << '  --colours?                                               # show '\
           'whether we will use colours or whether we will not'
  array << '  --passed-ects                                            # show '\
           'how many ECTS were passed in the registered curricula'
  array << '  --passed-exams=chemistry                                 # show '\
           'passed exams belonging to the given theme (in this '\
           'case, lectures related to chemistry)'
  array << '  --available-themes                                       # show '\
           'all registered (and thus available) themes of different lectures'
  array << '  --statistics                                             # show '\
           'some general statistics of this project'
  array << '  --check-the-lecture-information-file                     # check '\
           'whether all entries are correct, in the file called '+
           sfile('lecture_information.yml')
  array << '  --lectures-on-this-day=05.05.2018                        # show '\
           'which lectures are on the given day'
  array << '  --disable-colours                                        # this '\
           'entry point allows you to permanently disable colours'
  array << '  --solved?                                                # show '\
           'whether whether that particular lecture ID was already solved or '\
           'whether it was not'
  array << '  --set-log-dir=/foo/bar/                                  # specify '\
           'another log directory'
  array << '  --exams-at-the-meduni                                    # show '\
           'all exams at the meduni'
  array << '  --n-entries-in-the-file-lecture-information?             # report '\
           'how many courses are registered in the file '+
           sfile('lecture_information.yml')
  array << '  --max?                                                   # show '\
           'how many exams were already passed'
  array << '  --download-exam-dataset                                  # download '\
           'the exam dataset from a remote website'
  array << '  --gui                                                    # start '\
           'the GUI component of the Studium project'
  array << '  --timetable                                              # show '\
           'upcoming possible exams, via a timetable'
  array << '  --max-ever                                               # show '\
           'the maximum amount of exam-questions ever answered'
  array << '  --audio-stats                                            # show '\
           'all locally available audio files in the study-directory'
  array << '  --yearly-average-grades                                  # show '\
           'the yearly average grades'
  array << '  --percentage-achieved                                    # show '\
           'how much percent of a given curriculum we have already passed'
  array << '  --questions-per-year                                     # show '\
           'how many questions were added per year'
  array << '  --exams-at-the-uniwien                                   # show '\
           'all exams at the uniwien (university of vienna)'
  array << '  --open                                                   # open '\
           'relevant study-specific files in the (default) editor'
  array << '  /name_of_exams/                                          # regex '\
           'search for an exam with that name'
  array << '  --upcoming_exams_at_the_boku                             # show '\
           'all upcoming exams at the BOKU. (This will also generate a .html page.)'
  array << '  --upcoming-important-exams                               # show '\
           'all upcoming exams in general. (This will also generate a .html page.)'
  array << '  --examstats                                              # show '\
           'the exam statistics, that is, how many exams you passed'
  array << '  --use-this-colour-for-exam-questions=slateblue           # set '\
           'to use this colour for exam-questions'
  array << '  --use-this-colour-for-exam-answers=slateblue             # set '\
           'to use this colour for exam-answers'
  array << '  --set-delay=5                                            # set '\
           'the delay between answering a question to n seconds, in this case 5'
  array << '  --delay?                                                 # query '\
           'the current delay in use'
  array << '  --files?                                                 # show '\
           'where some of the important files may be kept'
  array << '  last-exams 15                                            # show '\
           'the last 15 passed exams'
  array << '  --update-max-questions                                   # update '\
           'how many questions were asked'
  array << '  --mandatory                                              # show '\
           'upcoming mandatory courses in the next some days (40 days usually)'
  e
  e "#{rev}The following #{steelblue(array.size.to_s)} options "\
    "are available and documented for #{royalblue('bin/studium')}:"
  e
  e
  # ======================================================================= #
  # The above ^^^ can be added in any random order; the next line will
  # sort this anyway.
  # ======================================================================= #
  array.sort.each {|entry| eparse entry }
  e
end

#show_how_many_exam_topics_are_available ⇒ Object

#

show_how_many_exam_topics_are_available

#

# File 'lib/studium/commandline/commandline.rb', line 1372

def show_how_many_exam_topics_are_available
  require 'studium/toplevel_methods/n_topics_available.rb'
  e rev+'There are '+simp(Studium::Exams.n_topics_available?.to_s)+' '\
    'topics available.'
end

#show_how_many_exams_were_passed ⇒ Object

#

show_how_many_exams_were_passed

This method will tell us how many exams were passed.

Commandline invocation example:

studium --show_how_many_exams_were_passed

#

# File 'lib/studium/commandline/commandline.rb', line 1730

def show_how_many_exams_were_passed
  require 'studium/toplevel_methods/toplevel_methods.rb'
  Studium::Exams.report_how_many_exam_questions_were_already_solved
end

#show_lva_dates_of_this_lecture(this_theme) ⇒ Object

#

show_lva_dates_of_this_lecture

#

# File 'lib/studium/commandline/commandline.rb', line 1418

def show_lva_dates_of_this_lecture(this_theme)
  Studium.show_lva_dates_of_this_lecture(this_theme)
end

#show_max_exam_questions_answered_per_topic(file_max_stats = Studium.file_max_stats) ⇒ Object

#

show_max_exam_questions_answered_per_topic

#

# File 'lib/studium/commandline/commandline.rb', line 1580

def show_max_exam_questions_answered_per_topic(
    file_max_stats = Studium.file_max_stats
  )
  dataset = YAML.load_file(file_max_stats)
  e
  dataset.each_pair {|key, value|
    value = value.to_s.rjust(5)
    e "  #{lightgreen(key+':').ljust(80)} "\
      "#{steelblue(value)}"
  }
  e
end

#show_maximum_amount_of_questions_ever_answered ⇒ Object

#

show_maximum_amount_of_questions_ever_answered

#

# File 'lib/studium/commandline/commandline.rb', line 42

def show_maximum_amount_of_questions_ever_answered
  require 'studium/exams/questions_solved_from_day_to_day/questions_solved_from_day_to_day.rb'
  _ = Studium::Exams::QuestionsSolvedFromDayToDay.return_maximum_amount_of_questions_ever_answered
  opne "#{rev}The maximum amount of exam-questions ever answered was `"\
       "#{sfancy(_)}#{rev}`."
  if Studium.is_on_roebe?
    # ===================================================================== #
    # Next show the "We already solved xyz questions" line:
    # ===================================================================== #
    require 'studium/toplevel_methods/toplevel_methods.rb'
    Studium::Exams.report_how_many_exam_questions_were_already_solved
  end
end

#show_n_ects_from_this_file(i) ⇒ Object

#

show_n_ects_from_this_file

#

# File 'lib/studium/commandline/commandline.rb', line 1747

def show_n_ects_from_this_file(i)
  if File.exist? i
    e royalblue(
        Studium.return_n_ects_from_this_file(i).to_s+' ECTS points'
      )
  else
    no_file_exists_at(i)
  end
end

#show_outdated_lva_dates ⇒ Object

#

show_outdated_lva_dates

#

# File 'lib/studium/commandline/commandline.rb', line 1200

def show_outdated_lva_dates
  require 'studium/utility_scripts/show_outdated_lva_dates.rb'
  Studium.show_outdated_lva_dates
end

#show_passed_credits_per_curriculum ⇒ Object

#

show_passed_credits_per_curriculum

Invocation example:

studium --passed-ects

#

# File 'lib/studium/commandline/commandline.rb', line 1484

def show_passed_credits_per_curriculum
  require 'studium/ects/show_passed_credits_per_curriculum.rb'
  Studium.show_passed_credits_per_curriculum
end

#show_passed_ects_in_the_individual_bachelor_and_master_curricula ⇒ Object

#

show_passed_ects_in_the_individual_bachelor_and_master_curricula

#

# File 'lib/studium/commandline/commandline.rb', line 1679

def show_passed_ects_in_the_individual_bachelor_and_master_curricula
  require 'studium/toplevel_methods/show_passed_ects_in_the_individual_bachelor_and_master_curricula.rb'
  Studium.show_passed_ects_in_the_individual_bachelor_and_master_curricula
end

#show_passed_ects_per_year ⇒ Object

#

show_passed_ects_per_year

#

# File 'lib/studium/commandline/commandline.rb', line 1381

def show_passed_ects_per_year
  require 'studium/utility_scripts/passed_ects_per_year.rb'
  Studium.passed_ects_per_year
end

#show_passed_exams ⇒ Object

#

show_passed_exams

#

# File 'lib/studium/commandline/commandline.rb', line 1519

def show_passed_exams
  ::Studium.show_passed_exams
end

#show_passed_lectures_in_a_bachelor_curriculum ⇒ Object

#

show_passed_lectures_in_a_bachelor_curriculum

#

# File 'lib/studium/commandline/commandline.rb', line 1768

def show_passed_lectures_in_a_bachelor_curriculum
  require 'studium/exams/exams_per_month/exams_per_month.rb'
  Studium::ExamsPerMonth.show_passed_bachelor_lectures
end

#show_passed_lectures_in_a_master_curriculum ⇒ Object

#

show_passed_lectures_in_a_master_curriculum

Use this method if you want to see which lectures have been passed in a master curriculum.

To invoke this method from the commandline, try:

studium --master_curricula

#

# File 'lib/studium/commandline/commandline.rb', line 1792

def show_passed_lectures_in_a_master_curriculum
  require 'studium/exams/exams_per_month/exams_per_month.rb'
  Studium::ExamsPerMonth.show_passed_master_lectures
end

#show_path_to_the_file_lecture_information ⇒ Object

#

show_path_to_the_file_lecture_information

#

# File 'lib/studium/commandline/commandline.rb', line 1615

def show_path_to_the_file_lecture_information
  e
  e sfancy("  #{Studium.file_lecture_information}")
  e
end

#show_questions_per_year ⇒ Object

#

show_questions_per_year

#

# File 'lib/studium/commandline/commandline.rb', line 1551

def show_questions_per_year
  require 'studium/exams/new_questions_per_year.rb'
  Studium.show_questions_per_year
end

#show_the_available_themes ⇒ Object

#

show_the_available_themes

Invoke this method from the commandline via:

studium --available-themes

#

# File 'lib/studium/commandline/commandline.rb', line 1129

def show_the_available_themes
  file = ::Studium.file_allowed_themes_for_courses
  if File.exist? file
    dataset = YAML.load_file(file)
    dataset.each {|entry| e steelblue(entry) }
  end
end

#show_the_base_dir ⇒ Object

#

show_the_base_dir

#

# File 'lib/studium/commandline/commandline.rb', line 1567

def show_the_base_dir
  e
  e '  '+sfile(
    File.expand_path(
      File.read(Studium.file_log_directory).chomp
    )
  )
  e
end

#show_the_current_studyset ⇒ Object

#

show_the_current_studyset

#

# File 'lib/studium/commandline/commandline.rb', line 1504

def show_the_current_studyset
  _ = FILE_FOR_EXAM_QUESTIONS
  if File.exist? _
    this_exam_topic = YAML.load_file(_).strip
    e 'The current exam-topic, taken from the file '
    e sfile(_)
    e 'is `'+sfile(File.basename(this_exam_topic))+'`.'
  else
    e 'No file exists at `'+sfile(_)+'`.'
  end
end

#show_timetable ⇒ Object

#

show_timetable

Invocation example:

studium --timetable

#

# File 'lib/studium/commandline/commandline.rb', line 1805

def show_timetable
  require 'studium/requires/require_upcoming_exams.rb'
  Studium::Exams::UpcomingExams.new
end

#show_upcoming_exams_at_the_boku ⇒ Object

#

show_upcoming_exams_at_the_boku

#

# File 'lib/studium/commandline/commandline.rb', line 1637

def show_upcoming_exams_at_the_boku
  require 'studium/exams/upcoming_exams_at_the_boku/upcoming_exams_at_the_boku.rb'
  Studium.show_upcoming_exams_at_the_boku
end

#show_upcoming_mandatory_presence_courses ⇒ Object

#

show_upcoming_mandatory_presence_courses

#

# File 'lib/studium/commandline/commandline.rb', line 1170

def show_upcoming_mandatory_presence_courses
  require 'studium/utility_scripts/upcoming_mandatory_presence_courses/upcoming_mandatory_presence_courses.rb'
  Studium::UpcomingMandatoryPresenceCourses.new(ARGV)
end

#show_where_the_exam_topics_can_be_found ⇒ Object

#

show_where_the_exam_topics_can_be_found

#

# File 'lib/studium/commandline/commandline.rb', line 1329

def show_where_the_exam_topics_can_be_found
  e
  e 'The exam topics can be found here:'
  e
  e  "  #{sdir(Studium.exam_topics?)}"
  e
end

#show_yearly_average_grades ⇒ Object

#

show_yearly_average_grades

Invocation example:

studium --yearly-average-grades

#

# File 'lib/studium/commandline/commandline.rb', line 1468

def show_yearly_average_grades
  # ======================================================================= #
  # Must delegate towards Studium::ExamsPerMonth in this case.
  # ======================================================================= #
  require 'studium/exams/exams_per_month/exams_per_month.rb'
  Studium::ExamsPerMonth.new(:dont_run_yet) { '--yearly-average-grades' }
end

#start_a_new_exam_day ⇒ Object

#

start_a_new_exam_day

#

# File 'lib/studium/commandline/commandline.rb', line 1140

def start_a_new_exam_day
  require 'studium/logging/store_last_question_asked_into_file.rb'
  Studium::Log::StoreLastQuestionAskedIntoFile.reset_file
end

#start_gui_component ⇒ Object

#

start_gui_component

Use this method to start the gui/gtk component of the Studium project.

Invocation example:

studium --gui

#

# File 'lib/studium/commandline/commandline.rb', line 1215

def start_gui_component
  unless ::Studium.const_defined? :GUI
    require 'studium/gui/gtk2/simple_widget_question_answer.rb'
  end
  Studium::GUI::Gtk::SimpleWidgetQuestionAnswer.run_as_standalone_gtk_window
end

#start_the_sinatra_interface ⇒ Object

#

start_the_sinatra_interface

#

# File 'lib/studium/commandline/commandline.rb', line 1760

def start_the_sinatra_interface
  require 'studium/www/sinatra/app.rb'
  Studium.start_sinatra_interface
end

#upcoming_important_exams ⇒ Object

#

upcoming_important_exams

This class seems to no longer exist as of October 2020.

#

# File 'lib/studium/commandline/commandline.rb', line 1288

def upcoming_important_exams
  Studium::Exams::UpcomingImportantExams.new
end

#upload_archive_of_the_exam_questions ⇒ Object

#

upload_archive_of_the_exam_questions

#

# File 'lib/studium/commandline/commandline.rb', line 1225

def upload_archive_of_the_exam_questions
  Studium.upload_archive_of_the_exam_questions
end

#upload_pdf ⇒ Object

#

upload_pdf

#

# File 'lib/studium/commandline/commandline.rb', line 1526

def upload_pdf
  Studium.upload_pdf
end

#verbose_open_important_exams ⇒ Object

#

verbose_open_important_exams

#

# File 'lib/studium/commandline/commandline.rb', line 1262

def verbose_open_important_exams
  require 'studium/exams/upcoming_exams/upcoming_exams.rb'
  opne "Now opening the #{slateblue('important-exams')} #{rev}"\
       "file in the editor." 
  ::Studium.open_important_exams
end

#verbose_set_this_dir_to_exam_topics(match) ⇒ Object

#

verbose_set_this_dir_to_exam_topics

#

# File 'lib/studium/commandline/commandline.rb', line 1311

def verbose_set_this_dir_to_exam_topics(match)
  e 'Now setting to a new directory for the exam topics, at:'
  e "  #{sdir(match)}"
  Studium.permanenty_set_directory_to_the_exam_topics(match)
end

#verbose_set_this_new_log_dir(match) ⇒ Object

#

verbose_set_this_new_log_dir

#

# File 'lib/studium/commandline/commandline.rb', line 1320

def verbose_set_this_new_log_dir(match)
  e 'Now setting to a new log-directory for the Studium project, at:'
  e "  #{sdir(match)}"
  Studium.permanenty_set_log_directory_to_this_entry(match)
end

#verbose_update_max_ever ⇒ Object

#

verbose_update_max_ever

#

# File 'lib/studium/commandline/commandline.rb', line 1492

def verbose_update_max_ever
  require 'studium/exams/questions_solved_from_day_to_day/questions_solved_from_day_to_day.rb'
  e "#{rev}Now updating the max-ever entry of all exam-questions "\
    "that were answered."
  e 'This will be stored in the file at '+
    sfile(Studium.file_daily_questions_solved?)
  Studium.update_max_ever_exam_questions_answered
end