| 1 | package App::tjoin ; | ||
| 2 | our $VERSION = '0.061' ; | ||
| 3 | our $DATE = '2021-11-13T14:42+09:00' ; | ||
| 4 | |||
| 5 | =encoding utf8 | ||
| 6 | =head1 NAME | ||
| 7 | App::tjoin | ||
| 8 | =head1 SYNOPSIS | ||
| 9 | This module provides a Unix-like command `F<tjoin>'. | ||
| 10 | =head1 DESCRIPTION | ||
| 11 | |||
| 12 | tjoin table < data | ||
| 13 | tjoin table data | ||
| 14 | cat data | tjoin -c1 -f1 table | ||
| 15 | |||
| 16 | data の指定列(c列目もしくはc列目からf個の列)を、table に従って変換したものを出力する。 | ||
| 17 | |||
| 18 | tableのファイルの中身は、タブ区切り(変更可)で1〜f列目とそれ以降が | ||
| 19 | それぞれ、変換前の文字列、変換後の文字列で構成されているとする。 | ||
| 20 | c は -c のオプションで指定される。未指定なら1である。 | ||
| 21 | f は -f のオプションで指定される。未指定なら1である。 | ||
| 22 | |||
| 23 | |||
| 24 | オプション : | ||
| 25 | |||
| 26 | -c num : (小文字のk) 1始まりもしくは-1終わりで列の番号を指定する。未指定なら1。 | ||
| 27 | -f num : (大文字のK) 指定位置から何列をキーにするかを指定。未指定なら1。 | ||
| 28 | -~ : 変換の仕方を逆方向にする。-fで指定された数をKとすると、tableの末尾のK列をキーと見なす。 | ||
| 29 | |||
| 30 | -h : 変換前のデータの最初列の前に変換した値を付ける。 (head) | ||
| 31 | -i : 入力データに対して、変換対象データを置換をする。 (insert) | ||
| 32 | -t : 変換前のデータの最終列の後ろに変換した値をつける。 (tail) | ||
| 33 | -x : 変換対象が無い場合と変換対象のキーの列が無い場合は、出力をしない。 | ||
| 34 | -m : 変換すべきdata の変換方法が、参照表 table によって何通り指定されているかを出力。 | ||
| 35 | |||
| 36 | -= : data の最初の行をヘッダ行と見なし、適切に結合した結果の表示をするようにする。(!要推敲) | ||
| 37 | -, str : dataもtableも各列は、文字列strで区切られているとする。 | ||
| 38 | -? str : 変換値が未定義の場合の出力文字列の指定。デフォルトは "notfound" の8文字。 | ||
| 39 | -E str : 入力が未定義の場合の出力文字列の指定。デフォルトは "noinput" の7文字。<-- 必要なのか? | ||
| 40 | |||
| 41 | --help : この tjoin のヘルプメッセージを出す。 perldoc -t tjoin | cat でもほぼ同じ。 | ||
| 42 | --help opt : オプションのみのヘルプを出す。opt以外でも optionsの先頭から一致すれば良い。 | ||
| 43 | |||
| 44 | 開発上のメモ: | ||
| 45 | * -E が必要なのか要検討 | ||
| 46 | |||
| 47 | =head1 SEE ALSO | ||
| 48 | |||
| 49 | CLI::KeyValue::Hack's wisejoin. | ||
| 50 | CLI::Table::Key::Finder's wisejoin. | ||
| 51 | |||
| 52 | =cut | ||
| 53 | |||
| 54 | 1 ; |