omnizip 0.3.54 → 0.3.55

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 87089cc22eb4f5edd1cb37e7a0de297527fb2f7c0a2815f29d1ff271c73f7461
-  data.tar.gz: e6b7848399a98ae4f38f80cbc71833ada099e071d4f4126437ebbfcca820dc48
+  metadata.gz: 7de280d85fcea7072c88798c925b5aa3e03bcff124c1294e72abeb6f976cc5e8
+  data.tar.gz: 579759d99f27af57c070e5e1b6a6d6b121651932b10681da88e96331adb36bee
 SHA512:
-  metadata.gz: cfd421337992988889d3e5e8d4e85177248c5586238c2c79a5d87e5fc2229de3620f53e93d582ac72992c90b213421b1832cd44ecb9e1ff94e94622a48fa6b88
-  data.tar.gz: 33ca53cfe50c72a1d31afbbf0848ed9559824867edf34f1a4fdc37484300c029fcbf36bdb3135d92f607e31c517d6a519e945065a6c17f817cfbdc0af9ee6de9
+  metadata.gz: a08a53e33284555a3fe7493834f522e0bf00a8609705e06d6c05578bb342bb3db4e4ba1c3c0793f18a001ef55305fd3396a7300b6c7f1c82196a9702931fc374
+  data.tar.gz: 7b0550e981ff0cb317beffdcb7eff7b233a7fff0bc4812eae01a566f1a0d255de8896e217d1d1ce62618b56bb5ea284dc414c98b53c171fa4af0b54a1a048b86

data/CHANGELOG.md

@@ -7,6 +7,41 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.54] - 2026-09-01
+
+### Changed
+- The 7z tree's 38 bare `raise "string"` sites gain their matching
+  classes: `PasswordError` for encrypted-header problems (with a
+  new autoload entry — the class lives at the top of password.rb,
+  so referencing it never loaded the file),
+  `InvalidArchiveError`/`UnsupportedFormatError` for parse and
+  structure failures, `ChecksumError` for CRC mismatches,
+  `AlgorithmNotFoundError`/`UnknownFilterError` in CoderChain, and
+  `Errno::ENOENT` for missing entries and volumes. The reader's
+  encrypted-header probe re-raises password errors by class instead
+  of matching message text.
+- In-memory ZIP leaves the rubyzip compat layer: `Buffer.create`
+  writes through the native Writer (which gains a per-entry
+  compression-method override so `:store` entries work beside
+  deflated ones), and `Buffer.open`/`MemoryExtractor` read through
+  the native Reader via a temporary-file spill.
+  `MemoryArchive::Entry#read` now has true IO streaming semantics —
+  successive chunks and nil at EOF (an always-returning read looped
+  forever in `Pipe::StreamDecompressor`).
+- The parallel subsystem is revived: Engine drives our own
+  WorkerPool instead of a phantom `Fractor::WorkerPool`,
+  ParallelExtractor reads through the native ZIP reader and runs on
+  a bounded ThreadPool — Ractor workers cannot trigger Omnizip's
+  autoloads or cross into Proc-holding codec constants on
+  Ruby <= 3.3 — JobScheduler's implemented round_robin/bin_packing
+  strategies are reachable, directory entries extract idempotently,
+  and the subsystem gains specs.
+
+### Fixed
+- par2_compatibility_spec was missing `require "tmpdir"` and failed
+  9 of 15 examples whenever no earlier spec happened to load tmpdir
+  first.
+
 ## [0.3.53] - 2026-09-01
 
 ### Changed

data/lib/omnizip/algorithms/lzma/dictionary.rb

@@ -31,7 +31,7 @@ module Omnizip
 
         # Read bytes from dictionary at a distance back
         def read_bytes(distance, length)
-          raise "Invalid distance: #{distance}" if distance > @buffer.bytesize
+          raise Omnizip::DecompressionError, "Invalid distance: #{distance}" if distance > @buffer.bytesize
 
           result = String.new(encoding: Encoding::BINARY)
           src_pos = @buffer.bytesize - distance
@@ -46,7 +46,7 @@ module Omnizip
 
         # Get byte at distance back
         def get_byte(distance)
-          raise "Invalid distance: #{distance}" if distance > @buffer.bytesize
+          raise Omnizip::DecompressionError, "Invalid distance: #{distance}" if distance > @buffer.bytesize
 
           @buffer.getbyte(@buffer.bytesize - distance)
         end

data/lib/omnizip/algorithms/lzma/lzma_alone_decoder.rb

@@ -118,12 +118,12 @@ module Omnizip
           # Step 1: Parse properties byte (SEQ_PROPERTIES)
           # Reference: alone_decoder.c:64-68
           props = @input.getbyte
-          raise "Invalid .lzma header: missing properties byte" if props.nil?
+          raise Omnizip::DecompressionError, "Invalid .lzma header: missing properties byte" if props.nil?
 
           # Use XZ Utils property byte parsing
           # Reference: /Users/mulgogi/src/external/xz/src/liblzma/lzma/lzma_decoder.c:1216-1228
           if props > MAX_PROPERTY_BYTE
-            raise "Invalid .lzma header: properties byte #{props} exceeds maximum #{MAX_PROPERTY_BYTE}"
+            raise Omnizip::DecompressionError, "Invalid .lzma header: properties byte #{props} exceeds maximum #{MAX_PROPERTY_BYTE}"
           end
 
           # Parse lc, lp, pb from properties byte
@@ -136,7 +136,7 @@ module Omnizip
           # Validate lc + lp <= 4 (LZMA_LCLP_MAX)
           # Reference: lzma_decoder.c:1227
           if @lc + @lp > 4
-            raise "Invalid .lzma header: lc (#{@lc}) + lp (#{@lp}) exceeds maximum 4"
+            raise Omnizip::DecompressionError, "Invalid .lzma header: lc (#{@lc}) + lp (#{@lp}) exceeds maximum 4"
           end
 
           # Step 2: Parse dictionary size (SEQ_DICTIONARY_SIZE)
@@ -144,7 +144,7 @@ module Omnizip
           @dict_size = 0
           4.times do |i|
             byte = @input.getbyte
-            raise "Incomplete .lzma header: missing dictionary size byte" if byte.nil?
+            raise Omnizip::DecompressionError, "Incomplete .lzma header: missing dictionary size byte" if byte.nil?
 
             @dict_size |= (byte << (i * 8))
           end
@@ -163,7 +163,7 @@ module Omnizip
             d += 1
 
             if d != @dict_size
-              raise "Invalid .lzma header: dictionary size #{@dict_size} is not 2^n or 2^n + 2^(n-1)"
+              raise Omnizip::DecompressionError, "Invalid .lzma header: dictionary size #{@dict_size} is not 2^n or 2^n + 2^(n-1)"
             end
           end
 
@@ -172,7 +172,7 @@ module Omnizip
           @uncompressed_size = 0
           8.times do |i|
             byte = @input.getbyte
-            raise "Incomplete .lzma header: missing uncompressed size byte" if byte.nil?
+            raise Omnizip::DecompressionError, "Incomplete .lzma header: missing uncompressed size byte" if byte.nil?
 
             @uncompressed_size |= (byte << (i * 8))
           end
@@ -182,7 +182,7 @@ module Omnizip
           # Reference: alone_decoder.c:116-120
           if @picky && @uncompressed_size != 0xFFFFFFFFFFFFFFFF &&
               @uncompressed_size >= MAX_UNCOMPRESSED_SIZE
-            raise "Invalid .lzma header: uncompressed size #{@uncompressed_size} exceeds maximum #{MAX_UNCOMPRESSED_SIZE}"
+            raise Omnizip::DecompressionError, "Invalid .lzma header: uncompressed size #{@uncompressed_size} exceeds maximum #{MAX_UNCOMPRESSED_SIZE}"
           end
 
           # Note: XZ Utils uses UINT64_MAX (0xFFFFFFFFFFFFFFFF) for unknown size

data/lib/omnizip/algorithms/lzma/xz_buffered_range_encoder.rb

@@ -97,7 +97,7 @@ module Omnizip
         # @param prob [BitModel] Probability model
         # @param bit [Integer] Bit value (0 or 1)
         def queue_bit(prob, bit)
-          raise "Symbol buffer overflow" if @count >= RC_SYMBOLS_MAX
+          raise Omnizip::CompressionError, "Symbol buffer overflow" if @count >= RC_SYMBOLS_MAX
 
           @symbols[@count] = bit.zero? ? RC_BIT_0 : RC_BIT_1
           @probs[@count] = prob
@@ -111,7 +111,7 @@ module Omnizip
         def queue_direct_bits(value, num_bits)
           num_bits.downto(1) do |i|
             bit = (value >> (i - 1)) & 1
-            raise "Symbol buffer overflow" if @count >= RC_SYMBOLS_MAX
+            raise Omnizip::CompressionError, "Symbol buffer overflow" if @count >= RC_SYMBOLS_MAX
 
             @symbols[@count] = bit.zero? ? RC_DIRECT_0 : RC_DIRECT_1
             @probs[@count] = nil
@@ -122,7 +122,7 @@ module Omnizip
         # Queue flush operation
         def queue_flush
           5.times do
-            raise "Symbol buffer overflow" if @count >= RC_SYMBOLS_MAX
+            raise Omnizip::CompressionError, "Symbol buffer overflow" if @count >= RC_SYMBOLS_MAX
 
             @symbols[@count] = RC_FLUSH
             @probs[@count] = nil
@@ -237,7 +237,7 @@ module Omnizip
 
         # Forget queued symbols (e.g., when output limit reached)
         def forget
-          raise "Cannot forget with partial encoding" unless @pos.zero?
+          raise Omnizip::CompressionError, "Cannot forget with partial encoding" unless @pos.zero?
 
           @count = 0
         end

data/lib/omnizip/algorithms/lzma/xz_range_encoder_exact.rb

@@ -63,7 +63,7 @@ module Omnizip
 
         # Forget pending symbols (matches XZ Utils rc_forget)
         def forget
-          raise "Cannot forget while encoding" if @pos != 0
+          raise Omnizip::CompressionError, "Cannot forget while encoding" if @pos != 0
 
           @count = 0
         end
@@ -73,7 +73,7 @@ module Omnizip
         # @param prob [Probability] Probability model
         # @param bit [Integer] Bit value (0 or 1)
         def bit(prob, bit)
-          raise "Symbol buffer overflow" if @count >= RC_SYMBOLS_MAX
+          raise Omnizip::CompressionError, "Symbol buffer overflow" if @count >= RC_SYMBOLS_MAX
 
           @symbols[@count] = bit
           @probs[@count] = prob
@@ -118,7 +118,7 @@ module Omnizip
         # @param bit_count [Integer] Number of bits
         def direct(value, bit_count)
           bit_count.times do
-            raise "Symbol buffer overflow" if @count >= RC_SYMBOLS_MAX
+            raise Omnizip::CompressionError, "Symbol buffer overflow" if @count >= RC_SYMBOLS_MAX
 
             @symbols[@count] = RC_DIRECT_0 | ((value >> (bit_count -= 1)) & 1)
             @probs[@count] = nil
@@ -129,7 +129,7 @@ module Omnizip
         # Queue flush operation (matches XZ Utils rc_flush)
         def flush
           5.times do
-            raise "Symbol buffer overflow" if @count >= RC_SYMBOLS_MAX
+            raise Omnizip::CompressionError, "Symbol buffer overflow" if @count >= RC_SYMBOLS_MAX
 
             @symbols[@count] = RC_FLUSH
             @probs[@count] = nil
@@ -159,7 +159,7 @@ module Omnizip
         # @param out_size [Integer] Output buffer size
         # @return [Boolean] True if output buffer filled before encoding complete
         def encode(out, out_pos, out_size)
-          raise "Symbol buffer overflow" if @count > RC_SYMBOLS_MAX
+          raise Omnizip::CompressionError, "Symbol buffer overflow" if @count > RC_SYMBOLS_MAX
 
           skip_increment = false
 
@@ -214,7 +214,7 @@ module Omnizip
               break
 
             else
-              raise "Unknown symbol type: #{@symbols[@pos]}"
+              raise Omnizip::CompressionError, "Unknown symbol type: #{@symbols[@pos]}"
             end
 
             @pos += 1 unless skip_increment
@@ -288,7 +288,7 @@ module Omnizip
 
         # Forget pending symbols (matches XZ Utils rc_forget)
         def forget
-          raise "Cannot forget while encoding" if @pos != 0
+          raise Omnizip::CompressionError, "Cannot forget while encoding" if @pos != 0
 
           @count = 0
         end

data/lib/omnizip/algorithms/lzma/xz_utils_decoder.rb

@@ -318,7 +318,7 @@ check_rc_finished: true)
 
           # Handle nil @pos or limit gracefully
           if limit && (@pos.nil? || limit.nil?)
-            raise "Invalid state: @pos=#{@pos.inspect}, limit=#{limit.inspect}"
+            raise Omnizip::DecompressionError, "Invalid state: @pos=#{@pos.inspect}, limit=#{limit.inspect}"
           end
 
           # Circular buffer: flush output before it can be overwritten.
@@ -757,7 +757,7 @@ check_rc_finished: true)
       def read_header
         # Property byte
         props = @input.getbyte
-        raise "Invalid LZMA header" if props.nil?
+        raise Omnizip::DecompressionError, "Invalid LZMA header" if props.nil?
 
         @lc = props % 9
         remainder = props / 9
@@ -768,7 +768,7 @@ check_rc_finished: true)
         @dict_size = 0
         4.times do |i|
           byte = @input.getbyte
-          raise "Incomplete header" if byte.nil?
+          raise Omnizip::DecompressionError, "Incomplete header" if byte.nil?
 
           @dict_size |= (byte << (i * 8))
         end
@@ -780,7 +780,7 @@ check_rc_finished: true)
         @uncompressed_size = 0
         8.times do |i|
           byte = @input.getbyte
-          raise "Incomplete header" if byte.nil?
+          raise Omnizip::DecompressionError, "Incomplete header" if byte.nil?
 
           @uncompressed_size |= (byte << (i * 8))
         end
@@ -791,9 +791,9 @@ check_rc_finished: true)
       # @return [void]
       # @raise [RuntimeError] If parameters are invalid
       def validate_parameters
-        raise "Invalid lc (#{@lc})" unless @lc.between?(0, 8)
-        raise "Invalid lp (#{@lp})" unless @lp.between?(0, 4)
-        raise "Invalid pb (#{@pb})" unless @pb.between?(0, 4)
+        raise Omnizip::DecompressionError, "Invalid lc (#{@lc})" unless @lc.between?(0, 8)
+        raise Omnizip::DecompressionError, "Invalid lp (#{@lp})" unless @lp.between?(0, 4)
+        raise Omnizip::DecompressionError, "Invalid pb (#{@pb})" unless @pb.between?(0, 4)
       end
 
       # Initialize probability models
@@ -1201,7 +1201,7 @@ check_rc_finished: true)
         # @dict_full is clamped at @dict_size. Use actual bytes written for validation.
         actual_bytes_written = @pos - LZ_DICT_INIT_POS
         unless actual_bytes_written > distance
-          raise "Invalid rep distance: #{distance} (bytes_written: #{actual_bytes_written})"
+          raise Omnizip::DecompressionError, "Invalid rep distance: #{distance} (bytes_written: #{actual_bytes_written})"
         end
 
         # IMPORTANT: Limit match length to not exceed uncompressed_size

data/lib/omnizip/commands/metadata_command.rb

@@ -84,16 +84,24 @@ module Omnizip
         end
       end
 
+      # The display is driven by the registry's field contract for
+      # :seven_zip — optional lines print only for registered fields.
       def show_seven_zip_entry(entry)
-        puts "Entry: #{entry[:name]}"
-        puts "  Type: #{entry[:directory] ? 'Directory' : 'File'}"
-        puts "  Size: #{format_size(entry[:size])}"
+        registry = Omnizip::Metadata::MetadataRegistry
+        puts "Entry: #{entry[:name]}" if registry.supports?(:seven_zip, :name)
+        puts "  Type: #{entry[:directory] ? 'Directory' : 'File'}" if registry.supports?(:seven_zip, :directory)
+        puts "  Size: #{format_size(entry[:size])}" if registry.supports?(:seven_zip, :size)
         # Per-entry packed sizes are not tracked by the parser
-        if entry[:compressed_size]&.positive?
+        if registry.supports?(:seven_zip, :compressed_size) &&
+            entry[:compressed_size]&.positive?
           puts "  Compressed: #{format_size(entry[:compressed_size])}"
         end
-        puts "  Modified: #{entry[:mtime]}" if entry[:mtime]
-        puts "  CRC32: 0x#{entry[:crc].to_s(16).upcase}" if entry[:crc]
+        if registry.supports?(:seven_zip, :mtime) && entry[:mtime]
+          puts "  Modified: #{entry[:mtime]}"
+        end
+        if registry.supports?(:seven_zip, :crc) && entry[:crc]
+          puts "  CRC32: 0x#{entry[:crc].to_s(16).upcase}"
+        end
       end
 
       def show_metadata(archive, pattern)

data/lib/omnizip/implementations/seven_zip/lzma/decoder.rb

@@ -136,19 +136,19 @@ module Omnizip
           # Parse LZMA header
           def parse_header
             props = @input.getbyte
-            raise "Invalid LZMA header: missing properties" unless props
+            raise Omnizip::DecompressionError, "Invalid LZMA header: missing properties" unless props
 
             @lc = props % 9
             rem = props / 9
             @lp = rem % 5
             @pb = rem / 5
 
-            raise "Invalid LZMA properties: pb=#{@pb} > 4" if @pb > 4
+            raise Omnizip::DecompressionError, "Invalid LZMA properties: pb=#{@pb} > 4" if @pb > 4
 
             @dict_size = 0
             4.times do |i|
               byte = @input.getbyte
-              raise "Invalid LZMA header: missing dictionary size" unless byte
+              raise Omnizip::DecompressionError, "Invalid LZMA header: missing dictionary size" unless byte
 
               @dict_size |= (byte << (i * 8))
             end
@@ -159,7 +159,7 @@ module Omnizip
             @uncompressed_size = 0
             8.times do |i|
               byte = @input.getbyte
-              raise "Invalid LZMA header: missing uncompressed size" unless byte
+              raise Omnizip::DecompressionError, "Invalid LZMA header: missing uncompressed size" unless byte
 
               @uncompressed_size |= (byte * (1 << (i * 8)))
             end
@@ -328,7 +328,7 @@ module Omnizip
               # Decoder returns distance before +1, so add 1 to get actual distance
               distance += 1
 
-              raise "Invalid distance: #{distance}" if distance >= @dict_size && @dict_full
+              raise Omnizip::DecompressionError, "Invalid distance: #{distance}" if distance >= @dict_size && @dict_full
 
               # Update reps
               @reps[3] = @reps[2]

data/lib/omnizip/implementations/seven_zip/lzma/encoder.rb

@@ -309,7 +309,7 @@ module Omnizip
           # @return [void]
           def encode_match(match, data)
             # Defensive check: distance must be >= 1
-            raise "Invalid match distance: #{match.distance}" if match.distance < 1
+            raise Omnizip::CompressionError, "Invalid match distance: #{match.distance}" if match.distance < 1
 
             pos_state = @pos & ((1 << @pb) - 1)
 

data/lib/omnizip/implementations/seven_zip/lzma/range_decoder.rb

@@ -158,7 +158,7 @@ module Omnizip
           def init_decoder
             # Read first byte (should be 0 for valid LZMA stream)
             first = read_byte
-            raise "Invalid LZMA stream: first byte not 0" unless first.zero?
+            raise Omnizip::DecompressionError, "Invalid LZMA stream: first byte not 0" unless first.zero?
 
             # Read 4 bytes for initial code value
             @code = 0

data/lib/omnizip/implementations/seven_zip/lzma/state_machine.rb

@@ -108,7 +108,7 @@ module Omnizip
             when 9
               CATEGORY_SHORT_REP
             else
-              raise "Invalid state: #{@index}"
+              raise Omnizip::CompressionError, "Invalid state: #{@index}"
             end
           end
 

data/lib/omnizip/metadata/metadata_registry.rb

@@ -55,10 +55,17 @@ module Omnizip
                                 extra_field
                               ])
 
-    # Register 7z format metadata support (limited)
+    # Register 7z format metadata support: the readable fields the
+    # handler detail contract carries (name/size/directory always
+    # present; compressed_size when tracked, mtime/crc when stored).
+    # Editing is ZIP-only — the metadata command raises truthfully.
     MetadataRegistry.register(:seven_zip, %i[
+                                name
+                                size
+                                directory
+                                compressed_size
                                 mtime
-                                attributes
+                                crc
                               ])
   end
 end

data/lib/omnizip/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: omnizip
 version: !ruby/object:Gem::Version
-  version: 0.3.54
+  version: 0.3.55
 platform: ruby
 authors:
 - Ribose Inc.