Package: f451-comms
TL;DRThis module provides a universal interface for various communications systems and services (e.g. email, Slack, SMS, etc.) and makes it possible to send the same message to several services with a single method call. The same call structure is used regardless of which services are enabled.InstallationWARNING:This module is in early alpha stage. And while the code works (and passes all the tests),use at your own risk 🤓You can install thef451 Communicationsmodule viapipfromPyPi:$pipinstallf451-commsPlease see the section “Installation” in themain documentationfor more information.QuickstartA common use case for thef451 Communicationsmodule is in applications that send (usually programmatically generated) messages via one or more channels. The module assumes that you provide all necessary keys and secrets required to verify your credentials with the services linked to the channels that you want to use.It is recommended that you store these keys and secrets in a separate file (e.g.secrets.ini). However, it is also possible to submit them – for example during testing – in the form of a so-calleddictstructure.from configparser import ConfigParser, ExtendedInterpolation
from f451_comms.comms import Comms

secrets = ConfigParser(interpolation=ExtendedInterpolation())
secrets.read("_PATH_TO_YOUR_SECRETS_FILE_")

comms = Comms(secrets)
comms.send_message("Hello world!", "all")The basic sequence is to first initialize theCommsobject with the keys and secrets required to authenticate with the services that you want to use. After that you can send messages to one or more channels with a single method call to theCommsobject.Thesend_message()method also has a 3rd argument that allows you to include additional attributes using adictstructure. These attributes can contain a wide variety of items. For example, you can include the HTML version of an email, or Slack blocks for more complex Slack messages. You can also include references to images to be included with the message, or files to be attached to emails, and so on.Please see the section “Getting started” in themain documentationfor more information.Run a demo of this moduleThis module comes with a demo that allows you to experiment with sending messages to the various channels. Of course, you must first ensure that you have accounts with the services that you want to experiment with. You must also provide the appropriate credentials when starting the demo or it will simply fail to authenticate with the services you’re trying to use.Please see the section “Run demo” in themain documentationfor more information.BackgroundThis module was originally created to “scratch an itch” – or, as we say in marketing parlance: to solve a particular use case. 😉 – I had several single-purpose applications running on different devices (e.g.Raspberry Pi) configured to support specific hardware configurations (i.e. sensors and displays, etc.), services, or functions. And all applications were designed to notify me via different channels that certain events had occurred and so on.Using a standardized communications library made it easy to have the main application on each device communicate results to the same channels without writing duplicate code for each application for a given device. Instead, I can now import this library, and most/all per-application customization can be handled by updating config files on each device.For example, I have several devices that continuously collect data from sensors and perform various processing tasks on that data. Then, at regular intervals, when specific tasks are completed or certain events are triggered, I get notified via SMS, some fancy Slack message, or even get a nice HTML-based email with a status update, etc. And in some cases, the devices also notify the world via Twitter that whatever status was updated.But most importantly, I’m able to call a simplesend_message()method, which works the same way regardless of which services are enabled for a given device. And if I add a new communications channel, I can enable it quickly on my devices without updating the core applications. Simply adding the new channel to a configuration file is enough 😎Current support:Email via Mailgun– plain text and HTML, with attachments and inline imagesSlack– plain text and Slack blocksSMS via Twilio– SMS with imagesTwitter– status updates and DMsFuture support:Other -I know, this is really specific … but there will be more😜DocumentationPlease refer to thedocumentationfor more information.ContributingContributions are very welcome. To learn more, see theContributor Guide.LicenseDistributed under the terms of theMIT license, thef451 Communicationsmodule is free and open source software.IssuesIf you encounter any problems, pleasefile an issuealong with a detailed description.CreditsThis project was generated from@cjolowicz’sHypermodern Python Cookiecuttertemplate.