image_util 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 893e648382567326c70c82a4b3e3b6580889229c9d56c7a20ec4d182b45332b4
-  data.tar.gz: 70fd8a63b0551a0aaca12dae391c076fb01621443ec1ae5e5f92c680655277f2
+  metadata.gz: 2665eb7733f8fa7dc6e091d09a8ddc3315d0461395fd15aa1eb2c12ca9de9df6
+  data.tar.gz: bc5ced5903fa35dfbe03a05ae6aff8e797ca3c5d39407881c288168f5cbe51d1
 SHA512:
-  metadata.gz: 89a0a3bf90307337674acae7e1315505bc4a8363e58c041388dc6e6beeaab3f03e4534d2ff41e9a97c23f5775e62db6ebe5493658ac2b81e06f3a650a197d28a
-  data.tar.gz: 6b425b6539c389431e78cdc98744a82888a3f55e0fdeed64062bf69a3e0448fec84e83264b3dd1380133a5adafa87e5751dd36595c7c3dc413e4ead3173d21ae
+  metadata.gz: caf2f99b10ff415168c0ac9defc7966d5e374d007a5859eab7580ae0865f6a6bc5203d116e094ca77dbbc26fcc69faaead7869b092297bc4a42749ae2a2f95cd
+  data.tar.gz: 66823c89ef52e3bb5c0927529c4dc99877253047a7659450da0d2a7bd7790944f836656b10c07bbbcb2eae40cb95ad95c694f5d69c2338a526fae36bfddedf21

data/CHANGELOG.md

@@ -1,3 +1,6 @@
+## [0.5.0] - 2025-10-05
+- Add `ImageUtil::Inspectable` interface for other gems to use
+
 ## [0.4.0] - 2025-10-04
 - BREAKING: Float color components now share the 0..255 range with integers instead of being scaled from 0..1.
 - Add `define_mutable_version` helper to create bang versions from immutable methods

data/lib/image_util/image.rb

@@ -4,6 +4,8 @@ module ImageUtil
   class Image
     autoload :Buffer, "image_util/image/buffer"
 
+    include ImageUtil::Inspectable
+
     Util.irb_fixup
 
     ALL = nil..nil
@@ -211,14 +213,8 @@ module ImageUtil
       Codec.encode(:sixel, self)
     end
 
-    def pretty_print(p)
-      if (image = Terminal.output_image($stdin, $stdout, self))
-        p.flush
-        p.output << image
-        p.text("", 0)
-      else
-        super
-      end
+    def inspect_image
+      self
     end
 
     def pixel_count(locations) = location_expand(locations).first.reduce(:*)

data/lib/image_util/inspectable.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module ImageUtil
+  module Inspectable
+    def pretty_print(pp)
+      image = inspect_image
+      return super unless image.is_a?(ImageUtil::Image)
+
+      rendered = ImageUtil::Terminal.output_image($stdin, $stdout, image)
+      if rendered
+        pp.flush
+        pp.output << rendered
+        pp.text("", 0)
+      else
+        super
+      end
+    rescue LoadError
+      super
+    end
+
+    def inspect_image
+      raise NotImplementedError, "including classes must implement #inspect_image"
+    end
+  end
+end

data/lib/image_util/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ImageUtil
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

data/lib/image_util.rb

@@ -11,6 +11,7 @@ module ImageUtil
   autoload :Image, "image_util/image"
   autoload :Util, "image_util/util"
   autoload :Codec, "image_util/codec"
+  autoload :Inspectable, "image_util/inspectable"
   autoload :Magic, "image_util/magic"
   autoload :Extension, "image_util/extension"
   autoload :Filter, "image_util/filter"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: image_util
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - hmdne
@@ -134,6 +134,7 @@ files:
 - lib/image_util/generator/example/rose.png
 - lib/image_util/image.rb
 - lib/image_util/image/buffer.rb
+- lib/image_util/inspectable.rb
 - lib/image_util/magic.rb
 - lib/image_util/statistic.rb
 - lib/image_util/statistic/colors.rb