Class: Palapala::Pdf

Inherits:
Object
  • Object
show all
Defined in:
lib/palapala/pdf.rb

Overview

Page class to generate PDF from HTML content using Chrome in headless mode in a thread-safe way

Instance Method Summary collapse

Constructor Details

#initialize(content, footer_template: nil, generate_tagged_pdf: nil, header_template: nil, landscape: nil, margin_bottom: nil, margin_left: nil, margin_right: nil, margin_top: nil, page_ranges: nil, paper_height: nil, paper_width: nil, prefer_css_page_size: nil, print_background: nil, scale: nil) ⇒ Pdf

Initialize the PDF object with the HTML content and optional parameters.

The options are passed to the renderer when generating the PDF. The options are the snakified version of the options from the Chrome DevTools Protocol to respect the Ruby conventions. (see chromedevtools.github.io/devtools-protocol/tot/Page/#method-printToPDF)

Parameters:

  • content (String) —

    the HTML content to convert to PDF

  • footer_html (String) —

    the HTML content for the footer

  • generate_tagged_pdf (Boolean) (defaults to: nil) —

    whether to generate a tagged PDF

  • header_html (String) —

    the HTML content for the header

  • landscape (Boolean) (defaults to: nil) —

    whether to use landscape orientation

  • margin_bottom (Integer) (defaults to: nil) —

    the bottom margin in inches

  • margin_left (Integer) (defaults to: nil) —

    the left margin in inches

  • margin_right (Integer) (defaults to: nil) —

    the right margin in inches

  • margin_top (Integer) (defaults to: nil) —

    the top margin in inches

  • page_ranges (String) (defaults to: nil) —

    the page ranges to print, e.g., “1-3, 5, 7-9”

  • paper_height (Integer) (defaults to: nil) —

    the paper height in inches

  • paper_width (Integer) (defaults to: nil) —

    the paper width in inches

  • prefer_css_page_size (Boolean) (defaults to: nil) —

    whether to prefer CSS page size (advised)

  • print_background (Boolean) (defaults to: nil) —

    whether to print background graphics

  • scale (Float) (defaults to: nil) —

    the scale of the PDF rendering



28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
 
# File 'lib/palapala/pdf.rb', line 28

def initialize(content,
               footer_template: nil,
               generate_tagged_pdf: nil,
               header_template: nil,
               landscape: nil,
               margin_bottom: nil,
               margin_left: nil,
               margin_right: nil,
               margin_top: nil,
               page_ranges: nil,
               paper_height: nil,
               paper_width: nil,
               prefer_css_page_size: nil,
               print_background: nil,
               scale: nil)
  @content = content || raise(ArgumentError, "Content is required and can't be nil")
  @opts = {}
  @opts[:headerTemplate]    = header_template      || Palapala.defaults[:header_template]
  @opts[:footerTemplate]    = footer_template      || Palapala.defaults[:footer_template]
  @opts[:pageRanges]        = page_ranges          || Palapala.defaults[:page_ranges]
  @opts[:generateTaggedPDF] = generate_tagged_pdf  || Palapala.defaults[:generate_tagged_pdf]
  @opts[:paperWidth]        = paper_width          || Palapala.defaults[:paper_width]
  @opts[:paperHeight]       = paper_height         || Palapala.defaults[:paper_height]
  @opts[:landscape]         = landscape            || Palapala.defaults[:landscape]
  @opts[:marginTop]         = margin_top           || Palapala.defaults[:margin_top]
  @opts[:marginLeft]        = margin_left          || Palapala.defaults[:margin_left]
  @opts[:marginBottom]      = margin_bottom        || Palapala.defaults[:margin_bottom]
  @opts[:marginRight]       = margin_right         || Palapala.defaults[:margin_right]
  @opts[:preferCSSPageSize] = prefer_css_page_size || Palapala.defaults[:prefer_css_page_size]
  @opts[:printBackground]   = print_background     || Palapala.defaults[:print_background]
  @opts[:scale]             = scale                || Palapala.defaults[:scale]
  @opts.compact!
end

Instance Method Details

#binary_data ⇒ String

Render the PDF content to a binary string.

The params from the initializer are converted to the expected casing and merged with the options passed to this method. The options passed here are passed unchanged to the renderer and get priority over the options from the initializer. Chrome DevTools Protocol expects the options to be camelCase, see chromedevtools.github.io/devtools-protocol/tot/Page/#method-printToPDF.

Parameters:

  • opts (Hash) —

    the options to pass to the renderer

Returns:

  • (String) —

    the PDF content as a binary string



70
71
72
73
74
75
76
77
 
# File 'lib/palapala/pdf.rb', line 70

def binary_data
  puts "Rendering PDF with params: #{@opts}" if Palapala.debug
  Renderer.html_to_pdf(@content, params: @opts)
rescue StandardError => e
  puts "Error rendering PDF: #{e.message}"
  Renderer.reset
  raise
end

#save(path) ⇒ void

This method returns an undefined value.

Save the PDF content to a file

Parameters:

  • path (String) —

    the path to save the PDF file



83
84
85
 
# File 'lib/palapala/pdf.rb', line 83

def save(path)
  File.binwrite(path, binary_data)
end