guillotina-mailer 1.1.1

Mailer integration with guillotina

Contents

• guillotina_mailer

  • Configuration

  • Printing mailer

  • Sending mail

  • Permissions

  • Using the mailer in code

  • 1.1.1 (2018-11-15)

  • 1.1.0 (2018-09-17)

  • 1.0.5 (2018-09-12)

  • 1.0.4 (2018-09-12)

  • 1.0.3 (2018-09-12)

  • 1.0.2 (2017-04-13)

  • 1.0.1 (2017-04-10)

  • 1.0.0 (2017-04-04)

guillotina_mailer

Configuration

config.json can include mailer section:

"applications": ["guillotina_mailer"],
"mailer": {
  "default_sender": "[e-mail]",
  "endpoints": {
    "default": {
      "type": "smtp",
      "host": "localhost",
      "port": 25
    }
  }
}

Printing mailer

For development/debugging, you can use a console print mailer:

"applications": ["guillotina_mailer"],
"mailer": {
  "default_sender": "[e-mail]",
  "endpoints": {
    "default": {
      "type": "smtp",
      "host": "localhost",
      "port": 25
    }
  },
  "utility": "guillotina_mailer.utility.PrintingMailerUtility"
}

Sending mail

POST http://localhost:8080/zodb/container/@mailer:

{
  "sender": "[e-mail]",
  "recipient": "[e-mail]",
  "subject": "Some subject",
  "text": "Hello"
}

Permissions

guillotina_mailer defines a permission mailer.SendMail which, by default, only the guillotina.ContainerAdmin role is assigned.

Using the mailer in code

You can also directly use the mailer in your code:

from guillotina.component import queryUtility
from guillotina_mailer.interfaces import IMailer
mailer = queryUtility(IMailer)
await mailer.send(recipient='[e-mail]', subject='This is my subject', text='Body of email')

1.1.1 (2018-11-15)

• Fix getting empty settings [vangheem]

1.1.0 (2018-09-17)

• Use a retriable async queue to send emails [vangheem]

1.0.5 (2018-09-12)

• Fix tests [vangheem]

1.0.4 (2018-09-12)

• Fix queue [vangheem]

1.0.3 (2018-09-12)

• Fix to make work with latest guillotina [vangheem]

1.0.2 (2017-04-13)

• Register the smtp endpoint [vangheem]

1.0.1 (2017-04-10)

• remove dependencies on repoze.sendmail and transaction [vangheem]

• Test mailer did not provide correct signature [vangheem]

1.0.0 (2017-04-04)

• Initial release moved from guillotina_mailer