thorn 1.5.2

使用中

Webhooks在实际应用中的显著例子有

示例

以下示例向一个假想的博客引擎的Article模型添加了四个webhook事件

from thorn import ModelEvent, webhook_model

@webhook_model   # <--- activate webhooks for this model
class Article(models.Model):
    uuid = models.UUIDField()
    title = models.CharField(max_length=100)
    body = models.TextField()

    class webhooks:
        on_create = ModelEvent('article.created')
        on_change = ModelEvent('article.changed'),
        on_delete = ModelEvent('article.removed'),
        on_publish = ModelEvent(
            'article.published',
            state__eq='PUBLISHED',
        ).dispatches_on_change(),

    @models.permalink
    def get_absolute_url(self):
        return 'article:detail', None, {'uuid': self.uuid}

现在，用户可以单独订阅这四个事件，或者通过订阅article.*来订阅所有事件，每当文章创建、更改、删除或发布时，都会收到通知

$ curl -X POST                                                      \
> -H "Authorization: Bearer <secret login token>"                   \
> -H "Content-Type: application/json"                               \
> -d '{"event": "article.*", "url": "https://e.com/h/article?u=1"}' \
> http://example.com/hooks/

API的表达能力强，因此您可能需要学习更多关于参数的知识，才能完全理解它。幸运的是，它都在快速入门教程后面的事件指南中描述了。

安装稳定版本

您可以通过Python包索引（PyPI）或从源代码安装thorn。

要使用pip安装

$ pip install -U thorn

从源代码下载和安装

从http://pypi.python.org/pypi/thorn/下载最新的thorn版本

您可以通过以下命令安装它

$ tar xvfz thorn-0.0.0.tar.gz
$ cd thorn-0.0.0
$ python setup.py build
# python setup.py install

如果当前没有使用virtualenv，则必须以特权用户身份执行最后一个命令。

使用开发版本

使用pip

您可以使用以下pip命令安装thorn的最新快照

$ pip install https://github.com/robinhood/thorn/zipball/master#egg=thorn

邮件列表

有关Thorn的使用、开发和未来讨论，请加入thorn-users邮件列表。

IRC

在IRC上与我们聊天。#thorn频道位于Freenode网络。