pack-rb 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8fcc3c6b2afa83dab5eeea8421f61e9c5fc89c4ec8cdac5ec679d7d4cb54c551
+  data.tar.gz: c6c8629d199f1472a0a40183e891b17ab0c5ef6e1d69a673bfb1d025536ef68d
+SHA512:
+  metadata.gz: 991e7b738fd63b7edfc303a931f81d86de289cf5f758692ecca6e18011cecb2f1ad31745f1e344fe278a6e0eb719fcaee9c02c4c4708384745ff585b771a16ed
+  data.tar.gz: cc3430255f66129741fb25c7d98d557958a3de82ecc6e9f285ee12ce4c29198142fb8eac0e5a218bf2f2ed3d050bd4f1833dc3cc1c416ce23e41172f837345f1

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Piper Software
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,20 @@
+# pack-rb
+
+`pack-rb` installs a `pack` executable through RubyGems and delegates to the Pack Rust binary.
+
+```bash
+gem install pack-rb
+pack --help
+```
+
+On first run, the wrapper detects the current platform, downloads the matching Pack release asset from GitHub Releases, stores it in the user cache, and execs it.
+
+The wrapper follows GitHub release redirects and verifies the downloaded binary against the published `SHA256SUMS` file before it is installed.
+
+Environment variables:
+
+- `PACK_RB_VERSION` forces a specific Pack version instead of the gem version.
+- `PACK_RB_GITHUB_REPOSITORY` overrides the default release repository.
+- `PACK_RB_DOWNLOAD_BASE_URL` overrides the release download base URL completely.
+- `PACK_RB_INSTALL_DIR` overrides the local binary cache directory.
+- `PACK_RB_SKIP_CHECKSUM=1` disables checksum verification for custom development mirrors.

data/exe/pack

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "pack/rb"
+
+Pack::RB::Launcher.run(ARGV)

data/lib/pack/rb/launcher.rb

@@ -0,0 +1,176 @@
+require "fileutils"
+require "digest"
+require "net/http"
+require "rbconfig"
+require "tempfile"
+require "tmpdir"
+require "uri"
+
+module Pack
+  module RB
+    class Launcher
+      class Error < StandardError; end
+
+      class << self
+        def run(argv = ARGV)
+          new(argv).run
+        end
+      end
+
+      def initialize(argv)
+        @argv = argv
+      end
+
+      def run
+        binary = ensure_binary!
+        exec(binary, *@argv)
+      rescue SystemCallError => e
+        raise Error, "failed to launch pack binary: #{e.message}"
+      end
+
+      private
+
+      def ensure_binary!
+        path = installed_binary_path
+        return path if File.exist?(path)
+
+        FileUtils.mkdir_p(File.dirname(path))
+        download_to(path)
+        FileUtils.chmod("+x", path) unless windows?
+        path
+      end
+
+      def download_to(path)
+        checksum = expected_checksum_for(asset_name)
+        with_download_response(download_url) do |response|
+          Tempfile.create(["pack-rb", windows? ? ".exe" : ""], File.dirname(path)) do |tmp|
+            tmp.binmode
+            response.read_body { |chunk| tmp.write(chunk) }
+            tmp.flush
+            staged_path = tmp.path
+            tmp.close
+            verify_checksum!(staged_path, checksum)
+            FileUtils.mv(staged_path, path)
+          end
+        end
+      rescue SocketError, IOError, SystemCallError, Timeout::Error => e
+        raise Error, "failed to download pack binary: #{e.message}"
+      end
+
+      def with_download_response(url, limit = 5, &block)
+        raise Error, "too many redirects while downloading #{url}" if limit <= 0
+
+        uri = URI.parse(url)
+        Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") do |http|
+          http.open_timeout = 15
+          http.read_timeout = 120
+
+          request = Net::HTTP::Get.new(uri.request_uri)
+          request["User-Agent"] = "pack-rb/#{VERSION}"
+          request["Accept"] = "application/octet-stream"
+
+          http.request(request) do |response|
+            case response
+            when Net::HTTPSuccess
+              yield response
+            when Net::HTTPRedirection
+              location = response["location"]
+              raise Error, "redirect missing location for #{url}" unless location
+
+              redirected = URI.join(url, location).to_s
+              with_download_response(redirected, limit - 1, &block)
+            else
+              raise Error, "download failed with HTTP #{response.code} from #{url}"
+            end
+          end
+        end
+      end
+
+      def expected_checksum_for(target_asset)
+        return nil if ENV["PACK_RB_SKIP_CHECKSUM"] == "1"
+
+        body = +""
+        with_download_response("#{download_base_url}/SHA256SUMS") do |response|
+          response.read_body { |chunk| body << chunk }
+        end
+
+        match = body.each_line.map(&:strip).find { |line| line.end_with?("  #{target_asset}") }
+        raise Error, "checksum entry missing for #{target_asset}" unless match
+
+        match.split(/\s+/, 2).first
+      end
+
+      def verify_checksum!(path, expected)
+        return unless expected
+
+        actual = Digest::SHA256.file(path).hexdigest
+        return if actual == expected
+
+        raise Error, "checksum mismatch for downloaded pack binary"
+      end
+
+      def download_url
+        "#{download_base_url}/#{asset_name}"
+      end
+
+      def download_base_url
+        ENV["PACK_RB_DOWNLOAD_BASE_URL"] || "https://github.com/#{github_repository}/releases/download/v#{pack_version}"
+      end
+
+      def github_repository
+        ENV["PACK_RB_GITHUB_REPOSITORY"] || "Blu3Ph4ntom/pack"
+      end
+
+      def installed_binary_path
+        File.join(install_dir, pack_version, asset_name)
+      end
+
+      def install_dir
+        ENV["PACK_RB_INSTALL_DIR"] || File.join(Dir.home, ".pack-rb", "bin")
+      end
+
+      def pack_version
+        ENV["PACK_RB_VERSION"] || VERSION
+      end
+
+      def asset_name
+        "pack-#{target_triple}#{windows? ? '.exe' : ''}"
+      end
+
+      def target_triple
+        @target_triple ||= begin
+          cpu = normalize_cpu
+          os = RbConfig::CONFIG["host_os"]
+
+          case os
+          when /linux/
+            raise Error, "unsupported CPU for Linux: #{cpu}" unless cpu == "x86_64"
+            "x86_64-unknown-linux-gnu"
+          when /darwin/
+            "#{cpu}-apple-darwin"
+          when /mswin|mingw|cygwin/
+            raise Error, "unsupported CPU for Windows: #{cpu}" unless cpu == "x86_64"
+            "x86_64-pc-windows-msvc"
+          else
+            raise Error, "unsupported platform: #{RbConfig::CONFIG["host_cpu"]} #{os}"
+          end
+        end
+      end
+
+      def normalize_cpu
+        case RbConfig::CONFIG["host_cpu"]
+        when "x86_64", "amd64", "x64"
+          "x86_64"
+        when "arm64", "aarch64"
+          "aarch64"
+        else
+          raise Error, "unsupported CPU: #{RbConfig::CONFIG["host_cpu"]}"
+        end
+      end
+
+      def windows?
+        (/mswin|mingw|cygwin/ =~ RbConfig::CONFIG["host_os"]) != nil
+      end
+    end
+  end
+end

data/lib/pack/rb/version.rb

@@ -0,0 +1,5 @@
+module Pack
+  module RB
+    VERSION = "0.1.1"
+  end
+end

data/lib/pack/rb.rb

@@ -0,0 +1,2 @@
+require_relative "rb/version"
+require_relative "rb/launcher"

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification
+name: pack-rb
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Hemanth
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2026-04-30 00:00:00.000000000 Z
+dependencies: []
+description: pack-rb installs a Ruby wrapper executable named `pack` that downloads
+  the matching Pack release binary for the current platform and then hands control
+  to it.
+email:
+- opensource@blu3phantom.dev
+executables:
+- pack
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- exe/pack
+- lib/pack/rb.rb
+- lib/pack/rb/launcher.rb
+- lib/pack/rb/version.rb
+homepage: https://github.com/Blu3Ph4ntom/pack
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://blu3ph4ntom.github.io/pack/
+  source_code_uri: https://github.com/Blu3Ph4ntom/pack
+  documentation_uri: https://blu3ph4ntom.github.io/pack/docs/
+  changelog_uri: https://github.com/Blu3Ph4ntom/pack/releases
+  rubygems_mfa_required: 'true'
+post_install_message: |
+  pack-rb installed the `pack` launcher.
+  First run will download the matching Pack binary from GitHub Releases.
+
+  Example:
+    pack --help
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Install and launch the Pack Rust binary from RubyGems.
+test_files: []