Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/homemadepy/messages
A python package designed to make sending messages easy and efficient!
https://github.com/homemadepy/messages
api api-wrapper automation beginner-friendly cli email python3 slack smtp telegram tool tools twilio whatsapp wiki
Last synced: 29 days ago
JSON representation
A python package designed to make sending messages easy and efficient!
- Host: GitHub
- URL: https://github.com/homemadepy/messages
- Owner: HomeMadePy
- License: mit
- Created: 2018-01-16T03:17:51.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2023-07-16T13:25:12.000Z (over 1 year ago)
- Last Synced: 2024-10-14T00:03:55.221Z (29 days ago)
- Topics: api, api-wrapper, automation, beginner-friendly, cli, email, python3, slack, smtp, telegram, tool, tools, twilio, whatsapp, wiki
- Language: Python
- Size: 966 KB
- Stars: 38
- Watchers: 6
- Forks: 12
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- License: LICENSE
Awesome Lists containing this project
README
# Messages: Create and send messages fast!
[](https://www.python.org/)
[](https://badge.fury.io/py/messages)
[](https://app.travis-ci.com/github/HomeMadePy/messages)
[](https://coveralls.io/github/HomeMadePy/messages?branch=master)
[](https://github.com/HomeMadePy/messages/blob/master/LICENSE)
## Purpose
- **Messages** is a package designed to make sending messages easy and efficient!
- **Messages** intends to be a _lightweight_ package with minimal dependencies.
- **Messages** with a **consistent API** across all message types.
- **Messages** includes **asynchronous** support for fast message handling.
## Installation
**Python3 only**
```shell
$ pip install messages
```
## Documentation in the [Wiki](https://github.com/HomeMadePy/messages/wiki)
## Supported Messages
* [Email](https://github.com/HomeMadePy/messages/wiki/Email)
* [Telegram](https://github.com/HomeMadePy/messages/wiki/TelegramBot)
* [Twilio](https://github.com/HomeMadePy/messages/wiki/Twilio)
* [WhatsApp](https://github.com/HomeMadePy/messages/wiki/WhatsApp)
* **Read the [Wiki](https://github.com/HomeMadePy/messages/wiki) for usage**.
# Examples
### Synchronous Execution
```python3
# You can send messages right in the REPL
>>> from messages import Email
>>>
>>> m = Email(
from_ = "[email protected]",
to = "[email protected]",
auth = "p@ssw0rd",
subject = "Good Advice",
body = "Hello,\n\tBuy more Bitcoin!",
attachments = ["./file1.txt", "~/Documents/file2.pdf"],
)
>>>
>>> m.send()
Message sent...
```
### Asynchronous Execution
```python3
# You can also send messages inside a script
import asyncio
from messages import Email
RECIPIENTS = [
"[email protected]",
"[email protected]",
"[email protected]",
"[email protected]",
]
loop = asyncio.get_event_loop()
for r in RECIPIENTS
e = Email(
from_ = "[email protected]",
to = r,
auth = "p@ssw0rd",
subject = "Good Advice",
body = "This is an asynchronous email.\nContinue buying more Bitcoin!",
attachments = ["./file1.txt", "~/Documents/file2.pdf"],
)
loop.create_task(e.send_async())
tasks = asyncio.all_tasks(loop=loop)
group = asyncio.gather(*tasks)
loop.run_until_complete(group)
```
### **Read** the [Wiki](https://github.com/HomeMadePy/messages/wiki) for **more examples**
## Contributing Code
* **Help Wanted!**
* All contributions are welcome to build upon the package!
* If it's a **message**, add it to messages!
* Read the [Wiki](https://github.com/HomeMadePy/messages/wiki) for guidelines.