termline 1.1.2 → 1.1.3

data/lib/termline.rb

@@ -32,68 +32,165 @@ Building a better future, one line of code at a time.
 
 
 # ·
+require_relative "termline/version"
+require_relative "termline/terminal"
 require_relative "termline/style"
 require_relative "termline/table"
 require_relative "termline/space"
 require_relative "termline/list"
 require_relative "termline/msg"
+require_relative "termline/text"
+require_relative "termline/details"
 
 
 # ·
 module Termline
     class << self
+        def terminal
+            @terminal ||= Termline::Terminal.new
+        end
+
+        def output
+            terminal.output
+        end
+
+        def output=(io)
+            terminal.output = io
+        end
+
+        def ansi
+            terminal.ansi
+        end
+
+        def ansi=(mode)
+            terminal.ansi = mode
+        end
+
+        def width
+            terminal.width
+        end
+
+        def width=(value)
+            terminal.width = value
+        end
+
+        def timestamps
+            @timestamps.nil? ? true : @timestamps
+        end
+
+        alias timestamps? timestamps
+
+        def timestamps=(value)
+            unless value == true || value == false
+                raise ArgumentError, "Timestamps must be true or false"
+            end
+
+            @timestamps = value
+        end
+
+        def timestamp_format
+            @timestamp_format || "%H:%M:%S:%L"
+        end
+
+        def timestamp_format=(format)
+            unless format.is_a?(String) && !format.empty?
+                raise ArgumentError, "Timestamp format must be a non-empty string"
+            end
+
+            @timestamp_format = format
+        end
+
+        def configure
+            yield self
+            self
+        end
+
         def m(*messages)
-            messages.each { |message| puts(message) }
+            write(messages.map(&:to_s).join("\n"))
         end
 
-        def msg(*messages, **data)
-            messages.each { |message| puts(Termline::Msg.builder(message, data:data)) }
+        def msg(*messages, time:nil, bgcolor: :default, **data)
+            write(messages.map { |message| Termline::Msg.builder(message, bgcolor:bgcolor, data:data, time:time) }.join("\n"))
         end
 
-        def info(*messages, tag:'INFO:', icon: :info, time:true, **data)
-            messages.each { |message| puts(Termline::Msg.builder(message, tag:tag, icon:icon,  data:data, color: :blue, time:time)) }
+        def info(*messages, tag:'INFO:', icon: :info, time:nil, bgcolor: :default, **data)
+            write(messages.map { |message| Termline::Msg.builder(message, tag:tag, icon:icon, data:data, color: :blue, bgcolor:bgcolor, time:time) }.join("\n"))
         end
 
-        def success(*messages, tag:'SUCCESS:', icon: :success, time:true, **data)
-            messages.each { |message| puts(Termline::Msg.builder(message, tag:tag, icon:icon, data:data, color: :green, time:time)) }
+        def success(*messages, tag:'SUCCESS:', icon: :success, time:nil, bgcolor: :default, **data)
+            write(messages.map { |message| Termline::Msg.builder(message, tag:tag, icon:icon, data:data, color: :green, bgcolor:bgcolor, time:time) }.join("\n"))
         end
 
-        def warning(*messages, tag:'WARNING:', icon: :warning, time:true, **data)
-            messages.each { |message| puts(Termline::Msg.builder(message, tag:tag, icon:icon,  data:data, color: :yellow, time:time)) }
+        def warning(*messages, tag:'WARNING:', icon: :warning, time:nil, bgcolor: :default, **data)
+            write(messages.map { |message| Termline::Msg.builder(message, tag:tag, icon:icon, data:data, color: :yellow, bgcolor:bgcolor, time:time) }.join("\n"))
         end
 
-        def danger(*messages, tag:'DANGER:', icon: :error, time:true, **data)
-            messages.each { |message| puts(Termline::Msg.builder(message, tag:tag, icon:icon,  data:data, color: :red, time:time)) }
+        def danger(*messages, tag:'DANGER:', icon: :error, time:nil, bgcolor: :default, **data)
+            write(messages.map { |message| Termline::Msg.builder(message, tag:tag, icon:icon, data:data, color: :red, bgcolor:bgcolor, time:time) }.join("\n"))
         end
 
         def alert(*messages)
-            messages.each { |message| puts(Termline::Msg.alert(message)) }
+            write(messages.map { |message| Termline::Msg.alert(message) }.join("\n"))
         end
 
 
         def list(*items, color: :default, icon: :debug)
-            Termline::List.builder(items, color:color, icon:icon)
+            write(Termline::List.builder(items, color:color, icon:icon))
         end
 
+        def ordered_list(*items, color: :default, start: 1)
+            write(Termline::List.builder(items, color:color, ordered:true, start:start))
+        end
 
-        def table(data, header:true)
-            Termline::Table.builder(data, header:header)
+        def table(data, header:true, align: :auto)
+            write(Termline::Table.builder(data, header:header, align:align))
         end
 
         def br(count=1)
-            puts(Termline::Space.builder("\n", count))
+            write(Termline::Space.builder("\n", count))
         end 
 
-        def line(count=8)
-            puts(Termline::Space.builder('-·-     ', count))
+        def line(count=nil, character: "─", width: nil)
+            content = if count
+                Termline::Space.builder('-·-     ', count)
+            else
+                Termline::Space.line(character, width || terminal.width)
+            end
+
+            write(content)
         end
 
         def color(color)
-            Termline::Space.color(count)
+            write(Termline::Space.color(color))
         end
 
 
-        def deprecation message
+        def title(text, color: :blue, character: "─", width: nil)
+            write(Termline::Text.title(text, color:color, character:character, width:width || terminal.width))
+        end
+
+        def details(data=nil, color: :blue, separator: ": ", icon: nil, icons: nil, **pairs)
+            write(Termline::Details.builder(
+                data,
+                color:color,
+                separator:separator,
+                icon:icon,
+                icons:icons,
+                **pairs
+            ))
+        end
+
+        def deprecation(*messages, time:nil, **data)
+            warning(*messages, tag: 'DEPRECATED:', time:time, **data)
+        end
+
+        private
+
+        def write(content)
+            return content if content.nil? || content.empty?
+
+            output.puts(content)
+            content
         end
     end
 end