install: remove need to name [esp]

Simplify install to just `pip install django-anymail`.
(Rather than `... django-anymail[mailgun]`

All of the ESPs so far require requests, so just move
that into the base requirements. (Chances are your
Django app already needs requests for some other
reason, anyway.)

Truly unique ESP dependencies (e.g., boto for
AWS-SES) could still use the setup extra features
mechanism.
This commit is contained in:
medmunds
2016-03-14 13:26:06 -07:00
parent f95bf1fbc4
commit fed98b14a8
8 changed files with 24 additions and 51 deletions

View File

@@ -6,24 +6,14 @@ Installation and configuration
Installing Anymail
------------------
Install Anymail from PyPI using pip.
Anymail uses python setuptools' "extra features" to pull in dependencies
for specific ESPs. (This avoids installing packages needed by ESPs
you aren't using.)
You'll want to include at least one ESP as an extra in your pip command.
E.g., for Anymail with Mailgun support:
It's easiest to install Anymail from PyPI using pip.
.. code-block:: console
$ pip install django-anymail[mailgun]
$ pip install django-anymail
...or with both Postmark and SendGrid support:
.. code-block:: console
$ pip install django-anymail[postmark,sendgrid]
If you don't want to use pip, you'll also need to install Anymail's
dependencies (requests and six).
.. _backend-configuration: