小型cli时间记录器
timeflow的Python项目详细描述
简单的cli时间记录器,灵感来自gtimelog
说明
timeflow是一个简单的cli时间记录器,用于记录您的活动和 具有简单的统计和报告功能
timeflow可以使用tf或timeflow命令调用
安装
pip3 install timeflow
用python3写的。使用python3的最佳用户体验。
教程
to start working (message content is not important) >>> tf log "Arrived." to save a timestamp and your log message, when finished doing a task write >>> tf log "Timeflow: create README.rst" here 'Timeflow' is a 'project' you were working on and 'create README.rst' is a log of what you were exactly doing this time. Both project and log must be separated by a colon and space (``: ``). some tasks are not (payable) work, mark them with two asterisks (**) >>> tf log "Slack: chatting in the office ** " you can have 'projects' without any explanations >>> tf log "Lunch ** " >>> tf log "Daily Scrum" if you made a mistake, or missed to log of your activities you can edit like this >>> tf edit this way timeflow will try to run your editor set in $EDITOR or you can try >>> tf edit -e vim to open log file in vim to check how much you've worked today >>> tf stats or to make a report >>> tf stats --report you can pass date ranges for stats command, e.g. >>> tf stats --from 2015-01-01 --to 2015-01-31 >>> tf stats --from 2015-01-01 --to 2015-01-31 --report
命令和选项
- log
- log LOG_TEXT-创建Timeflow日志文件的新日志项。
- edit
打开timeflow的日志文件,默认情况下尝试打开在$EDITOR环境变量中使用的编辑器。
-e EDITOR-传递用于打开日志文件的编辑器。
- stats
显示今天的工作和空闲时间。
-y,--yesterday-显示昨天的工作和空闲时间。
-d DATE, --day DATE-显示任意一天的工作和空闲时间。
--week WEEK_NUMBER-显示任意一周的工作和空闲时间。
--this-week-显示本周的工作和空闲时间。
--last-week-显示上周的工作和空闲时间。
--month MONTH_NUMBER-显示任意月份的工作和空闲时间。
--this-month-显示本月的工时和空闲时间。
--last-month-显示上个月的工作和空闲时间。
-f DATE, --from DATE-如果不使用--to选项,则显示从日期到今天的工作时间和空闲时间。
-t DATE, --to DATE-显示最新的工作和空闲时间。必须与--from选项一起使用。
--report-显示今天的报告,或者使用可用选项指定的其他时间范围。
--report-as-gtimelog-与--report相同,但输出类似于gtimelog