pdfmult 1.0.0

data/README.md

@@ -0,0 +1,83 @@
+pdfmult
+=======
+
+`pdfmult` is a command line tool (written in [Ruby][Ruby]) 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).
+
+Examples
+--------
+
+Use the program as shown in the examples below.
+
+* `pdfmult sample.pdf`
+
+    writes 2 copies of `sample.pdf` to `sample_2.pdf`
+
+    <img src="/stomar/pdfmult/raw/master/example1.png" alt="" width="152" height="59">
+
+* `pdfmult -n 4 sample.pdf`
+
+    writes 4 copies of `sample.pdf` to `sample_4.pdf`
+
+    <img src="/stomar/pdfmult/raw/master/example2.png" alt="" width="234" height="59">
+
+* `pdfmult sample.pdf -o outfile.pdf`
+
+    writes 2 copies of `sample.pdf` to `outfile.pdf`
+
+* `pdfmult sample.pdf -p 3`
+
+    processes the first 3 pages of `sample.pdf`
+
+Installation
+------------
+
+Use `gem install pdfmult`.
+
+Or opy `lib/pdfmult.rb` under the name `pdfmult` into your search path.
+
+On a Linux system you can use `[sudo] rake install`
+to install `pdfmult` and its man page to `/usr/local`.
+
+Requirements
+------------
+
+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.
+- `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.
+
+Documentation
+-------------
+
+`pdfmult --help` prints a brief help message.
+
+If you installed `pdfmult` using `rake install` you can read
+its man page with `man pdfmult`.
+
+Reporting bugs
+--------------
+
+Report bugs on the `pdfmult` home page: <https://github.com/stomar/pdfmult/>
+
+License
+-------
+
+Copyright &copy; 2011-2012, 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+),
+see [www.gnu.org/licenses/gpl.html](http://www.gnu.org/licenses/gpl.html).
+There is NO WARRANTY, to the extent permitted by law.
+
+
+[Ruby]: http://www.ruby-lang.org/

data/Rakefile

@@ -0,0 +1,64 @@
+# rakefile for the pdfmult script.
+#
+# Copyright (C) 2012 Marcus Stollsteimer
+
+require 'rake/testtask'
+
+BINDIR = '/usr/local/bin'
+MANDIR = '/usr/local/man/man1'
+
+HELP2MAN = 'help2man'
+SED = 'sed'
+
+BINARY = 'lib/pdfmult.rb'
+BINARYNAME = 'pdfmult'  # install using this name
+MANPAGE = 'man/pdfmult.1'
+H2MFILE = 'pdfmult.h2m'
+
+
+def gemspec_file
+  'pdfmult.gemspec'
+end
+
+
+task :default => [:test]
+
+Rake::TestTask.new do |t|
+  t.pattern = 'test/**/test_*.rb'
+  t.ruby_opts << '-rubygems'
+  t.verbose = true
+  t.warning = true
+end
+
+
+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)
+end
+
+
+desc 'Uninstall binary and man page'
+task :uninstall do
+  rm "#{BINDIR}/#{BINARYNAME}"
+  manfile = File.basename(MANPAGE)
+  rm "#{MANDIR}/#{manfile}"
+end
+
+
+desc 'Create man page'
+task :man => [MANPAGE]
+
+file MANPAGE => [BINARY, H2MFILE] do
+  sh "#{HELP2MAN} --no-info --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}"
+end
+
+
+desc 'Build gem'
+task :build do
+  sh "gem build #{gemspec_file}"
+end

data/bin/pdfmult

@@ -0,0 +1,5 @@
+#!/usr/bin/ruby -w
+
+require 'pdfmult'
+
+Pdfmult::Application.run!

data/example1.fig

@@ -0,0 +1,21 @@
+#FIG 3.2  Produced by xfig version 3.2.5b
+Landscape
+Center
+Metric
+A4      
+100.00
+Single
+-2
+1200 2
+2 1 0 4 0 7 50 -1 -1 0.000 0 0 -1 1 0 2
+	1 1 2.00 120.00 180.00
+	 1395 450 1845 450
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+	 540 0 1215 0 1215 900 540 900 540 0
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+	 2025 90 2925 90 2925 765 2025 765 2025 90
+2 1 2 1 0 7 50 -1 -1 3.000 0 0 -1 0 0 2
+	 2475 90 2475 765
+4 1 0 50 -1 16 32 0.0000 4 405 375 855 630 A\001
+4 1 0 50 -1 16 24 0.0000 4 315 270 2700 585 A\001
+4 1 0 50 -1 16 24 0.0000 4 315 270 2250 585 A\001

data/example2.fig

@@ -0,0 +1,46 @@
+#FIG 3.2  Produced by xfig version 3.2.5b
+Landscape
+Center
+Metric
+A4      
+100.00
+Single
+-2
+1200 2
+6 450 0 1125 900
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+	 450 0 1125 0 1125 900 450 900 450 0
+4 1 0 50 -1 16 32 0.0000 4 390 285 765 630 2\001
+-6
+6 1935 0 2610 900
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+	 1935 0 2610 0 2610 900 1935 900 1935 0
+2 1 2 1 0 7 50 -1 -1 3.000 0 0 -1 0 0 2
+	 1935 450 2610 450
+2 1 2 1 0 7 50 -1 -1 3.000 0 0 -1 0 0 2
+	 2272 0 2272 900
+4 1 0 50 -1 16 16 0.0000 4 195 150 2430 315 1\001
+4 1 0 50 -1 16 16 0.0000 4 195 150 2115 765 1\001
+4 1 0 50 -1 16 16 0.0000 4 195 150 2430 765 1\001
+4 1 0 50 -1 16 16 0.0000 4 195 150 2115 315 1\001
+-6
+6 -315 0 360 900
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+	 -315 0 360 0 360 900 -315 900 -315 0
+4 1 0 50 -1 16 32 0.0000 4 390 285 0 630 1\001
+-6
+6 2700 0 3375 900
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+	 2700 0 3375 0 3375 900 2700 900 2700 0
+2 1 2 1 0 7 50 -1 -1 3.000 0 0 -1 0 0 2
+	 2700 450 3375 450
+2 1 2 1 0 7 50 -1 -1 3.000 0 0 -1 0 0 2
+	 3037 0 3037 900
+4 1 0 50 -1 16 16 0.0000 4 195 150 3195 315 2\001
+4 1 0 50 -1 16 16 0.0000 4 195 150 2880 765 2\001
+4 1 0 50 -1 16 16 0.0000 4 195 150 3195 765 2\001
+4 1 0 50 -1 16 16 0.0000 4 195 150 2880 315 2\001
+-6
+2 1 0 4 0 7 50 -1 -1 0.000 0 0 -1 1 0 2
+	1 1 2.00 120.00 180.00
+	 1305 450 1755 450

data/lib/pdfmult.rb

@@ -0,0 +1,335 @@
+#!/usr/bin/ruby -w
+# == Name
+#
+# pdfmult - put multiple copies of a PDF page on one page
+#
+# == Synopsis
+#
+#    pdfmult [options] file
+#
+# == Description
+#
+# +pdfmult+ 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.
+#
+# == Options
+#
+# -n, --number:: Number of copies to put on one page: 2 (default), 4, 8, 9, 16.
+#
+# -o, --output:: Output file (default: infile_NUMBER.pdf).
+#
+# -p, --pages:: Number of pages to convert.
+#               If given, +pdfmult+ does not try to obtain the page count from the source PDF.
+#
+# -h, --help:: Prints a brief help message and exits.
+#
+# -v, --version:: Prints a brief version information and exits.
+#
+# == Examples
+#
+#   pdfmult sample.pdf                 # =>  sample_2.pdf (2 copies)
+#   pdfmult -n 4 sample.pdf            # =>  sample_4.pdf (4 copies)
+#   pdfmult sample.pdf -o outfile.pdf  # =>  outfile.pdf  (2 copies)
+#   pdfmult sample.pdf -p 3            # =>  processes 3 pages
+#
+# == Author
+#
+# Copyright (C) 2011-2012 Marcus Stollsteimer
+#
+# License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
+#
+
+
+require 'optparse'
+require 'tempfile'
+require 'fileutils'
+
+# This module contains the classes for the +pdfmult+ tool
+module Pdfmult
+
+  PROGNAME  = 'pdfmult'
+  VERSION   = '1.0.0'
+  DATE      = '2012-03-15'
+  COPYRIGHT = "Copyright (C) 2011-2012 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."
+
+  PDFLATEX  = '/usr/bin/pdflatex'
+  KPSEWHICH = '/usr/bin/kpsewhich'
+
+  # Parser for the command line options.
+  # The class method parse! does the job.
+  class Optionparser
+
+    # Parses the command line options from +argv+.
+    # (+argv+ is cleared).
+    # Might print out help or version information.
+    #
+    # +argv+ - array with the command line options
+    #
+    # Returns a hash containing the option parameters.
+    def self.parse!(argv)
+
+      options = {
+        :number  => 2,
+        :infile  => nil,
+        :outfile => nil,
+        :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 'Options'
+        opt.separator ''
+
+        # process --version and --help first,
+        # exit successfully (GNU Coding Standards)
+        opt.on_tail('-h', '--help', 'Prints a brief help message and exits.') do
+          puts opt_parser
+          puts "\nReport bugs on the pdfmult home page: <https://github.com/stomar/pdfmult/>"
+          exit
+        end
+
+        opt.on_tail('-v', '--version',
+                    'Prints a brief version information and exits.') 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|
+          options[:number] = n
+        end
+
+        opt.on('-o', '--output FILE', String,
+               'Output file (default: file_2.pdf).') do |f|
+          options[:outfile] = f
+        end
+
+        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
+          options[:pages] = p
+        end
+
+        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] == '')
+
+      options[:infile] = argv.pop
+
+      # set output file unless set by option
+      options[:outfile] ||= options[:infile].gsub(/(.pdf)$/, '') + "_#{options[:number].to_s}.pdf"
+
+      options
+    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.
+  #
+  # The method +to_s+ returns the document as multiline string.
+  class LaTeXDocument
+
+    attr_accessor :infile, :number, :page_count
+
+    HEADER =
+      "\\documentclass[CLASSOPTIONS]{article}\n" +
+      "\\usepackage{pdfpages}\n" +
+      "\\pagestyle{empty}\n" +
+      "\\setlength{\\parindent}{0pt}\n" +
+      "\\begin{document}%\n"
+
+    CONTENT =
+      "\\includepdf[pages={PAGES},nup=GEOMETRY]{FILENAME}%\n"
+
+    FOOTER =
+      '\end{document}'
+
+    # Initializes a LaTeXDocument instance.
+    #
+    # +infile+     - input file name
+    # +number+     - number of pages to put on one page
+    # +page_count+ - page count of the input file
+    def initialize(infile, number, page_count)
+      @infile = infile
+      @number = number
+      @page_count = page_count
+    end
+
+    def to_s
+      class_options = 'a4paper'
+      page_string = 'PAGE,' * (@number - 1) + 'PAGE'  # 4 copies: e.g. 1,1,1,1
+
+      case @number
+      when 2
+        class_options += ',landscape'
+        geometry = '2x1'
+      when 4
+        geometry = '2x2'
+      when 8
+        class_options += ',landscape'
+        geometry = '4x2'
+      when 9
+        geometry = '3x3'
+      when 16
+        geometry = '4x4'
+      end
+
+      content_template = CONTENT.gsub(/PAGES/, page_string).gsub(/GEOMETRY/, geometry).gsub(/FILENAME/, @infile)
+
+      content = HEADER.gsub(/CLASSOPTIONS/, class_options)
+      @page_count.times do |i|
+        content << content_template.gsub(/PAGE/,"#{i+1}")
+      end
+
+      content << FOOTER
+    end
+  end
+
+  # A class for PDF meta data (up to now only used for the page count).
+  #
+  # Create an instance with PDFInfo.new, specifying the file name.
+  # +PDFInfo+ tries to use the +pdfinfo+ system tool to obtain meta data.
+  # If successful, the attribute +page_count+ contains the page count,
+  # else the attribute is set to +nil+.
+  class PDFInfo
+
+    PDFINFOCMD = '/usr/bin/pdfinfo'
+
+    # Contains the page count of the input file, or nil.
+    attr_reader :page_count
+
+    # This is the initialization method for the class.
+    #
+    # +file+ - file name of the PDF file
+    def initialize(file, options={})
+      @page_count = nil
+      infos = Hash.new
+
+      binary = options[:pdfinfocmd] || PDFINFOCMD  # only for unit tests
+      command = "#{binary} #{file}"
+      if Application.command_available?(command)
+        infostring = `#{command}`
+        infostring.each_line do |line|
+          key, val = line.chomp.split(/\s*:\s*/, 2)
+          infos[key] = val
+        end
+        value = infos['Pages']
+        @page_count = value.to_i  unless value.nil?
+      end
+    end
+
+    # Returns true if default +pdfinfo+ system tool is available (for unit tests).
+    def self.infocmd_available? # :nodoc:
+      Application.command_available?(PDFINFOCMD + ' -v')
+    end
+  end
+
+  # The main program. It's run! method is called
+  # if the script is run from the command line.
+  # It parses the command line arguments and does the job.
+  class Application
+
+    ERRORCODE = {:general => 1, :usage => 2}
+
+    # The main program.
+    def self.run!
+
+      # parse options
+      begin
+        options = Optionparser.parse!(ARGV)
+      rescue => e
+        usage_fail(e.message)
+      end
+
+      # tests
+      general_fail("`#{PDFLATEX}' seems not to be installed")  unless command_available?("#{PDFLATEX} --version")
+      general_fail("`pdfpages.sty' seems not to be installed")  unless command_available?("#{KPSEWHICH} pdfpages.sty")
+
+      # main body #
+
+      infile = options[:infile]
+      outfile = options[:outfile]
+
+      # 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'
+
+      # set page number (get PDF info if necessary)
+      pages = options[:pages]
+      pages ||= PDFInfo.new(infile).page_count
+      pages ||= 1
+
+      # create LaTeX document
+      document = LaTeXDocument.new(infile, options[:number], pages)
+
+      Dir.mktmpdir('pdfmult') do |dir|
+        open("#{dir}/pdfmult.tex", 'w') do |f|
+          pdfpath = "#{dir}/pdfmult.pdf"
+          f.write(document.to_s)
+          f.flush
+          system("/usr/bin/pdflatex -output-directory #{dir} pdfmult.tex")
+          puts "Writing on #{outfile}."
+          FileUtils::mv(pdfpath, outfile)
+        end
+      end
+    end
+
+    # Prints an error message and exits.
+    def self.general_fail(message) # :nodoc:
+      warn "#{PROGNAME}: #{message}"
+      exit ERRORCODE[:general]
+    end
+
+    # Prints an error message and a short help information, then exits.
+    def self.usage_fail(message) # :nodoc:
+      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
+
+### call main method only if called on command line
+
+if __FILE__ == $0
+  Application.run!
+end
+
+end  # module

data/man/pdfmult.1

@@ -0,0 +1,49 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.40.4.
+.TH PDFMULT "1" "March 2012" "pdfmult 1.0.0" "User Commands"
+.SH NAME
+pdfmult \- puts multiple copies of a PDF page on one page
+.SH SYNOPSIS
+.B pdfmult
+[\fIoptions\fR] \fIfile\fR
+.SH DESCRIPTION
+pdfmult is a command line tool that
+rearranges multiple copies of a PDF page (shrunken) on one page.
+.PP
+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).
+.SH OPTIONS
+.TP
+\fB\-n\fR, \fB\-\-number\fR NUMBER
+Number of copies to put on one page: 2 (default), 4, 8, 9, 16.
+.TP
+\fB\-o\fR, \fB\-\-output\fR FILE
+Output file (default: file_2.pdf).
+.TP
+\fB\-p\fR, \fB\-\-pages\fR NUMBER
+Number of pages to convert.
+If given, pdfmult does not try to obtain the page count from the source PDF.
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Prints a brief help message and exits.
+.TP
+\fB\-v\fR, \fB\-\-version\fR
+Prints a brief version information and exits.
+.SH EXAMPLES
+ pdfmult sample.pdf                 # =>  sample_2.pdf (2 copies)
+ pdfmult -n 4 sample.pdf            # =>  sample_4.pdf (4 copies)
+ pdfmult sample.pdf -o outfile.pdf  # =>  outfile.pdf  (2 copies)
+ pdfmult sample.pdf -p 3            # =>  processes 3 pages
+.SH "REPORTING BUGS"
+Report bugs on the pdfmult home page: <https://github.com/stomar/pdfmult/>
+.SH COPYRIGHT
+Copyright \(co 2011\-2012 Marcus Stollsteimer.
+.br
+License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
+.br
+This is free software: you are free to change and redistribute it.
+.br
+There is NO WARRANTY, to the extent permitted by law.

data/pdfmult.gemspec

@@ -0,0 +1,42 @@
+require 'lib/pdfmult'
+
+version = Pdfmult::VERSION
+date    = Pdfmult::DATE
+
+Gem::Specification.new do |s|
+  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.'
+  s.summary = 'pdfmult - puts multiple copies of a PDF page on one page'
+
+  s.authors = ['Marcus Stollsteimer']
+  s.email = 'sto.mar@web.de'
+  s.homepage = 'https://github.com/stomar/pdfmult/'
+
+  s.license = 'GPL-3'
+
+  s.requirements << 'pdflatex and the pdfpages package'
+
+  s.executables = ['pdfmult']
+  s.bindir = 'bin'
+  s.require_path = 'lib'
+  s.test_files = Dir.glob('test/**/test_*.rb')
+
+  s.rdoc_options = ['--charset=UTF-8']
+
+  s.files = %w[
+      README.md
+      Rakefile
+      pdfmult.gemspec
+      pdfmult.h2m
+    ] +
+    Dir.glob('example*.*') +
+    Dir.glob('{bin,lib,man,test}/**/*')
+
+  s.add_development_dependency('rake')
+  s.add_development_dependency('minitest')
+end

data/pdfmult.h2m

@@ -0,0 +1,8 @@
+[Name]
+pdfmult \- puts multiple copies of a PDF page on one page
+
+[Examples]
+ pdfmult sample.pdf                 # =>  sample_2.pdf (2 copies)
+ pdfmult -n 4 sample.pdf            # =>  sample_4.pdf (4 copies)
+ pdfmult sample.pdf -o outfile.pdf  # =>  outfile.pdf  (2 copies)
+ pdfmult sample.pdf -p 3            # =>  processes 3 pages

data/test/sample.tex

@@ -0,0 +1,37 @@
+\documentclass[paper=A4,fontsize=120pt,parskip=half,pagesize]{scrartcl}
+
+\usepackage[utf8]{inputenc}
+\usepackage[T1]{fontenc}
+
+% Palatino / Helvetica
+\usepackage{mathpazo}
+\usepackage[scaled=.95]{helvet}
+
+\usepackage[margin=2cm]{geometry}
+
+% PDF-Metainformationen
+\usepackage[pdftitle={Sample PDF Document},
+            pdfauthor={Marcus Stollsteimer},
+            pdfkeywords={},
+            pdfpagemode=UseNone,
+            pdfstartview=FitH,% Fit Width
+            bookmarks=false%
+           ]{hyperref}
+
+\pagestyle{empty}
+
+\begin{document}
+
+\centering
+
+Page\\ One
+
+\newpage
+
+Page\\ Two
+
+\newpage
+
+Page\\ Three
+
+\end{document}

data/test/test_pdfmult.rb

@@ -0,0 +1,99 @@
+#!/usr/bin/ruby -w
+# test_pdfmult: Unit tests for the pdfmult script.
+#
+# Copyright (C) 2011-2012 Marcus Stollsteimer
+
+require 'minitest/spec'
+require 'minitest/autorun'
+require 'pdfmult'
+
+PROGNAME    = 'test_pdfmult.rb'
+PROGVERSION = '0.0.1'
+
+SRCPATH = File.dirname(__FILE__)
+
+
+describe Pdfmult::Optionparser do
+
+  it 'should return the correct default values' do
+    options = Pdfmult::Optionparser.parse!(['sample.pdf'])
+    expected = {
+      :infile => 'sample.pdf',
+      :outfile => 'sample_2.pdf',
+      :number => 2,
+      :pages => nil
+    }
+    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
+  end
+
+  it 'should not accept invalid -n option values' do
+    lambda { 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'
+  end
+
+  it 'should recognize the -p option' do
+    options = Pdfmult::Optionparser.parse!(['sample.pdf', '-p', '4'])
+    options[:pages].must_equal 4
+  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
+  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
+  end
+
+  it 'should not accept invalid options' do
+    lambda { Pdfmult::Optionparser.parse!(['-x']) }.must_raise OptionParser::InvalidOption
+  end
+end
+
+
+describe Pdfmult::LaTeXDocument do
+
+  it 'should return the expected LaTeX code' do
+    document = Pdfmult::LaTeXDocument.new('sample.pdf', 8, 3)
+    document.to_s.split(/\n/)[0].must_equal "\\documentclass[a4paper,landscape]{article}"
+    document.to_s.split(/\n/)[-2].must_equal "\\includepdf[pages={3,3,3,3,3,3,3,3},nup=4x2]{sample.pdf}%"
+  end
+end
+
+
+describe Pdfmult::PDFInfo do
+
+  before 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
+      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
+    end
+
+    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
+    end
+  end
+end

metadata

@@ -0,0 +1,105 @@
+--- !ruby/object:Gem::Specification 
+name: pdfmult
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: 
+  segments: 
+  - 1
+  - 0
+  - 0
+  version: 1.0.0
+platform: ruby
+authors: 
+- Marcus Stollsteimer
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-03-15 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.
+email: sto.mar@web.de
+executables: 
+- pdfmult
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.md
+- Rakefile
+- pdfmult.gemspec
+- pdfmult.h2m
+- example1.fig
+- example1.png
+- example2.fig
+- example2.png
+- bin/pdfmult
+- lib/pdfmult.rb
+- man/pdfmult.1
+- test/sample.tex
+- test/test_pdfmult.rb
+- test/sample.pdf
+homepage: https://github.com/stomar/pdfmult/
+licenses: 
+- GPL-3
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  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 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: 
+- pdflatex and the pdfpages package
+rubyforge_project: pdfmult
+rubygems_version: 1.7.2
+signing_key: 
+specification_version: 3
+summary: pdfmult - puts multiple copies of a PDF page on one page
+test_files: 
+- test/test_pdfmult.rb