Kosi
ターミナルアプリケーション用表フォーマットサポートツール。格子。
🎶 Images
🐤 Before
,👽,👵👵
👴,🐶,👶👶👶👶👶👶👶
🐱🐱,,🐙🐙🐙🐙🐙
🐔 After
+----------+--------------------------+--------------------------+
|:rage1::rage1::rage1:|:alien::grey_question::grey_question::grey_question::grey_question::grey_question::grey_question:|:older_woman::older_woman::grey_question::grey_question::grey_question::grey_question::grey_question:|
|:older_man::grey_question::grey_question:|:dog::grey_question::grey_question::grey_question::grey_question::grey_question::grey_question:|:baby::baby::baby::baby::baby::baby::baby:|
|:cat::cat::grey_question:|:octocat::octocat::octocat::octocat::octocat::octocat::octocat:|:octopus::octopus::octopus::octopus::octopus::grey_question::grey_question:|
+----------+--------------------------+--------------------------+
☁️⬇️ Installation
Add this line to your application's Gemfile:
gem 'kosi'
And then execute:
$ bundle
Or install it yourself as:
$ gem install kosi
👨 Description
2次元配列をテーブルフォーマットにして出力します。
🔗 terminal-table gem の日本語対応版にあたります。
(terminal-tableはASCII対応のみなので全角文字が混ざるとテーブルレイアウトが崩れる)
🅾️ Options
🍦 Align
配置指定。右寄せ、左寄せ、中央を選択可能。
設定可能パラメータ | 説明 |
---|---|
Kosi::Align::TYPE::RIGHT | 右寄せ |
Kosi::Align::TYPE::LEFT | 左寄せ。デフォルト |
Kosi::Align::TYPE::CENTER | 中央 |
🍦 ConnectorChar
表の結合部に表示するテキスト。1文字で指定。
下記で言うところの 「+」がConnectorChar。
+-----+------+-------+
|a |b |c |
+-----+------+-------+
🍦 Header
表のヘッダー。配列で指定。
デフォルトはヘッダーなし。
🍦 HorizontalBorderChar
水平線を1文字で設定。
デフォルトは「-」(半角ハイフン)
🍦 SeparateEachRow
各行に区切り線を入れるかどうか。
デフォルトは「false」
🍦 VerticalBorderChar
垂直線を1文字で設定。
デフォルトは「|」(パイプ)
📜 Usage
🍧 オプション指定なし
require 'kosi'
kosi = Kosi::Table.new
print kosi.render([[*'a'..'c'], ['ほゲ1', 'ひゲ22', 'へゲ333']])
- 出力
※GitHubの表示上ずれているかもしれませんが、等幅フォント利用時にそろいます。
+-----+------+-------+
|a |b |c |
|ほゲ1|ひゲ22|へゲ333|
+-----+------+-------+
🍧 Align指定
require 'kosi'
kosi = Kosi::Table.new({align: Kosi::Align::TYPE::CENTER})
print kosi.render([[*'a'..'c'], ['ほゲ1', 'ひゲ22', 'へゲ333']])
kosi = Kosi::Table.new({align: Kosi::Align::TYPE::RIGHT})
print kosi.render([[*'a'..'c'], ['ほゲ1', 'ひゲ22', 'へゲ333']])
kosi = Kosi::Table.new({align: Kosi::Align::TYPE::LEFT})
print kosi.render([[*'a'..'c'], ['ほゲ1', 'ひゲ22', 'へゲ333']])
- 出力
+-----+------+-------+
| a | b | c |
|ほゲ1|ひゲ22|へゲ333|
+-----+------+-------+
+-----+------+-------+
| a| b| c|
|ほゲ1|ひゲ22|へゲ333|
+-----+------+-------+
+-----+------+-------+
|a |b |c |
|ほゲ1|ひゲ22|へゲ333|
+-----+------+-------+
🍧 ConnectorChar指定
require 'kosi'
kosi = Kosi::Table.new
print kosi.render([[*'a'..'c'], ['ほゲ1', 'ひゲ22', 'へゲ333']])
kosi = Kosi::Table.new({connector_char: 'x'})
print kosi.render([[*'a'..'c'], ['ほゲ1', 'ひゲ22', 'へゲ333']])
kosi = Kosi::Table.new({connector_char: '$'})
print kosi.render([[*'a'..'c'], ['ほゲ1', 'ひゲ22', 'へゲ333']])
- 出力
+-----+------+-------+
|a |b |c |
|ほゲ1|ひゲ22|へゲ333|
+-----+------+-------+
x-----x------x-------x
|a |b |c |
|ほゲ1|ひゲ22|へゲ333|
x-----x------x-------x
$-----$------$-------$
|a |b |c |
|ほゲ1|ひゲ22|へゲ333|
$-----$------$-------$
🍧 Header指定
require 'kosi'
kosi = Kosi::Table.new
print kosi.render([[*'a'..'c'], ['ほゲ1', 'ひゲ22', 'へゲ333']])
kosi = Kosi::Table.new({header: %w{column1 column2 column3}})
print kosi.render([[*'a'..'c'], ['ほゲ1', 'ひゲ22', 'へゲ333']])
- 出力
+-----+------+-------+
|a |b |c |
|ほゲ1|ひゲ22|へゲ333|
+-----+------+-------+
+-------+-------+-------+
|column1|column2|column3|
+-------+-------+-------+
|a |b |c |
|ほゲ1 |ひゲ22 |へゲ333|
+-------+-------+-------+
🍧 HorizontalBorderChar指定
require 'kosi'
kosi = Kosi::Table.new
print kosi.render([[*'a'..'c'], ['ほゲ1', 'ひゲ22', 'へゲ333']])
kosi = Kosi::Table.new({horizontal_border_char: '*'})
print kosi.render([[*'a'..'c'], ['ほゲ1', 'ひゲ22', 'へゲ333']])
- 出力
+-----+------+-------+
|a |b |c |
|ほゲ1|ひゲ22|へゲ333|
+-----+------+-------+
+*****+******+*******+
|a |b |c |
|ほゲ1|ひゲ22|へゲ333|
+*****+******+*******+
🍧 SeparateEachRow指定
require 'kosi'
kosi = Kosi::Table.new
print kosi.render([[*'a'..'c'], ['ほゲ1', 'ひゲ22', 'へゲ333'], [*'a'..'c']])
kosi = Kosi::Table.new({separate_each_row: true})
print kosi.render([[*'a'..'c'], ['ほゲ1', 'ひゲ22', 'へゲ333'], [*'a'..'c']])
- 出力
+-----+------+-------+
|a |b |c |
|ほゲ1|ひゲ22|へゲ333|
|a |b |c |
+-----+------+-------+
+-----+------+-------+
|a |b |c |
+-----+------+-------+
|ほゲ1|ひゲ22|へゲ333|
+-----+------+-------+
|a |b |c |
+-----+------+-------+
🍧 VerticalBorderChar指定
require 'kosi'
kosi = Kosi::Table.new
print kosi.render([[*'a'..'c'], ['ほゲ1', 'ひゲ22', 'へゲ333']])
kosi = Kosi::Table.new({vertical_border_char: '#'})
print kosi.render([[*'a'..'c'], ['ほゲ1', 'ひゲ22', 'へゲ333']])
- 出力
+-----+------+-------+
|a |b |c |
|ほゲ1|ひゲ22|へゲ333|
+-----+------+-------+
+-----+------+-------+
#a #b #c #
#ほゲ1#ひゲ22#へゲ333#
+-----+------+-------+
🍧 複合オプション
様々なオプションを一気に指定してみます
require 'kosi'
kosi = Kosi::Table.new(
{
align: Kosi::Align::TYPE::CENTER,
connector_char: 'x',
header: %w{column1 column2 column3},
horizontal_border_char: '*',
vertical_border_char: '#',
separate_each_row: true
}
)
print kosi.render([[*'a'..'c'], ['ほゲ1', 'ひゲ22', 'へゲ333'], [*'a'..'c']])
- 出力
x*******x*******x*******x
#column1#column2#column3#
x*******x*******x*******x
# a # b # c #
x*******x*******x*******x
# ほゲ1 #ひゲ22 #へゲ333#
x*******x*******x*******x
# a # b # c #
x*******x*******x*******x
👬 Contributing 👭
- Fork it ( https://github.com/tbpgr/kosi/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request