png_conform 0.1.2 → 0.1.3

data/lib/png_conform/utils/colorizer.rb

@@ -0,0 +1,149 @@
+# frozen_string_literal: true
+
+require "paint"
+
+module PngConform
+  module Utils
+    # Colorization utility using the Paint gem
+    #
+    # Provides a centralized colorization service for terminal output.
+    # Wraps the Paint gem with semantic method names and caching.
+    #
+    # @example Basic usage
+    #   Colorizer.success("Success message")
+    #   Colorizer.error("Error message")
+    #   Colorizer.warning("Warning message", bold: true)
+    #
+    class Colorizer
+      class << self
+        # Check if colorization is enabled
+        #
+        # @return [Boolean] true if colors are enabled
+        def enabled?
+          Paint.mode != 0
+        end
+
+        # Enable or disable colorization
+        #
+        # @param value [Boolean] true to enable, false to disable
+        def enabled=(value)
+          Paint.mode = value ? Paint.detect_mode : 0
+        end
+
+        # Colorize text as success (green)
+        #
+        # @param text [String] Text to colorize
+        # @param bold [Boolean] Whether to use bold formatting
+        # @return [String] Colorized text
+        def success(text, bold: false)
+          colorize(text, :green, bold: bold)
+        end
+
+        # Colorize text as error (red)
+        #
+        # @param text [String] Text to colorize
+        # @param bold [Boolean] Whether to use bold formatting
+        # @return [String] Colorized text
+        def error(text, bold: false)
+          colorize(text, :red, bold: bold)
+        end
+
+        # Colorize text as warning (yellow)
+        #
+        # @param text [String] Text to colorize
+        # @param bold [Boolean] Whether to use bold formatting
+        # @return [String] Colorized text
+        def warning(text, bold: false)
+          colorize(text, :yellow, bold: bold)
+        end
+
+        # Colorize text as info (blue)
+        #
+        # @param text [String] Text to colorize
+        # @param bold [Boolean] Whether to use bold formatting
+        # @return [String] Colorized text
+        def info(text, bold: false)
+          colorize(text, :blue, bold: bold)
+        end
+
+        # Colorize text with bold formatting
+        #
+        # @param text [String] Text to colorize
+        # @param color [Symbol] Color to use
+        # @return [String] Colorized text
+        def bold(text, color = nil)
+          return Paint[text, :bold] unless color
+
+          Paint[text, color, :bold]
+        end
+
+        # Colorize text with a specific color
+        #
+        # @param text [String] Text to colorize
+        # @param color [Symbol] Color to use
+        # @param bold [Boolean] Whether to use bold formatting
+        # @return [String] Colorized text
+        def colorize(text, color, bold: false)
+          return text.to_s unless enabled?
+
+          if bold
+            Paint[text, color, :bold]
+          else
+            Paint[text, color]
+          end
+        end
+
+        # Colorize text based on priority
+        #
+        # @param text [String] Text to colorize
+        # @param priority [Symbol] Priority (:high, :medium, :low)
+        # @return [String] Colorized text
+        def priority(text, priority:)
+          case priority
+          when :high
+            error(text, bold: true)
+          when :medium
+            warning(text, bold: true)
+          when :low
+            info(text)
+          else
+            text.to_s
+          end
+        end
+
+        # Get a checkmark symbol (with color)
+        #
+        # @param success [Boolean] Whether the check should be green
+        # @return [String] Colored checkmark
+        def checkmark(success: true)
+          if success
+            success("✓")
+          else
+            error("✗")
+          end
+        end
+
+        # Remove all color codes from text
+        #
+        # @param text [String] Text to uncolorize
+        # @return [String] Plain text
+        def uncolorize(text)
+          Paint.unpaint(text)
+        end
+
+        # Apply multiple colorizations to different parts of text
+        #
+        # @param template [String] Template with %{key} placeholders
+        # @param substitutions [Hash] Hash of key => [text, color] pairs
+        # @return [String] Colorized text
+        # @example
+        #   Colorizer.template("%{greeting} %{name}",
+        #     greeting: ["Hello", :green],
+        #     name: ["World", :blue])
+        def template(template, substitutions)
+          Paint[template, substitutions]
+        end
+      end
+    end
+  end
+end

data/lib/png_conform/validators/chunk_registry.rb

@@ -189,6 +189,18 @@ module PngConform
           validator_class.new(chunk, context)
         end
 
+        # Preload all validators for performance
+        #
+        # Loads all validator classes into cache at startup to improve
+        # validation performance by avoiding lazy loading overhead.
+        #
+        # @return [void]
+        def preload_validators!
+          VALIDATOR_PATHS.each_key do |chunk_type|
+            validator_for(chunk_type)
+          end
+        end
+
         private
 
         # Cache for loaded validator classes

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.2"
+  VERSION = "0.1.3"
 end

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.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-11-23 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
@@ -91,6 +105,7 @@ files:
 - 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
@@ -112,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
@@ -121,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
@@ -135,9 +159,20 @@ 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
@@ -187,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