posts 0.2.0

A Python library for send mail easily

Posts is a Python library for send mail easily.

Installation

• GitHub: https://github.com/importcjj/Posts

• PyPi https://pypi.python.org/pypi/posts

pip install posts

Examples

Here is the first one to send a mail in text:

from posts import Posts

mail = Posts('smtp-server', 'your-username', 'your-passwd')

with mail() as box:
        box.text('to_address', subject='Subject', content='Content')

Posts does not only support mail in text type, but also support html:

box.html('to_address', subject='Subject', content='Content')

Next, we can send a mail with attachments:

with mail() as box:
        box.attach({'example.jpg': './example.jpg})
        box.text('to_address', subject='Subject', content='Content')

Finally, we can send the Html mail with image. and in the example, we also use a alias for the sender:

with mail(alias='alias') as box:
        box.attach({
                        'example.jpg': './example.jpg'})
        box.html(
                recipient='to_address',
                subject='subject',
                content='<img src="cid:example.jpg">')

Maybe you need to send mail by ssl, don’t worry:

with mail(ssl=True) as box:
        box.text('to_address', subject='Subject', content='Content')

Chain Useage

Just try like this:

box.attach({'name1': '/path/to/file1',
                        'name2': '/path/to/file2'}).\
        attach({'name3': '/path/to/file3'}).\
        text('to_address', 'subject', 'content').\
        html(['to_address1', 'to_address2'], 'subject', 'content')

The text mail with attachment 1, 2, 3 will send to address, and then the html mail with attachment 1, 2, 3 will be sent ot address1, address2 together.

TODO

• add alias for recipient.

• add carbon copy.

• add usage without with.