terminal_rb 1.0.5 → 1.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dd88e0e1f5665c57303b6540930bb88bc7fc7ba37341161593c47641d83aee5a
-  data.tar.gz: adde7fd25392299f1bc967d6537fd25fb94016fcfed76812a99c07ef45604765
+  metadata.gz: 91c150887b2ab21e509a1d8da160bc89879d9750de3246a2f84ee0c87c5a3992
+  data.tar.gz: 640cc99db38489ca6ccb57f3d7605fdc199a581ff674f20cda145b189a62747c
 SHA512:
-  metadata.gz: 3f487a373e5c05c61ef3c8433db0be643ac2cbd590859d67c2cdecbf62f6c91002d8c2ce19f6895f20e78531e2608ddb2a43491f87fea58c519f133df62070bf
-  data.tar.gz: 6db6da10522f8d94e5e1ff964529b0e2a022618c7edae701ffc89ce9bbdfb4ba5942d288b276112dff718e521d43d4f37736acf1be67049821a3abeabf18e39b
+  metadata.gz: 9a2f57d900145e027ea44bad3bea885a46c37c451e31cd9c0623c0d4935022ab3eb3479a76095a094d0ed3acb91d4248c2052d7b635538cf95d540af3a2b8512
+  data.tar.gz: 17b15d64bb67d748202fe7db329565d9bce197c50c00bb6005e15483acea2461d59b11f16d9910c4092532299c49047817d9e4934d54b8e8d59f1580040d4314

data/README.md

@@ -1,10 +1,10 @@
-# Terminal.rb v1.0.5
+# Terminal.rb v1.0.8
 
 Terminal.rb supports you with input and output on your terminal. Simple [BBCode](https://en.wikipedia.org/wiki/BBCode)-like markup for attributes and coloring, word-wise line breaks, correct special key recognition and mouse event reporting enable you to implement your CLI app quickly and easily.
 
 - Gem: [rubygems.org](https://rubygems.org/gems/terminal_rb)
 - Source: [codeberg.org](https://codeberg.org/mblumtritt/Terminal.rb)
-- Help: [rubydoc.info](https://rubydoc.info/gems/terminal_rb/1.0.5/Terminal)
+- Help: [rubydoc.info](https://rubydoc.info/gems/terminal_rb/1.0.8/Terminal)
 
 ## Features
 

data/examples/key-codes.rb

@@ -6,7 +6,7 @@ Terminal.puts <<~TEXT
 
   ✅ [b bright_green]Terminal.rb[/b] — Key Codes:[/fg]
      Press any key to display it's control code and name.
-     [bright_black]([b]#{Terminal.input_mode}[/b] mode  - exit with ESC)[/fg]
+     [bright_black]([b]#{Terminal.input_mode}[/b] mode – exit with ESC)[/fg]
 
 TEXT
 

data/lib/terminal/ansi/screen_viewer.rb

@@ -52,7 +52,7 @@ module Terminal
       # Total number of lines.
       #
       # @attribute [r] line_count
-      # @return [Integer, nil] +nil+ when not already calculated
+      # @return [Integer, nil] `nil` when not already calculated
       def line_count = @buf&.size
 
       # Index of the topmost visible line.
@@ -68,7 +68,7 @@ module Terminal
 
       # Resize to the current terminal dimensions and redraw.
       #
-      # @return [self, nil] +nil+ when resize is not required
+      # @return [self, nil] `nil` when resize is not required
       def resize_to_screen = _resize(*Terminal.size)
 
       # Resize to specific dimensions (clamped to terminal bounds)
@@ -76,7 +76,7 @@ module Terminal
       #
       # @param rows [Integer] new row count
       # @param columns [Integer] new column count
-      # @return [self, nil] +nil+ when resize is not required
+      # @return [self, nil] `nil` when resize is not required
       def resize(rows, columns)
         _resize(
           rows.clamp(1, Terminal.rows),
@@ -99,7 +99,7 @@ module Terminal
 
       # Scroll to the beginning of the content.
       #
-      # @return [self, nil] +nil+ when already on begin
+      # @return [self, nil] `nil` when already on begin
       def begin
         return draw unless @buf
         return if @line_top == 0
@@ -109,7 +109,7 @@ module Terminal
 
       # Scroll to the end of the content.
       #
-      # @return [self, nil] +nil+ when already on end
+      # @return [self, nil] `nil` when already on end
       def end
         return draw unless @buf
         idx = @buf.size - @rows_visible

data/lib/terminal/ansi.rb

@@ -45,7 +45,7 @@ module Terminal
       # Generate an ANSI escape sequence from attribute names or color
       # indices.
       #
-      # Accepts symbols (`:bold`, +:red+), strings (`"bold"`, +"#ff0000"+),
+      # Accepts symbols (`:bold`, `:red`), strings (`"bold"`, `"#ff0000"`),
       # or integers for 256-color palette (0-255 foreground, 256-511
       # background, 512-767 underline color).
       #
@@ -69,9 +69,9 @@ module Terminal
             .map! do |arg|
               case arg
               when String
-                @attr_map[arg] || _invalid(arg)
+                @attr_str_map[arg] || _invalid(arg)
               when Symbol
-                @attrs_map[arg] || _invalid(arg)
+                @attr_sym_map[arg] || _invalid(arg)
               when (0..255)
                 "38;5;#{arg}"
               when (256..511)
@@ -122,17 +122,22 @@ module Terminal
       #
       # @example
       #   Terminal::Ansi.try_convert('bold red')  # => "\e[1;31m"
-      #   Terminal::Ansi.try_convert('invalid')    # => nil
+      #   Terminal::Ansi.try_convert('invalid')   # => nil
       #
       # @param attributes [#to_s] space-separated attribute names
       # @param separator [String] delimiter for splitting
-      # @return [String, nil] ANSI escape sequence, or +nil+ if any
+      # @return [String, nil] ANSI escape sequence, or `nil` if any
       #   attribute is invalid
       def try_convert(attributes, separator: ' ')
         return unless attributes
-        return if (attributes = attributes.to_s.split(separator)).empty?
-        attributes.uniq!
-        "\e[#{attributes.map! { @attr_map[it] || return }.join(';')}m"
+        cache = @convert_cache[separator]
+        hit = cache[key = attributes.to_s] and return hit
+        cache.clear if cache.size > 1024 # cache limit
+        cache[key] = unless (attributes = key.split(separator)).empty?
+          # attributes.uniq!
+          codes = attributes.map { @attr_str_map[it] || break }
+          "\e[#{codes.join(';')}m" if codes
+        end
       end
 
       # Generate rainbow-colored text using true color (24-bit) ANSI
@@ -168,9 +173,9 @@ module Terminal
 
       # Convert BBCode markup to ANSI escape codes.
       #
-      # Tags like +[bold]+ are converted to their ANSI equivalents;
-      # +[/bold]+ or +[/]+ resets. Unknown tags are left unchanged.
-      # Escape a tag with a backslash: +[\\bold]+ renders as +[bold]+.
+      # Tags like `[bold]` are converted to their ANSI equivalents;
+      # `[/bold]` or `[/]` resets. Unknown tags are left unchanged.
+      # Escape a tag with a backslash: `[\\bold]` renders as `[bold]`.
       #
       # @see .unbbcode
       # @see .plain
@@ -213,7 +218,7 @@ module Terminal
             next "[#{match}]"
           end
           next match_str if (match = match.split).empty?
-          next if match.all? { @attr_map[it] }
+          next if match.all? { @attr_str_map[it] }
           match_str
         end
       end
@@ -237,7 +242,7 @@ module Terminal
           next match_str if fc == '\\' || fc == ']'
           match = Regexp.last_match(1) or next match_str
           next match_str if (parts = match.split).empty?
-          next "[\\#{match}]" if parts.all? { @attr_map[it] }
+          next "[\\#{match}]" if parts.all? { @attr_str_map[it] }
           match_str
         end
       end
@@ -271,9 +276,9 @@ module Terminal
         attributes.all? do |arg|
           case arg
           when String
-            @attr_map[arg]
+            @attr_str_map[arg]
           when Symbol
-            @attrs_map[arg]
+            @attr_sym_map[arg]
           when (0..767)
             true
           end
@@ -361,7 +366,7 @@ module Terminal
       #   Terminal::Ansi.cursor_pos(1, 1)  # home position
       #   Terminal::Ansi.cursor_pos(10, 5) # row 10, column 5
       #
-      # @param row [Integer, nil] row number; +nil+ moves to home
+      # @param row [Integer, nil] row number; `nil` moves to home
       # @param column [Integer, nil] column number
       # @return (see .[])
       def cursor_pos(row, column = nil)
@@ -396,7 +401,7 @@ module Terminal
       # Erase part of the screen.
       #
       # @param part [Symbol] area to erase:
-      #   +:all+, +:below+, +:above+, or +:scrollback+
+      #   `:all`, `:below`, `:above`, or `:scrollback`
       # @return (see .[])
       def screen_erase(part = :all) = "\e[#{@screen_erase[part]}J"
 
@@ -449,7 +454,7 @@ module Terminal
       # Erase part of the current line.
       #
       # @param part [Symbol] area to erase:
-      #   +:all+, +:to_end+, or +:to_start+
+      #   `:all`, `:to_end`, or `:to_start`
       # @return (see .[])
       def line_erase(part = :all) = "\e[#{@line_erase[part]}K"
 
@@ -472,7 +477,7 @@ module Terminal
       # @see .link_end
       #
       # @param url [#to_s] the link URL
-      # @param params [Hash] optional link parameters (e.g., +id:+)
+      # @param params [Hash] optional link parameters (e.g., `id:`)
       # @return (see .[])
       def link_start(url, **params)
         "\e]8;#{params.map { it.join('=') }.join(':')};#{url}\a"
@@ -520,12 +525,12 @@ module Terminal
       #   Terminal.raw_write(Terminal::Ansi.progress(:error)) # error state
       #   Terminal.raw_write(Terminal::Ansi.progress(nil))    # hide
       #
-      # @param state [Symbol, Numeric, Boolean] progress state:
-      #   - +:show+ or +true+ to show, `:err`/`:error`, `:warn`/`:warning`,
-      #   +:indeterminate+, a +Numeric+ (0-100) to set percentage, or
+      # @param state [Symbol, Numeric, true, false] progress state:
+      #   - `:show` or `true` to show, `:err`/`:error`, `:warn`/`:warning`,
+      #   `:indeterminate`, a `Numeric` (0-100) to set percentage, or
       #   any other value to hide
-      # @param percent [Integer] progress percentage (0-100, used with
-      #   +:show+ state)
+      # @param percent [#to_i] progress percentage (0-100, used with
+      #   `:show` state)
       # @return (see .[])
       def progress(state, percent = 0)
         case state
@@ -563,9 +568,9 @@ module Terminal
       # @param fracd [Integer, nil] fractional denominator
       #   (must be > fracn, max 15)
       # @param vertical [Symbol, Integer, nil] vertical alignment:
-      #   +:top+, +:bottom+, +:middle+
+      #   `:top`, `:bottom`, `:middle`
       # @param horizontal [Symbol, Integer, nil] horizontal alignment:
-      #   +:left+, +:right+, +:center+
+      #   `:left`, `:right`, `:center`
       # @return (see .[])
       def scale(
         text,
@@ -625,7 +630,7 @@ module Terminal
 
     @re_bbcode = /(?:\[((?~[\[\]]))\])/
 
-    clr_map = {
+    color_map = {
       # foreground
       'black' => '30',
       'red' => '31',
@@ -684,9 +689,9 @@ module Terminal
       'on_bright_white' => '107'
     }
 
-    @colors = clr_map.keys.map!(&:to_sym).sort!.freeze
+    @colors = color_map.keys.map!(&:to_sym).sort!.freeze
 
-    attr_map = {
+    @attr_base_map = {
       'reset' => '',
       'bold' => '1',
       'faint' => '2',
@@ -743,7 +748,7 @@ module Terminal
       'dashed_underline_off' => '4:0'
     }
 
-    attr_alias = ->(t, s) { attr_map[t] = attr_map[s] }
+    attr_alias = ->(t, s) { @attr_base_map[t] = @attr_base_map[s] }
 
     # aliases:
     attr_alias['off', 'reset']
@@ -768,18 +773,18 @@ module Terminal
     attr_alias['sup', 'superscript']
     attr_alias['sub', 'subscript']
 
-    @attributes = attr_map.keys.map!(&:to_sym).sort!.freeze
+    @attributes = @attr_base_map.keys.map!(&:to_sym).sort!.freeze
 
     # shortcuts disable:
-    attr_map.keys.each do |n|
+    @attr_base_map.keys.each do |n|
       attr_alias["/#{n.delete_suffix('_off')}", n] if n.end_with?('_off')
     end
 
     # additional shortcuts disable:
     attr_alias['/', 'reset']
-    attr_map['/bg'] = clr_map['on_default']
-    attr_map['/fg'] = clr_map['default']
-    attr_map['/ul'] = clr_map['ul_default']
+    @attr_base_map['/bg'] = color_map['on_default']
+    @attr_base_map['/fg'] = color_map['default']
+    @attr_base_map['/ul'] = color_map['ul_default']
 
     attr_alias['/b', 'bold_off']
     attr_alias['/d', 'dim_off']
@@ -800,15 +805,20 @@ module Terminal
     @cbase.default = '38'
     @cbase.freeze
 
-    @attr_map =
-      Hash.new do |_, str|
-        b, v = /\A(on|ul)?_?#?([[:xdigit:]]{1,6})\z/.match(str)&.captures
+    @attr_base_map.merge!(color_map).freeze
+
+    @attr_str_map = @attr_base_map.dup
+    @attr_str_map.default_proc =
+      proc do |h, s|
+        if h.size > 1024 # cache limit
+          h.keep_if { |key, _| @attr_base_map.key?(key) }
+        end
+        b, v = /\A(on|ul)?_?#?([[:xdigit:]]{1,6})\z/.match(s)&.captures
         unless v
-          b = /\A(on|ul)?_?([a-z]{3,}[0-9]{0,3})\z/.match(str) or next
-          v = NAMED_COLORS[b[2]] or next
-          next "#{@cbase[b[1]]};#{v}"
+          b = /\A(on|ul)?_?([a-z]{3,}[0-9]{0,3})\z/.match(s) or next h[s] = nil
+          next h[s] = (v = NAMED_COLORS[b[2]]) ? "#{@cbase[b[1]]};#{v}" : nil
         end
-        case v.size
+        h[s] = case v.size
         when 1, 2
           "#{@cbase[b]};5;#{v.hex}"
         when 3
@@ -817,12 +827,12 @@ module Terminal
           "#{@cbase[b]};2;#{v[0, 2].hex};#{v[2, 2].hex};#{v[4, 2].hex}"
         end
       end
-    attr_map.merge!(clr_map).keys.sort!.each { @attr_map[it] = attr_map[it] }
-    @attr_map.freeze
 
-    @attrs_map = @attr_map.transform_keys(&:to_sym)
-    @attrs_map.default_proc = @attr_map.default_proc
-    @attrs_map.compare_by_identity.freeze
+    @attr_sym_map = @attr_base_map.transform_keys(&:to_sym)
+    @attr_sym_map.compare_by_identity
+    @attr_sym_map.default_proc = proc { |h, s| h[s] = @attr_str_map[s.to_s] }
+
+    @convert_cache = Hash.new { |h, k| h[k] = {} }
 
     @screen_erase = { below: nil, above: '1', scrollback: '3' }
     @screen_erase.default = '2'

data/lib/terminal/input/ansi.rb

@@ -6,14 +6,13 @@ module Terminal
     attr_reader :input_mode
 
     def on_key_event(mouse: false, mouse_move: false, focus: false)
-      raise('already reading key events') if (@in_recursion += 1) != 1
       return unless block_given?
-      opts = __input_option(mouse, mouse_move, focus)
+      opts = nil
       STDIN.noecho do
-        opts &&= @in.syswrite("#{opts}h") ? "#{opts}l" : nil
+        opts = __input_options(mouse, mouse_move, focus)
         while (raw = @in.getch)
           next yield(KeyEvent[raw]) if raw != "\e"
-          while String === (nc = @in.read_nonblock(1, exception: false))
+          while (nc = @in.read_nonblock(1, exception: false)).is_a?(String)
             raw << nc
           end
           next yield(KeyEvent[raw]) if raw.rindex("\e") < 2
@@ -25,13 +24,15 @@ module Terminal
       __input_error
       false
     ensure
-      @in_recursion -= 1
-      @in.syswrite(opts) if opts && @in
+      if opts
+        @in_opts.pop
+        @in&.syswrite(opts)
+      end
     end
 
     private
 
-    def __input_option(mouse, mouse_move, focus)
+    def __input_options(mouse, mouse_move, focus)
       opts = (mouse ? ['1000'] : [])
       # highlight: '1001'
       # drag: '1002'
@@ -41,7 +42,19 @@ module Terminal
       # sgr: '1006'
       # urxvt: '1015'
       # pixel: '1016'
-      "\e[?#{opts.join(';')};1006" unless opts.empty?
+      if (last = @in_opts[-1])
+        if opts.empty?
+          @in.syswrite("#{last}l")
+          return "#{last}h"
+        end
+        @in_opts << (opts = "\e[?#{opts.join(';')};1006")
+        @in.syswrite("#{last}l#{opts}h")
+        return "#{opts}l#{last}h"
+      end
+      return if opts.empty?
+      @in_opts << (opts = "\e[?#{opts.join(';')};1006")
+      @in.syswrite("#{opts}h")
+      "#{opts}l"
     end
   end
 

data/lib/terminal/input/dumb.rb

@@ -5,8 +5,7 @@ module Terminal
   module DumpInput
     def input_mode = :dumb
 
-    def on_key_event(*_)
-      raise('already reading key events') if (@in_recursion += 1) != 1
+    def on_key_event(*)
       return unless block_given?
       while (raw = STDIN.getc)
         opts = dumb_keys[raw.ord] if raw.size == 1
@@ -17,8 +16,6 @@ module Terminal
     rescue IOError, SystemCallError
       __input_error
       false
-    ensure
-      @in_recursion -= 1
     end
 
     private

data/lib/terminal/input/key_event.rb

@@ -23,8 +23,8 @@ module Terminal
   class KeyEvent
     # The key identifier.
     #
-    # @return [Symbol, String, nil] a named key like +:Enter+, +:Tab+,
-    #   +:MBLeft+ (mouse), or a character string like +"a"+; +nil+ for
+    # @return [Symbol, String, nil] a named key like `:Enter`, `:Tab`,
+    #   `:MBLeft` (mouse), or a character string like `"a"`; `nil` for
     #   unknown sequences
     attr_reader :key
 
@@ -61,8 +61,8 @@ module Terminal
 
     # Mouse position when this is a mouse event.
     #
-    # @return [Array<Integer, Integer>, nil] +[row, column]+ for mouse
-    #   events, +nil+ for keyboard events
+    # @return [Array<Integer, Integer>, nil] `[row, column]` for mouse
+    #   events, `nil` for keyboard events
     attr_reader :position
 
     # The raw input sequence as received from the terminal.
@@ -85,8 +85,8 @@ module Terminal
     # @private
     # Destructuring-friendly array representation.
     #
-    # @return [Array<String>] +[raw]+ if {#simple?}
-    # @return [Array<String, String>] +[raw, name]+ otherwise
+    # @return [Array<String>] `[raw]` if {#simple?}
+    # @return [Array<String, String>] `[raw, name]` otherwise
     def to_ary = simple? ? [@raw] : [@raw, @name]
 
     # @return [String] the event {#name}
@@ -140,7 +140,7 @@ module Terminal
           @names ||=
             (@csiu.values + @csi.values + @ss3.values)
               .uniq
-              .keep_if { Symbol === it }
+              .keep_if { it.is_a?(Symbol) }
               .sort!
         ).dup
       end

data/lib/terminal/input.rb

@@ -15,7 +15,7 @@ module Terminal
   #   Terminal.input_mode # => :csi_u
   #
   # @attribute [r] input_mode
-  # @return [Symbol] +:csi_u+, +:legacy+, +:dumb+, or +:error+
+  # @return [Symbol] `:csi_u`, `:legacy`, `:dumb`, or `:error`
 
   #
   # @!endgroup
@@ -42,8 +42,7 @@ module Terminal
   #   @param focus [true, false] enable terminal focus/unfocus events
   #   @yield [event] called for each input event
   #   @yieldparam event [KeyEvent] the parsed key event
-  #   @return [nil, false] +false+ on I/O error
-  #   @raise [RuntimeError] if already inside a key event loop
+  #   @return [nil, false] `false` on I/O error
 
   # @!method self.read_key_event
   #
@@ -53,7 +52,7 @@ module Terminal
   #     event = Terminal.read_key_event
   #     puts "You pressed: #{event.name}"
   #
-  #   @return [KeyEvent, false] the next key event, or +false+ on error
+  #   @return [KeyEvent, false] the next key event, or `false` on error
 
   #
   # @!endgroup
@@ -62,10 +61,10 @@ module Terminal
   # @private
   module Input
     def input_mode
-      @in_recursion = 0
       case @input_mode = __find_input_mode
       when :legacy, :csi_u
         @in = IO.console
+        @in_opts = []
         require_relative('input/ansi')
         extend AnsiInput
       when :dumb
@@ -105,7 +104,7 @@ module Terminal
       con = IO.console
       STDIN.noecho do
         return :legacy if con.syswrite("\e[>1u\e[?u\e[c") != 12
-        inp = +''
+        inp = ''.b
         inp << con.getch until inp.rindex('c')
         return :legacy unless inp.include?("\e[?1u")
       end

data/lib/terminal/output/ansi.rb

@@ -43,6 +43,8 @@ module Terminal
 
     def raw_write(object)
       @out.syswrite(object)
+    rescue Errno::EINTR
+      retry # fixes rare condition found on MacOS Terminal.app
     rescue IOError, SystemCallError
       __output_error(nil)
     end
@@ -84,6 +86,7 @@ module Terminal
       suffix: nil
     )
       objects.flatten!
+      return @out.puts if objects.empty?
       @out.puts(
         Text::Formatter.format(
           *objects,

data/lib/terminal/output/dumb.rb

@@ -67,13 +67,14 @@ module Terminal
       suffix: nil
     )
       objects.flatten!
+      return @out.puts if objects.empty?
       @out.puts(
         Text::Formatter.format(
           *objects,
           ansi: false,
           bbcode:,
           spaces:,
-          eol: eol,
+          eol:,
           align:,
           width:,
           height:,

data/lib/terminal/output.rb

@@ -66,7 +66,7 @@ module Terminal
     #
     #   The terminal size.
     #
-    #   @return [Array<Integer, Integer>] +[rows, columns]+
+    #   @return [Array<Integer, Integer>] `[rows, columns]`
 
     # Terminal width in columns.
     #
@@ -89,7 +89,7 @@ module Terminal
     #   Current cursor position.
     #   This is only available when ANSI is supported ({ansi?} return true).
     #
-    #   @return [Array<Integer, Integer>, nil] +[row, column]+ or +nil+ if
+    #   @return [Array<Integer, Integer>, nil] `[row, column]` or `nil` if
     #     unavailable
 
     # Whether the terminal has been resized since the last size query.
@@ -113,7 +113,7 @@ module Terminal
     #   @example
     #     Terminal << '[bold]Hello[/bold] World'
     #
-    #   @param object [#to_s, nil] the object to output; +nil+ is ignored
+    #   @param object [#to_s, nil] the object to output; `nil` is ignored
     #   @return [self]
 
     # @!method print(*objects, bbcode: true)
@@ -162,7 +162,7 @@ module Terminal
     #   processing.
     #
     #   @param object [#to_s] object to write
-    #   @return [Integer, nil] bytes written, or +nil+ on error
+    #   @return [Integer, nil] bytes written, or `nil` on error
 
     # @!method hide_cursor
     #

data/lib/terminal/rspec/helper.rb

@@ -4,9 +4,9 @@ require 'stringio'
 
 # RSpec shared context for testing code that uses Terminal.rb.
 #
-# Stubs all Terminal I/O methods and provides +stdout+, +stdin+, and
-# +stdoutstr+ test helpers. Output is captured into the +stdout+ array;
-# input is read from the +stdin+ array.
+# Stubs all Terminal I/O methods and provides `stdout`, `stdin`, and
+# `stdoutstr` test helpers. Output is captured into the `stdout` array;
+# input is read from the `stdin` array.
 #
 # @example Basic usage
 #   RSpec.describe MyClass do
@@ -22,15 +22,15 @@ require 'stringio'
 #   include_context 'with Terminal.rb', ansi: false, colors: 8,
 #     size: [40, 120]
 #
-# @param ansi [true, false] mock ANSI support (default: +true+)
+# @param ansi [true, false] mock ANSI support (default: `true`)
 # @param application [Symbol] mock terminal application
-#   (default: +:kitty+)
-# @param colors [Integer, Symbol] mock color depth; use +:true_color+
-#   for 16777216 (default: +256+)
+#   (default: `:kitty`)
+# @param colors [Integer, Symbol] mock color depth; use `:true_color`
+#   for 16777216 (default: `256`)
 # @param size [Array<Integer, Integer>] mock terminal size as
-#   +[rows, columns]+ (default: +[25, 80]+)
+#   `[rows, columns]` (default: `[25, 80]`)
 # @param pos [Array<Integer, Integer>] mock cursor position as
-#   +[row, column]+ (default: +[1, 1]+)
+#   `[row, column]` (default: `[1, 1]`)
 RSpec.shared_context 'with Terminal.rb' do |ansi: true, application: :kitty, colors: 256, size: [25, 80], pos: [1, 1]|
   let(:stdout) { StringIO.new }
   let(:stdout_lines) { stdout.string.lines(chomp: true) }

data/lib/terminal/shell.rb

@@ -77,7 +77,7 @@ module Terminal
         return unless obj
         return copy_writer(obj) if obj.respond_to?(:readpartial)
         return copy_writer(obj.to_io) if obj.respond_to?(:to_io)
-        return array_writer(obj) if Array === obj
+        return array_writer(obj) if obj.is_a?(Array)
         if obj.respond_to?(:each)
           return enum_writer(obj.enum_for(:each)) if obj.respond_to?(:enum_for)
           return enum_writer(Enumerator.new { |y| obj.each { y << it } })