just-ansi 0.2.1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4bc8e95b8442246c0bb54c0fc9fd4bbb0196023a254f0127cd77f1699c7af47d
-  data.tar.gz: de0c011547c12fdc2568233a17d40b0228ea4604f5114db02c860d67c0737ad9
+  metadata.gz: 294e05aacfb98dbb9f9dfbb88059945d50b6f3bcc7660dbac93bfaab3aa10b9d
+  data.tar.gz: df553573277036702cb2056074c84400432da4a37eb240c996810b2b9b1ba53a
 SHA512:
-  metadata.gz: 918be47dc5e4562af228c7a82e32713424fcd771cf78b174ae72fd8bfea37011af96a40b07564be935e4d28f25bb855d07a4db6cce058781b2a7ccc3998ad4f1
-  data.tar.gz: a908ba695fc54a3503e7faccab0fabeaded67385b3ff0a2a42ad7c12615ad6e2dc1aab81c8ca331d77bf040f417cd5f101181cf9d00cf08eb7577294b975a897
+  metadata.gz: 8b80bbf875d910786941cf5c6fdd8118af22ba69a9f304c4bcfabf09dbb70f62d9e1b3ae45fd2f2cb1e43e103ae5e271507912c0fa2fd5648d57792d39cc5970
+  data.tar.gz: 8189df038c0b01a3f1327c7c27085097182dd1f6ef0475bd3bcc434d743fcbba744acbeb10dc47e6fcd67b612f789d425b00982e755aeaf9cc261b0a935bade1

data/.yardopts

@@ -0,0 +1,12 @@
+--title 'just-ansi'
+--charset utf-8
+--markup markdown
+--readme README.md
+--no-private
+--embed-mixins
+--tag comment
+--hide-tag comment
+lib/**/*.rb
+-
+README.md
+LICENSE

data/README.md

@@ -1,13 +1,38 @@
-# JustAnsi
+# JustAnsi ![version](https://img.shields.io/gem/v/just-ansi?label=)
 
-![version](https://img.shields.io/gem/v/just-ansi?label=)
-
-Simple and fast ANSI control code processing.
+Simple and fast ANSI control code processing. <!-- Without BS. -->
 
 - Gem: [rubygems.org](https://rubygems.org/gems/just-ansi)
 - Source: [github.com](https://github.com/mblumtritt/just-ansi)
 - Help: [rubydoc.info](https://rubydoc.info/gems/just-ansi/JustAnsi)
 
+## Description
+
+JustAnsi provides a rich set of methods to generate ANSI control codes for attributes, colors, cursor movement and much more. It supports most control codes, all attributes, 3/4bit-, 8bit- and 24bit-colors.
+
+```ruby
+hello = JustAnsi.decorate('Hello World!', :bold, :red)
+# => "\e[1;31mHello World!\e[m"
+
+JustAnsi.undecorate(hello)
+# => 'Hello World!'
+
+JustAnsi.bbcode('[b]Hello [red]World[/fg]![/b]')
+# => "\e[1mHello \e[31mWorld\e[39m!\e[22m"
+```
+
+## Help
+
+📕 See the [online help](https://rubydoc.info/gems/just-ansi/JustAnsi) and have a look at the [examples](./examples/) directory.
+
+### Run Examples
+
+You can execute the examples by
+
+```sh
+ruby ./examples/bbcode.rb
+```
+
 ## Installation
 
 You can install the gem in your system with

data/examples/24bit-colors.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require_relative '../lib/just-ansi'
+
+colors =
+  JustAnsi
+    .named_colors
+    .delete_if { /\d/.match?(_1) }
+    .map! { "[on_#{_1}] [/] [#{_1}]#{_1.to_s.ljust(22)}[/]" }
+    .each_slice(3)
+    .map(&:join)
+    .join("\n")
+
+puts JustAnsi.bbcode <<~TEXT
+
+  ✅ [b 2]Just Ansi[/b] — 24bit-Colors:[/]
+
+  #{colors}
+
+TEXT

data/examples/3bit-colors.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require_relative '../lib/just-ansi'
+
+puts JustAnsi.bbcode <<~TEXT
+
+  ✅ [b 2]Just Ansi[/b] — 3bit-Colors:[/]
+
+  [on_black] [/] [black]black[/]      [on_bright_black] [/] [bright_black]bright_black[/]
+  [on_red] [/] [red]red[/]        [on_bright_red] [/] [bright_red]bright_red[/]
+  [on_green] [/] [green]green[/]      [on_bright_green] [/] [bright_green]bright_green[/]
+  [on_yellow] [/] [yellow]yellow[/]     [on_bright_yellow] [/] [bright_yellow]bright_yellow[/]
+  [on_blue] [/] [blue]blue[/]       [on_bright_blue] [/] [bright_blue]bright_blue[/]
+  [on_magenta] [/] [magenta]magenta[/]    [on_bright_magenta] [/] [bright_magenta]bright_magenta[/]
+  [on_cyan] [/] [cyan]cyan[/]       [on_bright_cyan] [/] [bright_cyan]bright_cyan[/]
+  [on_white] [/] [white]white[/]      [on_bright_white] [/] [bright_white]bright_white[/]
+
+TEXT

data/examples/8bit-colors.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require_relative '../lib/just-ansi'
+
+puts JustAnsi.bbcode <<~TEXT
+
+  ✅ [b 2]Just Ansi[/b] — 8bit-Colors:[/]
+
+  System Colors
+    [on_0] 00 [on_1] 01 [on_2] 02 [on_3] 03 [on_4] 04 [on_5] 05 [on_6] 06 [on_7] 07 [/]
+    [on_8] 08 [on_9] 09 [on_a] 0a [on_b] 0b [on_c] 0c [on_d] 0d [on_e] 0e [on_e] 0f [/]
+
+  Grayscale
+    [on_e8] e8 [on_e9] e9 [on_ea] ea [on_eb] eb [on_ec] ec [on_ed] ed [on_ee] ee [on_ef] ef [on_f0] f0 [on_f1] f1 [on_f2] f2 [on_f3] f3 [/]
+    [on_f4] f4 [on_f5] f5 [on_f6] f6 [on_f7] f7 [on_f8] f8 [on_f9] f9 [on_fa] fa [on_fb] fb [on_fc] fc [on_fd] fd [on_fe] fe [on_ff] ff [/]
+
+  6x6 Color Cubes
+    [on_10] 10 [on_11] 11 [on_12] 12 [on_13] 13 [on_14] 14 [on_15] 15 [/]    [on_16] 16 [on_17] 17 [on_18] 18 [on_19] 19 [on_1a] 1a [on_1b] 1b [/]    [on_1c] 1c [on_1d] 1d [on_1e] 1e [on_1f] 1f [on_20] 20 [on_21] 21 [/]
+    [on_34] 34 [on_35] 35 [on_36] 36 [on_37] 37 [on_38] 38 [on_39] 39 [/]    [on_3a] 3a [on_3b] 3b [on_3c] 3c [on_3d] 3d [on_3e] 3e [on_3f] 3f [/]    [on_40] 40 [on_41] 41 [on_42] 42 [on_43] 43 [on_44] 44 [on_45] 45 [/]
+    [on_58] 58 [on_59] 59 [on_5a] 5a [on_5b] 5b [on_5c] 5c [on_5d] 5d [/]    [on_5e] 5e [on_5f] 5f [on_60] 60 [on_61] 61 [on_62] 62 [on_63] 63 [/]    [on_64] 64 [on_65] 65 [on_66] 66 [on_67] 67 [on_68] 68 [on_69] 69 [/]
+    [on_7c] 7c [on_7d] 7d [on_7e] 7e [on_7f] 7f [on_80] 80 [on_81] 81 [/]    [on_82] 82 [on_83] 83 [on_84] 84 [on_85] 85 [on_86] 86 [on_87] 87 [/]    [on_88] 88 [on_89] 89 [on_8a] 8a [on_8b] 8b [on_8c] 8c [on_8d] 8d [/]
+    [on_a0] a0 [on_a1] a1 [on_a2] a2 [on_a3] a3 [on_a4] a4 [on_a5] a5 [/]    [on_a6] a6 [on_a7] a7 [on_a8] a8 [on_a9] a9 [on_aa] aa [on_ab] ab [/]    [on_ac] ac [on_ad] ad [on_ae] ae [on_af] af [on_b0] b0 [on_b1] b1 [/]
+    [on_c4] c4 [on_c5] c5 [on_c6] c6 [on_c7] c7 [on_c8] c8 [on_c9] c9 [/]    [on_ca] ca [on_cb] cb [on_cc] cc [on_cd] cd [on_ce] ce [on_cf] cf [/]    [on_d0] d0 [on_d1] d1 [on_d2] d2 [on_d3] d3 [on_d4] d4 [on_d5] d5 [/]
+
+    [on_22] 22 [on_23] 23 [on_24] 24 [on_25] 25 [on_26] 26 [on_27] 27 [/]    [on_28] 28 [on_29] 29 [on_2a] 2a [on_2b] 2b [on_2c] 2c [on_2d] 2d [/]    [on_2e] 2e [on_2f] 2f [on_30] 30 [on_31] 31 [on_32] 32 [on_33] 33 [/]
+    [on_46] 46 [on_47] 47 [on_48] 48 [on_49] 49 [on_4a] 4a [on_4b] 4b [/]    [on_4c] 4c [on_4d] 4d [on_4e] 4e [on_4f] 4f [on_50] 50 [on_51] 51 [/]    [on_52] 52 [on_53] 53 [on_54] 54 [on_55] 55 [on_56] 56 [on_57] 57 [/]
+    [on_6a] 6a [on_6b] 6b [on_6c] 6c [on_6d] 6d [on_6e] 6e [on_6f] 6f [/]    [on_70] 70 [on_71] 71 [on_72] 72 [on_73] 73 [on_74] 74 [on_75] 75 [/]    [on_76] 76 [on_77] 77 [on_78] 78 [on_79] 79 [on_7a] 7a [on_7b] 7b [/]
+    [on_8e] 8e [on_8f] 8f [on_90] 90 [on_91] 91 [on_92] 92 [on_93] 93 [/]    [on_94] 94 [on_95] 95 [on_96] 96 [on_97] 97 [on_98] 98 [on_99] 99 [/]    [on_9a] 9a [on_9b] 9b [on_9c] 9c [on_9d] 9d [on_9e] 9e [on_9f] 9f [/]
+    [on_b2] b2 [on_b3] b3 [on_b4] b4 [on_b5] b5 [on_b6] b6 [on_b7] b7 [/]    [on_b8] b8 [on_b9] b9 [on_ba] ba [on_bb] bb [on_bc] bc [on_bd] bd [/]    [on_be] be [on_bf] bf [on_c0] c0 [on_c1] c1 [on_c2] c2 [on_c3] c3 [/]
+    [on_d6] d6 [on_d7] d7 [on_d8] d8 [on_d9] d9 [on_da] da [on_db] db [/]    [on_dc] dc [on_dd] dd [on_de] de [on_df] df [on_e0] e0 [on_e1] e1 [/]    [on_e2] e2 [on_e3] e3 [on_e4] e4 [on_e5] e5 [on_e6] e6 [on_e7] e7 [/]
+
+TEXT

data/examples/attributes.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require_relative '../lib/just-ansi'
+
+puts JustAnsi.bbcode <<~TEXT
+
+  ✅ [b 2]Just Ansi[/b] — Attributes:[/]
+
+  JustAnsi supports all well known attributes like [b]bold[/b], [i]italic[/i], [u]underline[/u], [blink]blink[/blink],
+  [inv]invert[/inv] and [strike]strike[/strike]. Other attributes like [faint]faint[/faint], [double_underline]double underline[/], [curly_underline]curly
+  underline[/], [dotted_underline]dotted underline[/], [dashed_underline]dashed underline[/], [rapid_blink]rapid_blink[/], [framed]framed[/], [encircled]encircled[/],
+  [overlined]overlined[/] and [proportional]proportional[/] are not widely used but also supported.
+  Alternative fonts are mostly completely ignored by terminal emulators:
+  [primary_font]primary_font[/], [fraktur]fraktur[/], [font1]font1[/] ... [font9]font9[/].
+
+TEXT

data/examples/bbcode.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require_relative '../lib/just-ansi'
+
+puts JustAnsi.bbcode <<~TEXT
+
+  ✅ [b 2]Just Ansi[/b] — BBCode:[/]
+
+              [b]Bold[/b]   [\\b]...[\\/b] or [\\bold]...[\\/bold]
+             [faint]Faint[/faint]   [\\faint]...[\\/faint]
+            [i]Italic[/i]   [\\i]...[\\/i] or [\|italic]...[\\/italic]
+            [inv]Invert[/inv]   [\\inv]...[\\/inv] or [\\invert]...[\\/invert]
+            [strike]Strike[/strike]   [\\strike]...[\\/strike]
+              [h]Hide[/h]   [\\h]...[\\/h] or [\\hide]...[\\/hide] or [\\conceal]...[\\/conceal]
+        [blink]Slow blink[/blink]   [\\blink]...[\\/blink] or [\\slow_blink]...[\\/slow_blink]
+         [u]Underline[/u]   [\\u]...[\\/u] or [\\underline]...[\\/underline]
+  [uu]Double underline[/uu]   [\\uu]...[\\/uu] or [\\double_underline]...[\\/double_underline]
+   [cu]Curly underline[/cu]   [\\cu]...[\\/cu] or [\\curly_underline]...[\\/curly_underline]
+  [dau]Dashed underline[/dau]   [\\dau]...[\\/dau] or [\\dashed_underline]...[\\/dashed_underline]
+  [dou]Dotted underline[/dou]   [\\dou]...[\\/dou] or [\\dotted_underline]...[\\/dotted_underline]
+           [fraktur]Fraktur[/fraktur]   [\\fraktur]...[\\/fraktur]
+            [framed]Framed[/framed]   [\\framed]...[\\/framed]
+         [encircled]Encircled[/encircled]   [\\encircled]...[\\/encircled]
+         [ovr]Overlined[/ovr]   [\\ovr]...[\\/ovr] or [\\overlined]...[\\/overlined]
+         [sub]Subscript[/sub]   [\\sub]...[\\/sub] or [\\subscript]...[\\/subscript]
+       [sup]Superscript[/sup]   [\\sup]...[\\/sup] or [\\superscript]...[\\/superscript]
+
+TEXT

data/lib/just-ansi/version.rb

@@ -2,5 +2,5 @@
 
 module JustAnsi
   # The version number of the gem.
-  VERSION = '0.2.1'
+  VERSION = '1.0.0'
 end

data/lib/just-ansi.rb

@@ -230,6 +230,27 @@ module JustAnsi
     # @return [String] string without BBCode and ANSI control codes.
     def plain(str) = unbbcode(str).gsub(TEST, '')
 
+    # Create nice colored text.
+    #
+    # @param str [#to_s] string to enrich with color
+    # @param frequence [Float] color change frequency
+    # @param spread [Float] number of chars with same color
+    # @param seed [Float] start index on sinus curve
+    # @return [String] fancy text
+    def rainbow(str, frequence: 0.3, spread: 0.8, seed: 1.1)
+      pos = -1
+      str
+        .to_s
+        .chars
+        .map! do |char|
+          i = (seed + ((pos += 1) / spread)) * frequence
+          "\e[38;2;#{(Math.sin(i) * 255).abs.to_i};" \
+            "#{(Math.sin(i + PI2_THIRD) * 255).abs.to_i};" \
+            "#{(Math.sin(i + PI4_THIRD) * 255).abs.to_i}m#{char}"
+        end
+        .join << RESET
+    end
+
     # @!group Control functions
 
     # Move cursor given lines up.
@@ -360,6 +381,18 @@ module JustAnsi
     # @return (see cursor_up)
     def line_erase = _line_erase(2)
 
+    # Insert given numbers of lines.
+    #
+    # @param (see cursor_up)
+    # @return (see cursor_up)
+    def line_insert(lines = 1) = "\e[#{lines}L"
+
+    # Delete given numbers of lines.
+    #
+    # @param (see cursor_up)
+    # @return (see cursor_up)
+    def line_delete(lines = 1) = "\e[#{lines}M"
+
     # Scroll window given lines up.
     #
     # @param lines [Integer] number of lines to scroll
@@ -390,8 +423,6 @@ module JustAnsi
     # This is not widely supported.
     def link(url, text) = "\e]8;;#{url}\a#{text}\e]8;;\a"
 
-    # @comment simple  def notify(title) = "\e]9;#{title}\a"
-
     # @!endgroup
 
     # @comment seems not widely supported:
@@ -401,10 +432,9 @@ module JustAnsi
     # @comment  def cursor_row_rel(rows = 1) = "\e[#{rows}e"
     # @comment  def cursor_tab(count = 1) = "\e[#{column}I"
     # @comment  def cursor_reverse_tab(count = 1) = "\e[#{count}Z"
-    # @comment  def line_insert(lines = 1) = "\e[#{lines}L"
-    # @comment  def line_delete(lines = 1) = "\e[#{lines}M"
     # @comment  def chars_delete(count = 1) = "\e[#{count}P"
     # @comment  def chars_erase(count = 1) = "\e[#{count}X"
+    # @comment simple  def notify(title) = "\e]9;#{title}\a"
 
     private
 
@@ -456,9 +486,15 @@ module JustAnsi
 
   BBCODE = /(?:\[((?~[\[\]]))\])/
 
+  PI2_THIRD = 2 * Math::PI / 3
+  PI4_THIRD = 4 * Math::PI / 3
+
+  private_constant :TEST, :BBCODE, :PI2_THIRD, :PI4_THIRD
+
   require_relative 'just-ansi/attributes'
+
   autoload :NAMED_COLORS, File.join(__dir__, 'just-ansi', 'named_colors')
-  private_constant :TEST, :BBCODE, :NAMED_COLORS
+  private_constant :NAMED_COLORS
 
   # @!visibility private
   RESET = self[:reset].freeze

data/lib/no-ansi.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+require_relative 'just-ansi'
+
+#
+# Shadow to {JustAnsi} but does **not** use ANSI codes.
+# It can be used as a compatible {JustAnsi} replacement.
+#
+# @example Define global Ansi module depending on `NO_COLOR` environment variable
+#   Ansi = ENV.key?('NO_COLOR') ? NoAnsi : JustAnsi
+#
+#   puts Ansi.bbcode('[b]Hello World![/b]')
+#   # => prints bold text when 'NO_COLOR' was not defined
+#
+# @see JustAnsi
+#
+module NoAnsi
+  class << self
+    # @!visibility private
+    def attributes = JustAnsi.attributes
+    # @!visibility private
+    def colors = JustAnsi.colors
+    # @!visibility private
+    def named_colors = JustAnsi.named_colors
+    # @!visibility private
+    def valid?(*attributes) = JustAnsi.valid?(*attributes)
+    # @!visibility private
+    def ansi?(str) = JustAnsi.ansi?(str)
+    # @!visibility private
+    def decorate(str, *_, **_) = JustAnsi.undecorate(str)
+    # @!visibility private
+    def undecorate(str) = JustAnsi.undecorate(str)
+    # @!visibility private
+    def bbcode(str) = JustAnsi.unbbcode(str)
+    # @!visibility private
+    def unbbcode(str) = JustAnsi.unbbcode(str)
+    # @!visibility private
+    def plain(str) = JustAnsi.plain(str)
+
+    # @!visibility private
+    def try_convert(attributes, seperator: ' ')
+      return unless attributes
+      return if (attributes = attributes.to_s.split(seperator)).empty?
+      +'' if JustAnsi.valid?(*attributes)
+    end
+
+    # @!visibility private
+    def [](*_) = +''
+    # @!visibility private
+    def rainbow(str, **_) = "#{str}"
+    # @!visibility private
+    def cursor_pos(_row, _column = nil) = +''
+    # @!visibility private
+    def link(_url, text) = "#{text}"
+
+    # @!visibility private
+    def dummy0 = +''
+    # @!visibility private
+    def dummy1(_ = 1) = +''
+
+    alias cursor_up dummy1
+    alias cursor_down dummy1
+    alias cursor_forward dummy1
+    alias cursor_back dummy1
+    alias cursor_next_line dummy1
+    alias cursor_previous_line dummy1
+    alias cursor_prev_line cursor_previous_line
+    alias cursor_column dummy1
+    alias cursor_show dummy0
+    alias cursor_hide dummy0
+    alias cursor_pos_safe dummy0
+    alias cursor_pos_restore dummy0
+    alias screen_erase_below dummy0
+    alias screen_erase_above dummy0
+    alias screen_erase dummy0
+    alias screen_erase_scrollback dummy0
+    alias screen_save dummy0
+    alias screen_restore dummy0
+    alias screen_alternate dummy0
+    alias screen_alternate_off dummy0
+    alias line_erase_to_end dummy0
+    alias line_erase_to_start dummy0
+    alias line_erase dummy0
+    alias line_insert dummy1
+    alias line_delete dummy1
+    alias scroll_up dummy1
+    alias scroll_down dummy1
+    alias window_title dummy1
+    alias tab_title dummy1
+
+    private :dummy0, :dummy1
+  end
+
+  JustAnsi.constants.each { const_set(_1, _1 == 'VERSION' ? _1 : '') }
+end

metadata

@@ -1,18 +1,19 @@
 --- !ruby/object:Gem::Specification
 name: just-ansi
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 1.0.0
 platform: ruby
 authors:
 - Mike Blumtritt
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-09-15 00:00:00.000000000 Z
+date: 2024-10-05 00:00:00.000000000 Z
 dependencies: []
-description: 'Simple and fast ANSI control code processing.
-
-  '
+description: |
+  JustAnsi provides a rich set of methods to generate ANSI control codes for
+  attributes, colors, cursor movement and much more. It supports most control
+  codes, all attributes, 3/4bit-, 8bit- and 24bit-colors.
 email:
 executables: []
 extensions: []
@@ -20,14 +21,20 @@ extra_rdoc_files:
 - README.md
 - LICENSE
 files:
+- ".yardopts"
 - LICENSE
 - README.md
+- examples/24bit-colors.rb
+- examples/3bit-colors.rb
+- examples/8bit-colors.rb
+- examples/attributes.rb
+- examples/bbcode.rb
 - lib/just-ansi.rb
 - lib/just-ansi/attributes.rb
 - lib/just-ansi/named_colors.rb
-- lib/just-ansi/string.rb
 - lib/just-ansi/version.rb
 - lib/just_ansi.rb
+- lib/no-ansi.rb
 homepage: https://github.com/mblumtritt/just-ansi
 licenses:
 - MIT
@@ -51,7 +58,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.18
+rubygems_version: 3.5.21
 signing_key:
 specification_version: 4
 summary: Simple fast ANSI

data/lib/just-ansi/string.rb

@@ -1,71 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../just-ansi'
-
-#
-# Ruby String class ANSI extension.
-#
-# This extension is not load by default but you need to require it.
-#
-# @example
-#   require 'just-ansi/string'
-#
-class String
-  # Test if String contains ANSI codes.
-  #
-  # @see JustAnsi.ansi?
-  #
-  # @return [true, false] whether if attributes are found
-  def ansi? = JustAnsi.ansi?(self)
-
-  # Decorate self with ANSI attributes and colors.
-  #
-  # @see JustAnsi.decorate
-  #
-  # @param attributes [Array<Symbol, String>] attribute names to be used
-  # @param reset [true, false] whether to include reset code for ANSI attributes
-  # @return [String] `str` converted and decorated with the ANSI `attributes`
-  def ansi(*attributes, reset: true)
-    JustAnsi.decorate(self, *attributes, reset: reset)
-  end
-
-  # Remove ANSI functions, attributes and colors from self.
-  #
-  # @see JustAnsi.undecorate
-  #
-  # @return [String] string without ANSI attributes
-  def unansi = JustAnsi.undecorate(self)
-
-  if defined?(:bbcode)
-    def bbcode = JustAnsi.bbcode(super)
-  else
-    # Replace embedded BBCode-like attributes with ANSI codes.
-    #
-    # @see JustAnsi.bbcode
-    #
-    # @return [String] string with ANSI attributes
-    def bbcode = JustAnsi.bbcode(self)
-  end
-
-  if defined?(:unbbcode)
-    def unbbcode = JustAnsi.unbbcode(super)
-  else
-    # Remove embedded BBCode-like attributes.
-    #
-    # @see JustAnsi.unbbcode
-    #
-    # @return [String] string without BBCode
-    def unbbcode = JustAnsi.unbbcode(self)
-  end
-
-  if defined?(:plain)
-    def plain = JustAnsi.plain(super)
-  else
-    # Remove any BBCode-like and/or ANSI attributes.
-    #
-    # @see JustAnsi.plain
-    #
-    # @return [String] string without BBCode and ANSI control codes.
-    def plain = JustAnsi.plain(self)
-  end
-end