gkhtmltopdf 1.1.1 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 074bccbef46db0aaa81947a06ea1a1d7022b75a4916dec8d76751b96bfbc607f
-  data.tar.gz: bd007b02950a0e01a6cb1a0a68c30e3f5f16604f0489568bef0899f5f2d1e84d
+  metadata.gz: 9b1e75b29bc038ca05956a13cecbd811f766f5ce5047b044348f707e18f5fdaf
+  data.tar.gz: 6f4880a82c257459133d3d63cb9eca5b6b538095ee9278b5846d965b53edda95
 SHA512:
-  metadata.gz: e359baec50a11f2276bd1354269c59667091bbf12f9285d219616569b266f18a63c40be1349667ee7cefd5550109b93c9757705a8135dd15152762c6ab98c09c
-  data.tar.gz: 2fe00c3971f0354310bbc946531eb6facb107c7649f0d191b0210ea2fd683a726cabe18613053d498ded52558eb92791a0c522bb87f16f7ad77220c72faf075b
+  metadata.gz: ec2c49f78a33d7be7257e09bc66508d14b65880ab88b48d636580de5052abbd31a34f2544d0c7c9acb1491ddda8fe74f09ff5d22c061ea465261170ca85388ae
+  data.tar.gz: 8e518a69a0183db0f3a4545d9fc20e8654cc189df79af68b1297b74b19f96a76ad74288fc12a107aaaab038903e678ab4102ea25983f2ae38e863d11c75907d8

data/CHANGELOG.md

@@ -2,15 +2,24 @@
 
 All noteworthy changes to this project will be documented in this file.
 
+## 1.2.0 / 2026-07-31
+
+- Added `pdf_binary` methods.
+  - PDFバイナリ取得メソッドの追加
+
 ## 1.1.1 / 2026-06-29
 
-- GeckodriverのSTDOUT/STDERR追加
+- Added STDOUT/STDERR for geckodriver.
+  - GeckodriverのSTDOUT/STDERR追加
 
 ## 1.1.0 / 2026-06-29
 
-- UA設定機能の追加
-- mktmpdirの明示的な削除
-- ubuntuでの動かし方とか修正
+- Added User-Agent setting.
+  - UA設定機能の追加
+- Explicit deleted of `mktmpdir`.
+  - `mktmpdir` の明示的な削除
+- Howto and docs updated.
+  - ubuntuでの動かし方とか修正
 
 ## 1.0.0 / 2026-03-19
 

data/README.md

@@ -8,6 +8,7 @@ This gem converts HTML to PDF using Firefox's Geckodriver.
 [![Gem Version](https://badge.fury.io/rb/gkhtmltopdf.svg)](https://badge.fury.io/rb/gkhtmltopdf)
 ![Gem Total Downloads](https://img.shields.io/gem/dt/gkhtmltopdf)
 ![GitHub License](https://img.shields.io/github/license/fantasia-tech/gkhtmltopdf-rb)
+![Rspec](https://github.com/fantasia-tech/gkhtmltopdf-rb/actions/workflows/main.yml/badge.svg)
 
 ---
 
@@ -15,33 +16,19 @@ This gem converts HTML to PDF using Firefox's Geckodriver.
 
 ### 1. Install
 
-1. [Firefox](https://www.firefox.com)
-  - Ubuntu  
-    > The snap does not work correctly, so please install it from the [official source](https://support.mozilla.org/en-US/kb/install-firefox-linux).
-    ```bash
-    $ wget -q https://packages.mozilla.org/apt/repo-signing-key.gpg -O- | sudo tee /etc/apt/keyrings/packages.mozilla.org.asc > /dev/null
-    $ echo "deb [signed-by=/etc/apt/keyrings/packages.mozilla.org.asc] https://packages.mozilla.org/apt mozilla main" | tee -a /etc/apt/sources.list.d/mozilla.list > /dev/null
-    $ tee /etc/apt/preferences.d/mozilla > /dev/null << EOF
-      Package: *
-      Pin: origin packages.mozilla.org
-      Pin-Priority: 1000
-      EOF
-    $ apt install -y firefox
-    $ apt install -y fonts-noto # recommended
-    ```
-  - Debian  
-    ```bash
-    $ apt install -y firefox-esr
-    $ apt install -y fonts-noto # recommended
-    ```
-
-2. [geckodriver](https://github.com/mozilla/geckodriver)
-  - Linux (Ubuntu / Debian)  
-    ```bash
-    $ wget "https://github.com/mozilla/geckodriver/releases/download/v0.36.0/geckodriver-v0.36.0-linux64.tar.gz" -O /tmp/geckodriver.tar.gz
-    $ tar -xzf /tmp/geckodriver.tar.gz -C /usr/local/bin
-    ```
+> The following is an example of the setup on Debian 13.  
+> For other operating systems (Ubuntu / Amazon Linux), please see [here](/docs/SupportList.md).
 
+1. [Firefox](https://www.firefox.com)  
+```bash
+$ apt install -y firefox-esr
+$ apt install -y fonts-noto # recommended
+```
+2. [geckodriver](https://github.com/mozilla/geckodriver)  
+```bash
+$ wget "https://github.com/mozilla/geckodriver/releases/download/v0.36.0/geckodriver-v0.36.0-linux64.tar.gz" -O /tmp/geckodriver.tar.gz
+$ tar -xzf /tmp/geckodriver.tar.gz -C /usr/local/bin
+```
 3. gem install
   - bundler  
     ```bash
@@ -81,10 +68,18 @@ Gkhtmltopdf.open do |gkh2p|
   gkh2p.save_pdf('file:///foo/bar/test.html', 'local.pdf')
   gkh2p.save_pdf('https://f6a.net/oss/', 'with_bg.pdf', print_options: {background: true})
 end
-# set custom user-agent
+# After version 1.1.0: set custom user-agent
 Gkhtmltopdf.open(user_agent: 'YOUR USER AGENT') do |gkh2p|
   gkh2p.save_pdf('https://f6a.net/oss/', 'ua.pdf')
 end
+# After version 1.2.0: get PDF binary
+Gkhtmltopdf.open do |gkh2p|
+  pdf_obj = gkh2p.pdf_binary('https://f6a.net/oss/', print_options: {background: true})
+  # for example, If the PDF size between 16KB and 1MB, write binary to a file.
+  max = 1 * 1000 * 1000
+  min = 16 * 1000
+  File.binwrite('binary.pdf', pdf_obj) if pdf_obj.bytesize.between?(min, max)
+end
 ```
 
 #### Shell

data/TODO.md

@@ -26,14 +26,14 @@
 
 - [x] GeckodriverのSTDOUT/STDERR追加
 
-## つぎ v1.2.0
+## 完了 v1.2.0
 
-- [ ] 設定のStruct化?(default切り出し)
-- [ ] pdfをsaveせずバイナリを直接返却するメソッドの追加
-- [ ] 肥大化したconvert.rbの分割( `Gkhtmltopdf::PDF` とかつくるか)
+- [x] pdfをsaveせずバイナリを直接返却するメソッドの追加
 
 ## 検討中
 
+- [ ] 設定のStruct化?(default切り出し)
+- [ ] 肥大化したconvert.rbの分割( `Gkhtmltopdf::PDF` とかつくるか)
 - [ ] ポート範囲設定?
 - [ ] YARD追加
 - [ ] FireFox timeout

data/dockerfiles/Dockerfile.amazonlinux2023-ruby32

@@ -0,0 +1,21 @@
+# syntax=docker/dockerfile:1.7
+FROM amazonlinux:2023
+RUN yum check-update
+RUN yum install -y wget tar git gzip ruby3.2 ruby3.2-devel libyaml-devel
+RUN yum groupinstall -y "Development Tools"
+
+# Install Noto Fonts
+RUN yum install -y google-noto-cjk-fonts
+RUN yum install -y google-noto-emoji-fonts
+
+# Install Firefox
+RUN yum install -y firefox
+
+# Install Geckodriver
+RUN wget "https://github.com/mozilla/geckodriver/releases/download/v0.36.0/geckodriver-v0.36.0-linux64.tar.gz" -O geckodriver.tar.gz
+RUN tar -xzf geckodriver.tar.gz -C /usr/local/bin
+
+COPY . /app
+WORKDIR /app
+RUN bundle install
+CMD ["bundle", "exec", "rspec"]

data/dockerfiles/Dockerfile.debian13-ruby34

@@ -0,0 +1,20 @@
+# syntax=docker/dockerfile:1.7
+FROM ruby:3.4-slim
+
+RUN apt-get update
+RUN apt-get install -y git wget xz-utils build-essential libyaml-dev
+
+# Install Noto Fonts
+RUN apt-get install -y fonts-noto
+
+# Install Firefox
+RUN apt-get install -y firefox-esr
+
+# Install Geckodriver
+RUN wget "https://github.com/mozilla/geckodriver/releases/download/v0.36.0/geckodriver-v0.36.0-linux64.tar.gz" -O geckodriver.tar.gz
+RUN tar -xzf geckodriver.tar.gz -C /usr/local/bin
+
+COPY . /app
+WORKDIR /app
+RUN bundle install
+CMD ["bundle", "exec", "rspec"]

data/dockerfiles/Dockerfile.debian13-ruby40

@@ -0,0 +1,20 @@
+# syntax=docker/dockerfile:1.7
+FROM ruby:4.0-slim
+
+RUN apt-get update
+RUN apt-get install -y git wget xz-utils build-essential libyaml-dev
+
+# Install Noto Fonts
+RUN apt-get install -y fonts-noto
+
+# Install Firefox
+RUN apt-get install -y firefox-esr
+
+# Install Geckodriver
+RUN wget "https://github.com/mozilla/geckodriver/releases/download/v0.36.0/geckodriver-v0.36.0-linux64.tar.gz" -O geckodriver.tar.gz
+RUN tar -xzf geckodriver.tar.gz -C /usr/local/bin
+
+COPY . /app
+WORKDIR /app
+RUN bundle install
+CMD ["bundle", "exec", "rspec"]

data/docs/ForDeveloper.md

@@ -2,21 +2,44 @@
 
 ## Test
 
+### Docker build
+
 ```bash
 $ docker build -f ./dockerfiles/Dockerfile.debian13-ruby32 . -t gkhtmltopdf-d13r32
 $ docker build -f ./dockerfiles/Dockerfile.ubuntu24-ruby32 . -t gkhtmltopdf-u24r32
 $ docker build -f ./dockerfiles/Dockerfile.ubuntu26-ruby33 . -t gkhtmltopdf-u26r33
+$ docker build -f ./dockerfiles/Dockerfile.debian13-ruby34 . -t gkhtmltopdf-d13r34
+$ docker build -f ./dockerfiles/Dockerfile.debian13-ruby40 . -t gkhtmltopdf-d13r40
+$ docker build -f ./dockerfiles/Dockerfile.amazonlinux2023-ruby32 . -t gkhtmltopdf-a23r32
+```
+
+### Docker run rspec
+
+```bash
 $ docker run --rm gkhtmltopdf-d13r32
 $ docker run --rm gkhtmltopdf-u24r32
 $ docker run --rm gkhtmltopdf-u26r33
+$ docker run --rm gkhtmltopdf-d13r34
+$ docker run --rm gkhtmltopdf-d13r40
+$ docker run --rm gkhtmltopdf-a23r32
+```
+
+### Docker remove image
+
+```bash
 $ docker rmi gkhtmltopdf-d13r32
 $ docker rmi gkhtmltopdf-u24r32
 $ docker rmi gkhtmltopdf-u26r33
+$ docker rmi gkhtmltopdf-d13r34
+$ docker rmi gkhtmltopdf-d13r40
+$ docker rmi gkhtmltopdf-a23r32
 ```
 
+---
+
 ## Build
 
 ```bash
 $ gem build gkhtmltopdf.gemspec
-$ gem push
+$ gem push ~.gem
 ```

data/docs/SupportList.md

@@ -0,0 +1,13 @@
+# SupportList
+
+Operation has been verified with the following OS and Ruby versions.  
+Please refer to the Dockerfile if you are unsure how to run the application.
+
+|       OS       | Ruby|   Link   |
+|----------------|-----|----------|
+|   Debian 13    |3.2.x| [Dockerfile](/dockerfiles/Dockerfile.debian13-ruby32) |
+|   Debian 13    |3.3.x| [Dockerfile](/dockerfiles/Dockerfile.debian13-ruby33) |
+|   Debian 13    |4.0.x| [Dockerfile](/dockerfiles/Dockerfile.debian13-ruby40) |
+|  Ubuntu 24.04  |3.2.x| [Dockerfile](/dockerfiles/Dockerfile.ubuntu24-ruby32) |
+|  Ubuntu 26.04  |3.3.x| [Dockerfile](/dockerfiles/Dockerfile.ubuntu26-ruby33) |
+|AmazonLinux 2023|3.2.x| [Dockerfile](/dockerfiles/Dockerfile.amazonlinux2023-ruby32) |

data/lib/gkhtmltopdf/converter.rb

@@ -47,6 +47,13 @@ module Gkhtmltopdf
       File.binwrite(output_path, Base64.decode64(pdf_base64))
     end
 
+    def pdf_binary(url, print_options: {})
+      validate_url_scheme!(url)
+      navigate(url)
+      pdf_base64 = print_pdf(print_options)
+      Base64.decode64(pdf_base64)
+    end
+
     private
 
     def get_free_port

data/lib/gkhtmltopdf/dsl.rb

@@ -17,5 +17,9 @@ module Gkhtmltopdf
     def save_pdf(url, output_path, print_options: {})
       @converter.save_pdf(url, output_path, print_options: print_options)
     end
+
+    def pdf_binary(url, print_options: {})
+      @converter.pdf_binary(url, print_options: print_options)
+    end
   end
 end

data/lib/gkhtmltopdf/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Gkhtmltopdf
-  VERSION = '1.1.1'
+  VERSION = '1.2.0'
 end

data/spec/gkhtmltopdf/converter_spec.rb

@@ -29,6 +29,16 @@ RSpec.describe Gkhtmltopdf::Converter do
       expect(File.binread(output)).to include('/FontName')
     }
   end
+  describe '#pdf_binary' do
+    before { converter.open }
+    let(:url) { "file://#{file_fixture('test.html')}" }
+
+    subject { converter.pdf_binary(url) }
+
+    it {
+      is_expected.to include('/FontName')
+    }
+  end
   describe '#resolve_geckodriver_path!' do
     subject { converter.send(:resolve_geckodriver_path!, nil) }
     context 'geckodriver is not available' do

data/spec/gkhtmltopdf_spec.rb

@@ -24,22 +24,41 @@ RSpec.describe Gkhtmltopdf do
     let(:url) { 'https://f6a.net/oss/' }
     let(:output_path) { Dir.mktmpdir }
     after { FileUtils.remove_entry_secure(output_path) }
+    describe '.save_pdf' do
+      subject do
+        Gkhtmltopdf.open do |gk|
+          (1..3).each { |n| gk.save_pdf("#{url}?test=#{n}", File.join(output_path, "#{n}.pdf")) }
+        end
+      end
 
-    subject do
-      Gkhtmltopdf.open do |gk|
-        (1..3).each { |n| gk.save_pdf("#{url}?test=#{n}", File.join(output_path, "#{n}.pdf")) }
+      it 'successful conversion' do
+        expect { subject }.to change { Dir.glob(File.join(output_path, '*.pdf')).count }.from(0).to(3)
+        expect { subject }.not_to raise_error
       end
-    end
 
-    it 'successful conversion' do
-      expect { subject }.to change { Dir.glob(File.join(output_path, '*.pdf')).count }.from(0).to(3)
-      expect { subject }.not_to raise_error
+      context 'invalid URL' do
+        let(:url) { 'ftp://example.com' }
+        it 'raises an error' do
+          expect { subject }.to raise_error(Gkhtmltopdf::URLSchemeInvalid, 'Invalid URL scheme: (ftp)')
+        end
+      end
     end
-
-    context 'invalid URL' do
-      let(:url) { 'ftp://example.com' }
-      it 'raises an error' do
-        expect { subject }.to raise_error(Gkhtmltopdf::URLSchemeInvalid, 'Invalid URL scheme: (ftp)')
+    describe '.pdf_binary' do
+      subject do
+        Gkhtmltopdf.open do |gk|
+          pdf_binary = gk.pdf_binary("#{url}?test=binary")
+          pdf_binary.bytesize
+        end
+      end
+      it 'successful conversion' do
+        is_expected.to be > 1000
+        expect { subject }.not_to raise_error
+      end
+      context 'invalid URL' do
+        let(:url) { 'ftp://example.com' }
+        it 'raises an error' do
+          expect { subject }.to raise_error(Gkhtmltopdf::URLSchemeInvalid, 'Invalid URL scheme: (ftp)')
+        end
       end
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gkhtmltopdf
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.2.0
 platform: ruby
 authors:
 - Kazuki Sakane
@@ -82,10 +82,14 @@ files:
 - README.md
 - Rakefile
 - TODO.md
+- dockerfiles/Dockerfile.amazonlinux2023-ruby32
 - dockerfiles/Dockerfile.debian13-ruby32
+- dockerfiles/Dockerfile.debian13-ruby34
+- dockerfiles/Dockerfile.debian13-ruby40
 - dockerfiles/Dockerfile.ubuntu24-ruby32
 - dockerfiles/Dockerfile.ubuntu26-ruby33
 - docs/ForDeveloper.md
+- docs/SupportList.md
 - exe/gkhtmltopdf
 - lib/errors.rb
 - lib/gkhtmltopdf.rb