omnizip 0.3.12 → 0.3.14

data/lib/omnizip/implementations/base/lzma_decoder_base.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 # Copyright (C) 2025 Ribose Inc.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a

data/lib/omnizip/implementations/base/lzma_encoder_base.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 # Copyright (C) 2025 Ribose Inc.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a

data/lib/omnizip/implementations/base/state_machine_base.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 # Copyright (C) 2025 Ribose Inc.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a

data/lib/omnizip/implementations/base.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module Implementations
     # Base classes for implementation inheritance

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

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 # Copyright (C) 2025 Ribose Inc.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a

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

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 # Copyright (C) 2025 Ribose Inc.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a

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

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 # Copyright (C) 2025 Ribose Inc.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a

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

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 # Copyright (C) 2025 Ribose Inc.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a

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

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 # Copyright (C) 2025 Ribose Inc.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a

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

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 # Copyright (C) 2025 Ribose Inc.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a

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

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module Implementations
     module SevenZip

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

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 # Copyright (C) 2025 Ribose Inc.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a

data/lib/omnizip/implementations/seven_zip/lzma2.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module Implementations
     module SevenZip

data/lib/omnizip/implementations/seven_zip.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module Implementations
     # 7-Zip SDK reference implementations

data/lib/omnizip/implementations/xz_utils/lzma2/decoder.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 # Copyright (C) 2025 Ribose Inc.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a

data/lib/omnizip/implementations/xz_utils/lzma2/encoder.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 # Copyright (C) 2025 Ribose Inc.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a

data/lib/omnizip/implementations/xz_utils/lzma2.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module Implementations
     module XZUtils

data/lib/omnizip/implementations/xz_utils.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module Implementations
     # XZ Utils reference implementations

data/lib/omnizip/implementations.rb

@@ -1,13 +1,25 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 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/io/buffered_input.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 #
 # Copyright (C) 2024 Ribose Inc.
 #

data/lib/omnizip/io/buffered_output.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 #
 # Copyright (C) 2024 Ribose Inc.
 #

data/lib/omnizip/io/source.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module IO
     # Polymorphic adapter for "things we can read bytes from".

data/lib/omnizip/io/stream_manager.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 #
 # Copyright (C) 2024 Ribose Inc.
 #

data/lib/omnizip/io.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   # I/O utilities module
   #

data/lib/omnizip/link_handler/hard_link.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module LinkHandler
     # Model for hard links

data/lib/omnizip/link_handler/symbolic_link.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module LinkHandler
     # Model for symbolic links

data/lib/omnizip/link_handler.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   # Handles symbolic and hard link operations with platform detection
   module LinkHandler

data/lib/omnizip/metadata/archive_metadata.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module Metadata
     # Model for archive-level metadata

data/lib/omnizip/metadata/entry_metadata.rb

@@ -1,14 +1,19 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module Metadata
     # 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/metadata/metadata_editor.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module Metadata
     # Coordinates metadata editing operations

data/lib/omnizip/metadata/metadata_registry.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module Metadata
     # Registry of supported metadata per archive format

data/lib/omnizip/metadata/metadata_validator.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module Metadata
     # Validates metadata changes before applying

data/lib/omnizip/metadata.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   # Metadata editing module
   # Provides in-place metadata modification without recompression

data/lib/omnizip/models/algorithm_metadata.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 require "lutaml/model"
 
 module Omnizip

data/lib/omnizip/models/compression_options.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 require "lutaml/model"
 require "json"
 

data/lib/omnizip/models/conversion_options.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module Models
     # Options for converting between archive formats.

data/lib/omnizip/models/conversion_result.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module Models
     # Model for format conversion results

data/lib/omnizip/models/eta_result.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 #
 # Copyright (C) 2025 Ribose Inc.
 #

data/lib/omnizip/models/extraction_rule.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module Models
     # Represents a rule for extracting files from an archive

data/lib/omnizip/models/filter_chain.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 #
 # Copyright (C) 2025 Ribose Inc.
 #

data/lib/omnizip/models/filter_config.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 #
 # Copyright (C) 2025 Ribose Inc.
 #

data/lib/omnizip/models/match_result.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module Models
     # Represents the result of pattern matching against archive entries

data/lib/omnizip/models/optimization_suggestion.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module Models
     # Represents a performance optimization suggestion based on profiling data

data/lib/omnizip/models/parallel_options.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module Models
     # Model for parallel processing configuration

data/lib/omnizip/models/performance_result.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module Models
     # Represents the performance characteristics of a profiled operation

data/lib/omnizip/models/profile_report.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module Models
     # Represents an aggregated profiling report with hot path analysis

data/lib/omnizip/models/progress_options.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 #
 # Copyright (C) 2025 Ribose Inc.
 #

data/lib/omnizip/models/split_options.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module Models
     # Configuration for split archive (multi-volume) creation

data/lib/omnizip/optimization_registry.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   class OptimizationRegistry < Omnizip::Registry
     class << self

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/job_queue.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module Parallel
     # Thread-safe job queue for parallel compression/extraction

data/lib/omnizip/parallel/job_scheduler.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   module Parallel
     # Job scheduler for load balancing and work distribution

data/lib/omnizip/parallel/parallel_compressor.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 require "fractor"
 require "fileutils"
 
@@ -214,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?
@@ -240,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

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 require "fractor"
 require "fileutils"
 
@@ -203,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?
@@ -229,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/worker_pool.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 require "fractor"
 
 module Omnizip

data/lib/omnizip/parallel.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-
-require "omnizip"
 module Omnizip
   # Parallel processing module for multi-threaded compression/extraction
   #
@@ -28,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"