sparklines 0.5.0

示例输出

这是一个记录的示例会话，展示了如何使用Sparklines（由于GitHub不支持嵌入Asciinema录制，您将看到指向相应asciicast）的图片

以下是一些命令行示例输出（请注意，在某些浏览器中，这些块字符的垂直对齐可能显示得稍微不正确，下面提到的其他仓库也可能会看到相同的效果）

以下代码的示例

$ sparklines 2 7 1 8 2 8 1 8
▂▇▁█▂█▁█
$ echo 2 7 1 8 2 8 1 8 | sparklines
▂▇▁█▂█▁█
$ sparklines < numbers.txt
▂▇▁█▂█▁█
$ sparklines 0 2. 1e0
▁█▅

安装

您可以使用来自Python软件包索引的pip install sparklines安装此软件包。您还可以克隆此存储库，并通过python setup.py install或pip install -e .安装它。安装后，您将可以通过程序或具有相同名称的命令行工具系统范围内（或如果您使用了虚拟环境，在虚拟环境中）访问sparklines。

测试

要运行测试套件，下载并解压此存储库或克隆它，运行pip install pytest，然后在解压的归档文件中运行pytest tests命令。从下载的存储库的根目录执行。

用法

请注意，以下示例在某些浏览器中可能看起来有些奇怪（对齐不正确或甚至带颜色），但在您的终端、Python或IPython会话或您选择的Python IDE中打印时应完全正常。下面的图2可能比随后复制的示例代码更能清楚地说明您应该期待什么

$ sparklines 1 2 3 4 5.0 null 3 2 1
▁▃▅▆█ ▅▃▁

$ sparklines -n 2 1 2 3 4 5.0 null 3 2 1
  ▁▅█ ▁
▁▅███ █▅▁

In [1]: from sparklines import sparklines

In [2]: for line in sparklines([1, 2, 3, 4, 5.0, None, 3, 2, 1]):
   ...:     print(line)
   ...:
▁▃▅▆█ ▅▃▁

In [3]: for line in sparklines([1, 2, 3, 4, 5.0, None, 3, 2, 1], num_lines=2):
    print(line)
   ...:
  ▁▅█ ▁
▁▅███ █▅▁

参考

此代码受到了Zach Holman的spark的启发，由Kenneth Reitz转换为名为spark.py的Python模块，并由RegKrieg转换为名为pysparklines的Python包。Roger Allen还提供了一个更短的spark.py。

但由于它非常短，且在Python中易于编码，我们可以添加一些我认为缺少的额外功能，例如

• 使用多行输出增加Sparkline的分辨率

• 显示输入数字中的缺失数据

• 对于负值发出警告（允许，但可能误导）

• 如果可用termcolor包，使用不同颜色突出显示超过某些阈值的值

• 在最大长度处包装长的Sparkline

• （待办事项）在常规间隔添加分隔符字符，如: