pdf_paradise 0.1.66

data/lib/pdf_paradise/base/base.rb

@@ -0,0 +1,239 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'pdf_paradise/base/base.rb'; < ::PdfParadise::Base
+# =========================================================================== #
+require 'pdf_paradise/requires/colours_and_esystem_and_save_file_and_fileutils_and_opn.rb'
+
+module PdfParadise
+
+class Base # === PdfParadise::Base
+
+  require 'yaml'
+  require 'fileutils'
+  require 'pdf_paradise/base/colours.rb'
+  require 'pdf_paradise/toplevel_methods/roebe.rb'
+  require 'pdf_paradise/constants/constants.rb'
+
+  begin
+    require 'cliner'
+  rescue LoadError; end
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize
+    reset
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+  end
+
+  # ========================================================================= #
+  # === no_file_at
+  #
+  # This method (or its alias) can be used to notify the user that the
+  # given file does not exist at that given location (denoted by the
+  # argument called i).
+  # ========================================================================= #
+  def no_file_at(i)
+    e "No file called `#{sfile(i)}` exists at that target."
+  end; alias no_file_exists_at no_file_at # === no_file_exists_at
+
+  # ========================================================================= #
+  # === is_on_roebe?
+  # ========================================================================= #
+  def is_on_roebe?
+    ::PdfParadise.is_on_roebe?
+  end
+
+  # ========================================================================= #
+  # === set_commandline_arguments
+  # ========================================================================= #
+  def set_commandline_arguments(i)
+    i = [i].flatten.compact
+    @commandline_arguments = i
+  end
+
+  # ========================================================================= #
+  # === return_files_from_the_commandline_arguments
+  #
+  # This method will return all existing files from the commandline
+  # arguments.
+  # ========================================================================= #
+  def return_files_from_the_commandline_arguments
+    @commandline_arguments.select {|entry|
+      File.file?(entry.to_s)
+    }
+  end
+
+  # ========================================================================= #
+  # === mv                                     (mv tag, move tag, rename tag)
+  # ========================================================================= #
+  def mv(old, new)
+    # ======================================================================= #
+    # We must check that both files exist, before we delete the new file,
+    # as we may otherwise end up without any .pdf file. This has happened
+    # to me in August 2019 when qpdf failed to do a conversion.
+    # ======================================================================= #
+    if File.file?(new) and File.file?(old)
+      File.delete(new)
+    end
+    if File.exist? old
+      FileUtils.mv(old, new)
+    else
+      e 'No file exists at '+sfile(old)+'.'
+    end
+  end; alias move_file mv # === move_file
+
+  # ========================================================================= #
+  # === return_pwd
+  # ========================================================================= #
+  def return_pwd
+    "#{Dir.pwd}/".squeeze('/')
+  end
+
+  # ========================================================================= #
+  # === commandline_arguments?
+  # ========================================================================= #
+  def commandline_arguments?
+    @commandline_arguments
+  end; alias input? commandline_arguments? # === input?
+
+  # ========================================================================= #
+  # === first_argument?
+  # ========================================================================= #
+  def first_argument?
+    @commandline_arguments.first
+  end
+
+  # ========================================================================= #
+  # === input_without_leading_hyphens?
+  #
+  # This method will return the input that will not begin with --.
+  # ========================================================================= #
+  def input_without_leading_hyphens?
+    @commandline_arguments.reject {|entry| entry.start_with? '--' }
+  end
+
+  # ========================================================================= #
+  # === return_commandline_arguments_starting_with_hyphens
+  # ========================================================================= #
+  def return_commandline_arguments_starting_with_hyphens(
+      i = @commandline_arguments
+    )
+    [i].flatten.select {|entry| entry.start_with? '--' }
+  end; alias return_hyphen_arguments return_commandline_arguments_starting_with_hyphens # === return_hyphen_arguments
+
+  # ========================================================================= #
+  # === mkdir
+  # ========================================================================= #
+  def mkdir(i)
+    FileUtils.mkdir_p(i)
+  end
+
+  # ========================================================================= #
+  # === copy_file
+  # ========================================================================= #
+  def copy_file(
+      from, to = (Dir.pwd+'/').squeeze('/')
+    )
+    if File.exist? from
+      FileUtils.cp(from, to)
+    end
+  end
+
+  # ========================================================================= #
+  # === change_directory                                             (cd tag)
+  # ========================================================================= #
+  def change_directory(i)
+    Dir.chdir(i) if File.directory?(i)
+  end; alias cd change_directory # === cd
+
+  # ========================================================================= #
+  # === delete_file
+  #
+  # This method can be used to delete a local file.
+  # ========================================================================= #
+  def delete_file(i)
+    begin
+      File.delete(i)
+    rescue Errno::EACCES => error
+      e 'Could not delete the file at '+i+' - reason '\
+        'being insufficient permission.'
+      e 'The error was:'
+      e
+      pp error
+      e
+    end
+  end
+
+  # ========================================================================= #
+  # === write_what_into
+  # ========================================================================= #
+  def write_what_into(
+      what, into
+    )
+    begin
+      require 'save_file/module' unless Object.const_defined?(:SaveFile)
+    rescue LoadError; end
+    if Object.const_defined?(:SaveFile)
+      SaveFile.write_what_into(what, into)
+    else
+      e 'Can not save into '+into+' as the save_file gem '\
+        'is not available/installed.'
+    end
+  end; alias save_what_into write_what_into # === save_what_into
+
+  # ========================================================================= #
+  # === n_pages?
+  #
+  # This method will return how many pages are in the given .pdf file at
+  # hand.
+  # ========================================================================= #
+  def n_pages?(i)
+    unless PdfParadise.const_defined? :PdfFileNTotalPages
+      require 'pdf_paradise/pdf_file_n_total_pages.rb'
+    end
+    ::PdfParadise.n_pdf_pages?(i) 
+  end
+
+  # ========================================================================= #
+  # === esystem
+  #
+  # This method can be used to execute system-commands.
+  # ========================================================================= #
+  def esystem(i)
+    e steelblue(i)
+    system(i)
+  end
+
+  # ========================================================================= #
+  # === opnn
+  # ========================================================================= #
+  def opnn(
+      i = @namespace
+    )
+    if i.is_a? String
+      i = { namespace: i }
+    end
+    Opn.opn(i)
+  end
+
+  # ========================================================================= #
+  # === log_dir?
+  # ========================================================================= #
+  def log_dir?
+    ::PdfParadise.log_dir?
+  end
+
+end; end

data/lib/pdf_paradise/base/colours.rb

@@ -0,0 +1,36 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'pdf_paradise/base/colours.rb'
+# =========================================================================== #
+require 'pdf_paradise/requires/colours_and_esystem_and_save_file_and_fileutils_and_opn.rb'
+
+module PdfParadise
+
+class Base # === PdfParadise::Base
+
+  include Colours
+
+  # ========================================================================= #
+  # === orange
+  # ========================================================================= #
+  def orange(i)
+    ::Colours.orange(i)
+  end
+
+  # ========================================================================= #
+  # === steelblue
+  # ========================================================================= #
+  def steelblue(i)
+    ::Colours.steelblue(i)
+  end
+
+  # ========================================================================= #
+  # === rev
+  # ========================================================================= #
+  def rev
+    ::Colours.rev
+  end
+
+end; end

data/lib/pdf_paradise/commandline/commandline.rb

@@ -0,0 +1,101 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'pdf_paradise/commandline/commandline.rb'
+# =========================================================================== #
+module PdfParadise
+
+  # ========================================================================= #
+  # === @commandline_arguments
+  # ========================================================================= #
+  @commandline_arguments = []
+
+  # ========================================================================= #
+  # === PdfParadise.set_commandline_arguments
+  # ========================================================================= #
+  def self.set_commandline_arguments(i)
+    i = [i].flatten.compact
+    # ======================================================================= #
+    # We will also check if a file with that name exists. If so we
+    # will replace it via File.absolute_path().
+    # ======================================================================= #
+    i.map! {|entry|
+      if File.exist?(entry)
+        entry = File.absolute_path(entry)
+      end
+      entry
+    }
+    @commandline_arguments = i
+  end
+
+  # ========================================================================= #
+  # === PdfParadise.commandline_arguments?
+  # ========================================================================= #
+  def self.commandline_arguments?
+    @commandline_arguments
+  end
+
+  # ========================================================================= #
+  # === @use_this_pdf_file
+  # ========================================================================= #
+  @use_this_pdf_file = nil
+
+  # ========================================================================= #
+  # === PdfParadise.set_use_this_pdf_file
+  # ========================================================================= #
+  def self.set_use_this_pdf_file(i)
+    @use_this_pdf_file = i.to_s.dup
+  end
+
+  # ========================================================================= #
+  # === PdfParadise.autoconvert_pdf_files_in_the_main_directory
+  # ========================================================================= #
+  def self.autoconvert_pdf_files_in_the_main_directory(
+      target = "#{AUTOCONVERT_PDF_FILES_RESIDING_IN_THIS_DIRECTORY}*.pdf"
+    )
+    require 'pdf_paradise/utility_scripts/split_pdf.rb'
+    all_pdf_files = Dir[target]
+    if all_pdf_files.empty?
+      e "No files found at #{target}."
+    else
+      all_pdf_files.each {|this_pdf_file|
+        PdfParadise.split_this_pdf_file(
+          this_pdf_file,
+          1,
+          AUTOCONVERT_PDF_FILES_RESIDING_IN_THIS_DIRECTORY
+        )
+      }
+    end
+  end; self.instance_eval { alias autoconvert_pdf_files autoconvert_pdf_files_in_the_main_directory } # === PdfParadise.autoconvert_pdf_files
+
+  # ========================================================================= #
+  # === PdfParadise.open_the_default_pdf_files
+  #
+  # To invoke this method, do:
+  #
+  #   pdfpa --open-pdf-files
+  #
+  # ========================================================================= #
+  def self.open_the_default_pdf_files(
+      use_this_file = ::PdfParadise.file_working_on_these_pdf_files
+    )
+    if File.exist? use_this_file
+      dataset = YAML.load_file(use_this_file)
+      dataset.each {|file|
+        esystem "atril #{file} &"
+      }
+    end
+  end
+
+  # ========================================================================= #
+  # === PdfParadise.start_the_most_important_libui_wrapper
+  # ========================================================================= #
+  def self.start_the_most_important_libui_wrapper(
+      optional_commandline_arguments = nil
+    )
+    require 'pdf_paradise/gui/libui/extract_all_images_from_this_pdf_file/extract_all_images_from_this_pdf_file.rb'
+    PdfParadise::GUI::LibUI::ExtractAllImagesFromThisPdfFile.new(optional_commandline_arguments)
+  end
+
+end

data/lib/pdf_paradise/commandline/help.rb

@@ -0,0 +1,73 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'pdf_paradise/commandline/help.rb'
+# =========================================================================== #
+module PdfParadise
+
+  # ========================================================================= #
+  # === PdfParadise.gold
+  # ========================================================================= #
+  def self.gold(i = '')
+    if Object.const_defined? :Colours
+      i = Colours.gold(i)
+    end
+    i
+  end
+
+  # ========================================================================= #
+  # === PdfParadise.show_help
+  #
+  # Show the documented help options of the PdfParadise project.
+  #
+  # To invoke this method from the commandline, do:
+  #
+  #   pdf_paradise --help
+  #
+  # ========================================================================= #
+  def self.show_help
+    e 'The available options are:'
+    e
+    e gold('  pdf_paradise --use-this-pdf-file=foobar.pdf --set_title="Hello world!"')
+    e
+    e "    ^^^ this can be used to modify a .pdf's title"
+    e
+    e gold('  pdf_paradise --shrink-pdf-size-of=foobar.pdf')
+    e
+    e "    ^^^ this can be used to shrinke a .pdf file"
+    e
+    e gold('  pdf_paradise --store-open-pdf-files')
+    e
+    e '    ^^^ store all currently open .pdf files into a local file.'
+    e
+    e gold('  pdf_paradise --open-last-pdf-files')
+    e
+    e '    ^^^ open the last opened .pdf files via a local PDF reader.'
+    e
+    e gold('  pdf_paradise --show_last_opened_pdf_files')
+    e
+    e '    ^^^ show which .pdf files were last open.'
+    e
+    e gold('  pdf_paradise --gui')
+    e gold('  pdf_paradise --gtk')
+    e
+    e '    ^^^ to start the ruby-gtk2 bindings for the pdf_paradise.'
+    e
+    e gold('  pdf_paradise --autoconvert')
+    e
+    e '    ^^^ to autoconvert all .pdf files in the main directory '\
+      'into standalone .pdf files.'
+    e
+    e gold('  pdf_paradise --sinatra')
+    e
+    e '    ^^^ start the (minimal) sinatra-interface of the pdf_paradise '\
+      'project'
+    e
+    e gold('  pdf_paradise --libui')
+    e
+    e '    ^^^ start the libui GUI'
+    e
+  end
+
+end

data/lib/pdf_paradise/commandline/menu.rb

@@ -0,0 +1,142 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'pdf_paradise/commandline/menu.rb'
+# =========================================================================== #
+module PdfParadise
+
+  require 'pdf_paradise/set_pdf_title.rb'
+  require 'pdf_paradise/toplevel_methods/e.rb'
+  require 'pdf_paradise/toplevel_methods/reduce_size_of_this_pdf_file.rb'
+  require 'pdf_paradise/toplevel_methods/opened_pdf_files.rb'
+  require 'pdf_paradise/commandline/commandline.rb'
+  require 'pdf_paradise/commandline/help.rb'
+
+  # ========================================================================= #
+  # === PdfParadise.menu                                           (menu tag)
+  # ========================================================================= #
+  def self.menu(i)
+    if i.is_a? Array
+      i.each {|entry| menu(entry) }
+    else
+      case i # case tag
+      # ===================================================================== #
+      # === pdfpa --libui
+      #
+      # This entry point will always refer to the most important 
+      # libui widget.
+      # ===================================================================== #
+      when /^-?-?libui$/
+        start_the_most_important_libui_wrapper(commandline_arguments?)
+      # ===================================================================== #
+      # === pdfpa --open-pdf-files
+      # ===================================================================== #
+      when /^-?-?open(-|_)?pdf(-|_)?files$/
+        open_the_default_pdf_files
+      # ===================================================================== #
+      # === pdfparadise --controller
+      # ===================================================================== #
+      when /^-?-?controller$/
+        require 'pdf_paradise/gui/gtk3/controller/controller.rb'
+        PdfParadise::GUI::Gtk::Controller.run
+      # ===================================================================== #
+      # === --use-this-pdf-file=DONE_Life_History_Evolution_WS_17_4.pdf
+      # ===================================================================== #
+      when /^-?-?use(-|_)?this(-|_)?pdf(-|_)?file=(.+)$/, # === $4
+           /^-?-?set(-|_)?pdf(-|_)?title=(.+)$/,          # === $3
+           /^-?-?use(-|_)?this(-|_)?title=(.+)$/          # === $4
+        i = $3 # <- This is for the second line ^^^.
+        i = $4 if $4 # <- And this is for the first line.
+        set_use_this_pdf_file(i)
+      # ===================================================================== #
+      # === pdf_paradise --sinatra
+      # ===================================================================== #
+      when /^-?-?sinatra$/i,
+           /^-?-?www$/i # === pdf_paradise --www
+        require 'pdf_paradise/www/sinatra/app.rb'
+        PdfParadise.start_sinatra_interface
+      # ===================================================================== #
+      # === pdf_paradise --autoconvert
+      # ===================================================================== #
+      when /^-?-?autoconvert$/i
+        autoconvert_pdf_files_in_the_main_directory
+      # ===================================================================== #
+      # === pdf_paradise --gui
+      # === pdf_paradise --gtk
+      # ===================================================================== #
+      when /^-?-?gui$/,
+           /^-?-?gtk$/
+        require 'pdf_paradise/gui/gtk2/split_pdf_file/split_pdf_file.rb'
+        PdfParadise.start_gtk_gui
+      # ===================================================================== #
+      # === pdf_paradise --show_last_opened_pdf_files
+      # ===================================================================== #
+      when /^-?-?show(-|_)?last(-|_)?opened(-|_)?pdf(-|_)?files$/i,
+           /^-?-?pdf(-|_)?file(-|_)?content$/i, # pdfparadise --pdf-file-content
+           /^-?-?last(-|_)?open(-|_)?pdf\??$/i,
+           /^-?-?last-pdf$/i,
+           /^-?-?last\??$/i,
+           /^-?-?pdf\??$/i # pdfparadise --pdf?
+        PdfParadise.show_last_opened_pdf_files
+      # ===================================================================== #
+      # === pdfparadise --store-open-pdf-files
+      # ===================================================================== #
+      when /^-?-?store(-|_| )?open(-|_| )?pdf(-|_| )?files$/,
+           /^-?-?store(-|_| )?open(-|_| )?pdfs?$/,
+           /^-?-?store(-|_| )?pdf(-|_| )?files$/,
+           /^-?-?store(-|_| )?pdfs$/
+        PdfParadise.store_all_currently_open_pdf_files
+      # ===================================================================== #
+      # === pdf_paradise --array-all-currently-opened-pdf-files
+      # ===================================================================== #
+      when /^-?-?array(-|_| )?all(-|_| )?currently(-|_| )?opened(-|_| )?pdf(-|_| )?files$/i,
+           /^-?-?show(-|_| )?currently(-|_| )?open(-|_| )?pdf(-|_| )?files$/i
+        PdfParadise.return_array_of_all_currently_opened_pdf_files(:do_not_run_locate).each {|entry|
+          e entry
+        }
+      # ===================================================================== #
+      # === pdfparadise --open-last-pdf-files
+      # ===================================================================== #
+      when /^-?-?open(-|_| )?last(-|_| )?pdf(-|_| )?files$/,
+           /^-?-?open(-|_| )?last(-|_| )?opened(-|_| )?pdf(-|_| )?files$/,
+           /^-?-?open(-|_| )?last(-|_| )?pdfs$/,
+           /^-?-?main$/, # <- This is the main task (main tag)
+           /^-?-?restore$/
+        PdfParadise.open_last_opened_pdf_files
+      # ===================================================================== #
+      # === pdf_paradise --shrink-pdf-size-of=foobar.pdf
+      # ===================================================================== #
+      when /^-?-?shrink(-|_)?pdf(-|_)?size(-|_)?of=(.+)/i,
+           /^-?-?shrink=(.+)/i
+        this_file = $1.to_s.dup
+        this_file = $4.to_s.dup if $4
+        reduce_size_of_this_pdf_file(this_file)
+      # ===================================================================== #
+      # === pdf_paradise --help
+      # ===================================================================== #
+      when /^-?-?help/
+        show_help
+      # ===================================================================== #
+      # === --set_title="Hello world!"
+      # ===================================================================== #
+      when /^--set(-|_)?title=(.+)$/,
+           /^--title=(.+)$/
+        # =================================================================== #
+        # @use_this_pdf_file has to have been set properly before calling
+        # this method.
+        # =================================================================== #
+        i = $1
+        i = $2 if $2
+        PdfParadise.set_title_of_this_pdf_file(@use_this_pdf_file, i)
+      else
+        e "Unknown command: #{i}" unless File.exist?(i)
+      end
+    end
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  PdfParadise.menu(ARGV)
+end

data/lib/pdf_paradise/compress/compress_via_hexapdf.rb

@@ -0,0 +1,27 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'pdf_paradise/compress/compress_via_hexapdf.rb'
+# PdfParadise.compress_via_pdf(ARGV)
+# =========================================================================== #
+module PdfParadise
+
+  # ========================================================================= #
+  # === PdfParadise.compress_via_pdf
+  # ========================================================================= #
+  def self.compress_via_pdf(
+      this_file = 'foobar.pdf'
+    )
+    if this_file.is_a? Array
+      this_file = this_file.first
+    end
+    require 'pdf_paradise/hexapdf/hexapdf.rb'
+    HexaPDF.optimize_this_pdf_file(this_file)
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  PdfParadise.compress_via_pdf(ARGV)
+end # rb $RUBY_SRC/pdf_paradise/lib/pdf_paradise/compress/compress_via_hexapdf.rb ack.pdf