懒人工作报告生成器
rapport的Python项目详细描述
写工作报告很乏味。有些人有自己的习惯。这意味着 成为最后一个。它是apache-2.0授权的,用python编写,而不是 vimscript,不是bash,不是ruby,不是c,…,您可能已经得到了;-)
功能
- 从各种资源异步收集数据:
- 布吉拉
- 格瑞特
- Github
- 启动板
- mediawiki
- OpenBuildService
- 特雷罗
- 推特
- 支持可扩展性插件
- 简单的ini样式配置文件
- (几乎)全面的单元和功能测试套件
- 支持为任意时间段创建工作报告,并提供一些方便的报告:
- 当前周/月
- 最近几天
- 一年中的周/月
- 通用
安装
要从Python Package Index安装融洽关系,只需:
$ pip install rapport
或者,如果您必须这样做:
$ easy_install rapport
但是,你真的不应该这么做。最后,您可以查看您选择的发行版 如果他们提供包裹。对于opensuse,您可以在Open Build Service中找到所有版本的包。如果您碰巧使用opensuse:factory( 滚动发布/开发版本),仅需:
$ sudo zypper install rapport
用法
rapport允许查询各种上游资源以获取您所做的修改。 所以在创建第一个工作报告之前,您应该检查rapport的配置 归档并将凭据添加到您感兴趣的资源中。
默认情况下,融洽会为当前的弱者创建一份工作报告,因此从周一开始 直到现在(是的,i18n和i10n在todo列表中)。你也可以设置 明确考虑的时间框架。例如,您可以生成一个工作 过去10天的报告:
$ rapport create --recent-days 10
有关其他选项,请查看create命令的帮助:
$ rapport create --help
您可以显示以前所有工作报告的列表:
$ rapport list
并显示特定工作报告的详细信息:
$ rapport show 2013-05-21T09:27:43
或显示最新的工作报告:
$ rapport show
如果您需要进一步的帮助,请查看Rapport的帮助:
$ rapport help
黑客攻击和贡献
您可以通过执行rapport.cli模块从git签出中测试rapport:
$ python -m rapport.cli
或者,可以调用方便脚本包装器:
$ ./scripts/rapport
在github上分叉the repository,开始对master进行更改 分支(或分支)。别忘了为已修复的问题或 在适当的时候实现特性。您可以从 存储库根目录通过:
$ python setup.py test
或者直接运行nose:
$ nosetests
两者都假设您安装了测试依赖项(pythonpath上提供) 在你的系统上。如果这对您不起作用,您可以创建一个virtual environment来代替:
$ virtualenv .venv $ source .venv/bin/activate (.venv)$ pip install -r test-requirements.txt (.venv)$ nosetests
最后,如果使用virtualenv太乏味,或者您想测试不同的 配置(py26、py27、py33、pep8),也可以使用tox:
$ tox