Skip to main content

An event driven middleware library for Python

Project description

.. image:: https://travis-ci.org/CloudVE/pyeventsystem.svg?branch=master :target: https://travis-ci.org/CloudVE/pyeventsystem :alt: build status

.. image:: https://codecov.io/gh/CloudVE/pyeventsystem/branch/master/graph/badge.svg :target: https://codecov.io/gh/CloudVE/pyeventsystem :alt: coverage status

pyeventsystem

pyeventsystem is an event-driven middleware library for Python. In addition to providing a mechanism for subscribing and listening to events, it also provides a mechanism for intercepting functions, thus making it suitable for writing middleware. By intercepting functions, middleware can be injected before, after or even replacing the original function. It also provides capabilities for grouping related event handlers into middleware classes, making it easier to manage installable middleware.

Simple Example

.. code-block:: python

from pyeventsystem.middleware import SimpleMiddlewareManager
from pyeventsystem.middleware import dispatch
from pyeventsystem.middleware import observe


class MyMiddleWare(object):

    def __init__(self, event_dispatcher):
        self.events = event_dispatcher

    @dispatch("a.series.of.unfortunate.events", priority=2500)
    def perform_villainy(self, name):
        return "Drop ACME Anvil on " + name

    @observe("a.series.of.unfortunate.events", priority=2400)
    def pre_log_villainy(self, event_args, name):
        print("Prepping for villainy: " + name)

    @observe("*.unfortunate.events", priority=2600)
    def post_log_villainy(self, event_args, name):
        print("Result of villainy: {0}".format(event_args['result']))


manager = SimpleMiddlewareManager()
myobj = MyMiddleWare(manager.events)
manager.add(myobj)
myobj.perform_villainy("RoadRunner")

In this example, we have intercepted the perform_villainy function, and observed the function both before and after execution.

The output is:

.. code-block:: console

Prepping for villainy: RoadRunner
Result of villainy: Drop ACME Anvil on RoadRunner

Download files

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

Source Distribution

pyeventsystem-0.1.0.tar.gz (13.5 kB view hashes)

Uploaded Source

Built Distribution

pyeventsystem-0.1.0-py2.py3-none-any.whl (15.1 kB view hashes)

Uploaded Python 2 Python 3

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