leptris 1.9.174.0 → 1.9.174.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e3fde2c39415a90a71f3505346bc86012166fccc1fa63b1918e97d1d6c7d0d3
-  data.tar.gz: 3df812e0ed1b0c00cbceacff3c59c37fbe468ada8a05eb411ad6e89b792cb09e
+  metadata.gz: fb172d69b816cff764e249cd5708a2394e7e4886a5c5281bf69160f876550c20
+  data.tar.gz: 22ff15b7a5dbaee59a9643f150662321e6f52267cb96b47c6621e73957615f46
 SHA512:
-  metadata.gz: 5f89f5a33495dfe354d6f87302981f998249c10fc0e7c64901c0b85234cb4d621c43612b221322e7e199a608217db9f94b5b4c728eb58ff2a905f352dc0f0fcf
-  data.tar.gz: b0245f06f74abbf56462dd2596e071a5034f903b0567a45c57987e96d94f36552f1aba1d0d0b2f476f4715d20cef5512384da4118da567fe00c150fa8fd9e5df
+  metadata.gz: d86e101b19a89c87b3ff67fc6fae563da827d3b389618fbada51cb9bcd387e772b474315e4d3d9f21bd6dd4bb1429df5b5f1de624787fc02db889dd6b1dc6efc
+  data.tar.gz: c20c6f8446a7aef0b0d08c672deccf1d5aaa7653fe04e8f69c6a8a1b0f641f6bb5221d44f0c28f0cabcfb901ce2762ce5eed3ed6fa427b2231935bda1c6bd9b9

data/CHANGELOG.md

@@ -5,6 +5,42 @@ All notable changes to Leptris will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.9.174.2] - 2026-09-15
+
+### Changed
+
+- **The native layer returns to Windows, one DLL per Ruby minor
+  (#227)**: a PE DLL must bind its build Ruby's runtime, so the
+  Windows platform gems now ship `native-3.3.so` / `native-3.4.so`
+  / `native-4.0.so` and the loader picks by `RUBY_VERSION` at
+  require. The release workflow compiles each minor's artifact on
+  the Windows legs (a minor unavailable on a runner degrades to
+  the loud FFI fallback for that cell); local `rake compile` on
+  Windows builds the current minor's DLL. Windows test legs now
+  exercise the full native suite instead of FFI-only.
+
+## [1.9.174.1] - 2026-09-15
+
+### Fixed
+
+- **Prebuilt native layer now loads on every Ruby minor (#207)**:
+  the Linux bundles were linked by mkmf against
+  `libruby.so.3.3` (plus a runner-specific RUNPATH), so they
+  failed to load on Ruby 3.4/4.0 — darwin's
+  `-undefined dynamic_lookup` contract now applies on Linux too:
+  the .so links without libruby and resolves rb_* from the
+  loading interpreter, one artifact serving every Ruby minor. A
+  build-log guard fails the compile if the artifact ever
+  references libruby again.
+- **Windows platform gems no longer ship the native bundle**: a
+  PE DLL cannot leave Ruby imports unresolved — it would bind to
+  the build Ruby's `x64-ucrt-rubyNNN.dll` and fail on other
+  minors. The FFI surface is the Windows contract.
+- **The auto-enable fallback is loud**: a failed native load now
+  warns (reason + FFI notice) on stderr instead of degrading
+  silently — the silent fallback is what hid #207 behind a
+  walk-speed regression.
+
 ## [1.9.174.0] - 2026-09-15
 
 ### Changed

data/Rakefile

@@ -127,33 +127,54 @@ task :compile do
   # Opt-in native read layer ext (#185): built and vendored beside
   # the library — no compile at install; resolves libleptris at
   # require time via dlsym.
-  ext_dir = "ext/leptris/native"
-  Dir.chdir(ext_dir) do
-    sh "ruby extconf.rb"
+  if Gem.win_platform?
+    # #207: a PE DLL cannot leave Ruby imports unresolved — it
+    # binds the build Ruby's x64-ucrt-rubyNNN.dll. The Windows
+    # gems therefore ship one DLL per supported Ruby minor
+    # (native-<minor>.so), and native_layer picks by RUBY_VERSION
+    # (#227). Local compile builds just the current minor's DLL;
+    # the release workflow runs the build script under 3.3/3.4/
+    # 4.0 to produce the full set.
+    sh "#{RbConfig.ruby} ext/build_windows_native.rb"
+  else
+    ext_dir = "ext/leptris/native"
+    Dir.chdir(ext_dir) do
+      sh "ruby extconf.rb"
+      if RUBY_PLATFORM =~ /darwin/
+        # Link the bundle ourselves: setup-ruby's custom rubies
+        # make mkmf link libruby by absolute runner path no matter
+        # which RbConfig entries are cleared, and any libruby
+        # LC_LOAD_DYLIB is unresolvable on user machines. Compile
+        # via the Makefile, link with pure -undefined
+        # dynamic_lookup (Ruby symbols resolve from the loading
+        # interpreter) and a conservative deployment target.
+        sh "make native.o"
+        sh "cc -dynamic -bundle -undefined dynamic_lookup " \
+           "-mmacosx-version-min=#{ENV['MACOSX_DEPLOYMENT_TARGET'] || '11.0'} " \
+           "-o native.bundle native.o"
+      else
+        # #207: the darwin contract on Linux too — mkmf's `make`
+        # linked libruby.so.3.3 (plus a runner runpath), which
+        # failed to load on 3.4/4.0. Link WITHOUT libruby: one
+        # .so serves every Ruby minor; rb_* resolve from the
+        # loading interpreter at dlopen (static rubies export
+        # their symbols via -rdynamic, like any extension .so).
+        sh "make native.o"
+        sh "#{RbConfig::CONFIG['CC']} -shared -fPIC -o native.so native.o"
+        # Guard the contract in the build log.
+        sh "if strings native.so | grep -q libruby; then " \
+           "echo 'ERROR: native.so links libruby (#207)'; exit 1; fi"
+      end
+    end
+    bundle = Dir.glob("#{ext_dir}/native.{bundle,so,dll}").first
+    raise "native layer bundle not found after build" unless bundle
     if RUBY_PLATFORM =~ /darwin/
-      # Link the bundle ourselves: setup-ruby's custom rubies make
-      # mkmf link libruby by absolute runner path no matter which
-      # RbConfig entries are cleared, and any libruby
-      # LC_LOAD_DYLIB is unresolvable on user machines. Compile
-      # via the Makefile, link with pure -undefined dynamic_lookup
-      # (Ruby symbols resolve from the loading interpreter) and a
-      # conservative deployment target.
-      sh "make native.o"
-      sh "cc -dynamic -bundle -undefined dynamic_lookup " \
-         "-mmacosx-version-min=#{ENV['MACOSX_DEPLOYMENT_TARGET'] || '11.0'} " \
-         "-o native.bundle native.o"
-    else
-      sh "make"
+      # Build-log proof of the linkage contract: libSystem only.
+      puts `otool -L #{bundle}`
     end
+    cp(bundle, "lib/leptris/xml/#{File.basename(bundle)}")
+    puts "Vendored native layer (#{File.basename(bundle)}) into lib/leptris/xml/"
   end
-  bundle = Dir.glob("#{ext_dir}/native.{bundle,so,dll}").first
-  raise "native layer bundle not found after build" unless bundle
-  if RUBY_PLATFORM =~ /darwin/
-    # Build-log proof of the linkage contract: libSystem only.
-    puts `otool -L #{bundle}`
-  end
-  cp(bundle, "lib/leptris/xml/#{File.basename(bundle)}")
-  puts "Vendored native layer (#{File.basename(bundle)}) into lib/leptris/xml/"
 end
 
 task spec: :compile unless ENV.key?("LEPTRIS_LIB_PATH")
@@ -264,7 +285,12 @@ platforms.each do |platform|
     spec.platform = Gem::Platform.new(platform)
     spec.files += Dir.glob("lib/libleptris.{dll,so,dylib}")
     spec.files += Dir.glob("lib/{libutf8proc.3.dylib,libutf8proc.so.3,libutf8proc.so,utf8proc.dll}")
-    spec.files += Dir.glob("lib/leptris/xml/native.{bundle,so,dll}")
+    if platform.include?("mingw")
+      # #207/#227: per-Ruby-minor DLLs (PE must bind its Ruby).
+      spec.files += Dir.glob("lib/leptris/xml/native-*.so")
+    else
+      spec.files += Dir.glob("lib/leptris/xml/native.{bundle,so,dll}")
+    end
     task = Gem::PackageTask.new(spec)
     task.define
   end

data/ext/build_windows_native.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+# Builds the native read layer DLL for the CURRENT Ruby and
+# installs it under its minor-versioned name
+# (lib/leptris/xml/native-<major.minor>.so).
+#
+# #207/#227: a PE DLL cannot resolve Ruby imports lazily — it
+# must bind the build Ruby's x64-ucrt-rubyNNN.dll. One DLL per
+# supported minor therefore ships in the Windows platform gems,
+# and native_layer picks by RUBY_VERSION at require.
+#
+# Standalone by design: the release workflow runs this under each
+# Ruby minor (3.3/3.4/4.0) with no bundler context.
+
+require "rbconfig"
+require "fileutils"
+
+root = File.expand_path("..", __dir__)
+ext_dir = File.join(root, "ext", "leptris", "native")
+minor = RUBY_VERSION[/\A\d+\.\d+/]
+
+Dir.chdir(ext_dir) do
+  system(RbConfig.ruby, "extconf.rb") or abort "extconf failed under #{RUBY_VERSION}"
+  # mkmf's link binds the CURRENT Ruby's runtime DLL — exactly
+  # what the versioned naming is for.
+  success = system("make")
+  abort "make failed under #{RUBY_VERSION}" unless success
+  so = Dir.glob("native.{so,dll}").first
+  abort "native bundle not produced under #{RUBY_VERSION}" unless so
+  dest = File.join(root, "lib", "leptris", "xml", "native-#{minor}.so")
+  # The artifact must reference only this minor's Ruby DLL.
+  imported = `strings #{so} 2>/dev/null`[/[a-z0-9-]*ruby\d{3,}\.dll/i]
+  if imported && !imported.include?("ruby#{minor.delete('.')}")
+    abort "#{so} imports #{imported} but was built under #{RUBY_VERSION} — refuse to mis-name it"
+  end
+  FileUtils.cp(so, dest)
+  puts "Installed native layer for Ruby #{minor} -> #{dest} (#{imported || 'no ruby dll string found'})"
+end

data/lib/leptris/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Leptris
-  VERSION = "1.9.174.0"
+  VERSION = "1.9.174.2"
 end

data/lib/leptris/xml/native_layer.rb

@@ -17,11 +17,17 @@
 require "ffi" unless defined?(::FFI::Library)
 
 begin
-  # The compiled bundle (feature "leptris/xml/native" resolves
-  # native.bundle). A sanctioned require exception: a .bundle
-  # cannot go through autoload. Missing in installs that do not
-  # vendor it (ruby-platform gem).
-  require "leptris/xml/native"
+  # The compiled bundle. A sanctioned require exception: a
+  # .bundle/.so cannot go through autoload. Missing in installs
+  # that do not vendor it (ruby-platform gem). Windows names the
+  # artifact per Ruby minor (#207/#227): a PE DLL must bind its
+  # build Ruby's runtime, so one DLL per supported minor ships
+  # and RUBY_VERSION selects.
+  if Gem.win_platform?
+    require "leptris/xml/native-#{RUBY_VERSION[/\A\d+\.\d+/]}"
+  else
+    require "leptris/xml/native"
+  end
 rescue LoadError => e
   raise LoadError, <<~MSG
     leptris: the compiled native read layer is not available in

data/lib/leptris.rb

@@ -42,7 +42,12 @@ end
 unless ENV["LEPTRIS_NO_NATIVE"] == "1"
   begin
     require "leptris/xml/native_layer"
-  rescue LoadError
-    nil
+  rescue LoadError => e
+    # #207: a silent fallback hides a platform-gem packaging bug
+    # behind a walk-speed regression. Say so, then continue on
+    # the FFI surface (the explicit require still raises its full
+    # error for callers that opt in).
+    warn "leptris: native acceleration unavailable " \
+         "(#{e.message.lines.first.strip}); using the FFI surface"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: leptris
 version: !ruby/object:Gem::Version
-  version: 1.9.174.0
+  version: 1.9.174.2
 platform: ruby
 authors:
 - Ribose Inc.
@@ -115,6 +115,7 @@ files:
 - docs/adr/0004-lifetime-guard.md
 - docs/adr/0005-autoload-manifest-ordering.md
 - docs/adr/0006-ruby-variant-policy.md
+- ext/build_windows_native.rb
 - ext/leptris/native/extconf.rb
 - ext/leptris/native/native.c
 - leptris.gemspec