The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
 / 
PDF-PDFUnit-0.17
River stage zero No dependents
/ PDF::PDFUnit::Installation

NAME

PDF::PDFUnit::Installation - Installation instructions for PDF::PDFUnit

IMPORTANT

This Module is not useable on its own!

It it "just" a Perl wrapper around Carsten Siedentop's awesome PDFUnit (a PDF testing framework written in Java).

INSTALLATION OF PERL PREREQUISITES

The most tricky part is the installation of our main dependency: Inline::Java.

This is typically not pre-packaged in any distribution of Linux or Perl, so we have to install it by hand.

We generally recommend installing it via cpanm, as described below.

Some other dependencies should be fulfilled with distribution packages before:

Linux

Debian 8 (Jessie)

  # aptitude install openjdk-7-jdk make gcc
  # aptitude install cpanminus libinline-c-perl libtest-exception-perl
  
  # JAVA_HOME=/usr/lib/jvm/java-7-openjdk-amd64  cpanm Inline::Java

Ubuntu 14.04

  $ sudo su -
  # apt-get install openjdk-7-jdk make gcc
  # apt-get install cpanminus libinline-perl libtest-exception-perl
  
  # JAVA_HOME=/usr/lib/jvm/java-7-openjdk-amd64  cpanm Inline::Java

CentOS 7

  # yum install java-1.8.0-openjdk-devel make gcc
  # yum install perl-App-cpanminus perl-Inline perl-Test-Exception

  # JAVA_HOME=/usr/lib/jvm/java-1.8.0  cpanm Inline::Java

OpenSUSE 42.1

  # zypper install java-1_8_0-openjdk-devel make gcc
  # zypper install perl-App-cpanminus perl-Inline perl-Test-Exception

  # cpanp install Parse::PMFile  # due to broken cpanm; "yes" to question

  # JAVA_HOME=/usr/lib64/jvm/java-1.8.0-openjdk-1.8.0  cpanm Inline::Java

Windows

Windows 8.1 with Oracle JDK + ActiveState Perl 5.22.1 (both 64 Bit)

  C:\> ppm install App-cpanminus MinGW
  C:\> ppm install Inline Test-Exception

  C:\> set JAVA_HOME=C:\Program Files\Java\jdk1.8.0_92
  C:\> cpanm Inline::Java

INSTALLATION OF THE JAVA PDFUNIT LIBRARY

Download the latest release of PDFUnit-Java from http://pdfunit.com/.

Create a folder somewhere and unzip it there.

If you have received a licence file, also drop it there.

INSTALLATION OF THIS MODULE

Attention! Under Windows/ActivePerl, use dmake instead of make!

  perl Makefile.PL
  make

If you want to run the tests, you have to create a configuration file. OK, since you have to create a config anyway, now would be a good time to read PDF::PDFUnit::Config; if necessary via:

  # Linux:
  perldoc lib/PDF/PDFUnit/Config.pod

  # Windows:
  perldoc lib\PDF\PDFUnit\Config.pod

With your new config file, you should now be able to:

  make test

  # or (to get a little bit more output):

  prove -v

And finally (this requires root/Admin permissions where necessary):

  make install

If everything has succeeded up to now, please verify your setup with:

  pdfunit-perl.pl -c

Have fun with PDF::PDFUnit!