Skip to main content

Activity stream application for Django

Project description

django-stream
=============

django-stream provides activity streams for Django applications.

It differs from
`django-activity-stream <https://github.com/justquick/django-activity-stream>`_
in that it does not use generic relations and does not provide a
``Follow`` object, but it can be used together with
`django-follow <https://github.com/caffeinehit/django-follow>`_.

Installation
------------

::

pip install django-stream

Configuration
-------------

- In your ``settings.py`` add stream types:

::

INSTALLED_APPS += ('stream', )

STREAM_VERBS = (
('default', 'Stream Item'),
('edit', 'Object edited'),
('created','Object created'),
('deleted','Object deleted'),
('followed', 'Object followed'),
)

- Register the models you want to be able to tag in your streams:

::

from django.db import models
from stream import utils

class MyModel(models.Model):
field = models.CharField(max_length = 255)

utils.register_actor(MyModel)
utils.register_target(MyModel)
utils.register_action_object(MyModel)

Test
----

The repository includes a sample project and application that is
configured to test ``django-stream``.

Clone the repository and cd into the project folder:

::

cd test_project/
python manage.py test stream

API
---

Manager
~~~~~~~

- ``ActionManager.create(actor, verb, target=None, action_object=None, **kwargs)``:
Create a new action object

- ``ActionManager.get_or_create(actor, verb, target=None, action_object=None, **kwargs)``
:
Returns a tuple ``(Action, bool)``

- ``ActionManager.get_for_actor(actor)``:
Returns all the ``Action`` objects involving ``actor``

- ``ActionManager.get_for_actors(actors)``:
Similar to above, but acts on a list of actors

- ``ActionManager.get_for_target(target)``:
Returns all the ``Action`` objects involving ``target``

- ``ActionManager.get_for_targets(targets)``:
Similar to above, but acts on a list of targets

- ``ActionManager.get_for_action_object(obj)``:
Returns all the ``Action`` objects involving ``obj``

- ``ActionManager.get_for_action_objects(objects)``:
Similar to above, but acts on a list of action objects.

Utils
~~~~~

- ``stream.utils.register_actor(Model)``:
Make ``Model`` a possible actor

- ``stream.utils.register_target(Model)``:
Make ``Model`` a possible target

- ``stream.utils.register_acction_object(Model)``:
Make ``Model`` a possible action\_object

- ``stream.utils.action.send(actor, verb, target=None, action_object=None, description=None)``:
Create a new action object

Template Tags
~~~~~~~~~~~~~

There is one template tag that attempts to render a given action:

::

{% load stream_tags %}
{% render_action action %}

The template tag will try to find ``stream/<action.verb>.html`` and if
it fails render the default template ``stream/action.html``.

Signals
~~~~~~~

There is one signal that is fired when new actions are created:

``stream.signals.action(instance)``

--------------

`@flashingpumpkin <http://twitter.com/flashingpumpkin>`_

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-stream-0.2.2.tar.gz (7.7 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page