gkhtmltopdf 0.9.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: bbc9b80ee14f3f1a0eae169fbd5b1b48a3a14f79bccf8c23cb445720ccf256ac
+  data.tar.gz: 84596639fd0dfc5a82a5d9e16373d7b00652688f747a6c8e6fd71a9eb9280038
+SHA512:
+  metadata.gz: 587c445948f7c8552a51ad81bf98e94fb6d76d8699faa59cfbf4138633585b9a3b64cd2ad0a307723908473d7f3258434346771bc6f4921b88628f07da101b81
+  data.tar.gz: 8d5edab4799522f1121a0fc2801fff8d5133a0cd58f4a98398f65b90b40dcabda48de29ebe442341e562b2ed27c045b7d312d01a78432bb72ef1e561057a56c2

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/.ruby-version

@@ -0,0 +1 @@
+3.2.10

data/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+All noteworthy changes to this project will be documented in this file.
+
+## 0.9.0 / 2026-03-13
+
+- Achieved 100% test coverage.🎉
+- Fixed github url.
+
+## 0.8.0 / 2026-03-10
+
+- Added parallel processing support with automatic free port checking.
+- Added print options.
+- Added Dockerfile (Debian compatibility verified).
+- Added error message display when PATH errors occur.
+
+## 0.1.0 / 2026-01-09
+
+- Initial release.

data/Dockerfile

@@ -0,0 +1,16 @@
+FROM ruby:3.2-slim
+
+RUN apt-get update
+RUN apt-get install -y git wget xz-utils build-essential libyaml-dev
+
+# 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/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kazuki Sakane
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,106 @@
+# Gkhtmltopdf
+
+Gkhtmltopdf is mean Gecko HTML to PDF converter.
+
+Developed as an alternative to wkhtmltopdf.
+This gem converts HTML to PDF using Firefox's Geckodriver.
+
+---
+
+## How to
+
+### 1. Install
+
+1. [Firefox](https://www.firefox.com)
+    - for Ubuntu
+        ```Ubuntu
+        $ apt install -y firefox
+        ```
+    - for Debian
+        ```bash
+        $ apt install -y firefox-esr
+        ```
+2. [geckodriver](https://github.com/mozilla/geckodriver)
+    - for 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
+        ```
+3. gem install
+	- bundler
+        ```bash
+        $ bundle add gkhtmltopdf
+        ```
+    - other
+        ```bash
+        $ gem install gkhtmltopdf
+        ```
+
+---
+
+### 2. Using
+
+#### ruby
+
+> **⚠️ Security Warning for Web Frameworks (e.g., Ruby on Rails):**
+> If you are accepting URLs from untrusted users, you must implement strict SSRF protection. Do not pass user-input URLs directly without network-level isolation. Please read the [SSRF](#what-is-ssrf) section below for details.
+
+```ruby
+# over network
+Gkhtmltopdf.convert('https://example.com', 'example_com.pdf')
+# local file
+Gkhtmltopdf.convert('file:///foo/bar/test.html', 'local.pdf')
+# with option (print background)
+Gkhtmltopdf.convert('https://f6a.net/oss/', 'with_bg.pdf', print_options: {background: true})
+```
+
+#### shell
+
+```bash
+# over network
+$ gkhtmltopdf https://example.com/ example_com.pdf
+# local file
+$ gkhtmltopdf /foo/bar/test.html local.pdf
+# with option (print background)
+$ gkhtmltopdf https://f6a.net/oss/ with_bg.pdf --background
+# other option
+$ gkhtmltopdf --help
+```
+
+---
+
+## FAQ
+
+### Why generated blank (white-color) PDF?
+
+Due to the W3C WebDriver specification, Geckodriver does not throw an error if the target URL returns an HTTP error status (such as `404 Not Found` or `500 Internal Server Error`). If the browser successfully renders an error page, that error page will simply be converted into a PDF.
+If you need to verify the status of a URL or branch your logic based on HTTP status codes, please perform a pre-flight check using an HTTP client (e.g., `Net::HTTP` or `Faraday`) before passing the URL to this gem.
+
+### What is SSRF?
+
+SSRF is Server-Side Request Forgery.
+
+This gem passes the provided URL directly to Headless Firefox.  
+If you integrate this gem into a web service that accepts arbitrary URLs from untrusted users, it may be vulnerable to SSRF and DNS Rebinding attacks.  
+Attackers could potentially generate PDFs of internal network resources (e.g., `localhost`, `192.168.0.1`, `169.254.169.254` for cloud metadata).
+
+**Recommendation:** Do not rely solely on application-level URL validation. If you process untrusted URLs, strongly consider using network-level isolation (such as Docker container networking restrictions, iptables, or an egress proxy) to block access to private/internal IP ranges.
+
+---
+
+## Acknowledgments & Third-Party Licenses
+
+This gem acts as a wrapper and communicates with the following external open-source tools.
+
+We are deeply grateful to their developers:
+
+* Firefox: Licensed under the [MPL-2.0](https://www.mozilla.org/en-US/MPL/2.0/).
+* Geckodriver: Licensed under the [MPL-2.0](https://github.com/mozilla/geckodriver/blob/master/LICENSE).
+
+_Note: Gkhtmltopdf does not bundle these binaries. When you install and use Firefox and Geckodriver in your environment, please refer to their respective licenses._
+
+---
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](LICENSE).

data/Rakefile

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+task default: %i[]

data/TODO.md

@@ -0,0 +1,18 @@
+# TODO
+
+## 完了
+
+- [x] 並列処理対応(自動空きportチェック)
+- [x] 印刷オプションの追加
+- [x] Dockerfileの追加(Debian動作確認)
+- [x] PATHエラー時の表示追加
+- [x] 入力値検証
+- [x] テストカバレッジ100%
+
+## 未了
+
+- [ ] RubyGemsで公開
+- [ ] UA設定機能
+- [ ] ポート範囲設定
+- [ ] 複数ファイル&URLの直列実行による高速化
+- [ ] configファイルからオプションを設定

data/exe/gkhtmltopdf

@@ -0,0 +1,88 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'optparse'
+require 'gkhtmltopdf'
+
+options = {
+  print_options: {},
+  firefox_prefs: {}
+}
+
+parser = OptionParser.new do |opts|
+  opts.banner = "Usage: gkhtmltopdf [options] <URL_OR_FILE> <OUTPUT_PDF>"
+
+  opts.on("-O", "--orientation [PORTRAIT|LANDSCAPE]", "default: portrait") do |v|
+    options[:print_options][:orientation] = v.downcase
+  end
+
+  opts.on("--background", "Print background") do
+    options[:print_options][:background] = true
+  end
+
+  opts.on("--margin-top [CM]", Float, "margin top (cm)") do |v|
+    options[:print_options][:margin] ||= {}
+    options[:print_options][:margin][:top] = v
+  end
+
+  opts.on("--margin-bottom [CM]", Float, "margin bottom (cm)") do |v|
+    options[:print_options][:margin] ||= {}
+    options[:print_options][:margin][:bottom] = v
+  end
+
+  opts.on("--firefox-path [PATH]", "Firefox custom PATH") do |v|
+    options[:firefox_path] = v
+  end
+
+  opts.on("--geckodriver-path [PATH]", "geckodriver custom PATH") do |v|
+    options[:geckodriver_path] = v
+  end
+
+  opts.on("-v", "--version", "display version") do
+    puts "Gkhtmltopdf version #{Gkhtmltopdf::VERSION}"
+    exit
+  end
+
+  opts.on("-h", "--help", "display help") do
+    puts opts
+    exit
+  end
+end
+
+begin
+  parser.parse!
+
+  if ARGV.length != 2
+    puts parser.help
+    exit 1
+  end
+
+  input_url = ARGV[0]
+  output_path = ARGV[1]
+
+  unless input_url.start_with?('http://', 'https://', 'file://')
+    input_url = "file://#{File.absolute_path(input_url)}"
+  end
+
+  puts "Converting: #{input_url} -> #{output_path}"
+
+  init_options = {}
+  init_options[:firefox_path] = options.delete(:firefox_path) if options[:firefox_path]
+  init_options[:geckodriver_path] = options.delete(:geckodriver_path) if options[:geckodriver_path]
+
+  converter = Gkhtmltopdf::Converter.new(**init_options)
+  converter.convert(input_url, output_path, print_options: options[:print_options])
+
+  puts "✅ Completed PDF generation!"
+
+rescue Gkhtmltopdf::Error => e
+  warn "\e[31m[Error] #{e.message}\e[0m"
+  exit 1
+rescue OptionParser::InvalidOption => e
+  warn "\e[31m[Error] #{e.message}\e[0m"
+  puts parser.help
+  exit 1
+rescue StandardError => e
+  warn "\e[31m[Error] #{e.class}: #{e.message}\e[0m"
+  exit 1
+end

data/lib/gkhtmltopdf/converter.rb

@@ -0,0 +1,174 @@
+require 'net/http'
+require 'json'
+require 'base64'
+require 'uri'
+require 'socket'
+
+module Gkhtmltopdf
+  class Converter
+    def initialize(geckodriver_path: nil, firefox_path: nil, port: nil)
+      @geckodriver_path = resolve_geckodriver_path!(geckodriver_path)
+      @firefox_path = resolve_firefox_path!(firefox_path)
+      @port = port || get_free_port
+      @base_url = "http://127.0.0.1:#{@port}"
+    end
+
+    def convert(url, output_path, print_options: {})
+      validate_url_scheme!(url)
+
+      pid = spawn("#{@geckodriver_path} --port #{@port}", out: File::NULL, err: File::NULL)
+      wait_for_server
+
+      session_id = nil
+      begin
+        session_id = create_session
+        navigate(session_id, url)
+        
+        pdf_base64 = print_pdf(session_id, print_options)
+        File.binwrite(output_path, Base64.decode64(pdf_base64))
+      ensure
+        delete_session(session_id) if session_id
+        begin
+          Process.kill('TERM', pid)
+          Process.wait(pid)
+        rescue Errno::ESRCH, Errno::ECHILD
+          # nothing to do if the process is already terminated
+        end
+      end
+    end
+
+    private
+
+    def get_free_port
+      server = TCPServer.new('127.0.0.1', 0)
+      port = server.addr[1]
+      server.close
+      port
+    end
+
+    def resolve_geckodriver_path!(provided_path)
+      path = provided_path || find_default_geckodriver
+      unless path
+        raise Error, "Geckodriver is not found. Please ensure Geckodriver is installed and either in your PATH or specify the path during initialization."
+      end
+      path
+    end
+
+    def resolve_firefox_path!(provided_path)
+      path = provided_path || find_default_firefox
+      unless path
+        raise Error, "Firefox is not found. Please ensure Firefox is installed and either in your PATH or specify the path during initialization."
+      end
+      path
+    end
+
+    def executable_exists?(cmd)
+      exts = ENV['PATHEXT'] ? ENV['PATHEXT'].split(';') : ['']
+      ENV['PATH'].to_s.split(File::PATH_SEPARATOR).each do |path|
+        exts.each do |ext|
+          exe = File.join(path, "#{cmd}#{ext}")
+          return true if File.executable?(exe) && !File.directory?(exe)
+        end
+      end
+      false
+    end
+
+    def find_default_geckodriver
+      return 'geckodriver' if executable_exists?('geckodriver')
+      nil
+    end
+
+    def find_default_firefox
+      return 'firefox' if executable_exists?('firefox')
+
+      common_paths = [
+        '/Applications/Firefox.app/Contents/MacOS/firefox',
+        'C:/Program Files/Mozilla Firefox/firefox.exe',
+        'C:/Program Files (x86)/Mozilla Firefox/firefox.exe'
+      ]
+      common_paths.find { |path| File.executable?(path) && !File.directory?(path) }
+    end
+
+    def wait_for_server
+      10.times do
+        begin
+          Net::HTTP.get(URI("#{@base_url}/status"))
+          return
+        rescue Errno::ECONNREFUSED
+          sleep 0.2
+        end
+      end
+      raise Error, "Failed to launch geckodriver (port #{@port})"
+    end
+
+    def post(path, payload)
+      uri = URI("#{@base_url}#{path}")
+      req = Net::HTTP::Post.new(uri, 'Content-Type' => 'application/json')
+      req.body = payload.to_json
+      res = Net::HTTP.start(uri.hostname, uri.port) { |http| http.request(req) }
+
+      begin
+        JSON.parse(res.body)
+      rescue JSON::ParserError
+        raise Error, "Invalid geckodriver response (Status: #{res.code}): #{res.body}"
+      end
+    end
+
+    def create_session
+      firefox_options = { args: ["-headless"] }
+      firefox_options[:binary] = @firefox_path if @firefox_path != 'firefox'
+
+      payload = {
+        capabilities: {
+          alwaysMatch: {
+            browserName: "firefox",
+            "moz:firefoxOptions": firefox_options
+          }
+        }
+      }
+
+      response = post("/session", payload)
+      value = response["value"]
+      raise Error, "Failed to launch Firefox: #{value}" if value["error"]
+
+      value["sessionId"]
+    end
+
+    def navigate(session_id, url)
+      post("/session/#{session_id}/url", { url: url })
+    end
+
+    def print_pdf(session_id, user_options)
+      default_options = {
+        background: false,
+        shrinkToFit: true,
+        orientation: "portrait",
+        page: { width: 21.0, height: 29.7 },
+        margin: { top: 1.0, bottom: 1.0, left: 1.0, right: 1.0 }
+      }
+
+      payload = default_options.merge(user_options)
+
+      response = post("/session/#{session_id}/print", payload)
+      value = response["value"]
+      raise Error, "Failed to generate PDF: #{value}" if value["error"]
+
+      value
+    end
+
+    def delete_session(session_id)
+      uri = URI("#{@base_url}/session/#{session_id}")
+      req = Net::HTTP::Delete.new(uri)
+      Net::HTTP.start(uri.hostname, uri.port) { |http| http.request(req) }
+    end
+
+    def validate_url_scheme!(url_string)
+      parsed_url = URI.parse(url_string)
+      allowed_schemes = ['http', 'https', 'file']
+      raise Error, 'URL scheme is nil' if parsed_url.scheme.nil?
+      unless allowed_schemes.include?(parsed_url.scheme)
+        raise Error, "Invalid URL scheme: #{parsed_url.scheme}"
+      end
+    end
+  end
+end

data/lib/gkhtmltopdf/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Gkhtmltopdf
+  VERSION = "0.9.0"
+end

data/lib/gkhtmltopdf.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative "gkhtmltopdf/version"
+require_relative "gkhtmltopdf/converter"
+
+module Gkhtmltopdf
+  class Error < StandardError; end
+  
+  def self.convert(url, output_path, geckodriver_path: nil, firefox_path: nil, port: nil, print_options: {})
+    converter = Converter.new(geckodriver_path: geckodriver_path, firefox_path: firefox_path, port: port)
+    converter.convert(url, output_path, print_options: print_options)
+  end
+end

data/spec/fixtures/test.html

@@ -0,0 +1,58 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Test HTML</title>
+<style>
+    table {
+        width: 100%;
+        border-collapse: collapse;
+    }
+    table caption {
+        font-size: 1.25rem;
+        border-bottom: 1px solid #333333;
+    }
+    table th, table td {
+        border-bottom: 1px solid #999999;
+        padding: 0.25rem 0.5rem;
+    }
+    hr {
+        border-width: 1px 0 0;
+        margin: 1.25rem 0;
+    }
+</style>
+</head>
+<body>
+    <h1>TEST</h1>
+    <hr>
+    <table>
+        <caption>LANG</caption>
+        <tbody>
+            <tr><td>ENG</td><td>HELLO</td></tr>
+            <tr><td>FRA</td><td>BONJOUR</td></tr>
+            <tr><td>ESP</td><td>HOLA</td></tr>
+            <tr><td>ITA</td><td>CIAO</td></tr>
+            <tr><td>DEU</td><td>HALLO</td></tr>
+            <tr><td>POR</td><td>OLÁ</td></tr>
+            <tr><td>RUS</td><td>ПРИВЕТ</td></tr>
+            <tr><td>ARA</td><td>مرحبا</td></tr>
+            <tr><td>CHN</td><td>你好</td></tr>
+            <tr><td>JPN</td><td>こんにちは</td></tr>
+            <tr><td>KOR</td><td>안녕하세요</td></tr>
+        </tbody>
+    </table>
+    <hr>
+    <table>
+        <caption>EMOJI</caption>
+        <tbody>
+            <tr><td>SMILE</td><td>😀</td></tr>
+            <tr><td>LAUGH</td><td>😂</td></tr>
+            <tr><td>WINK</td><td>😉</td></tr>
+            <tr><td>HEART</td><td>❤️</td></tr>
+            <tr><td>THUMBS UP</td><td>👍</td></tr>
+            <tr><td>CLAP</td><td>👏</td></tr>
+            <tr><td>CRY</td><td>😭</td></tr>
+        </tbody>
+    </table>
+</html>

data/spec/gkhtmltopdf/converter_spec.rb

@@ -0,0 +1,46 @@
+require 'spec_helper'
+require 'gkhtmltopdf'
+
+RSpec.describe Gkhtmltopdf::Converter do
+  let(:converter) { Gkhtmltopdf::Converter.allocate }
+  describe '#resolve_geckodriver_path!' do
+    subject { converter.send(:resolve_geckodriver_path!, nil) }
+    context 'geckodriver is not available' do
+      before { allow(File).to receive(:executable?).and_return(false) }
+      it 'raises an error' do
+        expect { subject }.to raise_error(Gkhtmltopdf::Error, /\AGeckodriver is not found./)
+      end
+    end
+  end
+
+  describe '#resolve_firefox_path!' do
+    subject { converter.send(:resolve_firefox_path!, nil) }
+    context 'firefox is not available' do
+      before { allow(File).to receive(:executable?).and_return(false) }
+      it 'raises an error' do
+        expect { subject }.to raise_error(Gkhtmltopdf::Error, /\AFirefox is not found./)
+      end
+    end
+  end
+  describe '#wait_for_server' do
+    subject { converter.send(:wait_for_server) }
+    context 'fail launch geckodriver' do
+      before { allow(Net::HTTP).to receive(:get).and_raise(Errno::ECONNREFUSED, 'Dummy error') }
+      it 'raises an error' do
+        expect { subject }.to raise_error(Gkhtmltopdf::Error, /\AFailed to launch geckodriver \(port \)\Z/)
+      end
+    end
+  end
+  describe '#post' do
+    let(:converter) { Gkhtmltopdf::Converter.new }
+    subject { converter.send(:post, '/dummy', {test: :value}) }
+    context 'Invalid json response from geckodriver' do
+      before {
+        allow(Net::HTTP).to receive(:start).and_return(Struct.new(:code, :body).new('200', 'invalid_json: 0123'))
+      }
+      it 'raises an error' do
+        expect { subject }.to raise_error(Gkhtmltopdf::Error, 'Invalid geckodriver response (Status: 200): invalid_json: 0123')
+      end
+    end
+  end
+end

data/spec/gkhtmltopdf_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+require 'gkhtmltopdf'
+require 'tmpdir'
+require 'base64'
+
+RSpec.describe Gkhtmltopdf do
+  describe '.convert' do
+    let(:url) { 'https://f6a.net/oss/' }
+    let(:output) { File.join(Dir.mktmpdir, 'output.pdf') }
+    let(:hash) { {} }
+
+    subject { Gkhtmltopdf.convert(url, output, **hash) }
+
+    it 'successful conversion' do
+      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::Error, 'Invalid URL scheme: ftp')
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,107 @@
+require 'simplecov'
+SimpleCov.start do
+  coverage_dir 'coverage'
+  add_filter '/spec/'
+  formatter SimpleCov::Formatter::MultiFormatter.new(
+    [
+      SimpleCov::Formatter::HTMLFormatter,
+      SimpleCov::Formatter::SimpleFormatter
+    ]
+  )
+end
+
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# The generated `.rspec` file contains `--require spec_helper` which will cause
+# this file to always be loaded, without a need to explicitly require it in any
+# files.
+#
+# Given that it is always loaded, you are encouraged to keep this file as
+# light-weight as possible. Requiring heavyweight dependencies from this file
+# will add to the boot time of your test suite on EVERY test run, even for an
+# individual file that may not need all of that loaded. Instead, consider making
+# a separate helper file that requires the additional dependencies and performs
+# the additional setup, and require it from the spec files that actually need
+# it.
+#
+# See https://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text for helper methods
+    # defined using `chain`, e.g.:
+    #     be_bigger_than(2).and_smaller_than(4).description
+    #     # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #     # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+  # This option will default to `:apply_to_host_groups` in RSpec 4 (and will
+  # have no way to turn it off -- the option exists only for backwards
+  # compatibility in RSpec 3). It causes shared context metadata to be
+  # inherited by the metadata hash of host groups and examples, rather than
+  # triggering implicit auto-inclusion in groups with matching metadata.
+  config.shared_context_metadata_behavior = :apply_to_host_groups
+
+  # The settings below are suggested to provide a good initial experience
+  # with RSpec, but feel free to customize to your heart's content.
+  #   # This allows you to limit a spec run to individual examples or groups
+  #   # you care about by tagging them with `:focus` metadata. When nothing
+  #   # is tagged with `:focus`, all examples get run. RSpec also provides
+  #   # aliases for `it`, `describe`, and `context` that include `:focus`
+  #   # metadata: `fit`, `fdescribe` and `fcontext`, respectively.
+  #   config.filter_run_when_matching :focus
+  #
+  #   # Allows RSpec to persist some state between runs in order to support
+  #   # the `--only-failures` and `--next-failure` CLI options. We recommend
+  #   # you configure your source control system to ignore this file.
+  #   config.example_status_persistence_file_path = "spec/examples.txt"
+  #
+  #   # Limits the available syntax to the non-monkey patched syntax that is
+  #   # recommended. For more details, see:
+  #   # https://rspec.info/features/3-12/rspec-core/configuration/zero-monkey-patching-mode/
+  #   config.disable_monkey_patching!
+  #
+  #   # This setting enables warnings. It's recommended, but in some cases may
+  #   # be too noisy due to issues in dependencies.
+  #   config.warnings = true
+  #
+  #   # Many RSpec users commonly either run the entire suite or an individual
+  #   # file, and it's useful to allow more verbose output when running an
+  #   # individual spec file.
+  #   if config.files_to_run.one?
+  #     # Use the documentation formatter for detailed output,
+  #     # unless a formatter has already been configured
+  #     # (e.g. via a command-line flag).
+  #     config.default_formatter = "doc"
+  #   end
+  #
+  #   # Print the 10 slowest examples and example groups at the
+  #   # end of the spec run, to help surface which specs are running
+  #   # particularly slow.
+  #   config.profile_examples = 10
+  #
+  #   # Run specs in random order to surface order dependencies. If you find an
+  #   # order dependency and want to debug it, you can fix the order by providing
+  #   # the seed, which is printed after each run.
+  #   #     --seed 1234
+  #   config.order = :random
+  #
+  #   # Seed global randomization in this process using the `--seed` CLI option.
+  #   # Setting this allows you to use `--seed` to deterministically reproduce
+  #   # test failures related to randomization by passing the same `--seed` value
+  #   # as the one that triggered the failure.
+  #   Kernel.srand config.seed
+end

metadata

@@ -0,0 +1,126 @@
+--- !ruby/object:Gem::Specification
+name: gkhtmltopdf
+version: !ruby/object:Gem::Version
+  version: 0.9.0
+platform: ruby
+authors:
+- Kazuki Sakane
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2026-03-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: irb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+description: |
+  Developed as an alternative to wkhtmltopdf.
+  This gem converts HTML to PDF using Firefox's Geckodriver.
+email:
+- sakane@f6a.net
+executables:
+- gkhtmltopdf
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".ruby-version"
+- CHANGELOG.md
+- Dockerfile
+- LICENSE
+- README.md
+- Rakefile
+- TODO.md
+- exe/gkhtmltopdf
+- lib/gkhtmltopdf.rb
+- lib/gkhtmltopdf/converter.rb
+- lib/gkhtmltopdf/version.rb
+- spec/fixtures/test.html
+- spec/gkhtmltopdf/converter_spec.rb
+- spec/gkhtmltopdf_spec.rb
+- spec/spec_helper.rb
+homepage: https://f6a.net/oss/
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://f6a.net/oss/
+  source_code_uri: https://github.com/fantasia-tech/gkhtmltopdf-rb
+post_install_message: "=====================================================================\nGkhtmltopdf
+  has been installed successfully. \U0001F389\n\n⚠️ Caution\nRequired: To run this
+  gem, you need to have `firefox` and `geckodriver` installed and added to your PATH.\n\ncheck
+  [readme.md](https://github.com/fantasia-tech/gkhtmltopdf-rb/blob/main/README.md)
+  for more details.\n=====================================================================\n"
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements:
+- Firefox
+- Geckodriver
+rubygems_version: 3.4.19
+signing_key:
+specification_version: 4
+summary: Gkhtmltopdf is mean Gecko HTML to PDF converter.
+test_files: []