Class: RBT::Linux::ParseBlfsWebpage

Inherits:
Base
  • Object
show all
Defined in:
lib/rbt/linux/linux_from_scratch/parse_blfs_webpage.rb

Overview

RBT::Linux::ParseBlfsWebpage

Constant Summary collapse

NAMESPACE =
#

NAMESPACE

#
inspect
DEFAULT_FILE =
#

DEFAULT_FILE

#
RBT.log_dir?+'blfs_webpages/blfs_page_for_krb5.html'

Constants inherited from Base

Base::ALL_COLOUR_METHODS, Base::ARRAY_KDE_KONSOLE_COLOURS_IN_USE, Base::KONSOLE

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Base

#abbreviations?, #add_to_the_commandline_arguments, #all_binaries?, #all_libraries?, #always_show_dependencies?, #appdir_location_of?, #append_what_into, #archive_type_of?, #available_programs?, #be_quiet?, #be_verbose?, #begins_with_a_comment?, #capitalize_first_alphabetical_character, #capitalize_program_names?, #cat, #cd_to_the_log_directory, #cd_to_the_temp_directory, #change_directory, #change_permission, #cheering_person?, #chmod, #chop_off_archive, #cliner, #colourize_directory_for_system_results, #colourize_this_error, #colourize_this_file_path, #colourize_this_warning, #commandline_arguments?, #commandline_arguments_without_hyphens?, #config?, #convert_env_variable, #cookbook_files?, #cookbooks_include_this_program?, #copy_directory, #copy_files, #copy_recursively, #cpr, #create_directory, #current_hour?, #dd_mmm_yyy, #debug, #debug?, #determine_appdir_prefix_from_this_input, #determine_archive_type, #directory_expanded_cookbooks?, #directory_validation?, #disable_colours, #display_md5sum?, #do_not_debug, #do_not_show_names, #does_the_cookbook_include_this_program?, #does_this_expanded_cookbook_file_exist_for_this_program?, #does_this_file_exist?, #does_this_file_exist_and_is_it_a_file?, #e, #eblue, #ecomment, #ecrimson, #edir, #editor?, #efancy, #eimp, #email?, #enable_colours, #enable_debug, #ensure_main_encoding_for, #eparse, #esystem, #esystem_gold, #etomato, #ewarn, #exit_on_unregistered_cookbook_entries?, #exit_program, #expanded_cookbooks_directory_exists?, #fast_return_file_size_of_this_program, #file_compiled_programs?, #file_last_symlinked_program?, #file_predefined_installation_instructions?, #file_programs_version_url, #file_specification_of_registered_cookbook_entries, #find_cookbook_alias_for, #find_this_yaml_file, #first_argument?, #gem_version, #get_all_directories_from, #get_all_files_from, #get_all_programs, #get_date, #get_files_and_directories_from, #go_to_base_dir, #home_dir?, #host_system?, #is_a_64bit_system?, #is_an_archive?, #is_ccache_available?, #is_file?, #is_on_gobolinux?, #is_on_windows?, #is_porg_available?, #is_roebe?, #is_this_a_header?, #is_this_a_library?, #is_this_program_included?, #load_dataset_from_this_expanded_cookbook, #load_yaml, #load_yaml_file_from_the_cookbook_directory_for_this_program, #log_directory?, #main_encoding?, #make_command?, make_command?, #make_install_command?, #move_file, #n_programs_available?, #new_cookbook_instance_for, #no_directory_exists_at, #no_opn, #no_such_file_exists, #open_in_browser, #open_in_editor, #opne, #opnef, #opnerror, #opnewarn, #opnn, #path_to_this_expanded_cookbooks_dataset, #play_song?, #predefined_installation_instructions?, #program_dir?, #program_exists?, #programs_dir?, #project_base_dir?, #project_yaml_directory?, #publish_list_of_all_programs_version, #rarrow?, #rbt_logs?, #read_file, #read_file_in_default_encoding, #readlines, #readlines_with_proper_encoding, #recipes_dir?, #register_sigint, registered_binaries?, #remove, #remove_archive_from_the_end, #remove_comments_from_each_line, #remove_directory, #remove_double_slashes, #remove_file, #remove_file_extension, #remove_newlines, #remove_parens, #remove_symlink, #remove_this_commandline_argument, #remove_trailing_ANSII_escape_code, #remove_unnecessary_data_from_url, #rename, #rename_kde_konsole_tab, #repackage, #report_n_programs, #report_pwd, #report_to_developers, #report_working_directory, #return_all_archives_from_this_directory, #return_commandline_arguments_with_leading_hyphens, #return_current_hour_minutes_second, #return_date, #return_day_of_the_month_based_on_utc, #return_full_time, #return_hours_minutes_seconds_based_on_utc, #return_location_to_this_programs_yaml_file, #return_month_based_on_this_number, #return_month_based_on_utc, #return_n_random_characters, #return_opnn, #return_program_information, #return_program_name, #return_program_name_for_gobolinux_systems, #return_pwd, #return_unicode_warning_symbol_or_empty_string, #return_utc, #return_utc_time_in_a_format_similar_to_slackware, #return_version_of_this_program, #return_weekday_based_on_utc, #return_year_based_on_utc, #rev, #run_ldconfig?, #run_make_then_make_install, #run_simulation=, #run_simulation?, #sanitize_url1_entry, #sdir, #sdir_return_pwd, #set_be_silent, #set_be_verbose, #set_source_directory, #set_use_opn, #set_xorg_buffer, #sfancy, #sfile, #show_overview_over_available_utility_scripts, #silently_create_this_directory_if_it_does_not_yet_exist, #simp, #source_base_directory?, #ssym, #stderr, #store_into_this_directory?, #swarn, #symlink, #symlink_all_files_from_this_directory_to_that_directory, #sysbin_directory?, #sysetc_directory?, #sysinclude_directory?, #syslib_directory?, #sysshare_directory?, #system_directory?, #system_tags?, #temp_directory?, #to_bool, #to_camelcase, #to_unicode, #today?, #touch, #unicode_cliner, #unicode_middle_cliner, #upload_list_of_all_programs_version, #use_ccache?, #use_colours=, #use_colours?, #use_mrxvt?, #use_opn=, #use_opn?, #use_porg?, #use_stow?, #use_tags?, #use_yaml_database_for_tags?, #verbose_truth, #warn_and_exit, #wget, #word_wrap, #write_what_into, #write_what_into_via_unicode, #yes_or_no

Constructor Details

#initialize(commandline_arguments = nil, run_already = true) ⇒ ParseBlfsWebpage

#

initialize

#

50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
# File 'lib/rbt/linux/linux_from_scratch/parse_blfs_webpage.rb', line 50

def initialize(
    commandline_arguments = nil,
    run_already           = true
  )
  reset
  set_commandline_arguments(
    commandline_arguments
  )
  if block_given?
    case yield
    when :do_report
      @shall_we_report = true
    end
  end
  run if run_already
end

Class Method Details

.[](i = '') ⇒ Object

#

ParseBlfsWebpage[]

#

179
180
181
# File 'lib/rbt/linux/linux_from_scratch/parse_blfs_webpage.rb', line 179

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

Instance Method Details

#apply_nokogiriObject

#

apply_nokogiri

#

104
105
106
107
108
109
# File 'lib/rbt/linux/linux_from_scratch/parse_blfs_webpage.rb', line 104

def apply_nokogiri
  _ = Nokogiri::HTML(@dataset)
  _.xpath('//kbd[starts-with(@class, "command")]').each { |element|
    @dataset_after_having_applied_the_regex << element.children[0].text
  }
end

#report(i = @dataset_after_having_applied_the_regex) ⇒ Object

#

report (report tag)

#

122
123
124
125
126
127
128
129
130
131
132
# File 'lib/rbt/linux/linux_from_scratch/parse_blfs_webpage.rb', line 122

def report(
    i = @dataset_after_having_applied_the_regex
  )
  if @shall_we_report
    if i.is_a? Array
      i.each {|entry| e entry }
    else
      e i
    end
  end
end

#resetObject

#

reset (reset tag)

#

70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
# File 'lib/rbt/linux/linux_from_scratch/parse_blfs_webpage.rb', line 70

def reset
  super()
  # ======================================================================= #
  # === @namespace
  # ======================================================================= #
  @namespace = NAMESPACE
  # ======================================================================= #
  # === @dataset_after_having_applied_the_regex
  # ======================================================================= #
  @dataset_after_having_applied_the_regex = []
  # ======================================================================= #
  # === @shall_we_report
  # ======================================================================= #
  @shall_we_report = false
end

#runObject

#

run (run tag)

#

154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
# File 'lib/rbt/linux/linux_from_scratch/parse_blfs_webpage.rb', line 154

def run
  first = first_argument?
  if first.nil?
    opne 'Please provide a page here.'
  end
  # ======================================================================= #
  # First: handle locally existing files:
  # ======================================================================= #
  if first and File.exist?(first)
    @dataset = File.read(first, encoding: 'iso-8859-1')
  elsif first and first.is_a?(String)
    @dataset = first
  else
    opnn; e 'No file could be found. Please provide valid input.'
  end
  if @dataset
    try_to_simplify_the_dataset
    apply_nokogiri
  end
  report if @shall_we_report
end

#set_commandline_arguments(i = :default) ⇒ Object

#

set_commandline_arguments

#

89
90
91
92
93
94
95
96
97
98
99
# File 'lib/rbt/linux/linux_from_scratch/parse_blfs_webpage.rb', line 89

def set_commandline_arguments(i = :default)
  if i.is_a? Array and i.empty?
    i = :default
  end
  case i
  when :default
    i = [DEFAULT_FILE]
  end
  i = [i].flatten.compact
  @commandline_arguments = i
end

#shell_instructions?Boolean Also known as: commands?, shell_commands?

#

shell_instructions?

#

Returns:

  • (Boolean)

114
115
116
# File 'lib/rbt/linux/linux_from_scratch/parse_blfs_webpage.rb', line 114

def shell_instructions?
  @dataset_after_having_applied_the_regex
end

#try_to_simplify_the_datasetObject

#

try_to_simplify_the_dataset

#

137
138
139
140
141
142
143
144
145
146
147
148
149
# File 'lib/rbt/linux/linux_from_scratch/parse_blfs_webpage.rb', line 137

def try_to_simplify_the_dataset
  # ======================================================================= #
  # Simplify the dataset next:
  # ======================================================================= #
  if @dataset.include? '<div class="commands"'
    # ===================================================================== #
    # This is to exclude the explanation for the commands:
    # ===================================================================== #
    @dataset = @dataset[
      0 .. @dataset.index('<div class="commands"')
    ]
  end
end