omnizip 0.4.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7a04b0c83ee4e9c6b57823c8db709178ed2b88e073f658fb6573d9f69fa7459f
-  data.tar.gz: 1c5d9b7e86c1d1322cfd8a8193fcec2c8b7a4d28a21b6ee4b6fca3a359bc01e3
+  metadata.gz: 06cbc9a2cd22e74a84d82211efa5e000d857da117bae9a995b76520839211362
+  data.tar.gz: e8ab9ec5638953dda59f4b43aa299cfa55262f77d3c9e9f795bbe8800d443592
 SHA512:
-  metadata.gz: c22355d1136d66e0c6632ce6b4ad57a1b27c8cf826b0f5593318bffd20e85de77ed8072e280a88aa01433ef658fb1adc9139ff1ff8aa6d31735efb6aea1fc9f5
-  data.tar.gz: b06259b9ca3ede7ed15bdfa33537a9d9a17099a59ac5b0d5dc95a4f29a46ead222641abf4e8a17f17a283b1272f99d589c3541d799da0f932fc58a1401aa0d2c
+  metadata.gz: ecd9426b7a3f0a75c68821ec6c2c4c0f0f4f6f5e5ae7a252dc6e1e4fb9f5eb94a01b84f937c797581b44584e8cc4ba244d35e37c2338b1401c46de42299a1627
+  data.tar.gz: 268f70fb015d2e21b8079cae5ea4e09a83e036e967cf83bed03cc37de45b61f1875547b1443b419eec502a3bcc264e323d19bb8c503f72437cfb47bbd9d31853

data/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+- `rake rust:build` — one command to build and vendor the Rust
+  backend's cdylib (clones omnizip-rs or reuses a checkout via
+  REPO=); the loader gains the `vendor/` resolution tier behind
+  `OMNIZIP_FFI_DYLIB`. No toolchain, no failure: the gem stays
+  pure Ruby. docs/rust-backend.md documents the tier policy,
+  resolution order, and CI pinning.
+
+
 ### Added
 - Rust-accelerated backend tier: `Omnizip::Backends` is the single
   tier switch between the pure-Ruby cores and the `omnizip-ffi`

data/lib/omnizip/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Omnizip
-  VERSION = "0.4.0"
+  VERSION = "0.4.1"
 end

data/lib/tasks/rust_backend.rake

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+# One command to build the Rust-accelerated backend's cdylib into
+# the gem's vendor dir (TODO.ref-parity/62 — the distribution
+# story). Requires git + a Rust toolchain; the gem stays fully
+# functional (pure Ruby) without ever running this.
+#
+#   bundle exec rake rust:build
+#   bundle exec rake rust:build REPO=/path/to/omnizip-rs
+desc "Build the omnizip-ffi cdylib into vendor/ for the Rust tier"
+task "rust:build" do
+  repo = ENV.fetch("REPO", nil)
+  gem_root = File.expand_path("../..", __dir__)
+  build = File.join(gem_root, "build", "rust")
+
+  require "fileutils"
+  FileUtils.mkdir_p(build)
+  src = if repo
+          File.expand_path(repo)
+        else
+          target = File.join(build, "omnizip-rs")
+          if File.directory?(File.join(target, ".git"))
+            system("git", "-C", target, "fetch", "--quiet", "origin") or abort "git fetch failed in #{target}"
+            system("git", "-C", target, "reset", "--quiet", "--hard", "origin/main") or abort "git reset failed"
+          else
+            system("git", "clone", "--quiet", "--depth", "1",
+                   "https://github.com/omnizip/omnizip-rs.git", target) or abort "clone failed"
+          end
+          target
+        end
+
+  abort "#{src} has no omnizip-ffi crate" unless File.directory?(File.join(src, "omnizip-ffi"))
+
+  system("cargo", "build", "--release", "-p", "omnizip-ffi", chdir: src) or abort "cargo build failed"
+
+  vendor = File.join(gem_root, "vendor")
+  FileUtils.mkdir_p(vendor)
+  %w[dylib so dll].each do |ext|
+    candidate = File.join(src, "target", "release", "libomnizip_ffi.#{ext}")
+    next unless File.file?(candidate)
+
+    FileUtils.cp(candidate, vendor)
+    puts "vendored: #{File.join(vendor, "libomnizip_ffi.#{ext}")}"
+    puts "tier: OMNIZIP_BACKEND=auto now uses the Rust decoders"
+    exit 0
+  end
+  abort "cdylib not found under #{src}/target/release"
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: omnizip
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.1
 platform: ruby
 authors:
 - Ribose Inc.
@@ -211,6 +211,7 @@ files:
 - docs/reference/index.adoc
 - docs/resources/faq.adoc
 - docs/resources/quick-reference.adoc
+- docs/rust-backend.md
 - docs/troubleshooting/index.adoc
 - docs/xar_format.md
 - examples/api_comparison.rb
@@ -722,6 +723,7 @@ files:
 - lib/omnizip/zip/input_stream.rb
 - lib/omnizip/zip/output_stream.rb
 - lib/tasks/msi_test_files.rake
+- lib/tasks/rust_backend.rake
 - readme-docs/advanced-features.adoc
 - readme-docs/api-usage.adoc
 - readme-docs/architecture.adoc