blib/lib/App/timeput.pm untested

filter: Statementstmt 0.0% 0 / 2 totaltotal 0.0% 0 / 2 SCAR -
1 package App::timeput ;
2 our $VERSION = '0.081' ;
3 our $DATE = '2023-03-10T16:47+09:00' ;
4  
5 =encoding utf8
6  
7 =head1 NAME
8  
9 App::timeput
10  
11 =head1 SYNOPSIS
12  
13 This module provides a Unix-like command `F<timeput>'.
14  
15 =head1 DESCRIPTION
16  
17 =head1
18  
19 timeput
20  
21 入力を1行ずつ読み、その各行の先頭に、読み取った時点の時刻をタブ区切りで出力する。
22 ただし、"-w 秒数" の指定により、1行読んで出力して、指定秒数動作を止める(sleepする)。
23  
24 Ctrl+Z で操作を中断し、2次情報として何行まで読んだのかを表示する。
25  
26 オプション :
27 -b 0 : 出力のバッファリングをしない。(Buffering)
28 -c STR : 色の指定。0で色無し。"cyan","faint red bold","bright_blue"など。色名はTerm::ANSIColor を参照。
29 -d : 日付も出力。yyyy-mm-dd HH:MM:SS 形式で。(date)
30 -g : 開始からの秒数でなくて、1行ごとの間隔秒数を表示。(gap)
31 -s : 起動してからの秒数を出力。(start)
32 --sleep N : 入力から1行ずつ逐次読み取り出力して、N秒停止することを繰り返す。
33 -z STR : タイムゾーンの設定。"Asia/Tokyo", "-9", "-9:00", "JST-9" などが設定できる。(システム依存)
34  
35 -. N : 秒数を小数点以下 N 桁出力する。0から6の整数値が使える。未指定なら3。(-d とは両立しない。)
36  
37 利用例 :
38 yes | head | timeput -.6
39 yes | head | timeput -d | sed 's/ /T/' # POSIXの日時形式にしたい場合。このsed文は最初の空白文字のみTに変更。
40 seq 5 | timeput -.6 | timeput -s.6 | timeput -g.6
41 seq 10 | timeput -w0.45 | timeput -g.3 # 0.45秒ずつ1行を読み取る。
42 command 1> output1.txt 2> >( timeput error.log ) # command は標準エラー出力に何か出力をするプログラムである。便利。
43  
44 開発メモ:
45 * -w の動作を高度化したい。-w 2,0.2x10,0 と指定することで最初は2秒、次に10回は0.2秒、残りは即座のように。,は+、xは*でも可としたい。
46 * -3 のオプションを作りたい。timeput -3 で timeput -g | timeput -s | timeput とおなじ機能を持たせたい。
47 * 名前を timeput (タイムプット)ではなく、puttime の方が「プッタイム」で発音しやすい気がする。その方が記憶しやすいかも。
48 * タイムゾーンの設定について、 -z が明示的に必要なようだ (Macの場合)。
49  
50 =head1 AUTHOR
51  
52 下野寿之 Toshiyuki SHIMONO <bin4tsv@gmail.com>
53  
54 =head1 COPYRIGHT AND LICENSE
55  
56 Copyright (c) 2021 Toshiyuki SHIMONO. All rights reserved.
57 This program is free software; you can redistribute it and/or
58 modify it under the same terms as Perl itself.
59  
60 =cut
61  
62 1 ;