Description: Simple mailer agent using SMTP
Copyright: 2021-2023 Fabio Castelli (Muflone) [email protected]
License: GPL-3+
Source code: https://github.com/muflone/mumailer
Documentation: http://www.muflone.com/mumailer/
MuMailer is a simple mail transfer agent (MTA) to send email messages from Python or from command line arguments, using multiple profiles to configure arguments.
Please see below and the samples folder for some usage examples.
- Python 3.x
- PyYAML 6.x (https://pypi.org/project/PyYAML/)
To use MuMailer from Python you have to instance a Connection and a Message objects and then execute the send method on the connection object passing the message object.
The Connection object refers to the SMTP server connection and it will require the SMTP server data (server, port, username, password, encryption).
The Message object will contain the information needed to send a single message (sender, recipients, subject, body, attachments).
For sender, reply-to, to, cc and bcc arguments you need to pass some Recipient objects with an email address and optionally a name (pass None if you don't want to specify the recipient name).
See the following example:
from mumailer import Connection, Message, Recipient
message = Message(sender=Recipient('Muflone', '[email protected]'),
to=[Recipient('Foo', '[email protected]')],
cc=[Recipient('Bar', '[email protected]')],
subject='Test e-mail',
body='<html><body><h1>Hello world!</h1></body></html>',
use_html=True)
connection = Connection(server='localhost',
port=587,
username='<username>',
password='<smtp password>')
connection.connect()
connection.send(message)
connection.disconnect()The previous code will prepare a message from Muflone and will send the message to Foo, adding Bar to the CC (carbon copy) list, using the subject Test e-mail with the HTML body Hello world!.
The SMTP connection will be established to the localhost server on the TCP port 587 (the server must be running) using username and password authentication. The SMTP data will be encrypted using the TLS protocol.
A Message object can have one or more attachments being sent along with the message body.
To add an attachment to the Message object you have to instance an Attachment object from which you can set its content (as binary data) or load it from a file.
The class method load_filename will return an Attachment object with the file content.
from mumailer import Attachment
pdf_attachment = Attachment.load_filename(filename='myfile.pdf',
content_type='application/pdf')
message.add_attachment(pdf_attachment)
txt_attachment = Attachment.load_filename(filename='document.txt',
content_type='text/plain')
message.add_attachment(txt_attachment)Custom headers can be added to the message by passing one or more Header objects
to the headers argument or by adding each header to the headers list.
from mumailer import Header
header = Header(name='X-Mailer',
value='MuMailer')
message.add_header(header)
header = Header.parse(header='X-Spam=0')
message.add_header(header)The SMTP settings can also be got from a profile file like the following:
SMTP:
SERVER: <SMTP server>
PORT: 465
USERNAME: <username>
PASSWORD: <password>
TIMEOUT: 30
ENCRYPTION: TLSv1_2
CIPHERS:And instance the ProfileSmtp object:
from mumailer import Connection, ProfileSmtp
profile_smtp = ProfileSmtp(filename='profile-smtp.yaml')
connection = Connection(server=profile_smtp.server,
port=profile_smtp.port,
username=profile_smtp.username,
password=profile_smtp.password)Message profiles files can be used to set up the options for the message to be sent, saving in a profile file the sender, the recipients, subject, attachments list and others options.
MESSAGE:
SENDER: Muflone [email protected]
TO:
- Foo [email protected]
CC:
- Bar [email protected]
SUBJECT: Test e-mail
BODY: <html><body><h1>Hello world!</h1></body></html>
HTML: true
ATTACHMENTS:
- README.md
- LICENSE
CONTENT_TYPES:
- text/plain
- application/octet-stream
- HEADERS:
- X-Mailer=MuMailer
- X-MuMailer-Profile=message.yamlAnd instance the ProfileMessage object:
from mumailer import Header, Message, ProfileMessage, Recipient
profile_message = ProfileMessage(filename='profile-message.yaml')
message = Message(sender=Recipient.parse(profile_message.sender),
reply_to=Recipient.parse(profile_message.reply_to),
to=Recipient.parse_as_list(profile_message.to),
cc=Recipient.parse_as_list(profile_message.cc),
bcc=Recipient.parse_as_list(profile_message.bcc),
subject=profile_message.subject,
body=profile_message.body,
use_html=profile_message.use_html,
headers=Header.parse_as_list(profile_message.headers))