Install it with pip

$ pip install email-service

Email Integration

Save the API_KEY in the .env file as

SENDGRID_API_KEY=api_key

Import EmailHandler

>>> from email_service.email_handler import EmailHandler

Form the dictionary of data

data = {
    "from_email": "Name WithSpace <from_email@gmail.com>",  # Required
    "subject": "This is the test for the Individual email", # Required
    "reply_to_addresses": "email1@gmail.com",
    "html_body": "<h1>Email Template for Individual email</h1>",    # Either of html_body or text_body is required
    "text_body": "Email Template for Individual email",
    "to_for_bulk": [{"name": "Name", "email": "email@gmail.com"},], # Required for Bulk Email
    "recipients": {
        "to": [{"name": "name1", "email": "email1@gmail.com"},],    # Required
        "cc": [{"name": "name2", "email": "email2@google.com"},],
        "bcc": [{"name": "name3", "email": "email3@google.com"},],
    },
    "attachments": [
        "file_path (pdf)", "calender invite (ics)", "image_path (png/jpg/jpeg)"
    ]
}

Send the email

>>> # For Individual Email
>>> send_email = EmailHandler()

>>> # For Bulk Email
>>> send_email = EmailHandler(email_type="BULK")

Sendgrid Integration

>>> # Send it using sendgrid
>>> response = send_email.sendgrid(data)

Response

status_code:
    202: OK,
    400: Error
message: Error or Success Message

Setup

$ git clone https://github.com/ramanaditya/email-service

$ python -m venv venv
$ source venv/bin/activate

$ python -m pip install --upgrade pip

$ python -m pip install -r requirements.txt

Git Flow

$ git checkout -b develop origin/develop
$ git checkout -b feature_branch

$ git add file_which_was_changed
$ git commit -m "Commit Message"
$ git push -u origin feature_branch

PyPI

This is just for the reference and need not to be run, If you want to run these scripts, please take a note of this

• For testing, we maintain the test package at testpypi

• PyPI or Test PyPI, does not accept same file name, you can change the file name or version in the ./setup.py

• You will be prompted to enter

  • Either username and password

  • or, username as “__token__” and password as token (can be generated from the pypi website)

• It will be uploaded to your pypi or testpypi account

$ # Downloading latest version of setuptools
$ python -m pip install --user --upgrade setuptools wheel

$ python setup.py sdist bdist_wheel

$ # Upload to Test PyPI https://test.pypi.org/
$ python -m twine upload --repository testpypi dist/*

$ python -m pip install -i https://test.pypi.org/simple/ email-service

$ # Edit the file inside /example to have some valid data
$ # export SENDGRID_API_KEY before running the script
$ python individual_email.py  # For individual email
$ python bulk.py  # For bulk email

$ # Upload to PyPI https://pypi.org/
$ python -m twine upload dist/*

$ python -m pip install -i https://test.pypi.org/simple/ email-service