django-timeline 0.5

使用事件流有两个部分。第一部分是声明一个事件，它看起来像这样

from django.contrib.auth.models import User

from timeline.base import EventType
from yourapp.library.models import Item


class AddedToLibrary(EventType):
    slug = "added-to-library"
    context_shape = {
        "user": User,
        "item": Item,
    }
    queryable_by = ["user", "item"]

然后是查询，所有的查询都被封装在timeline.base.Stream类中。它的用法如下

Stream(request.user)

将返回一个Stream，其中包含request.user.pk用户的全部事件。它可以接受任意数量的位置参数，并将它们组合成流。

它还接受多个关键字参数。其中event_type将只返回给定slug的事件。limit表示应该包含多少个事件，默认为20。cluster是一个布尔值，表示返回的数据是否应该聚类，如果是，则返回一个事件列表，而不是离散的事件。