pdf_paradise 0.3.20

data/lib/pdf_paradise/merge_pdf/merge_pdf.rb

@@ -0,0 +1,307 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === PdfParadise::MergePdf
+#
+# This class will merge together some .pdf files.
+#
+# Usage example:
+#
+#   PdfParadise::MergePdf.new(ARGV)
+#
+# =========================================================================== #
+# require 'pdf_paradise/merge_pdf/merge_pdf.rb'
+# =========================================================================== #
+require 'pdf_paradise/base/base.rb'
+
+module PdfParadise
+
+class MergePdf < Base # === PdfParadise::MergePdf
+
+  require 'pdf_paradise/merge_pdf/menu.rb'
+
+  # ========================================================================= #
+  # === THIS_FILE_HERE
+  # ========================================================================= #
+  THIS_FILE_HERE =
+    '/home/x/programming/ruby/src/pdf_paradise/lib/pdf_paradise/merge_pdf/merge_pdf.rb'
+
+  # ========================================================================= #
+  # === STORE_WHERE_WE_MERGED_FILES
+  # ========================================================================= #
+  STORE_WHERE_WE_MERGED_FILES =
+    '/home/Temp/merged_these_pdf_files.md'
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      i           = nil,
+      run_already = true
+    )
+    reset
+    set_commandline_arguments(
+      return_hyphen_arguments(i)
+    )
+    case i
+    # ======================================================================= #
+    # === :dont_run_yet
+    # ======================================================================= #
+    when :dont_run_yet
+      run_already = false
+    else
+      set_array_pdf_files(i)
+    end
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    infer_the_namespace
+    # ======================================================================= #
+    # === @array_pdf_files
+    # ======================================================================= #
+    @array_pdf_files = []
+    # ======================================================================= #
+    # === @use_this_program_for_merging_the_pdf_files
+    #
+    # Currently we can either use :ghostscript (gs) or :hexapdf. The
+    # latter is a pure ruby-gem.
+    # ======================================================================= #
+    @use_this_program_for_merging_the_pdf_files = :hexapdf # :ghostscript
+    set_output_filename
+  end
+
+  # ========================================================================= #
+  # === show_help                                                  (help tag)
+  # ========================================================================= #
+  def show_help
+    e
+    e 'To remove the merged files, do this:'
+    e
+    e '  mergepdf --remove'
+    e
+    e 'To use hexapdf:'
+    e
+    e '  mergepdf --use-hexapdf'
+    e
+    e 'To use ghostscript:'
+    e
+    e '  mergepdf --use-ghostscript'
+    e
+  end
+
+  # ========================================================================= #
+  # === remove_merged_files                                      (remove tag)
+  # ========================================================================= #
+  def remove_merged_files
+    _ = where_are_the_merged_files?
+    opnn; e 'We will now remove the merged files, by reading '\
+            'in from `'+sfile(_)+'`.'
+    # ======================================================================= #
+    # Read in that save-file next. As of Feb 2015, the format is
+    # one-file-per-line. We also get rid of '"' characters.
+    # ======================================================================= #
+    _ = File.readlines(_).map {|entry|
+      entry.chomp.delete('"')
+    } # .split(' ')
+    _.each {|file| delete(file) }
+  end
+
+  # ========================================================================= #
+  # === open_this_file_here
+  # ========================================================================= #
+  def open_this_file_here
+    _ = 'bluefish '+THIS_FILE_HERE
+    esystem _
+  end
+
+  # ========================================================================= #
+  # === do_conversion
+  #
+  # This method will do the actual conversion.
+  # ========================================================================= #
+  def do_conversion
+    these_files = @array_pdf_files.join(N)
+    # ======================================================================= #
+    # Next, we store this in the save-file.
+    # ======================================================================= #
+    write_what_into(these_files, where_are_the_merged_files?)
+    case @use_this_program_for_merging_the_pdf_files
+    # ======================================================================= #
+    # === :hexapdf
+    # ======================================================================= #
+    when :hexapdf
+      _ = 'hexapdf merge --force '.dup
+      _ << these_files.tr(N,' ')
+      _ << " #{@output_filename}"
+    # ======================================================================= #
+    # === :ghostscript
+    #
+    # To use this via the commandline, try:
+    #
+    #   mergepdf one.pdf two.pdf --use-ghostscript
+    #
+    # ======================================================================= #
+    when :ghostscript,
+         :default
+      _ = 'gs -dNOPAUSE -sDEVICE=pdfwrite -sOUTPUTFILE="'+
+          @output_filename+
+          '" -dBATCH '
+      _ << these_files.tr(N,' ')
+    end
+    e
+    cliner
+    e "#{::Colours.rev}We will run this command next for "\
+      "#{@array_pdf_files.size.to_s} .pdf files:"
+    e
+    efancy "  #{_}" # This is the command we will run.
+    e
+    system _
+    cliner
+  end
+
+  # ========================================================================= #
+  # === where_are_the_merged_files?
+  # ========================================================================= #
+  def where_are_the_merged_files?
+    STORE_WHERE_WE_MERGED_FILES
+  end
+
+  # ========================================================================= #
+  # === delete
+  # ========================================================================= #
+  def delete(i)
+    unless i == '/'
+      efancy(" - #{i}") # Add a slight padding to the output.
+      File.delete(i) if File.exist? i # Safeguard.
+    end
+  end
+
+  # ========================================================================= #
+  # === pad_this
+  # ========================================================================= #
+  def pad_this(i)
+    return '"'+i+'"'
+  end
+
+  # ========================================================================= #
+  # === set_array_pdf_files
+  # ========================================================================= #
+  def set_array_pdf_files(i = '')
+    if i and i.is_a?(String) and i.include?(' ')
+      # ===================================================================== #
+      # Do automatic splitting in this case.
+      # ===================================================================== #
+      i = i.split(' ')
+    end
+    i = [i].flatten.compact.reject {|entry| entry.start_with?('--') }
+    if i.is_a?(Array) and i.empty?
+      all_pdf_files = Dir['*.pdf']
+      # ===================================================================== #
+      # Try to use all .pdf files.
+      # ===================================================================== #
+      unless all_pdf_files.empty?
+        opnn; e 'No specific input was given, thus using all '+
+                 sfancy(all_pdf_files.size.to_s)+' .pdf files '\
+                'in this directory'
+        i = all_pdf_files
+      end
+    end
+    if i.is_a? Array # Keep only files that exist.
+      i.select! {|entry| File.exist? entry }
+    end
+    if i.is_a? Array
+      i.map! {|entry| pad_this(entry) }
+    end
+    if i.empty?
+      opnn; ewarn 'Unable to find any existing files '\
+                  'to match to, thus exiting now.'
+      exit
+    end
+    @array_pdf_files << i
+    @array_pdf_files = @array_pdf_files.flatten # Always keep it flattened.
+  end; alias << set_array_pdf_files # === <<
+
+  # ========================================================================= #
+  # === set_output_filename
+  #
+  # Store the filename of the pdf through this method, the name of
+  # the output file.
+  # ========================================================================= #
+  def set_output_filename(
+      i = 'Merged_PDF_Files.pdf'
+    )
+    if i.size > 40
+      opnn; ewarn 'The name for the new filename is larger than 255.'
+      opnn; ewarn 'We will thus truncate the name to the first 255 '\
+                  'characters instead.'
+      i = i[0, 41]
+      # ===================================================================== #
+      # Since as of Jun 2016, we will get rid of the last 4 characters
+      # and append '.pdf'
+      # ===================================================================== #
+      i[-4,4] = ''
+      i << '.pdf'
+    end
+    @output_filename = i
+  end; alias store_at set_output_filename # === store_at
+
+  # ========================================================================= #
+  # === opnn
+  # ========================================================================= #
+  def opnn
+    super(NAMESPACE)
+  end
+
+  # ========================================================================= #
+  # === feedback_where_it_is_stored
+  # ========================================================================= #
+  def feedback_where_it_is_stored
+    if File.exist? result?
+      opnn; e "The result is stored at `#{sfile(self.result)}`."
+    end
+  end; alias report feedback_where_it_is_stored # === report
+
+  # ========================================================================= #
+  # === output_filename
+  # ========================================================================= #
+  def output_filename
+    _ = @output_filename
+    _ = _.join(', ') if _.is_a? Array
+    return _
+  end; alias result              output_filename # === result
+       alias result?             output_filename # === result?
+       alias output_filename?    output_filename # === output_filename?
+       alias output_file?        output_filename # === output_file?
+       alias where_it_is_stored? output_filename # === where_it_is_stored?
+
+  # ========================================================================= #
+  # === build_new_output_name_based_on_input
+  # ========================================================================= #
+  def build_new_output_name_based_on_input
+    _ = @array_pdf_files.map {|entry|
+          File.basename(entry).gsub(File.extname(entry), '')
+        }
+    _ = _.join(' ').gsub(/ /,'_').gsub(/\"/,'')+'.pdf'
+    set_output_filename(_)
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    menu
+    build_new_output_name_based_on_input
+    do_conversion
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  _ = PdfParadise::MergePdf.new(ARGV)
+  _.feedback_where_it_is_stored # Call it manually.
+end # merge_pdf

data/lib/pdf_paradise/merge_pdf_namespace.rb

@@ -0,0 +1,9 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'pdf_paradise/merge_pdf_namespace'
+# =========================================================================== #
+require 'pdf_paradise/requires/require_the_whole_project.rb'
+
+MergePdf = PdfParadise::MergePdf # Now the MergePdf namespace is available in the toplevel.

data/lib/pdf_paradise/merge_then_open/merge_then_open.rb

@@ -0,0 +1,105 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === PdfParadise::MergeThenOpen
+#
+# This will first merge different .pdf files, and then open the
+# newly generated .pdf file.
+#
+# Usage example:
+#
+#   PdfParadise::MergeThenOpen.new(ARGV)
+#
+# =========================================================================== #
+# require 'pdf_paradise/merge_then_open/merge_then_open.rb'
+# PdfParadise::MergeThenOpen.new(ARGV)
+# =========================================================================== #
+require 'pdf_paradise/merge_pdf/merge_pdf.rb'
+
+module PdfParadise
+
+class MergeThenOpen < Base # === PdfParadise::MergeThenOpen
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      commandline_arguments = nil,
+      run_already           = true
+    )
+    reset
+    set_commandline_arguments(
+      commandline_arguments
+    )
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+  end
+
+  # ========================================================================= #
+  # === opnn
+  # ========================================================================= #
+  def opnn(i = NAMESPACE)
+    super(i)
+  end
+
+  # ========================================================================= #
+  # === set_commandline_arguments
+  # ========================================================================= #
+  def set_commandline_arguments(i = '')
+    i = [i].flatten.compact
+    @commandline_arguments = i
+  end
+
+  # ========================================================================= #
+  # === commandline_arguments?
+  # ========================================================================= #
+  def commandline_arguments?
+    @commandline_arguments
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    merge_pdf = MergePdf.new(@commandline_arguments)
+    new_file = merge_pdf.output_file?
+    if File.exist? new_file
+      # ===================================================================== #
+      # We have to open this file next.
+      # ===================================================================== #
+      begin
+        require 'open'
+        if Object.const_defined? :Open
+          opnn; e "Opening #{sfile(new_file)} next."
+          Open.in_editor(new_file)
+        end
+      rescue LoadError; end
+    else
+      opnn; e "No file appears to exist at #{sfile(new_file)}."
+    end
+  end
+
+  # ========================================================================= #
+  # === PdfParadise::MergeThenOpen[]
+  # ========================================================================= #
+  def self.[](i = '')
+    new(i)
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  PdfParadise::MergeThenOpen.new(ARGV)
+end # mergethenopen

data/lib/pdf_paradise/prawn_addons/README.md

@@ -0,0 +1,2 @@
+This directory may contain some modifications to the prawn gem
+and Prawn namespace.

data/lib/pdf_paradise/prawn_addons/prawn_addons.rb

@@ -0,0 +1,17 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'pdf_paradise/prawn_addons/prawn_addons.rb'
+# =========================================================================== #
+if Object.const_defined? :Prawn
+
+module Prawn
+
+class Document
+
+  if respond_to? :start_new_page
+    alias add_page start_new_page
+  end
+
+end; end; end

data/lib/pdf_paradise/project/project.rb

@@ -0,0 +1,22 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'pdf_paradise/project/project.rb'
+# =========================================================================== #
+module PdfParadise
+
+  # ========================================================================= #
+  # === PdfParadise::PROJECT_BASE_DIRECTORY
+  # ========================================================================= #
+  PROJECT_BASE_DIRECTORY =
+    File.absolute_path("#{__dir__}/..")+'/'
+
+  # ========================================================================= #
+  # === PdfParadise.project_base_dir?
+  # ========================================================================= #
+  def self.project_base_dir?
+    PROJECT_BASE_DIRECTORY
+  end; self.instance_eval { alias project_base_directory? project_base_dir? } # === PdfParadise.project_base_directory?
+
+end