backup_paradise 1.2.13

data/lib/backup_paradise/advanced_backup/reset.rb

@@ -0,0 +1,56 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'backup_paradise/advanced_backup/reset.rb'
+# =========================================================================== #
+module BackupParadise
+
+class AdvancedBackup < ::BackupParadise::Base # === BackupParadise::AdvancedBackup
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    super()
+    # ======================================================================= #
+    # === @perform_backup
+    #
+    # The next variable determines whether we will perform a backup
+    # job or not. By default this will be false - it will be set
+    # to true by default through the menu() interface, via its
+    # else clause.
+    # ======================================================================= #
+    @perform_backup = false
+    # ======================================================================= #
+    # === @date
+    # ======================================================================= #
+    @date = dd_mm_yyyy
+    # ======================================================================= #
+    # === @use_this_as_timestamp
+    #
+    # The next variable will keep the timestamp as-is.
+    #
+    # This may include ':' characters, which Windows NTFS does not seem
+    # to like. Thus, since as of September 2020, a slightly simpler
+    # variant is used here.
+    # ======================================================================= #
+    @use_this_as_timestamp = "#{@date}-#{current_time.tr(':','_')}"
+    # ======================================================================= #
+    # === @array_store_times
+    #
+    # The next Array will keep track of how long it took to backup
+    # the data.
+    # ======================================================================= #
+    @array_store_times = []
+    # ======================================================================= #
+    # === @show_popup_notification
+    # ======================================================================= #
+    @show_popup_notification = CONFIG['show_popup_notification']
+    # ======================================================================= #
+    # === @last_backup_directory
+    # ======================================================================= #
+    @last_backup_directory = nil
+  end
+
+end; end

data/lib/backup_paradise/advanced_backup/run.rb

@@ -0,0 +1,26 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'backup_paradise/advanced_backup/run.rb'
+# =========================================================================== #
+module BackupParadise
+
+class AdvancedBackup < ::BackupParadise::Base # === BackupParadise::AdvancedBackup
+
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run
+    # ======================================================================= #
+    # The next method will determine the main mountpoint in use, such as
+    # "/Mount/USB1/".
+    # ======================================================================= #
+    determine_the_target_mountpoint
+    menu
+    if @perform_backup
+      do_perform_the_backup_tasks # ← This is the main method of this class.
+    end
+  end
+
+end; end

data/lib/backup_paradise/advanced_backup/system_directory.rb

@@ -0,0 +1,35 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'backup_paradise/advanced_backup/system_directory.rb'
+# =========================================================================== #
+module BackupParadise
+
+class AdvancedBackup < ::BackupParadise::Base # === BackupParadise::AdvancedBackup
+
+  # ========================================================================= #
+  # === backup_the_system_directory
+  #  
+  # This method can be used to backup the "/System/Settings/" directory,
+  # as it may be found in GoboLinux.
+  # ========================================================================= #
+  def backup_the_system_directory(
+      target_directory = SYSTEM_SETTINGS_DIRECTORY
+    )
+    if File.directory? target_directory
+      cliner
+      e 'Now backing up the system-settings directory from '+
+         sfancy(target_directory)+' into '+
+         sfile(main_target?+File.basename(target_directory))
+      cliner
+      report_total_size_of(target_directory)
+      backup_this_directory_if_it_exists(
+        target_directory, :default, :do_not_continue
+      )
+    else
+      can_not_backup_this_directory_as_it_does_not_exist(target_directory)
+    end
+  end; alias backup_system_directory backup_the_system_directory # === backup_system_directory
+
+end; end

data/lib/backup_paradise/base/base.rb

@@ -0,0 +1,440 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'backup_paradise/base/base.rb'
+# =========================================================================== #
+require 'backup_paradise/base/colours.rb'
+require 'backup_paradise/base/constants.rb'
+require 'backup_paradise/constants/constants.rb'
+require 'backup_paradise/toplevel_methods/cliner.rb'
+require 'backup_paradise/toplevel_methods/colours.rb'
+require 'backup_paradise/toplevel_methods/e.rb'
+require 'backup_paradise/toplevel_methods/misc.rb'
+require 'backup_paradise/toplevel_methods/mountpoint.rb'
+require 'backup_paradise/tab/tab.rb'
+require 'backup_paradise/project/project_base_directory.rb'
+
+module BackupParadise
+
+class Base
+
+  # ========================================================================= #
+  # Next, external code is loaded.
+  # ========================================================================= #
+  begin
+    require 'roebe/time/time.rb'
+  rescue LoadError; end
+
+  begin
+    require 'opn'
+  rescue LoadError; end
+
+  # ========================================================================= #
+  # === BackupParadise.e
+  # ========================================================================= #
+  def e(i = '')
+    BackupParadise.e(i)
+  end
+
+  # ========================================================================= #
+  # === all_important_directories?
+  # ========================================================================= #
+  def all_important_directories?
+    ARRAY_THE_FIVE_MAIN_ENTRIES
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    @use_this_program_to_rename_tabs = nil
+  end
+
+  # ========================================================================= #
+  # === home_dir_of_user_x?
+  # ========================================================================= #
+  def home_dir_of_user_x?
+    '/home/x/'
+  end
+
+  # ========================================================================= #
+  # === use_colours?
+  # ========================================================================= #
+  def use_colours?
+    BackupParadise.use_colours?
+  end
+
+  # ========================================================================= #
+  # === n_files_in?
+  #
+  # This method will return how many files are in the given directory.
+  # ========================================================================= #
+  def n_files_in?(i)
+    _ = 0
+    if File.directory? i
+      _ = Dir["#{i}*"].size
+    end
+    _
+  end
+
+  # ========================================================================= #
+  # === create_directory
+  #
+  # The first argument to this method should be the name of the directory
+  # that has to be created, such as 'foobar/'.
+  # ========================================================================= #
+  def create_directory(
+      i, options = { mode_to_use: 0755 }
+    )
+    BackupParadise.create_directory(i, options)
+  end; alias mkdir create_directory # === mkdir
+
+  # ========================================================================= #
+  # === rds
+  # ========================================================================= #
+  def rds(i)
+    BackupParadise.rds(i)
+  end
+
+  # ========================================================================= #
+  # === no_such_directory_exists_at
+  # ========================================================================= #
+  def no_such_directory_exists_at(i)
+    e "No such directory exists at `#{sdir(i)}`."
+  end
+
+  # ========================================================================= #
+  # === cliner
+  # ========================================================================= #
+  def cliner
+    BackupParadise.cliner
+  end
+
+  # ========================================================================= #
+  # === no_target_at
+  # ========================================================================= #
+  def no_target_at(i)
+    e "No target at #{sfile(i)} could be found."
+  end
+
+  # ========================================================================= #
+  # === target_hdd_does_not_have_enough_space_left?
+  # ========================================================================= #
+  def target_hdd_does_not_have_enough_space_left?
+    false # for now this is always false. stub
+    # MINIMAL_FILESIZE
+  end
+
+  # ========================================================================= #
+  # === opnn
+  # ========================================================================= #
+  def opnn(i = NAMESPACE)
+    if i.is_a? String
+      i = {
+        namespace: i,
+        use_colours: use_colours?
+      }
+    end
+    BackupParadise.opnn(i)
+  end
+
+  # ========================================================================= #
+  # === delete_symlink
+  # ========================================================================= #
+  def delete_symlink(i)
+    if File.symlink? i
+      File.delete(i)
+    end
+  end
+
+  # ========================================================================= #
+  # === has_superuser_abilities?
+  # ========================================================================= #
+  def has_superuser_abilities?
+    Process.uid.zero?
+  end
+
+  # ========================================================================= #
+  # === chdir                                                        (cd tag)
+  #
+  # Change directory via this method here.
+  # ========================================================================= #
+  def chdir(i)
+    BackupParadise.change_directory(i)
+  end; alias cd               chdir # === cd
+       alias change_directory chdir # === change_directory
+
+  # ========================================================================= #
+  # === cd_to_the_mounted_device
+  # ========================================================================= #
+  def cd_to_the_mounted_device
+    cd target_mountpoint?
+  end
+
+  # ========================================================================= #
+  # === do_symlink
+  # ========================================================================= #
+  def do_symlink(
+      from_this_target, create_a_symlink_here
+    )
+    if File.exist? create_a_symlink_here
+      no_target_at(create_a_symlink_here)
+    else
+      File.symlink(from_this_target, create_a_symlink_here)
+    end
+  end
+
+  # ========================================================================= #
+  # === delete_files
+  # ========================================================================= #
+  def delete_files(
+      i, be_verbose = false
+    )
+    case be_verbose
+    when :be_verbose
+      be_verbose = true
+    end
+    if i.is_a? Array
+      i.each {|entry| delete_files(entry, be_verbose) }
+    else
+      if File.file? i
+        if be_verbose
+          opnn; e "Now deleting the file `#{sfile(i)}`."
+        end
+        File.delete(i)
+      else
+        e sfancy(i)+' is not not a file - we thus can not delete it.'
+      end
+    end
+  end; alias delete_file        delete_files # === delete_file
+       alias remove_these_files delete_files # === remove_these_files
+
+  # ========================================================================= #
+  # === remove_directory
+  # ========================================================================= #
+  def remove_directory(i)
+    BackupParadise.remove_directory(i)
+  end
+
+  # ========================================================================= #
+  # === register_sigint
+  # ========================================================================= #
+  def register_sigint
+    Signal.trap('SIGINT') { exit_program }
+  end
+
+  # ========================================================================= #
+  # === copy_file
+  # ========================================================================= #
+  def copy_file(from, to)
+    BackupParadise.copy_file(from, to)
+  end; alias copy_this_file copy_file # === copy_this_file
+
+  begin
+    require 'roebe/toplevel_methods/write_what_into.rb'
+  rescue LoadError => error
+    puts 'Please install the roebe-gem ( gem install roebe ).'
+    pp error
+  end
+
+  # ========================================================================= #
+  # === write_what_into
+  # ========================================================================= #
+  def write_what_into(what, into)
+    ::Roebe.write_what_into(what, into)
+  end
+
+  # ========================================================================= #
+  # === append_what_into
+  # ========================================================================= #
+  def append_what_into(what, into)
+    ::Roebe.append_what_into(what, into)
+  end
+
+  # ========================================================================= #
+  # === remove
+  # ========================================================================= #
+  def remove(i)
+    BackupParadise.remove(i)
+  end
+
+  # ========================================================================= #
+  # === data_directory?
+  # ========================================================================= #
+  def data_directory?
+    DATA_DIRECTORY
+  end; alias data_dir? data_directory? # === data_dir?
+
+  # ========================================================================= #
+  # === dd_mm_yyyy
+  #
+  # This method will return a String such as "25.12.2018".
+  # ========================================================================= #
+  def dd_mm_yyyy
+    ::Roebe::Time.dd_mm_yyyy # Tap into the Roebe namespace for this.
+  end
+
+  # ========================================================================= #
+  # === return_current_date_and_time
+  #
+  # This method will return a String such as:
+  #
+  #   "24.05.2018-03:48:50"
+  #
+  # ========================================================================= #
+  def return_current_date_and_time
+    "#{dd_mm_yyyy}-#{hh_mm_ss}"
+  end; alias return_full_date return_current_date_and_time # === return_full_date
+       alias date_and_time?   return_current_date_and_time # === date_and_time?
+
+  # ========================================================================= #
+  # === size?
+  # ========================================================================= #
+  def size?(i)
+    BackupParadise.size?(i)
+  end
+
+  # ========================================================================= #
+  # === no_file_exists_at
+  # ========================================================================= #
+  def no_file_exists_at(i)
+    e "No file exists at `#{sfile(i)}`."
+  end
+
+  # ========================================================================= #
+  # === exit_program                                               (exit tag)
+  #
+  # This method should be used when we have to exit from the
+  # backup_paradise project.
+  #
+  # The reason why a separate exit-method has been added is so that we
+  # can change this at a later time possibly, if we wish to do further
+  # checks before exiting.
+  # ========================================================================= #
+  def exit_program(be_verbose = false)
+    if be_verbose
+      e 'Quit was called, thus we exit now.'
+    end
+    if @use_this_program_to_rename_tabs
+     rename_tab(@use_this_program_to_rename_tabs)
+    end
+    exit
+  end
+
+  # ========================================================================= #
+  # === target_mountpoint?
+  #
+  # Designate to which target we will backup.
+  # ========================================================================= #
+  def target_mountpoint?
+    BackupParadise.target_mountpoint?
+  end; alias main_target?              target_mountpoint? # === main_target?
+       alias backup_to_this_directory? target_mountpoint? # === backup_to_this_directory?
+       alias mount_point?              target_mountpoint? # === mount_point?
+       alias mount_target?             target_mountpoint? # === mount_target?
+
+  # ========================================================================= #
+  # === report_total_size_of
+  #
+  # Use this method to report the total size of a specific directory. We
+  # expect the input to this method thus be a (local) directory.
+  # ========================================================================= #
+  def report_total_size_of(i)
+    size_result = size?(i)
+    kb_size     = (size_result.to_f / 1000.0).round(2)
+    mb_size     = (kb_size.to_f / 1000.0).round(2)
+    gb_size     = (mb_size.to_f / 1000.0).round(2)
+    e 'Total size of files in bytes at '+sdir(i)+': '+
+      seagreen(size_result)+' bytes.'
+    e 'This corresponds to '+
+      orangered(kb_size.to_s)+lightcoral(' KB ')+
+      orangered(mb_size.to_s)+lightcoral(' MB ')+
+      orangered(gb_size.to_s)+lightcoral(' GB')+'.'
+  end; alias report_file_size_of report_total_size_of # === report_file_size_of
+
+  # ========================================================================= #
+  # === rename
+  # ========================================================================= #
+  def rename(a, b)
+    if File.exist? b
+      e "Can not rename to #{sfancy(b)} as that target already exists."
+    else
+      FileUtils.mv(a, b)
+    end
+  end
+
+  # ========================================================================= #
+  # === copy_recursively
+  # ========================================================================= #
+  def copy_recursively(
+      source,
+      target,
+      be_verbose = :be_verbose
+    )
+    BackupParadise.copy_recursively(
+      source, target, be_verbose
+    )
+  end; alias cpr copy_recursively # === cpr
+
+  # ========================================================================= #
+  # === rename_tab
+  #
+  # This method can be used to rename the tab of e. g. mrxvt or KDE konsole.
+  # ========================================================================= #
+  def rename_tab(
+      use_this_terminal     = :konsole, # or :mrxvt
+      use_this_as_new_title = 'Hello world!'
+    )
+    BackupParadise::Tab.rename_tab(
+      use_this_terminal,
+      use_this_as_new_title
+    )
+  end
+
+  # ========================================================================= #
+  # === set_target_mountpoint
+  # ========================================================================= #
+  def set_target_mountpoint(i)
+    i = i.to_s
+    case i
+    # ======================================================================= #
+    # Specify some shortcuts to be used here.
+    # ======================================================================= #
+    when '1',
+         '2',
+         '3',
+         '4',
+         '5',
+         '6',
+         '7',
+         '8',
+         '9',
+         'usb1',
+         'usb2',
+         'usb3',
+         'usb4',
+         'usb5',
+         'usb6'
+      i = i.dup if i.frozen?
+      if i.start_with? 'usb'
+        i.sub!(/^usb/,'')
+      elsif i.start_with? 'to'
+        i.sub!(/^to(-| |_)?usb/,'')
+      end
+      i = "/Mount/USB#{i}/"
+    end
+    BackupParadise.target_mountpoint = i
+  end; alias set_target_device            set_target_mountpoint # === set_target_device
+       alias set_backup_to_this_directory set_target_mountpoint # === set_backup_to_this_directory
+       alias set_target                   set_target_mountpoint # === set_target
+       alias set_main_target              set_target_mountpoint # === set_main_target
+
+  # ========================================================================= #
+  # === hh_mm_ss
+  # ========================================================================= #
+  def hh_mm_ss
+    ::Roebe::Time.hh_mm_ss # This will yield something like: "03:53:55"
+  end; alias current_time hh_mm_ss # === current_time
+
+end; end