term-ansicolor 1.7.2 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 45d5c44dfe80380872b30c025fbbdb6da398482fce8adf8cbdb6353d81b6ca61
-  data.tar.gz: eed4f4cb1203e4ced32f053125e668ce6e9ffcca589b177cabcb40a675cc6e14
+  metadata.gz: f94f19feae65e9ff5aa9c4f79126eca941c7f824b2aa6fcb62dad77a2ef7e6d7
+  data.tar.gz: 0a94fdc003d7876d96b10e77170987786fccfa6013da118376c6b8ccf92fd876
 SHA512:
-  metadata.gz: 85098f326b4e01c3d3e0ae17dfcf00d3b76897625d5db09de1ca7c172b140b1250b05f98578a8534caf21032f24949a8a9ab81912d2d819a85aad4024c91b097
-  data.tar.gz: 23af07f3f3652f7867adab58eb360ed8f5d2adae614508ac92877d8aa6fbfd7e5a31501eb4dcb29f3ce0971f80e22b18a8667759d6d5dc78a30ef25abfcc3e53
+  metadata.gz: 6e5742e8fb06c4cbfcdd065619cc0b0a4af060f0708facb67190833e7a5f1d95a51fc0844e2e532d9d67332d2e419944c144116f9c82b363f1c4b387deb6dc3e
+  data.tar.gz: 8114385cec7788c819cfd1b70ebb8934afd4c7fd7bf68f85f5986869c840f7992e96c426c80b3debd864309211d3ad02c736a696be38b78fed6d8eff4777bd5b

data/.all_images.yml

@@ -11,6 +11,7 @@ script: &script |-
   rake test
 
 images:
+  ruby:3.3-alpine: *script
   ruby:3.2-alpine: *script
   ruby:3.1-alpine: *script
   ruby:3.0-alpine: *script

data/.gitignore

@@ -4,5 +4,6 @@
 .rvmrc
 Gemfile.lock
 coverage
+errors.lst
 pkg
 tags

data/.tool-versions

@@ -1 +1 @@
-ruby 3.2.3
+ruby 3.3.0

data/.utilsrc

@@ -0,0 +1,26 @@
+# vim: set ft=ruby:
+
+search do
+  prune_dirs /\A(\.svn|\.git|CVS|tmp|tags|coverage|pkg)\z/
+  skip_files /(\A\.|\.sw[pon]\z|\.(log|fnm|jpg|jpeg|png|pdf|svg)\z|tags|~\z)/i
+end
+
+discover do
+  prune_dirs /\A(\.svn|\.git|CVS|tmp|tags|coverage|pkg)\z/
+  skip_files /(\A\.|\.sw[pon]\z|\.log\z|~\z)/
+  binary false
+end
+
+strip_spaces do
+  prune_dirs /\A(\..*|CVS|pkg)\z/
+  skip_files /(\A\.|\.sw[pon]\z|\.log\z|~\z)/
+end
+
+probe do
+  test_framework :"test-unit"
+end
+
+ssh_tunnel do
+  terminal_multiplexer :tmux
+end
+

data/Rakefile

@@ -15,7 +15,7 @@ GemHadar do
 
   test_dir    'tests'
   ignore      '.*.sw[pon]', 'pkg', 'Gemfile.lock', '.rvmrc', 'coverage',
-    'tags', '.bundle', '.byebug_history'
+    'tags', '.bundle', '.byebug_history', 'errors.lst'
 
   readme      'README.md'
   executables.merge Dir['bin/*'].map { |x| File.basename(x) }

data/VERSION

@@ -1 +1 @@
-1.7.2
+1.9.0

data/bin/term_colortab

@@ -15,6 +15,32 @@ def print_color(c)
   print ("%3u #{color.rgb.html} " % c).on_color(color.name).color(text.name)
 end
 
+if Term::ANSIColor.true_coloring = ENV['COLORTERM'] =~ /\A(truecolor|24bit)\z/
+
+  puts "True colors".bold, ""
+  step = 36
+  (0..255).step(step) do |g|
+    (0..255).step(step) do |r|
+      (0..255).step(step) do |b|
+        print Term::ANSIColor.on_color(Term::ANSIColor::RGBTriple.new(r, g, b)) { ' ' }
+      end
+      print ' '
+    end
+    puts
+  end
+
+  puts
+  (0..255).step(4) do |g|
+    print Term::ANSIColor.on_color(Term::ANSIColor::RGBTriple.new(g, g, g)) { ' ' }
+  end
+  puts
+  puts
+
+end
+
+Term::ANSIColor.true_coloring = false
+
+puts "256 colors".bold, ""
 for c in 0..3
   print_color c
 end

data/bin/term_display

@@ -65,13 +65,14 @@ Options are
   -a ASPECT       x:y aspect, defaults to 2.2
   -C COLS         number of columns for rendering with aspect, defaults to max
   -R ROWS         number of rows for rendering with aspect, defaults to max - 1
+  -t              use true colors
   -h              this help
 
 EOT
   exit rc
 end
 
-opts = go 'hm:g:s:a:C:R:'
+opts = go 'hm:g:s:a:C:R:t'
 opts['h'] and usage
 filename = ARGV.shift or usage 1
 metric   = Term::ANSIColor::RGBColorMetrics.metric(opts['m'] || 'CIELab')
@@ -84,8 +85,9 @@ opts['R'] ||= [ Tins::Terminal.rows - 1, 0 ].max
 file = provide_ppm_file(filename, opts)
 ppm = Term::ANSIColor::PPMReader.new(
   file,
-  :metric => metric,
-  :gray   => gray
+  metric:        metric,
+  gray:          gray,
+  true_coloring: opts[?t]
 )
 
 puts ppm

data/bin/term_mandel

@@ -15,16 +15,12 @@ def draw_set(rx, ry)
   sx = (rx.end - rx.begin).abs / @width
   sy = (ry.end - ry.begin).abs / @height
 
-  ac = Term::ANSIColor
-  color =
-    ac::Attribute[ color_random ].gradient_to(ac::Attribute[ color_random ], :steps => 16) +
-    ac::Attribute[ color_random ].gradient_to(ac::Attribute[ color_random ], :steps => 16) +
-    ac::Attribute[ color_random ].gradient_to(ac::Attribute[ color_random ], :steps => 16) +
-    ac::Attribute[ color_random ].gradient_to(ac::Attribute[ color_random ], :steps => 16) +
-    ac::Attribute[ color_random ].gradient_to(ac::Attribute[ color_random ], :steps => 16) +
-    ac::Attribute[ color_random ].gradient_to(ac::Attribute[ color_random ], :steps => 16) +
-    ac::Attribute[ color_random ].gradient_to(ac::Attribute[ color_random ], :steps => 16) +
-    ac::Attribute[ color_random ].gradient_to(ac::Attribute['#000'], :steps => 16)
+  ac    = Term::ANSIColor
+  steps = 16
+  color = (5.times.map { color_random } + [ 0, 0, 0 ]).map { ac::Attribute[_1] }
+  color = color[1..-1].inject(color[0,1]) { |c, x|
+    c + c.last.gradient_to(x, steps:)
+  }
   iters = color.size - 2
 
   text = ''
@@ -44,9 +40,11 @@ def draw_set(rx, ry)
   puts text
 end
 
-opts = go 'x:y:'
+opts = go 'x:y'
 
-rx = opts['x'].full? { |r| Range.new(*(r.split('..', 2).map(&:to_f))) } || (-2.0..1.0)
-ry = opts['y'].full? { |r| Range.new(*(r.split('..', 2).map(&:to_f))) } || (-1.0..1.0)
+Term::ANSIColor.true_coloring = ENV['COLORTERM'] =~ /\A(truecolor|24bit)\z/
+
+rx = opts[?x].full? { |r| Range.new(*(r.split('..', 2).map(&:to_f))) } || (-2.0..1.0)
+ry = opts[?y].full? { |r| Range.new(*(r.split('..', 2).map(&:to_f))) } || (-1.0..1.0)
 
 draw_set rx, ry

data/bin/term_snow

@@ -9,23 +9,23 @@ class SnowFlake
   extend Term::ANSIColor
 
   def initialize(x, y, shape: %w[ ❄ ❅ ❆ • • · · . . ])
-     @x, @y, @shape = x, y, Array(shape).sample
-     @shape.size != 1 and raise ArgumentError, "#@shape needs to be a character"
-   end
+    @x, @y, @shape = x, y, Array(shape).sample
+    @shape.size != 1 and raise ArgumentError, "#@shape needs to be a character"
+  end
 
-   attr_accessor :x
+  attr_accessor :x
 
-   attr_accessor :y
+  attr_accessor :y
 
-   attr_accessor :shape
+  attr_accessor :shape
 
-   def to_s
-     move_to(y, x) { white on_black @shape }
-   end
+  def to_s
+    move_to(y, x) { white on_black @shape }
+  end
 end
 
-opts = go 'n:s:'
-new_snowflakes  = (opts[?n] || 3).to_i
+opts           = go 'n:s:'
+new_snowflakes = (opts[?n] || 3).to_i
 sleep_duration = (opts[?s] || 0.2).to_f
 
 flakes = []
@@ -51,7 +51,7 @@ loop do
         sf.x = SnowFlake.terminal_columns
       end
     else
-      sf.x == 1
+      sf.x += 1
       if sf.x > SnowFlake.terminal_columns
         sf.x = 1
       end
@@ -64,7 +64,7 @@ loop do
     flakes << SnowFlake.new(rand(1..SnowFlake.terminal_columns), 1)
   end
 
-  print *flakes
+  print(*flakes)
 
   sleep sleep_duration
 rescue Interrupt

data/examples/example.rb

@@ -81,6 +81,34 @@ print red { bold { "All supported attributes = " } },
 print "Send symbols to strings:".send(:red).send(:bold), "\n"
 print symbols[12, 8].map { |c| c.to_s.send(c) } * '', "\n\n"
 
+print red { bold { "Use true colors if supported" } }, "\n"
+
+colors = Term::ANSIColor::Attribute['#ff0000'].gradient_to(
+  Term::ANSIColor::Attribute['#ffff00'],
+  true_coloring: true,
+  step: 16
+)
+colors += Term::ANSIColor::Attribute[colors.last].gradient_to(
+  Term::ANSIColor::Attribute['#00ff00'],
+  true_coloring: true,
+  step: 16
+)
+colors += Term::ANSIColor::Attribute[colors.last].gradient_to(
+  Term::ANSIColor::Attribute['#00ffff'],
+  true_coloring: true,
+  step: 16
+)
+colors += Term::ANSIColor::Attribute[colors.last].gradient_to(
+  Term::ANSIColor::Attribute['#0000ff'],
+  true_coloring: true,
+  step: 16
+)
+
+chars = %w[ ⣾ ⣽ ⣻ ⢿ ⡿ ⣟ ⣯ ⣷ ]
+colors.each_with_index { |c, i| print c.apply { chars[i % chars.size] } }
+puts
+puts
+
 print red { bold { "Make strings monochromatic again:" } }, "\n"
 print [
     "red".red,
@@ -88,3 +116,5 @@ print [
     uncolored { "not red anymore".red },
     uncolored("not red anymore".red)
   ].map { |x| x + "\n" } * ''
+
+puts "Use the " + "Source".hyperlink("https://github.com/flori/term-ansicolor") + ", Luke!"

data/lib/term/ansicolor/attribute.rb

@@ -30,15 +30,28 @@ module Term
         end
       end
 
-      def self.[](name)
-        case
-        when self === name                              then name
-        when Array === name                             then nearest_rgb_color name
-        when name.respond_to?(:to_rgb_triple)           then nearest_rgb_color(name.to_rgb_triple.to_a)
-        when name.to_s =~ /\A(on_)?(\d+)\z/             then get "#$1color#$2"
-        when name.to_s =~ /\A#([0-9a-f]{3}){1,2}\z/i    then nearest_rgb_color name
-        when name.to_s =~ /\Aon_#([0-9a-f]{3}){1,2}\z/i then nearest_rgb_on_color name
-        else                                            get name
+      def self.[](name, true_coloring: false)
+        true_coloring ||= Term::ANSIColor.true_coloring?
+        if true_coloring
+          case
+          when self === name                              then name
+          when Array === name                             then true_color name
+          when name.respond_to?(:to_rgb_triple)           then true_color(name.to_rgb_triple.to_a)
+          when name.to_s =~ /\A(on_)?(\d+)\z/             then get "#$1color#$2"
+          when name.to_s =~ /\A#([0-9a-f]{3}){1,2}\z/i    then true_color name
+          when name.to_s =~ /\Aon_#([0-9a-f]{3}){1,2}\z/i then on_true_color name
+          else                                            get name
+          end
+        else
+          case
+          when self === name                              then name
+          when Array === name                             then nearest_rgb_color name
+          when name.respond_to?(:to_rgb_triple)           then nearest_rgb_color(name.to_rgb_triple.to_a)
+          when name.to_s =~ /\A(on_)?(\d+)\z/             then get "#$1color#$2"
+          when name.to_s =~ /\A#([0-9a-f]{3}){1,2}\z/i    then nearest_rgb_color name
+          when name.to_s =~ /\Aon_#([0-9a-f]{3}){1,2}\z/i then nearest_rgb_on_color name
+          else                                            get name
+          end
         end
       end
 
@@ -70,10 +83,24 @@ module Term
         colors.select(&:background?).min_by { |c| c.distance_to(rgb, options) }
       end
 
+      def self.true_color(color, options = {})
+        rgb = RGBTriple[color]
+        new(:true, "", { true_color: rgb, background: false })
+      end
+
+      def self.on_true_color(color, options = {})
+        rgb = RGBTriple[color]
+        new(:on_true, "", { true_color: rgb, background: true })
+      end
+
       def initialize(name, code, options = {})
-        @name = name.to_sym
-        @code = code.to_s
-        if html = options[:html]
+        @name       = name.to_sym
+        @background = @name.start_with?('on_')
+        @code       = code.to_s
+        if rgb = options[:true_color]
+          @true_color = true
+          @rgb = rgb
+        elsif html = options[:html]
           @rgb = RGBTriple.from_html(html)
         elsif !options.empty?
           @rgb = RGBTriple.from_hash(options)
@@ -85,7 +112,9 @@ module Term
       attr_reader :name
 
       def code
-        if rgb_color?
+        if true_color?
+          background? ? "48;2;#{@rgb.to_a * ?;}" : "38;2;#{@rgb.to_a * ?;}"
+        elsif rgb_color?
           background? ? "48;5;#{@code}" : "38;5;#{@code}"
         else
           @code
@@ -97,13 +126,19 @@ module Term
       end
 
       def background?
-        @name.to_s.start_with?('on_')
+        !!@background
       end
 
+      attr_writer :background
+
       attr_reader :rgb
 
       def rgb_color?
-        !!@rgb
+        !!@rgb && !@true_color
+      end
+
+      def true_color?
+        !!(@rgb && @true_color)
       end
 
       def gray?
@@ -127,11 +162,16 @@ module Term
 
       def gradient_to(other, options = {})
         if our_rgb = to_rgb_triple and
-          other.respond_to?(:to_rgb_triple) and
-          other_rgb = other.to_rgb_triple
-        then
+            other.respond_to?(:to_rgb_triple) and
+            other_rgb = other.to_rgb_triple
+          then
+          true_coloring = options[:true_coloring] || Term::ANSIColor.true_coloring?
           our_rgb.gradient_to(other_rgb, options).map do |rgb_triple|
-            self.class.nearest_rgb_color(rgb_triple, options)
+            if true_coloring
+              self.class.true_color(rgb_triple, options)
+            else
+              self.class.nearest_rgb_color(rgb_triple, options)
+            end
           end
         else
           []

data/lib/term/ansicolor/hyperlink.rb

@@ -0,0 +1,34 @@
+require 'tins/terminal'
+
+module Term
+  module ANSIColor
+    module Hyperlink
+      def hyperlink(link, string = nil, id: nil, as_link: false)
+        block_given? && string != nil && !respond_to?(:to_str) and
+          raise ArgumentError,
+          "Require either the string argument or a block argument"
+        if link.nil?
+          link = ''
+        end
+        if as_link && !link.empty?
+          string ||= link
+        end
+        result = ''
+        if Term::ANSIColor.coloring?
+          result = "\e]8;#{"id=#{id}" unless id.nil?};" << link.to_str << "\e\\"
+        end
+        if block_given?
+          result << yield.to_s
+        elsif string.respond_to?(:to_str)
+          result << string.to_str
+        elsif respond_to?(:to_str)
+          result << to_str
+        else
+          return result # only switch on
+        end
+        result << "\e]8;;\e\\" if Term::ANSIColor.coloring?
+        result
+      end
+    end
+  end
+end

data/lib/term/ansicolor/ppm_reader.rb

@@ -4,9 +4,10 @@ module Term
       include Term::ANSIColor
 
       def initialize(io, options = {})
-        @io      = io
-        @options = options
-        @buffer  = ''
+        @io            = io
+        @options       = options
+        @buffer        = ''
+        @true_coloring = options[:true_coloring]
       end
 
       def reset_io
@@ -34,7 +35,11 @@ module Term
           last_pixel = nil
           for pixel in row
             if pixel != last_pixel
-              color = Attribute.nearest_rgb_color(pixel, @options)
+              color = if @true_coloring
+                        Attribute.true_color(pixel, @options)
+                      else
+                        Attribute.nearest_rgb_color(pixel, @options)
+                      end
               result << on_color(color)
               last_pixel = pixel
             end

data/lib/term/ansicolor/version.rb

@@ -1,6 +1,6 @@
 module Term::ANSIColor
   # Term::ANSIColor version
-  VERSION         = '1.7.2'
+  VERSION         = '1.9.0'
   VERSION_ARRAY   = VERSION.split('.').map(&:to_i) # :nodoc:
   VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
   VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:

data/lib/term/ansicolor.rb

@@ -15,8 +15,9 @@ module Term
     require 'term/ansicolor/attribute/intense_color8'
     require 'term/ansicolor/attribute/color256'
     require 'term/ansicolor/movement'
-
     include Term::ANSIColor::Movement
+    require 'term/ansicolor/hyperlink'
+    include Term::ANSIColor::Hyperlink
 
     # :stopdoc:
     ATTRIBUTE_NAMES = Attribute.named_attributes.map(&:name)
@@ -34,6 +35,7 @@ module Term
         !String.instance_methods(false).map(&:to_sym).include?(:clear)
       end
     end
+
     # Returns true, if the coloring function of this module
     # is switched on, false otherwise.
     def self.coloring?
@@ -42,12 +44,26 @@ module Term
 
     # Turns the coloring on or off globally, so you can easily do
     # this for example:
-    #  Term::ANSIColor::coloring = STDOUT.isatty
+    #   Term::ANSIColor::coloring = STDOUT.isatty
     def self.coloring=(val)
-      @coloring = val
+      @coloring = !!val
     end
     self.coloring = true
 
+    # Returns true, if the tue coloring mode of this module is switched on,
+    # false otherwise.
+    def self.true_coloring?
+      @true_coloring
+    end
+
+    # Turns the true coloring mode on or off globally, that will display 24-bit
+    # colors if your terminal supports it:
+    #  Term::ANSIColor::true_coloring = ENV['COLORTERM'] =~ /\A(truecolor|24bit)\z/
+    def self.true_coloring=(val)
+      @true_coloring = !!val
+    end
+    self.true_coloring = false
+
     def self.create_color_method(color_name, color_value)
       module_eval <<-EOT
         def #{color_name}(string = nil, &block)
@@ -63,10 +79,10 @@ module Term
 
     # Regular expression that is used to scan for ANSI-Attributes while
     # uncoloring strings.
-    COLORED_REGEXP = /\e\[(?:(?:[349]|10)[0-7]|[0-9]|[34]8;5;\d{1,3})?m/
+    COLORED_REGEXP = /\e\[(?:(?:[349]|10)[0-7]|[0-9]|[34]8;(5;\d{1,3}|2;\d{1,3}(;\d{1,3}){2}))?m/
 
-    # Returns an uncolored version of the string, that is all
-    # ANSI-Attributes are stripped from the string.
+    # Returns an uncolored version of the string, that is all ANSI-Attributes
+    # are stripped from the string.
     def uncolor(string = nil) # :yields:
       if block_given?
         yield.to_str.gsub(COLORED_REGEXP, '')
@@ -95,7 +111,7 @@ module Term
       elsif respond_to?(:to_str)
         result << to_str
       else
-        return result #only switch on
+        return result # only switch on
       end
       result << "\e[0m" if Term::ANSIColor.coloring?
       result.extend(Term::ANSIColor)
@@ -103,7 +119,9 @@ module Term
 
     def on_color(name, string = nil, &block)
       attribute = Attribute[name] or raise ArgumentError, "unknown attribute #{name.inspect}"
-      color("on_#{attribute.name}", string, &block)
+      attribute = attribute.dup
+      attribute.background = true
+      color(attribute, string, &block)
     end
 
     class << self

data/term-ansicolor.gemspec

@@ -1,31 +1,31 @@
 # -*- encoding: utf-8 -*-
-# stub: term-ansicolor 1.7.2 ruby lib
+# stub: term-ansicolor 1.9.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "term-ansicolor".freeze
-  s.version = "1.7.2"
+  s.version = "1.9.0".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
   s.authors = ["Florian Frank".freeze]
-  s.date = "2024-03-15"
+  s.date = "2024-06-18"
   s.description = "This library uses ANSI escape sequences to control the attributes of terminal output".freeze
   s.email = "flori@ping.de".freeze
   s.executables = ["term_cdiff".freeze, "term_colortab".freeze, "term_decolor".freeze, "term_display".freeze, "term_mandel".freeze, "term_snow".freeze]
-  s.extra_rdoc_files = ["README.md".freeze, "lib/term/ansicolor.rb".freeze, "lib/term/ansicolor/attribute.rb".freeze, "lib/term/ansicolor/attribute/color256.rb".freeze, "lib/term/ansicolor/attribute/color8.rb".freeze, "lib/term/ansicolor/attribute/intense_color8.rb".freeze, "lib/term/ansicolor/attribute/text.rb".freeze, "lib/term/ansicolor/hsl_triple.rb".freeze, "lib/term/ansicolor/movement.rb".freeze, "lib/term/ansicolor/ppm_reader.rb".freeze, "lib/term/ansicolor/rgb_color_metrics.rb".freeze, "lib/term/ansicolor/rgb_triple.rb".freeze, "lib/term/ansicolor/version.rb".freeze]
-  s.files = [".all_images.yml".freeze, ".gitignore".freeze, ".tool-versions".freeze, "CHANGES".freeze, "COPYING".freeze, "Gemfile".freeze, "README.md".freeze, "Rakefile".freeze, "VERSION".freeze, "bin/term_cdiff".freeze, "bin/term_colortab".freeze, "bin/term_decolor".freeze, "bin/term_display".freeze, "bin/term_mandel".freeze, "bin/term_snow".freeze, "examples/example.rb".freeze, "examples/lambda-red-plain.ppm".freeze, "examples/lambda-red.png".freeze, "examples/lambda-red.ppm".freeze, "lib/term/ansicolor.rb".freeze, "lib/term/ansicolor/.keep".freeze, "lib/term/ansicolor/attribute.rb".freeze, "lib/term/ansicolor/attribute/color256.rb".freeze, "lib/term/ansicolor/attribute/color8.rb".freeze, "lib/term/ansicolor/attribute/intense_color8.rb".freeze, "lib/term/ansicolor/attribute/text.rb".freeze, "lib/term/ansicolor/hsl_triple.rb".freeze, "lib/term/ansicolor/movement.rb".freeze, "lib/term/ansicolor/ppm_reader.rb".freeze, "lib/term/ansicolor/rgb_color_metrics.rb".freeze, "lib/term/ansicolor/rgb_triple.rb".freeze, "lib/term/ansicolor/version.rb".freeze, "term-ansicolor.gemspec".freeze, "tests/ansicolor_test.rb".freeze, "tests/attribute_test.rb".freeze, "tests/hsl_triple_test.rb".freeze, "tests/ppm_reader_test.rb".freeze, "tests/rgb_color_metrics_test.rb".freeze, "tests/rgb_triple_test.rb".freeze, "tests/test_helper.rb".freeze]
+  s.extra_rdoc_files = ["README.md".freeze, "lib/term/ansicolor.rb".freeze, "lib/term/ansicolor/attribute.rb".freeze, "lib/term/ansicolor/attribute/color256.rb".freeze, "lib/term/ansicolor/attribute/color8.rb".freeze, "lib/term/ansicolor/attribute/intense_color8.rb".freeze, "lib/term/ansicolor/attribute/text.rb".freeze, "lib/term/ansicolor/hsl_triple.rb".freeze, "lib/term/ansicolor/hyperlink.rb".freeze, "lib/term/ansicolor/movement.rb".freeze, "lib/term/ansicolor/ppm_reader.rb".freeze, "lib/term/ansicolor/rgb_color_metrics.rb".freeze, "lib/term/ansicolor/rgb_triple.rb".freeze, "lib/term/ansicolor/version.rb".freeze]
+  s.files = [".all_images.yml".freeze, ".gitignore".freeze, ".tool-versions".freeze, ".utilsrc".freeze, "CHANGES".freeze, "COPYING".freeze, "Gemfile".freeze, "README.md".freeze, "Rakefile".freeze, "VERSION".freeze, "bin/term_cdiff".freeze, "bin/term_colortab".freeze, "bin/term_decolor".freeze, "bin/term_display".freeze, "bin/term_mandel".freeze, "bin/term_snow".freeze, "examples/example.rb".freeze, "examples/lambda-red-plain.ppm".freeze, "examples/lambda-red.png".freeze, "examples/lambda-red.ppm".freeze, "lib/term/ansicolor.rb".freeze, "lib/term/ansicolor/.keep".freeze, "lib/term/ansicolor/attribute.rb".freeze, "lib/term/ansicolor/attribute/color256.rb".freeze, "lib/term/ansicolor/attribute/color8.rb".freeze, "lib/term/ansicolor/attribute/intense_color8.rb".freeze, "lib/term/ansicolor/attribute/text.rb".freeze, "lib/term/ansicolor/hsl_triple.rb".freeze, "lib/term/ansicolor/hyperlink.rb".freeze, "lib/term/ansicolor/movement.rb".freeze, "lib/term/ansicolor/ppm_reader.rb".freeze, "lib/term/ansicolor/rgb_color_metrics.rb".freeze, "lib/term/ansicolor/rgb_triple.rb".freeze, "lib/term/ansicolor/version.rb".freeze, "term-ansicolor.gemspec".freeze, "tests/ansicolor_test.rb".freeze, "tests/attribute_test.rb".freeze, "tests/hsl_triple_test.rb".freeze, "tests/hyperlink_test.rb".freeze, "tests/ppm_reader_test.rb".freeze, "tests/rgb_color_metrics_test.rb".freeze, "tests/rgb_triple_test.rb".freeze, "tests/test_helper.rb".freeze]
   s.homepage = "https://github.com/flori/term-ansicolor".freeze
   s.licenses = ["Apache-2.0".freeze]
   s.rdoc_options = ["--title".freeze, "Term-ansicolor - Ruby library that colors strings using ANSI escape sequences".freeze, "--main".freeze, "README.md".freeze]
-  s.rubygems_version = "3.4.19".freeze
+  s.rubygems_version = "3.5.3".freeze
   s.summary = "Ruby library that colors strings using ANSI escape sequences".freeze
-  s.test_files = ["tests/ansicolor_test.rb".freeze, "tests/attribute_test.rb".freeze, "tests/hsl_triple_test.rb".freeze, "tests/ppm_reader_test.rb".freeze, "tests/rgb_color_metrics_test.rb".freeze, "tests/rgb_triple_test.rb".freeze, "tests/test_helper.rb".freeze]
+  s.test_files = ["tests/ansicolor_test.rb".freeze, "tests/attribute_test.rb".freeze, "tests/hsl_triple_test.rb".freeze, "tests/hyperlink_test.rb".freeze, "tests/ppm_reader_test.rb".freeze, "tests/rgb_color_metrics_test.rb".freeze, "tests/rgb_triple_test.rb".freeze, "tests/test_helper.rb".freeze]
 
   s.specification_version = 4
 
-  s.add_development_dependency(%q<gem_hadar>.freeze, ["~> 1.14.0"])
-  s.add_development_dependency(%q<simplecov>.freeze, [">= 0"])
-  s.add_development_dependency(%q<test-unit>.freeze, [">= 0"])
-  s.add_development_dependency(%q<utils>.freeze, [">= 0"])
-  s.add_runtime_dependency(%q<tins>.freeze, ["~> 1.0"])
+  s.add_development_dependency(%q<gem_hadar>.freeze, ["~> 1.15.0".freeze])
+  s.add_development_dependency(%q<simplecov>.freeze, [">= 0".freeze])
+  s.add_development_dependency(%q<test-unit>.freeze, [">= 0".freeze])
+  s.add_development_dependency(%q<utils>.freeze, [">= 0".freeze])
+  s.add_runtime_dependency(%q<tins>.freeze, ["~> 1.0".freeze])
 end

data/tests/ansicolor_test.rb

@@ -157,4 +157,20 @@ class ANSIColorTest < Test::Unit::TestCase
     string = Color.red(string)
     assert_kind_of Term::ANSIColor, 'new'
   end
+
+  def test_coloring
+    assert Term::ANSIColor.coloring?
+    Term::ANSIColor.coloring = false
+    assert_false Term::ANSIColor.coloring?
+  ensure
+    Term::ANSIColor.coloring = true
+  end
+
+  def test_true_coloring
+    assert_false Term::ANSIColor.true_coloring?
+    Term::ANSIColor.true_coloring = true
+    assert Term::ANSIColor.true_coloring?
+  ensure
+    Term::ANSIColor.true_coloring = false
+  end
 end

data/tests/attribute_test.rb

@@ -70,4 +70,43 @@ class AttributeTest < Test::Unit::TestCase
     assert_equal [ :color49, :color43, :color79, :color73, :color108,
       :color247, :color138, :color168, :color204 ], g2.map(&:name)
   end
+
+  def test_true_color
+    pinkish = Attribute['#f050a0', true_coloring: true]
+    assert_equal [ 240, 80, 160 ], pinkish.to_rgb_triple.to_a
+    on_pinkish = Attribute['on_#f050a0', true_coloring: true]
+    assert_equal [ 240, 80, 160 ], on_pinkish.to_rgb_triple.to_a
+    red = Attribute['9', true_coloring: true]
+    assert_equal [ 255, 0, 0 ], red.to_rgb_triple.to_a
+    red = Attribute['red', true_coloring: true]
+    assert_equal :red, red.name
+    pinkish_pinkish = Attribute[pinkish, true_coloring: true]
+    assert_equal pinkish, pinkish_pinkish
+    pinkish_pinkish = Attribute[pinkish.to_rgb_triple, true_coloring: true]
+    assert_equal pinkish.to_rgb_triple, pinkish_pinkish.to_rgb_triple
+    pinkish_pinkish = Attribute[pinkish.to_rgb_triple.to_a, true_coloring: true]
+    assert_equal pinkish.to_rgb_triple, pinkish_pinkish.to_rgb_triple
+  end
+
+  def test_true_color_gradient
+    g0 = Attribute[:blink].gradient_to Attribute['#30ffaa']
+    assert_equal [], g0
+    g1 = Attribute['#30ffaa'].gradient_to(
+      Attribute['#ff507f'],
+      :steps => 9,
+      true_coloring: true
+    )
+    assert_equal %w[
+      #00ffaf #1febaa #3ed7a5 #5dc3a0 #7caf9b #9b9b96 #ba8791 #d9738c #ff5f87
+    ], g1.map { _1.rgb.html }
+    g2 = Attribute['#30ffaa'].gradient_to(
+      Attribute['#ff507f'],
+      :steps  => 9,
+      true_coloring: true,
+      :metric => RGBColorMetrics::Euclidean
+    )
+    assert_equal %w[
+      #00ffaf #1febaa #3ed7a5 #5dc3a0 #7caf9b #9b9b96 #ba8791 #d9738c #ff5f87
+    ], g2.map { _1.rgb.html }
+  end
 end

data/tests/hyperlink_test.rb

@@ -0,0 +1,58 @@
+require 'test_helper'
+
+class HyperlinkTest < Test::Unit::TestCase
+  include Term::ANSIColor
+
+  def setup
+    @link = 'https://foo.example.com'
+  end
+
+  def test_hyperlink_switch_on
+    assert_equal(
+      "\e]8;;#@link\e\\",
+      hyperlink(@link)
+    )
+  end
+
+  def test_hyperlink_switch_off
+    assert_equal(
+      "\e]8;;\e\\",
+      hyperlink(nil)
+    )
+  end
+
+  def test_hyperlink_as_link
+    assert_equal(
+      hyperlink(@link, as_link: true),
+      "\e]8;;#@link\e\\#@link\e]8;;\e\\",
+    )
+  end
+
+  def test_hyperlink_two_args
+    assert_equal(
+      "\e]8;;#@link\e\\foo\e]8;;\e\\",
+      hyperlink(@link, 'foo')
+    )
+  end
+
+  def test_hyperlink_two_args_with_id
+    assert_equal(
+      "\e]8;id=666;#@link\e\\foo\e]8;;\e\\",
+      hyperlink(@link, 'foo', id: 666)
+    )
+  end
+
+  def test_hyperlink_block_arg
+    assert_raise(ArgumentError) { hyperlink(@link, 'bar') { 'baz' } }
+    assert_equal(
+      "\e]8;;#@link\e\\foo\e]8;;\e\\",
+      hyperlink(@link) { 'foo' }
+    )
+  end
+
+  def test_with_stringy_self
+    string = 'foo'
+    string.extend Term::ANSIColor
+    assert_equal "\e]8;;#@link\e\\foo\e]8;;\e\\", string.hyperlink(@link)
+  end
+end

data/tests/ppm_reader_test.rb

@@ -28,6 +28,14 @@ class PPMReaderTest < Test::Unit::TestCase
     end
   end
 
+  def test_rendering_ppm_with_true_colors
+    File.open(example_path('lambda-red.ppm')) do |ppm6|
+      ppm_reader = PPMReader.new(ppm6, :true_coloring => true)
+      assert_equal '5faa2b046cc3e030f86588e472683834',
+        Digest::MD5.hexdigest(ppm_reader.to_s)
+    end
+  end
+
   def test_to_a
     File.open(example_path('lambda-red.ppm')) do |ppm6|
       ppm_reader = PPMReader.new(ppm6, :gray => false)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: term-ansicolor
 version: !ruby/object:Gem::Version
-  version: 1.7.2
+  version: 1.9.0
 platform: ruby
 authors:
 - Florian Frank
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-03-15 00:00:00.000000000 Z
+date: 2024-06-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gem_hadar
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.14.0
+        version: 1.15.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.14.0
+        version: 1.15.0
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -100,6 +100,7 @@ extra_rdoc_files:
 - lib/term/ansicolor/attribute/intense_color8.rb
 - lib/term/ansicolor/attribute/text.rb
 - lib/term/ansicolor/hsl_triple.rb
+- lib/term/ansicolor/hyperlink.rb
 - lib/term/ansicolor/movement.rb
 - lib/term/ansicolor/ppm_reader.rb
 - lib/term/ansicolor/rgb_color_metrics.rb
@@ -109,6 +110,7 @@ files:
 - ".all_images.yml"
 - ".gitignore"
 - ".tool-versions"
+- ".utilsrc"
 - CHANGES
 - COPYING
 - Gemfile
@@ -133,6 +135,7 @@ files:
 - lib/term/ansicolor/attribute/intense_color8.rb
 - lib/term/ansicolor/attribute/text.rb
 - lib/term/ansicolor/hsl_triple.rb
+- lib/term/ansicolor/hyperlink.rb
 - lib/term/ansicolor/movement.rb
 - lib/term/ansicolor/ppm_reader.rb
 - lib/term/ansicolor/rgb_color_metrics.rb
@@ -142,6 +145,7 @@ files:
 - tests/ansicolor_test.rb
 - tests/attribute_test.rb
 - tests/hsl_triple_test.rb
+- tests/hyperlink_test.rb
 - tests/ppm_reader_test.rb
 - tests/rgb_color_metrics_test.rb
 - tests/rgb_triple_test.rb
@@ -169,7 +173,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
+rubygems_version: 3.5.3
 signing_key:
 specification_version: 4
 summary: Ruby library that colors strings using ANSI escape sequences
@@ -177,6 +181,7 @@ test_files:
 - tests/ansicolor_test.rb
 - tests/attribute_test.rb
 - tests/hsl_triple_test.rb
+- tests/hyperlink_test.rb
 - tests/ppm_reader_test.rb
 - tests/rgb_color_metrics_test.rb
 - tests/rgb_triple_test.rb