tty-pie 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 11c000927f796d72dc81d3c669f54a8c3bd4ef61c3da69abf0b9057ddc8cbe60
-  data.tar.gz: d5504fe31f97866a694aeb8920787a6f88b865a4d7feae193eb6457e869f0e98
+  metadata.gz: 22d6cb76f39389059b746df28e9409d99ab1591d77edbe9f76bc1e9a7ea5e332
+  data.tar.gz: 9e735e70ab7286e7ae5a0ee3e2d949f0734f8e002b37cf82b685f31e7729b7f8
 SHA512:
-  metadata.gz: abb3e24bee240ea3262e3db8de2e88a1013591355c1385e155c32c01c34cc336b7ce873eb8a946905e2e09a086ce59bba36d053a33cc2015610347b468c283b6
-  data.tar.gz: 64891d4c43466f012af0594575f3197588cb40494cf35dacd2023bc5f59705601b9f6a898012b843cabc7a53dcbd0f170a086f057f727d947319fa0c0de60803
+  metadata.gz: 291a12624a6fd02557e4f47c7535580dc215574d3804df5c7da454be0d9f50514a1776e58ea7fd9f73008c3cfe4a3f6405b116864d603e7635b40c76c9179738
+  data.tar.gz: d248aef95ff8a16ba71dc28c3da25d13d65b5360effe61b5893fc7088f3c32e82406e83f8738f8708f6fd436cf684e9a7786d6a49587a8b02498b1deecf6f855

data/CHANGELOG.md

@@ -1,7 +1,24 @@
 # Change log
 
+## [v0.2.0] - 2019-01-11
+
+### Added
+* Add :colors for specifying array of colors to rotate through
+* Add :format, :precision & :delimiter keys to legend for declaring custom formatting
+* Add #reset call to clear data
+
+### Changed
+
+* Change to allow specifying fill characters via :fill parameter
+* Change #draw to #render to keep consistent with other libs
+* Change #update to return instance
+
+### Fixed
+* Fix legend alignment when paired with absolute positioning
+
 ## [v0.1.0] - 2018-08-14
 
 * Initial implementation and release
 
+[v0.2.0]: https://github.com/piotrmurach/tty-pie/compare/v0.1.0...v0.2.0
 [v0.1.0]: https://github.com/piotrmurach/tty-pie/compare/v0.1.0

data/README.md

@@ -48,14 +48,15 @@ Or install it yourself as:
   * [2.1 data](#21-data)
   * [2.2 add](#22-add)
   * [2.3 update](#23-update)
-  * [2.4 draw](#24-draw)
+  * [2.4 render](#24-render)
   * [2.5 position](#25-position)
   * [2.6 radius](#26-radius)
   * [2.7 legend](#27-legend)
+    * [2.7.1 format](#271-format)
 
 ## 1. Usage
 
-To draw a pie chart you need to provide an array of data items:
+To render a pie chart you need to provide an array of data items:
 
 ```ruby
 data = [
@@ -95,7 +96,7 @@ print pie_chart
 
 ### 2.1 data
 
-To draw a pie chart you need to provide data. A single data item is just a Ruby hash that can contain the following keys:
+To render a pie chart you need to provide data. A single data item is just a Ruby hash that can contain the following keys:
 
 * `:name` - used for setting the entry name in legend
 * `:value` - used for calculating actual pie slice size
@@ -185,14 +186,14 @@ new_data = [
 pie_chart.update(new_data)
 ```
 
-### 2.4 draw
+### 2.4 render
 
-Once a pie chart has been initialized use the `draw` or `to_s` method to return a string representation of the chart.
+Once a pie chart has been initialized use the `render` or `to_s` method to return a string representation of the chart.
 
 To actually show it in a terminal, you need to print it:
 
 ```ruby
-print pie_chart.draw
+print pie_chart.render
 # => this will render chart in terminal
 ```
 
@@ -235,6 +236,9 @@ You can control how the legend is displayed using the `:legend` keyword and hash
 
 * `:left` - used to determine spacing between a chart and a legend, defaults to `4` columns
 * `:line` - used to determine spacing between legend labels, defaults to `1` line
+* `:format` - used to format a display label using template named strings
+* `:precision` - used to determine currency display decimal places, defaults to `2`
+* `:delimiter` - used to set thousands delimiter in currency format
 
 For example, to place a legend `10` columns away from the pie chart and separate each label by `2` lines do:
 
@@ -256,6 +260,110 @@ print pie_chart
 #      +**               x LTC 18.37%
 ```
 
+#### 2.7.1 format
+
+The `:format` uses Ruby's [format sequences](https://ruby-doc.org/core-2.5.0/Kernel.html#method-i-format) and named strings placeholders:
+
+* `<label>` - the icon matching pie chart display
+* `<name>` - the label name provided in data
+* `<value>` - the label value provided in data, by default not displayed
+* `<currency>` - the label value formatted as currency
+* `<percent>` - the percent automatically calculated from data
+
+By default the label is formatted according to the following pattern with named strings:
+
+```ruby
+"%<label>s %<name>s %<percent>.2f%%"
+```
+
+Given data items:
+
+```ruby
+data = [
+  { name: 'BTC', value: 5977.12345, fill: '*' },
+  { name: 'BCH', value: 3045.2, fill: '+' },
+  { name: 'LTC', value: 2030.444, fill: 'x' }
+]
+```
+
+The legend will show:
+
+```ruby
+# =>
+#      x**       * BTC 54.08%
+#   xxxx*****
+# ++++xx*******
+# ++++++*******  + BCH 27.55%
+# ++++++*******
+#   ++++*****
+#      +**       x LTC 18.37%
+```
+
+To display value together with percent, use `<value>` named string in the format:
+
+```ruby
+legend: {
+  format: "%<label>s %<name>s %<value>d (%<percent>.2f%%)"
+}
+```
+
+The legend will show:
+
+```ruby
+# =>
+#      x**       * BTC 5977 (54.08%)
+#   xxxx*****
+# ++++xx*******
+# ++++++*******  + BCH 3045 (27.55%)
+# ++++++*******
+#   ++++*****
+#      +**       x LTC 2030 (18.37%)
+```
+
+To display value as currency use `<currency>` name string in the format:
+
+```ruby
+legend: {
+  format: "%<label>s %<name>s $%<currency>s (%<percent>.0f%%)"
+}
+```
+
+The legend will show:
+
+```ruby
+# =>
+#      x**       * BTC $5,977 (54%)
+#   xxxx*****
+# ++++xx*******
+# ++++++*******  + BCH $3,045 (28%)
+# ++++++*******
+#   ++++*****
+#      +**       x LTC $2,030 (18%)
+```
+
+The currency can be further customised using `:precision` and `:delimiter` keys:
+
+```ruby
+legend: {
+  format: "%<label>s %<name>s $%<currency>s (%<percent>.0f%%)",
+  precision: 3,
+  delimiter: '*'
+}
+```
+
+The legend will show:
+
+```ruby
+# =>
+#      x**       * BTC $5*977.123 (54%)
+#   xxxx*****
+# ++++xx*******
+# ++++++*******  + BCH $3*045.200 (28%)
+# ++++++*******
+#   ++++*****
+#      +**       x LTC $2*030.444 (18%)
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/examples/fill.rb

@@ -9,4 +9,4 @@ data = [
 
 pie = TTY::Pie.new(data: data, radius: 10)
 
-puts pie.draw
+puts pie

data/examples/format.rb

@@ -0,0 +1,16 @@
+require_relative '../lib/tty-pie'
+
+data = [
+  { name: 'BTC', value: 5977, color: :yellow },
+  { name: 'BCH', value: 3045, color: :green },
+  { name: 'LTC', value: 2030, color: :magenta },
+]
+
+pie = TTY::Pie.new(
+  data: data,
+  legend: {
+    format: "%<label>s %<name>s $%<currency>s (%<percent>.0f%%)"
+  }
+)
+
+puts pie

data/lib/tty/pie.rb

@@ -28,6 +28,8 @@ module TTY
 
     attr_reader :fill
 
+    attr_reader :colors
+
     attr_reader :legend
 
     # Create pie chart
@@ -41,23 +43,26 @@ module TTY
     # @param [Integer] top
     # @param [Integer] left
     # @param [Integer] radius
-    # @param [Boolean] legend
+    # @param [Hash,Boolean] legend
     # @param [String] fill
     # @param [Float] aspect_ratio
     #
     # @api public
-    def initialize(data: [], top: nil, left: nil, radius: 10, legend: {}, fill: POINT_SYMBOL, aspect_ratio: 2)
+    def initialize(data: [], top: nil, left: nil, radius: 10,
+                   legend: {}, fill: POINT_SYMBOL, aspect_ratio: 2,
+                   colors: [])
       @data = data.dup
       @top = top
       @left = left
       @radius = radius
       @legend = legend
-      @fill = fill
+      @fill = Array(fill)
+      @colors = Array(colors)
       @aspect_ratio = aspect_ratio
       @center_x = (left || 0) + radius * aspect_ratio
       @center_y = (top || 0) + radius
 
-      @pastel = Pastel.new
+      @pastel = Pastel.new(enabled: !!colors)
       @cursor = TTY::Cursor
     end
 
@@ -77,11 +82,11 @@ module TTY
     # @api private
     def data_items
       total_value = total
-      @data.map do |item|
+      @data.each_with_index.map do |item, i|
         percent = (item[:value] * 100) / total_value.to_f
-        color_fill = item[:fill] || fill
-        DataItem.new(item[:name], item[:value], percent,
-                     item.fetch(:color, false), color_fill)
+        color_fill = item[:fill] || fill[i % fill.size]
+        color = colors && !colors.empty? ? colors[i % colors.size] : item.fetch(:color, false)
+        DataItem.new(item[:name], item[:value], percent, color, color_fill)
       end
     end
 
@@ -105,6 +110,7 @@ module TTY
     # @api public
     def update(data)
       @data = data
+      self
     end
 
     # Draw a pie based on the provided data
@@ -112,12 +118,13 @@ module TTY
     # @return [String]
     #
     # @api public
-    def draw
+    def render
       items = data_items
+      return '' if items.empty?
       angles = data_angles(items)
       output = []
 
-      labels = items.map(&:to_label)
+      labels = items.map { |item| item.to_label(legend) }
       label_vert_space  = legend_line
       label_horiz_space = legend_left
       label_offset  = labels.size / 2
@@ -147,7 +154,9 @@ module TTY
             output << cursor.move_to(center_x + aspect_ratio * radius + label_horiz_space, center_y + y)
           end
           if labels_range.include?(y)
-            output << ' ' * ((center_x - width) + label_horiz_space) if top.nil?
+            if top.nil?
+              output << ' ' * ((center_x - (left.to_i + width)) + label_horiz_space)
+            end
             output << labels[label_offset + y / label_vert_space]
           end
         end
@@ -157,7 +166,16 @@ module TTY
 
       output.join
     end
-    alias to_s draw
+    alias to_s render
+
+    # Reset data
+    #
+    # @api public
+    def clear
+      @data = []
+      self
+    end
+    alias reset clear
 
     private
 

data/lib/tty/pie/data_item.rb

@@ -1,10 +1,13 @@
-# frozen_string_literal
+# frozen_string_literal: true
 
 require 'pastel'
 
 module TTY
   class Pie
+    # Encapsulates a single data item
     class DataItem
+      LABEL_FORMAT = '%<label>s %<name>s %<percent>.2f%%'
+
       attr_accessor :name
 
       attr_accessor :value
@@ -26,7 +29,7 @@ module TTY
         @color = color
         @percent = percent
         @fill = fill
-        @pastel = Pastel.new
+        @pastel = Pastel.new(enabled: !!color)
       end
 
       # The item start angle
@@ -38,13 +41,39 @@ module TTY
 
       # Convert a data item into a legend label
       #
+      # @param [Hash] legend
+      #
       # @return [String]
       #
       # @api private
-      def to_label
-        percent_fmt = '%.2f' % percent
+      def to_label(legend)
+        pattern   = legend && legend[:format] || LABEL_FORMAT
+        precision = legend && legend[:precision] || 2
+        delimiter = legend && legend[:delimiter] || ','
+
         label = color ? @pastel.decorate(fill, color) : fill
-        "#{label} #{name} #{percent_fmt}%"
+        currency = number_to_currency(value, precision: precision,
+                                             delimiter: delimiter)
+
+        format(pattern, label: label, name: name, value: value,
+                        percent: percent, currency: currency)
+      end
+
+      # Convert a number to a currency
+      #
+      # @param [Numeric] value
+      # @param [Integer] precision
+      # @param [String] delimiter
+      #
+      # @return [String]
+      #
+      # @api private
+      def number_to_currency(value, precision: 2, delimiter: ',')
+        whole, part = value.to_s.split('.')
+        unless part.nil?
+          part = format("%.#{precision}f", part.to_f / 10**part.size)[1..-1]
+        end
+        "#{whole.gsub(/(\d)(?=(\d{3})+(?!\d))/, "\\1#{delimiter}")}#{part}"
       end
     end
   end # Pie

data/lib/tty/pie/version.rb

@@ -2,6 +2,6 @@
 
 module TTY
   class Pie
-    VERSION = "0.1.0".freeze
+    VERSION = "0.2.0"
   end # Pie
 end # TTY

data/spec/unit/add_spec.rb

@@ -8,7 +8,7 @@ RSpec.describe TTY::Pie, '#add' do
     pie << { name: 'BCH', value: 3045, fill: '+' }
     pie << { name: 'LTC', value: 2030, fill: 'x' }
 
-    output = pie.draw
+    output = pie.render
 
     expect(output).to eq([
       "   x**       * BTC 54.08%\n",

data/spec/unit/color_spec.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 RSpec.describe TTY::Pie, ':color option' do
-  it "draws a pie chart without colors" do
+  it "renders a pie chart without colors" do
     data = [
       { name: 'BTC', value: 5977, fill: '*' },
       { name: 'BCH', value: 3045, fill: '+' },
@@ -9,7 +9,7 @@ RSpec.describe TTY::Pie, ':color option' do
     ]
     pie = TTY::Pie.new(data: data, radius: 2)
 
-    output = pie.draw
+    output = pie.render
 
     expect(output).to eq([
       "   x**       * BTC 54.08%\n",
@@ -20,7 +20,26 @@ RSpec.describe TTY::Pie, ':color option' do
     ].join)
   end
 
-  it "draws a pie chart with colors" do
+  it "renders a pie chart with colors as a parameter" do
+    data = [
+      { name: 'BTC', value: 5977, fill: '*' },
+      { name: 'BCH', value: 3045, fill: '+' },
+      { name: 'LTC', value: 2030, fill: 'x' }
+    ]
+    pie = TTY::Pie.new(data: data, radius: 2, colors: %i[yellow green magenta])
+
+    output = pie.render
+    expected_output = [
+      "   \e[35mx\e[0m\e[33m*\e[0m\e[33m*\e[0m       \e[33m*\e[0m BTC 54.08%\n",
+      " \e[32m+\e[0m\e[35mx\e[0m\e[35mx\e[0m\e[33m*\e[0m\e[33m*\e[0m\e[33m*\e[0m\e[33m*\e[0m\n",
+      "\e[32m+\e[0m\e[32m+\e[0m\e[32m+\e[0m\e[32m+\e[0m\e[33m*\e[0m\e[33m*\e[0m\e[33m*\e[0m\e[33m*\e[0m\e[33m*\e[0m    \e[32m+\e[0m BCH 27.55%\n",
+      " \e[32m+\e[0m\e[32m+\e[0m\e[32m+\e[0m\e[33m*\e[0m\e[33m*\e[0m\e[33m*\e[0m\e[33m*\e[0m\n",
+      "   \e[32m+\e[0m\e[33m*\e[0m\e[33m*\e[0m       \e[35mx\e[0m LTC 18.37%\n"
+    ].join
+    expect(output).to eq(expected_output)
+  end
+
+  it "renders a pie chart with colors" do
     data = [
       { name: 'BTC', value: 5977, color: :bright_yellow },
       { name: 'BCH', value: 3045, color: :bright_green },
@@ -28,7 +47,7 @@ RSpec.describe TTY::Pie, ':color option' do
     ]
     pie = TTY::Pie.new(data: data, radius: 2)
 
-    output = pie.draw
+    output = pie.render
 
     expect(output).to eq([
        "   \e[95m•\e[0m\e[93m•\e[0m\e[93m•\e[0m",
@@ -42,7 +61,7 @@ RSpec.describe TTY::Pie, ':color option' do
     ].join)
   end
 
-  it "draw a pie chart with legend and cursor positioning" do
+  it "renders a pie chart with legend and cursor positioning" do
     data = [
       { name: 'BTC', value: 5977, color: :bright_yellow },
       { name: 'BCH', value: 3045, color: :bright_green },
@@ -50,7 +69,7 @@ RSpec.describe TTY::Pie, ':color option' do
     ]
     pie = TTY::Pie.new(data: data, radius: 2, left: 50, top: 10)
 
-    output = pie.draw
+    output = pie.render
 
     expect(output).to eq([
       "\e[11;54H\e[95m•\e[0m\e[11;55H\e[93m•\e[0m\e[11;56H\e[93m•\e[0m",
@@ -64,7 +83,7 @@ RSpec.describe TTY::Pie, ':color option' do
     ].join)
   end
 
-  it "draw a pie chart without legend and with cursor positioning" do
+  it "renders a pie chart without legend and with cursor positioning" do
     data = [
       { name: 'BTC', value: 5977, color: :bright_yellow },
       { name: 'BCH', value: 3045, color: :bright_green },
@@ -72,7 +91,7 @@ RSpec.describe TTY::Pie, ':color option' do
     ]
     pie = TTY::Pie.new(data: data, radius: 2, left: 50, top: 10, legend: false)
 
-    output = pie.draw
+    output = pie.render
 
     expect(output).to eq([
       "\e[11;54H\e[95m•\e[0m\e[11;55H\e[93m•\e[0m\e[11;56H\e[93m•\e[0m\n",

data/spec/unit/fill_spec.rb

@@ -9,10 +9,10 @@ RSpec.describe TTY::Pie, ':fill option' do
     ]
   }
 
-  it "draws a pie chart with custom fill per data item" do
+  it "renders a pie chart with custom fill per data item" do
      pie = TTY::Pie.new(data: data, radius: 2)
 
-     output = pie.draw
+     output = pie.render
 
      expect(output).to eq([
         "   \e[95mx\e[0m\e[93m*\e[0m\e[93m*\e[0m",
@@ -24,4 +24,24 @@ RSpec.describe TTY::Pie, ':fill option' do
         "       \e[95mx\e[0m LTC 18.37%\n"
      ].join)
   end
+
+  it "renders with custom fill chars per instance" do
+     data_without_fill = data.map { |item| item.delete(:fill); item }
+     pie = TTY::Pie.new(data: data_without_fill, radius: 2, fill: %w[* + x])
+
+     output = pie.render
+
+     expected_output = [
+        "   \e[95mx\e[0m\e[93m*\e[0m\e[93m*\e[0m",
+        "       \e[93m*\e[0m BTC 54.08%\n",
+        " \e[92m+\e[0m\e[95mx\e[0m\e[95mx\e[0m\e[93m*\e[0m\e[93m*\e[0m\e[93m*\e[0m\e[93m*\e[0m\n\e[92m+\e[0m\e[92m+\e[0m\e[92m+\e[0m\e[92m+\e[0m\e[93m*\e[0m\e[93m*\e[0m\e[93m*\e[0m\e[93m*\e[0m\e[93m*\e[0m",
+        "    \e[92m+\e[0m BCH 27.55%\n",
+        " \e[92m+\e[0m\e[92m+\e[0m\e[92m+\e[0m\e[93m*\e[0m\e[93m*\e[0m\e[93m*\e[0m\e[93m*\e[0m\n",
+        "   \e[92m+\e[0m\e[93m*\e[0m\e[93m*\e[0m",
+        "       \e[95mx\e[0m LTC 18.37%\n"
+
+     ].join
+
+     expect(output).to eq(expected_output)
+  end
 end

data/spec/unit/legend_spec.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 RSpec.describe TTY::Pie, ':legend option' do
-  it "draws legend at default location with 1 line separator" do
+  it "renders legend at default location with 1 line separator" do
     data = [
       { name: 'BTC', value: 5977, fill: '*' },
       { name: 'BCH', value: 3045, fill: '+' },
@@ -10,7 +10,7 @@ RSpec.describe TTY::Pie, ':legend option' do
 
     pie = TTY::Pie.new(data: data, radius: 2)
 
-    output = pie.draw
+    output = pie.render
 
     expect(output).to eq([
       "   x**       * BTC 54.08%\n",
@@ -21,7 +21,7 @@ RSpec.describe TTY::Pie, ':legend option' do
     ].join)
   end
 
-  it "draws legend next to chart without any line separator" do
+  it "renders legend next to chart without any line separator" do
     data = [
       { name: 'BTC', value: 5977, fill: '*' },
       { name: 'BCH', value: 3045, fill: '+' },
@@ -30,7 +30,7 @@ RSpec.describe TTY::Pie, ':legend option' do
 
     pie = TTY::Pie.new(data: data, radius: 2, legend: {left: 0, line: 0})
 
-    output = pie.draw
+    output = pie.render
 
     expect(output).to eq([
       "   x**\n",
@@ -41,7 +41,7 @@ RSpec.describe TTY::Pie, ':legend option' do
     ].join)
   end
 
-  it "draws legend at custom location with line separator" do
+  it "renders legend at custom location with line separator" do
     data = [
       { name: 'BTC', value: 5977, fill: '*' },
       { name: 'BCH', value: 3045, fill: '+' },
@@ -50,7 +50,7 @@ RSpec.describe TTY::Pie, ':legend option' do
 
     pie = TTY::Pie.new(data: data, radius: 3, legend: {left: 10, line: 2})
 
-    output = pie.draw
+    output = pie.render
 
     expect(output).to eq([
       "     x**               * BTC 54.08%\n",
@@ -62,4 +62,106 @@ RSpec.describe TTY::Pie, ':legend option' do
       "     +**               x LTC 18.37%\n"
     ].join)
   end
+
+  it "renders legend next to chart without any line separator" do
+    data = [
+      { name: 'BTC', value: 5977, fill: '*' },
+      { name: 'BCH', value: 3045, fill: '+' },
+      { name: 'LTC', value: 2030, fill: 'x' }
+    ]
+
+    pie = TTY::Pie.new(data: data, left: 2, top: 2, radius: 2, legend: {left: 2, line: 0})
+
+    output = pie.render
+
+    expected_output = [
+      "\e[3;6Hx\e[3;7H*\e[3;8H*\e[3;13H\n",
+      "\e[4;4H+\e[4;5Hx\e[4;6Hx\e[4;7H*\e[4;8H*\e[4;9H*\e[4;10H*\e[4;13H* BTC 54.08%\n",
+      "\e[5;3H+\e[5;4H+\e[5;5H+\e[5;6H+\e[5;7H*\e[5;8H*\e[5;9H*\e[5;10H*\e[5;11H*\e[5;13H+ BCH 27.55%\n",
+      "\e[6;4H+\e[6;5H+\e[6;6H+\e[6;7H*\e[6;8H*\e[6;9H*\e[6;10H*\e[6;13Hx LTC 18.37%\n",
+      "\e[7;6H+\e[7;7H*\e[7;8H*\e[7;13H\n"
+    ].join
+
+    expect(output).to eq(expected_output)
+  end
+
+  it "renders legend with a custom format" do
+    data = [
+      { name: 'BTC', value: 5977, fill: '*' },
+      { name: 'BCH', value: 3045, fill: '+' },
+      { name: 'LTC', value: 2030, fill: 'x' }
+    ]
+
+    pie = TTY::Pie.new(
+      data: data,
+      radius: 2,
+      legend: {
+        format: "%<label>s %<name>s %<value>d (%<percent>.2f%%)"
+      }
+    )
+
+    output = pie.render
+
+    expect(output).to eq([
+      "   x**       * BTC 5977 (54.08%)\n",
+      " +xx****\n",
+      "++++*****    + BCH 3045 (27.55%)\n",
+      " +++****\n",
+      "   +**       x LTC 2030 (18.37%)\n"
+    ].join)
+  end
+
+  it "renders legend with a custom format & value as currency" do
+    data = [
+      { name: 'BTC', value: 5977.12345, fill: '*' },
+      { name: 'BCH', value: 3045.2, fill: '+' },
+      { name: 'LTC', value: 2030.444, fill: 'x' }
+    ]
+
+    pie = TTY::Pie.new(
+      data: data,
+      radius: 2,
+      legend: {
+        format: "%<label>s %<name>s $%<currency>s (%<percent>.0f%%)"
+      }
+    )
+
+    output = pie.render
+
+    expect(output).to eq([
+      "   x**       * BTC $5,977.12 (54%)\n",
+      " +xx****\n",
+      "++++*****    + BCH $3,045.20 (28%)\n",
+      " +++****\n",
+      "   +**       x LTC $2,030.44 (18%)\n"
+    ].join)
+  end
+
+  it "renders legend with a custom format and currency precision & delimiter" do
+    data = [
+      { name: 'BTC', value: 5977.12345, fill: '*' },
+      { name: 'BCH', value: 3045.2, fill: '+' },
+      { name: 'LTC', value: 2030.444, fill: 'x' }
+    ]
+
+    pie = TTY::Pie.new(
+      data: data,
+      radius: 2,
+      legend: {
+        format: "%<label>s %<name>s $%<currency>s (%<percent>.0f%%)",
+        precision: 3,
+        delimiter: '*'
+      }
+    )
+
+    output = pie.render
+
+    expect(output).to eq([
+      "   x**       * BTC $5*977.123 (54%)\n",
+      " +xx****\n",
+      "++++*****    + BCH $3*045.200 (28%)\n",
+      " +++****\n",
+      "   +**       x LTC $2*030.444 (18%)\n"
+    ].join)
+  end
 end

data/spec/unit/{draw_spec.rb → render_spec.rb}

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-RSpec.describe TTY::Pie, '#draw' do
+RSpec.describe TTY::Pie, '#render' do
   let(:data) {
     [
       { name: 'BTC', value: 5977 },
@@ -9,10 +9,16 @@ RSpec.describe TTY::Pie, '#draw' do
     ]
   }
 
-  it "draws a pie chart with legend and without cursor positioning" do
+  it "renders chart with no data" do
+    pie = TTY::Pie.new(data: [], radius: 2)
+
+    expect(pie.render).to eq('')
+  end
+
+  it "renders a pie chart with legend and without cursor positioning" do
     pie = TTY::Pie.new(data: data, radius: 2)
 
-    output = pie.draw
+    output = pie.render
 
     expect(output).to eq([
        "   •••       • BTC 54.08%\n",
@@ -23,10 +29,10 @@ RSpec.describe TTY::Pie, '#draw' do
     ].join)
   end
 
-  it "draws a pie chart without legend and without cursor positioning" do
+  it "renders a pie chart without legend and without cursor positioning" do
     pie = TTY::Pie.new(data: data, radius: 2, legend: false)
 
-    output = pie.draw
+    output = pie.render
 
     expect(output).to eq([
        "   •••\n",
@@ -37,10 +43,10 @@ RSpec.describe TTY::Pie, '#draw' do
     ].join)
   end
 
-  it "draw a pie chart with legend and cursor positioning" do
+  it "render a pie chart with legend and cursor positioning" do
     pie = TTY::Pie.new(data: data, radius: 2, left: 50, top: 10)
 
-    output = pie.draw
+    output = pie.render
 
     expect(output).to eq([
       "\e[11;54H•\e[11;55H•\e[11;56H•\e[11;63H• BTC 54.08%\n",
@@ -52,10 +58,10 @@ RSpec.describe TTY::Pie, '#draw' do
     ].join)
   end
 
-  it "draw a pie chart without legend and with cursor positioning" do
+  it "render a pie chart without legend and with cursor positioning" do
     pie = TTY::Pie.new(data: data, radius: 2, left: 50, top: 10, legend: false)
 
-    output = pie.draw
+    output = pie.render
 
     expect(output).to eq([
       "\e[11;54H\•\e[11;55H•\e[11;56H•\n",

data/spec/unit/reset_spec.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+RSpec.describe TTY::Pie, '#reset' do
+  it "resets current data" do
+    data = [ { name: 'BTC', value: 5977, fill: '*' } ]
+
+    pie = TTY::Pie.new(data: data, radius: 2)
+
+    output = pie.render
+
+    expect(output).to eq([
+      "   ***\n",
+      " *******\n",
+      "*********    * BTC 100.00%\n",
+      " *******\n",
+      "   ***\n"
+    ].join)
+
+    pie.reset
+
+    expect(pie.render).to eq('')
+  end
+end

data/spec/unit/update_spec.rb

@@ -6,7 +6,7 @@ RSpec.describe TTY::Pie, '#update' do
 
     pie = TTY::Pie.new(data: data, radius: 2)
 
-    output = pie.draw
+    output = pie.render
 
     expect(output).to eq([
       "   ***\n",
@@ -18,7 +18,7 @@ RSpec.describe TTY::Pie, '#update' do
 
     pie.update([{name: 'LTC', value: 2030, fill: 'x'}])
 
-    output = pie.draw
+    output = pie.render
 
     expect(output).to eq([
       "   xxx\n",

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tty-pie
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Piotr Murach
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-12-25 00:00:00.000000000 Z
+date: 2019-01-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pastel
@@ -95,6 +95,7 @@ files:
 - bin/setup
 - examples/basic.rb
 - examples/fill.rb
+- examples/format.rb
 - lib/tty-pie.rb
 - lib/tty/pie.rb
 - lib/tty/pie/data_item.rb
@@ -102,9 +103,10 @@ files:
 - spec/spec_helper.rb
 - spec/unit/add_spec.rb
 - spec/unit/color_spec.rb
-- spec/unit/draw_spec.rb
 - spec/unit/fill_spec.rb
 - spec/unit/legend_spec.rb
+- spec/unit/render_spec.rb
+- spec/unit/reset_spec.rb
 - spec/unit/update_spec.rb
 - tasks/console.rake
 - tasks/coverage.rake