pdf_paradise 0.1.66

data/lib/pdf_paradise/www/sinatra/app.rb

@@ -0,0 +1,276 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === PdfParadise::Sinatra
+# =========================================================================== #
+# require 'pdf_paradise/www/sinatra/app.rb'
+# PdfParadise.start_sinatra_interface
+# =========================================================================== #
+require 'sinatra/base.rb'
+require 'pdf_paradise'
+
+module PdfParadise
+
+class Sinatra < ::Sinatra::Base
+
+  require 'beautiful_url'
+
+  require 'pdf_paradise/sinatra/embeddable_interface.rb'
+  include PdfParadise::EmbeddableInterface
+
+  begin
+    require 'web_object'
+  rescue LoadError; end
+
+  include Colours
+
+  set :port, USE_THIS_PORT
+
+  # ========================================================================= #
+  # === PdfParadise::Sinatra.sub_routes?
+  # ========================================================================= #
+  def self.sub_routes?
+    PdfParadise::EmbeddableInterface.sub_routes?
+  end
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize
+    super()
+    reset
+    Dir.chdir('/home/Temp/') if File.directory? '/home/Temp'
+    if ::PdfParadise.is_on_roebe?
+      require 'open'
+      # ===================================================================== #
+      # Tell us which port will be used:
+      # ===================================================================== #
+      target = "http://localhost:#{USE_THIS_PORT}/"
+      e sfancy(target)
+      Thread.new {
+        Open.in_browser(target) {{ delay: '1.0 seconds' }}
+      }
+    end
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+  end
+
+  # ========================================================================= #
+  # === / Entry point                                              (root tag)
+  #
+  # This is the root of our web-application.
+  #
+  # http://localhost:5200
+  # ========================================================================= #
+  get('/'){
+    return_root_string
+  }
+
+  # ========================================================================= #
+  # === report_file_listing
+  # ========================================================================= #
+  def report_file_listing
+    _ = '<p style="padding:1em; font-size: larger">'.dup
+    _ << '<b>File listing from the directory: '+Dir.pwd+'</b><br><br>'
+    Dir['*'].select {|entry| File.file?(entry) }.each {|entry|
+      _ << "→ <b style=\"margin-left:3em\">#{entry}</b><br>"
+    }
+    _ << '</p>'
+    _
+  end
+
+  # =========================================================================== #
+  # === View (view tag)
+  #
+  # http://localhost:5200/view
+  # http://localhost:5200/overview
+  # =========================================================================== #
+  %w( /view /overview ).each {|path|
+  get(path) {
+    result = ''.dup
+    result << p(
+      'The <b style="color: darkblue">content</b> of <b>'+
+      PdfParadise.main_directory?.to_s+'</b> is:'
+    ).dup
+    all_pdf_files = Dir[
+      PdfParadise.main_directory?.to_s+'*.pdf'
+    ]
+    if all_pdf_files.empty?
+      result << 'No .pdf files were found.<br>'
+    else
+      all_pdf_files.each {|this_file|
+        result << HtmlTags.p(
+          '<span style="color: darkblue">'+
+          RARROW+
+          '</span> '+this_file,
+          css_style: 'margin-left:1.5em; font-weight: bold; font-size: larger'
+        )
+      }
+    end
+    result << html_then_title+
+              p(
+                '(Do not forget to remove .pdf files that you do not '\
+                'wish to autoconvert, from that directory.)'
+              )+
+      return_link_to_root
+    result
+  }
+  }
+
+  # ========================================================================= #
+  # === view
+  #
+  # http://localhost:5200/view
+  # ========================================================================= #
+  get('/view') { # view tag
+    return_view_string
+  }
+
+  # =========================================================================== #
+  # http://localhost:5200/title
+  #
+  # Show the title of the pdf file at hand.
+  # =========================================================================== #
+  get('/title/*'){ # n pdf pages
+    _ = web_params?
+    if _.is_a? Array
+      _ = _.first
+    end
+    if File.exist? _
+      title = PdfParadise.return_title_of_this_pdf_file(_).to_s
+      content = "This .pdf's file title is: <b>#{title}</b>."
+      if title.empty?
+        content = "This .pdf file has no title."
+      end 
+      result = p(
+        content
+      ).dup
+      result
+    else
+      html_start_then_title+
+      p("No file called #{_} exists.")
+    end
+  }
+
+  # =========================================================================== #
+  # http://localhost:5200/title
+  #
+  # Show how many pdf pages a pdf file has.
+  # =========================================================================== #
+  get('/title'){ # n pdf pages
+    route_to_this_action = '/title'
+    html_start_then_title
+    p('Provide the path to a <b>.pdf</b> file:')+
+    form(action: route_to_this_action, id: route_to_this_action.delete('/'), css_style: 'margin-left:2em; margin-top:2px') {
+      input_type_user_input+
+      br+
+      input_type_submit
+    }+
+    report_file_listing
+  }
+
+  # ========================================================================= #
+  # === /convert_single_pdf_file
+  #
+  # http://localhost:5200/convert_single_pdf_file/
+  # ========================================================================= #
+  get('/convert_single_pdf_file/*') {
+    user_input = web_params?
+    if params.has_key?('user_input')
+      user_input = params.fetch('user_input')
+    end
+    result = 
+    html_then_title+
+    p(
+      'Next attempting to work with the pdf file '\
+      'at `<b>'+user_input+'</b>`.<br>'
+    ).dup
+    if File.exist? user_input
+      path = PdfParadise.convert(user_input).to_s
+      result << br+
+                p(
+                  'The converted .pdf file(s) should now be '\
+                  'available at: <b>'+path+'</b>'
+                )
+    else
+      result << p(
+                  'Unfortunately no .pdf file exists at that path.'
+                )
+    end
+    result
+  }
+
+  # =========================================================================== #
+  # === /autoconvert
+  #
+  # http://localhost:5200/autoconvert
+  # =========================================================================== #
+  get('/autoconvert'){
+    # Start the autoconversion next, part of the PdfParadise project.
+    PdfParadise.autoconvert_pdf_files
+    result = p(
+      'Trying to autoconvert all .pdf files - look at <b>'+
+      PdfParadise.main_directory?.to_s+'</b> for results.'
+    ).dup
+    Dir[PdfParadise.main_directory?.to_s+'*.pdf'].each {|this_file|
+      result << p(this_file)
+    }
+    result << return_view_string
+    result
+  }
+
+  # =========================================================================== #
+  # http://localhost:5200/n_pdf_pages
+  #
+  # Show how many pdf pages a pdf file has.
+  # =========================================================================== #
+  get('/n_pdf_pages'){ # n pdf pages
+    return_n_pdf_pages
+  }
+
+  # =========================================================================== #
+  # === /n_pdf_pages
+  #
+  # http://localhost:5200/n_pdf_pages
+  #
+  # Show how many pdf pages a pdf file has.
+  # =========================================================================== #
+  get(sub_routes?[:n_pdf_pages]+'/*'){ # n pdf pages
+    _ = web_params_as_string?
+    _.prepend('/') unless _.start_with? '/'
+    if File.exist? _
+      result = html_start_then_title+
+      p(
+        'This .pdf file (at <b>'+_+'</b>) has <b>'+
+        PdfParadise.n_pages?(_).to_s+'</b> pages.'
+      ).dup
+      result
+    else
+      html_start_then_title+
+      p('No file called '+_+' exists.')
+    end
+  }
+
+end
+
+# =========================================================================== #
+# === PdfParadise.start_sinatra_interface
+#
+# This method can be used to start the sinatra interface of the
+# PdfParadise project.
+# =========================================================================== #
+def self.start_sinatra_interface
+  e 'Starting the sinatra-interface of the PdfParadise project next.'
+  ::PdfParadise::Sinatra.run!
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  PdfParadise.start_sinatra_interface
+end

data/lib/pdf_paradise/yaml/working_on_these_pdf_files.yml

@@ -0,0 +1,4 @@
+---
+- "/home/x/books/NANO_TECHNOLOGY/DONE_Drexler_K.E._Engines_of_Creation_2.0_The_Coming_Era_of_Nanotechnology_2006.pdf"
+- "/home/x/books/GENETICS/DONE_Jochen_Graw_auth._Genetik-Springer_Spektrum_2015.pdf"
+- "/home/x/books/MICROBIOLOGY_IMMUNOLOGY_AND_VACCINATION/DONE_Immunulogie_für_Einsteiger_2015.pdf"

data/lib/pdf_paradise.rb

@@ -0,0 +1,5 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'pdf_paradise/requires/require_the_whole_project.rb'

data/pdf_paradise.gemspec

@@ -0,0 +1,61 @@
+# =========================================================================== #
+# Gemspec for Project PdfParadise.
+# =========================================================================== #
+require 'pdf_paradise/version/version.rb'
+require 'roebe/toplevel_methods/misc.rb'
+
+Gem::Specification.new { |s|
+
+  s.name    = 'pdf_paradise'
+  s.version = PdfParadise::VERSION
+  s.date    = Time.now.strftime('%Y-%m-%d')
+  
+  DESCRIPTION = <<-EOF
+
+This gem is called pdf_paradise.
+
+It attempts to be a swiss army knife, a wrapper, over pdf-related
+functionality in general, by tapping into external projects, 
+such as prawn, qpdf and so forth.
+
+For more information, please have a look at the documentation
+of the project on the homepage of this gem, at:
+
+https://www.rubydoc.info/gems/pdf_paradise/
+
+  EOF
+  
+  s.summary     = DESCRIPTION
+  s.description = DESCRIPTION
+
+  # ========================================================================= #
+  # Show this when a user installs this project.
+  # ========================================================================= #
+  s.post_install_message = <<-EOF
+
+  You can use this project to manipulate .pdf files.
+
+  You can find out the amount of pages in a .pdf file, you can use
+  it to merge pdf files and so on and so forth.
+
+  EOF
+
+  s.authors  = ['Robert A. Heiler']
+  s.email    = Roebe.email?
+  s.files    = Dir['**/*']
+  s.license  = 'GPL-2.0'
+  s.homepage = 'https://rubygems.org/gems/pdf_paradise'
+
+  s.required_ruby_version     = '>= '+Roebe.third_most_stable_version_of_ruby
+  s.required_rubygems_version = '>= '+Gem::VERSION
+  s.rubygems_version          = '>= '+Gem::VERSION
+
+  # ========================================================================= #
+  # External dependencies for the project:
+  # ========================================================================= #
+  s.add_dependency 'cliner'
+  s.add_dependency 'colours'
+  s.add_dependency 'opn'
+  s.add_dependency 'save_file'
+
+}

data/test/testing_pdf_paradise.rb

@@ -0,0 +1,9 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'colours/colours_e_autoinclude.rb'
+require 'pdf_paradise'
+e
+e Colours.rev+'Now testing the project called '+sfancy('pdf_paradise')+'.'
+e

metadata

@@ -0,0 +1,219 @@
+--- !ruby/object:Gem::Specification
+name: pdf_paradise
+version: !ruby/object:Gem::Version
+  version: 0.1.66
+platform: ruby
+authors:
+- Robert A. Heiler
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2022-09-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: cliner
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: colours
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: opn
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: save_file
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: "\nThis gem is called pdf_paradise.\n\nIt attempts to be a swiss army
+  knife, a wrapper, over pdf-related\nfunctionality in general, by tapping into external
+  projects, \nsuch as prawn, qpdf and so forth.\n\nFor more information, please have
+  a look at the documentation\nof the project on the homepage of this gem, at:\n\nhttps://www.rubydoc.info/gems/pdf_paradise/\n\n"
+email: shevy@inbox.lt
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- bin/automatic_pdf_title
+- bin/combine_these_pdf_pages
+- bin/compress_via_hexapdf
+- bin/convert_markdown_to_pdf
+- bin/convert_pdf_to_text
+- bin/delete_first_page_of_this_pdf_file
+- bin/merge_then_open
+- bin/n_pages
+- bin/open_main_pdf
+- bin/pdf_paradise
+- bin/set_main_book
+- bin/set_title_of_this_pdf_file
+- doc/README.gen
+- doc/todo/todo.md
+- lib/pdf_paradise.rb
+- lib/pdf_paradise/base/base.rb
+- lib/pdf_paradise/base/colours.rb
+- lib/pdf_paradise/commandline/commandline.rb
+- lib/pdf_paradise/commandline/help.rb
+- lib/pdf_paradise/commandline/menu.rb
+- lib/pdf_paradise/compress/compress_via_hexapdf.rb
+- lib/pdf_paradise/compress_this_pdf_file.rb
+- lib/pdf_paradise/constants/constants.rb
+- lib/pdf_paradise/convert_text_to_pdf.rb
+- lib/pdf_paradise/css/project.css
+- lib/pdf_paradise/djvu_to_pdf.rb
+- lib/pdf_paradise/gui/README.md
+- lib/pdf_paradise/gui/fox/split_pdf_file.rb
+- lib/pdf_paradise/gui/gtk2/delete_the_first_or_the_last_page_of_this_pdf_file/delete_the_first_or_the_last_page_of_this_pdf_file.rb
+- lib/pdf_paradise/gui/gtk2/pdf_viewer/pdf_viewer.rb
+- lib/pdf_paradise/gui/gtk2/split_pdf_file/split_pdf_file.rb
+- lib/pdf_paradise/gui/gtk2/statistics_widget/statistics_widget.rb
+- lib/pdf_paradise/gui/gtk2/to_pdf/to_pdf.rb
+- lib/pdf_paradise/gui/gtk3/controller/controller.rb
+- lib/pdf_paradise/gui/gtk3/convert_pdf_to_text/convert_pdf_to_text.rb
+- lib/pdf_paradise/gui/gtk3/delete_the_first_or_the_last_page_of_this_pdf_file/delete_the_first_or_the_last_page_of_this_pdf_file.rb
+- lib/pdf_paradise/gui/gtk3/pdf_viewer/pdf_viewer.rb
+- lib/pdf_paradise/gui/gtk3/split_pdf_file/split_pdf_file.rb
+- lib/pdf_paradise/gui/gtk3/statistics_widget/statistics_widget.rb
+- lib/pdf_paradise/gui/gtk3/to_pdf/to_pdf.rb
+- lib/pdf_paradise/gui/libui/extract_all_images_from_this_pdf_file/extract_all_images_from_this_pdf_file.rb
+- lib/pdf_paradise/gui/libui/statistics_widget/statistics_widget.rb
+- lib/pdf_paradise/gui/shared_code/convert_pdf_to_text/convert_pdf_to_text_module.rb
+- lib/pdf_paradise/gui/shared_code/delete_the_first_or_the_last_page_of_this_pdf_file/delete_the_first_or_the_last_page_of_this_pdf_file_module.rb
+- lib/pdf_paradise/gui/shared_code/pdf_viewer/pdf_viewer.css
+- lib/pdf_paradise/gui/shared_code/pdf_viewer/pdf_viewer_module.rb
+- lib/pdf_paradise/gui/shared_code/split_pdf_file/split_pdf_file.css
+- lib/pdf_paradise/gui/shared_code/split_pdf_file/split_pdf_file_module.rb
+- lib/pdf_paradise/gui/shared_code/statistics_widget/statistics_widget_module.rb
+- lib/pdf_paradise/gui/shared_code/to_pdf/to_pdf_module.rb
+- lib/pdf_paradise/hexapdf/001_rainbow_pattern_example.rb
+- lib/pdf_paradise/hexapdf/hexapdf.rb
+- lib/pdf_paradise/images/PDF_PARADISE_LOGO.png
+- lib/pdf_paradise/main_pdf/main_pdf.rb
+- lib/pdf_paradise/merge_pdf/menu.rb
+- lib/pdf_paradise/merge_pdf/merge_pdf.rb
+- lib/pdf_paradise/merge_pdf_namespace.rb
+- lib/pdf_paradise/merge_then_open/merge_then_open.rb
+- lib/pdf_paradise/pdf_file_n_total_pages.rb
+- lib/pdf_paradise/prawn_addons/README.md
+- lib/pdf_paradise/prawn_addons/prawn_addons.rb
+- lib/pdf_paradise/project/project.rb
+- lib/pdf_paradise/remove_pdf_password.rb
+- lib/pdf_paradise/requires/batch_require_toplevel_files.rb
+- lib/pdf_paradise/requires/colours.rb
+- lib/pdf_paradise/requires/colours_and_esystem_and_save_file_and_fileutils_and_opn.rb
+- lib/pdf_paradise/requires/esystem_and_colours.rb
+- lib/pdf_paradise/requires/esystem_and_opn_and_colours.rb
+- lib/pdf_paradise/requires/require_the_whole_project.rb
+- lib/pdf_paradise/requires/require_utility_scripts.rb
+- lib/pdf_paradise/set_main_book.rb
+- lib/pdf_paradise/set_pdf_title.rb
+- lib/pdf_paradise/sinatra/embeddable_interface.rb
+- lib/pdf_paradise/toplevel_methods/automatic_pdf_title.rb
+- lib/pdf_paradise/toplevel_methods/convert_epub_to_pdf.rb
+- lib/pdf_paradise/toplevel_methods/convert_markdown_to_pdf.rb
+- lib/pdf_paradise/toplevel_methods/convert_ppt_to_pdf.rb
+- lib/pdf_paradise/toplevel_methods/e.rb
+- lib/pdf_paradise/toplevel_methods/esystem.rb
+- lib/pdf_paradise/toplevel_methods/misc.rb
+- lib/pdf_paradise/toplevel_methods/number_pages.rb
+- lib/pdf_paradise/toplevel_methods/opened_pdf_files.rb
+- lib/pdf_paradise/toplevel_methods/query_pdf_title.rb
+- lib/pdf_paradise/toplevel_methods/reduce_size_of_this_pdf_file.rb
+- lib/pdf_paradise/toplevel_methods/roebe.rb
+- lib/pdf_paradise/toplevel_methods/rotate_pdf_file.rb
+- lib/pdf_paradise/toplevel_methods/to_pdf.rb
+- lib/pdf_paradise/utility_scripts/README.md
+- lib/pdf_paradise/utility_scripts/combine_these_pdf_pages.rb
+- lib/pdf_paradise/utility_scripts/convert_pdf_to_text.rb
+- lib/pdf_paradise/utility_scripts/delete_first_page_of_this_pdf_file.rb
+- lib/pdf_paradise/utility_scripts/delete_last_page_of_this_pdf_file.rb
+- lib/pdf_paradise/utility_scripts/delete_this_page_of_this_pdf_file.rb
+- lib/pdf_paradise/utility_scripts/extract_all_images_from_this_pdf_file.rb
+- lib/pdf_paradise/utility_scripts/extract_pdf_page.rb
+- lib/pdf_paradise/utility_scripts/pdf_optimizer.rb
+- lib/pdf_paradise/utility_scripts/pdf_statistics.rb
+- lib/pdf_paradise/utility_scripts/pdf_to_html.rb
+- lib/pdf_paradise/utility_scripts/remove_images.rb
+- lib/pdf_paradise/utility_scripts/split_pdf.rb
+- lib/pdf_paradise/utility_scripts/to_qdf.rb
+- lib/pdf_paradise/version/version.rb
+- lib/pdf_paradise/www/README.md
+- lib/pdf_paradise/www/sinatra/app.rb
+- lib/pdf_paradise/yaml/working_on_these_pdf_files.yml
+- pdf_paradise.gemspec
+- test/testing_pdf_paradise.rb
+homepage: https://rubygems.org/gems/pdf_paradise
+licenses:
+- GPL-2.0
+metadata: {}
+post_install_message: |2+
+
+    You can use this project to manipulate .pdf files.
+
+    You can find out the amount of pages in a .pdf file, you can use
+    it to merge pdf files and so on and so forth.
+
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.6
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.7
+requirements: []
+rubygems_version: 3.3.7
+signing_key:
+specification_version: 4
+summary: 'This gem is called pdf_paradise.  It attempts to be a swiss army knife,
+  a wrapper, over pdf-related functionality in general, by tapping into external projects,  such
+  as prawn, qpdf and so forth.  For more information, please have a look at the documentation
+  of the project on the homepage of this gem, at:  https://www.rubydoc.info/gems/pdf_paradise/'
+test_files: []
+...