Messages: Create and send messages fast!

messages_words

Purpose

Messages is a package designed to make sending messages easy and efficient!
Messages intends to be a lightweight package with minimal dependencies.
Messages wraps various standard library module, third-party module, web app API calls, etc. all in one package and with a consistent API across all message types.
Messages saves user parameters in config files and keyring backends to provide for easy invocation of all message types.
Messages can send messages via the command-line interface.

Installation

Python3 only

$ pip install messages

Documentation in the Wiki

Supported Messages

Email
Telegram
Twilio
Slack
WhatsApp
Read the Wiki for usage.

Examples

Email

REPL -- before configuration

>>> from messages import Email
>>> msg = 'Hello,\n\tBuy more Bitcoin!'
>>> m = Email(
            from_='me@here.com',
            server='smtp.here.com',
            port=465,
            to='you@there.com',
            auth='p@ssw0rd',       
            body=msg,
            attachments=['./file1.txt', '~/Documents/file2.pdf'],
            profile='myProfileName',
            save=True               # save user params for easier invocations later
   )
>>>
>>> m.send()        
Message sent...

REPL -- after configuration

Using the save=True keyword arg in the example above saves the _from__, server, port, and auth params, under the profile name myProfileName so you don't have include them in future calls, like below:

>>> from messages import Email
>>> msg = 'Hello,\n\tBuy more Bitcoin!'
>>> m = Email(
            to='you@there.com',      
            body=msg,
            attachments=['./file1.txt', '~/Documents/file2.pdf'],
            profile='myProfileName',
   )
>>>
>>> m.send()        
Message sent...

CLI

$ messages email myProfileName 'Hello,\n\tBuy more Bitcoin!' \
--to you@there.com \
--attach ./file.txt \
--attach ~/Documents/file2.pdf \
Message sent...

Read the 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 for guidelines.
Join the conversation in the Messages Slack Team