palapala_pdf 0.1.12 → 0.1.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9371e3f5558b6cac6126a9f8004e48dbbf7059e3bfbd230885d66502e1e0f931
-  data.tar.gz: 769a77ca03fb96e858991d98c0c49f2aa3de58ba0dc2e0f33207c264969ce9c4
+  metadata.gz: 3a5231c5a9994723db5fafc42682644a6320a69813444bc0939e179225e7181b
+  data.tar.gz: 5f3600f8fb867ee059e1a67fcda2eeeff0d7f290c8621d8bc055e6fb4cbda39c
 SHA512:
-  metadata.gz: 3458400fa50aeb4d2e672f156e8bf81f0a8d6a2384cb4b3d8624ca0cc18adc2c8a38eb905850fcb8d73ac3a72cd61525f77f02c5c1dd26d4a1f32ec87831556c
-  data.tar.gz: f536a148a022ebed055f349362d1f90593de300ac7972e767dc26c20db7be1ee7e1437a1195fa15e4ce5f5b40dc6e623196a64e6c0cc34c3a3fdf61dba080e4e
+  metadata.gz: a50a38a6482f04f7af087b0469d0fcf0d5bc02e79f3ad2fe26a91c5b06aa07345fe15b99472355eab1daef95c3069d54e1d9990820b401872681172b278f43d2
+  data.tar.gz: 2697106dfcad72207bd20fcad857c9a474ffacf49a67fa10e1d2801a8b5c41226e9d9b7145066b78f6dc002dc951f706c1f5fd83c346b196674f59294d124bc0

data/README.md

@@ -75,7 +75,7 @@ HEADLESS_CHROME_URL=http://192.168.1.1:9222 ruby examples/performance_benchmark.
 ```
 
 ```sh
-CHROME_HEADLESS_PATH=/var/to/chrome ruby examples/performance_benchmark.rb
+HEADLESS_CHROME_PATH=/var/to/chrome ruby examples/performance_benchmark.rb
 ```
 
 **Create a PDF from HTML**
@@ -97,6 +97,7 @@ binary_data = Palapala::Pdf.new("<h1>Hello, world! #{Time.now}</h1>").binary_dat
 ## Advanced Examples
 
 - headers and footers
+- watermark
 - paged css for paper sizes, paper margins, pages breaks, etc
 - js based rendering
 
@@ -189,7 +190,29 @@ In this example, `pdf_data` is the binary data of the PDF file. The `filename` o
 
 TODO
 
-*It has also been reported that the Chrome process repeatedly crashes when running inside a Docker container on an M1 Mac. Chrome should work as expected when deployed to a Docker container on a non-M1 Mac.*
+```Dockerfile
+# Install Nodejs and Chromium, to import the chrome headless shell dependencies easily (chrome itself is not used)
+RUN curl -fsSL https://deb.nodesource.com/setup_22.x | bash - && apt-get install --no-install-recommends -y nodejs chromium && \
+    rm -rf /var/lib/apthet/lists /var/cache/apt/archives
+
+# Install Chrome Headless Shell
+RUN npx --yes @puppeteer/browsers install chrome-headless-shell@stable
+```
+
+Use a script like the below, to launch chrome headless shell from e.g. docker entrypoint script.
+
+*launch_chrome_headless_shell.rb*
+
+```sh
+#!/bin/bash
+# find the installation path of chrome headless shell (latest version)
+export CHROME_PATH=$(npx --yes @puppeteer/browsers install chrome-headless-shell@stable | awk '{print $2}')
+# start chrome headless with remote debugging on
+$CHROME_PATH --disable-gpu --remote-debugging-port=9222 --disable-software-rasterizer --disable-bluetooth --no-sandbox
+```
+
+*It has also been reported that the Chrome process repeatedly crashes when running inside a Docker container on an M1 Mac. Chrome should work asexpected when deployed to a Docker container on a non-M1 Mac.*
+
 
 ## Thread-safety
 
@@ -203,12 +226,40 @@ thread safe in the sense that every web socket get's a new tab in the underlying
 
 TODO
 
-possible buildpacks
+This buildpack installs chrome and chromedriver (chromedriver is actually not needed, but at least the buildpack is maintained)
 
-https://github.com/heroku/heroku-buildpack-chrome-for-testing
+```sh
+https://elements.heroku.com/buildpacks/heroku/heroku-buildpack-google-chrome
+```
 
-this buildpack install chrome and chromedriver, which is actually not needed, but it's maintained
+### launch as child process
 
-https://elements.heroku.com/buildpacks/heroku/heroku-buildpack-google-chrome
+set `HEADLESS_CHROME_PATH=chrome` as an ENV variable as this buildpacks adds `chrome` to the path.
 
-this buildpack installs chrome, which is all we need, but it's deprecated
+### run seperately
+
+In your `Procfile` adjust the web worker command
+
+```yaml
+web: bin/start
+```
+
+Create a bin/start script
+
+```sh
+#!/bin/bash
+# Start Rails app
+bundle exec rails server -p $PORT -e $RAILS_ENV &
+
+# Start the background app
+command_to_start_your_background_app &
+
+# Wait for all processes to finish
+wait -n
+```
+
+ensure the script is executable
+
+```sh
+chmod +x bin/start
+```

data/examples/headers_and_footers.rb

@@ -23,7 +23,8 @@ Palapala::Pdf.new(
   footer:,
   margin_top: 1,
   margin_left: 1,
-  margin_bottom: 1).save('headers_and_footers.pdf')
+  margin_bottom: 1,
+  watermark: "DRAFT").save('headers_and_footers.pdf')
 
 puts "Generated headers_and_footers.pdf"
 # `open headers_and_footers.pdf`

data/lib/palapala/pdf.rb

@@ -43,7 +43,8 @@ module Palapala
                    paper_width: nil,
                    prefer_css_page_size: nil,
                    print_background: nil,
-                   scale: nil)
+                   scale: nil,
+                   watermark: nil)
       @content = content || raise(ArgumentError, "Content is required and can't be nil")
       @opts = {}
       raise(ArgumentError, "Either footer or footer_template is expected") if !footer_template.nil? && !footer.nil?
@@ -62,11 +63,29 @@ module Palapala
       @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[:headerTemplate]      = (@opts[:headerTemplate].to_s + watermark(watermark)) if watermark
       @opts[:displayHeaderFooter] = (@opts[:headerTemplate] || @opts[:footerTemplate]) ? true : false
       @opts[:encoding]            = :binary
       @opts.compact!
     end
 
+    def watermark(watermark, angle: "-15deg", color: "rgba(25,25,25,0.25)")
+      <<~HTML
+        <style>
+          .palapala_pdf_watermark {
+            position: fixed;
+            top: 50%;
+            left: 50%;
+            transform: translate(-50%, -50%) rotate(#{angle});
+            font-size: 8em;
+            color: #{color};
+            z-index: 9999;
+          }
+        </style>
+        <span class="palapala_pdf_watermark">#{watermark}</span>
+      HTML
+    end
+
     def hf_template(from:)
       return if from.nil?
       style = <<~HTML.freeze

data/lib/palapala/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: palapala_pdf
 version: !ruby/object:Gem::Version
-  version: 0.1.12
+  version: 0.1.13
 platform: ruby
 authors:
 - Koen Handekyn