tty_string 0.1.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 5cf9c99684d1bffc4b5238d85a0fbddc6c228a92
-  data.tar.gz: 29daa63edffa32d87215419a32c0f3eb06511648
+SHA256:
+  metadata.gz: b638ef2c66276f621f7ae5620e25af1ccfb1d79f634202aa59935e181baf53e2
+  data.tar.gz: ecce132aa8201f22a69c2c2a201143bb1f2775abf4ea0785553592a2f2615640
 SHA512:
-  metadata.gz: c0184931cc63e842676e467f9cf1e3262f97a3e191f690bc100e075f389cdd54e3d94d09295da58a2e23a97b9f27836cd3eaf6772a67079184b1fc8030cd05ac
-  data.tar.gz: 5804b7bcf35cb28a18feeb330662cac534b307badd16f2ebd5e138a772fcd8cf4743702181d33a208bf6b20f8d03013ac0f77fae7e1faba4eb1745bbb2687296
+  metadata.gz: 5799b2b9a14ecdb5d86cfd8d6af0d10f896c20de36dfed2801756172fe73afebb427d5cd5816a7bd18502a08640d5c9a691d6f65b2cde9cbf2e9932ca4ca55e8
+  data.tar.gz: 76d8856718792bcf2f4da207e6cb5aa69b8bf0cb81e9cc6e60aaf9ec1f8734ce0ca6abb4dca54ec04d97d95604badba2b9ba316ba7079fd3d6b198e34193c474

data/CHANGELOG.md

@@ -0,0 +1,21 @@
+# v1.1.0
+- suppress bracketed paste mode codes
+
+# v1.0.1
+- test push to rubygems, no functional changes
+
+# v1.0.0
+- added TTYString.parse as a shortcut for .new#to_s
+- added TTYString.to_proc for lols
+- added jruby to travis matrix, fortunately it just works™
+
+# v0.2.1
+- fixed a bug with ignoring \a
+
+# v0.2.0
+- Stricter rendering because it turns out terminals are randomly permissive
+- removed support for ruby 2.3
+- added \e[S and \e[T handling
+
+# v0.1.0
+- Initial Release

data/Gemfile

@@ -2,7 +2,5 @@
 
 source 'https://rubygems.org'
 
-git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
-
 # Specify your gem's dependencies in tty_string.gemspec
 gemspec

data/README.md

@@ -1,33 +1,49 @@
 # TTYString
 
-Render a string like your terminal does by parsing ANSI TTY codes.
-This is useful for testing CLI's
-
-Supported codes
-
- - \b
- - \e[A
- - \e[B
- - \e[C
- - \e[D
- - \e[E
- - \e[F
- - \e[G
- - \e[H
- - \e[J
- - \e[K
- - \e[f
- - \e[m
- - \n
- - \r
- - \t
+[![Build Status](https://travis-ci.com/robotdana/tty_string.svg?branch=main)](https://travis-ci.com/robotdana/tty_string)
+[![Gem Version](https://badge.fury.io/rb/tty_string.svg)](https://rubygems.org/gems/tty_string)
+
+Render to a string like your terminal does by (narrowly) parsing ANSI TTY codes.
+Intended for use in tests of command line interfaces.
+
+## Features
+
+- supports ruby 2.4 - 3.0.0.preview1, and jruby
+- has no dependencies outside ruby stdlib
+
+## Supported codes
+
+| Code | Description | Default |
+|------|-------------|---------|
+| `\a` | bell: suppressed | |
+| `\b` | backspace: clear the character to the left of the cursor and move the cursor back one column | |
+| `\n` | newline: move the cursor to the start of the next line | |
+| `\r` | return: move the cursor to the start of the current line | |
+| `\t` | tab: move the cursor to the next multiple-of-8 column | |
+| `\e[nA` | move the cursor up _n_ lines | _n_=`1` |
+| `\e[nB` | move the cursor down _n_ lines | _n_=`1` |
+| `\e[nC` | move the cursor right _n_ columns | _n_=`1` |
+| `\e[nD` | move the cursor left _n_ columns | _n_=`1` |
+| `\e[nE` | move the cursor down _n_ lines, and to the start of the line | _n_=`1` |
+| `\e[nF` | move the cursor up _n_ lines, and to the start of the line | _n_=`1` |
+| `\e[nG` | move the cursor to column _n_. `1` is left-most column | _n_=`1` |
+| `\e[n;mH` <br> `\e[n;mf` | move the cursor to row _n_, column _m_. `1;1` is top left corner | _n_=`1` _m_=`1` |
+| `\e[nJ` | _n_=`0`: clear the screen from the cursor forward <br>_n_=`1`: clear the screen from the cursor backward <br>_n_=`2` or _n_=`3`: clear the screen | _n_=`0` |
+| `\e[nK` | _n_=`0`: clear the line from the cursor forward <br>_n_=`1`: clear the line from the cursor backward <br>_n_=`2`: clear the line | _n_=`0` |
+| `\e[nS` | scroll up _n_ rows | _n_=`1` |
+| `\e[nT` | scroll down _n_ rows | _n_=`1` |
+| `\e[m` | styling codes: optionally suppressed with `clear_style: false` | |
+| `\e[?2004h` | enabled bracketed paste: suppressed | |
+| `\e[?2004l` | disable bracketed paste: suppressed | |
+| `\e[200~` | bracketed paste start: suppressed | |
+| `\e[201~` | bracketed paste end: suppressed | |
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'tty_string'
+gem 'tty_string', '~> 1.0'
 ```
 
 And then execute:
@@ -40,24 +56,41 @@ Or install it yourself as:
 
 ## Usage
 
-```
-TTYString.new("th\ta string\e[3Gis is").to_s => "this is a string"
+```ruby
+TTYString.parse("th\ta string\e[3Gis is")
+=> "this is a string"
 ```
 
 Styling information is suppressed by default:
-```
-TTYString.new("th\ta \e[31mstring\e[0m\e[3Gis is", clear_style: false).to_s => "this is a string"
+```ruby
+TTYString.parse("th\ta \e[31mstring\e[0m\e[3Gis is")
+=> "this is a string"
 ```
 But can be passed through:
+```ruby
+TTYString.parse("th\ta \e[31mstring\e[0m\e[3Gis is", clear_style: false)
+=> "this is a \e[31mstring\e[0m"
 ```
-TTYString.new("th\ta \e[31mstring\e[0m\e[3Gis is", clear_style: false).to_s => "this is a \e[31mstring\e[0m"
+
+Just for fun TTYString.to_proc provides the `parse` method as a lambda, so:
+```ruby
+["th\ta string\e[3Gis is"].each(&TTYString)
+=> ["this is a string"]
 ```
 
+## Limitations
+
+- Various terminals are wildly variously permissive with what they accept,
+  so this doesn't even try to cover all possible cases,
+  instead it covers the narrowest possible case, and leaves the codes in place when unrecognized
+
+- `clear_style: false` treats the style codes as regular text which may work differently when rendering codes that move the cursor.
+
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake` to run the tests and linters. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+To install this gem onto your local machine, run `bundle exec rake install`.
 
 ## Contributing
 

data/lib/tty_string.rb

@@ -3,19 +3,28 @@
 require_relative 'tty_string/parser'
 
 # Renders a string taking into ANSI escape codes and \t\r\n etc
-# Usage: TTYString.new("this\r\e[Kthat").to_s => "that"
+# Usage: TTYString.parse("This\r\e[KThat") => "That"
 class TTYString
+  class << self
+    def parse(input_string, clear_style: true)
+      new(input_string, clear_style: clear_style).to_s
+    end
+
+    def to_proc
+      method(:parse).to_proc
+    end
+  end
+
   def initialize(input_string, clear_style: true)
     @parser = Parser.new(input_string)
-    @clear_style = clear_style
+    @parser.clear_style = clear_style
   end
 
   def to_s
-    parser.render(clear_style: clear_style)
+    parser.render
   end
 
   private
 
-  attr_reader :clear_style
-  attr_reader :parser
+  attr_reader :clear_style, :parser
 end

data/lib/tty_string/code.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+class TTYString
+  class Code
+    class << self
+      def descendants
+        @@descendants
+      end
+
+      def inherited(klass)
+        @@descendants ||= [] # rubocop:disable Style/ClassVars I want it to be shared between subclasses.
+        @@descendants << klass
+        @@descendants.uniq!
+
+        super
+      end
+
+      def render(parser)
+        return unless match?(parser)
+
+        new(parser).action(*args(parser))
+
+        true
+      end
+
+      def char(value = nil)
+        @char = value if value
+        @char ||= name.split('::').last
+      end
+
+      private
+
+      def re
+        @re ||= /#{char}/.freeze
+      end
+
+      def args(_scanner)
+        []
+      end
+
+      def match?(parser)
+        parser.skip(re)
+      end
+    end
+
+    def initialize(parser)
+      @parser = parser
+    end
+
+    def action; end
+
+    private
+
+    attr_reader :parser
+
+    def screen
+      parser.screen
+    end
+
+    def cursor
+      parser.cursor
+    end
+  end
+end

data/lib/tty_string/code_definitions.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require_relative 'code'
+require_relative 'csi_code'
+
+class TTYString
+  class Code
+    class SlashA < TTYString::Code # leftovers:allow
+      char "\a"
+    end
+
+    class SlashB < TTYString::Code # leftovers:allow
+      char "\b"
+
+      def self.match?(scanner)
+        # can't use `scan(/\b/)` because it matches everything
+        return false unless scanner.peek(1) == "\b"
+
+        scanner.pos += 1
+        true
+      end
+
+      def action
+        cursor.left
+        screen.clear_at_cursor
+      end
+    end
+
+    class SlashN < TTYString::Code # leftovers:allow
+      char "\n"
+
+      def action
+        cursor.down
+        cursor.col = 0
+        screen.write('')
+      end
+    end
+
+    class SlashR < TTYString::Code # leftovers:allow
+      char "\r"
+
+      def action
+        cursor.col = 0
+      end
+    end
+
+    class SlashT < TTYString::Code # leftovers:allow
+      char "\t"
+
+      def action
+        cursor.right(8 - (cursor.col % 8))
+      end
+    end
+  end
+end

data/lib/tty_string/csi_code.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require_relative 'code'
+
+class TTYString
+  class CSICode < TTYString::Code
+    class << self
+      def default_arg(value = nil)
+        @default_arg ||= value
+        @default_arg || 1
+      end
+
+      private
+
+      def match?(parser)
+        parser.scan(re)
+      end
+
+      def args(parser)
+        a = parser.matched.slice(2..-2).split(';')
+        a = a.slice(0, max_args) unless max_args == -1
+        a.map! { |n| n.empty? ? default_arg : n.to_i }
+        a
+      end
+
+      def re
+        @re ||= /\e\[#{args_re}#{char}/
+      end
+
+      def args_re # rubocop:disable Metrics/MethodLength
+        case max_args
+        when 0 then nil
+        when 1 then /#{arg_re}?/
+        when -1 then /(#{arg_re}?(;#{arg_re})*)?/
+        else /(#{arg_re}?(;#{arg_re}){0,#{max_args - 1}})?/
+        end
+      end
+
+      def arg_re
+        /\d*/
+      end
+
+      def max_args
+        @max_args ||= instance_method(:action).arity
+      end
+    end
+  end
+end
+
+TTYString::Code.descendants.pop

data/lib/tty_string/csi_code_definitions.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+require_relative 'csi_code'
+
+class TTYString
+  class CSICode
+    class A < TTYString::CSICode # leftovers:allow
+      def action(rows = 1)
+        cursor.up(rows)
+      end
+    end
+
+    class B < TTYString::CSICode # leftovers:allow
+      def action(rows = 1)
+        cursor.down(rows)
+      end
+    end
+
+    class C < TTYString::CSICode # leftovers:allow
+      def action(cols = 1)
+        cursor.right(cols)
+      end
+    end
+
+    class D < TTYString::CSICode # leftovers:allow
+      def action(cols = 1)
+        cursor.left(cols)
+      end
+    end
+
+    class E < TTYString::CSICode # leftovers:allow
+      def action(rows = 1)
+        cursor.down(rows)
+        cursor.col = 0
+      end
+    end
+
+    class F < TTYString::CSICode # leftovers:allow
+      def action(rows = 1)
+        cursor.up(rows)
+        cursor.col = 0
+      end
+    end
+
+    class G < TTYString::CSICode # leftovers:allow
+      def action(col = 1)
+        # cursor is zero indexed, arg is 1 indexed
+        cursor.col = col.to_i - 1
+      end
+    end
+
+    class H < TTYString::CSICode # leftovers:allow
+      def action(row = 1, col = 1)
+        # cursor is zero indexed, arg is 1 indexed
+        cursor.row = row.to_i - 1
+        cursor.col = col.to_i - 1
+      end
+    end
+
+    class LowH < TTYString::CSICode # leftovers:allow
+      char(/\?2004h/)
+    end
+
+    class LowF < TTYString::CSICode::H # leftovers:allow
+      char 'f'
+    end
+
+    class J < TTYString::CSICode # leftovers:allow
+      default_arg 0
+
+      def self.arg_re
+        /[0-3]?/
+      end
+
+      def action(mode = 0)
+        # :nocov: else won't ever be called. don't worry about it
+        case mode
+        # :nocov:
+        when 0 then screen.clear_forward
+        when 1 then screen.clear_backward
+        when 2, 3 then screen.clear
+        end
+      end
+    end
+
+    class K < TTYString::CSICode # leftovers:allow
+      default_arg 0
+
+      def self.arg_re
+        /[0-2]?/
+      end
+
+      def action(mode = 0)
+        # :nocov: else won't ever be called. don't worry about it
+        case mode
+        # :nocov:
+        when 0 then screen.clear_line_forward
+        when 1 then screen.clear_line_backward
+        when 2 then screen.clear_line
+        end
+      end
+    end
+
+    class LowL < TTYString::CSICode # leftovers:allow
+      char(/\?2004l/)
+    end
+
+    class LowM < TTYString::CSICode # leftovers:allow
+      char 'm'
+
+      def self.arg_re
+        # 0-255
+        /(?:\d|\d\d|1\d\d|2[0-4]\d|25[0-5])?/
+      end
+
+      def self.render(renderer)
+        super if renderer.clear_style
+      end
+
+      def action(*args); end
+    end
+
+    class S < TTYString::CSICode # leftovers:allow
+      def action(rows = 1)
+        rows.times { screen.scroll_up }
+      end
+    end
+
+    class T < TTYString::CSICode # leftovers:allow
+      def action(rows = 1)
+        rows.times { screen.scroll_down }
+      end
+    end
+
+    class Tilde < TTYString::CSICode # leftovers:allow
+      char(/(?:200|201)~/)
+    end
+  end
+end

data/lib/tty_string/cursor.rb

@@ -11,46 +11,33 @@ class TTYString
     end
 
     def row=(value)
-      @row = value.to_i
+      @row = value
       @row = 0 if @row.negative?
     end
 
     def col=(value)
-      @col = value.to_i
+      @col = value
       @col = 0 if @col.negative?
     end
 
     def left(count = 1)
-      count = count.to_i
-      raise ArgumentError if count.negative?
-
       self.col -= count
     end
 
     def up(count = 1)
-      count = count.to_i
-      raise ArgumentError if count.negative?
-
       self.row -= count
     end
 
     def down(count = 1)
-      count = count.to_i
-      raise ArgumentError unless count >= 0
-
       self.row += count
     end
 
     def right(count = 1)
-      count = count.to_i
-      raise ArgumentError unless count >= 0
-
       self.col += count
     end
 
     def to_ary
       [row, col]
     end
-    alias to_a to_ary
   end
 end

data/lib/tty_string/parser.rb

@@ -1,82 +1,40 @@
 # frozen_string_literal: true
 
 require 'strscan'
-require_relative 'renderer'
+require_relative 'code_definitions'
+require_relative 'csi_code_definitions'
+
+require_relative 'screen'
 
 class TTYString
   # Reads the text string a
   class Parser < StringScanner
-    def render(clear_style: true)
+    attr_accessor :clear_style
+    attr_reader :screen
+
+    def render
       reset
-      @clear_style = clear_style
-      @renderer = Renderer.new
+      @screen = Screen.new
       read until eos?
-      renderer.to_s
+      screen.to_s
     end
 
-    private
+    def cursor
+      screen.cursor
+    end
 
-    attr_reader :renderer
-    attr_reader :clear_style
+    private
 
     def write(string)
-      renderer.write(string)
+      screen.write(string)
     end
 
     def read
-      text || slash_n || slash_r || slash_t || slash_b || slash_e
-    end
-
-    def text
-      write(matched) if scan(text_regexp)
-    end
-
-    def slash_n
-      renderer.slash_n if skip(/\n/)
-    end
-
-    def slash_r
-      renderer.slash_r if skip(/\r/)
-    end
-
-    def slash_t
-      renderer.slash_t if skip(/\t/)
-    end
-
-    def slash_b
-      # can't use `scan(/\b/)` because it matches everything
-      return unless peek(1) == "\b"
-
-      self.pos += 1
-      renderer.slash_b
-    end
-
-    def slash_e
-      return unless scan(csi_regexp)
-
-      args = matched.slice(2..-2).split(';')
-      command = matched.slice(-1)
-      render_csi(:"csi_#{command}", *args)
-    end
-
-    def csi_regexp
-      @csi_regexp ||= Regexp.new("\e#{csi_pattern}")
-    end
-
-    def csi_pattern
-      "\\[(\\d+;?|;)*[ABCDEFGHJKf#{'m' if clear_style}]"
-    end
-
-    def text_regexp
-      @text_regexp ||= Regexp.new("[^\b\t\r\n\e]|\e(?!#{csi_pattern})")
+      TTYString::Code.descendants.any? { |c| c.render(self) } || default
     end
 
-    def render_csi(method, *args)
-      method = renderer.method(method)
-      params = method.parameters
-      args = args.take(params.length) unless params.assoc(:rest)
-      args = [] if args.all?(&:empty?)
-      method.call(*args)
+    def default
+      write(getch)
     end
   end
 end

data/lib/tty_string/screen.rb

@@ -46,6 +46,16 @@ class TTYString
       @screen = []
     end
 
+    def scroll_up
+      screen.push([])
+      screen.shift
+    end
+
+    def scroll_down
+      screen.unshift([])
+      screen.pop
+    end
+
     def clear_lines_before
       screen.fill([], 0...row)
     end

data/lib/tty_string/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class TTYString
-  VERSION = '0.1.0'
+  VERSION = '1.1.0'
 end

data/tty_string.gemspec

@@ -11,21 +11,35 @@ Gem::Specification.new do |spec|
   spec.email = ['robot@dana.sh']
 
   spec.summary = 'Render a string using ANSI TTY codes'
-  spec.homepage = "https://github.com/robotdana/tty_string"
+  spec.homepage = 'https://github.com/robotdana/tty_string'
   spec.license = 'MIT'
 
-  spec.files = `git ls-files -z`.split("\x0").reject do |f|
-    f.match(%r{^(test|spec|features|\.?rubocop|\.travis|\.git|\.rspec)/})
+  if spec.respond_to?(:metadata)
+    spec.metadata['homepage_uri'] = spec.homepage
+    spec.metadata['source_code_uri'] = spec.homepage
+    spec.metadata['changelog_uri'] = "#{spec.homepage}/blob/main/CHANGELOG.md"
   end
-  spec.bindir = 'exe'
-  spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+
+  spec.files = Dir.glob('{lib}/**/*') + %w{
+    CHANGELOG.md
+    Gemfile
+    LICENSE.txt
+    README.md
+    tty_string.gemspec
+  }
+  spec.required_ruby_version = '>= 2.4'
   spec.require_paths = ['lib']
 
-  spec.add_development_dependency 'bundler', '~> 1.16'
-  spec.add_development_dependency 'pry', '~> 0.12.2'
-  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'fast_ignore', '>= 0.15.1'
+  spec.add_development_dependency 'leftovers', '>= 0.2.0'
+  spec.add_development_dependency 'pry', '~> 0.12'
+  spec.add_development_dependency 'rake', '>= 12.3.3'
   spec.add_development_dependency 'rspec', '~> 3.0'
-  spec.add_development_dependency 'rubocop', '~> 0.74.0'
-  spec.add_development_dependency 'rubocop-performance', '~> 1.4.1'
-  spec.add_development_dependency 'rubocop-rspec', '~> 1.35.0'
+  spec.add_development_dependency 'rubocop', '~> 0.93.1'
+  spec.add_development_dependency 'rubocop-performance', '~> 1.8.1'
+  spec.add_development_dependency 'rubocop-rspec', '~> 1.44.1'
+  spec.add_development_dependency 'simplecov', '~> 0.18.5'
+  spec.add_development_dependency 'simplecov-console'
+  spec.add_development_dependency 'spellr', '>= 0.8.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tty_string
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Dana Sherson
 autorequire: 
-bindir: exe
+bindir: bin
 cert_chain: []
-date: 2019-09-21 00:00:00.000000000 Z
+date: 2021-06-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -16,42 +16,70 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: fast_ignore
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.15.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.15.1
+- !ruby/object:Gem::Dependency
+  name: leftovers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.0
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.12.2
+        version: '0.12'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.12.2
+        version: '0.12'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 12.3.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 12.3.3
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -72,42 +100,84 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.74.0
+        version: 0.93.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.74.0
+        version: 0.93.1
 - !ruby/object:Gem::Dependency
   name: rubocop-performance
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.4.1
+        version: 1.8.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.4.1
+        version: 1.8.1
 - !ruby/object:Gem::Dependency
   name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.35.0
+        version: 1.44.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.44.1
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.18.5
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.35.0
+        version: 0.18.5
+- !ruby/object:Gem::Dependency
+  name: simplecov-console
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: spellr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.1
 description: 
 email:
 - robot@dana.sh
@@ -115,29 +185,27 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".gitmodules"
-- ".rspec"
-- ".rubocop.yml"
-- ".travis.yml"
+- CHANGELOG.md
 - Gemfile
-- Gemfile.lock
 - LICENSE.txt
 - README.md
-- Rakefile
-- bin/console
-- bin/setup
 - lib/tty_string.rb
+- lib/tty_string/code.rb
+- lib/tty_string/code_definitions.rb
+- lib/tty_string/csi_code.rb
+- lib/tty_string/csi_code_definitions.rb
 - lib/tty_string/cursor.rb
 - lib/tty_string/parser.rb
-- lib/tty_string/renderer.rb
 - lib/tty_string/screen.rb
 - lib/tty_string/version.rb
 - tty_string.gemspec
 homepage: https://github.com/robotdana/tty_string
 licenses:
 - MIT
-metadata: {}
+metadata:
+  homepage_uri: https://github.com/robotdana/tty_string
+  source_code_uri: https://github.com/robotdana/tty_string
+  changelog_uri: https://github.com/robotdana/tty_string/blob/main/CHANGELOG.md
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -146,15 +214,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.4'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.5.2.1
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: Render a string using ANSI TTY codes

data/.gitignore

@@ -1,11 +0,0 @@
-/.bundle/
-/.yardoc
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-
-# rspec failure tracking
-.rspec_status

data/.gitmodules

@@ -1,3 +0,0 @@
-[submodule "rubocop_yml"]
-	path = rubocop_yml
-	url = https://github.com/robotdana/rubocop_yml.git

data/.rspec

@@ -1,3 +0,0 @@
---format documentation
---color
---require spec_helper

data/.rubocop.yml

@@ -1 +0,0 @@
-rubocop_yml/rubocop.yml

data/.travis.yml

@@ -1,5 +0,0 @@
-sudo: false
-language: ruby
-rvm:
-  - 2.5.1
-before_install: gem install bundler -v 1.16.0

data/Gemfile.lock

@@ -1,63 +0,0 @@
-PATH
-  remote: .
-  specs:
-    tty_string (0.1.0)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    ast (2.4.0)
-    coderay (1.1.2)
-    diff-lcs (1.3)
-    jaro_winkler (1.5.3)
-    method_source (0.9.2)
-    parallel (1.17.0)
-    parser (2.6.4.1)
-      ast (~> 2.4.0)
-    pry (0.12.2)
-      coderay (~> 1.1.0)
-      method_source (~> 0.9.0)
-    rainbow (3.0.0)
-    rake (10.5.0)
-    rspec (3.8.0)
-      rspec-core (~> 3.8.0)
-      rspec-expectations (~> 3.8.0)
-      rspec-mocks (~> 3.8.0)
-    rspec-core (3.8.2)
-      rspec-support (~> 3.8.0)
-    rspec-expectations (3.8.4)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-mocks (3.8.1)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-support (3.8.2)
-    rubocop (0.74.0)
-      jaro_winkler (~> 1.5.1)
-      parallel (~> 1.10)
-      parser (>= 2.6)
-      rainbow (>= 2.2.2, < 4.0)
-      ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 1.7)
-    rubocop-performance (1.4.1)
-      rubocop (>= 0.71.0)
-    rubocop-rspec (1.35.0)
-      rubocop (>= 0.60.0)
-    ruby-progressbar (1.10.1)
-    unicode-display_width (1.6.0)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  bundler (~> 1.16)
-  pry (~> 0.12.2)
-  rake (~> 10.0)
-  rspec (~> 3.0)
-  rubocop (~> 0.74.0)
-  rubocop-performance (~> 1.4.1)
-  rubocop-rspec (~> 1.35.0)
-  tty_string!
-
-BUNDLED WITH
-   1.16.0

data/Rakefile

@@ -1,8 +0,0 @@
-# frozen_string_literal: true
-
-require 'bundler/gem_tasks'
-require 'rspec/core/rake_task'
-
-RSpec::Core::RakeTask.new(:spec)
-
-task default: :spec

data/bin/console

@@ -1,15 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require 'bundler/setup'
-require 'tty_string'
-
-# You can add fixtures and/or initialization code here to make experimenting
-# with your gem easier. You can also use a different console, if you like.
-
-# (If you use this, don't forget to add pry to your Gemfile!)
-# require "pry"
-# Pry.start
-
-require 'irb'
-IRB.start(__FILE__)

data/bin/setup

@@ -1,8 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-IFS=$'\n\t'
-set -vx
-
-bundle install
-
-# Do any other automated setup that you need to do here

data/lib/tty_string/renderer.rb

@@ -1,104 +0,0 @@
-# frozen_string_literal: true
-
-require_relative 'screen'
-class TTYString
-  # turns the text string into screen instructions
-  class Renderer
-    attr_reader :screen
-
-    def initialize
-      @screen = Screen.new
-    end
-
-    def to_s
-      screen.to_s
-    end
-
-    def write(string)
-      screen.write(string)
-    end
-
-    # rubocop:disable Naming/MethodName
-    def csi_A(rows = 1)
-      cursor.up(rows)
-    end
-
-    def csi_B(rows = 1)
-      cursor.down(rows)
-    end
-
-    def csi_C(cols = 1)
-      cursor.right(cols)
-    end
-
-    def csi_D(cols = 1)
-      cursor.left(cols)
-    end
-
-    def csi_E(rows = 1)
-      cursor.down(rows)
-      cursor.col = 0
-    end
-
-    def csi_F(rows = 1)
-      cursor.up(rows)
-      cursor.col = 0
-    end
-
-    def csi_G(col = 1)
-      cursor.col = col.to_i - 1 # cursor is zero indexed, arg is 1 indexed
-    end
-
-    def csi_H(row = 1, col = 1)
-      # cursor is zero indexed, arg is 1 indexed
-      cursor.row = row.to_i - 1
-      cursor.col = col.to_i - 1
-    end
-    alias csi_f csi_H
-
-    def csi_J(mode = 0)
-      case mode.to_i
-      when 0 then screen.clear_forward
-      when 1 then screen.clear_backward
-      when 2, 3 then screen.clear
-      end
-    end
-
-    def csi_K(mode = 0)
-      case mode.to_i
-      when 0 then screen.clear_line_forward
-      when 1 then screen.clear_line_backward
-      when 2 then screen.clear_line
-      end
-    end
-
-    def csi_m(*args)
-    end
-    # rubocop:enable Naming/MethodName
-
-    def slash_b
-      cursor.left
-      screen.clear_at_cursor
-    end
-
-    def slash_n
-      cursor.down
-      cursor.col = 0
-      screen.write('')
-    end
-
-    def slash_r
-      cursor.col = 0
-    end
-
-    def slash_t
-      cursor.right(8 - (cursor.col % 8))
-    end
-
-    private
-
-    def cursor
-      screen.cursor
-    end
-  end
-end