Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

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

Project details


Release history Release notifications

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
pyeventsystem-0.1.0-py2.py3-none-any.whl (15.1 kB) Copy SHA256 hash SHA256 Wheel py2.py3
pyeventsystem-0.1.0.tar.gz (13.5 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page