org_heigl / pdfunit
Unittests for comparing PDF-files
1.0.0
2015-06-17 20:37 UTC
Requires
- phpunit/phpunit: ^4.7
This package is auto-updated.
Last update: 2024-10-23 09:40:21 UTC
README
An extension to PHPUnit to test creation of PDF-Files.
About
Creating PDF-Files is always a bit difficult as the best comparison is a visual one.
As 2 PDF-Files can be internally completely different there is no way of comparing them on a source-code-level. Therefore comparing them by creating an image and comparing that to a known-good file. The differences between the two files are calculated and measured against a threshold.
Requirements
This package requires imagemagicks compare
-binary to be installed and available in the path.
Installation
$ composer require org_heigl/pdfunit
Usage
namespace Acme;
use Org_Heigl\PDFUnit\TestCase;
class PDFTest extends TestCase
{
public function testPdf()
{
$this->assertPdfDiffBelowThreshold(
'known-good.pdf',
0.4,
'generated.pdf'
);
}
}
This will compare generated.pdf
agains known-good.pdf
and checks whether the
difference is less or equals to 0.4.