did, 你上星期,月,年做了什么?

分享于 

6分钟阅读

GitHub

 
Comfortably generate status report stats for selected date range.
  • 源代码名称:did
  • 源代码网址:http://www.github.com/psss/did
  • did源代码文档
  • did源代码下载
  • Git URL:
    git://www.github.com/psss/did.git
    Git Clone代码到本地:
    git clone http://www.github.com/psss/did
    Subversion代码到本地:
    $ svn co --depth empty http://www.github.com/psss/did
    Checked out revision 1.
    $ cd repo
    $ svn up trunk
    

    你上星期,月,年做了什么?

    描述

    轻松收集状态报告数据( 比如。 给定的周,月,季度,年或者所选日期范围的已经提交更改列表。 默认情况下,本周所有可用的统计。

    概要

    用法很简单:

    did [this|last] [week|month|quarter|year] [opts]

    示例

    收集当前星期的所有统计数据:

    did

    显示当前/昨天的所有统计信息:

    did today
    did yesterday

    收集上个月的统计数据:

    did last month

    查看 did --help 获得可用统计数据的完整列表。

    命令行选项

    可用选项的列表取决于配置的插件。 以下是与任何插件都不相关的常规选项列表:

    选择

    至少需要在 命令行 上提供一个电子邮件地址,除非在配置文件中定义。 使用完整的电子邮件地址格式 Name Surname <email@example.org> 在报表输出中显示全名。 对于日期值 todayyesterday,可以使用完整的日期格式。

    --email=EMAILS用户电子邮件地址( es )
    --since=SINCEyyyy-MM-dd 格式的开始日期
    --until=UNTILyyyy-MM-dd 格式的结束日期

    格式

    默认输出是最大宽度 79字符的纯文本。 这可以使用 --width 参数进行调整。 若要禁用完全缩短,请使用 --width=0。 默认宽度值也可以保存在配置文件中。 使用 --format=wiki 启用简单的MoinMoin wiki语法。 对于支持它们的统计,--brief--verbose 可以用来指定要显示的不同级别的细节。

    --format=FMT输出样式,可能的值:文本( 默认值) 或者 wiki
    --width=WIDTH报表输出的最大宽度( 默认值: 79 )
    --brief仅显示简要摘要,不列出单个项目
    --verbose包含更多细节( 如修改过的git目录)

    命令行工具

    可以使用多个电子邮件来组合团队报告或者收集所有电子邮件别名的统计信息。 对于这里用例,--total--merge 可以用于在末尾附加总结,或者将所有结果分别合并到单个报表中。 使用 --debug 或者将环境变量 DEBUG 设置为 1到 5以设置所需的调试级别。

    --config=FILE使用备用配置文件( 默认: '配置)
    --total列出单个用户后的全部统计信息
    --merge将所有用户的统计合并到单个报表中
    --debug打开调试输出,不捕获异常

    有关可用选项的完整列表,请参阅 did --help

    安装

    直接从 fedora/copr仓库安装:

    yum install did

    或者使用 PIP ( 如果不在 virtualenv 中,则需要 sudo ):

    pip install did

    要在 Docker 容器中生成和执行,请运行:

    make run_docker

    有关安装选项的详细信息,请参阅文档。

    配置

    config文件 ~/.did/config 用于存储单个报表的常规设置和配置:

    [general]
    email ="Petr Šplíchal" <psplicha@redhat.com>
    width = 79
    [header]
    type = header
    highlights = Highlights
    joy = Joy of the week ;-)
    [tools]
    type = git
    did =/home/psss/git/did
    [tests]
    type = git
    tests =/home/psss/git/tests/*
    [trac]
    type = trac
    prefix = TT
    url = https://some.trac.com/trac/project/rpc
    [bz]
    type = bugzilla
    prefix = BZ
    url = https://bugzilla.redhat.com/xmlrpc.cgi
    [footer]
    type = footer
    next = Plans, thoughts, ideas...
    status = Status: Green | Yellow | Orange | Red

    有关特定插件可用选项的详细说明,请参阅插件文档。 你还可以直接检查 python 模块文档,比如 pydoc did.plugins.git 或者使用包和web文档中提供的示例配置。

    链接

    Git: https://github.com/psss/did

    文档:http://did.readthedocs.org

    问题:https://github.com/psss/did/issues

    发布:https://github.com/psss/did/releases

    Copr: http://copr.fedoraproject.org/coprs/psss/did

    PIP: https://pypi.python.org/pypi/did

    作者

    版权

    版权所有( c ) 2015红帽公司。 保留所有权利。

    本程序是自由软件,可以在自由软件基金会发布或者/或者修改它,如许可证版本 2,许可证或者任何更新版本。

    状态

    https://travis-ci.org/psss/did.svg?branch=masterhttps://readthedocs.org/projects/did/badge/

    相关文章