ffi-libarchive-binary 0.5.0-arm64-mingw-ucrt

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e4e18d3ce61f70325fcbc464d6933c59955492081dbbcd91be27358406db3e05
+  data.tar.gz: 9af0094e1b31fa6449fcc29782dad03cb89514baa8e3bea7b7fdc08bf4c7d2e0
+SHA512:
+  metadata.gz: 5d007132685ef42c35f06015447d8cdb77b79cab1be4a81707328354f318b3be00343a55b889fd85421ed2068f55f15c012f6a77931fff02a2f850b35881b9e3
+  data.tar.gz: 7897dc767d5374367589bb00f8c098bcb537a08dff61864931ff57409b77e0a36de45a36e45cd26969241e5a66495b7fefea2500dd0bea7c63c03f67fb68f519

data/.gitignore

@@ -0,0 +1,19 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+Gemfile.lock
+*.installed
+ports/
+vendor/
+*.dll
+*.dylib
+*.so
+/.vscode/
+
+# remote file cache
+.rubocop-*

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,18 @@
+inherit_from:
+  - 'https://raw.githubusercontent.com/riboseinc/oss-guides/master/ci/rubocop.yml'
+
+AllCops:
+  TargetRubyVersion: 2.7
+  SuggestExtensions: false
+  NewCops: enable
+  Exclude:
+    - 'ffi-libarchive-binary.gemspec'
+    - 'tmp/**/*'
+    - 'pkg/**/*'
+    - 'ports/**/*'
+
+Gemspec/RequireMFA:
+  Enabled: false
+
+Layout/LineLength:
+  Max: 160

data/Gemfile

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gemspec

data/README.adoc

@@ -0,0 +1,255 @@
+= Binaries for ffi-libarchive
+
+image:https://img.shields.io/gem/v/ffi-libarchive-binary.svg["Gem Version", link="https://rubygems.org/gems/ffi-libarchive-binary"]
+image:https://github.com/fontist/ffi-libarchive-binary/actions/workflows/test-and-release.yml/badge.svg["Build Status", link="https://github.com/fontist/ffi-libarchive-binary/actions/workflows/test-and-release.yml"]
+
+== Purpose
+
+Contains pre-compiled and install-time-compiled binaries for ffi-libarchive.
+
+
+== Installation
+
+Add this line to your application's Gemfile:
+
+[source,ruby]
+----
+gem "ffi-libarchive-binary"
+----
+
+And then execute:
+
+[source,sh]
+----
+$ bundle install
+----
+
+Or install it yourself as:
+
+[source,sh]
+----
+$ gem install ffi-libarchive-binary
+----
+
+
+== Usage
+
+Require the gem and use calls from https://github.com/chef/ffi-libarchive[ffi-libarchive].
+
+[source,ruby]
+----
+require "ffi-libarchive-binary"
+
+path = File.expand_path('file.pkg', __dir__)
+flags = Archive::EXTRACT_PERM
+reader = Archive::Reader.open_filename(path)
+
+reader.each_entry do |entry|
+  reader.extract(entry, flags.to_i)
+end
+
+reader.close
+----
+
+== Development
+
+We are following Sandi Metz's Rules for this gem, you can read the
+http://robots.thoughtbot.com/post/50655960596/sandi-metz-rules-for-developers[description of the rules here].
+All new code should follow these
+rules. If you make changes in a pre-existing file that violates these rules you
+should fix the violations as part of your contribution.
+
+== Releasing
+
+The gem uses an automated release workflow that handles version bumping and
+publishing to RubyGems using the `gem-release` gem.
+
+=== Release workflow
+
+The release process is managed through GitHub Actions workflow dispatch:
+
+. Navigate to the Actions tab in the GitHub repository
+. Select the "release" workflow
+. Click "Run workflow"
+. Choose the version bump type:
+  - `x.y.z` - Set a specific version (e.g., `1.2.3`)
+  - `major` - Bump major version (e.g., `0.4.2` → `1.0.0`)
+  - `minor` - Bump minor version (e.g., `0.4.2` → `0.5.0`)
+  - `patch` - Bump patch version (e.g., `0.4.2` → `0.4.3`)
+  - `skip` - Publish current version without bumping (useful for republishing)
+
+The workflow will:
+
+. Install the `gem-release` gem
+. Bump the version in [`lib/ffi-libarchive-binary/version.rb`](lib/ffi-libarchive-binary/version.rb:4) (if not skip)
+. Create a git commit with the version change
+. Create a git tag (`vX.Y.Z`)
+. Push changes to the repository
+. Build platform-specific gems for all supported platforms
+. Publish all gems to RubyGems
+
+NOTE: The workflow uses the `gem-release` gem which provides a reliable and
+well-tested version bumping mechanism used across many Ruby projects.
+
+=== Manual release
+
+For manual releases, you can use the `gem-release` gem directly:
+
+[source,shell]
+----
+# Install gem-release if not already installed
+gem install gem-release
+
+# Bump patch version (0.4.2 -> 0.4.3) and create tag
+gem bump --version patch --tag --push
+
+# Bump minor version (0.4.2 -> 0.5.0) and create tag
+gem bump --version minor --tag --push
+
+# Bump major version (0.4.2 -> 1.0.0) and create tag
+gem bump --version major --tag --push
+
+# Set specific version and create tag
+gem bump --version 1.2.3 --tag --push
+----
+
+Once the tag is pushed, the release workflow will automatically trigger and build
+the gems for all platforms.
+
+== Platform configuration
+
+The gem uses centralized platform configuration in [`.github/platforms.json`](.github/platforms.json:1)
+as the single source of truth for all platform-specific settings.
+
+=== Platform metadata
+
+Each platform entry includes:
+
+* `platform` - Platform identifier for gem naming (e.g., `x86_64-linux`)
+* `os` - GitHub Actions runner to use for building
+* `ruby` - Ruby version to use
+* `description` - Human-readable description
+* `build` - Whether to build a gem for this platform
+* `test` - Whether to test this platform
+* `test_os` - Array of OS runners to test on (if applicable)
+* `cross_compile` - Whether this requires cross-compilation
+* `notes` - Additional information
+
+=== Listing platforms
+
+Use the provided script to list all configured platforms:
+
+[source,shell]
+----
+# List all platforms
+bin/list-platforms
+
+# List only build platforms
+bin/list-platforms --build
+
+# List only test platforms
+bin/list-platforms --test
+----
+
+=== Adding or removing platforms
+
+To add or modify platform support:
+
+. Edit [`.github/platforms.json`](.github/platforms.json:1)
+. Update the platform entry with appropriate settings
+. Set `"build": true` to enable building for that platform
+. Set `"test": true` to enable testing for that platform
+. Update the platform arrays (`build_platforms` and `test_platforms`) at the bottom of the file
+
+NOTE: When adding a new platform, ensure the GitHub Actions runner is available
+and the build toolchain is properly configured.
+
+=== Windows ARM64 support
+
+Windows ARM64 (`arm64-mingw-ucrt`) builds pre-compiled gems for Windows on ARM64
+devices (e.g., Surface Pro X, Windows 11 ARM). This platform uses the GitHub
+Actions `windows-11-arm` runner.
+
+== Contributing
+
+First, thank you for contributing! We love pull requests from everyone. By
+participating in this project, you hereby grant https://www.ribose.com[Ribose Inc.] the
+right to grant or transfer an unlimited number of non exclusive licenses or
+sub-licenses to third parties, under the copyright covering the contribution
+to use the contribution by all means.
+
+Here are a few technical guidelines to follow:
+
+1. Open an https://github.com/fontist/ffi-libarchive-binary/issues[issue] to discuss a new feature.
+1. Write tests to support your new feature.
+1. Make sure the entire test suite passes locally and on CI.
+1. Open a Pull Request.
+1. https://github.com/thoughtbot/guides/tree/master/protocol/git#write-a-feature[Squash your commits]
+  after receiving feedback.
+1. Party!
+
+
+== License
+
+This gem is distributed with a BSD 3-Clause license.
+
+This gem is developed, maintained and funded by https://www.ribose.com/[Ribose Inc.]
+
+=== Supported platforms
+
+The following platforms are officially tested and supported:
+
+[cols="1,1,1,1",options="header"]
+|===
+| Platform | Architecture | Ruby Versions | Status
+
+| Windows 2022 | x86_64 | 3.1+ | ✅ Supported
+| Windows 2025 | x86_64 | 3.1+ | ✅ Supported
+| Windows 11 ARM | ARM64 | 3.4+ | ✅ Supported
+| macOS 15 | ARM64 (Apple Silicon) | 3.1+ | ✅ Supported
+| macOS 15 Large | x86_64 (Intel) | 3.1+ | ✅ Supported
+| macOS 26 | ARM64 (Apple Silicon) | 3.1+ | ✅ Supported
+| Ubuntu 24.04 | x86_64 (glibc) | 3.1+ | ✅ Supported
+| Ubuntu 22.04 | x86_64 (glibc) | 3.1+ | ✅ Supported
+| Alpine Linux | x86_64 (musl) | 3.1+ | ✅ Supported
+| Ubuntu 24.04 | ARM64 (glibc) | 3.1+ | ✅ Supported
+| Ubuntu 22.04 | ARM64 (glibc) | 3.1+ | ✅ Supported
+| Alpine Linux | ARM64 (musl) | 3.1+ | ✅ Supported
+|===
+
+NOTE: The gem provides pre-compiled binaries for 11 platforms. Separate binaries
+are provided for glibc-based (gnu) and musl-based Linux distributions to ensure
+compatibility.
+
+=== OpenSSL compiler target strategy
+
+The gem explicitly sets OpenSSL compiler targets to ensure correct assembly
+code generation:
+
+[cols="1,1,1",options="header"]
+|===
+| Platform | Compiler Target | Reason
+
+| Windows x64 | `mingw64` | Explicit x86_64 assembly selection
+| Linux x86_64 (gnu/musl) | Auto-detect | Native toolchain works correctly
+| Linux ARM64 (gnu/musl) | Auto-detect | Native toolchain works correctly
+| macOS ARM64 | Auto-detect | Native toolchain works correctly
+| macOS x64 | Auto-detect | Native toolchain works correctly
+|===
+
+NOTE: Windows platforms require explicit compiler targets because OpenSSL's
+auto-detection does not reliably select the correct target on Windows.
+Linux musl and glibc variants use the same OpenSSL configuration with
+auto-detection, as the toolchain correctly identifies the target.
+
+== Build requirements
+
+=== Windows
+
+==== Windows x64
+
+For building from source on Windows x64, you need:
+
+* Ruby 2.7 or higher with DevKit
+* MinGW-w64 x86_64 toolchain
+* MSYS2 (recommended) or equivalent Unix-like environment

data/Rakefile

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+require "rbconfig"
+require "rake/clean"
+require "rubygems/package_task"
+require_relative "lib/ffi-libarchive-binary/libarchive_recipe"
+
+require "rspec/core/rake_task"
+require "rubocop/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]
+task spec: :compile
+
+desc "Build install-compilation gem"
+task "gem:native:any" do
+  sh "rake platform:any gem"
+end
+
+desc "Define the gem task to build on any platform (compile on install)"
+task "platform:any" do
+  spec = Gem::Specification::load("ffi-libarchive-binary.gemspec").dup
+  task = Gem::PackageTask.new(spec)
+  task.define
+end
+
+platforms = [
+  ["x64-mingw32", "x86_64-w64-mingw32"],
+  ["x64-mingw-ucrt", "x86_64-w64-mingw32"],
+  ["arm64-mingw-ucrt", "aarch64-w64-mingw32"],
+  ["x86_64-linux", "x86_64-linux-gnu"],
+  ["x86_64-linux-gnu", "x86_64-linux-gnu"],
+  ["x86_64-linux-musl", "x86_64-linux-musl"],
+  ["aarch64-linux", "aarch64-linux-gnu"],
+  ["aarch64-linux-gnu", "aarch64-linux-gnu"],
+  ["aarch64-linux-musl", "aarch64-linux-musl"],
+  ["x86_64-darwin", "x86_64-apple-darwin"],
+  ["arm64-darwin", "arm64-apple-darwin"],
+]
+
+platforms.each do |platform, host|
+  desc "Build pre-compiled gem for the #{platform} platform"
+  task "gem:native:#{platform}" do
+    sh "rake compile[#{host}] platform:#{platform} gem"
+  end
+
+  desc "Define the gem task to build on the #{platform} platform (binary gem)"
+  task "platform:#{platform}" do
+    spec = Gem::Specification::load("ffi-libarchive-binary.gemspec").dup
+    spec.platform = Gem::Platform.new(platform)
+    spec.files += Dir.glob("lib/ffi-libarchive-binary/*.{dll,so,dylib}")
+    spec.extensions = []
+    spec.dependencies.reject! { |d| d.name == "mini_portile2" }
+
+    task = Gem::PackageTask.new(spec)
+    task.define
+  end
+end
+
+desc "Compile binary for the target host"
+task :compile, [:host] do |_t, args|
+  recipe = LibarchiveBinary::LibarchiveRecipe.new
+  if args[:host]
+    recipe.host = args[:host]
+  else
+    recipe.host = "x86_64-apple-darwin" if /x86_64-apple-darwin*/.match?(recipe.host)
+    recipe.host = "arm64-apple-darwin" if /arm64-apple-darwin*/.match?(recipe.host)
+  end
+  recipe.cook_if_not
+end
+
+CLOBBER.include("pkg")
+CLEAN.include("ports",
+              "tmp",
+              "lib/ffi-libarchive-binary/libarchive-13.dll",
+              "lib/ffi-libarchive-binary/libarchive.dylib",
+              "lib/ffi-libarchive-binary/libarchive.so")

data/ext/Makefile

@@ -0,0 +1,4 @@
+# dummy Makefile, it is required to build an extension
+all:
+clean:
+install:

data/ext/configuration.yml

@@ -0,0 +1,49 @@
+libraries:
+  # Windows ARM64 support is enabled via platform-specific configurations below:
+  # - OpenSSL uses version 3.3.2 for Windows ARM64 (required for ARM64 compatibility)
+  # - OpenSSL uses version 1.1.1w for Windows x64 (more stable for x86_64)
+  # - xz uses version 5.2.4 for all Windows platforms (MinGW compatibility)
+  # - Other libraries use cross-platform versions under 'all'
+  zlib:
+    all:
+      version: "1.3.1"
+      url: "https://zlib.net/zlib-1.3.1.tar.gz"
+      sha256: "9a93b2b7dfdac77ceba5a558a580e74667dd6fede4585b91eefb60f03b72df23"
+  libexpat:
+    all:
+      version: "2.7.4"
+      url: "https://github.com/libexpat/libexpat/releases/download/R_2_7_4/expat-2.7.4.tar.gz"
+      sha256: "461ecc8aa98ab1a68c2db788175665d1a4db640dc05bf0e289b6ea17122144ec"
+  # openssl:
+  #   version 3.x.y requires pod2man, that is not easily available on Windows x64
+  openssl:
+    windows-x64:
+      version: "3.6.1"
+      url: "https://github.com/openssl/openssl/releases/download/openssl-3.6.1/openssl-3.6.1.tar.gz"
+      sha256: "b1bfedcd5b289ff22aee87c9d600f515767ebf45f77168cb6d64f231f518a82e"
+    windows-arm64:
+      version: "3.6.1"
+      url: "https://github.com/openssl/openssl/releases/download/openssl-3.6.1/openssl-3.6.1.tar.gz"
+      sha256: "b1bfedcd5b289ff22aee87c9d600f515767ebf45f77168cb6d64f231f518a82e"
+    all:
+      version: "3.6.1"
+      url: "https://github.com/openssl/openssl/releases/download/openssl-3.6.1/openssl-3.6.1.tar.gz"
+      sha256: "b1bfedcd5b289ff22aee87c9d600f515767ebf45f77168cb6d64f231f518a82e"
+  # xz:
+  #   versions > 5.2.4 get crazy on MinGW
+  #   versions <= 5.2.5 do not support arm64-apple-darwin target
+  #   version 5.2.7 could not be linked statically to libarchive
+  xz:
+    windows:
+      version: "5.2.4"
+      url: "https://tukaani.org/xz/xz-5.2.4.tar.gz"
+      sha256: "b512f3b726d3b37b6dc4c8570e137b9311e7552e8ccbab4d39d47ce5f4177145"
+    all:
+      version: "5.2.6"
+      url: "https://tukaani.org/xz/xz-5.2.6.tar.gz"
+      sha256: "a2105abee17bcd2ebd15ced31b4f5eda6e17efd6b10f921a01cda4a44c91b3a0"
+  libarchive:
+    all:
+      version: "3.8.5"
+      url: "https://github.com/libarchive/libarchive/releases/download/v3.8.5/libarchive-3.8.5.tar.gz"
+      sha256: "8a60f3a7bfd59c54ce82ae805a93dba65defd04148c3333b7eaa2102f03b7ffd"

data/ext/extconf.rb

@@ -0,0 +1,6 @@
+$: << File.expand_path(File.join(File.dirname(__FILE__), "../lib"))
+
+require "ffi-libarchive-binary/libarchive_recipe"
+
+recipe = LibarchiveBinary::LibarchiveRecipe.new
+recipe.cook_if_not

data/ffi-libarchive-binary.gemspec

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+$: << File.expand_path("lib", __dir__)
+require "ffi-libarchive-binary/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "ffi-libarchive-binary"
+  spec.version       = LibarchiveBinary::VERSION
+  spec.authors       = ["Ribose Inc."]
+  spec.email         = ["open.source@ribose.com"]
+
+  spec.summary       = "Binaries for ffi-libarchive"
+  spec.description   = "Contains pre-compiled and install-time-compiled binaries for ffi-libarchive"  # rubocop:disable Layout/LineLength
+  spec.homepage      = "https://github.com/fontist/ffi-libarchive-binary"
+  spec.license       = "BSD-3-Clause"
+  spec.required_ruby_version = Gem::Requirement.new(">= 3.1.0")
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/fontist/ffi-libarchive-binary"
+  spec.metadata["changelog_uri"] = "https://github.com/fontist/ffi-libarchive-binary"
+
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    Dir.glob([
+      "lib/**/*.rb",
+      "lib/**/*.{so,dylib,dll}",
+      "ext/**/*",
+      "toolchain/**/*",
+      "ffi-libarchive-binary.gemspec",
+      "Gemfile",
+      "Rakefile",
+      "README.adoc",
+      ".gitignore",
+      ".rspec",
+      ".rubocop.yml"
+    ], base: __dir__)
+  end
+
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+  spec.extensions    = ["ext/extconf.rb"]
+
+  spec.add_runtime_dependency "ffi", "~> 1.0"
+  spec.add_runtime_dependency "ffi-libarchive", "~> 1.0"
+  spec.add_runtime_dependency "mini_portile2", "~> 2.7"
+  spec.add_runtime_dependency "rake", "~> 13.0"
+
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "rubocop", "~> 1.7"
+  spec.add_development_dependency "rubocop-performance", "~> 1.15"
+end

data/lib/ffi-libarchive-binary/base_recipe.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+require "mini_portile2"
+require_relative "configuration"
+
+module LibarchiveBinary
+  FORMATS = {
+    "arm64-apple-darwin" => "Mach-O 64-bit dynamically linked shared library arm64",
+    "x86_64-apple-darwin" => "Mach-O 64-bit dynamically linked shared library x86_64",
+    "aarch64-linux-gnu" => "ELF 64-bit LSB shared object, ARM aarch64",
+    "x86_64-linux-gnu" => "ELF 64-bit LSB shared object, x86-64",
+    "x86_64-w64-mingw32" => "PE32+ executable",
+    "aarch64-w64-mingw32" => "PE32+ executable",
+  }.freeze
+
+  ARCHS = {
+    "arm64-apple-darwin" => "arm64",
+    "x86_64-apple-darwin" => "x86_64",
+  }.freeze
+
+  LIBNAMES = {
+    "x86_64-w64-mingw32" => "libarchive.dll",
+    "aarch64-w64-mingw32" => "libarchive.dll",
+    "x86_64-linux-gnu" => "libarchive.so",
+    "aarch64-linux-gnu" => "libarchive.so",
+    "x86_64-apple-darwin" => "libarchive.dylib",
+    "arm64-apple-darwin" => "libarchive.dylib",
+  }.freeze
+
+  ROOT = Pathname.new(File.expand_path("../..", __dir__))
+
+  class BaseRecipe < MiniPortile
+    def initialize(name)
+      library = LibarchiveBinary.library_for(name)
+      version = library["version"]
+      super(name, version)
+      @target = ROOT.join(@target).to_s
+      @files << {
+        url: library["url"],
+        sha256: library["sha256"],
+      }
+      @printed = {}
+    end
+
+    def apple_arch_flag(host)
+      fl = ARCHS[host]
+      fl.nil? ? "" : " -arch #{fl}"
+    end
+
+    def cflags(host)
+      "CFLAGS=-fPIC#{apple_arch_flag(host)}"
+    end
+
+    def ldflags(host)
+      "LDFLAGS=-fPIC#{apple_arch_flag(host)}"
+    end
+
+    def cross_compiler_env(host)
+      # For aarch64 cross-compilation, set the compiler
+      return {} unless host&.start_with?("aarch64")
+
+      if host == "aarch64-linux-gnu" || host == "aarch64-linux-musl"
+        # Note: We use aarch64-linux-gnu-gcc for both glibc and musl targets because:
+        # 1. We build static libraries (.a files) which are libc-agnostic
+        # 2. The compiler generates aarch64 machine code (architecture-specific)
+        # 3. glibc vs musl only matters for dynamic linking at runtime
+        # 4. Our static libs link into libarchive.so which links to the target libc
+        {
+          "CC" => "aarch64-linux-gnu-gcc",
+          "CXX" => "aarch64-linux-gnu-g++",
+          "AR" => "aarch64-linux-gnu-ar",
+          "RANLIB" => "aarch64-linux-gnu-ranlib",
+          "STRIP" => "aarch64-linux-gnu-strip",
+        }
+      elsif host == "aarch64-w64-mingw32"
+        # For Windows ARM64 cross-compilation, use regular clang with explicit target
+        # Not clang-cl because configure scripts don't recognize it as a C99 compiler
+        {
+          "CC" => "clang -target aarch64-w64-mingw32",
+          "CXX" => "clang++ -target aarch64-w64-mingw32",
+          "AR" => "ar",
+          "RANLIB" => "ranlib",
+          "NM" => "nm",
+          # Put all windres flags in RC to prevent OpenSSL from appending --target=pe-x86-64
+          # OpenSSL's mingw64 target adds --target=pe-x86-64 which must be the LAST flag
+          "RC" => "windres",
+        }
+      else
+        {}
+      end
+    end
+
+    def message(text)
+      return super unless text.start_with?("\rDownloading")
+
+      match = text.match(/(\rDownloading .*)\((\s*)(\d+)%\)/)
+      pattern = match ? match[1] : text
+      return if @printed[pattern] && match[3].to_i != 100
+
+      @printed[pattern] = true
+      super
+    end
+  end
+end

data/lib/ffi-libarchive-binary/configuration.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require "psych"
+require "yaml"
+
+module LibarchiveBinary
+  def self.libraries
+    configuration_file = File.join(File.dirname(__FILE__), "..", "..", "ext", "configuration.yml")
+    @@libraries ||= ::YAML.load_file(configuration_file)["libraries"] || {}
+  rescue Psych::SyntaxError => e
+    puts "Warning: The configuration file '#{configuration_file}' contains invalid YAML syntax."
+    puts e.message
+    exit 1
+  rescue StandardError => e
+    puts "An unexpected error occurred while loading the configuration file '#{configuration_file}'."
+    puts e.message
+    exit 1
+  end
+
+  def self.library_for(libname)
+    if MiniPortile::windows?
+      # Detect Windows ARM64
+      if RUBY_PLATFORM =~ /aarch64|arm64/i
+        libraries[libname]["windows-arm64"] || libraries[libname]["windows"] || libraries[libname]["all"]
+      else
+        libraries[libname]["windows-x64"] || libraries[libname]["windows"] || libraries[libname]["all"]
+      end
+    else
+      libraries[libname]["all"]
+    end
+  rescue StandardError => e
+    puts "Failed to load library configuration for '#{libname}'."
+    puts e.message
+    exit 1
+  end
+end