rbe-tebako 0.15.0

data/lib/tebako/packager/pass2msys_patch.rb

@@ -0,0 +1,190 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2021-2025 [Ribose Inc](https://www.ribose.com).
+# All rights reserved.
+# This file is a part of the Tebako project.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+# 1. Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright
+#    notice, this list of conditions and the following disclaimer in the
+#    documentation and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS
+# BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+require_relative "pass2_patch"
+require_relative "patch_helpers"
+require_relative "patch_literals"
+
+# Tebako - an executable packager
+module Tebako
+  # Packager module
+  module Packager
+    IO_C_MSYS_BASE_PATCH = {
+      "#define open	rb_w32_uopen" => "#define open(p, f, m) tebako_open(3, (p), (f), (m))"
+    }.freeze
+
+    IO_C_MSYS_PATCH_PRE_32 = {
+      "(rb_w32_io_cancelable_p((fptr)->fd) ? Qnil : rb_io_wait(fptr->self, RB_INT2NUM(RUBY_IO_READABLE), Qnil))" =>
+          "((is_tebako_file_descriptor((fptr)->fd) || rb_w32_io_cancelable_p((fptr)->fd)) ? \\\n" \
+          "Qnil : rb_io_wait(fptr->self, RB_INT2NUM(RUBY_IO_READABLE), Qnil))"
+    }.freeze
+
+    IO_C_MSYS_PATCH = {
+      "(rb_w32_io_cancelable_p((fptr)->fd) ? Qnil : rb_io_wait(fptr->self, " \
+      "RB_INT2NUM(RUBY_IO_READABLE), RUBY_IO_TIMEOUT_DEFAULT))" =>
+          "((is_tebako_file_descriptor((fptr)->fd) || rb_w32_io_cancelable_p((fptr)->fd)) ? \\\n" \
+          "Qnil : rb_io_wait(fptr->self, RB_INT2NUM(RUBY_IO_READABLE), RUBY_IO_TIMEOUT_DEFAULT))"
+    }.freeze
+
+    RUBY_C_MSYS_PATH_SUBST = <<~SUBST
+      /* -- Start of tebako patch -- */
+              VALUE path = within_tebako_memfs(paths) ?
+                              rb_str_new_cstr(paths) :
+                              RUBY_RELATIVE(paths, len);
+              /* -- End of tebako patch -- */
+    SUBST
+
+    RUBY_C_MSYS_PATCHES = {
+      "#ifndef MAXPATHLEN" => "#{PatchLiterals::C_FILE_SUBST_LESS}\n#ifndef MAXPATHLEN",
+      "VALUE path = RUBY_RELATIVE(paths, len);" => RUBY_C_MSYS_PATH_SUBST
+    }.freeze
+
+    WIN32_FILE_C_MSYS_SUBST = <<~SUBST
+      /* -- Start of tebako patch -- */
+        if (tebako_file_load_ok(path)) return ret;
+          /* -- End of tebako patch -- */
+      wpath = mbstr_to_wstr(CP_UTF8, path, -1, &len);
+    SUBST
+
+    WIN32_FILE_C_MSYS_PATCHES = {
+      "#ifndef INVALID_FILE_ATTRIBUTES" => "#{PatchLiterals::C_FILE_SUBST_LESS}\n#ifndef INVALID_FILE_ATTRIBUTES",
+      "wpath = mbstr_to_wstr(CP_UTF8, path, -1, &len);" => WIN32_FILE_C_MSYS_SUBST
+    }.freeze
+
+    WIN32_WIN32_C_MSYS_SUBST = <<~SUBST
+      /* -- Start of tebako patch -- */
+        if (is_tebako_cwd()) {
+          char* tebako_cwd = tebako_getcwd(NULL,0);
+          if (tebako_cwd == NULL) {
+            errno = ENOMEM;
+            return NULL;
+          }
+          len = strlen(tebako_cwd) + 1;
+
+          if (buffer) {
+            if (size < len) {
+              free(tebako_cwd);
+              errno = ERANGE;
+              return NULL;
+            }
+          }
+          else {
+            buffer = (*alloc)(len, arg);
+            if (!buffer) {
+              free(tebako_cwd);
+              errno = ENOMEM;
+              return NULL;
+            }
+          }
+          translate_char(tebako_cwd, (char)0x5c, '/', CP_UTF8);
+          strcpy(buffer, tebako_cwd);
+          free(tebako_cwd);
+          return buffer;
+        }
+        /* -- End of tebako patch -- */
+
+        len = GetCurrentDirectoryW(0, NULL);
+    SUBST
+
+    WIN32_WIN32_C_MSYS_PATCHES = {
+      "#if defined _MSC_VER && _MSC_VER <= 1200" =>
+        "#{PatchLiterals::C_FILE_SUBST_LESS}\n#if defined _MSC_VER && _MSC_VER <= 1200",
+      "len = GetCurrentDirectoryW(0, NULL);" => WIN32_WIN32_C_MSYS_SUBST,
+      "clock_gettime(clockid_t clock_id, struct timespec *sp)" =>
+        "_dummy_clock_gettime(clockid_t clock_id, struct timespec *sp)",
+      "clock_getres(clockid_t clock_id, struct timespec *sp)" =>
+        "_dummy_clock_getres(clockid_t clock_id, struct timespec *sp)"
+    }.freeze
+
+    # Msys Pass2 patches
+    class Pass2MSysPatch < Pass2Patch
+      def patch_map
+        pm = super
+        pm.merge!(msys_patches)
+        pm.store("config.status", get_config_status_patch(@ostype, @deps_lib_dir, @ruby_ver))
+        pm
+      end
+
+      private
+
+      # Other MSYS (GNUMakefile) specific patches
+      #  - The same issue with libraries as for Makefile above
+      #  - 'Kill' ruby.exp regeneration on pass2
+      #     since we want to use output from pass1 for implib generation
+      #     [VERY UGLY HACK]
+      #  - Introduce LIBRUBY dependency on static extensions
+      #    This is an addition to COMMON_MK_PATCH specified above
+      def gnumakefile_in_patch_p2 # rubocop:disable Metrics/MethodLength
+        objext = @ruby_ver.ruby32? ? "$(OBJEXT)" : "@OBJEXT@"
+
+        {
+          "$(Q) $(DLLWRAP) \\" => GNUMAKEFILE_IN_DLLTOOL_SUBST,
+
+          "--output-exp=$(RUBY_EXP) \\" => "# tebako patched --output-exp=$(RUBY_EXP) \\",
+
+          "--export-all $(LIBRUBY_A) $(LIBS) -o $(PROGRAM)" =>
+            "# tebako patched --export-all $(LIBRUBY_A) $(LIBS) -o $(PROGRAM)",
+
+          "@rm -f $(PROGRAM)" => "# tebako patched @rm -f $(PROGRAM)",
+
+          "	$(Q) $(LDSHARED) $(DLDFLAGS) $(OBJS) dmyext.o $(SOLIBS) -o $(PROGRAM)" =>
+           "# tebako patched  $(Q) $(LDSHARED) $(DLDFLAGS) $(OBJS) dmyext.o $(SOLIBS) -o $(PROGRAM)",
+
+          "$(WPROGRAM): $(RUBYW_INSTALL_NAME).res.#{objext}" =>
+            "$(WPROGRAM): $(RUBYW_INSTALL_NAME).res.#{objext} $(WINMAINOBJ)  # tebako patched",
+
+          "RUBYDEF = $(DLL_BASE_NAME).def" => GNUMAKEFILE_IN_WINMAIN_SUBST,
+
+          "$(MAINOBJ) $(EXTOBJS) $(LIBRUBYARG) $(LIBS) -o $@" =>
+            "$(WINMAINOBJ) $(EXTOBJS) $(LIBRUBYARG) $(MAINLIBS) -o $@  # tebako patched",
+
+          "$(RUBY_EXP): $(LIBRUBY_A)" => "dummy.exp: $(LIBRUBY_A) # tebako patched",
+
+          "$(PROGRAM): $(RUBY_INSTALL_NAME).res.#{objext}" =>
+            "$(PROGRAM): $(RUBY_INSTALL_NAME).res.#{objext} $(LIBRUBY_A) # tebako patched\n" \
+            "$(LIBRUBY_A): $(LIBRUBY_A_OBJS) $(INITOBJS) # tebako patched\n"
+        }
+      end
+
+      def io_c_patch
+        patch = super
+        patch.merge!(@ruby_ver.ruby32? ? IO_C_MSYS_PATCH : IO_C_MSYS_PATCH_PRE_32)
+        patch.merge!(IO_C_MSYS_BASE_PATCH)
+        patch
+      end
+
+      def msys_patches
+        {
+          "cygwin/GNUmakefile.in" => gnumakefile_in_patch_p2,
+          "ruby.c" => RUBY_C_MSYS_PATCHES,
+          "win32/file.c" => WIN32_FILE_C_MSYS_PATCHES,
+          "win32/win32.c" => WIN32_WIN32_C_MSYS_PATCHES
+        }
+      end
+    end
+  end
+end

data/lib/tebako/packager/patch.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2025 [Ribose Inc](https://www.ribose.com).
+# All rights reserved.
+# This file is a part of the Tebako project.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+# 1. Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright
+#    notice, this list of conditions and the following disclaimer in the
+#    documentation and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS
+# BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+# Tebako - an executable packager
+module Tebako
+  module Packager
+    # Substitutions for cygwin/Gnumakefile.in shared across Pass1 and Pass2
+    GNUMAKEFILE_IN_DLLTOOL_SUBST = <<~SUBST
+      $(Q) dlltool --output-lib=$(LIBRUBY) --output-def=tebako.def --export-all $(LIBRUBY_A) --output-exp=$(RUBY_EXP)   # tebako patched
+    SUBST
+
+    # This MSYS specific thing ensure compilation of winmain.c
+    # Did try to understand why it did not work out of the box
+    GNUMAKEFILE_IN_WINMAIN_SUBST = <<~SUBST
+      RUBYDEF = $(DLL_BASE_NAME).def
+
+      # Start of tebako patch
+      WINMAINOBJ    = win32/winmain.$(OBJEXT)
+      $(WINMAINOBJ): win32/winmain.c
+      # End of tebako patch
+    SUBST
+
+    # Ruby patching definitions (common base)
+    class Patch
+      def patch_map
+        {}.freeze
+      end
+    end
+  end
+end

data/lib/tebako/packager/patch_buildsystem.rb

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2023-2025 [Ribose Inc](https://www.ribose.com).
+# All rights reserved.
+# This file is a part of the Tebako project.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+# 1. Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright
+#    notice, this list of conditions and the following disclaimer in the
+#    documentation and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS
+# BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+require_relative "patch_helpers"
+
+# Tebako - an executable packager
+module Tebako
+  module Packager
+    # Ruby buildsystem patches (pass2)
+    module PatchBuildsystem
+      # This patch forces rebuild of extinit.c when exts.mk changes
+      # exts.mk changes when we rebuild extensions to make them statically linked
+      # [TODO] it is possible that we can build extensions statically on pass1 and it will
+      #        eliminate the need for this patch
+      COMMON_MK_PATCH = {
+        "ext/extinit.c: $(srcdir)/template/extinit.c.tmpl $(PREP)" =>
+          "ext/extinit.c: $(srcdir)/template/extinit.c.tmpl $(PREP) $(EXTS_MK)"
+      }.freeze
+
+      # This patch changes libraries that are used for Ruby linking
+      # MAINLIBS is patched elsewhere (not with literal but dynamically)
+      #          to haold the list of sattic libraries and related options
+      # Also we have to put LIBRUBYARG_STATIC instead of LIBRUBYARG to link with static libruby,
+      # configure's --disable-shared option does not do it
+      # Several variants depending on os and version
+      TEMPLATE_MAKEFILE_IN_BASE_PATTERN_PRE_3_1 =
+        "\t\t$(Q) $(PURIFY) $(CC) $(LDFLAGS) $(XLDFLAGS) $(MAINOBJ) " \
+        "$(EXTOBJS) $(LIBRUBYARG) $(MAINLIBS) $(LIBS) $(EXTLIBS) $(OUTFLAG)$@"
+
+      TEMPLATE_MAKEFILE_IN_BASE_PATCH_PRE_3_1 =
+        "# -- Start of tebako patch --\n" \
+        "\t\t$(Q) $(PURIFY) $(CC) $(LDFLAGS) $(MAINOBJ) " \
+        "$(EXTOBJS) $(LIBRUBYARG_STATIC) $(OUTFLAG)$@\n" \
+        "# -- End of tebako patch --"
+
+      TEMPLATE_MAKEFILE_IN_BASE_PATTERN_PRE_3_3 =
+        "\t\t$(Q) $(PURIFY) $(CC) $(EXE_LDFLAGS) $(XLDFLAGS) $(MAINOBJ) $(EXTOBJS) " \
+        "$(LIBRUBYARG) $(MAINLIBS) $(LIBS) $(EXTLIBS) $(OUTFLAG)$@"
+
+      TEMPLATE_MAKEFILE_IN_BASE_PATTERN =
+        "\t\t$(Q) $(PURIFY) $(CC) $(EXE_LDFLAGS) $(XLDFLAGS) $(MAINOBJ) $(EXTOBJS) " \
+        "$(LIBRUBYARG) $(MAINLIBS) $(EXTLIBS) $(OUTFLAG)$@"
+
+      TEMPLATE_MAKEFILE_IN_BASE_PATCH =
+        "# -- Start of tebako patch --\n" \
+        "\t\t$(Q) $(PURIFY) $(CC) $(EXE_LDFLAGS) $(MAINOBJ) " \
+        "$(EXTOBJS) $(LIBRUBYARG_STATIC) $(OUTFLAG)$@\n" \
+        "# -- End of tebako patch --"
+
+      TEMPLATE_MAKEFILE_IN_BASE_PATCH_MSYS =
+        "# -- Start of tebako patch --\n" \
+        "\t\t$(Q) $(PURIFY) $(CC) $(EXE_LDFLAGS) $(RUBY_EXP) $(MAINOBJ) " \
+        "$(EXTOBJS) $(LIBRUBYARG_STATIC) $(OUTFLAG)$@\n" \
+        "# -- End of tebako patch --"
+
+      def template_makefile_in_subst(ruby_ver)
+        if ScenarioManagerBase.new.msys?
+          TEMPLATE_MAKEFILE_IN_BASE_PATCH_MSYS
+        elsif !ruby_ver.ruby31?
+          TEMPLATE_MAKEFILE_IN_BASE_PATCH_PRE_3_1
+        else
+          TEMPLATE_MAKEFILE_IN_BASE_PATCH
+        end
+      end
+
+      def template_makefile_in_patch_two(ruby_ver)
+        if !ruby_ver.ruby31?
+          { TEMPLATE_MAKEFILE_IN_BASE_PATTERN_PRE_3_1 => template_makefile_in_subst(ruby_ver) }
+        elsif !ruby_ver.ruby33?
+          { TEMPLATE_MAKEFILE_IN_BASE_PATTERN_PRE_3_3 => template_makefile_in_subst(ruby_ver) }
+        else
+          { TEMPLATE_MAKEFILE_IN_BASE_PATTERN => template_makefile_in_subst(ruby_ver) }
+        end
+      end
+
+      def get_config_status_pattern(ostype)
+        scmb = ScenarioManagerBase.new(ostype)
+        if scmb.macos?
+          "S[\"MAINLIBS\"]=\"-ldl -lobjc -lpthread \""
+        elsif scmb.msys?
+          "S[\"MAINLIBS\"]=\"-lshell32 -lws2_32 -liphlpapi -limagehlp -lshlwapi -lbcrypt \""
+        else
+          "S[\"MAINLIBS\"]=\"-lz -lrt -lrt -ldl -lcrypt -lm -lpthread \""
+        end
+      end
+
+      def get_config_status_patch(ostype, deps_lib_dir, ruby_ver)
+        # with_compression: true so rbconfig's MAINLIBS (used by mkmf have_func() conftest links
+        # during extension builds) force_loads the DwarFS (de)compressor libs. Since the v0.15
+        # split, libdwarfs_reader.a references dwarfs::block_decompressor (defined in
+        # libdwarfs_decompressor.a); omitting it made EVERY conftest fail to link, so every bundled
+        # gem fell back to its `static` compat shim and failed to compile under the real headers.
+        {
+          get_config_status_pattern(ostype) =>
+            "S[\"MAINLIBS\"]=\"#{PatchLibraries.mlibs(ostype, deps_lib_dir, ruby_ver, true)}\""
+        }
+      end
+    end
+  end
+end

data/lib/tebako/packager/patch_helpers.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2023-2025 [Ribose Inc](https://www.ribose.com).
+# All rights reserved.
+# This file is a part of the Tebako project.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+# 1. Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright
+#    notice, this list of conditions and the following disclaimer in the
+#    documentation and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS
+# BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+require "open3"
+require_relative "patch_literals"
+
+# Tebako - an executable packager
+module Tebako
+  module Packager
+    # Ruby patching helpers (pass2)
+    module PatchHelpers
+      class << self
+        def patch_file(fname, mapping)
+          raise Tebako::Error, "Could not patch #{fname} because it does not exist." unless File.exist?(fname)
+
+          puts "   ... patching #{fname}"
+          restore_and_save(fname)
+          contents = File.read(fname)
+
+          mapping.each { |pattern, subst| contents.sub!(pattern, subst) }
+          File.open(fname, "w") { |file| file << contents }
+        end
+
+        def get_prefix_macos(package)
+          out, st = Open3.capture2("brew --prefix #{package}")
+          raise Tebako::Error, "brew --prefix #{package} failed with code #{st.exitstatus}" unless st.exitstatus.zero?
+
+          out
+        end
+
+        def get_prefix_linux(package)
+          out, st = Open3.capture2("pkg-config --variable=libdir #{package}")
+          unless st.exitstatus.zero?
+            raise Tebako::Error,
+                  "pkg-config --variable=libdir #{package} failed with code #{st.exitstatus}"
+          end
+
+          out
+        end
+
+        def patch_c_file_pre(pattern)
+          {
+            pattern => "#{PatchLiterals::C_FILE_SUBST}\n#{pattern}"
+          }
+        end
+
+        def patch_c_file_post(pattern)
+          {
+            pattern => "#{pattern}\n\n#{PatchLiterals::C_FILE_SUBST}"
+          }
+        end
+
+        def recreate(dirname)
+          FileUtils.rm_rf(dirname, noop: nil, verbose: nil, secure: true)
+          FileUtils.mkdir(dirname)
+        end
+
+        def restore_and_save(fname, strict: true)
+          unless File.exist?(fname)
+            return unless strict
+
+            raise Tebako::Error, "Could not save #{fname} because it does not exist."
+          end
+
+          old_fname = "#{fname}.old"
+          if File.exist?(old_fname)
+            FileUtils.rm_f(fname)
+            File.rename(old_fname, fname)
+          end
+          FileUtils.cp(fname, old_fname)
+        end
+
+        def restore_and_save_files(files, ruby_source_dir, strict: true)
+          files.each do |fname|
+            restore_and_save("#{ruby_source_dir}/#{fname}", strict: strict)
+          end
+        end
+
+        def yaml_reference(ruby_ver)
+          ruby_ver.ruby32? ? "-l:libyaml.a" : ""
+        end
+      end
+    end
+  end
+end

data/lib/tebako/packager/patch_libraries.rb

@@ -0,0 +1,188 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2021-2025 [Ribose Inc](https://www.ribose.com).
+# All rights reserved.
+# This file is a part of the Tebako project.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+# 1. Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright
+#    notice, this list of conditions and the following disclaimer in the
+#    documentation and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS
+# BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+require_relative "patch_helpers"
+
+# Tebako - an executable packager
+module Tebako
+  module Packager
+    # Ruby patching definitions (pass2)
+    module PatchLibraries
+      class << self
+        # rubocop:disable Style/WordArray
+        DARWIN_BREW_LIBS = [
+          ["zlib", "z"],              ["gdbm", "gdbm"],           ["readline", "readline"], ["libffi", "ffi"],
+          ["ncurses", "ncurses"],     ["lz4", "lz4"],             ["xz", "lzma"],           ["libyaml", "yaml"],
+          ["boost", "boost_chrono"],  ["double-conversion", "double-conversion"],
+          # DwarFS v0.15 compression/hash deps (were staged into deps_lib_dir under the bridge)
+          ["xxhash", "xxhash"],               ["zstd", "zstd"],
+          ["brotli", "brotlienc"],            ["brotli", "brotlidec"],            ["brotli", "brotlicommon"],
+          # DwarFS reader link deps
+          ["boost", "boost_filesystem"],      ["boost", "boost_atomic"],
+          ["boost", "boost_iostreams"],       ["boost", "boost_program_options"],
+          ["boost", "boost_context"],         ["boost", "boost_regex"],
+          ["boost", "boost_thread"],
+          ["flac", "FLAC"],                   ["flac", "FLAC++"],
+          ["libogg", "ogg"]
+        ].freeze
+
+        DARWIN_BREW_LIBS_PRE_31 = [["openssl@1.1", "ssl"], ["openssl@1.1", "crypto"]].freeze
+
+        DARWIN_BREW_LIBS_31 = [["openssl@3", "ssl"], ["openssl@3", "crypto"]].freeze
+
+        # DwarFS v0.15 split static libs (installed to deps_lib_dir by libdwarfs). folly/fbthrift
+        # are gone; the thrift/fsst/frozen libs are now real .a files. glog/gflags/fmt are no
+        # longer linked (fmt is header-only / baked into the DwarFS libs).
+        DARWIN_DEP_LIBS_1 = [
+          "dwarfs_reader", "dwarfs_common",
+          "dwarfs_fsst", "dwarfs_frozen", "dwarfs_thrift_lite_v2",
+          "dwarfs_metadata_thrift", "dwarfs_compression_thrift",
+          "dwarfs_history_thrift", "dwarfs_features_thrift"
+        ].freeze
+        # rubocop:enable Style/WordArray
+
+        LIBTEBAKOFS = "-Wl,--push-state,--whole-archive -l:libtebako-fs.a -Wl,--pop-state"
+
+        COMMON_LINUX_LIBRARIES = [
+          LIBTEBAKOFS,            "-l:libdwarfs-wr.a",          "-l:libdwarfs.a",             "LIBCOMPRESSION",
+          "-l:libfolly.a",        "-l:libfsst.a",               "-l:libmetadata_thrift.a",    "-l:libthrift_light.a",
+          "-l:libxxhash.a",       "-l:libfmt.a",                "-l:libdouble-conversion.a",  "-l:libglog.a",
+          "-l:libgflags.a",       "-l:libevent.a"
+        ].freeze
+
+        COMMON_ARCHIEVE_LIBRARIES = [
+          "-l:libarchive.a",     "-l:liblz4.a",        "-l:libz.a",             "-l:libzstd.a",
+          "-l:libbrotlienc.a",   "-l:libbrotlidec.a",  "-l:libbrotlicommon.a",  "-l:liblzma.a"
+        ].freeze
+
+        LINUX_GNU_LIBRARIES = [
+          "-l:libiberty.a",      "-l:libacl.a",          "-l:libssl.a",           "-l:libcrypto.a",
+          "-l:libgdbm.a",        "-l:libreadline.a",     "-l:libtinfo.a",         "-l:libffi.a",
+          "-l:libncurses.a",     "-l:libjemalloc.a",     "-l:libcrypt.a",         "-l:libanl.a",
+          "LIBYAML",             "-l:libboost_system.a", "-l:libboost_chrono.a",  "-l:libutil.a",
+          "-l:libstdc++.a",      "-lgcc_eh",             "-l:libunwind.a",        "-l:liblzma.a",
+          "-l:librt.a",          "-ldl",                 "-lpthread",             "-lm"
+        ].freeze
+
+        LINUX_MUSL_LIBRARIES = [
+          "-l:libiberty.a",       "-l:libacl.a",          "-l:libssl.a",          "-l:libcrypto.a",
+          "-l:libreadline.a",     "-l:libgdbm.a",         "-l:libffi.a",          "-l:libncurses.a",
+          "-l:libjemalloc.a",     "-l:libcrypt.a",        "LIBYAML",              "-l:libboost_system.a",
+          "-l:libboost_chrono.a", "-l:librt.a",           "-l:libstdc++.a",       "-lgcc_eh",
+          " -l:libunwind.a",      "-l:liblzma.a",         "-ldl",                 "-lpthread"
+        ].freeze
+
+        MSYS_LIBRARIES = [
+          "-l:liblz4.a",             "-l:libz.a",               "-l:libzstd.a",            "-l:liblzma.a",
+          "-l:libncurses.a",         "-l:liblzma.a",            "-l:libiberty.a",          "LIBYAML",
+          "-l:libffi.a",             "-l:libboost_chrono-mt.a", "-l:libstdc++.a",          "-l:libdl.a",
+          "-static-libgcc",          "-static-libstdc++",       "-l:libssl.a",             "-l:libcrypto.a",
+          "-l:libz.a",               "-l:libwinpthread.a",      "-lcrypt32",               "-lshlwapi",
+          "-lwsock32",               "-liphlpapi",              "-limagehlp",              "-lbcrypt",
+          "-lole32",                 "-loleaut32",              "-luuid",                  "-lws2_32"
+        ].freeze
+
+        def linux_gnu_libraries(ruby_ver, with_compression)
+          libraries = COMMON_LINUX_LIBRARIES + COMMON_ARCHIEVE_LIBRARIES + LINUX_GNU_LIBRARIES
+          linux_libraries(libraries, ruby_ver, with_compression)
+        end
+
+        def linux_musl_libraries(ruby_ver, with_compression)
+          libraries = COMMON_LINUX_LIBRARIES + COMMON_ARCHIEVE_LIBRARIES + LINUX_MUSL_LIBRARIES
+          linux_libraries(libraries, ruby_ver, with_compression)
+        end
+
+        def linux_libraries(libraries, ruby_ver, with_compression)
+          libraries.map! do |lib|
+            if lib == "LIBYAML"
+              PatchHelpers.yaml_reference(ruby_ver)
+            elsif lib == "LIBCOMPRESSION"
+              with_compression ? "-Wl,--push-state,--whole-archive -l:libdwarfs_compression.a -Wl,--pop-state" : ""
+            else
+              lib
+            end
+          end
+          libraries.join(" ")
+        end
+
+        def msys_libraries(ruby_ver, with_compression)
+          libraries = with_compression ? ["-Wl,-Bstatic"] : []
+          libraries = libraries + COMMON_LINUX_LIBRARIES + MSYS_LIBRARIES
+          linux_libraries(libraries, ruby_ver, with_compression)
+        end
+
+        def process_brew_libs!(libs, brew_libs)
+          brew_libs.each { |lib| libs << "#{PatchHelpers.get_prefix_macos(lib[0]).chop}/lib/lib#{lib[1]}.a " }
+        end
+
+        def darwin_libraries(deps_lib_dir, ruby_ver, with_compression)
+          libs = String.new
+
+          DARWIN_DEP_LIBS_1.each { |lib| libs << "#{deps_lib_dir}/lib#{lib}.a " }
+          process_brew_libs!(libs, ruby_ver.ruby31? ? DARWIN_BREW_LIBS_31 : DARWIN_BREW_LIBS_PRE_31)
+          process_brew_libs!(libs, DARWIN_BREW_LIBS)
+
+          # DwarFS compression codecs self-register via static initializers, so force_load the
+          # (de)compressor libs to keep them (the reader would otherwise drop the unreferenced ones).
+          compression_lib =
+            if with_compression
+              "-force_load #{deps_lib_dir}/libdwarfs_decompressor.a " \
+              "-force_load #{deps_lib_dir}/libdwarfs_compressor.a"
+            else
+              ""
+            end
+          "-ltebako-fs -ldwarfs-wr #{compression_lib} #{libs} #{deps_lib_dir}/libjemalloc.a -lc++ -lc++abi"
+        end
+
+        # .....................................................
+        #  Notes re linux libraries
+        #   1) This order is important: -lgcc_eh -l:libunwind.a -l:liblzma.a  lzma is used to process debug sections.
+        #      gcc_eh shall be linked before unwind to avoid duplicate symbols.
+        #   2) -lgcc_eh assumes -static-libgcc (applied in CMakeLists.ext, RUBY_C_FLAGS)
+        #   3) -static-libstdc++ did not work, not sure why  [TODO ?]
+        #   4) When clang is used linker links libraries specified in exensions in such way that they are linked shared
+        #      (libz, libffi, libreadline, libncurses, libtinfo, ... )
+        #      Using stuff like -l:libz.a  does not help; there is a reference to libz.so anyway.
+        #      This is fixed by ext/extmk.rb patch [TODO ?]
+        # .....................................................
+
+        def mlibs(ostype, deps_lib_dir, ruby_ver, with_compression)
+          scmb = ScenarioManagerBase.new(ostype)
+          if scmb.msys?
+            msys_libraries(ruby_ver, with_compression)
+          elsif scmb.macos?
+            darwin_libraries(deps_lib_dir, ruby_ver, with_compression)
+          elsif scmb.musl?
+            linux_musl_libraries(ruby_ver, with_compression)
+          else
+            linux_gnu_libraries(ruby_ver, with_compression)
+          end
+        end
+      end
+    end
+  end
+end