mkreportとは

日報の作成とRedmineへの作業時間の入力を楽にするツールです。

使い方

以下のコマンドで使うことができます。
(python3をインストールしていることが前提です。)

$ pip3 install mkreport
$ mkreport

環境変数

実行時に環境変数を設定してください。
例えばdirenvを利用している場合は.envrcファイルを以下のように設定してください。

export REPORTER=七五三
export DEFAULT_START_TIME=0730
export DEFAULT_END_TIME=1630
export REDMINE_URL=https://redmine_url
export REDMINE_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxx

REPORTERにはあなたの名前を入力してください。
生成される日報に入力されます。

DEFAULT_START_TIME DEFAULT_END_TIMEには勤務開始、終了時間をhhmmの数字4桁で入力してください。
勤務開始、終了時間は日報を作成するたびに入力できますが、空欄で入力した場合にここで入力した値が使用されます。

REDMINE_URLにはRedmineのURLを入力してください。
BASIC認証が設定されている場合はhttp://user:password@redmine_urlとすることで認証可能になります。

REDMINE_API_KEYにはRedmineのAPIアクセスキーを入力してください。
詳しくはこちら

mkreportコマンド

mkreportコマンドを実行すると対話式で入力を求められます。

 務開始時間を「hhmm」で入力してください(デフォルト「0730」)
0720
勤務終了時間を「hhmm」で入力してください(デフォルト「1630」)
1700

はじめに、勤務時間の入力を求められます。hhmmの形式で4桁の数字を入力してください。
何もせずにエンターボタンを押すと環境変数で設定されたデフォルトの値になります。
ここで入力した値は生成される日報の勤務時間に記載されます。

担当者が自分のチケット一覧
       131:事前調査
       145:環境構築
作業したチケットの番号か内容を入力してください(qを入力すると終了)
131
事前調査でよろしいですか?(y/n)
y

次に作業したチケットの番号を求められるので、作業したRedmineのチケットの番号を入力してください。
担当者が自分のチケット一覧が表示されるのでチケットの番号を確認することもできます
(もし作業したRedmineのチケットがなければqを入力し次に進んでください。)</> 番号を入力するとチケットのタイトルが表示されるので正しければyを、間違っていればnを入力してください。

他にも作業したことがあればチケットの番号か内容を入力してください(qを入力すると終了)
ミーティング

また数字以外の項目を入力することもできます。
その場合は後述するステータスの変更や作業時間の入力は求められません。

日報に記載する作業内容を入力してください
機能要件の調査が終了
作業時間を入力してください
2
[?] ステータスを選択してください。(現在のステータスDoing): Done
   ToDo
   Doing
 > Done

次に入力したチケットの作業内容と作業時間を求められので、それぞれ入力してください。
作業内容に関しては生成される日報に記載されますが、それ以外には使用されません。
作業時間に関しては該当するチケットの作業時間としてRedmineに登録されます。
詳しくはこちら

登録される作業者はAPIアクセスキーのユーザー、それ以外の項目はデフォルトの値となるのでご注意ください。
作業時間はRedmineの作業時間登録にのみ使用し、生成される日報には記載されません。

チケットのステータスが変更された場合は変更後のステータスを選択することで選択したステータスに変更することができます。
(※ここで選択したステータスはRedmineのワークフローを考慮することができません。ワークフローを満たさないステータスを選択した場合はステータスの変更ができませんのでご注意ください。)

他にも作業したことがあればチケットの番号か内容を入力してください(qを入力すると終了)
q

他に作業したチケットがあればチケットの番号を入力し、なければqを入力し次に進んでください

日報の最後に記載する一言を入力してください(qを入力すると終了)
今日も一日お疲れさまでした。
日報の最後に記載する一言を入力してください(qを入力すると終了)
明日もよろしくおねがいします。
日報の最後に記載する一言を入力してください(qを入力すると終了)
q

最後に日報の最後に記載する一言の入力を求められます。qを入力するまでは複数行コメントを入力することができます。

日報を作成しました。
./daily_report/2020/1/1.txt

生成された日報のファイルパスが出力されます。

日報の内容

日報の内容はreport_content.txtに記載されていますので自由に変更してください。
上記の入力内容では下記のファイルが生成されます。

【日報】七五三 1/1(水)
お疲れさまです。
七五三です。

本日の日報です。

【勤務時間】
7:20-17:00

【作業内容】
#131 事前調査
  機能要件の調査が終了
ミーティング
  チーム内での認識合わせが終了

【ひとこと】
今日も一日お疲れさまでした。
明日もよろしくおねがいします。