Skip to main content

A library that implements a kind of fan-out pattern, sending messages to very different endpoints. Extendable through the implementation of custom Channels.

Project description

A library that implements a kind of fan-out pattern, sending messages to very different endpoints. Extendable through the implementation of custom Channels.

Features

Introduced concepts are:

  • Channels
    A channel is a communication endpoint capable of sending some type of message exposing a “notify” method.
  • Groups
    A group is a construct bringing channels together under a common entrypoint showing up as a method call of the main Notifier object.
  • Notifier
    The main object bringing together channels as broadcast by default and exposing methods to register and unregister channels and add and remove groups.

The payload of the notification methods is by convention a dictionary with at least a “subject” and a “message” key with the appropriate values. It is designed like this so it can be very easy to implement much more complex structures like templates without needed any domain knowledge on all the channels.

Each channel can implement their own template as in instantiation argument in their class and handle the interpolation of variables in the notify method.

An example could be :

from notifierlib.channels import Email
from notifierlib import Notifier, Group

import logging
logging.basicConfig(level=logging.DEBUG)
template='<b>{{subject}}</b> <i>{{message}}</i> <a href="http://google.com">link</a>.'

email=Email('email',
            sender='sender@gmail.com',
            recipient='recipient@gmail.com',
            smtp_address='smtp.domain.com',
            username='smtp_username',
            password='smtp_password',
            tls=True,
            ssl=False,
            port=587,
            template=template,
            content='html')

notifier=Notifier()
notifier.register(email)
notifier.broadcast(subject='this is a test of a template', message="""this is a nice and long message""")

The above would render the template with the provided values on the notify method of the email channel before the mail gets sent.

For a more detailed explanation please see the USAGE.rst file.

History

0.0.1 (18-09-2017)

  • First code creation

1.0.0 (07-07-2021)

  • Dropped support for python2.7, implemented a pipeline and bumped dependencies.

Project details


Download files

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

Source Distribution

notifierlib-1.0.0.tar.gz (56.8 kB view hashes)

Uploaded source

Built Distribution

notifierlib-1.0.0-py3.7.egg (36.8 kB view hashes)

Uploaded 3 7

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page