terminal_rb 1.0.5 → 1.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dd88e0e1f5665c57303b6540930bb88bc7fc7ba37341161593c47641d83aee5a
-  data.tar.gz: adde7fd25392299f1bc967d6537fd25fb94016fcfed76812a99c07ef45604765
+  metadata.gz: 8f2f93f672f13936c9415cf3a474533df0f5785da3272f3482a02842a0607917
+  data.tar.gz: 52a1498c80085ea7667b7641416f406ae8694e02505a0c3201efd5f150f8d986
 SHA512:
-  metadata.gz: 3f487a373e5c05c61ef3c8433db0be643ac2cbd590859d67c2cdecbf62f6c91002d8c2ce19f6895f20e78531e2608ddb2a43491f87fea58c519f133df62070bf
-  data.tar.gz: 6db6da10522f8d94e5e1ff964529b0e2a022618c7edae701ffc89ce9bbdfb4ba5942d288b276112dff718e521d43d4f37736acf1be67049821a3abeabf18e39b
+  metadata.gz: 41cfbe3e34fa3db0af51674dc0f70f32dd08fb20d2b3a1040eff2834c65440f917f2ecea021500037658fbcf613373148c8399fdb29b7ea987916e71c570a65d
+  data.tar.gz: b6485ac5e2a9ba17ec72ffadc94cad6f5348ab846f885d12e9a68a338c15baeaa0d564ce1e1a4d2f946505887782e02dfd7221fc03e60bd3e7bb40afb88b47a1

data/README.md

@@ -1,10 +1,10 @@
-# Terminal.rb v1.0.5
+# Terminal.rb v1.0.6
 
 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.6/Terminal)
 
 ## Features
 

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).
       #
@@ -122,11 +122,11 @@ 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
@@ -168,9 +168,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
@@ -361,7 +361,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 +396,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 +449,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 +472,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 +520,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 +563,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,

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

@@ -84,6 +84,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 } })

data/lib/terminal/text/formatter.rb

@@ -32,8 +32,8 @@ module Terminal
       #   # => [["Hello", 5]]
       #
       # @param (see #initialize)
-      # @param with_size [true, false] when +true+,
-      #   return +[line, width]+ pairs instead of plain strings
+      # @param with_size [true, false] when `true`,
+      #   return `[line, width]` pairs instead of plain strings
       # @param (see #lines_with_size)
       # @return (see #lines_with_size)
       def self.[](
@@ -86,17 +86,23 @@ module Terminal
       # @param ansi [true, false] recognize ANSI escape codes
       # @param bbcode [true, false] process BBCode markup
       # @param spaces [true, false] preserve whitespace;
-      #   when +false+ leading/trailing spaces and multiple spaces are
+      #   when `false` leading/trailing spaces and multiple spaces are
       #   collapsed
       # @param eol [true, false] preserve line endings;
-      #   when +false+ newlines are treated as spaces
+      #   when `false` newlines are treated as spaces
       def initialize(*str, ansi: true, bbcode: true, spaces: true, eol: true)
         @lex = []
         return if str.empty?
         ansi ? _generate_ansi(str, bbcode) : _generate(str, bbcode)
         return if @lex.empty?
+        @keep_paragraph = true
         @lex = _ignore_whitespace unless spaces
-        @lex = _ignore_newline unless eol
+        case eol
+        when false, nil
+          @lex = _ignore_newline
+        when :no_paragraph
+          @keep_paragraph = false
+        end
       end
 
       # Word-wrap and return lines with their display widths.
@@ -106,10 +112,10 @@ module Terminal
       #   fmt.lines_with_size(width: 5)
       #   # => [["Hello", 5], ["World", 5]]
       #
-      # @param width [Integer, nil] maximum line width in columns;
-      #   +nil+ returns unwrapped lines
+      # @param width [#to_i, nil] maximum line width in columns;
+      #   `nil` returns unwrapped lines
       # @return [Array<String, Integer>] pairs of
-      #   +[line_text, display_width]+
+      #   `[line_text, display_width]`
       # @raise (see #format)
       def lines_with_size(width: nil)
         return [] if @lex.empty?
@@ -125,9 +131,9 @@ module Terminal
       #   fmt.lines(width: 5)
       #   # => ["Hello", "World"]
       #
-      # @param width [Integer, nil] maximum line width in columns
+      # @param width [#to_i, nil] maximum line width in columns
       # @return [Array<String>]
-      # @raise [ArgumentError] if +width+ is zero or negative
+      # @raise [ArgumentError] if `width` is zero or negative
       def lines(width: nil) = lines_with_size(width:).map(&:first)
 
       # Format lines with alignment, padding, and decorations.
@@ -138,11 +144,11 @@ module Terminal
       #   # => [" Hi         "]
       #
       # @param align [Symbol, nil] text alignment:
-      #   +:left+, +:right+, +:center+, or +nil+ (no fill)
-      # @param width [Integer, nil] output line width in columns
-      # @param height [Integer, nil] number of output lines;
+      #   `:left`, `:right`, `:center`, or `nil` (no fill)
+      # @param width [#to_i, nil] output line width in columns
+      # @param height [#to_i, nil] number of output lines;
       #   negative values take lines from the end
-      # @param padding [Integer, Array, nil] CSS-style padding
+      # @param padding [#to_i, Array, nil] CSS-style padding
       #    - 1 value: all sides;
       #    - 2 values: [vertical, horizontal];
       #    - 3 values: [top, horizontal, bottom];
@@ -150,7 +156,7 @@ module Terminal
       # @param prefix [#to_s, nil] string prepended to each line
       # @param suffix [#to_s, nil] string appended to each line
       # @return [Array<String>] formatted output lines
-      # @raise [ArgumentError] if +width+ is zero or negative
+      # @raise [ArgumentError] if `width` is zero or negative
       def format(
         align: nil,
         width: nil,
@@ -226,7 +232,7 @@ module Terminal
       #   fmt = Terminal::Text::Formatter.new("short\na longer line")
       #   fmt.max_line_width # => 13
       #
-      # @return [Integer] widest line in columns, +0+ when empty
+      # @return [Integer] widest line in columns, `0` when empty
       def max_line_width
         @max_line_width ||=
           (@lex.empty? ? 0 : (@unlimited || _unlimited).max_by(&:last)[-1])
@@ -239,7 +245,7 @@ module Terminal
       #   Terminal::Text::Formatter.new('Hello World').to_s(width: 5)
       #   # => "Hello\nWorld"
       #
-      # @param width [Integer, nil] maximum line width in columns
+      # @param width [#to_i, nil] maximum line width in columns
       # @return [String]
       def to_s(width: nil) = lines(width:).join("\n")
 
@@ -298,7 +304,7 @@ module Terminal
               size -= last.size
               next add_line.call
             end
-            add_line.call if size > 0
+            add_line.call if (current != EOP) || (@keep_paragraph || size > 0)
             next
           end
 
@@ -510,7 +516,7 @@ module Terminal
       # @private
       class Space
         attr_accessor :size
-        def to_str = (' ' * @size)
+        def to_str = (@size == 1 ? ' ' : ' ' * @size)
         def initialize = (@size = 1)
         def inc = (@size += 1)
         def inspect = @size == 1 ? '<Space>' : "<Space #{@size}>"
@@ -568,7 +574,7 @@ module Terminal
         class << self
           attr_reader :to_str, :size, :inspect
         end
-        @to_str = "\e[m"
+        @to_str = Ansi::RESET
         @size = 0
         @inspect = '<CsiEnd>'
       end
@@ -584,11 +590,12 @@ module Terminal
 
       ENCODING = Encoding::UTF_8
 
-      SPACE_CACHE =
-        Hash
-          .new { |h, s| h[s] = s < 1 ? '' : ' ' * s }
-          .compare_by_identity
-          .freeze
+      space_cache =
+        Hash.new { |h, s| h[s] = s < 1 ? '' : ' ' * s }.compare_by_identity
+      space_cache[0]
+      space_cache[1]
+      space_cache[2]
+      SPACE_CACHE = space_cache.freeze
 
       SCAN_REGEX =
         /\G(?:

data/lib/terminal/text.rb

@@ -28,7 +28,7 @@ module Terminal
       #   Terminal::Text.ambiguous_char_width     # => 1
       #   Terminal::Text.ambiguous_char_width = 2 # for CJK terminals
       #
-      # @return [Integer] default: +1+
+      # @return [Integer] default: `1`
       attr_accessor :ambiguous_char_width
 
       # Calculate the display width of a string in terminal columns.

data/lib/terminal/version.rb

@@ -2,5 +2,5 @@
 
 module Terminal
   # The version number of the gem.
-  VERSION = '1.0.5'
+  VERSION = '1.0.6'
 end

data/lib/terminal.rb

@@ -30,32 +30,32 @@ module Terminal
     # Detect the terminal emulator application.
     #
     # Known applications:
-    # +:alacritty+,
-    # +:amiga+,
-    # +:code_edit+,
-    # +:dg_unix+,
-    # +:docker+,
-    # +:fluent+,
-    # +:hpterm+,
-    # +:hyper+,
-    # +:iterm+,
-    # +:kitty+,
-    # +:macos+,
-    # +:mintty+,
-    # +:ms_terminal+,
-    # +:ncr260+,
-    # +:nsterm+,
-    # +:terminator+,
-    # +:terminology+,
-    # +:termite+,
-    # +:vscode+,
-    # +:vt100+,
-    # +:warp+,
-    # +:wyse+,
-    # +:xnuppc+
+    # `:alacritty`,
+    # `:amiga`,
+    # `:code_edit`,
+    # `:dg_unix`,
+    # `:docker`,
+    # `:fluent`,
+    # `:hpterm`,
+    # `:hyper`,
+    # `:iterm`,
+    # `:kitty`,
+    # `:macos`,
+    # `:mintty`,
+    # `:ms_terminal`,
+    # `:ncr260`,
+    # `:nsterm`,
+    # `:terminator`,
+    # `:terminology`,
+    # `:termite`,
+    # `:vscode`,
+    # `:vt100`,
+    # `:warp`,
+    # `:wyse`,
+    # `:xnuppc`
     #
-    # Any unrecognized +TERM_PROGRAM+ value is converted to a sanitized
-    # symbol. Returns +nil+ when no terminal can be identified.
+    # Any unrecognized `TERM_PROGRAM` value is converted to a sanitized
+    # symbol. Returns `nil` when no terminal can be identified.
     #
     # @example
     #   Terminal.application # => :kitty
@@ -77,7 +77,7 @@ module Terminal
     #   @param cmd [Array<String>] command and arguments
     #   @param options [Hash] options passed to the shell runner
     #   @return [Array<Process::Status, Array<String>, Array<String>>]
-    #     +[status, stdout_lines, stderr_lines]+
+    #     `[status, stdout_lines, stderr_lines]`
     #   @example
     #     status, output, error = Terminal.sh('echo', 'hello')
     #     output # => ["hello\n"]
@@ -88,7 +88,7 @@ module Terminal
     #   @param options [Hash] options passed to the shell runner
     #   @yield [line, type] called for each output line
     #   @yieldparam line [String] the output line
-    #   @yieldparam type [Symbol] +:output+ or +:error+
+    #   @yieldparam type [Symbol] `:output` or `:error`
     #   @return [Process::Status] the exit status
     #   @example
     #     Terminal.sh('make') do |line, type|

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: terminal_rb
 version: !ruby/object:Gem::Version
-  version: 1.0.5
+  version: 1.0.6
 platform: ruby
 authors:
 - Mike Blumtritt
@@ -60,13 +60,13 @@ metadata:
   yard.run: yard
   source_code_uri: https://codeberg.org/mblumtritt/Terminal.rb
   bug_tracker_uri: https://codeberg.org/mblumtritt/Terminal.rb/issues
-  documentation_uri: https://rubydoc.info/gems/terminal_rb/1.0.5
+  documentation_uri: https://rubydoc.info/gems/terminal_rb/1.0.6
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
       version: '3.4'
 required_rubygems_version: !ruby/object:Gem::Requirement
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.13
+rubygems_version: 4.0.15
 specification_version: 4
 summary: Fast terminal access with ANSI, CSIu, mouse events, BBCode, word-wise line
   break support and much more.