Metadata-Version: 1.1
Name: pyramid_transactional_celery
Version: 0.1.1
Summary: A transaction-aware Celery job setup
Home-page: https://github.com/petrilli/pyramid_transactional_celery
Author: Christopher Petrilli
Author-email: petrilli@amber.org
License: BSD
Description: ===============================
        Transactional Celery for Pyramid
        ===============================
        
        .. image:: https://badge.fury.io/py/pyramid_transactional_celery.png
            :target: http://badge.fury.io/py/pyramid_transactional_celery
        
        .. image:: https://travis-ci.org/petrilli/pyramid_transactional_celery.png?branch=master
                :target: https://travis-ci.org/petrilli/pyramid_transactional_celery
        
        .. image:: https://pypip.in/d/pyramid_transactional_celery/badge.png
                :target: https://pypi.python.org/pypi/pyramid_transactional_celery
        
        
        A transaction-aware Celery job setup. This is integrated with the Zope
        transaction_ package, which implements a full two-phase commit protocol.
        While it is not designed for anything other than Pyramid, it also does not
        use any component of Pyramid. It's simply not tested anywhere else.
        
        * Free software: BSD license
        * Documentation: https://pyramid_transactional_celery.readthedocs.org.
        
        .. _transaction: https://pypi.python.org/pypi/transaction
        
        Features
        --------
        
        * Queues tasks into a thread-local when they are called either using ``delay``
          or ``apply_async``.
        * If the transaction is aborted, then the tasks will never be called.
        * If the transaction is committed, the tasks will go through their normal
          ``apply_async`` process and be queued for processing.
        
        
        Limitations
        -----------
        
        Currently, the code is designed around Celery v3.1, and it is unknown whether
        it will work with previous versions.  I'm more than happy to integrate changes
        that would make it work with other releases, but since I generally stay on
        the latest release, it isn't a priority for my own development.
        
        
        Usage
        -----
        
        Using the library is a relatively easy thing to do. First, you'll need to
        integrate Celery into your Pyramid application, for which I recommend using
        pyramid_celery_. Once that's done, you simply need to start creating your
        tasks. The big difference is for function-based tasks, you use a different
        decorator::
        
            from pyramid_transactional_celery import task_tm
        
            @task_tm
            def add(x, y):
                """Add two numbers together."""
                return x + y
        
        That's all there is to it. For class-based tasks, you simply need to
        subclass ``TransactionalTask`` instead of ``Task``::
        
            from pyramid_transactional_celery import TransactionalTask
        
            class SampleTask(TransactionalTask):
                """A sample task that is transactional."""
                def run(x, y):
                    return x + y
        
        That's it. Bob's your uncle.
        
        .. _pyramid_celery: https://pypi.python.org/pypi/pyramid_celery/
        
        
        
        
        History
        -------
        
        0.1.1 (2015-01-19)
        ------------------
        
        * Removed an excess creation of a CeleryDataManager that was a left-over from
          a previous approach. While this didn't create a bug, it wasted memory.
        
        
        0.1.0 (2015-01-19)
        ------------------
        
        * Initial functionality, but more testing of edge cases is needed to ensure
          that it works correctly in all cases, and with other versions of Celery.
        * First release on PyPI.
        
        
Keywords: pyramid_transactional_celery
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
