color_echo 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 51b73486f80605fc2b29e9a87129e3f528222599
-  data.tar.gz: a1fcdaa02b03ee665075e7768fa05931f5a9216f
+  metadata.gz: 71656796cab59b1ebe1d27d680e2ce4c30b7b604
+  data.tar.gz: 2406fffc8c2a85628cfc797da963bc8bf373e705
 SHA512:
-  metadata.gz: 3640bb11d8f5477ab2cc93b809e9f691e42ff28d9d174a7d2dab546d96cad801aacecb33e18b3faf668d29b9c4f93ca658896d0d5fb223527db30c205585928c
-  data.tar.gz: b180b3d77e7df8420c8ad493768407b6031161722c8af5efb60d50ea43e4eb9a2fe6600f104701ad98396c0c3d09103f88a4db07a7ccbd469cbc6876db6973b3
+  metadata.gz: 9c955163de5d79d247474036f1a53608376e9e9383322bbc5b672ec8dada2618c32ed444f514c186f18fe4caed9f503780dae04cef29b66c342a8b1a0d3fa46c
+  data.tar.gz: 4ae8cca7ff900843822a143ab41b9d8dc38321dd948d011514010144afa9bd138366516995ffe5ea129ba5ec0c2003fc601526e0349bc27bc8a8489a560cc687

data/README.md

@@ -3,8 +3,8 @@ Decorate the command line output with ANSI escape sequence.
 String that is output by "print, puts, p" method is decorated.    
 It is also can to decorate only your specified words!   
 
-Version: 0.8.0   
-Compliant Rubys Version: 1.9.3, 2.0.0, 2.1.0 (for Linux)  
+Version: 0.9.0   
+Compliant Rubys Version: 2.0.0, 2.1.0 (for Linux)  
 License: MIT  
 Gems repository: http://rubygems.org/gems/color_echo
 
@@ -41,6 +41,26 @@ EOS
 ![screen shot](/images/pickup1.png)
 
 
+
+## Do you want to return words with the escape sequence?
+
+Please write `require "color_echo/get"` rather than `require "color_echo"`.
+```ruby
+require "color_echo/get"
+
+greet  = CE.fg(:yellow).get("Hello")
+name   = CE.ch(:h_blue, :gray).get("Foo")
+myname = CE.tx(:underscore).rainbow.get("Bar")
+
+puts greet + ", " + name + "!"
+puts "My name is " + myname
+
+output = CE.fg(:blue).pickup(/color$/, :index199).pickup(/^color/, :h_green).get("color color color")
+puts "output is -> " + output
+```
+![screen shot](/images/get1.png)
+
+
 ## You can run on the command line
 <pre>
     * Usage
@@ -134,7 +154,7 @@ ex.) CE.ch_bg :white #=> background color will be changed white
 #### CE.ch_tx(text_attribute)        
 Change the text attribute to the your specified decoration.     
  - Alias -> tx   
- - Parameter attribute -> symbol or array of them   
+ - Parameter text_attribute -> symbol or array of them   
  - Return -> self    
 
 * symbol list of text attribute:    
@@ -180,7 +200,7 @@ Reset automatically after once output.
 
 #### CE.times(cnt)
 Reset automatically after cnt times output.     
- - Parameter cnt -> Integer    
+ - Parameter cnt -> integer    
  - Return -> self    
 
 
@@ -205,7 +225,14 @@ Force ignore the function of this library.
 
 #### CE.rainbow
 Text color will change to rainbow color.   
+ - Return -> self
+
 
+#### CE.get(text)    
+Decorate and return argument with ANSI escape sequence.   
+If you want to use this module function; You have to require "color_echo/get" only!     
+ - Parameter text -> string 
+ - Return -> string
 
 
 ### Example
@@ -294,6 +321,9 @@ puts "Disable rainbow mode."
 ![screen shot](/images/screenshot.png)
 
 ## Release Note
+* v0.9.0, 2014-01-19
+    * Added a mode to receive as the words with ANSI escape sequence; without output to display.
+
 * v0.8.0, 2014-01-14
     * Changed for the specified arguments of reset method.
     * Fixed small bugs.

data/bin/color_echo

@@ -33,7 +33,7 @@ def usage
     puts padding + "--index_list, -l"
     puts padding * 2 + "Display color index list that can to specify." + $/ + $/
 
-    exit
+    exit 0
 end
 
 def display_color_index
@@ -61,6 +61,8 @@ def display_color_index
         end
     end
     CE.off
+
+    exit 0
 end
 
 def display_symbol_list
@@ -120,24 +122,30 @@ def display_symbol_list
     end
 
     print $/
-end
 
+    exit 0
+end
 
 usage if ARGV.size != 1
 
-case ARGV[0]
-when "--symbol_list", "-s"
-    display_symbol_list
+require "optparse"
+opt = OptionParser.new
+
+opt.on("-h") { usage }
+opt.on("-v") { puts CE::VERSION; exit 0 }
+opt.on("-s", "--symbol_list") { display_symbol_list }
+opt.on("-l", "--index_list") { display_color_index }
 
-when "--index_list", "-l"
-    display_color_index
+begin
+    opt.parse!(ARGV)
 
-when "-v"
-    puts CE::VERSION
+rescue OptionParser::InvalidOption => err
+    mess = "[OPTION ERROR] Invalid option ->"
+    err.args.each do |op|
+        mess += %( '#{op}')
+    end
+    mess += " (OptionParser::InvalidOption)"
+    warn mess + $/ + $/
 
-else
     usage
 end
-
-
-

data/lib/color_echo.rb

@@ -1,20 +1,7 @@
 # color_echo
-#
-# Decorate the command line output with ANSI escape sequense.
-# This Library will extend the Kernel module's functions(#print, #puts, #p).
-# Required StringIO.
-#
-begin
-    require "stringio"
-rescue LoadError
-    warn "color_echo required 'stringio'."
-end
+# Decorate the command line output with ANSI escape sequence.
+# String that is output by "print, puts, p" method is decorated.
+# It is also can to decorate only your specified words!
 
-require_relative "color_echo/const.rb"
-require_relative "color_echo/module/foreground.rb"
-require_relative "color_echo/module/background.rb"
-require_relative "color_echo/module/textattr.rb"
-require_relative "color_echo/module/off.rb"
-require_relative "color_echo/variables.rb"
-require_relative "color_echo/module_functions.rb"
-require_relative "color_echo/override.rb"
+require_relative "color_echo/get"
+require_relative "color_echo/override"

data/lib/color_echo/const.rb

@@ -1,8 +1,8 @@
 module CE
-    LIBS_NAME = "color_echo"
-    VERSION   = "0.8.0"
-    SUMMARY   = "Decorate the command line output with ANSI escape sequence."
-    DOCS_PAGE = "https://github.com/khotta/color_echo"
+    LIBS_NAME   = "color_echo"
+    VERSION     = "0.9.0"
+    SUMMARY     = "Decorate the command line output with ANSI escape sequence."
+    DOCS_PAGE   = "https://github.com/khotta/color_echo"
     DESCRIPTION = <<EOS
 #{SUMMARY}
 String that is output by "print, puts, p" method is decorated.

data/lib/color_echo/functions.rb

@@ -0,0 +1,177 @@
+module CE
+    # do not allow to use
+    # @return void
+    def unuse
+        @@enable = false
+    end
+
+    # reset code
+    # @param scope symbol|array
+    # @return self
+    def reset(scope=:all)
+        if scope.is_a?(Array)
+            scopes = scope
+        else
+            scopes = [scope]
+        end
+
+        scopes.each do |scope|
+            case scope
+            when :all
+                reset_fg
+                reset_bg
+                reset_tx
+                reset_pickup
+                reset_rainbow
+            when :fg
+                reset_fg
+            when :bg
+                reset_bg
+            when :tx
+                reset_tx
+            when :pickup
+                reset_pickup
+            when :rainbow
+                reset_rainbow
+            end
+        end
+
+        return self
+    end
+
+    # auto off until output set count
+    # @params int cnt
+    # @return self
+    def times(cnt)
+        @@cnt_limit = cnt
+        return self
+    end
+
+    def once
+        times(1)
+    end
+
+    # @param symbol name
+    # @return self
+    def ch_fg(name)
+        return nil if !name.is_a?(Symbol)
+
+        @@rainbow       = false if @@rainbow
+        @@code_fg_color = convert_to_code("ForeGround", name)
+
+        return self
+    end
+
+    # @param symbol name
+    # @return self
+    def ch_bg(name)
+        return nil if !name.is_a?(Symbol)
+
+        @@rainbow       = false if @@rainbow
+        @@code_bg_color = convert_to_code("BackGround", name)
+
+        return self
+    end
+
+    # @param array name : Array of Symbols
+    # @return self
+    def ch_tx(*names)
+        @@rainbow = false    if @@rainbow
+        names     = names[0] if names[0].instance_of?(Array)
+
+        names.each do |name|
+            next if !name.is_a?(Symbol)
+            @@code_text_attr += convert_to_code("TextAttr", name)
+        end
+
+        return self
+    end
+
+    # @param symbol fg
+    # @param symbol bg
+    # @param symbol|array txs
+    # @return self
+    def ch(fg, bg=nil, txs=nil)
+        ch_fg(fg)
+        ch_bg(bg)
+        ch_tx(*txs)  # passing expand
+
+        return self
+    end
+
+    # to decorate only the specified target
+    # @param string|regexp|array target
+    # @param symbol fg
+    # @param symbol bg
+    # @param symbol tx
+    # @return self
+    def pickup(target, fg=:red, bg=nil, *txs)
+        key = target.object_id.to_s
+        @@pickup_list[key] = {}
+
+        if target.is_a?(Array)
+            @@pickup_list[key][:patterns] = target
+        else
+            @@pickup_list[key][:patterns] = [target]
+        end
+
+        if fg.instance_of?(Symbol)
+            code_fg = convert_to_code("ForeGround", fg)
+        else
+            code_fg = ""
+        end
+
+        if bg.instance_of?(Symbol)
+            code_bg = convert_to_code("BackGround", bg)
+        else
+            code_bg = ""
+        end
+
+        code_tx = ""
+        if txs.size > 0
+            txs = txs[0] if txs[0].instance_of?(Array)
+            txs.each do |name|
+                next if !name.is_a?(Symbol)
+                code_tx += convert_to_code("TextAttr", name)
+            end
+        end
+
+        @@pickup_list[key][:code] = code_fg + code_bg + code_tx
+
+        return self
+    end
+
+    # change mode to rainbow
+    # @return void
+    def rainbow
+        @@rainbow      = true
+        @@code_rainbow = @@code_bg_color + @@code_text_attr
+
+        return self
+    end
+
+    # get decorated text
+    # require "color_echo/get"
+    # @param string text
+    def get(text)
+        if @@allow_output
+            warn (%([WARNING] CE.get; If you want to use this module function; You have to require "color_echo/get" only!))
+            return text
+        end
+
+        if !text.is_a?(String)
+            text = text.to_s
+        end
+        
+        @@task.call(text)
+    end
+
+    # method alias
+    alias_method :off,     :reset
+    alias_method :disable, :reset
+    alias_method :fg,      :ch_fg
+    alias_method :bg,      :ch_bg
+    alias_method :tx,      :ch_tx
+
+    extend self
+end

data/lib/color_echo/get.rb

@@ -0,0 +1,14 @@
+begin
+    require "stringio"
+rescue LoadError
+    warn "color_echo required 'stringio'."
+end
+
+require_relative "const"
+require_relative "variables"
+require_relative "module/foreground"
+require_relative "module/background"
+require_relative "module/textattr"
+require_relative "module/off"
+require_relative "functions"
+require_relative "internal"

data/lib/color_echo/internal.rb

@@ -0,0 +1,186 @@
+module CE
+    # is allow to use?
+    # @return bool
+    def enable?
+        return @@enable
+    end
+
+    # is allow to use? and is set code?
+    # @return bool
+    def available?
+        return @@enable && isset?
+    end
+
+    # is set code?
+    # @return bool
+    def isset?
+        return get_start_code != "" || @@pickup_list.size > 0 || @@rainbow
+    end
+
+    # reset foreground code
+    # @return self
+    def reset_fg
+        @@code_fg_color = ""
+        return self
+    end
+
+    # reset background code
+    # @return self
+    def reset_bg
+        @@code_bg_color = ""
+        return self
+    end
+
+    # reset text attr code
+    # @return self
+    def reset_tx
+        @@code_text_attr = ""
+        return self
+    end
+
+    # reset pickup code
+    # @return self
+    def reset_pickup
+        @@pickup_list = {}
+        return self
+    end
+
+    # reset and off raubow mode
+    # @return self
+    def reset_rainbow
+        @@code_rainbow = ""
+        @@rainbow      = false
+        return self
+    end
+
+    # reset all state of code
+    # @return self
+    def reset_all
+        reset_fg
+        reset_bg
+        reset_tx
+        reset_pickup
+        reset_rainbow
+        return self
+    end
+
+    # return start escape sequence code
+    # @return string
+    def get_start_code
+        if @@rainbow
+            return @@code_rainbow
+        else
+            return @@code_fg_color + @@code_bg_color + @@code_text_attr
+        end
+    end
+
+    # @return String
+    def get_reset_code
+        return self::Off::ALL
+    end
+
+    # add reset & start code to line feed code
+    # @param string input
+    def add_reset_line_feed(input)
+        input.gsub!(/#{$/}/, get_reset_code + $/ + get_start_code)
+        input += get_reset_code
+        return input
+    end
+
+    # add code to be a rainbow color
+    # @param string text
+    # @return string
+    def add_rainbow(text)
+        cnt    = 0
+        output = get_start_code
+
+        text.each_char do |char|
+            if char == $/
+                output += get_reset_code + $/ + get_start_code
+                next
+            end
+
+            case cnt
+            when 0
+                output += ForeGround::RED + char + Off::ALL + get_start_code
+            when 1
+                output += ForeGround::GREEN + char + Off::ALL + get_start_code
+            when 2
+                output += ForeGround::YELLOW + char + Off::ALL + get_start_code
+            when 3
+                output += ForeGround::BLUE + char + Off::ALL + get_start_code
+            when 4
+                output += ForeGround::MAGENTA + char + Off::ALL + get_start_code
+            when 5
+                output += ForeGround::CYAN + char + Off::ALL + get_start_code
+            when 6
+                output += ForeGround::WHITE + char + Off::ALL + get_start_code
+            end
+            cnt += 1
+            cnt  = 0 if cnt >= 7
+        end
+
+        output += get_reset_code
+
+        return output
+    end
+
+    # add pickup code
+    # @param string text
+    # @return string
+    def add_pickup_code(text)
+        @@pickup_list.each_pair do |key, hash|
+            patterns = hash[:patterns]
+            code     = hash[:code]
+
+            # repeat to each specified pickup pattern
+            patterns.each do |pattern|
+                # pattern is Regexp
+                if pattern.is_a?(Regexp)
+                    after_text = ""
+                    # global match
+                    (text.scan(pattern)).size.times do
+                        pattern =~ text
+                        after_text += $` + code + $& + get_reset_code + get_start_code
+                        text = $'
+                    end
+                    text = after_text + text
+
+                # pattern is String
+                else
+                    text.gsub!(pattern, code + pattern + get_reset_code + get_start_code)
+                end
+            end
+        end
+
+        return text
+    end
+
+    # get sequence code by symbol
+    # @param string module_name
+    # @param symbol name
+    # @return string
+    def convert_to_code(module_name, name)
+        return "" if (name == nil || name == "")
+
+        begin
+            cname = name.to_s.swapcase
+
+            # specified color index
+            if cname.index("INDEX")
+                num = cname.sub("INDEX", "").to_i - 1
+                return eval(%{#{module_name}::INDEX}) + num.to_s + "m"
+            end
+
+            code = eval(%{#{module_name}::#{cname}})
+        rescue NameError
+            raise(NameError ,%{:#{name} is not defined! Please check reference.})
+        end
+        return code
+    end
+
+    # @return proc
+    def task
+        return @@task
+    end
+end

data/lib/color_echo/override.rb

@@ -1,3 +1,7 @@
+module CE
+    @@allow_output = true
+end
+
 # override Kernel methods
 def print(*arg)
     CE.task.call(*arg)

data/lib/color_echo/variables.rb

@@ -8,10 +8,14 @@ module CE
     @@rainbow        = false
     @@pickup_list    = {}
     @@cnt_limit      = 0
+    @@allow_output   = false
 
     @@print = method :print
     @@p     = method :p
     @@puts  = method :puts
+    @@get   = lambda do |text|
+        print text
+    end
 
     @@task = lambda do |*arg|
         if available?
@@ -27,7 +31,7 @@ module CE
 
             #is_hit_pickup = false
 
-            # output to STDOUT
+            # get output text
             if @@rainbow
                 output = add_rainbow(strio.string)
             else
@@ -47,21 +51,30 @@ module CE
                 output = add_reset_line_feed(output)
             end
 
-            $stdout.print output
-
-            # auto off
-            if @@cnt_limit > 0
-                @@cnt_limit -= 1
-                # to reset
-                if @@cnt_limit == 0
-                    reset [:fg, :bg, :tx, :rainbow]
+            # output to STDOUT
+            if @@allow_output
+                $stdout.print output
+                # auto off
+                if @@cnt_limit > 0
+                    @@cnt_limit -= 1
+                    # to reset
+                    if @@cnt_limit == 0
+                        reset [:fg, :bg, :tx, :rainbow]
+                    end
                 end
+            else
+                reset
+                return output
             end
 
         # no available "color echo"
         else
-            # call original method
-            eval("@@#{caller_locations(2).first.label}").call(*arg)
+            if @@allow_output
+                # call original method
+                eval("@@#{caller_locations(2).first.label}").call(*arg)
+            else
+                return arg
+            end
         end
     end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: color_echo
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - khotta
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-01-14 00:00:00.000000000 Z
+date: 2015-01-19 00:00:00.000000000 Z
 dependencies: []
 description: |
   Decorate the command line output with ANSI escape sequence.
@@ -25,11 +25,13 @@ files:
 - bin/color_echo
 - lib/color_echo.rb
 - lib/color_echo/const.rb
+- lib/color_echo/functions.rb
+- lib/color_echo/get.rb
+- lib/color_echo/internal.rb
 - lib/color_echo/module/background.rb
 - lib/color_echo/module/foreground.rb
 - lib/color_echo/module/off.rb
 - lib/color_echo/module/textattr.rb
-- lib/color_echo/module_functions.rb
 - lib/color_echo/override.rb
 - lib/color_echo/variables.rb
 homepage: https://github.com/khotta/color_echo
@@ -48,7 +50,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 1.9.3
+      version: 2.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

data/lib/color_echo/module_functions.rb

@@ -1,374 +0,0 @@
-module CE
-    # is allow to use?
-    # @return bool
-    def enable?
-        return @@enable
-    end
-
-    # is allow to use? and is set code?
-    # @return bool
-    def available?
-        return @@enable && isset?
-    end
-
-    # is set code?
-    # @return bool
-    def isset?
-        return get_start_code != "" || @@pickup_list.size > 0 || @@rainbow
-    end
-
-    # do not allow to use
-    # @return void
-    def unuse
-        @@enable = false
-    end
-
-    # reset code
-    # @param scope symbol|array
-    # @return self
-    def reset(scope=:all)
-        if scope.is_a?(Array)
-            scopes = scope
-        else
-            scopes = [scope]
-        end
-
-        scopes.each do |scope|
-            case scope
-            when :all
-                reset_fg
-                reset_bg
-                reset_tx
-                reset_pickup
-                reset_rainbow
-            when :fg
-                reset_fg
-            when :bg
-                reset_bg
-            when :tx
-                reset_tx
-            when :pickup
-                reset_pickup
-            when :rainbow
-                reset_rainbow
-            end
-        end
-
-        return self
-    end
-
-    # reset foreground code
-    # @return self
-    def reset_fg
-        @@code_fg_color = ""
-        return self
-    end
-
-    # reset background code
-    # @return self
-    def reset_bg
-        @@code_bg_color = ""
-        return self
-    end
-
-    # reset text attr code
-    # @return self
-    def reset_tx
-        @@code_text_attr = ""
-        return self
-    end
-
-    # reset pickup code
-    # @return self
-    def reset_pickup
-        @@pickup_list = {}
-        return self
-    end
-
-    # reset and off raubow mode
-    # @return self
-    def reset_rainbow
-        @@code_rainbow = ""
-        @@rainbow      = false
-        return self
-    end
-
-    # reset all state of code
-    # @return self
-    def reset_all
-        reset_fg
-        reset_bg
-        reset_tx
-        reset_pickup
-        reset_rainbow
-        return self
-    end
-
-    # auto off until output set count
-    # @params int cnt
-    # @return self
-    def times(cnt)
-        @@cnt_limit = cnt
-        return self
-    end
-
-    def once
-        times(1)
-    end
-
-    # @param symbol name
-    # @return self
-    def ch_fg(name)
-        return nil if !name.instance_of?(Symbol)
-
-        @@rainbow = false if @@rainbow
-        @@code_fg_color = convert_to_code("ForeGround", name)
-
-        return self
-    end
-
-    # @param symbol name
-    # @return self
-    def ch_bg(name)
-        return nil if !name.instance_of?(Symbol)
-
-        @@rainbow = false if @@rainbow
-        @@code_bg_color = convert_to_code("BackGround", name)
-
-        return self
-    end
-
-    # @param array name : Array of Symbols
-    # @return self
-    def ch_tx(*names)
-        @@rainbow = false    if @@rainbow
-        names     = names[0] if names[0].instance_of?(Array)
-
-        names.each do |name|
-            next if !name.instance_of?(Symbol)
-            @@code_text_attr += convert_to_code("TextAttr", name)
-        end
-
-        return self
-    end
-
-    # @param symbol fg
-    # @param symbol bg
-    # @param symbol|array txs
-    # @return self
-    def ch(fg, bg=nil, txs=nil)
-        ch_fg(fg)
-        ch_bg(bg)
-        ch_tx(*txs)  # passing expand
-
-        return self
-    end
-
-    # to decorate only the specified target
-    # @param string|regexp|array target
-    # @param symbol fg
-    # @param symbol bg
-    # @param symbol tx
-    # @return self
-    def pickup(target, fg=:red, bg=nil, *txs)
-        key = target.object_id.to_s
-        @@pickup_list[key] = {}
-
-        if target.is_a?(Array)
-            @@pickup_list[key][:patterns] = target
-        else
-            @@pickup_list[key][:patterns] = [target]
-        end
-
-        if fg.instance_of?(Symbol)
-            code_fg = convert_to_code("ForeGround", fg)
-        else
-            code_fg = ""
-        end
-
-        if bg.instance_of?(Symbol)
-            code_bg = convert_to_code("BackGround", bg)
-        else
-            code_bg = ""
-        end
-
-        code_tx = ""
-        if txs.size > 0
-            txs = txs[0] if txs[0].instance_of?(Array)
-            txs.each do |name|
-                next if !name.instance_of?(Symbol)
-                code_tx += convert_to_code("TextAttr", name)
-            end
-        end
-
-        @@pickup_list[key][:code] = code_fg + code_bg + code_tx
-
-        return self
-    end
-
-    # change mode to rainbow
-    # @return void
-    def rainbow
-        @@rainbow      = true
-        @@code_rainbow = @@code_bg_color + @@code_text_attr
-    end
-
-    # return start escape sequence code
-    # @return string
-    def get_start_code
-        if @@rainbow
-            return @@code_rainbow
-        else
-            return @@code_fg_color + @@code_bg_color + @@code_text_attr
-        end
-    end
-
-    # @return String
-    def get_reset_code
-        return self::Off::ALL
-    end
-
-    # add reset & start code to line feed code
-    # @param string input
-    def add_reset_line_feed(input)
-        input.gsub!(/#{$/}/, CE::get_reset_code + $/ + CE::get_start_code)
-        input += CE::get_reset_code
-        return input
-    end
-
-    # add code to be a rainbow color
-    # @param string text
-    # @return string
-    def add_rainbow(text)
-        cnt    = 0
-        output = get_start_code
-
-        text.each_char do |char|
-            if char == $/
-                output += get_reset_code + $/ + get_start_code
-                next
-            end
-
-            case cnt
-            when 0
-                output += ForeGround::RED + char + Off::ALL + get_start_code
-            when 1
-                output += ForeGround::GREEN + char + Off::ALL + get_start_code
-            when 2
-                output += ForeGround::YELLOW + char + Off::ALL + get_start_code
-            when 3
-                output += ForeGround::BLUE + char + Off::ALL + get_start_code
-            when 4
-                output += ForeGround::MAGENTA + char + Off::ALL + get_start_code
-            when 5
-                output += ForeGround::CYAN + char + Off::ALL + get_start_code
-            when 6
-                output += ForeGround::WHITE + char + Off::ALL + get_start_code
-            end
-            cnt += 1
-            cnt  = 0 if cnt >= 7
-        end
-
-        output += get_reset_code
-
-        return output
-    end
-
-    # add pickup code
-    # @param string text
-    # @return string
-    def add_pickup_code(text)
-        @@pickup_list.each_pair do |key, hash|
-            patterns = hash[:patterns]
-            code     = hash[:code]
-
-            # repeat to each specified pickup pattern
-            patterns.each do |pattern|
-                # pattern is Regexp
-                if pattern.is_a?(Regexp)
-                    after_text = ""
-                    # global match
-                    (text.scan(pattern)).size.times do
-                        pattern =~ text
-                        after_text += $` + code + $& + get_reset_code + get_start_code
-                        text = $'
-                    end
-                    text = after_text + text
-
-                # pattern is String
-                else
-                    text.gsub!(pattern, code + pattern + get_reset_code + get_start_code)
-                end
-            end
-        end
-
-        return text
-    end
-
-    # get sequence code by symbol
-    # @param string module_name
-    # @param symbol name
-    # @return string
-    def convert_to_code(module_name, name)
-        return "" if (name == nil || name == "")
-
-        begin
-            cname = name.to_s.swapcase
-
-            # specified color index
-            if cname.index("INDEX")
-                num = cname.sub("INDEX", "").to_i - 1
-                return eval(%{#{module_name}::INDEX}) + num.to_s + "m"
-            end
-
-            code = eval(%{#{module_name}::#{cname}})
-        rescue NameError
-            raise(NameError ,%{:#{name} is not defined! Please check reference.})
-        end
-        return code
-    end
-
-    # @return proc
-    def task
-        return @@task
-    end
-
-    # method alias
-    alias_method :off,     :reset
-    alias_method :disable, :reset
-    alias_method :fg,      :ch_fg
-    alias_method :bg,      :ch_bg
-    alias_method :tx,      :ch_tx
-
-    module_function :available?,
-                    :isset?,
-                    :enable?,
-                    :unuse,
-                    :reset,
-                    :reset_fg,
-                    :reset_bg,
-                    :reset_tx,
-                    :reset_pickup,
-                    :reset_rainbow,
-                    :reset_all,
-                    :off,
-                    :disable,
-                    :times,
-                    :once,
-                    :ch_fg,
-                    :fg,
-                    :ch_bg,
-                    :bg,
-                    :ch_tx,
-                    :tx,
-                    :ch,
-                    :pickup,
-                    :rainbow,
-                    :get_start_code,
-                    :get_reset_code,
-                    :add_reset_line_feed,
-                    :add_rainbow,
-                    :add_pickup_code,
-                    :convert_to_code,
-                    :task
-end