just-ansi 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f93be0e88f2c592c08f145ee09ac614745333ecd14b9a9bb024c50adf3b2d549
-  data.tar.gz: daa92f7cb65f9ba56c5991ad2876f7aa4cc2738532dce52cf69ef25432a81275
+  metadata.gz: de63b65fe1ca722779a0847310877197661780173df41c2f95178c36a5b85cb4
+  data.tar.gz: 2893de40b471bb6c461a9dc16e82fcfc990ee12172440cfac17f49b2192c49b2
 SHA512:
-  metadata.gz: 11c986e236eff5ef0ce7d815c39341dddb6050f8deec3e50df7a48fb45595d7ab722daa44c5b03d907e31332611fbe3099b05fd3c338c485bd54c00eb9713b31
-  data.tar.gz: d910ca7ac0374a2ab2237aa139e1e3cd5e1f29bfbf429ea6e65c7684d5d8932405f86ad5d8096961d59d7aa2bfccff8ac3215912681229b29507dfc502127e54
+  metadata.gz: b7a6bbaab57d7c56d8579cc5120e48ea2f5be68831f848102883b48c32a81a175c2cb0823d147b9c7ec8ea385355d612c17b1da79dbf04b8928d40a92052f326
+  data.tar.gz: 169589c1a0bf8712c233bb64a87cca32dc4248d2d9564542b6c9edfbc166587609e72c5adf87551c800c97559f87d51c74a06d0425f66c7a6d8c611601fff2e7

data/lib/just-ansi/attributes.rb

@@ -3,6 +3,7 @@
 
 module JustAnsi
   ATTRIBUTES = {
+    '/' => '',
     '/b' => '22',
     '/blink' => '25',
     '/bold' => '22',

data/lib/just-ansi/string.rb

@@ -2,7 +2,14 @@
 
 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.
   #
@@ -28,4 +35,37 @@ class String
   #
   # @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

data/lib/just-ansi/version.rb

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

data/lib/just-ansi.rb

@@ -187,6 +187,50 @@ module JustAnsi
       }m"
     end
 
+    # Replace embedded BBCode-like attributes with ANSI codes.
+    #
+    # @example
+    #   JustAnsi.bbcode "[b]Bold[/b] Text"
+    #   # "\e[1mBold\e[22m Text"
+    #
+    # @param str [#to_s] string to be modified
+    # @return [String] string with ANSI attributes
+    def bbcode(str)
+      str
+        .to_s
+        .gsub(BBCODE) do |match_str|
+          match = Regexp.last_match[1]
+          next "[#{match[1..]}]" if match[0] == '\\'
+          try_convert(match) || match_str
+        end
+    end
+
+    # Remove embedded BBCode-like attributes.
+    #
+    # @example
+    #   JustAnsi.unbbcode "[b]Bold[/b] Text"
+    #   # "Bold Text"
+    #
+    # @param str [#to_s] string to be modified
+    # @return [String] string without BBCode
+    def unbbcode(str)
+      str
+        .to_s
+        .gsub(BBCODE) do |match_str|
+          next match_str if (match = Regexp.last_match[1]).empty?
+          next "[#{match[1..]}]" if match[0] == '\\'
+          next match_str if (match = match.split).empty?
+          next if match.all? { ATTRIBUTES[_1] || COLORS[_1] || _color(_1) }
+          match_str
+        end
+    end
+
+    # Remove any BBCode-like and/or ANSI attributes.
+    #
+    # @param str [#to_s] string to be modified
+    # @return [String] string without BBCode and ANSI control codes.
+    def plain(str) = unbbcode(str).gsub(TEST, '')
+
     # @!group Control functions
 
     # Move cursor given lines up.
@@ -334,7 +378,7 @@ module JustAnsi
     #
     # @param [String] title text
     # @return (see cursor_up)
-    def window_title(title) = "\e]2;#{title}\e\\"
+    def window_title(title) = "\e]2;#{title}\a"
 
     # Change tab title.
     # This is not widely supported.
@@ -345,7 +389,9 @@ module JustAnsi
 
     # Create a hyperlink.
     # This is not widely supported.
-    def link(url, text) = "\e]8;;#{url}\e\\#{text}\e]8;;\e\\"
+    def link(url, text) = "\e]8;;#{url}\a#{text}\e]8;;\a"
+
+    # @comment simple  def notify(title) = "\e]9;#{title}\a"
 
     # @!endgroup
 
@@ -403,15 +449,17 @@ module JustAnsi
   end
 
   TEST =
-    /\e
-      (?:\[[\d;:\?]*[ABCDEFGHJKSTfminsuhl])
+    /
+      (?:\e\[[\d;:\?]*[ABCDEFGHJKSTfminsuhl])
       |
-      (?:\]\d+(?:;[^;\a\e]+)*(?:\a|\e\\))
+      (?:\e\]\d+(?:;[^\a\e]+)*(?:\a|\e\\))
     /x
 
+  BBCODE = /(?:\[((?~[\[\]]))\])/
+
   require_relative 'just-ansi/attributes'
   autoload :NAMED_COLORS, File.join(__dir__, 'just-ansi', 'named_colors')
-  private_constant :TEST, :NAMED_COLORS
+  private_constant :TEST, :BBCODE, :NAMED_COLORS
 
   # @!visibility private
   RESET = self[:reset].freeze

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: just-ansi
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Mike Blumtritt
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-09-14 00:00:00.000000000 Z
+date: 2024-09-15 00:00:00.000000000 Z
 dependencies: []
 description: 'Simple and fast ANSI control code processing.