kami-messenger 0.3.0

Library to aggregate multiple messengers services

Kami Messenger

---

Aggregator of Digital Channels For Sending Messages

📝 Table of Contents

• About
• Getting Started
• Deployment
• Usage
• Built Using
• TODO
• Contributing
• Authors
• Acknowledgments

🧐 About

Kami Messenger is a tool for aggregating several messaging platforms into a single package in order to facilitate the task of sending mass messages.

It contains three main classes for this purpose:

• Message(A single message that contains a list of recipients to send);
• Contact(A single contact with a list of addresses for different messaging platforms);
• Messenger(An object that instantiates, connects, and provides message push service of a specific platform)

🏁 Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

To run this package you only need a python 3.x compiler and poetry on your dev enviroment.

Installing

pip install kami-messenger

Then, after installing the dependencies, just activate the development environment with the following command:

poetry shell

Ready now you start developing and testing!

🔧 Running the tests

The project already has some of the main unit tests for each of the entities present in the code, but you can add your own tests in the respective directories 'test' of each entity.

Break down into end to end tests

Each entity has its own tests folder with the most elementary unit tests and to run them just run the command below in the entity folder you want to test or in the root folder to test all project codes

task test

Note that when executing this command, before actually testing the code, a code review will be performed using the lint-review task and after the execution of the test, an html file with the full coverage of the test will be available in the htmlcov folder created in the folder where the command was run. was executed

And coding style tests

In addition, the project already has automated tasks for review and correcting the code style following pep8 standards

To just review the code run the command below in the folder you want to analyze:

task lint-review

If you want to automatically review and correct the code, run this command in the desired directory

task lint-fix

🎈 Usage

Add notes about how to use the system.

🚀 Deployment

Add additional notes about how to deploy this on a live system.

⛏️ Built Using

• Python 3.x
• Python email built-in lib

✍️ Authors

• @maicondmenezes - Idea & Initial work

See also the list of contributors who participated in this project.

🎉 Acknowledgements

• The main references for this project can be found in the Python topic of this repository