palapala_pdf 0.1.11 → 0.1.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 230cc525cd5e4bbc4d2ce9ddb0a418486bc27ad6163cef9834a67d7e23442b41
-  data.tar.gz: b283d90551ef07efe3384148b061ec0a6a18cb3bdbc9485c1e8717e6bc4979f3
+  metadata.gz: 9371e3f5558b6cac6126a9f8004e48dbbf7059e3bfbd230885d66502e1e0f931
+  data.tar.gz: 769a77ca03fb96e858991d98c0c49f2aa3de58ba0dc2e0f33207c264969ce9c4
 SHA512:
-  metadata.gz: cfcf738f7171f679d419349cce4ce0441bb3be54fc355fa9592222b04c63654d6646c6103310f8ddf56e7112a3ccc95b30ddb92db86e0ff48a12b221f8be039c
-  data.tar.gz: efa8277743d960b0d3e869ab970c8248a2f901b572d4451bf0c479c311eabbd2a810e678efad489913ced8ab2ada14e8ce7d4b4fbb7d3ccad61ce98f419ee1b2
+  metadata.gz: 3458400fa50aeb4d2e672f156e8bf81f0a8d6a2384cb4b3d8624ca0cc18adc2c8a38eb905850fcb8d73ac3a72cd61525f77f02c5c1dd26d4a1f32ec87831556c
+  data.tar.gz: f536a148a022ebed055f349362d1f90593de300ac7972e767dc26c20db7be1ee7e1437a1195fa15e4ce5f5b40dc6e623196a64e6c0cc34c3a3fdf61dba080e4e

data/README.md

@@ -18,6 +18,8 @@ And this while having the most modern HTML/CSS/JS availlable to you: flex, grid,
 
 A core goal of this project is performance, and it is designed to be exceptionally fast. By leveraging **direct communication** with a headless Chrome or Chromium browser via a **raw web socket**, the gem minimizes overhead and dependencies, enabling PDF generation at speeds that significantly outperform other solutions. Whether generating simple or complex documents, this gem ensures that your Ruby applications can handle PDF tasks efficiently and at scale.
 
+[Example: paged_css.pdf](https://raw.githubusercontent.com/palapala-app/palapala_pdf/main/examples/paged_css.pdf)
+
 ## Sponsor This Project
 
 If you find this project useful and would like to support its development, consider sponsoring or buying a coffee to help keep it going:

data/examples/headers_and_footers.rb

@@ -3,18 +3,27 @@
 $LOAD_PATH.unshift File.expand_path('../lib', __dir__)
 require 'palapala'
 
-header_template =
-  '<div style="text-align: center; font-size: 12pt; padding: 1rem; width: 100%;">Page <span class="pageNumber"></span> of <span class="totalPages"></span></div>'
+header =
+  '<div class="center">Page <span class="pageNumber"></span> of <span class="totalPages"></span></div>'
 
-footer_template =
-  '<div style="text-align: center; font-size: 12pt; padding: 1rem; width: 100%;">Generated with Palapala PDF</div>'
+left_center_right = <<~HTML
+<div style="display: flex; justify-content: space-between; width: 100%; margin-left: 1cm; margin-right: 1cm;">
+    <div style="text-align: left; flex: 1;">Left Text</div>
+    <div style="text-align: center; flex: 1;">Center Text</div>
+    <div style="text-align: right; flex: 1;">Page <span class="pageNumber"></span> of <span class="totalPages"></span></div>
+</div>
+HTML
+
+footer =
+  '<span>Generated at&nbsp;<span class="date"></span></span>'
 
 Palapala::Pdf.new(
   "<h1>Title</h1><p>Hello world #{Time.now}</>",
-  header_template:,
-  footer_template:,
-  margin_top: 3,
-  margin_bottom: 3).save('headers_and_footers.pdf')
+  header: left_center_right,
+  footer:,
+  margin_top: 1,
+  margin_left: 1,
+  margin_bottom: 1).save('headers_and_footers.pdf')
 
 puts "Generated headers_and_footers.pdf"
 # `open headers_and_footers.pdf`

data/examples/paged_css.rb

@@ -43,6 +43,7 @@ document = <<~HTML
         margin: 0;
         padding: 0;
         font-family: Arial, sans-serif;
+        /* background-color: yellow; */
       }
       h1 {
         page-break-before: always;
@@ -165,21 +166,21 @@ end
 def header_footer_template(debug_color: nil)
   <<~HTML
   #{ debug(color: debug_color) if debug_color }
-  <div style="text-align: center; font-size: 12pt; padding: 1rem; width: 100%;">#{yield}</div>
+  <div style="font-size: 12pt;">#{yield}</div>
   HTML
 end
 
-footer_template = header_footer_template do
+footer = header_footer_template do
   "Page <span class='pageNumber'></span> of <span class='totalPages'></span>"
 end
 
-header_template = header_footer_template do
+header = header_footer_template do
   "Generated with Palapala PDF"
 end
 
 Palapala::Pdf.new(document,
-                  header_template:,
-                  footer_template:).save("paged_css.pdf")
+                  header:,
+                  footer:).save("paged_css.pdf")
 
 puts "Generated paged_css.pdf"
 

data/lib/palapala/chrome_process.rb

@@ -82,7 +82,7 @@ module Palapala
         # Display the version
         system("#{chrome_path} --version") if Palapala.debug
         # Launch chrome-headless-shell with the --remote-debugging-port parameter
-        params = [ "--disable-gpu", "--remote-debugging-port=9222" ]
+        params = [ "--disable-gpu", "--remote-debugging-port=9222", "--remote-debugging-address=0.0.0.0" ]
         params.merge!(Palapala.chrome_params) if Palapala.chrome_params
         pid = if Palapala.debug
           spawn(chrome_path, *params)

data/lib/palapala/pdf.rb

@@ -12,8 +12,10 @@ module Palapala
     #
     # @param content [String] the HTML content to convert to PDF
     # @param footer_html [String] the HTML content for the footer
+    # @param footer [String] the footer content that is centered
     # @param generate_tagged_pdf [Boolean] whether to generate a tagged PDF
     # @param header_html [String] the HTML content for the header
+    # @param header [String] the header content that is centered
     # @param landscape [Boolean] whether to use landscape orientation
     # @param margin_bottom [Integer] the bottom margin in inches
     # @param margin_left [Integer] the left margin in inches
@@ -27,8 +29,10 @@ module Palapala
     # @param scale [Float] the scale of the PDF rendering
     def initialize(content,
                    footer_template: nil,
+                   footer: nil,
                    generate_tagged_pdf: nil,
                    header_template: nil,
+                   header: nil,
                    landscape: nil,
                    margin_bottom: nil,
                    margin_left: nil,
@@ -42,8 +46,10 @@ module Palapala
                    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]
+      raise(ArgumentError, "Either footer or footer_template is expected") if !footer_template.nil? && !footer.nil?
+      raise(ArgumentError, "Either header or header_template is expected") if !header_template.nil? && !header.nil?
+      @opts[:headerTemplate]      = header_template      || hf_template(from: header) || Palapala.defaults[:header_template]
+      @opts[:footerTemplate]      = footer_template      || hf_template(from: footer) || 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]
@@ -61,6 +67,20 @@ module Palapala
       @opts.compact!
     end
 
+    def hf_template(from:)
+      return if from.nil?
+      style = <<~HTML.freeze
+        <style>
+          #header, #footer {
+            font-size: 10pt;
+            display: flex;
+            justify-content: center;
+          }
+        </style>
+      HTML
+      style + from
+    end
+
     # 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.

data/lib/palapala/renderer.rb

@@ -103,8 +103,20 @@ module Palapala
       Base64.decode64(result["data"])
     end
 
+    def ping
+      result = send_command_and_wait_for_result("Runtime.evaluate", params: { expression: "1 + 1" })
+      raise "Ping failed" unless result["result"]["value"] == 2
+    end
+
     def self.html_to_pdf(html, params: {})
       thread_local_instance.html_to_pdf(html, params: params)
+    rescue StandardError
+      reset # Reset the renderer on error, the websocket connection might be broken
+      thread_local_instance.html_to_pdf(html, params: params) # Retry (once)
+    end
+
+    def self.ping
+      thread_local_instance.ping
     end
 
     def close

data/lib/palapala/version.rb

@@ -1,3 +1,3 @@
 module Palapala
-  VERSION = "0.1.11"
+  VERSION = "0.1.12"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: palapala_pdf
 version: !ruby/object:Gem::Version
-  version: 0.1.11
+  version: 0.1.12
 platform: ruby
 authors:
 - Koen Handekyn
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-08-30 00:00:00.000000000 Z
+date: 2024-09-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64