Skip to content

Commit

Permalink
More README notes
Browse files Browse the repository at this point in the history
  • Loading branch information
spookylukey committed Sep 26, 2023
1 parent e45ab9f commit 53ee4f0
Showing 1 changed file with 8 additions and 1 deletion.
9 changes: 8 additions & 1 deletion README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,10 @@ works by storing email in the database for later sending. This has a number of
advantages:

- **robustness** - if your email provider goes down or has a temporary error,
the email won’t be lost.
the email won’t be lost. In addition, since the ``send_mail()`` call always
succeeds (unless your database is out of action), then the HTTP request that
triggered the email to be sent won’t crash, and any ongoing transaction won’t
be rolled back.

- **correctness** - when an outgoing email is created as part of a transaction,
since it is stored in the database it will participate in transactions. This
Expand All @@ -51,6 +54,10 @@ you'll either need to fall back to using Django's default mail backend, or
increase your database limits (a procedure that depends on which database you
are using).

With django-mailer, you can’t know in a Django view function whether the email
has actually been sent or not - the ``send_mail`` function just stores mail on
the queue to be sent later.

django-mailer was developed as part of the `Pinax ecosystem
<http://pinaxproject.com>`_ but is just a Django app and can be used
independently of other Pinax apps.
Expand Down

0 comments on commit 53ee4f0

Please sign in to comment.