pdfmult 1.3.1 → 1.4.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c2332ed5eb863e47259f51eaedc2e6f26d9bc58190c2c0da9c13a2d1d128f7fd
+  data.tar.gz: 164a73cc0876f21ebacee131c000c74609f591784f46297fcfdb084ff4016b7f
+SHA512:
+  metadata.gz: 42279e717e4991a3a5e4931e3a312b9603e436f45d706f6308989776eb96ca8af1c84a47780de8014793e63594d76d3fd90f6a5db99dab5bef2d2e3dcd0c6dea
+  data.tar.gz: f7de063d36bc0366059b9b65634e38b127f7bee228b033e7d3854a5c2cdf188779a07253c672cae2cefd532c84acc6c6190649b2c1aec2118ac83f32798c7405

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+gemspec
+
+gem "minitest"
+gem "rake"

data/README.md

@@ -23,13 +23,13 @@ Use the program as shown in the examples below.
 
     writes 2 copies of `sample.pdf` to `sample_2.pdf`
 
-    <img src="https://github.com/stomar/pdfmult/raw/master/example1.png" alt="" width="152" height="59">
+    <img src="example1.png" alt="" width="152" height="59">
 
 * `pdfmult -n 4 sample.pdf`
 
     writes 4 copies of `sample.pdf` to `sample_4.pdf`
 
-    <img src="https://github.com/stomar/pdfmult/raw/master/example2.png" alt="" width="234" height="59">
+    <img src="example2.png" alt="" width="234" height="59">
 
 * `pdfmult sample.pdf -o outfile.pdf`
 
@@ -46,7 +46,7 @@ Use the program as shown in the examples below.
 Installation
 ------------
 
-Use `gem install pdfmult`.
+Use `gem install pdfmult` to install from RubyGems.org.
 
 Or copy `lib/pdfmult.rb` under the name `pdfmult` into your search path.
 
@@ -60,7 +60,7 @@ As of now, `pdfmult` has only been tested on a Linux system.
 
 - `pdfmult` is written in [Ruby][Ruby], so Ruby must be installed on your system.
 - `pdfmult` uses `pdflatex` with the `pdfpages` package, so both have to be installed on the system.
-  (If `pdfmult` can not find the `pdflatex` command on your system
+  (If `pdfmult` cannot find the `pdflatex` command on your system
   you might want to use the `--latex` option.)
 - `pdfmult` tries to obtain the page count of PDF files with `pdfinfo`.
   If it fails, by default only the first page of a PDF file will be processed.
@@ -81,7 +81,7 @@ Report bugs on the `pdfmult` home page: <https://github.com/stomar/pdfmult/>
 License
 -------
 
-Copyright &copy; 2011-2012, Marcus Stollsteimer
+Copyright &copy; 2011-2024 Marcus Stollsteimer
 
 `pdfmult` is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License version 3 or later (GPLv3+),

data/Rakefile

@@ -1,52 +1,49 @@
-# rakefile for the pdfmult script.
-#
-# Copyright (C) 2011-2013 Marcus Stollsteimer
+# frozen_string_literal: true
 
-require 'rake/testtask'
+require "rake/testtask"
 
-require './lib/pdfmult'
+require "./lib/pdfmult"
 
 PROGNAME = Pdfmult::PROGNAME
 HOMEPAGE = Pdfmult::HOMEPAGE
 TAGLINE  = Pdfmult::TAGLINE
 
-BINDIR = '/usr/local/bin'
-MANDIR = '/usr/local/man/man1'
+BINDIR = "/usr/local/bin"
+MANDIR = "/usr/local/man/man1"
 
-HELP2MAN = 'help2man'
-SED = 'sed'
+HELP2MAN = "help2man"
+SED = "sed"
 
-BINARY = 'lib/pdfmult.rb'
-BINARYNAME = 'pdfmult'  # install using this name
-MANPAGE = 'man/pdfmult.1'
-H2MFILE = 'pdfmult.h2m'
+BINARY = "lib/pdfmult.rb"
+BINARYNAME = "pdfmult"  # install using this name
+MANPAGE = "man/pdfmult.1"
+H2MFILE = "pdfmult.h2m"
 
 
 def gemspec_file
-  'pdfmult.gemspec'
+  "pdfmult.gemspec"
 end
 
 
-task :default => [:test]
+task default: [:test]
 
 Rake::TestTask.new do |t|
-  t.pattern = 'test/**/test_*.rb'
-  t.ruby_opts << '-rubygems'
+  t.pattern = "test/**/test_*.rb"
   t.verbose = true
   t.warning = true
 end
 
 
-desc 'Install binary and man page'
-task :install => [BINARY, MANPAGE] do
+desc "Install binary and man page"
+task install: [BINARY, MANPAGE] do
   mkdir_p BINDIR
   install(BINARY, "#{BINDIR}/#{BINARYNAME}")
   mkdir_p MANDIR
-  install(MANPAGE, MANDIR, :mode => 0644)
+  install(MANPAGE, MANDIR, mode: 0o644)
 end
 
 
-desc 'Uninstall binary and man page'
+desc "Uninstall binary and man page"
 task :uninstall do
   rm "#{BINDIR}/#{BINARYNAME}"
   manfile = File.basename(MANPAGE)
@@ -54,19 +51,18 @@ task :uninstall do
 end
 
 
-desc 'Create man page'
-task :man => [MANPAGE]
+desc "Create man page"
+task man: [MANPAGE]
 
 file MANPAGE => [BINARY, H2MFILE] do
   sh "#{HELP2MAN} --no-info --name='#{TAGLINE}' --include=#{H2MFILE} -o #{MANPAGE} ./#{BINARY}"
-  sh "#{SED} -i '/\.PP/{N;s/\.PP\\nOptions/.SH OPTIONS/}' #{MANPAGE}"
   sh "#{SED} -i 's/^License GPL/.br\\nLicense GPL/;s/There is NO WARRANTY/.br\\nThere is NO WARRANTY/' #{MANPAGE}"
   sh "#{SED} -i 's!%HOMEPAGE%!#{HOMEPAGE}!g' #{MANPAGE}"
   sh "#{SED} -i 's!%PROGNAME%!#{PROGNAME}!g' #{MANPAGE}"
 end
 
 
-desc 'Build gem'
-task :build => [MANPAGE] do
+desc "Build gem"
+task build: [MANPAGE] do
   sh "gem build #{gemspec_file}"
 end

data/bin/pdfmult

@@ -1,5 +1,6 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
-require 'pdfmult'
+require "pdfmult"
 
-Pdfmult::Application.run!
+Pdfmult::Application.new.run!

data/lib/pdfmult.rb

@@ -1,4 +1,6 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
+
 # == Name
 #
 # pdfmult - put multiple copies of a PDF page on one page
@@ -16,31 +18,33 @@
 #
 # == Author
 #
-# Copyright (C) 2011-2013 Marcus Stollsteimer
+# Copyright (C) 2011-2024 Marcus Stollsteimer
 #
 # License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
 
-require 'optparse'
-require 'tempfile'
-require 'open3'
-require 'erb'
+require "optparse"
+require "tempfile"
+require "open3"
+require "erb"
 
 # This module contains the classes for the +pdfmult+ tool.
 module Pdfmult
 
-  PROGNAME  = 'pdfmult'
-  VERSION   = '1.3.1'
-  DATE      = '2013-01-04'
-  HOMEPAGE  = 'https://github.com/stomar/pdfmult/'
-  TAGLINE   = 'puts multiple copies of a PDF page on one page'
+  PROGNAME  = "pdfmult"
+  VERSION   = "1.4.0"
+  DATE      = "2024-01-05"
+  HOMEPAGE  = "https://github.com/stomar/pdfmult/"
+  TAGLINE   = "puts multiple copies of a PDF page on one page"
 
-  COPYRIGHT = "Copyright (C) 2011-2013 Marcus Stollsteimer.\n" +
-              "License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.\n" +
-              "This is free software: you are free to change and redistribute it.\n" +
-              "There is NO WARRANTY, to the extent permitted by law."
+  COPYRIGHT = <<~TEXT
+    Copyright (C) 2011-2024 Marcus Stollsteimer.
+    License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
+    This is free software: you are free to change and redistribute it.
+    There is NO WARRANTY, to the extent permitted by law.
+  TEXT
 
-  PDFLATEX  = '/usr/bin/pdflatex'
-  KPSEWHICH = '/usr/bin/kpsewhich'
+  PDFLATEX  = "/usr/bin/pdflatex"
+  KPSEWHICH = "/usr/bin/kpsewhich"
 
   # Parser for the command line options.
   # The class method parse! does the job.
@@ -54,95 +58,96 @@ module Pdfmult
     #
     # Returns a hash containing the option parameters.
     def self.parse!(argv)
-
       options = {
-        :force   => false,
-        :infile  => nil,
-        :latex   => false,
-        :number  => 2,
-        :outfile => nil,
-        :silent  => false,
-        :pages   => nil
+        force: false,
+        infile: nil,
+        latex: false,
+        number: 2,
+        outfile: nil,
+        silent: false,
+        pages: nil
       }
 
       opt_parser = OptionParser.new do |opt|
         opt.banner = "Usage: #{PROGNAME} [options] file"
-        opt.separator ''
-        opt.separator 'pdfmult is a command line tool that'
-        opt.separator 'rearranges multiple copies of a PDF page (shrunken) on one page.'
-        opt.separator ''
-        opt.separator 'The paper size of the produced PDF file is A4,'
-        opt.separator 'the input file is also assumed to be in A4 format.'
-        opt.separator 'The input PDF file may consist of several pages.'
-        opt.separator 'If pdfmult succeeds in obtaining the page count it will rearrange all pages,'
-        opt.separator 'if not, only the first page is processed'
-        opt.separator '(unless the page count was specified via command line option).'
-        opt.separator ''
-        opt.separator 'pdfmult uses pdflatex with the pdfpages package,'
-        opt.separator 'so both have to be installed on the system.'
-        opt.separator 'If the --latex option is used, though, pdflatex is not run'
-        opt.separator 'and a LaTeX file is created instead of a PDF.'
-        opt.separator ''
-        opt.separator 'Options'
-        opt.separator ''
+        opt.separator ""
+        opt.separator <<~DESCRIPTION
+          pdfmult is a command line tool that
+          rearranges multiple copies of a PDF page (shrunken) on one page.
+
+          The paper size of the produced PDF file is A4,
+          the input file is also assumed to be in A4 format.
+          The input PDF file may consist of several pages.
+          If pdfmult succeeds in obtaining the page count it will rearrange all pages,
+          if not, only the first page is processed
+          (unless the page count was specified via command line option).
+
+          pdfmult uses pdflatex with the pdfpages package,
+          so both have to be installed on the system.
+          If the --latex option is used, though, pdflatex is not run
+          and a LaTeX file is created instead of a PDF.
+
+          Options:
+        DESCRIPTION
 
         # process --version and --help first,
         # exit successfully (GNU Coding Standards)
-        opt.on_tail('-h', '--help', 'Print a brief help message and exit.') do
+        opt.on_tail("-h", "--help", "Print a brief help message and exit.") do
           puts opt_parser
           puts "\nReport bugs on the #{PROGNAME} home page: <#{HOMEPAGE}>"
           exit
         end
 
-        opt.on_tail('-v', '--version',
-                    'Print a brief version information and exit.') do
+        opt.on_tail("-v", "--version",
+                    "Print a brief version information and exit.") do
           puts "#{PROGNAME} #{VERSION}"
           puts COPYRIGHT
           exit
         end
 
-        opt.on('-n', '--number NUMBER', ['2', '4', '8', '9', '16'], Integer,
-               'Number of copies to put on one page: 2 (default), 4, 8, 9, 16.') do |n|
+        opt.on("-n", "--number NUMBER", %w[2 4 8 9 16], Integer,
+               "Number of copies to put on one page: 2 (default), 4, 8, 9, 16.") do |n|
           options[:number] = n
         end
 
-        opt.on('-f', '--[no-]force', 'Do not prompt before overwriting.') do |f|
+        opt.on("-f", "--[no-]force", "Do not prompt before overwriting.") do |f|
           options[:force] = f
         end
 
-        opt.on('-l', '--latex', 'Create a LaTeX file instead of a PDF file (default: file_2.tex).') do
+        opt.on("-l", "--latex", "Create a LaTeX file instead of a PDF file (default: file_2.tex).") do
           options[:latex] = true
         end
 
-        opt.on('-o', '--output FILE', String,
-               'Output file (default: file_2.pdf). Use - to output to stdout.') do |f|
+        opt.on("-o", "--output FILE", String,
+               "Output file (default: file_2.pdf). Use - to output to stdout.") do |f|
           options[:outfile] = f
         end
 
-        opt.on('-p', '--pages NUMBER', Integer,
-               'Number of pages to convert.',
+        opt.on("-p", "--pages NUMBER", Integer,
+               "Number of pages to convert.",
                "If given, #{PROGNAME} does not try to obtain the page count from the source PDF.") do |p|
-          raise(OptionParser::InvalidArgument, p)  unless p > 0
+          raise(OptionParser::InvalidArgument, p)  unless p.positive?
+
           options[:pages] = p
         end
 
-        opt.on('-s', '--[no-]silent', 'Do not output progress information.') do |s|
+        opt.on("-s", "--[no-]silent", "Do not output progress information.") do |s|
           options[:silent] = s
         end
 
-        opt.separator ''
+        opt.separator ""
       end
       opt_parser.parse!(argv)
 
       # only input file should be left in argv
-      raise(ArgumentError, 'wrong number of arguments')  if (argv.size != 1 || argv[0].empty?)
+      raise(ArgumentError, "wrong number of arguments")  if argv.size != 1 || argv[0].empty?
 
       options[:infile] = argv.pop
 
       # set output file unless set by option
-      ext = options[:latex] ? 'tex' : 'pdf'
-      infile_without_ext = options[:infile].gsub(/(.pdf)\Z/, '')
-      options[:outfile] ||= "#{infile_without_ext}_#{options[:number].to_s}.#{ext}"
+      ext = options[:latex] ? "tex" : "pdf"
+      infile_without_ext = options[:infile].delete_suffix(".pdf")
+      options[:outfile] ||= "#{infile_without_ext}_#{options[:number]}.#{ext}"
 
       options
     end
@@ -158,12 +163,12 @@ module Pdfmult
     attr_reader :pages, :geometry
 
     GEOMETRY = {
-      2  => '2x1',
-      4  => '2x2',
-      8  => '4x2',
-      9  => '3x3',
-      16 => '4x4'
-    }
+      2 => "2x1",
+      4 => "2x2",
+      8 => "4x2",
+      9 => "3x3",
+      16 => "4x4"
+    }.freeze
 
     def initialize(pages)
       @pages = pages
@@ -171,30 +176,31 @@ module Pdfmult
     end
 
     def landscape?
-      ['2x1', '4x2'].include?(geometry)
+      %w[2x1 4x2].include?(geometry)
     end
   end
 
   # Class for the LaTeX document.
   #
-  # Create an instance with LaTeXDocument.new, specifying
-  # the input file, the number of pages to put on one page,
-  # and the page count of the input file.
+  # Create an instance with LaTeXDocument.new, specifying the
+  # input file, the layout, and the page count of the input file.
   #
   # The method +to_s+ returns the document as multiline string.
   class LaTeXDocument
 
-    TEMPLATE = %q(
+    attr_reader :pdffile, :layout, :page_count
+
+    TEMPLATE = <<~'LATEX'
       \documentclass[<%= class_options %>]{article}
       \usepackage{pdfpages}
       \pagestyle{empty}
       \setlength{\parindent}{0pt}
       \begin{document}
       % pages_strings.each do |pages|
-        \includepdf[pages={<%= pages %>},nup=<%= geometry %>]{<%= @pdffile %>}%
+      \includepdf[pages={<%= pages %>},nup=<%= geometry %>]{<%= pdffile %>}%
       % end
       \end{document}
-    ).gsub(/\A\n/,'').gsub(/^ +/, '')
+    LATEX
 
     # Initializes a LaTeXDocument instance.
     # Expects an argument hash with:
@@ -209,9 +215,7 @@ module Pdfmult
     end
 
     def to_s
-      class_options = "a4paper"
-      class_options << ',landscape'  if @layout.landscape?
-      latex = ERB.new(TEMPLATE, 0, '%<>')
+      latex = ERB.new(TEMPLATE, trim_mode: "%<>")
 
       latex.result(binding)
     end
@@ -219,15 +223,23 @@ module Pdfmult
     private
 
     def geometry
-      @layout.geometry
+      layout.geometry
+    end
+
+    def class_options
+      layout.landscape? ? "a4paper,landscape" : "a4paper"
+    end
+
+    def pages_per_sheet
+      layout.pages
     end
 
     # Returns an array of pages strings.
     # For 4 copies and 2 pages: ["1,1,1,1", "2,2,2,2"].
     def pages_strings
-      template = 'PAGE,' * (@layout.pages - 1) + 'PAGE'
+      pages = (1..page_count).to_a
 
-      Array.new(@page_count) {|i| template.gsub(/PAGE/, "#{i+1}") }
+      pages.map {|page| ([page] * pages_per_sheet).join(",") }
     end
   end
 
@@ -239,7 +251,7 @@ module Pdfmult
   # else the attribute is set to +nil+.
   class PDFInfo
 
-    PDFINFOCMD = '/usr/bin/pdfinfo'
+    PDFINFOCMD = "/usr/bin/pdfinfo"
 
     # Returns the page count of the input file, or nil.
     attr_reader :page_count
@@ -247,11 +259,16 @@ module Pdfmult
     # This is the initialization method for the class.
     #
     # +file+ - file name of the PDF file
-    def initialize(file, options={})
+    def initialize(file, options = {})
       @file = file
       @binary = options[:pdfinfocmd] || PDFINFOCMD  # for unit tests
-      @infos = retrieve_infos
-      @page_count = @infos['Pages'] && @infos['Pages'].to_i
+      infos = retrieve_infos
+      @page_count = infos["Pages"]&.to_i
+    end
+
+    # Returns true if default +pdfinfo+ system tool is available (for unit tests).
+    def self.infocmd_available?
+      Application.command_available?("#{PDFINFOCMD} -v")
     end
 
     private
@@ -261,14 +278,9 @@ module Pdfmult
       command = "#{@binary} #{@file}"
       return {}  unless Application.command_available?(command)
 
-      info_array = `#{command}`.split(/\n/)
+      info_array = `#{command}`.split("\n")
 
-      Hash[info_array.map {|line| line.split(/\s*:\s*/, 2) }]
-    end
-
-    # Returns true if default +pdfinfo+ system tool is available (for unit tests).
-    def self.infocmd_available?
-      Application.command_available?("#{PDFINFOCMD} -v")
+      info_array.to_h {|line| line.split(/\s*:\s*/, 2) }
     end
   end
 
@@ -277,62 +289,62 @@ module Pdfmult
   # It parses the command line arguments and does the job.
   class Application
 
-    ERRORCODE = {:general => 1, :usage => 2}
-
-    # The main program.
-    def self.run!
+    ERRORCODE = { general: 1, usage: 2 }.freeze
 
-      # parse options
+    def initialize
       begin
         options = Optionparser.parse!(ARGV)
-      rescue => e
+      rescue StandardError => e
         usage_fail(e.message)
       end
+      @infile = options[:infile]
+      @outfile = options[:outfile]
+      @use_stdout = (@outfile == "-")
+      @silent = options[:silent]
+      @force = options[:force]
+      @latex = options[:latex]
+      @number = options[:number]
+      @pages = options[:pages] || PDFInfo.new(@infile).page_count || 1
+    end
 
-      infile = options[:infile]
-      outfile = options[:outfile]
-      use_stdout = (outfile == '-')
-      silent = options[:silent]
-
+    # The main program.
+    def run!
       # test for pdflatex installation
-      unless options[:latex]
-        message = 'seems not to be installed (you might try using the -l option)'
-        general_fail("`#{PDFLATEX}' #{message}")  unless command_available?("#{PDFLATEX} --version")
-        general_fail("`pdfpages.sty' #{message}")  unless command_available?("#{KPSEWHICH} pdfpages.sty")
+      unless @latex
+        message = "seems not to be installed (you might try using the -l option)"
+        general_fail("`#{PDFLATEX}' #{message}")  unless self.class.command_available?("#{PDFLATEX} --version")
+        general_fail("`pdfpages.sty' #{message}")  unless self.class.command_available?("#{KPSEWHICH} pdfpages.sty")
       end
 
       # test input file
-      usage_fail("no such file: `#{infile}'")  unless File.exist?(infile)
-      usage_fail("specified input not of the type `file'")  unless File.ftype(infile) == 'file'
+      usage_fail("no such file: `#{@infile}'")  unless File.exist?(@infile)
+      usage_fail("specified input not of the type `file'")  unless File.ftype(@infile) == "file"
 
       # test for existing output file
-      if !use_stdout and !options[:force] and File.exist?(outfile)
-        overwrite_ok = ask("File `#{outfile}' already exists. Overwrite?")
+      if !@use_stdout && !@force && File.exist?(@outfile)
+        overwrite_ok = confirm("File `#{@outfile}' already exists. Overwrite?")
         exit  unless overwrite_ok
       end
 
-      # set page number (get PDF info if necessary)
-      pages = options[:pages] || PDFInfo.new(infile).page_count || 1
-
       # create LaTeX document
       args = {
-        :pdffile    => infile,
-        :layout     => Layout.new(options[:number]),
-        :page_count => pages
+        pdffile: @infile,
+        layout: Layout.new(@number),
+        page_count: @pages
       }
       document = LaTeXDocument.new(args)
 
       output = nil
-      if options[:latex]
+      if @latex
         output = document.to_s
       else
-        Dir.mktmpdir('pdfmult') do |dir|
-          texfile = 'pdfmult.tex'
-          pdffile = 'pdfmult.pdf'
-          open("#{dir}/#{texfile}", 'w') {|f| f.write(document.to_s) }
+        Dir.mktmpdir("pdfmult") do |dir|
+          texfile = "pdfmult.tex"
+          pdffile = "pdfmult.pdf"
+          File.write("#{dir}/#{texfile}", document.to_s)
           command = "#{PDFLATEX} -output-directory #{dir} #{texfile}"
-          Open3.popen3(command) do |stdin, stdout, stderr|
-            stdout.each_line {|line| warn line.chomp }  unless silent # redirect progress messages to stderr
+          Open3.popen3(command) do |_stdin, stdout, stderr|
+            stdout.each_line {|line| warn line.chomp }  unless @silent # redirect progress messages to stderr
             stderr.read  # make sure all streams are read (and command has finished)
           end
           output = File.read("#{dir}/#{pdffile}")
@@ -340,52 +352,51 @@ module Pdfmult
       end
 
       # redirect stdout to output file
-      $stdout.reopen(outfile, 'w')  unless use_stdout
+      $stdout.reopen(@outfile, "w")  unless @use_stdout
 
-      warn "Writing on #{outfile}."  unless (use_stdout || silent)
+      warn "Writing on #{@outfile}."  unless @use_stdout || @silent
       puts output
     end
 
+    # Tests silently whether the given system command is available.
+    #
+    # +command+ - command to test
+    def self.command_available?(command) # :nodoc:
+      !!system("#{command} >/dev/null 2>&1")
+    end
+
+    private
+
     # Asks for yes or no (y/n).
     #
     # +question+ - string to be printed
     #
     # Returns +true+ if the answer is yes.
-    def self.ask(question) # :nodoc:
+    def confirm(question)
       loop do
         $stderr.print "#{question} [y/n] "
-        reply = $stdin.gets.chomp.downcase  # $stdin: avoids gets / ARGV problem
-        return true   if reply == 'y'
-        return false  if reply == 'n'
+        reply = $stdin.gets.chomp.downcase  # $stdin avoids gets/ARGV problem
+        return reply == "y"  if reply.match?(/\A[yn]\z/)
+
         warn "Please answer `y' or `n'."
       end
     end
 
     # Prints an error message and exits.
-    def self.general_fail(message) # :nodoc:
+    def general_fail(message)
       warn "#{PROGNAME}: #{message}"
       exit ERRORCODE[:general]
     end
 
     # Prints an error message and a short help information, then exits.
-    def self.usage_fail(message) # :nodoc:
+    def usage_fail(message)
       warn "#{PROGNAME}: #{message}"
       warn "Use `#{PROGNAME} --help' for valid options."
       exit ERRORCODE[:usage]
     end
-
-    # Tests silently whether the given system command is available.
-    #
-    # +command+ - command to test
-    def self.command_available?(command) # :nodoc:
-      !!system("#{command} >/dev/null 2>&1")
-    end
   end
+end
 
 ### call main method only if called on command line
 
-if __FILE__ == $0
-  Application.run!
-end
-
-end  # module
+Pdfmult::Application.new.run!  if __FILE__ == $PROGRAM_NAME

data/man/pdfmult.1

@@ -1,10 +1,10 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.40.4.
-.TH PDFMULT "1" "January 2013" "pdfmult 1.3.1" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.1.
+.TH PDFMULT "1" "January 2024" "pdfmult 1.4.0" "User Commands"
 .SH NAME
 pdfmult \- puts multiple copies of a PDF page on one page
 .SH SYNOPSIS
 .B pdfmult
-[\fIoptions\fR] \fIfile\fR
+[\fI\,options\/\fR] \fI\,file\/\fR
 .SH DESCRIPTION
 pdfmult is a command line tool that
 rearranges multiple copies of a PDF page (shrunken) on one page.
@@ -55,7 +55,7 @@ Print a brief version information and exit.
 .SH "REPORTING BUGS"
 Report bugs on the pdfmult home page: <https://github.com/stomar/pdfmult/>
 .SH COPYRIGHT
-Copyright \(co 2011\-2013 Marcus Stollsteimer.
+Copyright \(co 2011\-2024 Marcus Stollsteimer.
 .br
 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
 .br

data/pdfmult.gemspec

@@ -1,4 +1,6 @@
-require './lib/pdfmult'
+# frozen_string_literal: true
+
+require "./lib/pdfmult"
 
 version  = Pdfmult::VERSION
 date     = Pdfmult::DATE
@@ -6,40 +8,42 @@ homepage = Pdfmult::HOMEPAGE
 tagline  = Pdfmult::TAGLINE
 
 Gem::Specification.new do |s|
-  s.name              = 'pdfmult'
+  s.name              = "pdfmult"
   s.version           = version
   s.date              = date
-  s.rubyforge_project = 'pdfmult'
 
-  s.description = 'pdfmult is a command line tool that rearranges ' +
-                  'multiple copies of a PDF page (shrunken) on one page. ' +
-                  'It is a wrapper for pdflatex with the pdfpages package.'
+  s.description = "pdfmult is a command line tool that rearranges " \
+                  "multiple copies of a PDF page (shrunken) on one page. " \
+                  "It is a wrapper for pdflatex with the pdfpages package."
   s.summary = "pdfmult - #{tagline}"
 
-  s.authors = ['Marcus Stollsteimer']
-  s.email = 'sto.mar@web.de'
+  s.authors = ["Marcus Stollsteimer"]
+  s.email = "sto.mar@web.de"
   s.homepage = homepage
 
-  s.license = 'GPL-3'
+  s.license = "GPL-3.0"
+
+  s.required_ruby_version = ">= 3.1.0"
+
+  s.requirements << "pdflatex and the pdfpages package"
 
-  s.requirements << 'pdflatex and the pdfpages package'
+  s.executables = ["pdfmult"]
+  s.bindir = "bin"
 
-  s.executables = ['pdfmult']
-  s.bindir = 'bin'
-  s.require_path = 'lib'
-  s.test_files = Dir.glob('test/**/test_*.rb')
+  s.require_paths = ["lib"]
 
-  s.rdoc_options = ['--charset=UTF-8']
+  s.test_files = Dir.glob("test/**/test_*.rb")
 
-  s.files = %w{
+  s.files =
+    %w[
       README.md
       Rakefile
+      Gemfile
       pdfmult.gemspec
       pdfmult.h2m
-    } +
-    Dir.glob('example*.*') +
-    Dir.glob('{bin,lib,man,test}/**/*')
+    ] +
+    Dir.glob("example*.*") +
+    Dir.glob("{bin,lib,man,test}/**/*")
 
-  s.add_development_dependency('rake')
-  s.add_development_dependency('minitest')
+  s.rdoc_options = ["--charset=UTF-8"]
 end

data/test/test_latex_document.rb

@@ -1,10 +1,7 @@
-# test_latex_document.rb: Unit tests for the pdfmult script.
-#
-# Copyright (C) 2011-2013 Marcus Stollsteimer
+# frozen_string_literal: true
 
-require 'minitest/spec'
-require 'minitest/autorun'
-require 'pdfmult'
+require "minitest/autorun"
+require "pdfmult"
 
 
 describe Pdfmult::LaTeXDocument do
@@ -13,27 +10,27 @@ describe Pdfmult::LaTeXDocument do
     @layout_class = Pdfmult::Layout
   end
 
-  it 'should return the expected LaTeX code for 4 pages' do
+  it "should return the expected LaTeX code for 4 pages" do
     args = {
-      :pdffile    => 'sample.pdf',
-      :layout     => @layout_class.new(4),
-      :page_count => 3
+      pdffile: "sample.pdf",
+      layout: @layout_class.new(4),
+      page_count: 3
     }
-    document_lines = Pdfmult::LaTeXDocument.new(args).to_s.split(/\n/)
-    document_lines[0].must_equal  '\documentclass[a4paper]{article}'
-    document_lines[-2].must_equal '\includepdf[pages={3,3,3,3},nup=2x2]{sample.pdf}%'
-    document_lines.grep(/includepdf/).size.must_equal args[:page_count]
+    document_lines = Pdfmult::LaTeXDocument.new(args).to_s.split("\n")
+    _(document_lines[0]).must_equal  '\documentclass[a4paper]{article}'
+    _(document_lines[-2]).must_equal '\includepdf[pages={3,3,3,3},nup=2x2]{sample.pdf}%'
+    _(document_lines.grep(/includepdf/).size).must_equal args[:page_count]
   end
 
-  it 'should return the expected LaTeX code for 8 pages' do
+  it "should return the expected LaTeX code for 8 pages" do
     args = {
-      :pdffile    => 'sample.pdf',
-      :layout     => @layout_class.new(8),
-      :page_count => 5
+      pdffile: "sample.pdf",
+      layout: @layout_class.new(8),
+      page_count: 5
     }
-    document_lines = Pdfmult::LaTeXDocument.new(args).to_s.split(/\n/)
-    document_lines[0].must_equal  '\documentclass[a4paper,landscape]{article}'
-    document_lines[-2].must_equal '\includepdf[pages={5,5,5,5,5,5,5,5},nup=4x2]{sample.pdf}%'
-    document_lines.grep(/includepdf/).size.must_equal args[:page_count]
+    document_lines = Pdfmult::LaTeXDocument.new(args).to_s.split("\n")
+    _(document_lines[0]).must_equal  '\documentclass[a4paper,landscape]{article}'
+    _(document_lines[-2]).must_equal '\includepdf[pages={5,5,5,5,5,5,5,5},nup=4x2]{sample.pdf}%'
+    _(document_lines.grep(/includepdf/).size).must_equal args[:page_count]
   end
 end

data/test/test_layout.rb

@@ -1,10 +1,7 @@
-# test_layout.rb: Unit tests for the pdfmult script.
-#
-# Copyright (C) 2011-2013 Marcus Stollsteimer
+# frozen_string_literal: true
 
-require 'minitest/spec'
-require 'minitest/autorun'
-require 'pdfmult'
+require "minitest/autorun"
+require "pdfmult"
 
 
 describe Pdfmult::Layout do
@@ -13,45 +10,45 @@ describe Pdfmult::Layout do
     @layout = Pdfmult::Layout.new(2)
   end
 
-  it 'can return the number of pages' do
-    @layout.pages.must_equal 2
+  it "can return the number of pages" do
+    _(@layout.pages).must_equal 2
   end
 
-  it 'can return the geometry' do
-    @layout.geometry.must_equal '2x1'
+  it "can return the geometry" do
+    _(@layout.geometry).must_equal "2x1"
   end
 
-  it 'knows whether it is landscape' do
-    @layout.landscape?.must_equal true
+  it "knows whether it is landscape" do
+    _(@layout.landscape?).must_equal true
   end
 
-  it 'returns the correct layout for 2 pages' do
+  it "returns the correct layout for 2 pages" do
     layout = Pdfmult::Layout.new(2)
-    layout.geometry.must_equal '2x1'
-    layout.landscape?.must_equal true
+    _(layout.geometry).must_equal "2x1"
+    _(layout.landscape?).must_equal true
   end
 
-  it 'returns the correct layout for 4 pages' do
+  it "returns the correct layout for 4 pages" do
     layout = Pdfmult::Layout.new(4)
-    layout.geometry.must_equal '2x2'
-    layout.landscape?.must_equal false
+    _(layout.geometry).must_equal "2x2"
+    _(layout.landscape?).must_equal false
   end
 
-  it 'returns the correct layout for 8 pages' do
+  it "returns the correct layout for 8 pages" do
     layout = Pdfmult::Layout.new(8)
-    layout.geometry.must_equal '4x2'
-    layout.landscape?.must_equal true
+    _(layout.geometry).must_equal "4x2"
+    _(layout.landscape?).must_equal true
   end
 
-  it 'returns the correct layout for 9 pages' do
+  it "returns the correct layout for 9 pages" do
     layout = Pdfmult::Layout.new(9)
-    layout.geometry.must_equal '3x3'
-    layout.landscape?.must_equal false
+    _(layout.geometry).must_equal "3x3"
+    _(layout.landscape?).must_equal false
   end
 
-  it 'returns the correct layout for 16 pages' do
+  it "returns the correct layout for 16 pages" do
     layout = Pdfmult::Layout.new(16)
-    layout.geometry.must_equal '4x4'
-    layout.landscape?.must_equal false
+    _(layout.geometry).must_equal "4x4"
+    _(layout.landscape?).must_equal false
   end
 end

data/test/test_optionparser.rb

@@ -1,87 +1,84 @@
-# test_optionparser.rb: Unit tests for the pdfmult script.
-#
-# Copyright (C) 2011-2013 Marcus Stollsteimer
+# frozen_string_literal: true
 
-require 'minitest/spec'
-require 'minitest/autorun'
-require 'pdfmult'
+require "minitest/autorun"
+require "pdfmult"
 
 
 describe Pdfmult::Optionparser do
 
-  it 'should return the correct default values' do
-    options = Pdfmult::Optionparser.parse!(['sample.pdf'])
+  it "should return the correct default values" do
+    options = Pdfmult::Optionparser.parse!(["sample.pdf"])
     expected = {
-      :force   => false,
-      :infile  => 'sample.pdf',
-      :latex   => false,
-      :number  => 2,
-      :outfile => 'sample_2.pdf',
-      :pages   => nil,
-      :silent  => false
+      force: false,
+      infile: "sample.pdf",
+      latex: false,
+      number: 2,
+      outfile: "sample_2.pdf",
+      pages: nil,
+      silent: false
     }
-    options.must_equal expected
+    _(options).must_equal expected
   end
 
-  it 'should recognize the -n option and set the corresponding output filename' do
-    options = Pdfmult::Optionparser.parse!(['sample.pdf', '-n', '4'])
-    options[:outfile].must_equal 'sample_4.pdf'
-    options[:number].must_equal 4
+  it "should recognize the -n option and set the corresponding output filename" do
+    options = Pdfmult::Optionparser.parse!(["sample.pdf", "-n", "4"])
+    _(options[:outfile]).must_equal "sample_4.pdf"
+    _(options[:number]).must_equal 4
   end
 
-  it 'should not accept invalid -n option values' do
-    lambda { Pdfmult::Optionparser.parse!(['sample.pdf', '-n', '3']) }.must_raise OptionParser::InvalidArgument
+  it "should not accept invalid -n option values" do
+    _ { Pdfmult::Optionparser.parse!(["sample.pdf", "-n", "3"]) }.must_raise OptionParser::InvalidArgument
   end
 
-  it 'should recognize the -o option' do
-    options = Pdfmult::Optionparser.parse!(['sample.pdf', '-o', 'outfile.pdf'])
-    options[:outfile].must_equal 'outfile.pdf'
+  it "should recognize the -o option" do
+    options = Pdfmult::Optionparser.parse!(["sample.pdf", "-o", "outfile.pdf"])
+    _(options[:outfile]).must_equal "outfile.pdf"
   end
 
-  it 'should recognize the -p option' do
-    options = Pdfmult::Optionparser.parse!(['sample.pdf', '-p', '4'])
-    options[:pages].must_equal 4
+  it "should recognize the -p option" do
+    options = Pdfmult::Optionparser.parse!(["sample.pdf", "-p", "4"])
+    _(options[:pages]).must_equal 4
   end
 
-  it 'should recognize the -f option' do
-    options = Pdfmult::Optionparser.parse!(['sample.pdf', '-f'])
-    options[:force].must_equal true
+  it "should recognize the -f option" do
+    options = Pdfmult::Optionparser.parse!(["sample.pdf", "-f"])
+    _(options[:force]).must_equal true
   end
 
-  it 'should recognize the --no-force option' do
-    options = Pdfmult::Optionparser.parse!(['sample.pdf', '--no-force'])
-    options[:force].must_equal false
+  it "should recognize the --no-force option" do
+    options = Pdfmult::Optionparser.parse!(["sample.pdf", "--no-force"])
+    _(options[:force]).must_equal false
   end
 
-  it 'should recognize the -l option and set the corresponding output filename' do
-    options = Pdfmult::Optionparser.parse!(['sample.pdf', '-l'])
-    options[:outfile].must_equal 'sample_2.tex'
-    options[:latex].must_equal true
+  it "should recognize the -l option and set the corresponding output filename" do
+    options = Pdfmult::Optionparser.parse!(["sample.pdf", "-l"])
+    _(options[:outfile]).must_equal "sample_2.tex"
+    _(options[:latex]).must_equal true
   end
 
-  it 'should only accept positive -p option values' do
-    lambda { Pdfmult::Optionparser.parse!(['sample.pdf', '-p', '0.5']) }.must_raise OptionParser::InvalidArgument
-    lambda { Pdfmult::Optionparser.parse!(['sample.pdf', '-p', '0']) }.must_raise OptionParser::InvalidArgument
-    lambda { Pdfmult::Optionparser.parse!(['sample.pdf', '-p', '-1']) }.must_raise OptionParser::InvalidArgument
+  it "should only accept positive -p option values" do
+    _ { Pdfmult::Optionparser.parse!(["sample.pdf", "-p", "0.5"]) }.must_raise OptionParser::InvalidArgument
+    _ { Pdfmult::Optionparser.parse!(["sample.pdf", "-p", "0"]) }.must_raise OptionParser::InvalidArgument
+    _ { Pdfmult::Optionparser.parse!(["sample.pdf", "-p", "-1"]) }.must_raise OptionParser::InvalidArgument
   end
 
-  it 'should recognize the -s option' do
-    options = Pdfmult::Optionparser.parse!(['sample.pdf', '-s'])
-    options[:silent].must_equal true
+  it "should recognize the -s option" do
+    options = Pdfmult::Optionparser.parse!(["sample.pdf", "-s"])
+    _(options[:silent]).must_equal true
   end
 
-  it 'should recognize the --no-silent option' do
-    options = Pdfmult::Optionparser.parse!(['sample.pdf', '--no-silent'])
-    options[:silent].must_equal false
+  it "should recognize the --no-silent option" do
+    options = Pdfmult::Optionparser.parse!(["sample.pdf", "--no-silent"])
+    _(options[:silent]).must_equal false
   end
 
-  it 'should not accept wrong number of arguments' do
-    lambda { Pdfmult::Optionparser.parse!(['sample.pdf', 'sample2.pdf']) }.must_raise ArgumentError
-    lambda { Pdfmult::Optionparser.parse!(['']) }.must_raise ArgumentError
-    lambda { Pdfmult::Optionparser.parse!([]) }.must_raise ArgumentError
+  it "should not accept wrong number of arguments" do
+    _ { Pdfmult::Optionparser.parse!(["sample.pdf", "sample2.pdf"]) }.must_raise ArgumentError
+    _ { Pdfmult::Optionparser.parse!([""]) }.must_raise ArgumentError
+    _ { Pdfmult::Optionparser.parse!([]) }.must_raise ArgumentError
   end
 
-  it 'should not accept invalid options' do
-    lambda { Pdfmult::Optionparser.parse!(['-x']) }.must_raise OptionParser::InvalidOption
+  it "should not accept invalid options" do
+    _ { Pdfmult::Optionparser.parse!(["-x"]) }.must_raise OptionParser::InvalidOption
   end
 end

data/test/test_pdfinfo.rb

@@ -1,10 +1,7 @@
-# test_pdfinfo.rb: Unit tests for the pdfmult script.
-#
-# Copyright (C) 2011-2013 Marcus Stollsteimer
+# frozen_string_literal: true
 
-require 'minitest/spec'
-require 'minitest/autorun'
-require 'pdfmult'
+require "minitest/autorun"
+require "pdfmult"
 
 SRCPATH = File.dirname(__FILE__)
 
@@ -15,20 +12,20 @@ describe Pdfmult::PDFInfo do
     @sample_pdf = File.expand_path("#{SRCPATH}/sample.pdf")
   end
 
-  describe 'when asked about the page count' do
-    it 'should return the page count for existing file and system tool' do
+  describe "when asked about the page count" do
+    it "should return the page count for existing file and system tool" do
       infocmd = Pdfmult::PDFInfo::PDFINFOCMD
       skip("Skipped: `#{infocmd}' not available on the system")  unless Pdfmult::PDFInfo.infocmd_available?
-      Pdfmult::PDFInfo.new(@sample_pdf).page_count.must_equal 3
-      Pdfmult::PDFInfo.new(@sample_pdf, :pdfinfocmd => infocmd).page_count.must_equal 3
+      _(Pdfmult::PDFInfo.new(@sample_pdf).page_count).must_equal 3
+      _(Pdfmult::PDFInfo.new(@sample_pdf, pdfinfocmd: infocmd).page_count).must_equal 3
     end
 
-    it 'should return nil for non-existent files' do
-      Pdfmult::PDFInfo.new('not_a_file.pdf').page_count.must_be_nil
+    it "should return nil for non-existent files" do
+      _(Pdfmult::PDFInfo.new("not_a_file.pdf").page_count).must_be_nil
     end
 
     it "should return nil for non-existent `pdfinfo' system tool" do
-      Pdfmult::PDFInfo.new(@sample_pdf, :pdfinfocmd => 'not_a_command').page_count.must_be_nil
+      _(Pdfmult::PDFInfo.new(@sample_pdf, pdfinfocmd: "not_a_command").page_count).must_be_nil
     end
   end
 end

metadata

@@ -1,111 +1,68 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: pdfmult
-version: !ruby/object:Gem::Version 
-  hash: 25
-  prerelease: 
-  segments: 
-  - 1
-  - 3
-  - 1
-  version: 1.3.1
+version: !ruby/object:Gem::Version
+  version: 1.4.0
 platform: ruby
-authors: 
+authors:
 - Marcus Stollsteimer
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2013-01-04 00:00:00 Z
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: rake
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
-  type: :development
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: minitest
-  prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
-  type: :development
-  version_requirements: *id002
-description: pdfmult is a command line tool that rearranges multiple copies of a PDF page (shrunken) on one page. It is a wrapper for pdflatex with the pdfpages package.
+date: 2024-01-05 00:00:00.000000000 Z
+dependencies: []
+description: pdfmult is a command line tool that rearranges multiple copies of a PDF
+  page (shrunken) on one page. It is a wrapper for pdflatex with the pdfpages package.
 email: sto.mar@web.de
-executables: 
+executables:
 - pdfmult
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
+- Gemfile
 - README.md
 - Rakefile
-- pdfmult.gemspec
-- pdfmult.h2m
+- bin/pdfmult
 - example1.fig
 - example1.png
 - example2.fig
 - example2.png
-- bin/pdfmult
 - lib/pdfmult.rb
 - man/pdfmult.1
-- test/test_pdfinfo.rb
-- test/test_latex_document.rb
+- pdfmult.gemspec
+- pdfmult.h2m
+- test/sample.pdf
 - test/sample.tex
+- test/test_latex_document.rb
 - test/test_layout.rb
 - test/test_optionparser.rb
-- test/sample.pdf
+- test/test_pdfinfo.rb
 homepage: https://github.com/stomar/pdfmult/
-licenses: 
-- GPL-3
+licenses:
+- GPL-3.0
+metadata: {}
 post_install_message: 
-rdoc_options: 
-- --charset=UTF-8
-require_paths: 
+rdoc_options:
+- "--charset=UTF-8"
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
   - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
   - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-requirements: 
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements:
 - pdflatex and the pdfpages package
-rubyforge_project: pdfmult
-rubygems_version: 1.8.24
+rubygems_version: 3.5.3
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: pdfmult - puts multiple copies of a PDF page on one page
-test_files: 
-- test/test_pdfinfo.rb
+test_files:
 - test/test_latex_document.rb
 - test/test_layout.rb
 - test/test_optionparser.rb
+- test/test_pdfinfo.rb