pdf_paradise 0.3.20

data/lib/pdf_paradise/gui/universal_widgets/delete_the_first_or_the_last_page_of_this_pdf_file/delete_the_first_or_the_last_page_of_this_pdf_file.rb

@@ -0,0 +1,776 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === PdfParadise::GUI::UniversalWidgets::DeleteTheFirstOrTheLastPageOfThisPdfFile
+#
+# This class is a simple gtk-GUI wrapper over the remove-first-page and
+# the remove-last-page functionality of the PdfParadise project.
+#
+# It also serves as a prototype for the jruby-SWING wrapper.
+#
+# Usage example:
+#
+#   PdfParadise::GUI::UniversalWidgets::DeleteTheFirstOrTheLastPageOfThisPdfFile.new(ARGV)
+#
+# =========================================================================== #
+# require 'pdf_paradise/gui/universal_widgets/statistics_widget/statistics_widget.rb'
+# =========================================================================== #
+require 'pdf_paradise/base/base.rb'
+
+module PdfParadise
+
+module GUI
+
+module UniversalWidgets
+
+class DeleteTheFirstOrTheLastPageOfThisPdfFile < ::PdfParadise::Base # === PdfParadise::GUI::UniversalWidgets::DeleteTheFirstOrTheLastPageOfThisPdfFile
+
+  require 'universal_widgets/base_module/base_module.rb'
+  include ::UniversalWidgets::BaseModule
+
+  require 'pdf_paradise/utility_scripts/delete_the_first_page_of_this_pdf_file/delete_the_first_page_of_this_pdf_file.rb'
+  require 'pdf_paradise/utility_scripts/delete_last_page_of_this_pdf_file.rb'
+  require 'pdf_paradise/utility_scripts/delete_this_page_of_this_pdf_file.rb'
+  require 'pdf_paradise/utility_scripts/pdf_file_n_total_pages.rb'
+
+  # ========================================================================= #
+  # === TITLE
+  # ========================================================================= #
+  TITLE = 'Remove a specific page from a .pdf file.'
+
+  # ========================================================================= #
+  # === DENOTE_WHICH_PDF_PAGE_IS_TO_BE_REMOVED
+  # ========================================================================= #
+  DENOTE_WHICH_PDF_PAGE_IS_TO_BE_REMOVED =
+    'Denote which .pdf page (as a number) is to be removed '
+
+  # ========================================================================= #
+  # === FONT_SIZE_LARGE
+  # ========================================================================= #
+  FONT_SIZE_LARGE = 30
+
+  # ========================================================================= #
+  # === FONT_SIZE
+  # ========================================================================= #
+  FONT_SIZE = 18
+
+  # ========================================================================= #
+  # === USE_THIS_FONT
+  # ========================================================================= #
+  USE_THIS_FONT = :dejavu_condensed_24
+
+  # ========================================================================= #
+  # === SMALLER_FONT
+  # ========================================================================= #
+  SMALLER_FONT  = :dejavu_condensed_22
+
+  # ========================================================================= #
+  # === HEIGHT_FOR_THE_SECOND_ENTRY
+  # ========================================================================= #
+  HEIGHT_FOR_THE_SECOND_ENTRY = 40
+
+  # ========================================================================= #
+  # === LABEL_SET_THE_PATH_TO_THE_PDF_FILE_BELOW_THIS_TEXT_HERE
+  # ========================================================================= #
+  LABEL_SET_THE_PATH_TO_THE_PDF_FILE_BELOW_THIS_TEXT_HERE =
+    'Set the path to the .pdf file below this text here.'
+
+  # ========================================================================= #
+  # === ARRAY_ADD_THESE_SHORTCUT_FOLDERS
+  # ========================================================================= #
+  ARRAY_ADD_THESE_SHORTCUT_FOLDERS = [
+    '/',
+    '/Depot/j/',
+    '/Depot/PDF/'
+  ]
+
+  # ========================================================================= #
+  # === USE_THIS_FONT_FOR_THE_DISPLAY_AREA
+  # ========================================================================= #
+  USE_THIS_FONT_FOR_THE_DISPLAY_AREA = 'DejaVu Sans Mono 18' # :hack_18
+
+  # ========================================================================= #
+  # === WIDTH
+  # ========================================================================= #
+  WIDTH = '52% or minimum 1500px'
+
+  # ========================================================================= #
+  # === HEIGHT
+  # ========================================================================= #
+  HEIGHT = '45% or minimum 500px'
+
+  # ========================================================================= #
+  # === LARGER_FONT
+  # ========================================================================= #
+  LARGER_FONT   = :hack_24
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      commandline_arguments = nil,
+      run_already           = true
+    )
+    super(:vertical) if use_gtk3?
+    determine_the_GUI_to_be_used(commandline_arguments) # This must come first, even before reset().
+    reset
+    set_commandline_arguments(
+      commandline_arguments
+    )
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super() if respond_to?(:super)
+    reset_the_base_module
+    reset_the_internal_variables
+    infer_the_namespace
+    # ======================================================================= #
+    # === @configuration
+    # ======================================================================= #
+    @configuration = [true, __dir__, namespace?]
+    # ======================================================================= #
+    # === Set the title, width, height and the font in use.
+    # ======================================================================= #
+    title_width_height_font(TITLE, WIDTH, HEIGHT, USE_THIS_FONT)
+    if use_gtk3?
+      append_project_css_file 
+      use_gtk_paradise_project_css_file
+    end  
+    infer_the_size_automatically
+  end
+
+  # ========================================================================= #
+  # === populate_the_grid                                          (grid tag)
+  # ========================================================================= #
+  def populate_the_grid(grid)
+    grid.full_row(return_set_the_path_to_the_pdf_file_below_widget)
+    grid.full_row(return_text_and_entry_remove_this_pdf_page)
+    grid.full_row(checkbox_shall_we_overwrite_the_original_pdf_file?)
+    grid.full_row(create_and_then_return_the_label_that_shows_how_many_pages_are_in_the_given_pdf_file)
+    grid.full_row(text_for_notifications?)
+  end
+
+  # ========================================================================= #
+  # === create_the_skeleton                        (create tag, skeleton tag)
+  # ========================================================================= #
+  def create_the_skeleton
+    create_the_entries
+    create_the_buttons
+    create_the_labels
+    create_the_checkboxes
+  end
+
+  # ========================================================================= #
+  # === connect_the_skeleton                                    (connect tag)
+  # ========================================================================= #
+  def connect_the_skeleton
+    abort_on_exception
+
+    outer_vbox = create_vbox
+
+    grid = default_grid # grid tag
+    grid.uniform_spacing(18)
+    populate_the_grid(grid)
+    right_side = create_vbox # right tag
+    right_side.minimal(@button_remove_the_first_page_of_the_pdf_file,     2)
+    right_side.minimal(@button_remove_the_last_page_of_the_pdf_file,      2)
+    right_side.minimal(@button_remove_the_specified_page_of_the_pdf_file, 2)
+    right_side.minimal(@button_pdf_viewer,                                2)
+    right_side.minimal(@button_file_chooser,                              2)
+    right_side.show_all
+    _ = drag_from_left_to_right(
+      grid,
+      right_side
+    )
+    outer_vbox.minimal(_)
+
+    window = create_window_or_runner(
+      widget: outer_vbox,
+      width:  width?,
+      height: height?,
+      title:  title?,
+      font:   font?
+    )
+
+    window.set_padding(padding?)
+    window.set_border_size(border_size?)
+    window.show_all
+    Thread.new {
+      sleep 0.001
+      main_entry?.do_focus
+    }
+    do_parse_the_commandline_arguments
+    run_main
+  end
+
+  # ========================================================================= #
+  # === create_the_file_chooser_button
+  # ========================================================================= #
+  def create_the_file_chooser_button
+    # ======================================================================= #
+    # === @button_file_chooser
+    # ======================================================================= #
+    @button_file_chooser = bold_button('🗄️ _Choose a file', self, :use_mnemonics) {
+      :open_file_chooser_dialog
+    }
+    @button_file_chooser.hint =
+      'Click this button to select a file. It will then appear in the '\
+      'entry on the top-left part of this widget.'
+    @button_file_chooser.clear_background
+    @button_file_chooser.skyblue
+    @button_file_chooser.bblack2
+  end
+
+  # ========================================================================= #
+  # === create_the_remove_the_specified_page_of_the_pdf_file_button
+  # ========================================================================= #
+  def create_the_remove_the_specified_page_of_the_pdf_file_button
+    _ = bold_button('Remove the _specified page')
+    _.clear_background
+    _.skyblue
+    _.bblack2
+    _.do_use_mnemonic
+    _.hint = 
+      "  <b>Click</b> on this button to remove the specified page of the pdf file.\n"\
+      "Do not forget to make sure that the .pdf file exists at that location, in "\
+      "the top-left entry; and make sure that a number is input in the second "\
+      "entry below."
+    _.on_clicked {
+      do_determine_how_many_pages_are_in_the_pdf_file
+      do_remove_the_specified_page_of_the_pdf_file
+      do_determine_how_many_pages_are_in_the_pdf_file
+    }
+    @button_remove_the_specified_page_of_the_pdf_file = _
+  end
+
+  # ========================================================================= #
+  # === create_the_remove_the_last_page_of_the_pdf_file_button
+  # ========================================================================= #
+  def create_the_remove_the_last_page_of_the_pdf_file_button
+    # ======================================================================= #
+    # === @button_remove_the_last_page_of_the_pdf_file
+    # ======================================================================= #
+    @button_remove_the_last_page_of_the_pdf_file = bold_button('Remove the _last page')
+    @button_remove_the_last_page_of_the_pdf_file.clear_background
+    @button_remove_the_last_page_of_the_pdf_file.skyblue
+    @button_remove_the_last_page_of_the_pdf_file.bblack2
+    @button_remove_the_last_page_of_the_pdf_file.do_use_mnemonic
+    @button_remove_the_last_page_of_the_pdf_file.hint = 
+      "  <b>Click</b> on this button to remove the last page of the pdf file.\n"\
+      "Do not forget to make sure that the .pdf file exists at that location."
+    @button_remove_the_last_page_of_the_pdf_file.on_clicked {
+      do_determine_how_many_pages_are_in_the_pdf_file
+      do_remove_the_last_page_of_the_pdf_file
+      do_determine_how_many_pages_are_in_the_pdf_file
+    }
+  end
+
+  # ========================================================================= #
+  # === do_determine_how_many_pages_are_in_the_pdf_file
+  #
+  # This method should ideally be called only when the .pdf file at hand
+  # exists. 
+  # ========================================================================= #
+  def do_determine_how_many_pages_are_in_the_pdf_file
+    main_entry = main_entry?
+    if main_entry and main_entry.respond_to?(:text?)
+      this_file = main_entry?.text?.to_s
+      if File.exist? this_file
+        n_pages = PdfParadise.n_pages_in_this_pdf_file?(this_file)
+        _ = 'The <b>.pdf</b> file at <b>'+this_file+'</b> contains '\
+            '<b>'+n_pages.to_s+'</b> pages.'
+        @label_n_pages_in_the_pdf_file.set_text(_)
+      else
+        @label_n_pages_in_the_pdf_file.set_text('')
+      end
+      @label_n_pages_in_the_pdf_file.do_markify
+      @label_n_pages_in_the_pdf_file.make_selectable
+    end
+  end; alias update_n_pages do_determine_how_many_pages_are_in_the_pdf_file # === update_n_pages
+
+  # ========================================================================= #
+  # === do_remove_this_page
+  # ========================================================================= #
+  def do_remove_this_page(
+     i           = entry_remove_this_pdf_page?.text?,
+     target_file = entry_for_the_path_to_the_pdf_file?.text.to_s
+    )
+    if File.exist?(target_file)
+      PdfParadise.remove_this_page_of_that_pdf_file(
+        i, target_file
+      )
+      update_all_done_finished_at
+    else
+      no_file_was_found_at(target_file)
+    end
+  end
+
+  # ========================================================================= #
+  # === do_remove_the_first_page_of_the_pdf_file
+  #
+  # This is the main action of this class.
+  # ========================================================================= #
+  def do_remove_the_first_page_of_the_pdf_file
+    e 'Now removing the first .pdf page.'
+    target_file = entry_for_the_path_to_the_pdf_file?.text?
+    if File.exist?(target_file)
+      PdfParadise.remove_the_first_page_of_this_pdf_file(
+        target_file
+      )
+      # ===================================================================== #
+      # Notify the user that we finished here.
+      # ===================================================================== #
+      update_all_done_finished_at
+    else
+      no_file_was_found_at(target_file)
+    end
+  end
+
+  # ========================================================================= #
+  # === update_all_done_finished_at
+  # ========================================================================= #
+  def update_all_done_finished_at
+    @text_for_notifications.set_text(
+      'All done! Finished at <b>'+Time.now.to_s+'</b>'
+    )
+    @text_for_notifications.do_markify
+    @text_for_notifications.make_selectable
+  end
+
+  # ========================================================================= #
+  # === do_parse_the_commandline_arguments
+  # ========================================================================= #
+  def do_parse_the_commandline_arguments
+    commandline_arguments?.each {|this_entry|
+      if this_entry and File.exist?(this_entry)
+        this_entry = File.absolute_path(this_entry)
+        set_use_this_pdf_file(this_entry)
+      end
+    }
+  end
+
+  # ========================================================================= #
+  # === do_remove_the_specified_page_of_the_pdf_file
+  # ========================================================================= #
+  def do_remove_the_specified_page_of_the_pdf_file
+    _ = main_entry?.text?
+    this_page = which_page?
+    if File.exist? _
+      update_n_pages
+      if checkbox_shall_we_overwrite_the_original_pdf_file?.is_active?
+        PdfParadise.remove_this_page_from_that_pdf_file(this_page, _) {
+          :do_not_overwrite_the_original_pdf_file
+        }
+      else
+        PdfParadise.remove_this_page_from_that_pdf_file(this_page, _)
+      end
+      update_n_pages
+    end
+  end
+
+  # ========================================================================= #
+  # === checkbox_shall_we_overwrite_the_original_pdf_file
+  # ========================================================================= #
+  def checkbox_shall_we_overwrite_the_original_pdf_file?
+    @checkbox_shall_we_overwrite_the_original_pdf_file
+  end; alias main_checkbox? checkbox_shall_we_overwrite_the_original_pdf_file? # === main_checkbox?
+
+  # ========================================================================= #
+  # === create_the_checkboxes
+  # ========================================================================= #
+  def create_the_checkboxes
+    # ======================================================================= #
+    # === @checkbox_shall_we_overwrite_the_original_pdf_file
+    # ======================================================================= #
+    @checkbox_shall_we_overwrite_the_original_pdf_file = create_checkbox(:is_checked)
+    @checkbox_shall_we_overwrite_the_original_pdf_file.set_text(
+      'overwrite the original .pdf file'
+    )
+    @checkbox_shall_we_overwrite_the_original_pdf_file.hint =
+      'If this checkbox is active, then the original .pdf file '\
+      'will NOT be overwritten. This is sometimes necessary, such as '\
+      'on windows if you lack proper permission to do the file operation '\
+      'at hand.'
+  end
+
+  # ========================================================================= #
+  # === return_text_and_entry_remove_this_pdf_page
+  # ========================================================================= #
+  def return_text_and_entry_remove_this_pdf_page
+    _ = create_vbox
+    _.minimal(
+      left_aligned_bold_text(
+        DENOTE_WHICH_PDF_PAGE_IS_TO_BE_REMOVED
+      ), 4
+    )
+    mini_hbox = create_hbox
+    mini_hbox.maximal(@entry_remove_this_pdf_page,       4)
+    mini_hbox.minimal(@button_remove_the_specified_page, 4)
+    _.maximal(mini_hbox)
+    return _
+  end
+
+  # ========================================================================= #
+  # === return_set_the_path_to_the_pdf_file_below_widget
+  # ========================================================================= #
+  def return_set_the_path_to_the_pdf_file_below_widget
+    _ = create_vbox
+    create_the_text_above_the_main_entry
+    _.minimal(@text_above_the_main_entry, 4)
+    _.minimal(main_entry?,                4)
+    return _
+  end
+
+  # ========================================================================= #
+  # === open_file_chooser_dialog                                   (open tag)
+  # ========================================================================= #
+  def open_file_chooser_dialog
+    current_directory = return_pwd
+    if is_on_roebe? and File.directory?('/Depot/j/')
+      current_directory = '/Depot/j/'
+    end
+    filename = ::Gtk.select_file(parent_widget?) {{
+      current_directory:             current_directory,
+      show_hidden:                true,
+      extra_widget:               @extra_button,
+      add_these_shortcut_folders: ARRAY_ADD_THESE_SHORTCUT_FOLDERS,
+      use_this_file_filter:       '*.pdf'
+    }}
+    if filename and filename.end_with? '.pdf'
+      entry_for_the_path_to_the_pdf_file?.set_text(filename.to_s)
+      do_determine_how_many_pages_are_in_the_pdf_file
+    else
+      bold_popover_message = bold_text(
+        'Please assign an existing .pdf file in the top-left entry.'
+      )
+      bold_popover_message.set_font(default_font?)
+      popover_message(
+        bold_popover_message,
+        main_entry?
+      ).popup
+    end
+  end
+
+  # ========================================================================= #
+  # === which_page?
+  # ========================================================================= #
+  def which_page?
+    entry_remove_this_pdf_page?.text?.to_i
+  end
+
+  # ========================================================================= #
+  # === entry_for_the_path_to_the_pdf_file?
+  # ========================================================================= #
+  def entry_for_the_path_to_the_pdf_file?
+    @entry_for_the_path_to_the_pdf_file
+  end; alias main_entry? entry_for_the_path_to_the_pdf_file? # === main_entry?
+       alias top_entry?  entry_for_the_path_to_the_pdf_file? # === top_entry?
+
+  # ========================================================================= #
+  # === set_use_this_pdf_file
+  # ========================================================================= #
+  def set_use_this_pdf_file(
+      i, main_entry = main_entry?
+    )
+    main_entry.set_text(i.to_s) if main_entry
+  end
+
+  # ========================================================================= #
+  # === padding?
+  # ========================================================================= #
+  def padding?
+    4
+  end
+
+  # ========================================================================= #
+  # === border_size?
+  # ========================================================================= #
+  def border_size?
+    2
+  end
+
+  # ========================================================================= #
+  # === entry_remove_this_pdf_page?
+  # ========================================================================= #
+  def entry_remove_this_pdf_page?
+    @entry_remove_this_pdf_page
+  end
+
+  # ========================================================================= #
+  # === default_font?
+  # ========================================================================= #
+  def default_font?
+    USE_THIS_FONT
+  end
+
+  # ========================================================================= #
+  # === create_the_labels
+  # ========================================================================= #
+  def create_the_labels
+    # ======================================================================= #
+    # === @text_for_notifications
+    # ======================================================================= #
+    @text_for_notifications = text
+  end
+
+  # ========================================================================= #
+  # === text_for_notifications?
+  # ========================================================================= #
+  def text_for_notifications?
+    @text_for_notifications
+  end
+
+  # ========================================================================= #
+  # === create_the_entries                                      (entries tag)
+  # ========================================================================= #
+  def create_the_entries
+    # ======================================================================= #
+    # === @entry_for_the_path_to_the_pdf_file
+    # ======================================================================= #
+    _ = create_entry('')
+    _.highlight_on_click_event
+    _.add_css_class('BG_floralwhite')
+    _.pad4px
+    _.width_height(200, HEIGHT_FOR_THE_SECOND_ENTRY)
+    @entry_for_the_path_to_the_pdf_file = _
+    # ======================================================================= #
+    # === @entry_remove_this_pdf_page
+    # ======================================================================= #
+    @entry_remove_this_pdf_page = create_entry
+    @entry_remove_this_pdf_page.highlight_on_click_event
+    @entry_remove_this_pdf_page.bblack1
+    @entry_remove_this_pdf_page.add_css_class(
+      'BG_floralwhite'
+    )
+    @entry_remove_this_pdf_page.align_to_the_center
+    @entry_remove_this_pdf_page.set_size_request(160, HEIGHT_FOR_THE_SECOND_ENTRY)
+  end; alias create_entries create_the_entries # === create_entries
+
+  # ========================================================================= #
+  # === button_remove_the_specified_page?
+  # ========================================================================= #
+  def button_remove_the_specified_page?
+    @button_remove_the_specified_page
+  end
+
+  # ========================================================================= #
+  # === parent_widget?
+  # ========================================================================= #
+  def parent_widget?
+    @parent_widget
+  end
+
+  # ========================================================================= #
+  # === set_parent_widget
+  # ========================================================================= #
+  def set_parent_widget(i)
+    @parent_widget = i
+  end
+
+  # ========================================================================= #
+  # === do_remove_the_last_page_of_the_pdf_file
+  # ========================================================================= #
+  def do_remove_the_last_page_of_the_pdf_file
+    e 'Now removing the last .pdf page.'
+    target_file = entry_for_the_path_to_the_pdf_file?.text.to_s
+    if File.exist?(target_file)
+      PdfParadise.remove_the_last_page_of_this_pdf_file(
+        target_file
+      )
+      # ===================================================================== #
+      # Notify the user that we finished here.
+      # ===================================================================== #
+      update_all_done_finished_at
+    else
+      no_file_was_found_at(target_file)
+    end
+  end
+
+  # ========================================================================= #
+  # === create_the_text_above_the_main_entry
+  # ========================================================================= #
+  def create_the_text_above_the_main_entry
+    # ======================================================================= #
+    # === @text_above_the_main_entry
+    # ======================================================================= #
+    @text_above_the_main_entry = bold_label(
+      LABEL_SET_THE_PATH_TO_THE_PDF_FILE_BELOW_THIS_TEXT_HERE
+    ) {{
+      tooltip: 'You need to supply the path to the .pdf file '\
+      'into the entry below this text.'
+    }}
+  end
+
+  # ========================================================================= #
+  # === create_the_buttons                                      (buttons tag)
+  #
+  # This method can be used to create all buttons in this small application.
+  # ========================================================================= #
+  def create_the_buttons
+    create_the_open_in_pdf_viewer_button
+    # ======================================================================= #
+    # === @button_remove_the_first_page_of_the_pdf_file
+    # ======================================================================= #
+    create_the_remove_the_first_page_of_the_pdf_file_button
+    # ======================================================================= #
+    # === @button_remove_the_last_page_of_the_pdf_file
+    # ======================================================================= #
+    create_the_remove_the_last_page_of_the_pdf_file_button
+    create_the_remove_the_specified_page_of_the_pdf_file_button
+    create_the_file_chooser_button
+    # ======================================================================= #
+    # === @button_remove_the_specified_page
+    # ======================================================================= #
+    create_the_remove_the_specified_page_button
+    # ======================================================================= #
+    # === @extra_button
+    # ======================================================================= #
+    @extra_button = button('_Extra button')
+    @extra_button.on_clicked { e ' > Extra button was clicked' }
+  end; alias create_buttons create_the_buttons # === create_buttons
+
+  # ========================================================================= #
+  # === create_the_remove_the_specified_page_button
+  # ========================================================================= #
+  def create_the_remove_the_specified_page_button
+    @button_remove_the_specified_page = button('🗙')
+    @button_remove_the_specified_page.hint =
+      'Click this button in order to remove the specified page '\
+      'from the .pdf document at hand.'
+    @button_remove_the_specified_page.on_clicked {
+      do_determine_how_many_pages_are_in_the_pdf_file
+      do_remove_this_page(entry_remove_this_pdf_page?.text?)
+      do_determine_how_many_pages_are_in_the_pdf_file
+    }
+    @button_remove_the_specified_page.set_size_request(100, HEIGHT_FOR_THE_SECOND_ENTRY)
+    @button_remove_the_specified_page.bblack1
+    @button_remove_the_specified_page.disallow_resizing
+    return @button_remove_the_specified_page
+  end
+
+  # ========================================================================= #
+  # === create_the_remove_the_first_page_of_the_pdf_file_button
+  # ========================================================================= #
+  def create_the_remove_the_first_page_of_the_pdf_file_button
+    _ = bold_button('Remove the _first page')
+    _.clear_background
+    _.skyblue
+    _.bblack2
+    _.do_use_mnemonic
+    _.hint = 
+      "<b>Click</b> on this button to remove the first page of the "\
+      "designated <b>.pdf</b> file.\n\n"\
+      "Do not forget to make sure that the .pdf file exists at that "\
+      "location.\n"\
+      "Note that the program called qpdf has to be installed as well."
+    _.on_clicked {
+      do_determine_how_many_pages_are_in_the_pdf_file
+      do_remove_the_first_page_of_the_pdf_file
+      do_determine_how_many_pages_are_in_the_pdf_file
+    }
+    @button_remove_the_first_page_of_the_pdf_file = _
+  end
+
+  # ========================================================================= #
+  # === create_and_then_return_the_label_that_shows_how_many_pages_are_in_the_given_pdf_file
+  # ========================================================================= #
+  def create_and_then_return_the_label_that_shows_how_many_pages_are_in_the_given_pdf_file
+    @label_n_pages_in_the_pdf_file = text
+    return @label_n_pages_in_the_pdf_file
+  end
+
+  # ========================================================================= #
+  # === create_the_open_in_pdf_viewer_button
+  # ========================================================================= #
+  def create_the_open_in_pdf_viewer_button
+    # ======================================================================= #
+    # === @button_file_chooser
+    # ======================================================================= #
+    @button_pdf_viewer = button('Open in pdf viewer')
+    @button_pdf_viewer.hint =
+      'Click this button to open the .pdf file in the pdf viewer.'
+    @button_pdf_viewer.clear_background
+    @button_pdf_viewer.skyblue
+    @button_pdf_viewer.bblack2
+    @button_pdf_viewer.on_clicked {
+      target_file = main_entry?.text?.to_s
+      if target_file and File.exist?(target_file)
+        do_determine_how_many_pages_are_in_the_pdf_file
+        system("evince #{target_file}")
+      else
+        bold_popover_message = bold_text(
+          'Please assign an existing .pdf file in the top-left entry.'
+        )
+        bold_popover_message.set_font(default_font?)
+        popover_message(
+          bold_popover_message,
+          main_entry?
+        ).popup
+      end
+    }
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    run_super
+  end
+
+  # ========================================================================= #
+  # === PdfParadise::GUI::Gtk::DeleteTheFirstOrTheLastPageOfThisPdfFile.run
+  # ========================================================================= #
+  def self.run(
+      i = ARGV
+    )
+    require 'gtk_paradise/run'
+    _ = ::PdfParadise::GUI::Gtk::DeleteTheFirstOrTheLastPageOfThisPdfFile.new(i)
+    r = ::Gtk.run
+    r << _
+    r.automatic_size
+    r.automatic_title
+    r.top_left_then_run
+  end
+
+  # ========================================================================= #
+  # === PdfParadise::GUI::UniversalWidgets::DeleteTheFirstOrTheLastPageOfThisPdfFile[]
+  # ========================================================================= #
+  def self.[](i = ARGV)
+    new(i)
+  end
+
+end; end; end
+
+# =========================================================================== #
+# === PdfParadise.return_widget_remove_first_page_of_pdf_file
+# =========================================================================== #
+def self.return_widget_remove_first_page_of_pdf_file
+  ::PdfParadise::GUI::Gtk::DeleteTheFirstOrTheLastPageOfThisPdfFile.new
+end
+
+# =========================================================================== #
+# === PdfParadise.start_gtk_gui_remove_first_page_of_pdf_file
+#
+# This is a simple toplevel method that can be used to start the
+# gtk3-GUI.
+# =========================================================================== #
+def self.start_gtk_gui_remove_first_page_of_pdf_file
+  require 'gtk_paradise/run'
+  _ = PdfParadise::GUI::Gtk::DeleteTheFirstOrTheLastPageOfThisPdfFile.new
+  r = ::Gtk.run
+  _.set_parent_widget(r)
+  r.easy_exit
+  r << _
+  r.top_left_then_run
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  PdfParadise::GUI::UniversalWidgets::DeleteTheFirstOrTheLastPageOfThisPdfFile.new(ARGV)
+end # gtk_todo_viewer