png_conform 0.1.1 → 0.1.3

data/lib/png_conform/validators/streaming_idat_validator.rb

@@ -0,0 +1,123 @@
+# frozen_string_literal: true
+
+require_relative "../base_validator"
+
+module PngConform
+  module Validators
+    # Streaming IDAT validator for memory-efficient validation
+    #
+    # This validator processes IDAT chunk data in streaming mode to avoid
+    # loading large decompressed image data into memory. Instead of
+    # fully decompressing, it validates the zlib stream incrementally.
+    #
+    class StreamingIdatValidator < BaseValidator
+      # Validate IDAT chunk
+      #
+      # Performs streaming validation of zlib-compressed image data
+      # without fully decompressing into memory.
+      #
+      # @return [void]
+      def validate
+        return add_error("Invalid IDAT sequence") unless check_idat_sequence
+        return add_error("Invalid IDAT order") unless check_idat_order
+
+        # Validate compression in streaming mode
+        validate_streaming_compression
+      end
+
+      private
+
+      # Check IDAT sequence requirements
+      #
+      # @return [Boolean] True if IDAT sequence is valid
+      def check_idat_sequence
+        # IDAT chunks must be consecutive
+        previous_chunk_type = @context.seen?("IDAT") ? "IDAT" : nil
+
+        if previous_chunk_type && previous_chunk_type != "IDAT"
+          add_warning("IDAT chunks must be consecutive")
+          return false
+        end
+
+        true
+      end
+
+      # Check IDAT order requirements
+      #
+      # IDAT must come after PLTE (if present) and before IEND
+      #
+      # @return [Boolean] True if IDAT is in correct position
+      def check_idat_order
+        # IDAT cannot be first (must have IHDR)
+        return false unless @context.seen?("IHDR")
+
+        # If PLTE exists, IDAT must come after it
+        if @context.seen?("PLTE")
+          @context.chunks_of_type("PLTE")
+          find_chunk_index("PLTE")
+          @context.chunks_of_type("IDAT").length
+
+          # For now, just check that PLTE was seen before any IDAT
+          # The actual ordering is validated in sequence validation
+        end
+
+        true
+      end
+
+      # Find the index of a chunk in the validation sequence
+      #
+      # @param chunk_type [String] Chunk type to find
+      # @return [Integer, nil] Index of chunk or nil
+      def find_chunk_index(_chunk_type)
+        # This would require tracking chunk order in context
+        # For now, return nil as this is handled by sequence validation
+        nil
+      end
+
+      # Validate compression using streaming zlib validation
+      #
+      # Instead of fully decompressing the image data (which can be huge),
+      # this validates that the compressed data is valid zlib format without
+      # loading the decompressed result.
+      #
+      # @return [void]
+      def validate_streaming_compression
+        require "zlib"
+
+        # Try to validate the zlib stream without full decompression
+        # We inflate just enough to verify validity
+        begin
+          inflater = Zlib::Inflate.new(Zlib::MAX_WBITS)
+
+          # Process data in chunks to avoid large memory allocation
+          chunk.data.each_slice(8192) do |slice|
+            # << is used to append data to the inflate stream
+            # This validates the data format without storing result
+            result = inflater << slice
+
+            # If we got decompressed data back, the stream is valid
+            # We don't need to store it, just validate
+            if result && !result.empty?
+              # Data is valid, we can discard it
+              # This means the compressed data is well-formed
+            end
+          rescue Zlib::DataError => e
+            return add_error("Invalid compressed data in IDAT: #{e.message}")
+          end
+
+          # Finish the stream to validate end of data
+          inflater.finish
+          inflater.close
+
+          add_info("Streaming compression validation successful")
+        rescue Zlib::StreamError => e
+          add_error("Invalid zlib stream in IDAT: #{e.message}")
+        rescue Zlib::BufError => e
+          add_error("Buffer error in IDAT compression: #{e.message}")
+        rescue StandardError => e
+          add_error("Compression validation error: #{e.message}")
+        end
+      end
+    end
+  end
+end

data/lib/png_conform/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PngConform
-  VERSION = "0.1.1"
+  VERSION = "0.1.3"
 end

data/lib/png_conform.rb

@@ -40,60 +40,21 @@ module PngConform
   require_relative "png_conform/models/validation_result"
   require_relative "png_conform/models/file_analysis"
 
-  # Load validators (Phase 4 & 5 - implemented)
+  # Load base validator and registry (Phase 4 optimization: lazy validator loading)
+  # All validators are loaded on-demand by chunk_registry
   require_relative "png_conform/validators/base_validator"
-
-  # Critical validators
-  require_relative "png_conform/validators/critical/ihdr_validator"
-  require_relative "png_conform/validators/critical/plte_validator"
-  require_relative "png_conform/validators/critical/idat_validator"
-  require_relative "png_conform/validators/critical/iend_validator"
-
-  # Ancillary validators
-  require_relative "png_conform/validators/ancillary/gama_validator"
-  require_relative "png_conform/validators/ancillary/trns_validator"
-  require_relative "png_conform/validators/ancillary/chrm_validator"
-  require_relative "png_conform/validators/ancillary/srgb_validator"
-  require_relative "png_conform/validators/ancillary/iccp_validator"
-  require_relative "png_conform/validators/ancillary/text_validator"
-  require_relative "png_conform/validators/ancillary/ztxt_validator"
-  require_relative "png_conform/validators/ancillary/itxt_validator"
-  require_relative "png_conform/validators/ancillary/bkgd_validator"
-  require_relative "png_conform/validators/ancillary/phys_validator"
-  require_relative "png_conform/validators/ancillary/sbit_validator"
-  require_relative "png_conform/validators/ancillary/splt_validator"
-  require_relative "png_conform/validators/ancillary/hist_validator"
-  require_relative "png_conform/validators/ancillary/time_validator"
-  require_relative "png_conform/validators/ancillary/offs_validator"
-  require_relative "png_conform/validators/ancillary/pcal_validator"
-  require_relative "png_conform/validators/ancillary/scal_validator"
-  require_relative "png_conform/validators/ancillary/ster_validator"
-  require_relative "png_conform/validators/ancillary/cicp_validator"
-  require_relative "png_conform/validators/ancillary/mdcv_validator"
+  require_relative "png_conform/validators/chunk_registry"
 
   # Load services (Phase 9 - implemented)
-  require_relative "png_conform/validators/chunk_registry"
   require_relative "png_conform/services/validation_service"
   require_relative "png_conform/services/profile_manager"
 
   # Load analyzers (Phase 13 - Quick Win features)
-  require_relative "png_conform/analyzers/optimization_analyzer"
-  require_relative "png_conform/analyzers/metrics_analyzer"
-  require_relative "png_conform/analyzers/resolution_analyzer"
-  require_relative "png_conform/analyzers/comparison_analyzer"
+  # Analyzers are lazy-loaded on-demand in validation_service.rb (Phase 3 optimization)
+  # No upfront loading needed here
 
-  # Load reporters (Phase 10 & 7 - implemented)
-  require_relative "png_conform/reporters/visual_elements"
-  require_relative "png_conform/reporters/base_reporter"
-  require_relative "png_conform/reporters/summary_reporter"
-  require_relative "png_conform/reporters/verbose_reporter"
-  require_relative "png_conform/reporters/very_verbose_reporter"
-  require_relative "png_conform/reporters/quiet_reporter"
-  require_relative "png_conform/reporters/palette_reporter"
-  require_relative "png_conform/reporters/text_reporter"
-  require_relative "png_conform/reporters/color_reporter"
-  require_relative "png_conform/reporters/yaml_reporter"
-  require_relative "png_conform/reporters/json_reporter"
+  # Load reporter factory only (Phase 2 optimization: lazy reporter loading)
+  # Individual reporters are loaded on-demand by the factory
   require_relative "png_conform/reporters/reporter_factory"
 
   # Load CLI (Phase 11 - implemented)

data/png_conform.gemspec

@@ -39,5 +39,6 @@ Gem::Specification.new do |spec|
 
   spec.add_dependency "bindata", "~> 2.5"
   spec.add_dependency "lutaml-model", "~> 0.7"
+  spec.add_dependency "paint", "~> 2.3"
   spec.add_dependency "thor", "~> 1.4"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: png_conform
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.3
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-11-17 00:00:00.000000000 Z
+date: 2026-01-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bindata
@@ -38,6 +38,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: paint
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
@@ -76,11 +90,28 @@ files:
 - README.adoc
 - Rakefile
 - SECURITY.md
+- benchmarks/README.adoc
+- benchmarks/config/default.yml
+- benchmarks/config/full.yml
+- benchmarks/config/quick.yml
+- benchmarks/direct_validation.rb
+- benchmarks/lib/benchmark_runner.rb
+- benchmarks/lib/metrics_collector.rb
+- benchmarks/lib/png_conform_runner.rb
+- benchmarks/lib/pngcheck_runner.rb
+- benchmarks/lib/report_generator.rb
+- benchmarks/lib/tool_runner.rb
+- benchmarks/profile_loading.rb
+- benchmarks/profile_validation.rb
+- benchmarks/results/.gitkeep
+- benchmarks/run_benchmark.rb
+- config/validation_profiles.yml
 - docs/ARCHITECTURE.adoc
 - docs/CHUNK_TYPES.adoc
 - docs/CLI_OPTIONS.adoc
 - docs/COMPATIBILITY.adoc
 - examples/README.adoc
+- examples/README.md
 - examples/advanced_usage.rb
 - examples/basic_usage.rb
 - exe/png_conform
@@ -96,6 +127,8 @@ files:
 - lib/png_conform/cli.rb
 - lib/png_conform/commands/check_command.rb
 - lib/png_conform/commands/list_command.rb
+- lib/png_conform/configuration.rb
+- lib/png_conform/container.rb
 - lib/png_conform/models/chunk.rb
 - lib/png_conform/models/chunk_info.rb
 - lib/png_conform/models/compression_info.rb
@@ -105,6 +138,13 @@ files:
 - lib/png_conform/models/image_info.rb
 - lib/png_conform/models/validation_error.rb
 - lib/png_conform/models/validation_result.rb
+- lib/png_conform/pipelines/pipeline_result.rb
+- lib/png_conform/pipelines/stages/analysis_stage.rb
+- lib/png_conform/pipelines/stages/base_stage.rb
+- lib/png_conform/pipelines/stages/chunk_validation_stage.rb
+- lib/png_conform/pipelines/stages/sequence_validation_stage.rb
+- lib/png_conform/pipelines/stages/signature_validation_stage.rb
+- lib/png_conform/pipelines/validation_pipeline.rb
 - lib/png_conform/readers/full_load_reader.rb
 - lib/png_conform/readers/streaming_reader.rb
 - lib/png_conform/reporters/base_reporter.rb
@@ -119,15 +159,27 @@ files:
 - lib/png_conform/reporters/very_verbose_reporter.rb
 - lib/png_conform/reporters/visual_elements.rb
 - lib/png_conform/reporters/yaml_reporter.rb
+- lib/png_conform/services/analysis_manager.rb
+- lib/png_conform/services/chunk_processor.rb
+- lib/png_conform/services/file_signature.rb
+- lib/png_conform/services/file_strategy.rb
+- lib/png_conform/services/lru_cache.rb
+- lib/png_conform/services/parallel_validator.rb
 - lib/png_conform/services/profile_manager.rb
+- lib/png_conform/services/result_builder.rb
+- lib/png_conform/services/validation_cache.rb
+- lib/png_conform/services/validation_orchestrator.rb
 - lib/png_conform/services/validation_service.rb
+- lib/png_conform/services/validator_pool.rb
 - lib/png_conform/services/zlib_validator.rb
+- lib/png_conform/utils/colorizer.rb
 - lib/png_conform/validators/ancillary/bkgd_validator.rb
 - lib/png_conform/validators/ancillary/chrm_validator.rb
 - lib/png_conform/validators/ancillary/cicp_validator.rb
 - lib/png_conform/validators/ancillary/gama_validator.rb
 - lib/png_conform/validators/ancillary/hist_validator.rb
 - lib/png_conform/validators/ancillary/iccp_validator.rb
+- lib/png_conform/validators/ancillary/idot_validator.rb
 - lib/png_conform/validators/ancillary/itxt_validator.rb
 - lib/png_conform/validators/ancillary/mdcv_validator.rb
 - lib/png_conform/validators/ancillary/offs_validator.rb
@@ -170,6 +222,7 @@ files:
 - lib/png_conform/validators/mng/seek_validator.rb
 - lib/png_conform/validators/mng/show_validator.rb
 - lib/png_conform/validators/mng/term_validator.rb
+- lib/png_conform/validators/streaming_idat_validator.rb
 - lib/png_conform/version.rb
 - png_conform.gemspec
 homepage: https://github.com/claricle/png_conform