Go to file

François Poulain 2e6c786f4f ajoute une option very-verbose pour les trames smtp		2020-08-25 09:45:13 +02:00
.gitignore	gitignore	2020-08-25 08:50:40 +02:00
mailing.py	ajoute une option very-verbose pour les trames smtp	2020-08-25 09:45:13 +02:00
README.md	précise des détails dans le readme	2020-08-25 09:45:13 +02:00
test-emailling.footer	ajoute des exemples	2020-08-25 09:45:13 +02:00
test-emailling.html	ajoute des exemples	2020-08-25 09:45:13 +02:00
test-emailling.subject	ajoute des exemples	2020-08-25 09:45:13 +02:00
test-emailling.txt	ajoute des exemples	2020-08-25 09:45:13 +02:00
test-recipients-data	ajoute des exemples	2020-08-25 09:45:13 +02:00

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+.