Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kitanokitsune/csv2tabular
Script to display CSV in tabular form
https://github.com/kitanokitsune/csv2tabular
bash csv csv-converter csv-format gplv3 linux msys shell shell-script unix
Last synced: 2 days ago
JSON representation
Script to display CSV in tabular form
- Host: GitHub
- URL: https://github.com/kitanokitsune/csv2tabular
- Owner: kitanokitsune
- License: gpl-3.0
- Created: 2019-02-03T01:05:43.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2020-11-03T13:16:55.000Z (about 4 years ago)
- Last Synced: 2024-11-11T08:39:35.010Z (2 months ago)
- Topics: bash, csv, csv-converter, csv-format, gplv3, linux, msys, shell, shell-script, unix
- Language: Shell
- Size: 24.4 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
# Display CSV in Tabular Form
## 概要
**csv2tabular.sh** は標準入力からCSV形式のデータを受け取り、標準出力に表形式で出力するシェルスクリプトです。UTF-8に対応しています。
## 動作条件
* Bash
* GNU Awk 4.0 以降が必要です
## 使い方
csv2tabular.sh へCSVを入力するには、以下のようにファイルリダイレクトまたはコマンドのパイプを使います。
* $ csv2tabular.sh < sample.csv
* $ cat sample.csv | csv2tabular.sh
**実行例：**
* $ cat sample.csv
```
"Sample No.","Project Name",Score,Status
880221,"Super-X alpha",1500,Pass
21012,"Extreme DX",30,Fail
9910903,Hypernova,12000,Pass
```
* $ csv2tabular.sh < sample.csv
```
+------------+---------------+-------+--------+
| Sample No. | Project Name | Score | Status |
+------------+---------------+-------+--------+
| 880221 | Super-X alpha | 1500 | Pass |
| 21012 | Extreme DX | 30 | Fail |
| 9910903 | Hypernova | 12000 | Pass |
+------------+---------------+-------+--------+
```
文字のエンコードが UTF-8 以外の場合は、nkf 等で UTF-8 へ変換する必要があります。
* $ cat sjis.csv | nkf -Sw | csv2tabular.sh | nkf -Ws
```
+------------+------------+--------+
| あいうえお | かきくけこ | さしす |
+------------+------------+--------+
| a | b | c |
| Ａ | Ｂ | Ｃ |
+------------+------------+--------+
```
## オプション
以下のオプションが用意されています。
| オプション | 説明 |
| :--- | :--- |
| -s {0..3} | ボーダースタイル
0:枠なし 1:外枠と列の仕切り 2:ヘッダーとボディ（デフォルト） 3:行毎に仕切り |
| -r -l -c
(組み合わせ可)| 列のアライメント
r:右寄せ l:左寄せ（デフォルト） c:中央揃え
例： -lrcr 1～4列目を 左,右,中,右 に揃える （5列目以降は左） |
| -p <整数> | セル内のパディング量（省略時=1） |
| -i <整数> | 表のインデント量（省略時=2） |
| -t <文字列>...| ヘッダー行の挿入
ヘッダー行が含まれないCSVデータに、コマンドラインからヘッダー行を挿入できます。|
| -w | East Asian Ambiguous Width を全角として扱います（省略時は半角）|
| -v | バージョンとライセンス情報の表示 |
| -h | ヘルプ |
以下、オプションの例を示します。
### ボーダースタイルの例
* ___Style 0___ : 枠なし
$ cat sample.csv | csv2tabular.sh -s0
```
Sample No. Project Name Score Status
880221 Super-X alpha 1500 Pass
21012 Extreme DX 30 Fail
9910903 Hypernova 12000 Pass
```
* ___Style 1___ : 外枠と列の仕切り
$ cat sample.csv | csv2tabular.sh -s1
```
+------------+---------------+-------+--------+
| Sample No. | Project Name | Score | Status |
| 880221 | Super-X alpha | 1500 | Pass |
| 21012 | Extreme DX | 30 | Fail |
| 9910903 | Hypernova | 12000 | Pass |
+------------+---------------+-------+--------+
```
* ___Style 2___ : ヘッダーとボディ（デフォルト）
$ cat sample.csv | csv2tabular.sh -s2
```
+------------+---------------+-------+--------+
| Sample No. | Project Name | Score | Status |
+------------+---------------+-------+--------+
| 880221 | Super-X alpha | 1500 | Pass |
| 21012 | Extreme DX | 30 | Fail |
| 9910903 | Hypernova | 12000 | Pass |
+------------+---------------+-------+--------+
```
* ___Style 3___ : 行毎に仕切り
$ cat sample.csv | csv2tabular.sh -s3
```
+------------+---------------+-------+--------+
| Sample No. | Project Name | Score | Status |
+------------+---------------+-------+--------+
| 880221 | Super-X alpha | 1500 | Pass |
+------------+---------------+-------+--------+
| 21012 | Extreme DX | 30 | Fail |
+------------+---------------+-------+--------+
| 9910903 | Hypernova | 12000 | Pass |
+------------+---------------+-------+--------+
```
### アライメントオプションの例
アライメントは列毎に設定できます。オプションを省略した場合は左揃えになります。
* ___e.g.1:___ **-r** 先頭の1列だけ右揃え。残りは左揃え。
$ cat sample.csv | csv2tabular.sh -r
```
+------------+---------------+-------+--------+
| Sample No. | Project Name | Score | Status |
+------------+---------------+-------+--------+
| 880221 | Super-X alpha | 1500 | Pass |
| 21012 | Extreme DX | 30 | Fail |
| 9910903 | Hypernova | 12000 | Pass |
+------------+---------------+-------+--------+
```
* ___e.g.2:___ **-rrrr** 先頭から４列目まで全て右揃え。
$ cat sample.csv | csv2tabular.sh -rrrr
```
+------------+---------------+-------+--------+
| Sample No. | Project Name | Score | Status |
+------------+---------------+-------+--------+
| 880221 | Super-X alpha | 1500 | Pass |
| 21012 | Extreme DX | 30 | Fail |
| 9910903 | Hypernova | 12000 | Pass |
+------------+---------------+-------+--------+
```
* ___e.g.3:___ **-rlrc** １および３列目を右揃え、２列目を左揃え、４列目を中央揃え。
$ cat sample.csv | csv2tabular.sh -rlrc
```
+------------+---------------+-------+--------+
| Sample No. | Project Name | Score | Status |
+------------+---------------+-------+--------+
| 880221 | Super-X alpha | 1500 | Pass |
| 21012 | Extreme DX | 30 | Fail |
| 9910903 | Hypernova | 12000 | Pass |
+------------+---------------+-------+--------+
```
### ヘッダー行の挿入
* 入力されたCSVデータの先頭に、-t 以降のコマンドライン引数を挿入します。
$ cat sample.csv | csv2tabular.sh -t "a,b,c" -p0 -i10 "g h"
```
+------------+---------------+-------+--------+
| a,b,c | -p0 | -i10 | g h |
+------------+---------------+-------+--------+
| Sample No. | Project Name | Score | Status |
| 880221 | Super-X alpha | 1500 | Pass |
| 21012 | Extreme DX | 30 | Fail |
| 9910903 | Hypernova | 12000 | Pass |
+------------+---------------+-------+--------+
```
このように、-t 以降はヘッダーデータとして扱われるため、-t より後ろにオプションを指定することはできません。
## License
Copyright (C) 2019 kitanokitsune
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
---
kitanokitsune / 北乃きつね