gkhtmltopdf 1.1.1 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 074bccbef46db0aaa81947a06ea1a1d7022b75a4916dec8d76751b96bfbc607f
-  data.tar.gz: bd007b02950a0e01a6cb1a0a68c30e3f5f16604f0489568bef0899f5f2d1e84d
+  metadata.gz: d19d8c78dff4c87b9c50ea25a94f606d4485313cc37e8a553f0f5188d344fe41
+  data.tar.gz: 0c5b0b8f586920efc3a42a03e8a1da264ea8a68305424aadbca9763bed9d785d
 SHA512:
-  metadata.gz: e359baec50a11f2276bd1354269c59667091bbf12f9285d219616569b266f18a63c40be1349667ee7cefd5550109b93c9757705a8135dd15152762c6ab98c09c
-  data.tar.gz: 2fe00c3971f0354310bbc946531eb6facb107c7649f0d191b0210ea2fd683a726cabe18613053d498ded52558eb92791a0c522bb87f16f7ad77220c72faf075b
+  metadata.gz: 9854a78ecf08c217f9d27ed5288f6fcbad15d53c16eeacb2a6a47603f1fd32e43f29aa799aafaa2612dc5279bf21ec92c90d24f97b00cd89d78721a1172dabe4
+  data.tar.gz: de4240fa2f30027a76d2acfb91a0fedfcc55a7c37b1fea4bce7ce7a18a5406766dd00bbd7986176e96cbcaf3819e3011364062682c5588e8ccd7f6e16461c717

data/.ruby-version

@@ -1 +1 @@
-3.2.10
+4.0.9

data/CHANGELOG.md

@@ -2,15 +2,33 @@
 
 All noteworthy changes to this project will be documented in this file.
 
+## 1.2.1 / 2026-10-27
+
+- No new features added.
+  - 機能追加なし
+- Updated DevEnv to ruby4.
+  - 開発環境をruby4.0.9に
+- Added dockerfiles.
+  - amazonlinux2023でのテストとか追加
+
+## 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,50 @@
 
 ## 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 run --rm gkhtmltopdf-d13r32
+$ docker build -f ./dockerfiles/Dockerfile.debian13-ruby32 . -t gkhtmltopdf-d13r32
+$ docker build -f ./dockerfiles/Dockerfile.debian13-ruby33 . -t gkhtmltopdf-d13r33
+$ 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 build -f ./dockerfiles/Dockerfile.amazonlinux2023-ruby40 . -t gkhtmltopdf-a23r40
+```
+
+### Docker run rspec
+
+```bash
 $ docker run --rm gkhtmltopdf-u24r32
 $ docker run --rm gkhtmltopdf-u26r33
-$ docker rmi gkhtmltopdf-d13r32
+$ docker run --rm gkhtmltopdf-d13r32
+$ docker run --rm gkhtmltopdf-d13r33
+$ docker run --rm gkhtmltopdf-d13r34
+$ docker run --rm gkhtmltopdf-d13r40
+$ docker run --rm gkhtmltopdf-a23r32
+$ docker run --rm gkhtmltopdf-a23r40
+```
+
+### Docker remove image
+
+```bash
 $ docker rmi gkhtmltopdf-u24r32
 $ docker rmi gkhtmltopdf-u26r33
+$ docker rmi gkhtmltopdf-d13r32
+$ docker rmi gkhtmltopdf-d13r33
+$ docker rmi gkhtmltopdf-d13r34
+$ docker rmi gkhtmltopdf-d13r40
+$ docker rmi gkhtmltopdf-a23r32
+$ docker rmi gkhtmltopdf-a23r40
 ```
 
-## Build
+---
+
+## Build & Push
 
 ```bash
 $ gem build gkhtmltopdf.gemspec
-$ gem push
+$ gem push ~.gem
 ```

data/docs/SupportList.md

@@ -0,0 +1,15 @@
+# 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   |
+|----------------|-----|----------|
+|AmazonLinux 2023|3.2.x| [Dockerfile](/dockerfiles/Dockerfile.amazonlinux2023-ruby32) |
+|AmazonLinux 2023|4.0.x| [Dockerfile](/dockerfiles/Dockerfile.amazonlinux2023-ruby40) |
+|   Debian 13    |3.2.x| [Dockerfile](/dockerfiles/Dockerfile.debian13-ruby32) |
+|   Debian 13    |3.3.x| [Dockerfile](/dockerfiles/Dockerfile.debian13-ruby33) |
+|   Debian 13    |3.4.x| [Dockerfile](/dockerfiles/Dockerfile.debian13-ruby34) |
+|   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) |

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.1'
 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.1
 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
@@ -124,7 +128,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements:
 - Firefox
 - Geckodriver
-rubygems_version: 4.0.8
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Gkhtmltopdf is mean Gecko HTML to PDF converter.
 test_files: []