Mercurial Hook向Campfire聊天室报告传入的变更集
hgcampfire的Python项目详细描述
hg篝火
hgcampfire提供一个mercurial钩子来通知Campfire 关于变更集进入存储库的聊天室。
使用量
将以下内容添加到Mercurial配置中(在系统、用户或 repo级hgrc文件),替换api密钥、url和房间id:
[campfire] api_key = CAMPFIRE_AUTH_TOKEN_FOR_THE_USER_NOTIFICATIONS_WILL_COME_FROM url = https://myorg.campfirenow.com room = 123456 [hooks] changegroup.campfire = python:hgcampfire.notify
当然,这些配置可以分为不同的hgrc文件, 例如,如果要在用户范围内指定campfire数据,但是 仅将实际的钩子应用于某些存储库。
注意
从2010年9月开始,campfire api开始需要ssl,因此 配置中的“url”设置应为https://url。
定制
您可以修改用于通知的模板hgcampfire。 通过在^{tt4}中设置templateconfig值$ 区域默认值是{user} pushed:\n{changesets}。这个 模板具有以下可用上下文:root是 存储库根路径,user是^{tt8}的值$ 环境变量,changesets是变更集的列表 推。
您还可以修改用于报告每个 变更集,通过在 [campfire]节。这应该是一个灵活的变更集模板, 同一个表单的模板。默认值为 * "{desc}" by {author}。
您还可以选择从 通知。默认情况下,所有提交都将包含在通知中。 在[campfire]部分中,您可以设置以下属性:
only_branch=default include_nonmerges=False include_single_branch_merges=False include_multi_branch_merges=False exclude_merges_from_branch=branch_regex
only_branch设置将只宣布打开的变更集 指定的分支。默认情况下,它对分支名称没有任何限制。 include_nonmerges设置将包括或排除正常的非合并 变更集。include_single_branch_merges设置将包括或 排除合并的双亲所在的合并的变更集 同一个分支。include_multi_branch_merges设置将包括 或排除合并的两个父级位于不同 树枝。默认情况下,所有include_*设置都设置为true。所以 如果不需要,只需在配置中提到它们 要显示的变更集类型,在这种情况下,应设置 值为False。
exclude_merges_from_branch选项接受 正则表达式,如果提供了正则表达式,则不包括合并 它来自一个名字和普通的 表达。更清楚的是,它检查 合并提交存在于其名称与模式匹配的分支上。
更改
0.3.2(2012.10.03)
- 添加选项以避免宣布来自与 正则表达式
0.3(2012.03.16)
- 添加控件以限制发布的变更集类型 -添加选项以仅显示特定分支上的变更集 -添加选项以不显示单个分支合并 -添加不显示多分支合并的选项 -添加选项以不显示正常的非合并变更集
0.2.3(2010.10.25)
- 记录campfire的api现在需要https。
0.2.2(2010.06.10)
- 不要让python 2.5和更早版本在201响应代码上引发httperror
- 以最新的第一个顺序列出多个变更集
0.2.1(2010.06.08)
- 不要强制消息类型为textmessage
0.2.0(2010.06.08)
- 初始工作版本。