prebake 0.2.10 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5016083674e522c23d95fa0526df6b35f159e529b0d3116fc24daf70e1c52df9
-  data.tar.gz: 7a32973b781cb342998d150c5fe75b944c4865055df2f168c2bebeb48fa1450c
+  metadata.gz: 27e9af4988afacc2c07ae6e09eac8aa9efa26d44dc95401cd4f1d52e14993bd6
+  data.tar.gz: 801beefc4a2eed88cda591e6cf0b6abbef13a8f597f185eececeafd49b9e6857
 SHA512:
-  metadata.gz: b9ea7f985f4ca767edaca8598a79023e0ec9c0fe1ea9e5219a368ce4d44e4d0ef8ccb8bf8a57434fce514afc9e80694a4a72c3e2335d54ba37d2857a8d43476d
-  data.tar.gz: 05adfe955164c50037842cd380504e938df4618160de34c9fee7e7e25e225226eefb44a4a9fc6a2181f41702e23ff2ed00686bffaee20643de811cde9d98922a
+  metadata.gz: 9911d705b900209619e8051a3d01acb4fdd1337b026f93b577f6b6113cee8ce0a18fa5f88af9316988c7433f01232700731776ff562b8f7d85910cdcd94c802f
+  data.tar.gz: 80a33006c4a8159bb0b5f594b95c9b60f443e0126f3862fc2c526424794bc2acf6ff2c90ad4bbbec88c58ce0a1dba40ff05c7cc48001e9c0568675f53013fc07

data/lib/prebake/async_publisher.rb

@@ -75,6 +75,12 @@ module Prebake
         end
       end
 
+      if !Prebake.libruby_available? && ElfInspector.libruby_needed_for_gem?(gem_path)
+        Logger.warn "Skipping push of #{cache_key}: binary requires libruby.so (dynamic Ruby) but this is a static Ruby build; binary would crash on this platform"
+        FileUtils.rm_f(gem_path)
+        return nil
+      end
+
       Logger.debug "Built #{cache_key}"
       [gem_path, cache_key, checksum, backend]
     rescue StandardError => e

data/lib/prebake/elf_inspector.rb

@@ -9,17 +9,9 @@ require_relative "logger"
 module Prebake
   module ElfInspector
     def self.required_glibc_for_gem(gem_path)
-      Dir.mktmpdir("prebake-portability") do |tmpdir|
-        Gem::Package.new(gem_path).extract_files(tmpdir)
-        versions = Dir.glob(File.join(tmpdir, "**/*.{so,bundle,dll}")).filter_map do |binary|
-          next if File.symlink?(binary) || File.size(binary).zero?
-
-          required_glibc(binary)
-        end
-        return nil if versions.empty?
-
-        versions.max_by { |v| Gem::Version.new(v) }
-      end
+      versions = []
+      each_gem_binary(gem_path) { |binary| v = required_glibc(binary); versions << v if v }
+      versions.empty? ? nil : versions.max_by { |v| Gem::Version.new(v) }
     rescue StandardError => e
       # Malformed gem, missing objdump, or I/O error — treat as unknown, let
       # downstream extraction catch real corruption.
@@ -43,6 +35,27 @@ module Prebake
       versions.max_by { |v| Gem::Version.new(v) }
     end
 
+    def self.libruby_needed_for_gem?(gem_path)
+      each_gem_binary(gem_path) { |binary| return true if libruby_needed?(binary) }
+      false
+    rescue StandardError => e
+      Logger.debug "libruby inspection failed for #{File.basename(gem_path)}: #{e.message}"
+      false
+    end
+
+    def self.libruby_needed?(path)
+      needed_libraries(path).any? { |lib| lib.start_with?("libruby") }
+    end
+
+    def self.needed_libraries(path)
+      out, status = Open3.capture2e("objdump", "-p", path)
+      return [] unless status.success?
+
+      out.scan(/NEEDED\s+(\S+)/).flatten
+    rescue Errno::ENOENT
+      []
+    end
+
     def self.run_objdump(path)
       out, status = Open3.capture2e("objdump", "-T", path)
       return nil unless status.success?
@@ -51,5 +64,16 @@ module Prebake
     rescue Errno::ENOENT
       nil
     end
+
+    private_class_method def self.each_gem_binary(gem_path)
+      Dir.mktmpdir("prebake-gem") do |tmpdir|
+        Gem::Package.new(gem_path).extract_files(tmpdir)
+        Dir.glob(File.join(tmpdir, "**/*.{so,bundle,dll}")).each do |binary|
+          next if File.symlink?(binary) || File.size(binary).zero?
+
+          yield binary
+        end
+      end
+    end
   end
 end

data/lib/prebake/ext_builder_patch.rb

@@ -6,8 +6,7 @@ require "digest"
 require_relative "cache_key"
 require_relative "platform"
 require_relative "extractor"
-require_relative "elf_inspector"
-require_relative "glibc"
+require_relative "portability_guard"
 require_relative "logger"
 
 module Prebake
@@ -17,6 +16,12 @@ module Prebake
       return super unless Prebake.enabled?
       return super unless Prebake.backend # nil if config failed
 
+      if Prebake.optional_native_extension?(@spec.name) && !Prebake.libruby_available?
+        Logger.warn "#{@spec.name}: native extension skipped (optional gem, libruby.so absent on static Ruby build)"
+        install_without_native_extension
+        return
+      end
+
       platform = Platform.generalized
       cache_key = CacheKey.for(@spec.name, @spec.version.to_s, platform)
 
@@ -40,7 +45,7 @@ module Prebake
       end
 
       if verify_checksum(cache_key, expected_checksum, cached_gem)
-        unless portable_for_host?(cached_gem)
+        unless PortabilityGuard.portable_for_host?(cached_gem, spec_name: @spec.name)
           # Binary is valid for other hosts; don't delete from backend.
           return super
         end
@@ -85,16 +90,8 @@ module Prebake
       end
     end
 
-    def portable_for_host?(gem_path)
-      # Cache key already segregates platforms; glibc check only applies on linux.
-      return true unless Glibc.linux?
-      return true if Prebake.skip_portability_check?
-
-      required = ElfInspector.required_glibc_for_gem(gem_path)
-      return true if Glibc.compatible?(required)
-
-      Logger.warn "Cached #{@spec.name} requires glibc #{required}, host has #{Glibc.detected_version || 'unknown'}; falling back to source build"
-      false
+    def install_without_native_extension
+      mark_build_complete
     end
 
     def install_from_cache(gem_path)
@@ -105,9 +102,13 @@ module Prebake
         return false
       end
 
+      mark_build_complete
+      true
+    end
+
+    def mark_build_complete
       FileUtils.mkdir_p(File.dirname(@spec.gem_build_complete_path))
       FileUtils.touch(@spec.gem_build_complete_path)
-      true
     end
   end
 end

data/lib/prebake/portability_guard.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require_relative "elf_inspector"
+require_relative "glibc"
+require_relative "logger"
+
+module Prebake
+  # Host-side portability guards for cached gems: ensures the cached binary
+  # will actually load on this host (glibc version + libruby.so presence).
+  module PortabilityGuard
+    module_function
+
+    def portable_for_host?(gem_path, spec_name:)
+      return true unless Glibc.linux?
+      return true if Prebake.skip_portability_check?
+
+      glibc_ok?(gem_path, spec_name:) && libruby_ok?(gem_path, spec_name:)
+    end
+
+    def glibc_ok?(gem_path, spec_name:)
+      required = ElfInspector.required_glibc_for_gem(gem_path)
+      return true if Glibc.compatible?(required)
+
+      Logger.warn "Cached #{spec_name} requires glibc #{required}, " \
+                  "host has #{Glibc.detected_version || 'unknown'}; falling back to source build"
+      false
+    end
+
+    def libruby_ok?(gem_path, spec_name:)
+      return true if Prebake.libruby_available?
+      return true unless ElfInspector.libruby_needed_for_gem?(gem_path)
+
+      Logger.warn "Cached #{spec_name} requires libruby.so (dynamic Ruby build) " \
+                  "but this host has a static Ruby; falling back to source build"
+      false
+    end
+  end
+end

data/lib/prebake/static_ruby.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Prebake
+  # Detection and configuration for static Ruby builds (e.g. Paketo MRI buildpack),
+  # where libruby.so is absent and native extensions dynamically linked against it
+  # would crash at load time.
+  module StaticRuby
+    # Gems whose native extensions are entirely optional — the gem runs correctly in pure Ruby
+    # mode when the extension can't be loaded. Prebake skips the extension for these gems
+    # instead of installing a broken .so. Extend via PREBAKE_OPTIONAL_NATIVE_EXTENSIONS=gem1,gem2.
+    OPTIONAL_NATIVE_EXTENSIONS_DEFAULT = %w[bootsnap].freeze
+
+    class << self
+      def optional_native_extensions
+        @optional_native_extensions ||= begin
+          extra = ENV.fetch("PREBAKE_OPTIONAL_NATIVE_EXTENSIONS", "")
+                     .split(",").map(&:strip).reject(&:empty?)
+          (OPTIONAL_NATIVE_EXTENSIONS_DEFAULT + extra).uniq
+        end
+      end
+
+      def optional_native_extension?(gem_name)
+        optional_native_extensions.include?(gem_name)
+      end
+
+      def libruby_available?
+        return @libruby_available if defined?(@libruby_available)
+
+        libruby_so = RbConfig::CONFIG["LIBRUBY_SO"]
+        @libruby_available = !libruby_so.nil? && !libruby_so.empty? &&
+                             File.exist?(File.join(RbConfig::CONFIG["libdir"], libruby_so))
+      end
+
+      def reset!
+        remove_instance_variable(:@optional_native_extensions) if defined?(@optional_native_extensions)
+        remove_instance_variable(:@libruby_available) if defined?(@libruby_available)
+      end
+    end
+  end
+end

data/lib/prebake.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "prebake/logger"
+require_relative "prebake/static_ruby"
 
 module Prebake
   class Error < StandardError; end
@@ -27,6 +28,10 @@ module Prebake
     ENV.fetch("PREBAKE_MAX_GLIBC", nil)
   end
 
+  def self.optional_native_extensions = StaticRuby.optional_native_extensions
+  def self.optional_native_extension?(gem_name) = StaticRuby.optional_native_extension?(gem_name)
+  def self.libruby_available? = StaticRuby.libruby_available?
+
   def self.backend
     return @backend if defined?(@backend_loaded)
 
@@ -49,6 +54,7 @@ module Prebake
   def self.reset!
     remove_instance_variable(:@backend_loaded) if defined?(@backend_loaded)
     remove_instance_variable(:@backend) if defined?(@backend)
+    StaticRuby.reset!
   end
 
   def self.setup!

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: prebake
 version: !ruby/object:Gem::Version
-  version: 0.2.10
+  version: 0.3.0
 platform: ruby
 authors:
 - Thejus Paul
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-20 00:00:00.000000000 Z
+date: 2026-04-23 00:00:00.000000000 Z
 dependencies: []
 description: Prebake speeds up bundle install by skipping native gem compilation.
   It fetches precompiled binaries for gems like puma, nokogiri, pg, grpc, and bootsnap
@@ -40,6 +40,8 @@ files:
 - lib/prebake/logger.rb
 - lib/prebake/platform.rb
 - lib/prebake/platform_gem_builder.rb
+- lib/prebake/portability_guard.rb
+- lib/prebake/static_ruby.rb
 - plugins.rb
 homepage: https://github.com/gembakery/prebake
 licenses: