search

marrow / mailer

A light-weight, modular, message representation and mail delivery framework for Python.
MIT License
276 stars 62 forks source link

Configuration defaults are not documented #11

Closed agronholm closed 12 years ago

agronholm commented 12 years ago

I was left wondering what the default settings are. I had to look in the code. Then I STILL could not figure them out. For example, most people would prefer to send utf-8 encoded messages via SMTP to localhost. If those are not the defaults, they should be.

amcgregor commented 12 years ago
  1. The defaults for all configuration values of all transports and managers are documented.
  2. There are only three Message attributes with default values, which will be documented shortly.
  3. UTF-8 is a sane default, I agree… and it is the default.
  4. Defaulting to SMTP on localhost is dangerous, thus not the default. It used to be, but was changed around TurboMail 2.0 to prevent accidental message delivery and unintentional spamming. Because explicit is better than implicit, Marrow Mailer does not assume a default transport or manager.