Metadata-Version: 1.1
Name: trunk
Version: 0.2.0
Summary: Making postgres listen/notify easier.
Home-page: https://github.com/cyberdelia/trunk
Author: Timothée Peignier
Author-email: timothee.peignier@tryphon.org
License: MIT
Description: =====
        Trunk
        =====
        
        Installing
        ==========
        
        To install : ::
        
            pip install trunk
        
        
        Usage
        =====
        
        Trunk tries to be as simple as possible ::
        
            t = Trunk("postgres://localhost/noclue")
            for channel, payload in t.notifications("clues"):
                print channel, payload
            t.notify("clues", "chandelier")
            t.unlisten("clues")
        
        
        Celery
        ======
        
        Trunk provides a `Kombu <http://kombu.readthedocs.org>`_ transport,
        that allows you to use trunk with `Celery <http://celeryproject.org>`_,
        to do so, configure Celery with : ::
        
            BROKER_URL = 'trunk.transport.Transport://localhost/database'
        
        Limitations
        -----------
        
        For now, and since LISTEN/NOTIFY behavior is not strictly speaking a queue,
        if you have more than one celery worker (but you can use worker concurrency),
        each worker will receive every job send.
        
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Utilities
