précise des détails dans le readme

This commit is contained in:
François Poulain 2020-08-25 09:02:02 +02:00
parent aa29bdc6b6
commit f8d0bbd001
1 changed files with 25 additions and 0 deletions

View File

@ -5,6 +5,7 @@ Simple mailing script.
**Table of content** **Table of content**
- [Installation](#installation) - [Installation](#installation)
- [Input format](#input-format)
- [Licence](#licence) - [Licence](#licence)
## Installation ## Installation
@ -29,6 +30,30 @@ following packages:
$ ./mailing.py --help $ ./mailing.py --help
$ ./mailing.py -t test-recipients-data -b test-emailling --dry-run --verbose $ ./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](https://docs.python.org/3/library/csv.html?highlight=csv#dialects-and-formatting-parameters)
(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](https://jinja.palletsprojects.com/en/2.11.x/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 ## License
Spamotron is developed by April and licensed under the [GPLv2+](LICENSE). Spamotron is developed by April and licensed under the [GPLv2+](LICENSE).