Send automated emails using a CSV datafile and a template
Project description
Minimailer
Minimailer is a small script to send automated emails.
It's feeded from a template file and from a CSV data file, sending one email per CSV row after applying substitutions according to template rules that matches the data columns.
Dependencies
Minimailer has minimal dependencies:
It was successfully tested in Debian but should run in other systems without problems.
Installation
Minimailer can live anywhere in your $PATH
or run directly from the repository.
You can also install Minimailer from PyPI using
pip install minimailer
Basic usage
Minimailer only needs two parameters, the template and the data filenames:
minimailer message.tmpl data.csv
CSV file format
- Minimailer uses the first row in the CSV file as field names.
- All other rows are considered as data.
- There are no constraints about which or how many fields can be used.
- The only requirement is that one of those fields should be used as the email address source.
- By default, the field named
email
is used for email addresses, and can be overriden by the--recipient-field-address
option.
Template file format
Minimailer relies in Python 3's str.format() syntax, meaning that any text file can be used as long as:
- Template variables are enclosed in curly braces like
{this}
. - It implements a valid email message, i.e, it's compatible if the format specified by RFC 2822.
Advanced usage
Minimailer also comes with optional parameters allowing things such as handling
email addresses in a custom contact
field as indicated above:
minimailer message.tmpl data.csv --recipient-field-address 'contact'
Or using a custom sendmail
invocation (in this case, msmtp
with the account
name my-account
):
minimailer message.tmpl data.csv --sendmail-command 'msmtp -a my-account'
Check minimailer --help
for details and more invocation options.
Examples
Check the following files for examples in how to structure your template file and data source:
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for minimailer-0.0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 49bfaa559bb749e293c18c86da8349545107ac8a5ef39d34ac7686f4c491d4b8 |
|
MD5 | 207c33682e49c356ae47643e5dcdd641 |
|
BLAKE2b-256 | d1b1b5dbea3182d7e9c10a33573410eeb455935061cc55b3804ebf41e9b3d230 |