This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Telegraphy - Real Time Events For Django.

Project Description

Telegraphy

Telegraphy provides real time events for WSGI Python applications with additional features such as event filtering, subscription persistence and authorization/authentication.

It’s initially intended for Django but you can extend it to any WSGI framework.

WebSocket pub/sub and RPC is based on AutobahnPython implementation of WAMP protocol

Getting It

You can get Telegraphy by using pip:

$ pip install telegraphy

You will need to have pip installed on your system. On linux install the python-pip package, on windows follow this. Also, if you are on linux and not working with a virtualenv, remember to use sudo for both commands (sudo pip install telegraphy).

If you want to install it from source, grab the git repository from GitHub and run setup.py:

$ git clone git://github.com/machinalis/telegraphy/telegraphy.git
$ cd telegraphy
$ python setup.py install

Installing the Django app

Telegraphy’s Django app is installed with the standard procedure: in your projects settings.py file add telegraphy.contrib.django_telegraphy to the INSTALLED_APPS:

INSTALLED_APPS = (
    ...
    'telegraphy.contrib.django_telegraphy',
    ...
)

Using It

The django_telegraphy app allows you to easily extend your models so that they generate events on creation, update or delete. Those events will reach your front end in real time.

Simply install the django_telegraphy app in your Django project. Then run the following command in parallel to your web-server:

$ python manage.py run_telegraph

Extend your models so that they automatically generate events: create an events.py file next to your models.py

from models import MyModel
from telegraphy.contrib.django_telegraphy.events import BaseEventModel


class MyEventsModel(BaseEventModel):
    model = MyModel

And that’s it! Every time you create, update or delete an instance of your model, an event will reach the frontend.

You can find more examples in the documentation.

More detailed documentation

You can read the docs online here. Or for offline access, you can clone the project code repository and read them from the docs folder.

Help and discussion

For help, suggestions and discussions please refer to http://groups.google.com/group/telegraphy

To guide the development efforts, or if you find any bugs, please use GitHub’s issue tracker.

Authors

Machinalis also works on some other very interesting projects, like SimpleAI, Quepy and more.

Release History

Release History

History Node

0.1.3a1

This version
History Node

0.1.2.7

History Node

0.1.2.6

History Node

0.1.2.5

History Node

0.1.2.4

History Node

0.1.2.3

History Node

0.1.2.2

History Node

0.1.2.1

History Node

0.1.2

History Node

0.1.1.4

History Node

0.1.1.3

History Node

0.1.1.2

History Node

0.1.1.1

History Node

0.1.1h

History Node

0.1.1g

History Node

0.1.1

History Node

0.1.1f

History Node

0.1.1e

History Node

0.1.1d

History Node

0.1.1c

History Node

0.1.1b

History Node

0.1

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
telegraphy-0.1.2.7.tar.gz (52.4 kB) Copy SHA256 Checksum SHA256 Source Dec 6, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting