raku-wkhtmltox's Introduction

Wkhtmltox

This modules converts HTML code to PDF or Image files using libwkhtmltox (aka wkhtmltopdf, wkhtmltoimage). It does not run wkhtmltopdf or wkhtmltoimage binaries thus no extra CPU/memory cost for each conversion operation. It is suitable for batch HTML to PDF/Image conversions.

Note: This is currently experimental and API may change. Please DO NOT use in a production environment.

Example

use v6;
use Wkhtmltox::PDF;

# Print library version
my $version = Wkhtmltox::PDF.version;
say "wkhtmltopdf version: $version";

# Create pdf object
my $pdf = Wkhtmltox::PDF.new;

# Print global setting values
say $pdf.get-global-setting("size.pageSize");

# Set global settings values
$pdf.set-global-setting("size.pageSize", "A4");

# Convert HTML to PDF
my $html = "Raku rocks!";
my $pdf-blob = $pdf.render($html);
"sample.pdf".IO.spurt($pdf-blob) if $pdf-blob.defined;

# Call only once to cleanup resources
$pdf.destroy;

Installation

Please download & install libwkhtmltox binaries.
Install this module using zef:

$ zef install Wkhtmltox

Testing

To run tests:

$ prove --ext .rakutest -ve "raku -I."

To run all tests including author tests (Please make sure Test::Meta is installed):

$ zef install Test::META
$ AUTHOR_TESTING=1 prove --ext .rakutest -ve "raku -I."

# On windows
$ $env:AUTHOR_TESTING=1; prove --ext .rakutest -ve "raku -I."

Author

Ahmad M. Zawawi, azawawi on #raku, https://github.com/azawawi/

License

MIT License

raku-wkhtmltox's People

Contributors

Stargazers

Watchers

raku-wkhtmltox's Issues

The approach to search for library is not portable

➜  ~ zef install Wkhtmltox
===> Searching for: Wkhtmltox
===> Testing: Wkhtmltox:ver<0.0.1>:auth<github:azawawi>
[Wkhtmltox] Cannot locate native library '(null)': /usr/local/lib/libwkhtmltox.so: cannot open shared object file: No such file or directory
[Wkhtmltox]   in method setup at /home/koto/.rakudobrew/versions/moar-master/install/share/perl6/core/sources/947BDAB9F96E0E5FCCB383124F923A6BF6F8D76B (NativeCall) line 293
[Wkhtmltox]   in block  at /home/koto/.rakudobrew/versions/moar-master/install/share/perl6/core/sources/947BDAB9F96E0E5FCCB383124F923A6BF6F8D76B (NativeCall) line 593
[Wkhtmltox]   in method version at /home/koto/.zef/store/Wkhtmltox-0.0.1.tar.gz/Wkhtmltox-0.0.1/lib/Wkhtmltox/PDF.pm6 (Wkhtmltox::PDF) line 28
[Wkhtmltox]   in block <unit> at t/01-version.t line 8
===> Testing [FAIL]: Wkhtmltox:ver<0.0.1>:auth<github:azawawi>
Aborting due to test failure: Wkhtmltox:ver<0.0.1>:auth<github:azawawi> (use --force-test to override)