Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vokimon/visualpdfdiff
Visual side by side comparision of rendered PDF documents (CLI tool, python function, unittest assert and back2back plugin)
https://github.com/vokimon/visualpdfdiff
back-to-back compare diff pdf testing
Last synced: 1 day ago
JSON representation
Visual side by side comparision of rendered PDF documents (CLI tool, python function, unittest assert and back2back plugin)
- Host: GitHub
- URL: https://github.com/vokimon/visualpdfdiff
- Owner: vokimon
- License: agpl-3.0
- Created: 2019-11-11T08:32:41.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2023-09-11T17:58:38.000Z (over 1 year ago)
- Last Synced: 2024-11-10T23:33:21.261Z (about 2 months ago)
- Topics: back-to-back, compare, diff, pdf, testing
- Language: Python
- Homepage:
- Size: 104 KB
- Stars: 3
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Visual PDF diff
[](https://github.com/GuifiBaix/visualpdfdiff/actions/workflows/main.yml)
[](https://coveralls.io/github/GuifiBaix/visualpdfdiff?branch=master)
Visual side by side comparision of rendered PDF documents.
You can use this in several ways:
- a commandline tool to obtain the diff of two pdfs
- a Python function to do the same from other Python programs
- an equality assertion to be used in `python-unittest`
- a back-to-back assertion to be used in `python-unittest`
- an extension for the tool [`back2back`](https://github.com/vokimon/back2back) to make back-to-back tests of the PDF outputs of your commands
The generated diff looks like this:
## Installation
```
sudo apt install imagemagick # Or the equivalent if not debian based
pip install visualpdfdiff
pip install b2btest # if you want to use the back2back command
```
NOTE: visualpdfdiff requires enabling ImageMagick to handle PDF.
This is disabled by default for security reasons.
If you are running a web server accepting PDF files from outside,
please, consider the security implications.
Edit `/etc/ImageMagick-*/policy.xml` and
uncomment th line:
```xml
```
And comment the line:
```xml
```
## Comand line diff tool
```bash
visualpdfdiff a.pdf b.pdf [output-diff.pdf]
```
Returns 0 if both pdfs are raster equal, -1 if they are not.
If an output is provided the side-by-side diff pdf is generated.
Not providing an output is faster when diff exists, though,
so checking and then generating is faster when you expect, being equal most of the time.
## Python diff function
```python
from visualpdfdiff import diff
haveDifferences = diff('a.pdf', 'b.pdf', 'out.pdf')
```
## Unittest back-to-back assertion
Compares against the last validated output.
If the extension is PDF, visualpdfdiff will be chosen to detect and output the differences.
```python
class MyClass_Test(unittest.TestCase):
from b2btest import assertB2BEqual
def test_otherMethod_conditions(self):
...
self.assertB2BEqual('b.pdf')
```
## Command back2back tests
Using the back2back command.
Also, by installing this package, PDF outputs are compared using visualpdfdiff.
```yaml
myTest:
command: ./myreportscript.py -o output.pdf
outputs:
- output.pdf
```
## Similar tools
- [pdfdiff:](https://github.com/JoshData/pdf-diff)
Extracts text and diff that, then draws an outline on the text.
Better for text diffing, but not so for layout diffing.
- [qtrac's diffpdf:](http://www.qtrac.eu/diffpdf-foss.html)
A quite nice (qt-based) graphical tool that does both text and visual diffing.
Is not maintained anymore since the authors moved to a close source license.
- [vslavik's diff-pdf:](https://vslavik.github.io/diff-pdf/)
- [diff-pdf-visualy](https://github.com/bgeron/diff-pdf-visually)
Quite similar to this one, not just in name, but does not generate an output pdf
## CHANGES
### 1.0 (Unreleased)
- First version as independent module
- Previous versions were part of somenergia-oomakotest a test suite to compare outputs of mako reports generated by odoo
## TODO
- Raster resolution configurable by keywords
- Diff metadata as well
- Make an overlay fully transparent within the diff zone, and translucent gray in the matching zone