leptris 1.9.174.0 → 1.9.174.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e3fde2c39415a90a71f3505346bc86012166fccc1fa63b1918e97d1d6c7d0d3
-  data.tar.gz: 3df812e0ed1b0c00cbceacff3c59c37fbe468ada8a05eb411ad6e89b792cb09e
+  metadata.gz: cd97282aa1d1c93dd600491c6209a122c436effa4cf65e9c3f5e71d830343aac
+  data.tar.gz: 28e2d7a97cb72d10059674d512ffc657b3a22d3c2be28b1002c45192c05cb11a
 SHA512:
-  metadata.gz: 5f89f5a33495dfe354d6f87302981f998249c10fc0e7c64901c0b85234cb4d621c43612b221322e7e199a608217db9f94b5b4c728eb58ff2a905f352dc0f0fcf
-  data.tar.gz: b0245f06f74abbf56462dd2596e071a5034f903b0567a45c57987e96d94f36552f1aba1d0d0b2f476f4715d20cef5512384da4118da567fe00c150fa8fd9e5df
+  metadata.gz: 687c5a22ea2c1bff192be56174588d1fdcb6cf6441bee2071e197950cbd095f123761bb92e15da497d0c30d9cdc394ca5c75514be82bcc98fde0ad449a80c44c
+  data.tar.gz: 468d6e81dbb1c7716da5bff232cde73cf247d04d0f895a842be8511aef07abfb8b2ad2f2f872bca25a8995397be27b2b89fc43d21c2cebb172622856dd106eac

data/CHANGELOG.md

@@ -5,6 +5,28 @@ 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.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,52 @@ 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 — the
+    # bundle would bind to the build Ruby's x64-ucrt-rubyNNN.dll
+    # and fail on every other minor. No bundle ships for
+    # Windows; the FFI surface is the Windows contract (the
+    # auto-enable warns and falls back).
+    puts "Windows: native read layer not built — FFI is the Windows surface (#207)"
+  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 +283,11 @@ 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}")
+    # #207: no native bundle in Windows gems (PE cannot resolve
+    # Ruby imports without binding the build Ruby's DLL).
+    unless platform.include?("mingw")
+      spec.files += Dir.glob("lib/leptris/xml/native.{bundle,so,dll}")
+    end
     task = Gem::PackageTask.new(spec)
     task.define
   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.1"
 end

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.1
 platform: ruby
 authors:
 - Ribose Inc.