cabriolet 0.1.2 → 0.2.0

data/lib/cabriolet/szdd/compressor.rb

@@ -14,8 +14,10 @@ module Cabriolet
       #
       # @param io_system [System::IOSystem, nil] Custom I/O system or nil for
       #   default
-      def initialize(io_system = nil)
+      # @param algorithm_factory [AlgorithmFactory, nil] Custom algorithm factory or nil for default
+      def initialize(io_system = nil, algorithm_factory = nil)
         @io_system = io_system || System::IOSystem.new
+        @algorithm_factory = algorithm_factory || Cabriolet.algorithm_factory
       end
 
       # Compress a file to SZDD format
@@ -59,12 +61,14 @@ module Cabriolet
                         Compressors::LZSS::MODE_QBASIC
                       end
 
-          compressor = Compressors::LZSS.new(
+          compressor = @algorithm_factory.create(
+            :lzss,
+            :compressor,
             @io_system,
             input_handle,
             output_handle,
             2048,
-            lzss_mode,
+            mode: lzss_mode,
           )
 
           compressed_bytes = compressor.compress
@@ -107,18 +111,18 @@ module Cabriolet
           )
 
           # Compress data using LZSS
-          lzss_mode = if format == :normal
-                        Compressors::LZSS::MODE_EXPAND
-                      else
-                        Compressors::LZSS::MODE_QBASIC
-                      end
-
-          compressor = Compressors::LZSS.new(
+          compressor = @algorithm_factory.create(
+            :lzss,
+            :compressor,
             @io_system,
             input_handle,
             output_handle,
             2048,
-            lzss_mode,
+            mode: if format == :normal
+                    Compressors::LZSS::MODE_EXPAND
+                  else
+                    Compressors::LZSS::MODE_QBASIC
+                  end,
           )
 
           compressed_bytes = compressor.compress

data/lib/cabriolet/szdd/decompressor.rb

@@ -17,8 +17,10 @@ module Cabriolet
       #
       # @param io_system [System::IOSystem, nil] Custom I/O system or nil for
       #   default
-      def initialize(io_system = nil)
+      # @param algorithm_factory [AlgorithmFactory, nil] Custom algorithm factory or nil for default
+      def initialize(io_system = nil, algorithm_factory = nil)
         @io_system = io_system || System::IOSystem.new
+        @algorithm_factory = algorithm_factory || Cabriolet.algorithm_factory
         @parser = Parser.new(@io_system)
         @buffer_size = DEFAULT_BUFFER_SIZE
       end
@@ -70,16 +72,18 @@ module Cabriolet
                       end
 
           # Create LZSS decompressor
-          decompressor = Decompressors::LZSS.new(
+          decompressor = @algorithm_factory.create(
+            :lzss,
+            :decompressor,
             @io_system,
             input_handle,
             output_handle,
             @buffer_size,
-            lzss_mode,
+            mode: lzss_mode,
           )
 
-          # Decompress
-          bytes_written = decompressor.decompress(header.length)
+          # Decompress (SZDD reads until EOF, no compressed size stored)
+          bytes_written = decompressor.decompress(nil)
 
           # Verify decompressed size matches expected
           if bytes_written != header.length && Cabriolet.verbose && Cabriolet.verbose
@@ -118,16 +122,18 @@ module Cabriolet
                       end
 
           # Create LZSS decompressor
-          decompressor = Decompressors::LZSS.new(
+          decompressor = @algorithm_factory.create(
+            :lzss,
+            :decompressor,
             @io_system,
             input_handle,
             output_handle,
             @buffer_size,
-            lzss_mode,
+            mode: lzss_mode,
           )
 
-          # Decompress
-          decompressor.decompress(header.length)
+          # Decompress (SZDD reads until EOF, no compressed size stored)
+          decompressor.decompress(nil)
 
           # Return the decompressed data
           output_handle.data
@@ -175,6 +181,9 @@ module Cabriolet
         # Use header's suggested filename method
         suggested = header.suggested_filename(base)
 
+        # Strip null bytes which can occur in malformed SZDD files
+        suggested = suggested.delete("\0")
+
         # Combine with original directory
         dir = ::File.dirname(input_path)
         ::File.join(dir, suggested)

data/lib/cabriolet/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Cabriolet
-  VERSION = "0.1.2"
+  VERSION = "0.2.0"
 end

data/lib/cabriolet.rb

@@ -1,8 +1,31 @@
 # frozen_string_literal: true
 
+# Cabriolet - Pure Ruby implementation of Microsoft compression formats
 require_relative "cabriolet/version"
-require_relative "cabriolet/platform"
 require_relative "cabriolet/constants"
+require_relative "cabriolet/errors"
+require_relative "cabriolet/platform"
+
+# System layer
+require_relative "cabriolet/system/io_system"
+require_relative "cabriolet/system/file_handle"
+require_relative "cabriolet/system/memory_handle"
+
+# Binary structures
+require_relative "cabriolet/binary/bitstream"
+require_relative "cabriolet/binary/bitstream_writer"
+require_relative "cabriolet/binary/structures"
+require_relative "cabriolet/binary/chm_structures"
+require_relative "cabriolet/binary/szdd_structures"
+require_relative "cabriolet/binary/kwaj_structures"
+require_relative "cabriolet/binary/hlp_structures"
+require_relative "cabriolet/binary/lit_structures"
+require_relative "cabriolet/binary/oab_structures"
+
+# Foundation classes (architectural improvements)
+require_relative "cabriolet/file_entry"
+require_relative "cabriolet/file_manager"
+require_relative "cabriolet/base_compressor"
 
 # Cabriolet is a pure Ruby library for extracting Microsoft Cabinet (.CAB) files,
 # CHM (Compiled HTML Help) files, and related compression formats.
@@ -13,40 +36,62 @@ module Cabriolet
 
     # Default buffer size for I/O operations (4KB)
     attr_accessor :default_buffer_size
+
+    # Get the global algorithm factory instance
+    #
+    # @return [AlgorithmFactory] The algorithm factory
+    def algorithm_factory
+      @algorithm_factory ||= AlgorithmFactory.new
+    end
+
+    # Set the global algorithm factory instance
+    #
+    # @param factory [AlgorithmFactory] The algorithm factory to use
+    # @return [AlgorithmFactory] The factory
+    def algorithm_factory=(factory)
+      @algorithm_factory = factory
+    end
+
+    # Get the global plugin manager instance
+    #
+    # @return [PluginManager] The plugin manager
+    def plugin_manager
+      PluginManager.instance
+    end
   end
 
   self.verbose = false
   self.default_buffer_size = 4096
 end
 
-# Load core components
-require_relative "cabriolet/system/io_system"
-require_relative "cabriolet/system/file_handle"
-require_relative "cabriolet/system/memory_handle"
-
-require_relative "cabriolet/binary/structures"
-require_relative "cabriolet/binary/bitstream"
-require_relative "cabriolet/binary/bitstream_writer"
-require_relative "cabriolet/binary/chm_structures"
-require_relative "cabriolet/binary/szdd_structures"
-require_relative "cabriolet/binary/kwaj_structures"
-require_relative "cabriolet/binary/hlp_structures"
-require_relative "cabriolet/binary/lit_structures"
-require_relative "cabriolet/binary/oab_structures"
-
+# Models
 require_relative "cabriolet/models/cabinet"
 require_relative "cabriolet/models/folder"
+require_relative "cabriolet/models/folder_data"
 require_relative "cabriolet/models/file"
 require_relative "cabriolet/models/chm_header"
-require_relative "cabriolet/models/chm_file"
 require_relative "cabriolet/models/chm_section"
+require_relative "cabriolet/models/chm_file"
 require_relative "cabriolet/models/szdd_header"
 require_relative "cabriolet/models/kwaj_header"
 require_relative "cabriolet/models/hlp_header"
 require_relative "cabriolet/models/hlp_file"
+require_relative "cabriolet/models/winhelp_header"
 require_relative "cabriolet/models/lit_header"
 require_relative "cabriolet/models/oab_header"
 
+# Load errors first (needed by algorithm_factory)
+
+# Load plugin system
+require_relative "cabriolet/plugin"
+require_relative "cabriolet/plugin_validator"
+require_relative "cabriolet/plugin_manager"
+
+# Load algorithm factory
+require_relative "cabriolet/algorithm_factory"
+
+# Load core components
+
 require_relative "cabriolet/huffman/tree"
 require_relative "cabriolet/huffman/decoder"
 require_relative "cabriolet/huffman/encoder"
@@ -85,6 +130,11 @@ require_relative "cabriolet/hlp/parser"
 require_relative "cabriolet/hlp/decompressor"
 require_relative "cabriolet/hlp/compressor"
 
+require_relative "cabriolet/hlp/winhelp/parser"
+require_relative "cabriolet/hlp/winhelp/zeck_lz77"
+require_relative "cabriolet/hlp/winhelp/decompressor"
+require_relative "cabriolet/hlp/winhelp/compressor"
+
 require_relative "cabriolet/lit/decompressor"
 require_relative "cabriolet/lit/compressor"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cabriolet
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-11-14 00:00:00.000000000 Z
+date: 2026-01-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bindata
@@ -53,7 +53,9 @@ files:
 - README.adoc
 - exe/cabriolet
 - lib/cabriolet.rb
+- lib/cabriolet/algorithm_factory.rb
 - lib/cabriolet/auto.rb
+- lib/cabriolet/base_compressor.rb
 - lib/cabriolet/binary/bitstream.rb
 - lib/cabriolet/binary/bitstream_writer.rb
 - lib/cabriolet/binary/chm_structures.rb
@@ -63,14 +65,19 @@ files:
 - lib/cabriolet/binary/oab_structures.rb
 - lib/cabriolet/binary/structures.rb
 - lib/cabriolet/binary/szdd_structures.rb
+- lib/cabriolet/cab/command_handler.rb
 - lib/cabriolet/cab/compressor.rb
 - lib/cabriolet/cab/decompressor.rb
 - lib/cabriolet/cab/extractor.rb
 - lib/cabriolet/cab/parser.rb
+- lib/cabriolet/chm/command_handler.rb
 - lib/cabriolet/chm/compressor.rb
 - lib/cabriolet/chm/decompressor.rb
 - lib/cabriolet/chm/parser.rb
 - lib/cabriolet/cli.rb
+- lib/cabriolet/cli/base_command_handler.rb
+- lib/cabriolet/cli/command_dispatcher.rb
+- lib/cabriolet/cli/command_registry.rb
 - lib/cabriolet/compressors/base.rb
 - lib/cabriolet/compressors/lzss.rb
 - lib/cabriolet/compressors/lzx.rb
@@ -84,18 +91,35 @@ files:
 - lib/cabriolet/decompressors/none.rb
 - lib/cabriolet/decompressors/quantum.rb
 - lib/cabriolet/errors.rb
+- lib/cabriolet/file_entry.rb
+- lib/cabriolet/file_manager.rb
 - lib/cabriolet/format_detector.rb
+- lib/cabriolet/hlp/command_handler.rb
 - lib/cabriolet/hlp/compressor.rb
 - lib/cabriolet/hlp/decompressor.rb
 - lib/cabriolet/hlp/parser.rb
+- lib/cabriolet/hlp/quickhelp/compression_stream.rb
+- lib/cabriolet/hlp/quickhelp/compressor.rb
+- lib/cabriolet/hlp/quickhelp/decompressor.rb
+- lib/cabriolet/hlp/quickhelp/huffman_stream.rb
+- lib/cabriolet/hlp/quickhelp/huffman_tree.rb
+- lib/cabriolet/hlp/quickhelp/parser.rb
+- lib/cabriolet/hlp/winhelp/btree_builder.rb
+- lib/cabriolet/hlp/winhelp/compressor.rb
+- lib/cabriolet/hlp/winhelp/decompressor.rb
+- lib/cabriolet/hlp/winhelp/parser.rb
+- lib/cabriolet/hlp/winhelp/zeck_lz77.rb
 - lib/cabriolet/huffman/decoder.rb
 - lib/cabriolet/huffman/encoder.rb
 - lib/cabriolet/huffman/tree.rb
+- lib/cabriolet/kwaj/command_handler.rb
 - lib/cabriolet/kwaj/compressor.rb
 - lib/cabriolet/kwaj/decompressor.rb
 - lib/cabriolet/kwaj/parser.rb
+- lib/cabriolet/lit/command_handler.rb
 - lib/cabriolet/lit/compressor.rb
 - lib/cabriolet/lit/decompressor.rb
+- lib/cabriolet/lit/parser.rb
 - lib/cabriolet/models/cabinet.rb
 - lib/cabriolet/models/chm_file.rb
 - lib/cabriolet/models/chm_header.rb
@@ -109,16 +133,23 @@ files:
 - lib/cabriolet/models/lit_header.rb
 - lib/cabriolet/models/oab_header.rb
 - lib/cabriolet/models/szdd_header.rb
+- lib/cabriolet/models/winhelp_header.rb
 - lib/cabriolet/modifier.rb
+- lib/cabriolet/oab/command_handler.rb
 - lib/cabriolet/oab/compressor.rb
 - lib/cabriolet/oab/decompressor.rb
+- lib/cabriolet/offset_calculator.rb
 - lib/cabriolet/parallel.rb
 - lib/cabriolet/platform.rb
+- lib/cabriolet/plugin.rb
+- lib/cabriolet/plugin_manager.rb
+- lib/cabriolet/plugin_validator.rb
 - lib/cabriolet/repairer.rb
 - lib/cabriolet/streaming.rb
 - lib/cabriolet/system/file_handle.rb
 - lib/cabriolet/system/io_system.rb
 - lib/cabriolet/system/memory_handle.rb
+- lib/cabriolet/szdd/command_handler.rb
 - lib/cabriolet/szdd/compressor.rb
 - lib/cabriolet/szdd/decompressor.rb
 - lib/cabriolet/szdd/parser.rb