tty-pie 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 11c000927f796d72dc81d3c669f54a8c3bd4ef61c3da69abf0b9057ddc8cbe60
+  data.tar.gz: d5504fe31f97866a694aeb8920787a6f88b865a4d7feae193eb6457e869f0e98
+SHA512:
+  metadata.gz: abb3e24bee240ea3262e3db8de2e88a1013591355c1385e155c32c01c34cc336b7ce873eb8a946905e2e09a086ce59bba36d053a33cc2015610347b468c283b6
+  data.tar.gz: 64891d4c43466f012af0594575f3197588cb40494cf35dacd2023bc5f59705601b9f6a898012b843cabc7a53dcbd0f170a086f057f727d947319fa0c0de60803

data/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Change log
+
+## [v0.1.0] - 2018-08-14
+
+* Initial implementation and release
+
+[v0.1.0]: https://github.com/piotrmurach/tty-pie/compare/v0.1.0

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 Piotr Murach
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,279 @@
+<div align="center">
+  <a href="https://piotrmurach.github.io/tty" target="_blank"><img width="130" src="https://github.com/piotrmurach/tty/blob/master/images/tty.png" alt="tty logo" /></a>
+</div>
+
+# TTY:Pie [![Gitter](https://badges.gitter.im/Join%20Chat.svg)][gitter]
+
+[![Gem Version](https://badge.fury.io/rb/tty-pie.svg)][gem]
+[![Build Status](https://secure.travis-ci.org/piotrmurach/tty-pie.svg?branch=master)][travis]
+[![Build status](https://ci.appveyor.com/api/projects/status/9n69xpw64sylqh2y?svg=true)][appveyor]
+[![Maintainability](https://api.codeclimate.com/v1/badges/dfac05073e1549e9dbb6/maintainability)][codeclimate]
+[![Coverage Status](https://coveralls.io/repos/github/piotrmurach/tty-pie/badge.svg)][coverage]
+[![Inline docs](http://inch-ci.org/github/piotrmurach/tty-pie.svg?branch=master)][inchpages]
+
+[gitter]: https://gitter.im/piotrmurach/tty
+[gem]: http://badge.fury.io/rb/tty-pie
+[travis]: http://travis-ci.org/piotrmurach/tty-pie
+[appveyor]: https://ci.appveyor.com/project/piotrmurach/tty-pie
+[codeclimate]: https://codeclimate.com/github/piotrmurach/tty-pie/maintainability
+[coverage]: https://coveralls.io/github/piotrmurach/tty-pie
+[inchpages]: http://inch-ci.org/github/piotrmurach/tty-pie
+
+> Draw pie charts in your terminal window
+
+**TTY::Pie** provides pie chart drawing component for [TTY](https://github.com/piotrmurach/tty) toolkit.
+
+![Pie chart drawing](https://github.com/piotrmurach/tty-pie/blob/master/assets/tty-pie_chart_drawing_crypto.png)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'tty-pie'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install tty-pie
+
+## Contents
+
+* [1. Usage](#1-usage)
+* [2. Interface](#2-interface)
+  * [2.1 data](#21-data)
+  * [2.2 add](#22-add)
+  * [2.3 update](#23-update)
+  * [2.4 draw](#24-draw)
+  * [2.5 position](#25-position)
+  * [2.6 radius](#26-radius)
+  * [2.7 legend](#27-legend)
+
+## 1. Usage
+
+To draw a pie chart you need to provide an array of data items:
+
+```ruby
+data = [
+  { name: 'BTC', value: 5977, color: :bright_yellow, fill: '*' },
+  { name: 'BCH', value: 3045, color: :bright_green, fill: 'x' },
+  { name: 'LTC', value: 2030, color: :bright_magenta, fill: '@' },
+  { name: 'ETH', value: 2350, color: :bright_cyan, fill: '+' }
+]
+```
+
+Then pass data to **TTY::Pie** instance with a given radius:
+
+```ruby
+pie_chart = TTY::Pie.new(data: data, radius: 5)
+```
+
+and print the pie chart in your terminal window:
+
+```ruby
+print pie_chart
+# =>
+#         ++***
+#     ++++++*******        * BTC 44.60%
+#   @@@+++++*********
+#  @@@@@@+++**********     x BCH 22.72%
+# @@@@@@@@@+***********
+# @@@@@@@@@@x**********    @ LTC 15.15%
+# @@@@@@@@@xx**********
+#  @@@@@@xxxx*********     + ETH 17.53%
+#   @@@xxxxxxx*******
+#     xxxxxxxx*****
+#         xxxx*
+# 
+```
+
+## 2. Interface
+
+### 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:
+
+* `:name` - used for setting the entry name in legend
+* `:value` - used for calculating actual pie slice size
+* `:color` - used to color a pie slice corresponding with a value
+* `:fill` - used as a character to fill in a pie slice
+
+At the very minimum you need to provide a `:value` in order for a pie to calculate slice sizes. If you wish to have a legend then add the `:name` key as well.
+
+For example, the following will result in four slices in a pie chart:
+
+```ruby
+data = [
+  { name: 'BTC', value: 5977 },
+  { name: 'BCH', value: 3045 },
+  { name: 'LTC', value: 2030 },
+  { name: 'ETH', value: 2350 }
+]
+```
+
+However, the above data slices will be displayed without any color. Use `:color` out of [supported colors](https://github.com/piotrmurach/pastel#3-supported-colors):
+
+```ruby
+data = [
+  { name: 'BTC', value: 5977, color: :bright_yellow },
+  { name: 'BCH', value: 3045, color: :bright_green },
+  { name: 'LTC', value: 2030, color: :bright_magenta },
+  { name: 'ETH', value: 2350, color: :bright_cyan }
+]
+```
+
+To further make your chart readable consider making pie chart slices visible by channging the displayed characters using `:fill` key:
+
+```ruby
+data = [
+  { name: 'BTC', value: 5977, color: :bright_yellow, fill: '*' },
+  { name: 'BCH', value: 3045, color: :bright_green, fill: 'x' },
+  { name: 'LTC', value: 2030, color: :bright_magenta, fill: '@' },
+  { name: 'ETH', value: 2350, color: :bright_cyan, fill: '+' }
+]
+```
+
+There is no limit to the amount of data you can present, however there is a point of scale and legibility to be considered when printing in the terminals.
+
+You can add data to pie chart during initialization using `:data` keyword:
+
+```ruby
+pie_chart = TTY::Pie.new(data: data)
+```
+
+Alternatively, you can delay adding data later with `add` or `<<` methods:
+
+```ruby
+pie_chart = TTY::Pie.new
+pie_chart << { name: 'BTC', value: 5977, color: :bright_yellow, fill: '*' }
+pie_chart << { name: 'BCH', value: 3045, color: :bright_green, fill: 'x' }
+pie_chart << { name: 'LTC', value: 2030, color: :bright_magenta, fill: '@' }
+pie_chart << { name: 'ETH', value: 2350, color: :bright_cyan, fill: '+' }
+```
+
+### 2.2 add
+
+You can also set data for the pie chart using the `add` or `<<` method calls. Once a pie chart is initialized, you can add data items:
+
+```ruby
+pie_chart = TTY::Pie.new
+pie_chart << { name: 'BTC', value: 5977, color: :bright_yellow, fill: '*' }
+pie_chart << { name: 'BCH', value: 3045, color: :bright_green, fill: 'x' }
+...
+```
+
+### 2.3 update
+
+To replace current data completely with the new use `update`:
+
+```ruby
+data = [
+  { name: 'BTC', value: 5977, color: :bright_yellow, fill: '*' },
+  { name: 'BCH', value: 3045, color: :bright_green, fill: 'x' }
+]
+pie_chart = TTY::Pie.new(data: data)
+
+new_data = [
+  { name: 'BTC', value: 3400, color: :bright_yellow, fill: '*' },
+  { name: 'BCH', value: 1200, color: :bright_green, fill: 'x' },
+]
+
+pie_chart.update(new_data)
+```
+
+### 2.4 draw
+
+Once a pie chart has been initialized use the `draw` 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
+# => this will render chart in terminal
+```
+
+You can skip calling any method and simply print:
+
+```ruby
+print pie_chart
+# => this will render chart in terminal
+```
+
+### 2.5 position
+
+If you don't provide location for you pie chart it will be printed at the current cursor location. In order to absolutely position the chart use `:left` and `:top` keyword arguments. For example, if you wanted to position the pie chart at `50th`column and `10th` row:
+
+```ruby
+TTY::Pie.new(data: data, left: 50, top: 10)
+```
+
+### 2.6 radius
+
+By default, a pie chart is rendered with a radius of `10`, you can change this using the `:radius` keyword:
+
+```ruby
+TTY::Pie.new(data: data, radius: 5)
+```
+
+### 2.7 legend
+
+Provided the following data:
+
+```ruby
+data = [
+  { name: 'BTC', value: 5977, fill: '*' },
+  { name: 'BCH', value: 3045, fill: '+' },
+  { name: 'LTC', value: 2030, fill: 'x' }
+]
+```
+
+You can control how the legend is displayed using the `:legend` keyword and hash as value with the following keys:
+
+* `: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
+
+For example, to place a legend `10` columns away from the pie chart and separate each label by `2` lines do:
+
+```ruby
+pie_chart = TTY::Pie.new(data: data, radius: 3, legend: {left: 10, line: 2})
+```
+
+And printing in a terminal will produce:
+
+```ruby
+print pie_chart
+# =>
+#      x**               * BTC 54.08%
+#   xxxx*****
+# ++++xx*******
+# ++++++*******          + BCH 27.55%
+# ++++++*******
+#   ++++*****
+#      +**               x LTC 18.37%
+```
+
+## 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.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/piotrmurach/tty-pie_chart. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the TTY::Pie project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/piotrmurach/tty-pie_chart/blob/master/CODE_OF_CONDUCT.md).
+
+## Copyright
+
+Copyright (c) 2018 Piotr Murach. See [LICENSE.txt](https://github.com/piotrmurach/tty-pie_chart/blob/master/LICENSE.txt) for further details.

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/gem_tasks"
+
+FileList['tasks/**/*.rake'].each(&method(:import))
+
+desc 'Run all specs'
+task ci: %w[ spec ]
+
+task default: :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "tty/pie_chart"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/examples/basic.rb

@@ -0,0 +1,12 @@
+require_relative '../lib/tty-pie'
+
+data = [
+  { name: 'BTC', value: 5977, color: :bright_yellow },
+  { name: 'BCH', value: 3045, color: :bright_green },
+  { name: 'LTC', value: 2030, color: :bright_magenta },
+  { name: 'ETH', value: 2350, color: :bright_cyan }
+]
+
+pie = TTY::Pie.new(data: data, radius: 10)
+
+puts pie

data/examples/fill.rb

@@ -0,0 +1,12 @@
+require_relative '../lib/tty-pie'
+
+data = [
+  { name: 'BTC', value: 5977, color: :bright_yellow, fill: '*' },
+  { name: 'BCH', value: 3045, color: :bright_green, fill: 'x' },
+  { name: 'LTC', value: 2030, color: :bright_magenta, fill: '@' },
+  { name: 'ETH', value: 2350, color: :bright_cyan, fill: '+' }
+]
+
+pie = TTY::Pie.new(data: data, radius: 10)
+
+puts pie.draw

data/lib/tty-pie.rb

@@ -0,0 +1 @@
+require_relative 'tty/pie'

data/lib/tty/pie.rb

@@ -0,0 +1,216 @@
+# frozen_string_literal: true
+
+require 'pastel'
+require 'tty-cursor'
+
+require_relative 'pie/data_item'
+require_relative 'pie/version'
+
+module TTY
+  class Pie
+    FULL_CIRCLE_DEGREES = 360
+
+    POINT_SYMBOL = '•'
+
+    LEGEND_LINE_SPACE = 1
+
+    LEGEND_LEFT_SPACE = 4
+
+    attr_reader :top, :left
+
+    attr_reader :center_x, :center_y
+
+    attr_reader :radius
+
+    attr_reader :aspect_ratio
+
+    attr_reader :cursor
+
+    attr_reader :fill
+
+    attr_reader :legend
+
+    # Create pie chart
+    #
+    # @example
+    #   data = [ { name: 'BTC', value: 5977, fill: '*' } ]
+    #   pie_chart = TTY::Pie.new(data: data, radius: 2)
+    #
+    # @param [Array[Hash]] data
+    #   the data to display in each slice
+    # @param [Integer] top
+    # @param [Integer] left
+    # @param [Integer] radius
+    # @param [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)
+      @data = data.dup
+      @top = top
+      @left = left
+      @radius = radius
+      @legend = legend
+      @fill = fill
+      @aspect_ratio = aspect_ratio
+      @center_x = (left || 0) + radius * aspect_ratio
+      @center_y = (top || 0) + radius
+
+      @pastel = Pastel.new
+      @cursor = TTY::Cursor
+    end
+
+    # Total for the data items
+    #
+    # @return [Integer]
+    #
+    # @api private
+    def total
+      @data.inject(0) { |sum, item| sum += item[:value]; sum }
+    end
+
+    # Convert data into DataItems
+    #
+    # @return [Array[DataItem]]
+    #
+    # @api private
+    def data_items
+      total_value = total
+      @data.map do |item|
+        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)
+      end
+    end
+
+    # Add a data item
+    #
+    # @param [Hash]
+    #
+    # @return [self]
+    #
+    # @api public
+    def add(item)
+      @data << item
+      self
+    end
+    alias << add
+
+    # Replace current data with new set
+    #
+    # @param [Array[Hash]]
+    #
+    # @api public
+    def update(data)
+      @data = data
+    end
+
+    # Draw a pie based on the provided data
+    #
+    # @return [String]
+    #
+    # @api public
+    def draw
+      items = data_items
+      angles = data_angles(items)
+      output = []
+
+      labels = items.map(&:to_label)
+      label_vert_space  = legend_line
+      label_horiz_space = legend_left
+      label_offset  = labels.size / 2
+      label_boundry = label_vert_space * label_offset
+      labels_range  = (-label_boundry..label_boundry).step(label_vert_space)
+
+      (-radius..radius).each do |y|
+        width = (Math.sqrt(radius * radius - y * y) * aspect_ratio).round
+        width = width.zero? ? (radius / aspect_ratio).round : width
+
+        output << ' ' * (center_x - width) if top.nil?
+        (-width..width).each do |x|
+          angle = radian_to_degree(Math.atan2(x, y))
+          item = items[select_data_item(angle, angles)]
+          if !top.nil?
+            output << cursor.move_to(center_x + x, center_y + y)
+          end
+          if item.color
+            output << @pastel.decorate(item.fill, item.color)
+          else
+            output << item.fill
+          end
+        end
+
+        if legend
+          if !top.nil?
+            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?
+            output << labels[label_offset + y / label_vert_space]
+          end
+        end
+
+        output << "\n"
+      end
+
+      output.join
+    end
+    alias to_s draw
+
+    private
+
+    # All angles from the data to slice the pie
+    #
+    # @return [Array[Numeric]]
+    #
+    # @api private
+    def data_angles(items)
+      start_angle = 0
+      items.reduce([]) do |acc, item|
+        acc << start_angle + item.angle
+        start_angle += item.angle
+        acc
+      end
+    end
+
+    # The space between a legend and a chart
+    #
+    # @return [Integer]
+    #
+    # @api private
+    def legend_left
+      legend ? legend.fetch(:left, LEGEND_LEFT_SPACE) : LEGEND_LEFT_SPACE
+    end
+
+    # The space between each legend item
+    #
+    # @return [Integer]
+    #
+    # @api private
+    def legend_line
+      (legend ? legend.fetch(:line, LEGEND_LINE_SPACE) : LEGEND_LINE_SPACE) + 1
+    end
+
+    # Select data item index based on angle
+    #
+    # @return [Integer]
+    #
+    # @api private
+    def select_data_item(angle, angles)
+      angles.index { |a| (FULL_CIRCLE_DEGREES / 2 - angle) < a }
+    end
+
+    # Convert radians to degrees
+    #
+    # @param [Float] radians
+    #
+    # @return [Float]
+    #
+    # @api private
+    def radian_to_degree(radians)
+      radians * 180 / Math::PI
+    end
+  end # Pie
+end # TTY

data/lib/tty/pie/data_item.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal
+
+require 'pastel'
+
+module TTY
+  class Pie
+    class DataItem
+      attr_accessor :name
+
+      attr_accessor :value
+
+      attr_accessor :percent
+
+      attr_writer :angle
+
+      attr_accessor :color
+
+      attr_accessor :fill
+
+      # Creat a DataItem
+      #
+      # @api private
+      def initialize(name, value, percent, color, fill)
+        @name = name
+        @value = value
+        @color = color
+        @percent = percent
+        @fill = fill
+        @pastel = Pastel.new
+      end
+
+      # The item start angle
+      #
+      # @api private
+      def angle
+        percent * FULL_CIRCLE_DEGREES / 100.to_f
+      end
+
+      # Convert a data item into a legend label
+      #
+      # @return [String]
+      #
+      # @api private
+      def to_label
+        percent_fmt = '%.2f' % percent
+        label = color ? @pastel.decorate(fill, color) : fill
+        "#{label} #{name} #{percent_fmt}%"
+      end
+    end
+  end # Pie
+end # TTY

data/lib/tty/pie/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module TTY
+  class Pie
+    VERSION = "0.1.0".freeze
+  end # Pie
+end # TTY

data/spec/spec_helper.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+if ENV['COVERAGE'] || ENV['TRAVIS']
+  require 'simplecov'
+  require 'coveralls'
+
+  SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
+    SimpleCov::Formatter::HTMLFormatter,
+    Coveralls::SimpleCov::Formatter
+  ]
+
+  SimpleCov.start do
+    command_name 'spec'
+    add_filter 'spec'
+  end
+end
+
+require "bundler/setup"
+require "tty/pie"
+
+RSpec.configure do |config|
+  # Enable flags like --only-failures and --next-failure
+  config.example_status_persistence_file_path = ".rspec_status"
+
+  # Disable RSpec exposing methods globally on `Module` and `main`
+  config.disable_monkey_patching!
+
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+end

data/spec/unit/add_spec.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+RSpec.describe TTY::Pie, '#add' do
+  it "adds additional item" do
+    data = [ { name: 'BTC', value: 5977, fill: '*' } ]
+
+    pie = TTY::Pie.new(data: data, radius: 2)
+    pie << { name: 'BCH', value: 3045, fill: '+' }
+    pie << { name: 'LTC', value: 2030, fill: 'x' }
+
+    output = pie.draw
+
+    expect(output).to eq([
+      "   x**       * BTC 54.08%\n",
+      " +xx****\n",
+      "++++*****    + BCH 27.55%\n",
+      " +++****\n",
+      "   +**       x LTC 18.37%\n"
+    ].join)
+  end
+
+  it "adds item without modifying original data source" do
+    data = [ { name: 'BTC', value: 5977, fill: '*' } ]
+    pie = TTY::Pie.new(data: data, radius: 2)
+    pie << { name: 'BCH', value: 3045, fill: '+' }
+
+    expect(data).to match([a_hash_including(name: 'BTC')])
+  end
+end

data/spec/unit/color_spec.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+RSpec.describe TTY::Pie, ':color option' do
+  it "draws a pie chart without colors" 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)
+
+    output = pie.draw
+
+    expect(output).to eq([
+      "   x**       * BTC 54.08%\n",
+      " +xx****\n",
+      "++++*****    + BCH 27.55%\n",
+      " +++****\n",
+      "   +**       x LTC 18.37%\n"
+    ].join)
+  end
+
+  it "draws a pie chart with colors" do
+    data = [
+      { name: 'BTC', value: 5977, color: :bright_yellow },
+      { name: 'BCH', value: 3045, color: :bright_green },
+      { name: 'LTC', value: 2030, color: :bright_magenta }
+    ]
+    pie = TTY::Pie.new(data: data, radius: 2)
+
+    output = pie.draw
+
+    expect(output).to eq([
+       "   \e[95m•\e[0m\e[93m•\e[0m\e[93m•\e[0m",
+       "       \e[93m•\e[0m BTC 54.08%\n",
+       " \e[92m•\e[0m\e[95m•\e[0m\e[95m•\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[95m•\e[0m LTC 18.37%\n"
+    ].join)
+  end
+
+  it "draw a pie chart with legend and cursor positioning" do
+    data = [
+      { name: 'BTC', value: 5977, color: :bright_yellow },
+      { name: 'BCH', value: 3045, color: :bright_green },
+      { name: 'LTC', value: 2030, color: :bright_magenta }
+    ]
+    pie = TTY::Pie.new(data: data, radius: 2, left: 50, top: 10)
+
+    output = pie.draw
+
+    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",
+      "\e[11;63H\e[93m•\e[0m BTC 54.08%\n",
+      "\e[12;52H\e[92m•\e[0m\e[12;53H\e[95m•\e[0m\e[12;54H\e[95m•\e[0m\e[12;55H\e[93m•\e[0m\e[12;56H\e[93m•\e[0m\e[12;57H\e[93m•\e[0m\e[12;58H\e[93m•\e[0m\e[12;63H\n",
+      "\e[13;51H\e[92m•\e[0m\e[13;52H\e[92m•\e[0m\e[13;53H\e[92m•\e[0m\e[13;54H\e[92m•\e[0m\e[13;55H\e[93m•\e[0m\e[13;56H\e[93m•\e[0m\e[13;57H\e[93m•\e[0m\e[13;58H\e[93m•\e[0m\e[13;59H\e[93m•\e[0m",
+      "\e[13;63H\e[92m•\e[0m BCH 27.55%\n",
+      "\e[14;52H\e[92m•\e[0m\e[14;53H\e[92m•\e[0m\e[14;54H\e[92m•\e[0m\e[14;55H\e[93m•\e[0m\e[14;56H\e[93m•\e[0m\e[14;57H\e[93m•\e[0m\e[14;58H\e[93m•\e[0m\e[14;63H\n",
+      "\e[15;54H\e[92m•\e[0m\e[15;55H\e[93m•\e[0m\e[15;56H\e[93m•\e[0m",
+      "\e[15;63H\e[95m•\e[0m LTC 18.37%\n"
+    ].join)
+  end
+
+  it "draw 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 },
+      { name: 'LTC', value: 2030, color: :bright_magenta }
+    ]
+    pie = TTY::Pie.new(data: data, radius: 2, left: 50, top: 10, legend: false)
+
+    output = pie.draw
+
+    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",
+      "\e[12;52H\e[92m•\e[0m\e[12;53H\e[95m•\e[0m\e[12;54H\e[95m•\e[0m\e[12;55H\e[93m•\e[0m\e[12;56H\e[93m•\e[0m\e[12;57H\e[93m•\e[0m\e[12;58H\e[93m•\e[0m\n",
+      "\e[13;51H\e[92m•\e[0m\e[13;52H\e[92m•\e[0m\e[13;53H\e[92m•\e[0m\e[13;54H\e[92m•\e[0m\e[13;55H\e[93m•\e[0m\e[13;56H\e[93m•\e[0m\e[13;57H\e[93m•\e[0m\e[13;58H\e[93m•\e[0m\e[13;59H\e[93m•\e[0m\n",
+      "\e[14;52H\e[92m•\e[0m\e[14;53H\e[92m•\e[0m\e[14;54H\e[92m•\e[0m\e[14;55H\e[93m•\e[0m\e[14;56H\e[93m•\e[0m\e[14;57H\e[93m•\e[0m\e[14;58H\e[93m•\e[0m\n",
+      "\e[15;54H\e[92m•\e[0m\e[15;55H\e[93m•\e[0m\e[15;56H\e[93m•\e[0m\n",
+    ].join)
+  end
+end

data/spec/unit/draw_spec.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+RSpec.describe TTY::Pie, '#draw' do
+  let(:data) {
+    [
+      { name: 'BTC', value: 5977 },
+      { name: 'BCH', value: 3045 },
+      { name: 'LTC', value: 2030 }
+    ]
+  }
+
+  it "draws a pie chart with legend and without cursor positioning" do
+    pie = TTY::Pie.new(data: data, radius: 2)
+
+    output = pie.draw
+
+    expect(output).to eq([
+       "   •••       • BTC 54.08%\n",
+       " •••••••\n",
+       "•••••••••    • BCH 27.55%\n",
+       " •••••••\n",
+       "   •••       • LTC 18.37%\n"
+    ].join)
+  end
+
+  it "draws a pie chart without legend and without cursor positioning" do
+    pie = TTY::Pie.new(data: data, radius: 2, legend: false)
+
+    output = pie.draw
+
+    expect(output).to eq([
+       "   •••\n",
+       " •••••••\n",
+       "•••••••••\n",
+       " •••••••\n",
+       "   •••\n"
+    ].join)
+  end
+
+  it "draw a pie chart with legend and cursor positioning" do
+    pie = TTY::Pie.new(data: data, radius: 2, left: 50, top: 10)
+
+    output = pie.draw
+
+    expect(output).to eq([
+      "\e[11;54H•\e[11;55H•\e[11;56H•\e[11;63H• BTC 54.08%\n",
+      "\e[12;52H•\e[12;53H•\e[12;54H•\e[12;55H•\e[12;56H•\e[12;57H•\e[12;58H•\e[12;63H\n",
+      "\e[13;51H•\e[13;52H•\e[13;53H•\e[13;54H•\e[13;55H•\e[13;56H•\e[13;57H•\e[13;58H•\e[13;59H•\e[13;63H• BCH 27.55%\n",
+      "\e[14;52H•\e[14;53H•\e[14;54H•\e[14;55H•\e[14;56H•\e[14;57H•\e[14;58H•\e[14;63H\n",
+      "\e[15;54H•\e[15;55H•\e[15;56H•",
+      "\e[15;63H• LTC 18.37%\n"
+    ].join)
+  end
+
+  it "draw 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
+
+    expect(output).to eq([
+      "\e[11;54H\•\e[11;55H•\e[11;56H•\n",
+      "\e[12;52H\•\e[12;53H•\e[12;54H•\e[12;55H•\e[12;56H•\e[12;57H•\e[12;58H•\n",
+      "\e[13;51H\•\e[13;52H•\e[13;53H•\e[13;54H•\e[13;55H•\e[13;56H•\e[13;57H•\e[13;58H•\e[13;59H•\n",
+      "\e[14;52H\•\e[14;53H•\e[14;54H•\e[14;55H•\e[14;56H•\e[14;57H•\e[14;58H•\n",
+      "\e[15;54H\•\e[15;55H•\e[15;56H•\n",
+    ].join)
+  end
+end

data/spec/unit/fill_spec.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+RSpec.describe TTY::Pie, ':fill option' do
+  let(:data) {
+    [
+      { name: 'BTC', value: 5977, color: :bright_yellow, fill: '*' },
+      { name: 'BCH', value: 3045, color: :bright_green, fill: '+' },
+      { name: 'LTC', value: 2030, color: :bright_magenta, fill: 'x' }
+    ]
+  }
+
+  it "draws a pie chart with custom fill per data item" do
+     pie = TTY::Pie.new(data: data, radius: 2)
+
+     output = pie.draw
+
+     expect(output).to eq([
+        "   \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)
+  end
+end

data/spec/unit/legend_spec.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+RSpec.describe TTY::Pie, ':legend option' do
+  it "draws legend at default location with 1 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, radius: 2)
+
+    output = pie.draw
+
+    expect(output).to eq([
+      "   x**       * BTC 54.08%\n",
+      " +xx****\n",
+      "++++*****    + BCH 27.55%\n",
+      " +++****\n",
+      "   +**       x LTC 18.37%\n"
+    ].join)
+  end
+
+  it "draws 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, radius: 2, legend: {left: 0, line: 0})
+
+    output = pie.draw
+
+    expect(output).to eq([
+      "   x**\n",
+      " +xx**** * BTC 54.08%\n",
+      "++++*****+ BCH 27.55%\n",
+      " +++**** x LTC 18.37%\n",
+      "   +**\n"
+    ].join)
+  end
+
+  it "draws legend at custom location with 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, radius: 3, legend: {left: 10, line: 2})
+
+    output = pie.draw
+
+    expect(output).to eq([
+      "     x**               * BTC 54.08%\n",
+      "  xxxx*****\n",
+      "++++xx*******\n",
+      "++++++*******          + BCH 27.55%\n",
+      "++++++*******\n",
+      "  ++++*****\n",
+      "     +**               x LTC 18.37%\n"
+    ].join)
+  end
+end

data/spec/unit/update_spec.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+RSpec.describe TTY::Pie, '#update' do
+  it "updates current data" do
+    data = [ { name: 'BTC', value: 5977, fill: '*' } ]
+
+    pie = TTY::Pie.new(data: data, radius: 2)
+
+    output = pie.draw
+
+    expect(output).to eq([
+      "   ***\n",
+      " *******\n",
+      "*********    * BTC 100.00%\n",
+      " *******\n",
+      "   ***\n"
+    ].join)
+
+    pie.update([{name: 'LTC', value: 2030, fill: 'x'}])
+
+    output = pie.draw
+
+    expect(output).to eq([
+      "   xxx\n",
+      " xxxxxxx\n",
+      "xxxxxxxxx    x LTC 100.00%\n",
+      " xxxxxxx\n",
+      "   xxx\n"
+    ].join)
+  end
+end

data/tasks/console.rake

@@ -0,0 +1,11 @@
+# encoding: utf-8
+
+desc 'Load gem inside irb console'
+task :console do
+  require 'irb'
+  require 'irb/completion'
+  require File.join(__FILE__, '../../lib/tty-pie_chart')
+  ARGV.clear
+  IRB.start
+end
+task c: %w[ console ]

data/tasks/coverage.rake

@@ -0,0 +1,11 @@
+# encoding: utf-8
+
+desc 'Measure code coverage'
+task :coverage do
+  begin
+    original, ENV['COVERAGE'] = ENV['COVERAGE'], 'true'
+    Rake::Task['spec'].invoke
+  ensure
+    ENV['COVERAGE'] = original
+  end
+end

data/tasks/spec.rake

@@ -0,0 +1,29 @@
+# encoding: utf-8
+
+begin
+  require 'rspec/core/rake_task'
+
+  desc 'Run all specs'
+  RSpec::Core::RakeTask.new(:spec) do |task|
+    task.pattern = 'spec/{unit,integration}{,/*/**}/*_spec.rb'
+  end
+
+  namespace :spec do
+    desc 'Run unit specs'
+    RSpec::Core::RakeTask.new(:unit) do |task|
+      task.pattern = 'spec/unit{,/*/**}/*_spec.rb'
+    end
+
+    desc 'Run integration specs'
+    RSpec::Core::RakeTask.new(:integration) do |task|
+      task.pattern = 'spec/integration{,/*/**}/*_spec.rb'
+    end
+  end
+
+rescue LoadError
+  %w[spec spec:unit spec:integration].each do |name|
+    task name do
+      $stderr.puts "In order to run #{name}, do `gem install rspec`"
+    end
+  end
+end

data/tty-pie.gemspec

@@ -0,0 +1,29 @@
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "tty/pie/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "tty-pie"
+  spec.version       = TTY::Pie::VERSION
+  spec.authors       = ["Piotr Murach"]
+  spec.email         = [""]
+
+  spec.summary       = %q{Draw pie charts in your terminal window.}
+  spec.description   = %q{Draw pie charts in your terminal window.}
+  spec.homepage      = "https://piotrmurach.github.io/tty"
+  spec.license       = "MIT"
+
+  spec.files         = Dir['{lib,spec,examples}/**/*.rb']
+  spec.files        += Dir['{bin,tasks}/*', 'tty-pie.gemspec']
+  spec.files        += Dir['README.md', 'CHANGELOG.md', 'LICENSE.txt', 'Rakefile']
+  spec.require_paths = ["lib"]
+
+  spec.required_ruby_version = '>= 2.0.0'
+
+  spec.add_dependency 'pastel', '~> 0.7.2'
+  spec.add_dependency 'tty-cursor', '~> 0.6.0'
+
+  spec.add_development_dependency 'bundler', '~> 1.16'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+end

metadata

@@ -0,0 +1,137 @@
+--- !ruby/object:Gem::Specification
+name: tty-pie
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Piotr Murach
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-12-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: pastel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.2
+- !ruby/object:Gem::Dependency
+  name: tty-cursor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Draw pie charts in your terminal window.
+email:
+- ''
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- examples/basic.rb
+- examples/fill.rb
+- lib/tty-pie.rb
+- lib/tty/pie.rb
+- lib/tty/pie/data_item.rb
+- lib/tty/pie/version.rb
+- 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/update_spec.rb
+- tasks/console.rake
+- tasks/coverage.rake
+- tasks/spec.rake
+- tty-pie.gemspec
+homepage: https://piotrmurach.github.io/tty
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.3
+signing_key: 
+specification_version: 4
+summary: Draw pie charts in your terminal window.
+test_files: []