Sparkr 开源项目教程-优快云博客

Sparkr 开源项目教程

sparkr ▁▂▃▅▂▇ in Ruby (and your shell) 项目地址: https://gitcode.com/gh_mirrors/sp/sparkr

1. 项目介绍

Sparkr 是一个 Ruby 语言的端口，它允许你在 Ruby CLI 中创建 ASCII 风格的迷你图表（sparklines）。Sparkr 是基于 Zach Holman 的 spark 项目开发的，旨在为 Ruby 开发者提供一个简单易用的工具来生成迷你图表。

Sparkr 的主要功能包括：

在 Ruby 脚本中生成迷你图表。
支持在命令行中直接使用，通过传递数字列表生成图表。
支持通过管道输入数据生成图表。
支持对图表进行颜色定制，以便更好地展示数据。

2. 项目快速启动

安装

首先，你需要在你的 Ruby 项目中添加 Sparkr 依赖。在 Gemfile 中添加以下内容：

gem 'sparkr'

然后执行以下命令安装依赖：

$ bundle install

或者你也可以直接通过 gem 命令安装：

$ gem install sparkr

使用示例

在命令行中使用

安装完成后，你可以在命令行中直接使用 Sparkr 生成迷你图表。例如：

$ sparkr 0 30 55 80 33 150

输出结果为：

▁▂▃▅▂▇

你也可以通过管道输入数据：

$ echo 9 13 5 17 1 | sparkr

输出结果为：

▄▆▂█▁

在 Ruby 脚本中使用

在 Ruby 脚本中，你可以使用 Sparkr 生成迷你图表。例如：

require 'sparkr'

data = [0, 30, 55, 80, 33, 150]
sparkline = Sparkr.sparkline(data)
puts sparkline

输出结果为：

▁▂▃▅▂▇

颜色定制

如果你希望对生成的图表进行颜色定制，可以使用类似 Term::ANSIColor 这样的 gem 来实现。例如：

require 'sparkr'
require 'term/ansicolor'

class String
  include Term::ANSIColor
end

open_issue_count = 3
closed_issue_count = 13
list = [open_issue_count, closed_issue_count]

sparkline = Sparkr.sparkline(list) do |tick, count, index|
  if index == 0
    tick.color(:red)
  else
    tick.color(:green)
  end
end

puts "Issues: " + sparkline

输出结果为：