sghtmltopdf 0.6.0-x86_64-linux → 0.7.0-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8b4831391639b8b8e6036a95d79d3c5387a4a252874bd1e6073266f751e75c1e
-  data.tar.gz: 354406630de9fd7fe0a570eb53c77fb8230f492701eaace98752ec1efb2173ff
+  metadata.gz: e593b72f956b47782af175710df5f7c0f344bc7dcc36a0228310c8c4990e2f6a
+  data.tar.gz: 9e39d7a29271656526c937dab6e61382ae61aa86be2964ed195262f053062aba
 SHA512:
-  metadata.gz: 2cabd56b41588bb310e56a33eab907175ba90e695207fe02823e0ff7f8eefd816bbab80693d251f2d30c3b12cc786a23be701aaed0189863ec982cb88399d1b7
-  data.tar.gz: bece91b0de6f4e1b81b9b8ca4977709ee57eaa36ed682d73992a870028142ede794d0a067c2fec2bf337cb3e3e6456592ebc03cf97f3b4d42c684d3917d8a3b3
+  metadata.gz: d4707b684abe170632868a2c05d90ced04b651b8991a77798a0bce4a856f9bd6c015d67bc952c0c0e80526c18d5c3fbe30c0e3ff72698ef701de7f7e6a6b284c
+  data.tar.gz: f8a8ce7d3e6d735db810fc2e40fa087f5ba69b914f111e1247cca42b766d07905fc98bb4208aa6043c7562879a0e4ae7479a785399fdc4d3e86a81e21c5f8e62

data/README.md

@@ -13,13 +13,22 @@ The engine runs inside your process through a native extension (magnus + rb-sys)
 gem "sghtmltopdf"
 ```
 
-Precompiled native gems are published for `x86_64-linux`, `aarch64-linux`, `x86_64-linux-musl`, `aarch64-linux-musl`, `arm64-darwin`, and `x86_64-darwin`.
+Precompiled native gems are published for `x86_64-linux`, `aarch64-linux`, `x86_64-linux-musl`, `aarch64-linux-musl`, `arm64-darwin`, `x86_64-darwin`, and Windows `x64-mingw-ucrt`.
 There is no build step on those platforms.
 
-Elsewhere (Windows) the gem cannot run in-process — the source gem does not carry the Rust core and will refuse to build with an explanatory message.
+Elsewhere the source gem does not carry the Rust core and will refuse to build with an explanatory message.
 Point those environments at a separate `sghtmltopdf server` process instead; see [Delegating to a server](#delegating-to-a-server).
 
-Requires Ruby >= 3.2.
+Requires Ruby >= 3.2. The precompiled gems bundle extensions for Ruby 3.2, 3.3,
+3.4, and 4.0. On Windows, use 64-bit RubyInstaller UCRT (`x64-mingw-ucrt`).
+
+For contributors building from a repository checkout on Windows, use RubyInstaller
+with its Devkit, the Rust GNU toolchain (`stable-x86_64-pc-windows-gnu`), and LLVM
+with `libclang.dll`. Set `RUSTUP_TOOLCHAIN=stable-x86_64-pc-windows-gnu`, set
+`LIBCLANG_PATH` to the LLVM `bin` directory, add it to `PATH`, and set
+`BINDGEN_EXTRA_CLANG_ARGS=--target=x86_64-w64-windows-gnu`.
+Run the build through `ridk exec bundle exec rake compile`. The precompiled gem
+does not need these tools.
 
 ## Usage
 
@@ -89,6 +98,8 @@ end
 ```
 
 View-rendering keys (`template`, `layout`, `locals`, …) go to `render_to_string`, response keys (`filename`, `disposition`, `status`) go to `send_data`, `show_as_html: true` returns the HTML instead of a PDF, and everything else is passed to the converter.
+
+`render_to_string(pdf: "invoice", template: "invoices/show")` returns PDF bytes without setting the controller response. You can then pass those bytes to `send_data` or save them elsewhere; response options such as `filename`, `disposition`, and `status` only apply to `render pdf:`.
 Converter keys are flat CLI flag names, so wicked_pdf's nested `margin: {top: 10}` becomes `margin_top: "10mm"` (with the unit spelled out); the [migration guide](https://waka.github.io/sghtmltopdf/en/migration/wicked-pdf.html) maps every key one by one.
 
 ### Assets

data/lib/sghtmltopdf/options.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require "date"
+# `Time#iso8601` comes from here before Ruby 3.4 (Rails loads it, a plain Ruby script may not).
+require "time"
 require "uri"
 
 module Sghtmltopdf
@@ -78,6 +81,11 @@ module Sghtmltopdf
       when true then [[name, nil]]
       # An array means the same option repeated. The same rule applies to each element.
       when Array then value.flat_map { |element| pairs_for(key, element) }
+      # `creation_date:` takes a moment in time. The CLI wants it as ISO 8601, so it is
+      # converted to UTC here rather than left to `to_s`, which would drop the zone for a Time
+      # and the subsecond part of a DateTime.
+      when Time, DateTime then [[name, value.to_time.getutc.iso8601]]
+      when Date then [[name, value.iso8601]]
       when Hash
         # Nesting such as wicked_pdf's `margin: {top: 10}` is not accepted. There is no
         # corresponding CLI flag, and flattening it mechanically would let even misspelled

data/lib/sghtmltopdf/renderer.rb

@@ -10,6 +10,19 @@ module Sghtmltopdf
   #
   # It is a pure Ruby class with no dependency on Rails, so it can be unit tested without Rails.
   class Renderer
+    module RenderToString
+      def render_to_string(*args, &block)
+        options = args.first.is_a?(Hash) ? args.first : args[1]
+        return super unless options.is_a?(Hash) && options.key?(:pdf)
+
+        normalized_args = args.map { |arg| arg.is_a?(Hash) ? arg.dup : arg }
+        options = _normalize_args(*normalized_args, &block)
+        renderer = Renderer.new(options.delete(:pdf), options, default_name: action_name)
+        html = super(**renderer.render_options, &block)
+        renderer.body_for(html)
+      end
+    end
+
     # The keys passed straight to `render_to_string`.
     RAILS_RENDER_KEYS = %i[
       action assigns body collection file formats handlers html inline layout
@@ -39,6 +52,7 @@ module Sghtmltopdf
     # Register the renderer with `ActionController::Renderers.add(:pdf)`.
     # Called from the Railtie's Action Controller load hook (`on_load`).
     def self.register!
+      ::ActionController::Rendering.prepend(RenderToString)
       ::ActionController::Renderers.add(:pdf) do |name, options|
         renderer = ::Sghtmltopdf::Renderer.new(name, options, default_name: action_name)
         html = render_to_string(**renderer.render_options)

data/lib/sghtmltopdf/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Sghtmltopdf
-  VERSION = "0.6.0"
+  VERSION = "0.7.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sghtmltopdf
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: x86_64-linux
 authors:
 - yo_waka
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-10-18 00:00:00.000000000 Z
+date: 2026-11-01 00:00:00.000000000 Z
 dependencies: []
 description: |
   Ruby binding for sghtmltopdf, a successor to wkhtmltopdf: an HTML-to-PDF