Amazon SES: use SES v2 API by default

- Rename `anymail.backends.amazon_sesv2.EmailBackend` to `amazon_ses`, making SES v2 the default. - Rename the old `amazon_ses` backend to `amazon_sesv1`, keeping it available. Add a deprecation warning. - Alias `amazon_sesv2` to `amazon_ses`, with a deprecation warning (for projects that opted into v2 early under Anymail 9.1 or 9.2). - Similar renaming on the test files. - Update docs to assume v2 in most places (other than migration-specific sections)
anymail · May 4, 2023 · 41754d9 · 41754d9
1 parent 2335b9c
commit 41754d9
Show file tree

Hide file tree

Showing 9 changed files with 1,021 additions and 991 deletions.
diff --git a/CHANGELOG.rst b/CHANGELOG.rst
@@ -33,6 +33,18 @@ vNext
 Breaking changes
 ~~~~~~~~~~~~~~~~
 
+* **Amazon SES:** The Amazon SES backend now sends using the SES v2 API.
+  Most projects should not require code changes, but you may need to update
+  your IAM permissions. See
+  `Migrating to the SES v2 API <https://anymail.dev/en/latest/esps/amazon_ses/#amazon-ses-v2>`__.
+
+  If you were using SES v2 under Anymail 9.1 or 9.2, change your
+  ``EMAIL_BACKEND`` setting from ``amazon_sesv2`` to just ``amazon_ses``.
+
+  (If you are not ready to migrate to SES v2, an ``amazon_sesv1`` EmailBackend
+  is available. But Anymail will drop support for that later this year. See
+  `Using SES v1 (deprecated) <https://anymail.dev/en/latest/esps/amazon_ses/#amazon-ses-v1>`__.)
+
 * **Amazon SES:** The "extra name" for installation must now be spelled with
   a hyphen rather than an underscore: ``django-anymail[amazon-ses]``.
   Be sure to update any dependencies specification (pip install, requirements.txt,

diff --git a/anymail/backends/amazon_ses.py b/anymail/backends/amazon_ses.py