blib/lib/App/tjoin.pm untested

filter: Statementstmt 0.0% 0 / 2 totaltotal 0.0% 0 / 2 SCAR -
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 ;