Metadata-Version: 1.1
Name: telegraphy
Version: 0.1.1c
Summary: Telegraphy - Real Time Events For Django.
Home-page: http://telegraphy.machinalis.com
Author: Nahuel Defossé
Author-email: nahuel.defosse@gmail.com
License: Apache License 2.0
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`_
        
        .. _AutobahnPython: http://autobahn.ws/
        
        .. _WAMP Protocol: http://wamp.ws/
        
        
        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 <http://stackoverflow.com/questions/4750806/how-to-install-pip-on-windows>`_.
        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``
        
        .. code-block:: python
        
            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 <http://telegraphy.readthedocs.org/en/latest/>`_.
        
        
        More detailed documentation
        ===========================
        
        You can read the docs online `here <http://telegraphy.readthedocs.org/en/latest/>`_.
        Or for offline access, you can clone the project code repository and read them from the ``docs`` folder.
        
        Help and discussion
        ===================
        
        Join us at the telegraphy `google group <http://groups.google.com/group/telegraphy>`_.
        
        
        Authors
        =======
        
        * Many people you can find on the `contributors section <https://github.com/machinalis/telegraphy/graphs/contributors>`_.
        * Special acknowledgements to `Machinalis <http://www.machinalis.com/>`_ for the time provided to work on this project.
        
        Machinalis also works on some other very interesting projects, like
        `SimpleAI <http://simpleai.machinalis.com/>`_,
        `Quepy <http://quepy.machinalis.com/>`_
        and `more <https://github.com/machinalis>`_.
Keywords: django real-time-web websocket wamp
Platform: Any
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Framework :: Django
Classifier: Framework :: Twisted
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries
