django-trello-broker 0.3

依赖性

• Python2.7+
• Django 1.7+
• 特雷罗0.9.1+
• 请求2.2.1+

安装

管道：

pip install django-trello-broker

基本手动安装：

$ python setup.py build
$ sudo python setup.py install

替代安装（手动）：

使用量

1. 将“Trello_Broker”添加到已安装的应用程序中

2. 在URL结构中的某个位置添加“trello_broker.url”。示例：

   urlpatterns = patterns('',
       url(r'^admin/', include(admin.site.urls)),
       url(r'^broker', include('trello_broker.urls')),
       ... (all your other urls here) ...
   )
   

3. 向数据库中至少添加1个trello令牌。示例：

   $ ./manage.py add_trello_token
   Enter your Trello applications name.
   
   App Name: Netlandish Bot
   
   Enter your Trello user API Key. You can get it from:
   
   https://trello.com/1/appKey/generate
   
   API Key: <Our Super Secret Key Here>
   
   Go to the following URL to get your API Token:
   
   https://trello.com/1/authorize?key=<Our Super Secret Key Here>&name=Netlandish+Bot&expiration=never&response_type=token&scope=read,write
   
   API Token: <Our Super Secret Token Here>
   Saved token (ID: 1) to the database.
   

4. 现在，您可以自动填充新令牌可以访问的所有trello板。示例：

   $ ./manage.py populate_trello_boards
   Processing token Netlandish Bot
   Processing board BracketWire Development
   Processing board Bracketwire Planning
   Processing board CHAP Development
   Processing board CHAP Planning
   Processing board CartFreak Development
   Processing board CartFreak Planning
   .......
   

5. 转到http://yourdomain.com/admin/（或您的管理url）并添加位桶存储库。保存后，您将能够添加一个新的“规则”。一旦保存了该规则，就可以添加另一个规则。目前只允许2条规则。“参考”和“修复/关闭”。

Referenced

When a card has been referenced in a commit message, this rule will be triggered.

Example

Simply using “#<card-short-id>” works. For instance, “Starting working on new feature for #213”

Fixes / Closes

When a card has been referenced in a commit message but also uses a “fix” or “close” prefix

Example:

One of the following words following by the card short ID. Words are “fix(ed|es)” or “close(d|s)”. This is case insensitive. For instance, “Finished work for new feature. Closes #213”

#是的。将post hook添加到bitbucket存储库设置中。见BitBucket POST Hook Management

Note Be sure to include the access_key if you stored one in your BitBucket Repo in the Django Admin. For instance, if you used “foobar” as your access key in Django admin, in the BitBucket settings you need to pass in the access key like so: http://yourdomain.com/broker/?access_key=foobar

设置

应用程序支持一些设置。

1. trello_broker_use_芹菜-默认为false。如果为true，代理处理器将使用芹菜任务“芹菜进程提交”，这只是通过芹菜设置运行的正常“进程提交”函数的包装。

2. trello_broker_restrict_ips-默认为false。如果为true，代理将检查发送请求的客户端是否来自指定的BitBucket代理服务器。见：BitBucket IP List Here

3. trello_broker_bitbucket_ip s-允许发布给代理的客户端IP的列表。默认为

   ['131.103.20.165', '131.103.20.166']
   

   此设置取决于trello_broker_restrict_ips设置为true

模板

使用了一个模板，其中包含用于生成Trello卡上的注释的消息。：

trello_broker/update_message.txt

默认情况下，模板包含以下内容：

Commit ```{{ changeset }}``` committed by {{ author }} with the message ```{{ commit_message }}``` - View at: {{ commit_url }}

以下是将传递给模板的上下文：

context = {
    'author': commit['author'],
    'author_full': commit['raw_author'],
    'changeset': commit['node'],
    'changeset_full': commit['raw_node'],
    'commit_url': urljoin(base_commit_url, commit['raw_node']),
    'commit_message': commit['message'],
}

“base_commit_url”变量的值是从BitBucket提供的数据拼凑而成的。本质上是“https://bitbucket.org/username/reponame”。请参见BitBucket POST Hook Management文档，了解json数据的外观示例

管理操作

还包括一个简单的管理操作，使您可以很容易地通过管理列表页面重新填充一个或多个trello板。只需选择要更新的板，选择操作，点击“开始”。

实际例子

这是我们的一张开发卡的简单截图