omnizip 0.3.57 → 0.3.58

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1ea5d1a7c799ac0f1b17c60e1c715fc0bf95a2d8dc3d3a02e0776bac6efbccf0
-  data.tar.gz: 198583bbdc571acdd26a8a1e25f4a6ce0e5aa6b33d613c247bf49556d164200c
+  metadata.gz: 04bb0d1c81ef7f4571014bb6679ad0d4750d4c078729daea82c88f643e246818
+  data.tar.gz: 7523e6a77a43db5eb02ec7c16ef4adf0751150129f329af82eb11297f93a68f6
 SHA512:
-  metadata.gz: edaf17357204a214beecdd32e18bd53139bb6a7b9797b29a181a44db80b531e847f6d3e48da97f6ce5f02e80feeb456c71e593df92b471b4d5875a8d13ae1e98
-  data.tar.gz: 6f82822274ad086eef57304f2386a43f979525dd6893f0eabf693b6c8c60a08a71729beb5c2a3328c8617871bbbc4b9d33a2b6801ae801eeb3614a8f4cbd6d4e
+  metadata.gz: da1c027f6e44246e6421760d3197501db38957aeb1541c0db6e3553ab73b5e03a221a362b0165d4196bf1185f0022b341529321cdce9c2a339c3cf2f31b4f733
+  data.tar.gz: 7732ed6d8268d006195f7648980e2f8619ea89d45767932afd587f508592f627697a9cc436f6f3e1a01b41a8a579034f654c1bc33cc3331fced28af5bd68b8ff

data/CHANGELOG.md

@@ -7,6 +7,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.57] - 2026-09-02
+
+### Fixed
+- TAR archives no longer corrupt silently on long paths: the writer
+  now splits entry names over 99 bytes across the ustar prefix +
+  name fields at a "/" boundary, the reader joins them back for
+  consumers, and paths no ustar fields can represent raise
+  `FormatError` instead of truncating. Verified against system tar.
+- `:auto` profile sampling walked directories in the OS's
+  iteration order, resolving different files (and compression
+  settings) per platform; the walk is sorted and deterministic now.
+- The getting-started docs' 7z examples used a Reader API that
+  never shipped (`each_file`, `close`, `Reader.info`) — every
+  snippet raised NoMethodError verbatim. Rewritten against the real
+  surface and executed to verify.
+
+### Changed
+- The last 28 bare `raise "string"` sites (RAR tree, cpio entries,
+  parity internals, zip compat streams, two commands) gained their
+  matching error classes — `lib/` now contains zero bare raises.
+- The dead `--preserve-ntfs-streams` CLI flag is removed; nothing
+  read it and no code path implements NTFS stream preservation.
+
 ## [0.3.56] - 2026-09-02
 
 ### Fixed

data/docs/guides/creating-archives.adoc

@@ -76,7 +76,7 @@ writer.write
 
 IMPORTANT: RAR5 CRC32 checksums only work with STORE compression. When LZMA is used, CRC32 is automatically disabled. Use BLAKE2sp (always present) for compressed file integrity.
 
-=== RAR5 Multi-Volume Archives (v0.5.0)
+=== RAR5 Multi-Volume Archives
 
 Split large archives across multiple volumes:
 
@@ -110,36 +110,30 @@ volumes = writer.write
 # Minimum volume size: 64 KB
 ----
 
-=== RAR5 Solid Compression (v0.5.0)
+=== RAR5 Solid Archives
 
-Achieve 10-30% better compression ratios for similar files:
+`solid: true` requests a shared solid block, but the RAR-compatible
+LZSS encoder is not implemented yet — the writer warns and writes
+independent STORE entries instead, so the archive stays extractable
+by official unrar:
 
 [source,ruby]
 ----
 require 'omnizip/formats/rar/rar5/writer'
 
-# Enable solid compression
 writer = Omnizip::Formats::Rar::Rar5::Writer.new('project.rar',
-  compression: :lzma,
-  level: 5,
-  solid: true  # Shared dictionary across files
+  solid: true  # warns: falls back to independent STORE entries
 )
 writer.add_directory('source_code/')
 writer.write
+----
 
-# Best for:
-# - Source code repositories
-# - Log files
-# - Text documents
-# - Similar structured data
-
-# Trade-offs:
-# - Cannot extract individual files without decompressing entire block
-# - Corruption may affect multiple files
-# - Slightly longer extraction time for single files
+Solid compression (shared dictionary across files, better ratios
+for similar content) arrives when the RAR-compatible LZSS encoder
+lands.
 ----
 
-=== RAR5 AES-256 Encryption (v0.5.0)
+=== RAR5 AES-256 Encryption
 
 Password-protect archives with industry-standard encryption:
 
@@ -177,7 +171,7 @@ writer.write
 # - Password verification before decryption
 ----
 
-=== RAR5 PAR2 Recovery Records (v0.5.0)
+=== RAR5 PAR2 Recovery Records
 
 Add error correction for archive recovery:
 
@@ -216,7 +210,7 @@ files = writer.write
 # - Works with multi-volume, solid, and encrypted archives
 ----
 
-=== RAR5 Combined Features (v0.5.0)
+=== RAR5 Combined Features
 
 Use all features together for comprehensive protection:
 
@@ -262,13 +256,13 @@ puts "  Total size: #{files.sum { |f| File.size(f) } / 1024 / 1024}MB"
 
 === RAR5 Best Practices
 
-**For Maximum Compression:**
+**For Maximum Compatibility:**
 [source,ruby]
 ----
 writer = Omnizip::Formats::Rar::Rar5::Writer.new('archive.rar',
   compression: :lzma,
-  level: 5,        # Best compression
-  solid: true,     # 10-30% better ratios
+  level: 5,        # Honored by the 7z-style writers; RAR5 entries
+                   # are STORE until the LZSS encoder lands
   include_mtime: true
 )
 ----

data/lib/omnizip/commands/decompress_command.rb

@@ -80,7 +80,10 @@ module Omnizip
         end
       end
 
-      ARCHIVE_EXTENSIONS = %w[.zip .7z .tar .rar .cpio .iso .rpm .xar .msi].freeze
+      # Archive-vs-stream routing derives from the registry's
+      # extension routes so new formats route here automatically
+      ARCHIVE_EXTENSIONS = (Convenience::ARCHIVE_FORMAT_EXTENSIONS.keys +
+                            Convenience::READ_ARCHIVE_FORMAT_EXTENSIONS.keys).freeze
 
       private
 

data/lib/omnizip/formats/rar/rar5/writer.rb

@@ -199,6 +199,11 @@ module Omnizip
               if @options[:solid] && Compression::Lzss.available?
                 write_solid_block(f, @files)
               else
+                if @options[:solid]
+                  warn "omnizip: solid: true requested but the " \
+                       "RAR-compatible LZSS encoder is not available " \
+                       "— writing independent STORE entries instead"
+                end
                 @files.each do |file|
                   write_file_entry(f, file)
                 end

data/lib/omnizip/formats/zip/writer.rb

@@ -152,6 +152,8 @@ module Omnizip
         end
 
         def write_precompressed_to_io(io, compression_method: COMPRESSION_DEFLATE)
+          check_classic_entry_count!
+          entries.each { |entry| check_classic_size_limit!(entry) }
           local_header_offsets = []
 
           entries.each do |entry|
@@ -189,6 +191,7 @@ module Omnizip
 
         # Write to an IO object
         def write_to_io(io, compression_method: COMPRESSION_DEFLATE, level: 6)
+          check_classic_entry_count!
           local_header_offsets = []
 
           # Write local file headers and data. An entry-level
@@ -220,6 +223,8 @@ module Omnizip
               entry[:crc32] = calculate_crc32(entry[:uncompressed_data])
             end
 
+            check_classic_size_limit!(entry)
+
             # Update local header with compressed sizes
             local_header.compressed_size = entry[:compressed_size]
             local_header.uncompressed_size = entry[:uncompressed_size]
@@ -234,6 +239,7 @@ module Omnizip
 
           # Record start of central directory
           central_directory_offset = io.pos
+          check_classic_offset_limit!(central_directory_offset)
 
           # Write central directory headers
           entries.each_with_index do |entry, index|
@@ -257,8 +263,42 @@ module Omnizip
           io.write(eocd.to_binary)
         end
 
+        # Classic (non-ZIP64) ZIP headers pack sizes and offsets as
+        # 32-bit values and entry counts as 16-bit; exceeding them
+        # raises instead of letting Array#pack fail with a bare
+        # RangeError. ZIP64 writing is not supported.
+        MAX_CLASSIC_SIZE = 0xFFFFFFFF
+        MAX_CLASSIC_ENTRIES = 0xFFFF
+        private_constant :MAX_CLASSIC_SIZE, :MAX_CLASSIC_ENTRIES
+
         private
 
+        def check_classic_entry_count!
+          return if entries.size <= MAX_CLASSIC_ENTRIES
+
+          raise Omnizip::UnsupportedFormatError,
+                "#{entries.size} entries exceed the classic ZIP " \
+                "limit of #{MAX_CLASSIC_ENTRIES} (ZIP64 writing is " \
+                "not supported)"
+        end
+
+        def check_classic_size_limit!(entry)
+          return if entry[:compressed_size].to_i <= MAX_CLASSIC_SIZE &&
+            entry[:uncompressed_size].to_i <= MAX_CLASSIC_SIZE
+
+          raise Omnizip::UnsupportedFormatError,
+                "entry #{entry[:filename].inspect} exceeds the 4 GiB " \
+                "classic ZIP size limit (ZIP64 writing is not supported)"
+        end
+
+        def check_classic_offset_limit!(offset)
+          return if offset <= MAX_CLASSIC_SIZE
+
+          raise Omnizip::UnsupportedFormatError,
+                "archive layout exceeds the 4 GiB classic ZIP " \
+                "offset limit (ZIP64 writing is not supported)"
+        end
+
         # Create an entry hash
         def create_entry(
           filename:,

data/lib/omnizip/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: omnizip
 version: !ruby/object:Gem::Version
-  version: 0.3.57
+  version: 0.3.58
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-02 00:00:00.000000000 Z
+date: 2026-09-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64