Files
django-anymail/docs/esps/index.rst
Mike Edmunds 53546ffc19 Docs: simplify editing ESP feature matrix
Move the big ESP feature matrix table
into a CSV file for easier maintenance.

Remove the doc8 line-length exception
the old table needed.

Docutils csv-table directive doesn't
support colspan on the subheadings
like the old table did. Add some JS
that replicates the old behavior.
(The new table is still readable even
with JS disabled.)
2024-02-19 15:00:43 -08:00

62 lines
1.8 KiB
ReStructuredText

.. _supported-esps:
Supported ESPs
==============
Anymail currently supports these Email Service Providers.
Click an ESP's name for specific Anymail settings required,
and notes about any quirks or limitations:
.. these are listed in alphabetical order
.. toctree::
:maxdepth: 1
amazon_ses
brevo
mailersend
mailgun
mailjet
mandrill
postal
postmark
resend
sendgrid
sparkpost
Anymail feature support
-----------------------
The table below summarizes the Anymail features supported for each ESP.
(Scroll it to the left and right to see all ESPs.)
.. currentmodule:: anymail.message
.. It's much easier to edit esp-feature-matrix.csv with a CSV-aware editor, such as:
.. PyCharm (Pro has native CSV support; use a CSV editor plugin with Community)
.. VSCode with a CSV editor extension
.. Excel (watch out for charset issues), Apple Numbers, or Google Sheets
.. Every row must have the same number of columns. If you add a column, you must
.. also add a comma to each sub-heading row. (A CSV editor should handle this for you.)
.. Please keep columns sorted alphabetically by ESP name.
.. csv-table::
:file: esp-feature-matrix.csv
:header-rows: 1
:widths: auto
:class: sticky-left
Trying to choose an ESP? Please **don't** start with this table. It's far more
important to consider things like an ESP's deliverability stats, latency, uptime,
and support for developers. The *number* of extra features an ESP offers is almost
meaningless. (And even specific features don't matter if you don't plan to use them.)
Other ESPs
----------
Don't see your favorite ESP here? Anymail is designed to be extensible.
You can suggest that Anymail add an ESP, or even contribute
your own implementation to Anymail. See :ref:`contributing`.