png_conform 0.1.0

data/lib/png_conform.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+require "bindata"
+require "lutaml/model"
+require "thor"
+
+require_relative "png_conform/version"
+
+# Configure lutaml-model for YAML/JSON serialization
+Lutaml::Model::Config.configure do |config|
+  config.yaml_adapter_type = :standard_yaml
+  config.json_adapter_type = :standard_json
+end
+
+module PngConform
+  class Error < StandardError; end
+
+  class ValidationError < Error; end
+
+  class ParseError < Error; end
+
+  # Load BinData structures (Phase 2 - implemented)
+  require_relative "png_conform/bindata/chunk_structure"
+  require_relative "png_conform/bindata/png_file"
+  require_relative "png_conform/bindata/mng_file"
+  require_relative "png_conform/bindata/jng_file"
+
+  # Load readers (Phase 2 - implemented)
+  require_relative "png_conform/readers/streaming_reader"
+  require_relative "png_conform/readers/full_load_reader"
+
+  # Load domain models (Phase 3 & 10 - implemented)
+  require_relative "png_conform/models/decoded_chunk_data"
+  require_relative "png_conform/models/chunk"
+  require_relative "png_conform/models/validation_error"
+  require_relative "png_conform/models/chunk_info"
+  require_relative "png_conform/models/image_info"
+  require_relative "png_conform/models/compression_info"
+  require_relative "png_conform/models/file_info"
+  require_relative "png_conform/models/validation_result"
+  require_relative "png_conform/models/file_analysis"
+
+  # Load validators (Phase 4 & 5 - implemented)
+  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"
+
+  # 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"
+
+  # 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"
+  require_relative "png_conform/reporters/reporter_factory"
+
+  # Load CLI (Phase 11 - implemented)
+  require_relative "png_conform/cli"
+end

data/png_conform.gemspec

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require_relative "lib/png_conform/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "png_conform"
+  spec.version = PngConform::VERSION
+  spec.authors = ["Ribose Inc."]
+  spec.email = ["open.source@ribose.com"]
+
+  spec.summary = "Pure Ruby PNG/MNG/JNG validity checker with profile support"
+  spec.description = <<~HEREDOC
+    PngConform provides a comprehensive PNG, MNG, and JNG file validation library
+    in pure Ruby. It validates file structure, chunk validity, CRC checksums,
+    zlib compression, and profile conformance. Built with a layered architecture
+    using BinData for binary parsing, Lutaml::Model for domain models, and Thor
+    for CLI. Supports PNG baseline, MNG-VLC, MNG-LC, and JNG profiles with
+    detailed validation reporting compatible with pngcheck output.
+  HEREDOC
+
+  spec.homepage = "https://github.com/claricle/png_conform"
+  spec.license = "BSD-2-Clause"
+  spec.required_ruby_version = ">= 3.0.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/claricle/png_conform"
+  spec.metadata["changelog_uri"] = "https://github.com/claricle/png_conform"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
+    end
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "bindata", "~> 2.5"
+  spec.add_dependency "lutaml-model", "~> 0.7"
+  spec.add_dependency "thor", "~> 1.4"
+end

metadata

@@ -0,0 +1,201 @@
+--- !ruby/object:Gem::Specification
+name: png_conform
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ribose Inc.
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-11-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bindata
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: lutaml-model
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+description: |
+  PngConform provides a comprehensive PNG, MNG, and JNG file validation library
+  in pure Ruby. It validates file structure, chunk validity, CRC checksums,
+  zlib compression, and profile conformance. Built with a layered architecture
+  using BinData for binary parsing, Lutaml::Model for domain models, and Thor
+  for CLI. Supports PNG baseline, MNG-VLC, MNG-LC, and JNG profiles with
+  detailed validation reporting compatible with pngcheck output.
+email:
+- open.source@ribose.com
+executables:
+- png_conform
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- ".rubocop_todo.yml"
+- CODE_OF_CONDUCT.md
+- CONTRIBUTING.md
+- Gemfile
+- LICENSE
+- README.adoc
+- Rakefile
+- SECURITY.md
+- docs/ARCHITECTURE.adoc
+- docs/CHUNK_TYPES.adoc
+- docs/CLI_OPTIONS.adoc
+- docs/COMPATIBILITY.adoc
+- examples/README.adoc
+- examples/advanced_usage.rb
+- examples/basic_usage.rb
+- exe/png_conform
+- lib/png_conform.rb
+- lib/png_conform/analyzers/comparison_analyzer.rb
+- lib/png_conform/analyzers/metrics_analyzer.rb
+- lib/png_conform/analyzers/optimization_analyzer.rb
+- lib/png_conform/analyzers/resolution_analyzer.rb
+- lib/png_conform/bindata/chunk_structure.rb
+- lib/png_conform/bindata/jng_file.rb
+- lib/png_conform/bindata/mng_file.rb
+- lib/png_conform/bindata/png_file.rb
+- lib/png_conform/cli.rb
+- lib/png_conform/commands/check_command.rb
+- lib/png_conform/commands/list_command.rb
+- lib/png_conform/models/chunk.rb
+- lib/png_conform/models/chunk_info.rb
+- lib/png_conform/models/compression_info.rb
+- lib/png_conform/models/decoded_chunk_data.rb
+- lib/png_conform/models/file_analysis.rb
+- lib/png_conform/models/file_info.rb
+- lib/png_conform/models/image_info.rb
+- lib/png_conform/models/validation_error.rb
+- lib/png_conform/models/validation_result.rb
+- lib/png_conform/readers/full_load_reader.rb
+- lib/png_conform/readers/streaming_reader.rb
+- lib/png_conform/reporters/base_reporter.rb
+- lib/png_conform/reporters/color_reporter.rb
+- lib/png_conform/reporters/json_reporter.rb
+- lib/png_conform/reporters/palette_reporter.rb
+- lib/png_conform/reporters/quiet_reporter.rb
+- lib/png_conform/reporters/reporter_factory.rb
+- lib/png_conform/reporters/summary_reporter.rb
+- lib/png_conform/reporters/text_reporter.rb
+- lib/png_conform/reporters/verbose_reporter.rb
+- 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/profile_manager.rb
+- lib/png_conform/services/validation_service.rb
+- lib/png_conform/services/zlib_validator.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/itxt_validator.rb
+- lib/png_conform/validators/ancillary/mdcv_validator.rb
+- lib/png_conform/validators/ancillary/offs_validator.rb
+- lib/png_conform/validators/ancillary/pcal_validator.rb
+- lib/png_conform/validators/ancillary/phys_validator.rb
+- lib/png_conform/validators/ancillary/sbit_validator.rb
+- lib/png_conform/validators/ancillary/scal_validator.rb
+- lib/png_conform/validators/ancillary/splt_validator.rb
+- lib/png_conform/validators/ancillary/srgb_validator.rb
+- lib/png_conform/validators/ancillary/ster_validator.rb
+- lib/png_conform/validators/ancillary/text_validator.rb
+- lib/png_conform/validators/ancillary/time_validator.rb
+- lib/png_conform/validators/ancillary/trns_validator.rb
+- lib/png_conform/validators/ancillary/ztxt_validator.rb
+- lib/png_conform/validators/apng/actl_validator.rb
+- lib/png_conform/validators/apng/fctl_validator.rb
+- lib/png_conform/validators/apng/fdat_validator.rb
+- lib/png_conform/validators/base_validator.rb
+- lib/png_conform/validators/chunk_registry.rb
+- lib/png_conform/validators/critical/idat_validator.rb
+- lib/png_conform/validators/critical/iend_validator.rb
+- lib/png_conform/validators/critical/ihdr_validator.rb
+- lib/png_conform/validators/critical/plte_validator.rb
+- lib/png_conform/validators/jng/jdat_validator.rb
+- lib/png_conform/validators/jng/jhdr_validator.rb
+- lib/png_conform/validators/jng/jsep_validator.rb
+- lib/png_conform/validators/mng/back_validator.rb
+- lib/png_conform/validators/mng/clip_validator.rb
+- lib/png_conform/validators/mng/clon_validator.rb
+- lib/png_conform/validators/mng/defi_validator.rb
+- lib/png_conform/validators/mng/dhdr_validator.rb
+- lib/png_conform/validators/mng/disc_validator.rb
+- lib/png_conform/validators/mng/endl_validator.rb
+- lib/png_conform/validators/mng/fram_validator.rb
+- lib/png_conform/validators/mng/loop_validator.rb
+- lib/png_conform/validators/mng/mend_validator.rb
+- lib/png_conform/validators/mng/mhdr_validator.rb
+- lib/png_conform/validators/mng/move_validator.rb
+- lib/png_conform/validators/mng/save_validator.rb
+- 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/version.rb
+- png_conform.gemspec
+homepage: https://github.com/claricle/png_conform
+licenses:
+- BSD-2-Clause
+metadata:
+  homepage_uri: https://github.com/claricle/png_conform
+  source_code_uri: https://github.com/claricle/png_conform
+  changelog_uri: https://github.com/claricle/png_conform
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Pure Ruby PNG/MNG/JNG validity checker with profile support
+test_files: []