Class: Roebe::PrependThis

Inherits:
Base show all
Defined in:
lib/roebe/classes/prepend_this.rb

Overview

Roebe::PrependThis

Constant Summary

Constants inherited from Base

Base::COLOURS, Base::HOME_DIRECTORY_OF_USER_X, Base::N, Base::NAMESPACE

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Base

#actions, #append_this_onto_that_file, #append_what_into, #be_silent, #be_verbose?, #beautiful_url, #burlywood, #call_next, #chdir, #cheerful_guy, #cliner, #complex_esystem, #convert_global_env, #copy_directory, #copy_file, #cornflowerblue, #create_directory, #crimson, #current_month?, #current_time?, #current_year?, #cyan, #darkcyan, #darkgreen, #darkkhaki, #darkslateblue, #deeppink, #delete_symlink, #do_not_use_the_base_colours, #do_use_the_base_colours, #e, #ecomment, #editor_to_use?, #efancy, #eimp, #emphasis, #ensure_main_encoding, #ensure_utf_encoding, #eparse, #erev, #esteelblue, #etomato, #ewarn, #firebrick, #get_current_day, #get_current_month, #get_files_and_directories, #get_files_from, #get_german_name_for_this_weekday, #gold, #green, #grey, #hh_mm_ss, #hh_mm_ss_day_month_year, #home_dir?, #home_directory_of_user_x?, #infer_the_namespace, #internal_hash?, #is_a_directory?, #is_a_file?, #is_a_jpg_file?, #is_an_image_file?, #is_archive?, #is_audio_file?, #is_in_studium_dir?, #is_multimedia_file?, #is_on_roebe?, #is_on_windows?, #is_studium_available?, #is_symlink?, #is_this_a_ruby_file?, #is_video_file?, #iso_encoding?, #le, #left_colour, #lightblue, #lightgreen, #lightseagreen, #lightsteelblue, #lime, #limegreen, #localhost_to_data, #log_directory?, #main_encoding?, #mediumorchid, #mediumpurple, #mediumseagreen, #mediumslateblue, #mediumspringgreen, #mediumturquoise, #mkdir_p, #mv, #n_days_in_this_month, #n_pages_in_this_pdf_file?, #namespace?, #no_file_exists_at, #olivedrab, #open_in_browser, #opne, #opnesystem, #opnn, #orange, #orchid, #palegoldenrod, #palevioletred, #pink, #powderblue, #programs_dir?, #project_base_dir?, #random_html_colour, #rds, #read_file_in_iso_encoding, #read_file_via_the_default_encoding, #read_lines_via_iso_encoding, #readlines_with_main_encoding, #red, #register_sigint, #remove, #remove_directory, #remove_file, #rename_kde_konsole_tab, #replace_localhost_with_data, #report_pwd, #require_rescue, #reset_the_internal_hash, #return_all_directories_from_this_directory, #return_all_files_from_this_directory, #return_current_directory, #return_dd_mm_yyyy, #return_file_or_directory_of, #return_files_from_pwd, #return_last_part_of_the_current_directory, #return_utc, #rev, #right_arrow?, #right_colour, #roebe_log_directory?, #rosybrown, #royalblue, #ruby_base_directory?, #run_in_background, #run_rcfiles_then_run_ata_via_qdbus, #sandybrown, #sdir, #seagreen, #set_be_verbose, #set_xorg_buffer, #sfancy, #sfile, #silent_redirection?, #simp, #simple_esystem, #skyblue, #slateblue, #slategray, #springgreen, #steelblue, #swarn, #symlink, #teal, #temp_dir?, #to_camelcase, #to_counted_hash, #tomato, #touch, #try_to_require_the_beautiful_url_gem, #try_to_require_the_html_template, #try_to_require_the_open_gem, #try_to_require_the_program_information_gem, #try_to_require_the_xorg_buffer, #use_colours?, #verbose_truth, #weekday?, #word_wrap, #write_what_into, #yellow

Methods included from Base::CommandlineArguments

#append_onto_the_commandline_arguments, #clear_commandline_arguments, #commandline_arguments?, #commandline_arguments_as_string?, #commandline_arguments_without_leading_hyphens?, #first_argument?, #first_argument_without_leading_hyphens?, #has_an_argument_been_passed?, #remove_hyphened_arguments_from_the_commandline_arguments, #return_commandline_arguments_with_leading_hyphens, #second_argument?, #set_commandline_arguments

Constructor Details

#initialize(prepend_this = nil, use_these_files = :fetch_from_the_current_working_directory, run_already = true) ⇒ PrependThis

#

initialize

The first argument is “what String to prepend?”.

The second argument is the target file(s).

#


29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
# File 'lib/roebe/classes/prepend_this.rb', line 29

def initialize(
    prepend_this    = nil,
    use_these_files = :fetch_from_the_current_working_directory,
    run_already     = true
  )
  reset
  if prepend_this.is_a?(Array) and (prepend_this.size > 1)
    # ===================================================================== #
    # In this case at the least two arguments were given on the
    # commandline.
    # ===================================================================== #
    use_these_files = prepend_this.pop
    prepend_this = prepend_this.first if prepend_this.respond_to?(:first)
  end
  set_prepend_this(
    prepend_this
  )
  set_modify_these_files(
    use_these_files
  )
  run if run_already
end

Class Method Details

.[](i = ARGV) ⇒ Object

#

Roebe::PrependThis[]

#


258
259
260
# File 'lib/roebe/classes/prepend_this.rb', line 258

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

.to(this_string = ARGV.first, files: :in_the_current_directory) ⇒ Object

#

Roebe::PrependThis.to

#


265
266
267
268
269
270
271
272
273
# File 'lib/roebe/classes/prepend_this.rb', line 265

def self.to(
    this_string = ARGV.first,
    files: :in_the_current_directory
  )
  self.new(
    prepend_this    = this_string,
    use_these_files = files
  )
end

Instance Method Details

#batch_modify_the_files(these_files = files? ) ⇒ Object

#

batch_modify_the_files

#


164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
# File 'lib/roebe/classes/prepend_this.rb', line 164

def batch_modify_the_files(
    these_files = files?
  )
  prepend_this = prepend_this?
  if prepend_this.empty?
    opne 'Can not prepend anything as the main prepend-string is empty.'
  else
    these_files.each {|this_file|
      basename = File.basename(this_file)
      new_name = File.absolute_path("#{prepend_this}#{basename}")
      opne 'The new name is `'+sfile(new_name)+'`.'
      mv(this_file, new_name)
      # =================================================================== #
      # Keep track of the rename-operations next. The Hash format will
      # first show the ORIGINAL filename, and then the NEW filename.
      # =================================================================== #
      @hash_logging_actions_done_by_this_class[File.absolute_path(this_file)] =
        File.absolute_path(new_name)
    }
  end
end

#consider_logging_the_operations_that_were_done_by_this_classObject

#

consider_logging_the_operations_that_were_done_by_this_class (store tag)

#


207
208
209
210
211
212
213
214
215
216
217
218
219
# File 'lib/roebe/classes/prepend_this.rb', line 207

def consider_logging_the_operations_that_were_done_by_this_class
  unless @hash_logging_actions_done_by_this_class.empty?
    into = store_where?
    opne "Logging the prepend-operations that were done "\
         "into the local file"
    opne "  `(#{sfile(into)})`."
    what = YAML.dump(hash?)
    # if File.exist?(into)
    #   what.update(YAML.load_file(into))
    # end
    write_what_into(what, into)
  end
end

#hash_logging_actions_done_by_this_class?Boolean Also known as: hash?

#

hash_logging_actions_done_by_this_class?

#

Returns:

  • (Boolean)


74
75
76
# File 'lib/roebe/classes/prepend_this.rb', line 74

def hash_logging_actions_done_by_this_class?
  @hash_logging_actions_done_by_this_class
end
#

menu (menu tag)

#


224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
# File 'lib/roebe/classes/prepend_this.rb', line 224

def menu(i)
  if i.is_a? Array
    i.each {|entry| menu(entry) }
  else
    case i # case tag
    # ===================================================================== #
    # === prepend --revert
    # ===================================================================== #
    when /^-?-?revert$/i,
         /^-?-?reverse$/i,
         /^-?-?undo$/i # === prepend --undo
      revert_the_last_operation
      exit
    # ===================================================================== #
    # === help
    # ===================================================================== #
    when /help/
      show_help
      exit
    end
  end
end

#modify_these_files?Boolean Also known as: files?

#

modify_these_files?

#

Returns:

  • (Boolean)


99
100
101
# File 'lib/roebe/classes/prepend_this.rb', line 99

def modify_these_files?
  @modify_these_files
end

#prepend_this?Boolean

#

prepend_this?

#

Returns:

  • (Boolean)


122
123
124
# File 'lib/roebe/classes/prepend_this.rb', line 122

def prepend_this?
  @prepend_this
end

#resetObject

#

reset (reset tag)

#


55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
# File 'lib/roebe/classes/prepend_this.rb', line 55

def reset
  super()
  infer_the_namespace
  # ======================================================================= #
  # === @hash_logging_actions_done_by_this_class
  #
  # The next Hash is useful because we can store what happened while this
  # class is working.
  # ======================================================================= #
  @hash_logging_actions_done_by_this_class = {}
  # ======================================================================= #
  # === @modify_these_files
  # ======================================================================= #
  @modify_these_files = []
end

#revert_the_last_operationObject

#

revert_the_last_operation

To invoke this method from the commandline, try:

prepend --revert
#


134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
# File 'lib/roebe/classes/prepend_this.rb', line 134

def revert_the_last_operation
  opne 'Now attempting to revert the last prepend-operation.'
  _ = store_where?
  if File.exist?(_)
    opne 'Using the information from the file '+sfile(_)+'.'
    hash_dataset = YAML.load_file(_)
    hash_dataset.each_pair {|old_file, existing_file|
      if File.exist? existing_file
        opne 'Renaming/moving file from '+
              sfile(existing_file)+' to '+sfile(old_file)
        move_file(existing_file, old_file)
      else
        opnn; no_file_at(existing_file)
      end
    }
  else
    opnn; no_file_exists_at(_)
  end
end

#runObject

#

run (run tag)

#


250
251
252
253
# File 'lib/roebe/classes/prepend_this.rb', line 250

def run
  batch_modify_the_files
  consider_logging_the_operations_that_were_done_by_this_class
end

#set_modify_these_files(i = return_files_from_pwd) ⇒ Object

#

set_modify_these_files

#


81
82
83
84
85
86
87
88
89
90
91
92
93
94
# File 'lib/roebe/classes/prepend_this.rb', line 81

def set_modify_these_files(
    i = return_files_from_pwd
  )
  case i
  # ======================================================================= #
  # === :default
  # ======================================================================= #
  when :default,
       :in_the_current_directory,
       :fetch_from_the_current_working_directory
    i = return_files_from_pwd
  end
  @modify_these_files = [i].flatten.compact
end

#set_prepend_this(i = 'DONE_') ⇒ Object

#

set_prepend_this

#


106
107
108
109
110
111
112
113
114
115
116
117
# File 'lib/roebe/classes/prepend_this.rb', line 106

def set_prepend_this(i = 'DONE_')
  menu(i)
  case i
  # ======================================================================= #
  # === :today
  # ======================================================================= #
  when ':today', :today
    i = "#{dd_mm_yyyy}_"
  end
  i = [i].flatten.compact.first.to_s # We require a String here.
  @prepend_this = i
end

#show_helpObject

#

show_help (help)

#


189
190
191
192
193
194
195
196
197
198
199
200
201
202
# File 'lib/roebe/classes/prepend_this.rb', line 189

def show_help
  _ = <<-EOF

This class is currently very limited from the commandline.

Simply input the string that you wish to prepend, such as:

DONE_

--reverse # reverse the last prepend-operation (undo operation)'

EOF
  e _
end

#store_where?Boolean

#

store_where?

#

Returns:

  • (Boolean)


157
158
159
# File 'lib/roebe/classes/prepend_this.rb', line 157

def store_where?
  "#{log_dir?}prepend_actions.yml"
end