leptris 1.9.201.1 → 1.9.201.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 420777c52b2a204e7d2735237901cf304444ca8577df22da44663d444b25526d
-  data.tar.gz: 5578ae956db7557409f5b73e6ba0e9a543b347e6fa73e391a1175c8cfe69c45a
+  metadata.gz: aad9938e69332952ad6bf3f10a58475f017f781fd8603dbec3c6591bb4c29b17
+  data.tar.gz: e56f8feb3a9dd9ba2e97772a1e1a10bbe0687f5fe7d60f6432ec898acc2dde9e
 SHA512:
-  metadata.gz: 69a689e63cc05325a12430ad0d0d7d3b1515e2213e23487f84182b8406f9cc44e7d66befa5448334b6593d34109523814da95465e52697b3e55cf4f144816ce4
-  data.tar.gz: 14f5a53ca0353dfca6a805ff1e2621241287e71cb79183117b90d4571ae29265361aa4ca55922ab902ee221d6f2b6aca0fdb60df232056302cb193d8e84ccb69
+  metadata.gz: a7771a13bbac1883902471c33a48979e63de5d64dff476d5b7a7c033f844feea831066e3ab079741a618a1e7c152c847b8bc0daa2e3dfa16e41af7193e9c03ea
+  data.tar.gz: 7a4e5a3557e59049de395a5d04c6c6034144a5aa253adff0b75efaaff5acd6fc6451fcf14d1378e454fbfe5faef13adec518dd581892802f328fd2ab823902b4

data/CHANGELOG.md

@@ -5,6 +5,29 @@ 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.201.1] - 2026-09-19
+
+### Changed — source-distribution doctrine
+
+- **Every platform gem now carries the full source** (engine +
+  utf8proc + `ext/`, staged under `vendor-src/` at build time,
+  ~8 MB) alongside the precompiled bundles — recompile rights per
+  the packaging doctrine. No extensions: installing a platform
+  gem never rebuilds.
+- **The ruby-platform gem is now a real sdist**: it compiles at
+  install. `extconf.rb` orchestrates the vendored sources through
+  cmake (libleptris + utf8proc into the gem's `lib/`) before
+  building the native extension. Graceful degradation is the
+  contract: no mkmf (JRuby/TruffleRuby) → no-op Makefile, install
+  proceeds on the vendored binaries / FFI; no cmake or build
+  failure → loud skip, FFI surface applies.
+- New CI proof legs (`source-install`): MRI installs the built
+  source gem and must round-trip on the **native layer**
+  (compiled at install); TruffleRuby installs the same gem and
+  must round-trip on the **FFI layer** (vendored binaries).
+  Verified locally end-to-end in an isolated GEM_HOME:
+  `SMOKE OK (native layer)`.
+
 ## [1.9.201.0] - 2026-09-19
 
 ### Changed — libleptris 1.9.199 → 1.9.201 (lockstep)

data/Rakefile

@@ -97,6 +97,25 @@ task :compile do
   sh "cmake --build #{u8_dir}/build --config Release -j 4"
   sh "cmake --install #{u8_dir}/build --prefix #{u8_prefix}"
 
+  # Source distribution (packaging doctrine): EVERY gem — binary
+  # platform gems and the ruby source gem — carries the full
+  # engine + utf8proc + ext sources so users can recompile; the
+  # ruby variant additionally compiles at install (extconf.rb
+  # orchestrates these trees). Staged under vendor-src/ at build
+  # time (gitignored); binary dirs excluded.
+  vsrc = File.expand_path("vendor-src", __dir__)
+  rm_rf(vsrc)
+  mkdir_p(vsrc)
+  {
+    build => File.join(vsrc, "libleptris"),
+    u8_dir => File.join(vsrc, "utf8proc"),
+  }.each do |src, dest|
+    cp_r(File.join(src, "."), dest)
+    # Build byproducts (the cmake tree and the install prefix
+    # carry symlinks + binaries — source only).
+    rm_rf([File.join(dest, "build"), File.join(dest, "prefix")])
+  end
+
   # libleptris 1.9.18's xslt_functions.c:270 assigns LeptrisElement
   # to LeptrisNodeRef — GCC 14 (Alpine/musl) makes incompatible
   # pointer types an error by default and the musl platform gems
@@ -221,7 +240,7 @@ task :compile do
     # 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
+  elsif %w[ruby truffleruby].include?(RUBY_ENGINE)
     ext_dir = "ext/leptris/native"
     Dir.chdir(ext_dir) do
       sh "ruby extconf.rb"
@@ -252,18 +271,26 @@ task :compile do
       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/
-      # Build-log proof of the linkage contract: libSystem only.
-      puts `otool -L #{bundle}`
+    if bundle.nil?
+      # Engines without an MRI C-ext toolchain (JRuby's mkmf is a
+      # stub): no native layer here — the FFI surface + vendored
+      # binaries apply (the sdist extconf mirrors this gate).
+      raise "native layer bundle not found after build" if
+        %w[ruby truffleruby].include?(RUBY_ENGINE)
+      warn "leptris: #{RUBY_ENGINE} — no native layer in rake compile"
+    else
+      if RUBY_PLATFORM =~ /darwin/
+        # Build-log proof of the linkage contract: libSystem only.
+        puts `otool -L #{bundle}`
+      end
+      # Atomic replace: overwriting a bundle another process still
+      # has mapped gets that loader SIGKILLed (CODESIGNING Invalid
+      # Page) — cp to a temp name, then mv.
+      dest = "lib/leptris/xml/#{File.basename(bundle)}"
+      cp(bundle, "#{dest}.new")
+      mv("#{dest}.new", dest)
+      puts "Vendored native layer (#{File.basename(bundle)}) into lib/leptris/xml/"
     end
-    # Atomic replace: overwriting a bundle another process still
-    # has mapped gets that loader SIGKILLed (CODESIGNING Invalid
-    # Page) — cp to a temp name, then mv.
-    dest = "lib/leptris/xml/#{File.basename(bundle)}"
-    cp(bundle, "#{dest}.new")
-    mv("#{dest}.new", dest)
-    puts "Vendored native layer (#{File.basename(bundle)}) into lib/leptris/xml/"
   end
 end
 
@@ -347,6 +374,14 @@ task "platform:any" do
   # checkout — the variant then carries no binaries and the
   # system-library / LEPTRIS_LIB_PATH path applies as before.
   spec.files += Dir.glob("lib/leptris/vendor/**/*")
+  # Source distribution: the ruby variant is the sdist — it carries
+  # the engine + utf8proc + ext sources AND compiles at install
+  # (extensions). Engines without mkmf (JRuby) install through the
+  # guarded extconf no-op and run on the vendored binaries / FFI.
+  spec.files += Dir.glob("vendor-src/**/*")
+  spec.files += %w[ext/leptris/native/extconf.rb
+                   ext/leptris/native/native.c]
+  spec.extensions = ["ext/leptris/native/extconf.rb"]
   task = Gem::PackageTask.new(spec)
   task.define
 end
@@ -379,6 +414,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}")
+    # Binary gems carry the source too (recompile rights), but no
+    # extensions — installing a platform gem never rebuilds.
+    spec.files += Dir.glob("vendor-src/**/*")
+    spec.files += %w[ext/leptris/native/extconf.rb
+                     ext/leptris/native/native.c]
     if platform.include?("mingw")
       # #207/#227: per-Ruby-minor DLLs (PE must bind its Ruby).
       # DOT-FREE names — MRI derives the init symbol from the

data/ext/leptris/native/extconf.rb

@@ -1,5 +1,90 @@
 # frozen_string_literal: true
 
+# Install-time build orchestration for the SOURCE (ruby-platform)
+# gem: compile libleptris (+ utf8proc) from the vendored
+# vendor-src/ trees via cmake, then build the native C extension
+# against nothing (dynamic_lookup — it dlopens the same library
+# the FFI layer loads). Graceful degradation is the contract:
+#   - no mkmf (JRuby): emit a no-op Makefile; the gem installs and
+#     runs on the vendored binaries / FFI (#160 path).
+#   - no cmake / build failure: warn and build only the extension;
+#     native_layer's resolve! falls back loudly to the FFI surface
+#     (vendored binaries or system library).
+# Platform gems ship the same sources but never run this at
+# install (they carry no extensions) — recompile rights only.
+gem_root = File.expand_path("../../..", __dir__) # <gem>/ext/leptris/native
+lib_dir = File.join(gem_root, "lib")
+vendored = File.join(gem_root, "vendor-src")
+
+# Only engines that genuinely build MRI C extensions attempt the
+# build. JRuby carries an mkmf STUB: require succeeds, but the
+# generated Makefile fails on ruby.h — route it to the no-op too.
+unless %w[ruby truffleruby].include?(RUBY_ENGINE)
+  File.write("Makefile", <<~MAKE)
+    all install clean:
+    \t@echo "leptris: no MRI C-ext toolchain on #{RUBY_ENGINE} — skipping the native extension; the FFI surface applies"
+  MAKE
+  warn "leptris: #{RUBY_ENGINE} cannot build MRI C extensions — " \
+       "installing without the compiled native layer"
+  exit 0
+end
+require "mkmf"
+
+# A prebuilt libleptris in lib/ (dev checkout after rake compile,
+# or any context that already provides one) means this extconf is
+# NOT an sdist install — skip the orchestration entirely (it also
+# keeps rake compile from redundantly rebuilding the engine into
+# vendor-src/).
+prebuilt = Dir.glob(File.join(lib_dir, "libleptris.{so,dylib,dll}")).first
+if !prebuilt && File.directory?(File.join(vendored, "libleptris")) &&
+   find_executable("cmake")
+  begin
+    u8_src = File.join(vendored, "utf8proc")
+    u8_bld = File.join(vendored, "utf8proc-build")
+    u8_pre = File.join(vendored, "utf8proc-prefix")
+    FileUtils.mkpath(u8_bld)
+    sh_ok = lambda do |*cmd|
+      system(*cmd.map(&:to_s)) or raise "command failed: #{cmd.join(' ')[0, 120]}"
+    end
+    sh_ok.call("cmake", "-B", u8_bld, "-S", u8_src,
+               "-DCMAKE_BUILD_TYPE=Release", "-DBUILD_SHARED_LIBS=ON",
+               "-DUTF8PROC_ENABLE_TESTING=OFF")
+    sh_ok.call("cmake", "--build", u8_bld, "--config", "Release", "-j",
+               ENV.fetch("MAKEFLAGS", "-j4").split.first || "-j4")
+    sh_ok.call("cmake", "--install", u8_bld, "--prefix", u8_pre)
+
+    eng_src = File.join(vendored, "libleptris")
+    eng_bld = File.join(vendored, "libleptris-build")
+    FileUtils.mkpath(eng_bld)
+    sh_ok.call("cmake", "-B", eng_bld, "-S", eng_src,
+               "-DCMAKE_BUILD_TYPE=Release",
+               "-DLEPTRIS_BUILD_SHARED=ON", "-DLEPTRIS_BUILD_STATIC=OFF",
+               "-DBUILD_TESTING=OFF", "-DLEPTRIS_BUILD_CLI=OFF",
+               "-DLEPTRIS_BUILD_BENCHMARKS=OFF", "-DLEPTRIS_BUILD_MAN_PAGES=OFF",
+               "-DLEPTRIS_ENABLE_UTF8PROC=ON",
+               "-DCMAKE_PREFIX_PATH=#{u8_pre}")
+    sh_ok.call("cmake", "--build", eng_bld, "--config", "Release",
+               ENV.fetch("MAKEFLAGS", "-j4").split.first || "-j4")
+    built = Dir.glob(File.join(eng_bld, "**", "libleptris.{so,dylib,dll}")).first
+    raise "libleptris build produced no shared library" unless built
+    ext = File.extname(built)
+    FileUtils.cp(built, File.join(lib_dir, "libleptris#{ext}"))
+    Dir.glob(File.join(u8_pre, "lib", "libutf8proc.*")).each do |u8|
+      next if File.directory?(u8)
+      base = File.basename(u8)
+      next if base.end_with?(".pc")
+      FileUtils.cp(u8, File.join(lib_dir, base)) rescue nil
+    end
+    puts "leptris: compiled libleptris from source into #{lib_dir}"
+  rescue StandardError => e
+    warn "leptris: source build skipped (#{e.message}); the gem will " \
+         "load the vendored binary or system library instead"
+  end
+else
+  warn "leptris: cmake or vendored sources unavailable — skipping the " \
+       "engine compile; vendored binaries / system library apply"
+end
+
 # The bundle must load into ANY Ruby (not the building runner's):
 # macOS links with -undefined dynamic_lookup (Ruby symbols resolve
 # from the loading interpreter — the standard C-ext convention)

data/lib/leptris/version.rb

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

data/lib/leptris/xml/ffi.rb

@@ -16,6 +16,19 @@ module Leptris
       # preference order (glibc before musl — dlopen falls through
       # on musl hosts).
       def self.vendor_platforms_for(ruby_platform)
+        # JVM engines report "x86_64-java" or bare "java" — the OS
+        # (and sometimes the arch) is lost. Rebuild cpu-os from
+        # RbConfig so the native vendor binaries resolve there too.
+        if ruby_platform =~ /java/
+          host_os = RbConfig::CONFIG["host_os"].to_s
+          if host_os =~ /mingw|mswin|windows/
+            return [] # no windows vendor tree; the .dll is gem-local
+          end
+          cpu = RbConfig::CONFIG["host_cpu"].to_s
+          cpu = "aarch64" if cpu.empty?
+          os = host_os =~ /darwin/ ? "darwin" : "linux"
+          ruby_platform = "#{cpu}-#{os}"
+        end
         case ruby_platform
         when /arm64.*darwin|aarch64.*darwin/ then %w[arm64-darwin]
         when /x86_64.*darwin/ then %w[x86_64-darwin]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: leptris
 version: !ruby/object:Gem::Version
-  version: 1.9.201.1
+  version: 1.9.201.2
 platform: ruby
 authors:
 - Ribose Inc.
@@ -60,7 +60,8 @@ description: |
 email:
 - open.source@ribose.com
 executables: []
-extensions: []
+extensions:
+- ext/leptris/native/extconf.rb
 extra_rdoc_files: []
 files:
 - CHANGELOG.md