termchart 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 61d7a54444a32d1b78ca78fc4d8b5d4e1c5c16b7e26a9f5a163066fd9ebc7831
-  data.tar.gz: e5c466192416619cf7e556c5f8ad7cae6dd84210e5f5a2acfc58b33bc5f3b350
+  metadata.gz: 55f452dc8d64878667f8f2b1713082ffa6749c457094c35ee66e0b0defa622b5
+  data.tar.gz: b45f48358e95976f342890386a470eed2f9765ec2e6d06a43ebbe4345bf6b1c2
 SHA512:
-  metadata.gz: 93b4a0c40d9dcc79d311040340714218d0d89c9215383bcab42de9b7c20b704870d3e394505753c17a2db978c08ca7c92cf724c4f2ed74202328bb03d0c989df
-  data.tar.gz: 5e5805164766efd3d04089ed36aaaba435cecbf2574c0b7d232e3c0cbc1e65cca8733dc66355f6d22cd4018fb58093ee491b4adc1e791cfa72d4d6a9c17c8336
+  metadata.gz: 4c416cae0fdeeec726b42661b071ed3d1e53b87631c69005018c65d865954446b5698eb9c48abd4d7c8d64861738d63eee2e661536c9c67979810bd92e74ca88
+  data.tar.gz: bdb901634be7a9ee63e975d3d21460a279b4e3e3e839eebdac060ceffde4d2d1d971d1e98ca42b88576bf13a0b6172be41670e1e6d8f827603d4ff0fab33e326

data/lib/termchart/bar.rb

@@ -21,6 +21,9 @@ module Termchart
 
     def render
       return "" if @items.empty?
+      if @items.any? { |i| i[:value] < 0 }
+        raise ArgumentError, "Bar chart does not support negative values"
+      end
       @orientation == :horizontal ? render_horizontal : render_vertical
     end
 
@@ -43,7 +46,7 @@ module Termchart
         pad    = bar_w - visible_len(bar)
         pad    = 0 if pad < 0
         bar_str = bar + " " * pad
-        bar_str = colorize(bar_str, item[:color]) if item[:color]
+        bar_str = Termchart.colorize(bar_str, item[:color]) if item[:color]
         lbl = item[:label].ljust(label_w)
         val = format_val(item[:value]).rjust(val_w)
         "#{lbl} │#{bar_str} #{val}"
@@ -78,7 +81,7 @@ module Termchart
       h.times do |row|
         parts = cols.each_with_index.map do |col, i|
           cell = col[row]
-          @items[i][:color] ? colorize(cell, @items[i][:color]) : cell
+          @items[i][:color] ? Termchart.colorize(cell, @items[i][:color]) : cell
         end
         lines << parts.join(" ")
       end
@@ -96,15 +99,5 @@ module Termchart
       str.gsub(/\e\[[0-9;]*m/, "").length
     end
 
-    def colorize(str, color)
-      code = case color
-             when Integer then "38;5;#{color}"
-             when /\A#?([0-9a-fA-F]{6})\z/
-               r, g, b = [$1].pack("H*").unpack("CCC")
-               "38;2;#{r};#{g};#{b}"
-             else "38;5;#{color}"
-             end
-      "\e[#{code}m#{str}\e[0m"
-    end
   end
 end

data/lib/termchart/candle.rb

@@ -17,15 +17,15 @@ module Termchart
     # Add OHLC data: array of hashes with keys :o, :h, :l, :c
     def add(ohlc_data)
       ohlc_data.each do |d|
-        @data << {
-          o: d[:o].to_f, h: d[:h].to_f,
-          l: d[:l].to_f, c: d[:c].to_f
-        }
+        o, h, l, c = d[:o].to_f, d[:h].to_f, d[:l].to_f, d[:c].to_f
+        raise ArgumentError, "high (#{h}) must be >= low (#{l})" if h < l
+        @data << { o: o, h: h, l: l, c: c }
       end
     end
 
     def render
       return "" if @data.empty?
+      effective_height = [@height, 3].max
 
       data_min = @data.map { |d| d[:l] }.min
       data_max = @data.map { |d| d[:h] }.max
@@ -33,10 +33,10 @@ module Termchart
       data_range = 1.0 if data_range.zero?
 
       # Y-axis label width
-      y_label_w = [format_num(data_max).length, format_num(data_min).length].max + 1
+      y_label_w = [Termchart.format_num(data_max).length, Termchart.format_num(data_min).length].max + 1
       chart_w = @width - y_label_w
       chart_w = 10 if chart_w < 10
-      chart_h = @height
+      chart_h = effective_height
 
       # Decide how many candles to show (1 char width each, with gaps)
       max_candles = chart_w / 2  # each candle takes 1 col + 1 gap
@@ -89,18 +89,18 @@ module Termchart
       # Add Y-axis labels
       result = lines.each_with_index.map do |line, row|
         if row == 0
-          label = format_num(data_max).rjust(y_label_w - 1) + "┤"
+          label = Termchart.format_num(data_max).rjust(y_label_w - 1) + "┤"
         elsif row == chart_h - 1
-          label = format_num(data_min).rjust(y_label_w - 1) + "┤"
+          label = Termchart.format_num(data_min).rjust(y_label_w - 1) + "┤"
         elsif row == chart_h / 2
           mid = data_min + data_range / 2.0
-          label = format_num(mid).rjust(y_label_w - 1) + "┤"
+          label = Termchart.format_num(mid).rjust(y_label_w - 1) + "┤"
         elsif row == chart_h / 4
           q1 = data_max - data_range / 4.0
-          label = format_num(q1).rjust(y_label_w - 1) + "┤"
+          label = Termchart.format_num(q1).rjust(y_label_w - 1) + "┤"
         elsif row == chart_h * 3 / 4
           q3 = data_min + data_range / 4.0
-          label = format_num(q3).rjust(y_label_w - 1) + "┤"
+          label = Termchart.format_num(q3).rjust(y_label_w - 1) + "┤"
         else
           label = " " * (y_label_w - 1) + "│"
         end
@@ -110,16 +110,5 @@ module Termchart
       result.join("\n")
     end
 
-    private
-
-    def format_num(v)
-      if v.abs >= 1000
-        "%.0f" % v
-      elsif v.abs >= 100
-        "%.1f" % v
-      else
-        "%.2f" % v
-      end
-    end
   end
 end

data/lib/termchart/line.rb

@@ -17,6 +17,7 @@ module Termchart
 
     def render
       return "" if @series.empty?
+      effective_height = [@height, 3].max
 
       # Compute global min/max across all series
       all_vals = @series.flat_map { |s| s[:values] }
@@ -27,10 +28,10 @@ module Termchart
 
       # Reserve space for Y-axis labels (use widest of min/mid/max)
       mid = data_min + data_range / 2.0
-      y_label_w = [format_num(data_max), format_num(data_min), format_num(mid)].map(&:length).max + 1
+      y_label_w = [Termchart.format_num(data_max), Termchart.format_num(data_min), Termchart.format_num(mid)].map(&:length).max + 1
       chart_w = @width - y_label_w
       chart_w = 10 if chart_w < 10
-      chart_h = @height
+      chart_h = effective_height
 
       # Pixel dimensions (braille: 2 dots wide, 4 dots tall per cell)
       px_w = chart_w * 2
@@ -66,12 +67,12 @@ module Termchart
       lines = chart_str.split("\n")
       result = lines.each_with_index.map do |line, row|
         if row == 0
-          label = format_num(data_max).rjust(y_label_w - 1) + "┤"
+          label = Termchart.format_num(data_max).rjust(y_label_w - 1) + "┤"
         elsif row == chart_h - 1
-          label = format_num(data_min).rjust(y_label_w - 1) + "┤"
+          label = Termchart.format_num(data_min).rjust(y_label_w - 1) + "┤"
         elsif row == chart_h / 2
           mid = data_min + data_range / 2.0
-          label = format_num(mid).rjust(y_label_w - 1) + "┤"
+          label = Termchart.format_num(mid).rjust(y_label_w - 1) + "┤"
         else
           label = " " * (y_label_w - 1) + "│"
         end
@@ -82,7 +83,7 @@ module Termchart
       if @series.any? { |s| s[:label] }
         legend = @series.map do |s|
           name = s[:label] || "data"
-          colorize("━━", s[:color]) + " " + name
+          Termchart.colorize("━━", s[:color]) + " " + name
         end.join("  ")
         result << " " * y_label_w + legend
       end
@@ -113,25 +114,5 @@ module Termchart
       end
     end
 
-    def format_num(v)
-      if v.abs >= 1000
-        "%.0f" % v
-      elsif v.abs >= 1
-        "%.1f" % v
-      else
-        "%.2f" % v
-      end
-    end
-
-    def colorize(str, color)
-      code = case color
-             when Integer then "38;5;#{color}"
-             when /\A#?([0-9a-fA-F]{6})\z/
-               r, g, b = [$1].pack("H*").unpack("CCC")
-               "38;2;#{r};#{g};#{b}"
-             else "38;5;#{color}"
-             end
-      "\e[#{code}m#{str}\e[0m"
-    end
   end
 end

data/lib/termchart/spark.rb

@@ -15,26 +15,7 @@ module Termchart
         TICKS[idx]
       end
       line = chars.join
-      color ? colorize(line, color) : line
+      color ? Termchart.colorize(line, color) : line
     end
-
-    private
-
-    def self.colorize(str, color)
-      code = case color
-             when Integer then "38;5;#{color}"
-             when Symbol  then "38;5;#{NAMED_COLORS[color] || 7}"
-             when /\A#?([0-9a-fA-F]{6})\z/
-               r, g, b = [$1].pack("H*").unpack("CCC")
-               "38;2;#{r};#{g};#{b}"
-             else "38;5;#{color}"
-             end
-      "\e[#{code}m#{str}\e[0m"
-    end
-
-    NAMED_COLORS = {
-      red: 196, green: 82, blue: 33, yellow: 226, cyan: 51,
-      magenta: 201, white: 255, gray: 245, orange: 208
-    }.freeze
   end
 end

data/lib/termchart/version.rb

@@ -1,3 +1,3 @@
 module Termchart
-  VERSION = "0.1.2"
+  VERSION = "0.2.0"
 end

data/lib/termchart.rb

@@ -6,6 +6,38 @@ require_relative "termchart/candle"
 require_relative "termchart/bar"
 
 module Termchart
+  NAMED_COLORS = {
+    red: 196, green: 82, blue: 33, yellow: 226, cyan: 51,
+    magenta: 201, white: 255, gray: 245, orange: 208
+  }.freeze
+
+  # Shared colorize helper (ANSI escape wrapping).
+  # Supports Integer (256-color), Symbol (named), and hex string.
+  def self.colorize(str, color)
+    code = case color
+           when Integer then "38;5;#{color}"
+           when Symbol  then "38;5;#{NAMED_COLORS[color] || 7}"
+           when /\A#?([0-9a-fA-F]{6})\z/
+             r, g, b = [$1].pack("H*").unpack("CCC")
+             "38;2;#{r};#{g};#{b}"
+           else "38;5;#{color}"
+           end
+    "\e[#{code}m#{str}\e[0m"
+  end
+
+  # Shared numeric formatter for axis labels.
+  def self.format_num(v)
+    if v.abs >= 1000
+      "%.0f" % v
+    elsif v.abs >= 100
+      "%.1f" % v
+    elsif v.abs >= 1
+      "%.1f" % v
+    else
+      "%.2f" % v
+    end
+  end
+
   # Convenience: Termchart.spark([1,3,5,2,8], color: :green)
   def self.spark(values, color: nil)
     Spark.render(values, color: color)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: termchart
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - Geir Isene
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-18 00:00:00.000000000 Z
+date: 2026-03-21 00:00:00.000000000 Z
 dependencies: []
 description: Render sparklines, line charts (braille), candlestick charts, and bar
   charts as plain strings with ANSI color codes. Zero dependencies, pure Ruby.