| 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 ; |