omnizip 0.3.13 → 0.3.14

data/lib/omnizip/formats/rar.rb

@@ -161,13 +161,7 @@ module Omnizip
         def repair(archive_path, output_path)
           ArchiveRepairer.new.repair(archive_path, output_path)
         end
-
-        # Auto-register .rar format
-        def register!
-          FormatRegistry.register(".rar", "Omnizip::Formats::Rar::Reader")
-        end
       end
     end
   end
 end
-

data/lib/omnizip/formats/rar3/reader.rb

@@ -361,10 +361,17 @@ module Omnizip
 
       # RAR archive entry model
       class Entry
+        include Omnizip::Entry
+
         attr_accessor :name, :compressed_size, :uncompressed_size, :crc32,
                       :compression_method, :modified_time, :attributes,
                       :encrypted, :data_offset, :host_os, :salt
 
+        def entry_name = name
+        def entry_directory? = false
+        def entry_size = uncompressed_size
+        def entry_mtime = modified_time
+
         def initialize(name: nil, compressed_size: nil, uncompressed_size: nil,
                        crc32: nil, compression_method: nil, modified_time: nil,
                        attributes: nil, encrypted: nil, data_offset: nil,

data/lib/omnizip/formats/rar5/reader.rb

@@ -316,10 +316,17 @@ module Omnizip
 
       # RAR v5 archive entry model
       class Entry
+        include Omnizip::Entry
+
         attr_accessor :name, :compressed_size, :uncompressed_size, :crc32,
                       :compression_method, :modified_time, :attributes,
                       :encrypted, :data_offset, :host_os, :is_directory
 
+        def entry_name = name
+        def entry_directory? = is_directory
+        def entry_size = uncompressed_size
+        def entry_mtime = modified_time
+
         def initialize(name: nil, compressed_size: nil, uncompressed_size: nil,
                        crc32: nil, compression_method: nil, modified_time: nil,
                        attributes: nil, encrypted: nil, data_offset: nil,

data/lib/omnizip/formats/rpm/entry.rb

@@ -8,8 +8,14 @@ module Omnizip
       # Represents a single file within an RPM package.
       # File information is assembled from multiple header tags.
       class Entry
+        include Omnizip::Entry
         include Omnizip::Formats::Rpm::Constants
 
+        def entry_name = path
+        def entry_directory? = mode && ::File.directory?(mode)
+        def entry_size = size
+        def entry_mtime = mtime
+
         # @return [String] File path
         attr_accessor :path
 

data/lib/omnizip/formats/seven_zip/models/file_entry.rb

@@ -7,11 +7,18 @@ module Omnizip
         # Represents a file entry in .7z archive
         # Contains file metadata, attributes, and extraction information
         class FileEntry
+          include Omnizip::Entry
+
           attr_accessor :name, :size, :compressed_size, :crc, :is_dir,
                         :is_empty, :is_anti, :has_stream, :mtime, :atime,
                         :ctime, :attributes, :folder_index, :file_index,
                         :source_path, :inline_data, :compression_options
 
+          def entry_name = name
+          def entry_directory? = is_dir
+          def entry_size = size
+          def entry_mtime = mtime
+
           # Initialize file entry
           def initialize
             @name = nil

data/lib/omnizip/formats/seven_zip.rb

@@ -174,12 +174,6 @@ module Omnizip
       rescue StandardError
         false
       end
-
-      # Auto-register .7z format when loaded
-      def self.register!
-        FormatRegistry.register(".7z", "Omnizip::Formats::SevenZip::Reader")
-      end
     end
   end
 end
-

data/lib/omnizip/formats/tar/entry.rb

@@ -7,12 +7,18 @@ module Omnizip
       #
       # Represents a single entry (file, directory, link) in a TAR archive
       class Entry
+        include Omnizip::Entry
         include Omnizip::Formats::Tar::Constants
 
         attr_accessor :name, :mode, :uid, :gid, :size, :mtime, :typeflag,
                       :linkname, :uname, :gname, :devmajor, :devminor, :prefix
         attr_reader :data
 
+        def entry_name = name
+        def entry_directory? = directory?
+        def entry_size = size
+        def entry_mtime = mtime
+
         # Initialize a new TAR entry
         #
         # @param name [String] Entry name/path

data/lib/omnizip/formats/tar.rb

@@ -70,13 +70,7 @@ module Omnizip
           reader = read(file_path)
           reader.list_entries
         end
-
-        # Register TAR format when loaded
-        def register!
-          FormatRegistry.register(".tar", Omnizip::Formats::Tar)
-        end
       end
     end
   end
 end
-

data/lib/omnizip/formats/xar/entry.rb

@@ -8,8 +8,14 @@ module Omnizip
       # Represents a single file/directory/link in a XAR archive.
       # Each entry has metadata and optional data.
       class Entry
+        include Omnizip::Entry
         include Omnizip::Formats::Xar::Constants
 
+        def entry_name = name
+        def entry_directory? = type == :directory
+        def entry_size = size
+        def entry_mtime = mtime
+
         attr_accessor :id, :name, :type, :mode, :uid, :gid, :user, :group,
                       :size, :ctime, :mtime, :atime,
                       :data_offset, :data_length, :data_size, :data_encoding,

data/lib/omnizip/formats/xar.rb

@@ -139,13 +139,7 @@ module Omnizip
         def info(path)
           open(path, &:info) # rubocop:disable Security/Open
         end
-
-        # Auto-register XAR format when loaded
-        def register!
-          FormatRegistry.register(".xar", Reader)
-        end
       end
     end
   end
 end
-

data/lib/omnizip/formats/zip.rb

@@ -44,13 +44,7 @@ module Omnizip
           reader = read(file_path)
           reader.list_entries
         end
-
-        # Auto-register .zip format when loaded
-        def register!
-          FormatRegistry.register(".zip", Omnizip::Formats::Zip)
-        end
       end
     end
   end
 end
-

data/lib/omnizip/implementations.rb

@@ -1,11 +1,25 @@
 # frozen_string_literal: true
 
 module Omnizip
+  # Bit-level SDK ports: state machines, range coders, match finders,
+  # raw LZMA/LZMA2 encoders and decoders.
+  #
+  # This namespace owns the *primitives*; +Omnizip::Algorithms+ owns
+  # the *streaming contract*. The boundary is: +Algorithms+ calls
+  # +Implementations+, never the reverse. Files under this tree
+  # should never reach across into format-specific concerns (no
+  # .7z header parsing, no ZIP central directory, no tar entry
+  # metadata).
+  #
+  # The two top-level sub-namespaces mirror the upstream SDK split:
+  # - +SevenZip+ : ports of 7-Zip's LZMA/LZMA2 encoder + decoder
+  # - +XZUtils+ : ports of XZ Utils' LZMA/LZMA2 encoder + decoder
+  #
+  # Despite the LZMA name, the two SDKs diverge in subtle ways (no
+  # EOS marker, different chunk padding, different property-byte
+  # handling); keeping them in separate trees makes those
+  # divergences visible rather than hidden in flag parameters.
   module Implementations
-    # Implementation namespace for various algorithm ports
-    # This module contains reference implementations ported from external projects
-
-    # Base classes for implementation inheritance
     autoload :Base, "omnizip/implementations/base"
   end
 end

data/lib/omnizip/metadata/entry_metadata.rb

@@ -5,8 +5,15 @@ module Omnizip
     # Model for file entry metadata
     # Wraps CentralDirectoryHeader with a cleaner metadata API
     class EntryMetadata
+      include Omnizip::Entry
+
       attr_reader :entry
 
+      def entry_name = entry.name
+      def entry_directory? = entry.directory?
+      def entry_size = entry.size
+      def entry_mtime = entry.time
+
       # Initialize metadata for an entry
       # @param entry [Omnizip::Zip::Entry] The entry to manage metadata for
       def initialize(entry)

data/lib/omnizip/parallel/engine.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require "fractor"
+
+module Omnizip
+  module Parallel
+    # Engine owns the Fractor worker-pool dance: build the pool, submit
+    # a batch of work, run it to completion, return successful and
+    # failed results. Callers (ParallelCompressor, ParallelExtractor,
+    # future operations) supply the worker class and the work items;
+    # Engine handles the threading.
+    #
+    # This is the deep module behind the parallel API: the threading
+    # shape is identical across every consumer, so it lives here once.
+    # Domain-specific concerns (which file to read, which archive to
+    # open, what stats to track) stay with the caller.
+    class Engine
+      # @param worker_class [Class] a +Fractor::Worker+ subclass whose
+      #   +#process(work)+ turns one work item into a result.
+      # @param threads [Integer] worker count.
+      def initialize(worker_class:, threads:)
+        @worker_class = worker_class
+        @threads = threads
+      end
+
+      # Run +work_items+ through the pool and yield each successful
+      # +Fractor::WorkResult+ to the caller-supplied block.
+      #
+      # @param work_items [Array<Fractor::Work>] batch to submit.
+      # @yieldparam result [Fractor::WorkResult] a successful result.
+      # @return [Array<Fractor::WorkResult>] the failed results, for
+      #   the caller to decide how to surface.
+      def run(work_items)
+        pool = Fractor::WorkerPool.new(
+          worker_class: @worker_class,
+          num_workers: @threads,
+          continuous: false,
+        )
+        pool.start
+        pool.submit_batch(work_items)
+        pool.run
+
+        pool.successful_results.each { |r| yield r if block_given? }
+        pool.failed_results
+      end
+    end
+  end
+end

data/lib/omnizip/parallel/parallel_compressor.rb

@@ -212,20 +212,11 @@ level: 6)
           )
         end
 
-        # Create worker pool
-        pool = WorkerPool.new(
-          worker_class: CompressionWorker,
-          num_workers: @options.threads,
-          continuous: false,
-        )
-
-        pool.start
-        pool.submit_batch(work_items)
-        pool.run
-
-        # Collect results
-        results = pool.successful_results
-        errors = pool.failed_results
+        # Run the worker pool through the shared engine.
+        engine = Engine.new(worker_class: CompressionWorker,
+                            threads: @options.threads)
+        results = []
+        errors = engine.run(work_items) { |r| results << r }
 
         # Handle errors
         unless errors.empty?
@@ -238,8 +229,6 @@ level: 6)
         # Write archive sequentially (thread-safe)
         write_archive(output, results, compression: compression)
 
-        pool.shutdown
-
         @stats[:end_time] = Time.now
         @stats[:files_processed] = results.size
 

data/lib/omnizip/parallel/parallel_extractor.rb

@@ -201,20 +201,11 @@ module Omnizip
           )
         end
 
-        # Create worker pool
-        pool = WorkerPool.new(
-          worker_class: ExtractionWorker,
-          num_workers: @options.threads,
-          continuous: false,
-        )
-
-        pool.start
-        pool.submit_batch(work_items)
-        pool.run
-
-        # Collect results
-        results = pool.successful_results
-        errors = pool.failed_results
+        # Run the worker pool through the shared engine.
+        engine = Engine.new(worker_class: ExtractionWorker,
+                            threads: @options.threads)
+        results = []
+        errors = engine.run(work_items) { |r| results << r }
 
         # Handle errors
         unless errors.empty?
@@ -227,8 +218,6 @@ module Omnizip
         # Write files to disk (thread-safe)
         extracted_paths = write_extracted_files(results, overwrite: overwrite)
 
-        pool.shutdown
-
         @stats[:end_time] = Time.now
         @stats[:files_extracted] = results.size
 

data/lib/omnizip/parallel.rb

@@ -26,6 +26,7 @@ module Omnizip
     autoload :JobQueue, "omnizip/parallel/job_queue"
     autoload :JobScheduler, "omnizip/parallel/job_scheduler"
     autoload :WorkerPool, "omnizip/parallel/worker_pool"
+    autoload :Engine, "omnizip/parallel/engine"
     autoload :ParallelCompressor, "omnizip/parallel/parallel_compressor"
     autoload :ParallelExtractor, "omnizip/parallel/parallel_extractor"
 

data/lib/omnizip/registry.rb

@@ -48,7 +48,6 @@ module Omnizip
 
         trigger = lazy_triggers[normalized]
         if trigger
-          synchronize { lazy_triggers.delete(normalized) }
           trigger.call
           value = storage[normalized]
           return value if value

data/lib/omnizip/rubyzip_compat.rb

@@ -15,7 +15,6 @@
 #   end
 #
 
-
 # Create Zip namespace as alias for Omnizip::Zip
 module Zip
   # Rubyzip-compatible File class

data/lib/omnizip/version.rb

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

data/lib/omnizip/zip/entry.rb

@@ -5,8 +5,15 @@ module Omnizip
     # Rubyzip-compatible Entry class
     # Wraps CentralDirectoryHeader with rubyzip API
     class Entry
+      include Omnizip::Entry
+
       attr_reader :header, :ftype, :filepath
 
+      def entry_name = name
+      def entry_directory? = directory?
+      def entry_size = size
+      def entry_mtime = time
+
       # Create entry from CentralDirectoryHeader
       def initialize(header, filepath: nil)
         @header = header

data/lib/omnizip.rb

@@ -43,7 +43,6 @@ module Omnizip
   autoload :Registry, "omnizip/registry"
   autoload :Algorithm, "omnizip/algorithm"
   autoload :AlgorithmRegistry, "omnizip/algorithm_registry"
-  autoload :FormatRegistry, "omnizip/format_registry"
   autoload :OptimizationRegistry, "omnizip/optimization_registry"
   autoload :ChecksumRegistry, "omnizip/checksum_registry"
   autoload :FilterRegistry, "omnizip/filter_registry"
@@ -60,6 +59,7 @@ module Omnizip
   autoload :ETA, "omnizip/eta"
   autoload :Progress, "omnizip/progress"
   autoload :Metadata, "omnizip/metadata"
+  autoload :Entry, "omnizip/entry"
   autoload :Converter, "omnizip/converter"
   autoload :LinkHandler, "omnizip/link_handler"
   autoload :Parity, "omnizip/parity"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: omnizip
 version: !ruby/object:Gem::Version
-  version: 0.3.13
+  version: 0.3.14
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-07-24 00:00:00.000000000 Z
+date: 2026-07-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -364,6 +364,7 @@ files:
 - lib/omnizip/crypto/aes256/cipher.rb
 - lib/omnizip/crypto/aes256/constants.rb
 - lib/omnizip/crypto/aes256/key_derivation.rb
+- lib/omnizip/entry.rb
 - lib/omnizip/error.rb
 - lib/omnizip/eta.rb
 - lib/omnizip/eta/exponential_smoothing_estimator.rb
@@ -397,12 +398,8 @@ files:
 - lib/omnizip/filters/bcj_sparc.rb
 - lib/omnizip/filters/bcj_x86.rb
 - lib/omnizip/filters/delta.rb
-- lib/omnizip/filters/filter_base.rb
-- lib/omnizip/filters/registration.rb
-- lib/omnizip/filters/registry.rb
 - lib/omnizip/filters/xz_delta.rb
 - lib/omnizip/format_detector.rb
-- lib/omnizip/format_registry.rb
 - lib/omnizip/formats.rb
 - lib/omnizip/formats/.keep
 - lib/omnizip/formats/bzip2_file.rb
@@ -630,6 +627,7 @@ files:
 - lib/omnizip/models/split_options.rb
 - lib/omnizip/optimization_registry.rb
 - lib/omnizip/parallel.rb
+- lib/omnizip/parallel/engine.rb
 - lib/omnizip/parallel/job_queue.rb
 - lib/omnizip/parallel/job_scheduler.rb
 - lib/omnizip/parallel/parallel_compressor.rb

data/lib/omnizip/filters/filter_base.rb

@@ -1,6 +0,0 @@
-# frozen_string_literal: true
-
-# FilterBase is a historical alias for Omnizip::Filter. New code should
-# inherit from Omnizip::Filter directly; FilterBase is kept for
-# backward compatibility with existing subclasses (BcjX86, BcjArm, …).
-Omnizip::Filters::FilterBase = Omnizip::Filter

data/lib/omnizip/filters/registration.rb

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-
-# Filter registration - triggers autoload and registers all filters
-# This file should be required after filters.rb which sets up autoloads
-
-module Omnizip
-  module Filters
-    # Touch constants to trigger autoload
-    BCJ
-    BcjX86
-    Bcj2
-    BcjArm
-    BcjArm64
-    BcjPpc
-    BcjSparc
-    BcjIa64
-    Delta
-  end
-end
-
-# Filter registration is handled by each filter class in their initialize methods
-# via FilterRegistry.register calls

data/lib/omnizip/filters/registry.rb

@@ -1,111 +0,0 @@
-# frozen_string_literal: true
-
-#
-# Copyright (C) 2024 Ribose Inc.
-#
-# This file is part of Omnizip.
-#
-# Omnizip is a pure Ruby port of 7-Zip compression algorithms.
-# Based on the 7-Zip LZMA SDK by Igor Pavlov.
-#
-# This library is free software; you can redistribute it and/or
-# modify it under the terms of the GNU Lesser General Public
-# License as published by the Free Software Foundation; either
-# version 2.1 of the License, or (at your option) any later version.
-#
-# See the COPYING file for the complete text of the license.
-#
-
-module Omnizip
-  module Filters
-    # Registry for auto-registering all preprocessing filters.
-    #
-    # This module centralizes filter registration, ensuring all filters
-    # are properly registered with their supported formats.
-    module Registry
-      # Register all BCJ filters with appropriate format support.
-      #
-      # BCJ filters are architecture-specific filters for executable code.
-      # XZ format supports a subset of architectures (no ARM64),
-      # while 7z supports all.
-      #
-      # @return [void]
-      def self.register_bcj_filters
-        # Individual BCJ architecture filters (use hyphens to match existing convention)
-        register_bcj_filter(:"bcj-x86", BcjX86, architecture: :x86)
-        register_bcj_filter(:"bcj-arm", BcjArm, architecture: :arm)
-        register_bcj_filter(:"bcj-arm64", BcjArm64, architecture: :arm64,
-                                                    xz_supported: false)
-        register_bcj_filter(:"bcj-ia64", BcjIa64, architecture: :ia64)
-        register_bcj_filter(:"bcj-ppc", BcjPpc, architecture: :powerpc)
-        register_bcj_filter(:"bcj-sparc", BcjSparc, architecture: :sparc)
-
-        # Unified BCJ filter (Task 2) - supports all architectures
-        # Note: We register it as 'bcj' without architecture suffix
-        Omnizip::FilterRegistry.register_with_formats(
-          :bcj,
-          Omnizip::Filters::BCJ,
-          formats: [:seven_zip], # Only 7z for now (uses architecture parameter)
-        )
-      end
-
-      # Register a BCJ filter with format support.
-      #
-      # @param name [Symbol] Filter name identifier
-      # @param filter_class [Class] Filter class to register
-      # @param architecture [Symbol] Target architecture
-      # @param xz_supported [Boolean] Whether XZ format supports this architecture
-      # @return [void]
-      def self.register_bcj_filter(name, filter_class, architecture:,
-      xz_supported: true)
-        formats = [:seven_zip]
-        formats << :xz if xz_supported
-        Omnizip::FilterRegistry.register_with_formats(name, filter_class,
-                                                      formats: formats)
-      end
-
-      # Register Delta filter.
-      #
-      # Delta filter is supported by both XZ and 7z formats.
-      #
-      # @return [void]
-      def self.register_delta_filter
-        Omnizip::FilterRegistry.register_with_formats(
-          :delta,
-          Delta,
-          formats: %i[seven_zip xz],
-        )
-      end
-
-      # Register BCJ2 filter.
-      #
-      # BCJ2 is a 4-stream variant of BCJ, primarily used by 7z.
-      # XZ does not support BCJ2.
-      #
-      # @return [void]
-      def self.register_bcj2_filter
-        Omnizip::FilterRegistry.register_with_formats(
-          :bcj2,
-          Bcj2,
-          formats: [:seven_zip], # Only 7z supports BCJ2
-        )
-      end
-
-      # Register all filters.
-      #
-      # This method registers all available filters with their
-      # appropriate format support. Call this during application
-      # initialization to ensure all filters are available.
-      #
-      # @return [void]
-      def self.register_all
-        register_bcj_filters
-        register_delta_filter
-        register_bcj2_filter
-      end
-    end
-  end
-end
-
-# Auto-register all filters on load
-Omnizip::Filters::Registry.register_all