Metadata-Version: 2.1
Name: ppmail
Version: 2.2.2
Summary: Tool to send messages via Sendgrid/Slack
Home-page: https://github.com/peterpakos/ppmail
Author: Peter Pakos
Author-email: peter.pakos@wandisco.com
License: GPLv3
Keywords: mail mailer sendgrid slack
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Topic :: Communications :: Email
Classifier: Topic :: Communications :: Chat
Requires-Dist: pplogger
Requires-Dist: ppconfig
Requires-Dist: sendgrid
Requires-Dist: slackclient (==1.3.1)

ppmail
======

Tool to send messages via Sendgrid/Slack

PyPI package: `ppmail <https://pypi.python.org/pypi/ppmail>`__

If you spot any problems or have any improvement ideas then feel free to
open an issue and I will be glad to look into it for you.

Installation
------------

A recommended way of installing the tool is pip install.

Once installed, a command line tool ``ppmail`` should be available in
your system's PATH.

pip install
~~~~~~~~~~~

The tool is available in PyPI and can be installed using pip:

::

   $ pip install --user ppmail
   $ ppmail --help

Configuration
-------------

By default, the tool reads its configuration from ``~/.config/ppmail``
file (the location can be overridden by setting environment variable
``XDG_CONFIG_HOME``). If the config file (or directory) does not exist
then it will be automatically created and populated with sample config
upon the next run.

Usage - Help
------------

::

   $ ppmail --help
   usage: ppmail [--version] [--help] [--debug] [--verbose] [-S] [-f SENDER] -t
                 RECIPIENTS [RECIPIENTS ...] [-c CC [CC ...]] [-s SUBJECT] [-H]
                 [-F FONT_SIZE]

   Tool to send messages via Sendgrid/Slack

   optional arguments:
     --version             show program's version number and exit
     --help                show this help message and exit
     --debug               debugging mode
     --verbose             verbose logging mode
     -S, --slack           Use Slack instead of Sendgrid
     -f SENDER, --from SENDER
                           sender
     -t RECIPIENTS [RECIPIENTS ...], --to RECIPIENTS [RECIPIENTS ...]
                           recipient
     -c CC [CC ...], --cc CC [CC ...]
                           carbon copy recipient
     -s SUBJECT, --subject SUBJECT
                           subject
     -H, --code            send HTML formatted email/code block
     -F FONT_SIZE, --font-size FONT_SIZE
                           font size in px for HTML formatted email (use with -H)

Usage - CLI
-----------

::

   $ echo 'The king is dead, long live the king!' \
     | ppmail -SHf 'Jon Snow' \
     -t 'arya.stark@winterfell.com' \
     -c 'sansa.stark@winterfell.com' \
     -s 'Re: secret message'

Usage - Python module
---------------------

::

   from ppmail import Mailer

   mailer = Mailer(slack=True)

   status = mailer.send(
       sender='Jon Snow',
       recipients=['arya.stark@winterfell.com'],
       cc=['sansa.stark@winterfell.com'],
       subject='Re: secret message',
       message='The king is dead, long live the king!',
       code=True
   )


