leptris 1.9.174.1 → 1.9.174.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cd97282aa1d1c93dd600491c6209a122c436effa4cf65e9c3f5e71d830343aac
-  data.tar.gz: 28e2d7a97cb72d10059674d512ffc657b3a22d3c2be28b1002c45192c05cb11a
+  metadata.gz: fb172d69b816cff764e249cd5708a2394e7e4886a5c5281bf69160f876550c20
+  data.tar.gz: 22ff15b7a5dbaee59a9643f150662321e6f52267cb96b47c6621e73957615f46
 SHA512:
-  metadata.gz: 687c5a22ea2c1bff192be56174588d1fdcb6cf6441bee2071e197950cbd095f123761bb92e15da497d0c30d9cdc394ca5c75514be82bcc98fde0ad449a80c44c
-  data.tar.gz: 468d6e81dbb1c7716da5bff232cde73cf247d04d0f895a842be8511aef07abfb8b2ad2f2f872bca25a8995397be27b2b89fc43d21c2cebb172622856dd106eac
+  metadata.gz: d86e101b19a89c87b3ff67fc6fae563da827d3b389618fbada51cb9bcd387e772b474315e4d3d9f21bd6dd4bb1429df5b5f1de624787fc02db889dd6b1dc6efc
+  data.tar.gz: c20c6f8446a7aef0b0d08c672deccf1d5aaa7653fe04e8f69c6a8a1b0f641f6bb5221d44f0c28f0cabcfb901ce2762ce5eed3ed6fa427b2231935bda1c6bd9b9

data/CHANGELOG.md

@@ -5,6 +5,20 @@ 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

data/Rakefile

@@ -128,12 +128,14 @@ task :compile do
   # the library — no compile at install; resolves libleptris at
   # require time via dlsym.
   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)"
+    # #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
@@ -283,9 +285,10 @@ 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}")
-    # #207: no native bundle in Windows gems (PE cannot resolve
-    # Ruby imports without binding the build Ruby's DLL).
-    unless platform.include?("mingw")
+    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)

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.1"
+  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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: leptris
 version: !ruby/object:Gem::Version
-  version: 1.9.174.1
+  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