François Poulain 2e6c786f4f ajoute une option very-verbose pour les trames smtp		8 months ago
.gitignore	gitignore	8 months ago
README.md	précise des détails dans le readme	8 months ago
mailing.py	ajoute une option very-verbose pour les trames smtp	8 months ago
test-emailling.footer	ajoute des exemples	8 months ago
test-emailling.html	ajoute des exemples	8 months ago
test-emailling.subject	ajoute des exemples	8 months ago
test-emailling.txt	ajoute des exemples	8 months ago
test-recipients-data	ajoute des exemples	8 months ago

README.md

Spamotron

Simple mailing script.

Table of content

Installation
Input format
Licence

Installation

Requirements

On a Debian-based host running at least Debian Stretch, you will need the following packages:

git (recommended for getting the source)
python3
python3-jinja2

Manual installation

Clone repo

$ git clone https://forge.april.org/adminsys/spamotron
$ cd spamotron
$ chmod a+x mailing.py

Try it

$ ./mailing.py --help
$ ./mailing.py -t test-recipients-data -b test-emailling --dry-run --verbose

Input format

CSV

The « to-file » is expected to be csv with the default dialect (delimiter = , and char delimiter =").

The first line declare columns headers. The from and to headers are expected the be found. Headers are lower cased.

To avoid boring repetition it is possible to declare a default column value using : in header. The default value is considered when the column is lacking, not when the column is empty.

Templates

The templates files are expected to be jinja2 templates. The csv values are accessible using the column name, i.e. one can insert the recipient address anywhere in template using {{ to }}.

Don't worry about escaping: HTML templates are auto escaped.

License

Spamotron is developed by April and licensed under the GPLv2+.