# -*- encoding: utf-8; frozen_string_literal: true -*- # #-- # This file is part of HexaPDF. # # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby # Copyright (C) 2014-2020 Thomas Leitner # # HexaPDF is free software: you can redistribute it and/or modify it # under the terms of the GNU Affero General Public License version 3 as # published by the Free Software Foundation with the addition of the # following permission added to Section 15 as permitted in Section 7(a): # FOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY # THOMAS LEITNER, THOMAS LEITNER DISCLAIMS THE WARRANTY OF NON # INFRINGEMENT OF THIRD PARTY RIGHTS. # # HexaPDF is distributed in the hope that it will be useful, but WITHOUT # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or # FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public # License for more details. # # You should have received a copy of the GNU Affero General Public License # along with HexaPDF. If not, see . # # The interactive user interfaces in modified source and object code # versions of HexaPDF must display Appropriate Legal Notices, as required # under Section 5 of the GNU Affero General Public License version 3. # # In accordance with Section 7(b) of the GNU Affero General Public # License, a covered work must retain the producer line in every PDF that # is created or manipulated using HexaPDF. # # If the GNU Affero General Public License doesn't fit your need, # commercial licenses are available at . #++ require 'hexapdf/cli/command' module HexaPDF module CLI # Merges pages from multiple PDF files. class Merge < Command InputSpec = Struct.new(:file, :pages, :password) #:nodoc: def initialize #:nodoc: super('merge', takes_commands: false) short_desc("Merge multiple PDF files") long_desc(<<~EOF) This command merges pages from multiple PDFs into one output file which can optionally be encrypted/decrypted and optimized in various ways. The first input file is the primary input file from which meta data like file information, outlines, etc. are taken from. Alternatively, it is possible to start with an empty PDF file by using --empty. The order of the files is important as they are used in that order. Also note that the --password and --pages options apply to the last preceeding input file. EOF options.on(/.*/, "Input file, can be specified multiple times") do |file| @files << InputSpec.new(file, '1-e') throw :prune end options.on("-p", "--password PASSWORD", String, "The password for decrypting the last " \ "specified input file (use - for reading from standard input)") do |pwd| raise OptionParser::InvalidArgument, "(No prior input file specified)" if @files.empty? pwd = (pwd == '-' ? read_password("#{@files.last.file} password") : pwd) @files.last.password = pwd end options.on("-i", "--pages PAGES", "The pages of the last specified input file that " \ "should be used (default: 1-e)") do |pages| raise OptionParser::InvalidArgument, "(No prior input file specified)" if @files.empty? @files.last.pages = pages end options.on("-e", "--empty", "Use an empty file as the first input file") do @initial_empty = true end options.on("--[no-]interleave", "Interleave the pages from the input files (default: " \ "false)") do |c| @interleave = c end options.separator("") options.separator("Output related options") define_optimization_options define_encryption_options @files = [] @initial_empty = false @interleave = false end def execute #:nodoc: if !@initial_empty && @files.empty? error = OptionParser::ParseError.new("At least one FILE or --empty is needed") error.reason = "Missing argument" raise error elsif (@initial_empty && @files.empty?) || (!@initial_empty && @files.length < 2) error = OptionParser::ParseError.new("Output file is needed") error.reason = "Missing argument" raise error end output_file = @files.pop.file maybe_raise_on_existing_file(output_file) # Create PDF documents for each input file cache = {} @files.each do |spec| cache[spec.file] ||= begin io = if spec.file == output_file StringIO.new(File.binread(spec.file)) else File.open(spec.file) end HexaPDF::Document.new(io: io, **pdf_options(spec.password)) end spec.file = cache[spec.file] end # Assemble pages target = (@initial_empty ? HexaPDF::Document.new : @files.first.file) page_tree = target.add({Type: :Pages}) import_pages(page_tree) target.catalog[:Pages] = page_tree remove_unused_pages(target) target.pages.add unless target.pages.count > 0 apply_encryption_options(target) apply_optimization_options(target) write_document(target, output_file) end def usage #:nodoc: "Usage: #{command_parser.main_options.program_name} merge [options] {FILE | --empty} " \ "[FILE]... OUT_FILE" end private # Imports the pages of the document as specified with the --pages option to the given page # tree. def import_pages(page_tree) @files.each do |s| page_list = s.file.pages.to_a s.pages = parse_pages_specification(s.pages, s.file.pages.count) s.pages.each {|arr| arr[0] = page_list[arr[0]] } end if @interleave max_pages_per_file = 0 all = @files.each_with_index.map do |spec, findex| list = [] spec.pages.each {|index, rotation| list << [spec.file, findex, index, rotation] } max_pages_per_file = list.size if list.size > max_pages_per_file list end first, *rest = *all first[max_pages_per_file - 1] ||= nil first.zip(*rest) do |slice| slice.each do |source, findex, page, rotation| next unless source import_page(page_tree, findex, page, rotation) end end else @files.each_with_index do |s, findex| s.pages.each {|page, rotation| import_page(page_tree, findex, page, rotation) } end end end # Import the page with the given +rotation+ into the page tree. def import_page(page_tree, source_index, page, rotation) if page_tree.document == page.document page.value.update(page.copy_inherited_values) page = page.deep_copy unless source_index == 0 else page = page_tree.document.import(page).deep_copy end if rotation == :none page.delete(:Rotate) elsif rotation.kind_of?(Integer) page.rotate(rotation) end page_tree.document.add(page) page_tree.add_page(page) end end end end