Project

kosi

0.02
No release in over 3 years
Low commit activity in last 3 years
terminal table format for japanese
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.15
>= 0
~> 3.6.0
~> 0.14.1

Runtime

 Project Readme

Kosi

Gem Version Gem Downloads Build Status Coverage Status Code Climate

ターミナルアプリケーション用表フォーマットサポートツール。格子。

🎶 Images

🐤 Before

:rage1::rage1::rage1:,👽,👵👵
👴,🐶,👶👶👶👶👶👶👶
🐱🐱,:octocat::octocat::octocat::octocat::octocat::octocat::octocat:,🐙🐙🐙🐙🐙

🐔 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 👭

  1. Fork it ( https://github.com/tbpgr/kosi/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request