一个简单的命令行应用程序,帮助您使用已配置的redmine服务器的时间日志。
minetime的Python项目详细描述
minetime是一个命令行应用程序,用于帮助您收集时间日志,并使用python-redmine库通过其REST API将其发布到配置的Redmine项目管理应用程序。
功能
- 交互式向导。在向导模式下,用户可以从分配的问题和跟踪的查询中选择问题,添加、删除、编辑、合并或循环时间日志。
- GTimelog集成。
- Universal Time Tracker集成。
- 创建项目报告以公开每个版本的MineTime项目时间项。为使用backlog插件进行redmine优化。
Basics: | |
---|---|
Package & Build Status: | |
License: | |
Issue tracker: |
安装
# install minetime pip install minetime # upgrade minetime pip install --upgrade minetime
或者,如果没有pip,则来自源代码:
python setup.py install
主配置文件
默认位置:$HOME/.config/minetime/config.yml。格式:yaml
默认位置可能会被minetime_conf环境变量覆盖。
下面是主配置文件的示例:
general:uri:https://redmine.mydomain.com/user:api_key:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXactivity_id:9tracked_queries:-10001-10002-10003tracked_reports:-my_report_string_idactivities:9:Developpement
安装时不创建配置目录和文件。您可以手动创建它们,或者第一次启动minetime,配置向导将启动。
登录时,您可以在默认布局的右侧窗格中的redmine account页面(/my/account)上找到您的api密钥。必须在redmine实例上激活rest api。有关详细信息,请参见Redmine Rest API Documentation。
使用minetime
minetime --help Usage: minetime [OPTIONS] [INPUT] Options: -a, --all Import all timelogs in --batch, regardless of --date. -d, --date TEXT YYYY-MM-DD date of timelogs, default: today. -b, --batch [gtl|utt] Read GTimelog|utt from input. See GTimelog integration documentation. -t, --timelog <INTEGER FLOAT TEXT INTEGER>... ISSUEID, HOURS, COMMENTS, ACTIVITYID HOURS: decimal float (0.25 : 15 minutes). -i, --issues Show issues and exit. See GTimelog integration documentation. -r, --report Project Time Report for any tracked projects or manually-fed project-string. --debug Enable debug logging. --version Show the version and exit. --help Show this message and exit.
交互式cli向导:
minetime
从命令行馈送2个时间日志的示例:
minetime -t 123 0.75 "first time log", 9 -t 321 1.5 "second time log", 9
导入gtimelog平面文件的示例:
minetime -b gtl $HOME/.local/share/gtimelog/timelog.txt
注意,这将导入今天的时间日志。使用--date指定要导入的另一天,或使用--all导入在输入文件中找到的所有内容。
项目报告:
minetime -r git-helloworld